Data Export
The Data Export tool saves frames of scan data to local PC storage (by default, C:\GoTools\DataExport), letting you import and evaluate scan data in 3rd-party applications.
|
This tool is only available in a PC instance of GoPxL. It is not available on a sensor or on GoMax NX. |
You can optionally use a measurement as a condition for data export. For example, you could configure the tool to only export data if a Surface Position's Z measurement is a Fail (or a Pass).
The tool supports exporting the following formats. The available formats depend on the tool's input.
| Format | Surface | Profile | Image | Description |
|---|---|---|---|---|
|
CSV (.csv) |
✔ | ✔ |
CSV format. For more information, see CSV File Format. |
|
| PRO (.pro) | ✔ | MountainsMap format. Uniform data only. | ||
|
Wavefront OBJ (.obj) |
✔ |
Mesh with comma-separated vertices and facets in text format. |
||
|
ODSCAD OMC (.omc) |
✔ |
ODSCAD heightmap. |
||
|
PCL PCD (.pcd) |
✔ |
Point Cloud Data (PCD) file format for the Point Cloud Library (PCL). |
||
|
PNG (.png) |
✔ | ✔ |
Surface The heightmap as a PNG image. The image is either a 24-bit RGB image or a 16-bit grayscale image, depending on whether 16-bit Depth is enabled (see below).
Image An image from the sensor camera. The bit-depth depends on the camera. |
|
|
STL ASCII (.stl) |
✔ |
Mesh in the standard STL text format (can become very large). |
||
|
STL Binary (.stl) |
✔ |
Mesh in the binary STL format. |
||
|
MountainsMap SUR (.sur) |
✔ |
MountainsMap SUR heightmap. |
||
|
TIFF (.tif) |
✔ | ✔ |
Surface The heightmap as a TIFF image. The image is either a 24-bit RGB image or a 16-bit grayscale image, depending on whether 16-bit Depth is enabled (see below).
Image An image from the sensor camera. The bit-depth depends on the camera. |
The file naming convention is as follows:
<frame>_<timestamp>_<counter>.<extension>
<counter> is optional: It is only present if a file with the same name is already in the output folder.
For information on adding, managing, and removing tools, as well as detailed descriptions of settings common to most tools, see Tool Configuration.
Inputs
You configure the tool's inputs in the expandable Inputs section.
| Name | Description |
|---|---|
| Enable Batching |
When Enable Batching is checked, the tool takes an array as input and exports the data for each item in the array individually. For more information on arrays, batching, and aggregating, see Arrays, Batching, and Aggregation. |
|
Input |
The data the tool exports. |
| Conditional Measurement |
The measurement the tool uses to determine whether to export data. Can be None, in which case the tool exports all frames. In the Parameters section, set Condition to the condition type (see below). |
Parameters
You configure the tool's parameters in the expandable Parameters section.
| Name | Description |
|---|---|
| Enable Export |
When this parameter is checked, the tool exports frames in the format you select in File Format to the folder specified in Folder. |
| Condition |
If the Conditional Measurement input is set to a measurement, this determines which state of the measurement causes the tool to export data. One of the following:
The setting is only displayed if the Conditional Measurement input is set to a measurement. |
| File Format |
The format the tool uses to export data. For a list of the formats, see Output formats. |
| Data Type |
The type of data the tool outputs, using the format selected in File Format. One of the following:
Surface Outputs Surface data.
Intensity If intensity data is available, the tool outputs this data. Otherwise, no output is produced.
Surface and Intensity Outputs Surface data and, if it is available, intensity data. The tool appends "_surface" and "_intensity" to the file names of the outputs. |
| 16-bit Surface |
The bit depth of the heightmap output as an image. When disabled, the tool outputs a 24-bit RGB image. When enabled, the tool outputs a 16-bit grayscale image. Only available for PNG and TIFF outputs. |
| Keep Aspect Ratio |
Preserves the aspect ration of the image outputs (PNG and TIFF) by resampling to equal XY spacing. |
| Folder |
The folder in which the tool saves exported data. If the folder doesn't exist, the tool creates the folder. By default, C:/GoTools/DataExport. |
|
External ID |
The external ID of the tool that appears in GoHMI Designer. For more information, see GoHMI and GoHMI Designer. |
Outputs
This tool provides no outputs other than saving exported data in C:\GoTools\DataExport.