Group To Surface Fit    

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.