# CircleFromNPoints3D

The CircleFromNPoints3D function 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,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. 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.