Calculates the transform required to fit a point group to a specified surface.
Input Arguments
0 |
Collection Object Name |
Group to Fit |
The point group to fit to the surface. |
1 |
Collection Object Name |
Surface |
The surface to fit to. |
2 |
Boolean |
Do Conventional Fit |
Specifies whether a conventional fit is used, or whether the Direct fit is used. |
3 |
Double |
RMS Tolerance (0.0 for none) |
An optional tolerance for the RMS of the fit. |
4 |
Double |
Maximum Absolute Toler- ance(0.0 for none |
An optional maximum absolute error allowable for the fit. |
Return Arguments
5 |
World Transform Operator |
Optimum Transform |
The ideal transform for the fit. |
6 |
Double |
RMS Deviation |
The actual RMS error |
7 |
Double |
Maximum Absolute Deviation |
The largest actual deviation between a point and the surface. |
Returned Status
SUCCESS |
The fit was calculated successfully. |
FAILURE |
The group or surface was not found, or the fit exceeded the specified tolerances. |
Remarks
When “Do Conventional Fit” is set to TRUE, the standard fit optimization is performed, however this optimization is susceptible to getting trapped in a local minimum, terminating the optimization prematurely. When false, the “Direct ” optimization method is used, which is a brute force method that more frequently reaches a final solution without getting trapped in a local minimum--although it usually takes significantly longer to calculate.