3DExplorer Quickstart. Introduction Requirements Getting Started... 4

Transcription

1 Page 1 of 43 Table of Contents Introduction... 2 Requirements... 3 Getting Started... 4 The 3DExplorer User Interface... 6 Description of the GUI Panes... 6 Description of the 3D Explorer Headbar... 7 Description of the Image View Toolbars... 8 Description of the 3D Explorer Header Camera Configuration Step by Step Camera Configuration and Image Acquisition Adjusting the Integration Time of the Image Acquisition Validating the COG Results Sensor Trigger Modes Saving Image Data Document Revision... 43

2 Page 2 of 43 INTRODUCTION The following describes the Graphical User Interface (GUI), the functions and the usage of the 3DExplorer that provide AT GmbH. The 3DExplorer offers the easy way to configure the C5-CS-GigE sensors.

3 Page 3 of 43 REQUIREMENTS The requirements state herein are the minimum the 3DExplorer need to run without any problems. Windows XP GenICam with GigE-Vision Transport Layer (preferably Stemmer Imaging Common Vision Blox version or higher) The firewall should be turned off Antivirus software should be turned off

4 Page 4 of 43 GETTING STARTED Connect the sensor to both the C5-CS-I/O Panel and the GigE Network Interface Card of the host PC. Be sure that the power supply unit of the C5-CS- I/O Panel is connected to the mains. Start the 3D Explorer by double clicking the shortcut icon on the windows desktop. The program starts and detects all sensors connected to the host PC. The dialog Device Selection appears showing the results of the start-up enumeration. Choose the right sensor over the preferable Transport Layer and then press Open Device. FD : Filter Driver SD : Socket Driver Discover : Performs sensor enumeration. Ignore Subnet : Detects sensors with IP address outside the host subnet. Set Persistent IP : Sets the persistent IP address of the sensor. Force IP : Configures the sensor with a temporary IP address

5 Page 5 of 43 When any problems with the connection to the sensor appear please read the AT FAQ for further information and help.

6 Page 6 of 43 THE 3DEXPLORER USER INTERFACE Description of the GUI Panes Image View Pane Info View and Log Pane XML Pane Statistic Pane 2D LinePlot Pane The different panes can be moved freely inside the GUI container by drag and drop.

7 Page 7 of 43 Description of the 3D Explorer Headbar Save Image As Tiff New 2D-Display XML View Start Live Image 3D Wizard New 3D-Display New Statistic- Display Snapshot Image Wizard Name Description Save Image As Tiff New 2D-Display New 3D-Display New Statistics-Display XML View Snapshot Start Live Image Image Wizard 3D Wizard Save the current frame as a Tiff image Open a new LinePlot pane Open a new 3D pane Open a new statistic pane Open the XML window Acquire a single frame Start a continuous image acquisition Wizard to set the camera to 2D image mode Wizard to set the camera to 3D mode

8 Page 8 of 43 Description of the Image View Toolbars Choose Color-Palette Draw Rectangle Set AOI Pixel coordinates at current position of mouse pointer Scale Image to Window Original size of Image Select Line Draw Line or Rectangle to move Reset AOI Pixel coordinates of mouse pointer shown in mm (requires calibration) Fit Image to Window Select Data Channel to show Name Description Choose Color-Palette Select Line or Rectangle to move Draw rectangle Draw line Set AOI Reset AOI Scale Image to Window Fit Image to Window Load a colour palette for false colour representation Select a drawn line or rectangle in the image Draw a rectangle into the image Draw a line into the image Define an AOI Set the AOI to the maximum size Scale the Image to fit to the Window (keep aspect ratio) Scale the Image to fit to the Window Original size of Image Scale the Image to 1:1 Select Data Channel to show Selecting the Data Channel which will be displayed in the Image View

9 Page 9 of 43 Max. value of shown data Automatic scaling to min. and max. data Min. value of shown data Data scale for min. and max. Suppress zeros for scaling Lock min. and max. values Name Description Min. value of shown data Data scale for min. and max. Max. value of shown data Suppress zeros for scaling Automatic scaling to min. and max. values Lock min. and max. values Minimum value of the displayed data Scaling the minimum and maximum values of the displayed data Maximum value of the displayed data Suppress zero values for scaling Scale to the minimum and maximum values of the displayed data Lock the minimum and maximum values of the displayed data

10 Page 10 of 43 Description of the 3D Explorer Header File Name Open Graphics File Save Image As Tiff Export Image Exit Preferences Save Camera Configuration Description Open a saved Tiff image Save the current frame as a Tiff image Export the Image in different types: Binary *.bin, 3D point cloud *.xyz, STL-Format *.stl Close the 3DExplorer Defines specifc options Save the camera settings as a.cfg file Load Camera Configuration Load a.cfg file

11 Page 11 of 43 Preferences Device-Options The Acquisition Timeout set the maximum waiting time for getting data from the device. Show Device Selection at Startup enables the automatic camera detection and enumeration at program start. If this option is unchecked, the 3DExplorer tries to connect to the last connected device. In case of failure, e.g. the device is not available, the device selection dialog appears again.

12 Page 12 of 43 Export-Options Enable or disable the function to convert 0 values to not any number for export data. Display-Options Enable or disable the Demo/Presentation Mode at Startup. When activated the camera starts directly the image acquisition in its startup mode. Set the refresh time for the Info Window.

13 Page 13 of 43 Calibration Obsolete.

14 Page 14 of 43 Device Name Snapshot Start Live Image Stop Live Image Select Device Close Device Load/Save Calibration Metric Description Acquire a single frame Start a continuous image acquisition Stop a continuous image acquisition Open the Device Selection Close the Device Load or save a metric calibration Load/Save Calibration Metric Here are all calibration files that are saved in the camera Status bar that shows how much camera memory is in use Delete all saved calibration files from the camera Delete the chosen calibration file from the camera Load a calibration file from the camera The current calibration file the 3D Explorer use Save a calibration file into the camera Load a calibration file from the PC Save the calibration file to the PC Clear the current calibration file

15 Page 15 of 43 Wizards Name Image Wizard 3D Wizard Description Open the image wizard Open the 3D wizard Image Wizard The Image Wizard is the easy way to set the sensor manually to the 2D greyscale image mode. Select the image format, set the integration time and enable or disable the FIR filter. Change the number of AOIs or change the size. Finish the Wizard to complete the adjustment.

16 Page 16 of 43 3D Wizard With the 3D Wizard the camera mode can be easily switched to 3D mode. Set the number of profiles per frame, choose the 3D algorithm, set the integration time and select the number of subpixel. Enable the required Output Channels and select the trigger mode to finish the wizard.

17 Page 17 of 43 Windows Name New 3D-Display New 2D-Display New Statistics-Display XML-View Description Open a new 3D pane Open a new 3D pane Open a new statistic pane Open the XML window Help The 3DExplorer version can be found over About.

18 Page 18 of 43 CAMERA CONFIGURATION Step by Step Camera Configuration and Image Acquisition The easiest way to configure the sensor manually is by using the configuration wizards. Set Sensor to 2D Image Mode In order to set the camera to 2D greyscale image mode, click at the symbol located on the 3D Explorer toolbar. The Image Wizard appears. Select the image format, set the integration time and enable or disable the FIR filter. Then click Next. Depending on the camera model the number of AOIs can be up to 8 AOIs. Adjust the OffsetY, the AOI height and the AOI Threshold for every AOI. Press Finish to close the wizard.

19 Page 19 of 43 Start live image acquisition by clicking at the symbol located on the 3D Explorer toolbar. The Image View shows the live image. Timing information appears in the Info View pane.

20 Page 20 of 43 Define the Area Of Interest (AOI) Stop the live image acquisition by clicking at the symbol located on the 3D Explorer toolbar. Click at the symbol located on the Image View toolbar and define the AOI by drawing a rectangle in the Image View pane. Click at the symbol located on the Image View toolbar to enable the AOI definition from the drawn rectangle. Start live image acquisition by clicking at the symbol located on the 3D Explorer toolbar. The Image View shows the live image of the newly defined AOI.

21 Page 21 of 43 The AOI can be easily set to the maximum size by first stopping the image acquisition and then clicking at the symbol.

22 Page 22 of 43 Set Sensor to 3D Mode In order to set the camera to 3D mode, click first at the symbol to stop live image acquisition and then click at the symbol located on the 3D Explorer toolbar. The 3D Wizard appears. Set the number of profiles to be acquired, the 3D algorithm as well as the sensor integration time and the number of Subpixel, then click Next.

23 Page 23 of 43 If needed, select additional data channels to be output according to the following table: Camera Mode FIR FIRMode DC0 DC1 DC2 Image False - Sensor intensity Not used Not used True Derivative First derivative of sensor intensity Not used Not used True Smoothing Smoothed sensor intensity Not used Not used MaximumIntensity False - Maximum intensity of Gauss Position of rising edge of Gauss Position of maximum intensity of (PosL) Gauss (PosM) True Smoothing Maximum intensity of Gauss detected in smoothed sensor image Position of rising edge of Gauss (PosL) detected in smoothed sensor image Threshold False - Maximum intensity of Gauss - Position of rising edge of Gauss (PosL) or - Gauss width (PosR-PosL) True Smoothing Maximum intensity of Gauss detected in smoothed sensor image CenterOfGravity False - Sum of intensity values of Gauss Is - Position of rising edge of Gauss (PosL) or - Gauss width (PosR-PosL) detected in smoothed sensor image - Position of rising edge of Gauss (PosL) or - Gauss width (PosR-PosL) Position of maximum intensity of Gauss (PosM) detected in smoothed sensor image - Position of falling edge of Gauss (PosR) or - Position of Gauss with 1/2 pixel resolution (PosL+PosR) - Position of falling edge of Gauss (PosR) or - Position of Gauss with 1/2 pixel resolution (PosL+PosR) detected in smoothed sensor image Position of center of gravity of Gauss with 1/(2 N ) pixel resolution, where N=number of subpixel bits (0-6)

24 Page 24 of 43 Camera Mode FIR FIRMode DC0 DC1 DC2 True Smoothing Sum of intensity values of Gauss Is in smoothed sensor image FIRPeak True Derivative Zero-crossing slope (Absolute value) - Position of rising edge of Gauss line (PosL) or - Gauss width (PosR-PosL) - Index of next sensor row to the left of zero-crossing or - maximum value of intensity first derivative Position of center of gravity of Gauss in smoothed sensor image with 1/(2 N ) pixel resolution, where N=number of subpixel bits (0-6) Position of Gauss peak with 1/(2 N ) pixel resolution, where N=number of subpixel bits (0-6) Click Next to proceed to the next wizard step.

25 Page 25 of 43 On the next page appears the configuration of the camera trigger mode. The mode for frame and profile triggering can be selected here. Click Next and Finish to complete the configuration.

26 Page 26 of 43 Acquire a Height Image Start the image acquisition by clicking at the symbol located on the 3DExplorer toolbar. The Image View shows the grabbed height image. The height values are rendered using a colour palette shown at the right of the pane. Click to load a different palette. By default the greyscal palette is active. Depending on sensor model, it could be necessary to invert the height image (Select Image Format Controls ReverseY = True)

27 Page 27 of 43 Create a Profile Plot In order to visualise a height profile, click at the symbol and draw a line over the height image. By holding down the SHIFT-key while dragging, the line is drawn only horizontally or vertically. In addition, by holding down the CTRL-Key, the line is extended automatically to the whole width or height of the view. After finishing the line draw, click the right mouse button to call the context menu.

28 Page 28 of 43 From the context menu, select New 2D LinePlot-View and the 2D graph appearing at the bottom of the GUI. - The graph can be zoomed in by dragging a window over the plot (not in Live-Mode) - The value of a specific point of the plot can be inquired by left-clicking the mouse

29 Page 29 of 43 Description of Line Plot Toolbar Automatic Update Connect all Points Data in mm (Requires Calibration) Reset View Plot a Linefit through the Data Show Line in Image Enable/disable the StatisticView Plot additional Data Original Size Suppress Zeros Keep the Aspect Ratio Show the Raw Data Show the Detrend Data Autoscale the Data Name Automatic Update Original Size Connect all Points Suppress Zeros Data in mm (Requires Calibration) Keep the Aspect Ratio Reset View Show the Raw Data Plot a Linefit through the data Show the Detrend Data Show Line in Image Autoscale the Data Enable/disable the StatisticView Plot additional Data Description Continuous update of the line plot data Scale the data to its original size Draw line from point to point Suppress all values with zero Show the data in mm Keep the Aspect Ratio Reset to full size after zooming Display the raw line plot data Plot a line through the mean data Correct the relative error to the mean Highlight the drawn line in the image Scale the plot to the data Flag for enable or disable of the StatisticView Draw an additional plot into the existing plot

30 Page 30 of 43 Create a 3D plot In order to create a 3D plot of the height profile, click at the symbol and draw a rectangle over the height image. Then click the right mouse button to call the context menu. From the context menu, select New 3D view to create the 3D plot.

31 Page 31 of 43 A new 3D plot appears in the GUI.

32 Page 32 of 43 Description of 3D Plot Toolbar The 3D plot can be controlled similar to a standard OpenGL view. Moving the mouse with pressed left button moves the 3D-Plot. Pressing the right button while moving the mouse rotates the 3D-Plot around its centre. The mouse wheel scales the plot. Suppress zeros in 3D-Plot Global scale of 3D-Plot Stretch after next Update Automatic update during image grab Reset View Show Axes Z-Scale of 3D-Plot Shows the 3D- Plot with Points, Lines or Shaded. Adjust plot resolution (higher values = faster plot) Show source rectangle in ImageView Name Description Suppress zeros in 3D-Plot Show Axes Z-Scale of 3D-Plot Global scale of 3D-Plot Stretch after next update Shows the 3D-Plot with Points, Lines or Shaded Adjust plot resolution (higher values=faster plot) Automatic update during image grab Show source rectangle in ImageView Reset View Suppress zero values from the image data Show coordinate plane in the 3D-Plot Scale the height values Scale the 3D-Plot in the 3D-View Stretch the 3D-Plot after an ImageView update Three different visualization options for the 3D-Plot Adjust the plot resolution Continuous update of 3D-Plot Highlight the rectangle in the source image Reset the 3D-Plot to the best fitting

33 Page 33 of 43 Adjusting the Integration Time of the Image Acquisition The integration time of the sensor can be adjusted by using the wizards or over the XML nodes. Depending on the sensor model select node Camera Control Sensor Control Sensor Integration Time and/or Acquisition Control Exposure Time. Enter the desired integration time in µs

34 Page 34 of 43 Validating the COG Results When using the COG algorithm, the sensor offers the ability to validate the resulting height data. Using criteria related to the Gauss distribution area (sum of intensity values) and Gauss distribution width, it is possible to suppress invalid height values. In XML view pane select the Camera Control Mode and Algorithm Control. By setting the option Position Validation at the End of Gauss Scan to true, the camera firmware validates the result of the COG calculation along a column of the line image. The validation is performed using tolerances for minimum Gauss width (Valid Minimum Width), maximum Gauss width (Valid Maximum Width), minimum Gauss area (Valid Minimum Sum of Intensity) and maximum Gauss area (Valid Maximum Sum of Intensity). If the parameter First Falling Edge is false, then

35 Page 35 of 43 the COG calculation takes into account multiple detected curves along the column. This can be useful when the laser line is distorted due to speckle effect. In addition, by setting the parameters Position Validation During Gauss Scan and First Falling Edge to true, the firmware validates every Gauss curve and stops the COG calculation after the first valid Gauss curve is detected. Furthermore, the COG search direction can be inverted by selecting the node Image Format Control ReverseY to true.

36 Page 36 of 43 Sensor Trigger Modes Apart from using the 3D wizard, the sensor trigger mode can be configured using the XML view pane. Select node Trigger Control. The mode for Sequencer and Trigger can be here selected.

37 Page 37 of 43 Description of Profile Trigger Modes No. Profile Trigger Mode (PTM) 0 Free-run (PTM0) 1 Camera input 1 (PTM1) IN1 Profile Acquisition 1 Profile Acquisition 2 Profile Acquisition 3 Profile Acquisition 4 t 2 Camera input 2 (PTM2) IN2 Profile Acquisition 1 Profile Acquisition 2 Profile Acquisition 3 Profile Acquisition 4 t 3 Encoder/Resolver Interface (PTM3) RS422 ENC_A A ENC_B B Counter Internal Trigger Profile Acquisition 1 Example: Trigger after number of steps = 4 Profile Acquisition 2 Profile Acquisition 3 t

38 Page 38 of 43 Description of Modes for Triggering of Sequencer/Frame and Profile Acquisition No. Sequencer/Frame Trigger Mode Profile Trigger Mode (PTM) 0 Free-run PTM0 (free-run) PTM1 (IN1) PTM2 (IN2) 1 Start/stop over camera input 1/2 Continuous frame acquisition is started with the rising edge of camera input 1 (IN1) and stopped with rising edge of camera input 2 (IN2) PTM0 (free-run) PTM3 (RS422) trigger start of sequencer (frame trigger) trigger stop of sequencer t When stop occurs, the frame is not transmitted immediately over the GigE interface but the camera continues to acquire profile data, until the predefined frame height is reached. 2 Trigger one frame over camera input 1 Single frame acquisition is triggered over the rising edge of camera input 1 (IN1) PTM0 (free-run) PTM2 (IN2) IN1 PTM3 (RS422) trigger start of sequencer (frame trigger) t

39 Page 39 of 43 No. Sequencer/Frame Trigger Mode Profile Trigger Mode (PTM) 3 Gate over camera input 1 Continuous frame acquisition is performed as long as the camera input 1 is on high state IN1 start trigger of sequencer Gate Function PTM0 (free-run) PTM2 (IN2) PTM3 (RS422) stop trigger of sequencer 4 Start/stop with instant transmission over camera input 1/2 Continuous frame acquisition is started with rising edge of camera input 1 (IN1) and stopped with rising edge of camera input 2 (IN2) trigger start of sequencer (frame trigger) t PTM0 (free-run) PTM3 (RS422) trigger stop of sequencer t When stop occurs, the frame is transmitted immediately over the GigE interface. Using the Chunk Data mode of C5 camera, it is possible to determine how many rows of the frame contain valid data (see ChunkImageInfo for details). 5 AutoStart (no external signal is required) PTM0 (free-run) PTM1(IN1) PTM2 (IN2) PTM3 (RS422) Remark: The above table (except AutoStart) applies also to acquisition in image mode. In this case the sensor delivers a gray scale image for every profile trigger.

40 Page 40 of 43 Triggering the Profile Acquisition with an external Encoder Signal (RS422) The profile acquisition can be synchronized to the motion of the scanned object by using an external encoder signal (RS422 profile trigger). The sensor features an integrated three-channel RS422 interface. Connect the encoder signal to the terminal A+, A-, B+, B-, Z+ and Z- of the C5-CS-I/O-Panel (see C5-CS series manuals for details). Set parameter Trigger Control Trigger Mode to Encoder/Resolver Interface RS422 Once this mode is set, the sensor will await the encoder signal to trigger a profile scan. As soon as a rising or falling edge of the RS422 signal is detected, the sensor acquires a single profile and waits for the next edge. Select the node Trigger Control RS422 Resolver to access the specific parameters for this mode. For example, the trigger frequency can be scaled down by adjusting the parameter Trigger Controls RS422 Resolver Trigger Divider or the trigger direction mode (unidirectional or bidirectional) can be set with Trigger Controls RS422 Resolver Count Bidirectional.

41 Page 41 of 43

42 Page 42 of 43 Saving Image Data Click at the symbol located at the 3DExplorer toolbar, in order to save the current image data as TIFF bitmap. A dialogue box appears. Enter the filename of the 3D image, e.g. 3DImage. Depending on which data channels were enabled during the 3D image acquisition, the following files are produced: 3DImage_0.tif contains the data of the first enabled Data Channel 3DImage_1.tif contains the data of the second enabled Data Channel 3DImage_2.tif contains the data of the third enabled Data Channel Example: If DC0 and DC2 were enabled then two single files will be saved ( 3Dimage_0.tif and 3DImage_1.tif ) containing the data of DC0 in _0.tif and DC2 in _1.tif. The above mentioned numbering scheme of data files applies also to configurations with multiple AOIs or multiple frames (NDR mode). The pixel depth of saved data depends on the selected mode, which is 8- bit/16-bit for image mode and 16-bit for 3D mode. Using an external image or data processing software (like ImageJ or Matlab), which can import TIFF bitmap files, you can process and evaluate the data.

43 Page 43 of 43 DOCUMENT REVISION Rev. No. Date Modification First release Minor corrections