# ProfileExtractPoint3D

The ProfileExtractPoint3D function Functions are tools that are available in Spreadsheet for processing and analyzing acquisitions or other results. You can add functions to your Spreadsheet job to create tool chains and produce results for specific applications. allows you to extract the points with the smallest and the largest value on the X-axis and Z-axis in a profile, and a point with an average Z-axis value along the X-axis midline of the profile.

The ProfileExtractPoint3D function requires an existing Profile3D structure as input.

3D Point Cloud A point cloud is a 3D structure that consists of the data points collected by a 3D vision system during acquisition. with ProfileExtractPoint3D | Profile View

The ProfileExtractPoint3D function also allows you to use an external ProfileFixture3D input, which ensures that the function extracts the same profile feature for each acquisition Acquisition is the process or result of the vision system acquiring a new image.. The ProfileExtractPoint3D function can use the profile fixture A fixture is a coordinate location on the image that keeps the tool in the place determined by the fixture. to align the intersecting line in the profile, and produce consistent results regardless of positioning inconsistencies in the acquisition.

The ProfileExtractPoint3D function produces Point3D structures that you can use as input for other functions.

Inputs

The ProfileExtractPoint3D function has the following syntax:

ProfileExtractPoint3D(Profile3D, ProfileFixture3D, ExternalProfileFixture3D, Region3D, Show)

See the table for a description of the available parameters.

Parameter | Description
External Profile | Specifies the Profile3D structure to use.
Profile Fixture | Specifies the coordinates defining the profile fixture. It is offset from the profile origin in the following format with the following arguments: {Xp, Zp, Angle}
X | Offset on the X-axis from the profile origin.
Z | Offset on the Z-axis from the profile origin.
Angle | Specifies the in-plane rotation in degrees around the Y-axis of the profile origin. The value range is 0 to 180.
Note: This parameter is only available if you set External Profile Fixture to 0.
External Profile Fixture | Specifies a reference to a ProfileFixture3D structure defined in another cell. The function uses the ProfileFixture3D cell as the profile fixture of the function. Set to 0 (OFF) to use the internal profile fixture of the function instead.
Profile Region | Specifies the dimensions, offset and angle for the Profile Region of the function. The Profile Region is offset from the profile origin or the external fixture in the following format with the following arguments: {SizeXp, SizeZp, Xp, Zp, Angle}
SizeXp | The size of the Profile Region along the profile X-axis.
SizeZp | The size of the Profile Region along the profile Z-axis.
Xp | Offset on the X-axis from the profile origin.
Zp | Offset on the Z-axis from the profile origin.
Angle | Specifies the in-plane rotation in degrees around the profile Z-axis. The value range is 0 to 180.
Show | Selects the type of graphics to overlay on the image.
0 = hide all (default) | All graphics are hidden, except when the cell containing the function is highlighted in the spreadsheet.
1 = result graphics only | The result graphics of the function are displayed at all times.
2 = input and result graphics | The region of interest, the input data and the results are displayed at all times.

Outputs

Returns | Point3D data structures containing the extracted points, or #ERR if any of the input parameters are invalid.
Results | When initially inserted into a cell, the following functions are automatically inserted into the spreadsheet to create a result table:
| Min Xp Point | Max Xp Point | Min Zp Point | Max Zp Point | Ave Zp Point
❒ProfilePoints3D | ❒Point3D | ❒Point3D | ❒Point3D | ❒Point3D | ❒Point3D

Vision Data Access functions

The following ProfileExtractPoint3D Vision Data Access functions are automatically inserted into the spreadsheet to create the result table:

Function | Description
GetMinimumXPoint(ProfilePoints3D) | Returns the Point3D with the smallest X-axis value in the profile.
GetMaximumXPoint(ProfilePoints3D) | Returns the Point3D with the largest X-axis value in the profile.
GetMinimumZPoint(ProfilePoints3D) | Returns the Point3D with the smallest Z-axis value in the profile.
GetMaximumZPoint(ProfilePoints3D) | Returns the Point3D with the largest Z-axis value in the profile.
GetAverageZPoint(ProfilePoints3D) | Returns a Point3D on the X-axis midline of the profile with the average Z-axis value of all points in the profile.