# CircleFromNPoints3D

The CircleFromNPoints3D 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. is used to construct a 3D circle that best fits the specified 3 or more Point3D input points. The constructed circle is returned as a Circle3D structure.

Inputs

The CircleFromNPoints3D function has the following syntax:

CircleFromNPoints3D(PointCloud A point cloud is a 3D structure that consists of the data points collected by a 3D vision system during acquisition.,ExternalPoint0,ExternalPoint1,ExternalPoint2,[ExternalPoint3, ... ExternalPointN],Show)

See the table for a description of the available parameters.

Note: This function can accept a variable number of arguments. Therefore, the function does not have a Property Sheet. After drag-and-dropping from the Toolbox onto the spreadsheet, you must complete it manually according to the above syntax.
Note: You can add each Point3D individually or you can use a range:

Parameter | Description
PointCloud | Reference to a cell containing a point cloud A point cloud is a 3D structure that consists of the data points collected by a 3D vision system during acquisition.. The default value is $A$0.
External Point 0 | Specifies a reference to a Point3D structure defined in another cell to be used by the function as the first point for constructing the 3D circle.
External Point 1 | Specifies a reference to a Point3D structure defined in another cell to be used by the function as the second point for constructing the 3D circle.
External Point 2 | Specifies a reference to a Point3D structure defined in another cell to be used by the function as the third point for constructing the 3D circle.
... |
External Point N | Specifies a reference to a Point3D structure defined in another cell to be used by the function as the Nth point for constructing the 3D circle.
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 | A Circle3D structure containing the parameters of the configured 3D circle.
Results | When initially inserted into a cell, the following functions are automatically inserted into the spreadsheet to create a result table.
| Radius | X | Y | Z | Tilt | Tilt Direction
❒Circle3D | GetRadius(Circle3D) | GetX(Circle3D) | GetY(Circle3D) | GetZ(Circle3D) | GetTilt(Circle3D) | GetTiltDirection(Circle3D)

Vision Data Access functions

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

Function | Description
GetRadius(Circle3D) | Returns the radius of the 3D circle.
GetTilt(Circle3D) | Returns the tilt angle of the Circle3D structure in degrees on the Z-axis.
GetTiltDirection(Circle3D) | Returns the tilt direction angle of the specified Circle3D structure in degrees. The angle is measured in the X-Y plane of the original reference coordinate system, and specifies the direction for the projection of the tilted Z-axis onto that plane.
GetX(Circle3D) | Returns the X-axis coordinate of the 3D circle's center point.
GetY(Circle3D) | Returns the Y-axis coordinate of the 3D circle's center point.
GetZ(Circle3D) | Returns the Z-axis coordinate of the 3D circle's center point.