Fits a geometric shape (line, plane, circle, sphere, cylinder, cone, paraboloid, or ellipse) to a point gropu that has been projected to a plane. a specified point group.
Input Arguments
0 |
Geometry Type |
Geometry Type |
The type of geometry to fit to the points. |
1 |
Collection Object Name |
Group to Fit |
The point group to use for fitting. |
2 |
Collection Object Name |
Plane Name |
The name of the plane that is being used fo the projection. |
3 |
Collection Object Name |
Resulting Object Name |
The name of the resulting geometry. |
4 |
String |
Fit Profile Name |
The name of the geometry fit profile to use. |
5 |
Boolean |
Report Deviations |
Indicates whether a dialog should be displayed showing the fit results. |
6 |
Double |
Fit Interface Tolerance (-1.0 use profile) |
The tolerance to use for the geometry fit. |
7 |
Boolean |
Ignore Out of Tolerance Points |
Indicates whether or not points outside the toler- ance specified in Argument 6 should be included in the fit. |
8 |
Collection Object Name |
Starting Condition Geometry (optional) |
The name of a like geometry type to use as an initial guess for the geometry fit. |
Return Arguments
None.
Returned Status
SUCCESS |
The fit was successful. |
PARTIAL SUCCESS |
The fit was successful, but the tolerance was exceeded. |
FAILURE |
The fit was unsuccessful because the point group or fit profile could not be found. |
Remarks
Leave the fit profile name blank in order to use the default fit profile for the specified geometry type. Use a fit toler- ance of -1.0 to use the tolerance defined in the specified fit profile or a value of 0.0 to indicate that no tolerance should apply. The optional starting condition geometry is useful in rare cases when a fit algorithm gets “confused” and fails to settle on an acceptable solution. Providing a starting condition geometry can often eliminate this problem. An object providing starting condition geometry is usually not required.