CogFixtureNPointToNPoint.Execute Method

CogFixtureNPointToNPoint Execute Method

Cognex VisionPro

Computes a fixtured space using the points contained in this object and attaches it to the coordinate tree of the input image. Returns a result object that holds the computed fixture transform and a shallow copy of the input image.

Namespace: Cognex.VisionPro.CalibFix
Assembly: Cognex.VisionPro.CalibFix (in Cognex.VisionPro.CalibFix.dll) Version: 65.1.0.0

Syntax

C++

Copy to Clipboard Print

public CogFixtureNPointToNPointResult Execute(
	ICogImage inputImage
)

public CogFixtureNPointToNPointResult Execute(
	ICogImage inputImage
)

Public Function Execute ( 
	inputImage As ICogImage
) As CogFixtureNPointToNPointResult

Public Function Execute ( 
	inputImage As ICogImage
) As CogFixtureNPointToNPointResult

public:
CogFixtureNPointToNPointResult^ Execute(
	ICogImage^ inputImage
)

public:
CogFixtureNPointToNPointResult^ Execute(
	ICogImage^ inputImage
)

Parameters

inputImage: Type: Cognex.VisionPro ICogImage
The input image on which to perform the N-point-to-N-point fixturing.

Return Value

Type: CogFixtureNPointToNPointResult

The output image.

Exceptions

Exception	Condition
CogOperatorNoInputImageException	inputImage is NULL.
CogCalibFixNPointTooFewException	There are too few points for the requested DOFs.
CogCalibFixNPointUnstableException	The points are in a configuration that is numerically unstable or ambiguous. For example, all points lie along the x-axis and the DOFs need to measure y-axis scaling.

Remarks

Computes a fixtured space using the points contained in this object, attaches it to the coordinate space tree of the input image, and returns a result object that holds the computed fixture transform and a shallow copy of the input image.

The fixturing computation involves several steps. The Execute(ICogImage) method:

Computes the minimum squared error UnfixturedFromRawFixtured transform that best maps the current set of raw fixtured points onto the set of unfixtured points, using the allowed degrees of freedom.Computes the UnfixturedFromFixtured transform by concatenating the origin adjustment transform (if any) as follows: UnfixturedFromFixtured = UnfixturedFromRawFixtured * RawFixturedFromFixturedAttaches the (adjusted) fixtured space to the coordinate space tree of the input image. The FixturedSpaceName property determines the nonqualified space name of the fixtured space. The selected space of the input image is the unfixtured space.Creates an output image that shares the pixels and tree of the input image. The SpaceToOutput property determines the selected space name of this image. It is either the fully-qualified name of the fixtured space or the fully-qualified name of the unfixtured space.Returns a result object that holds the output image, the UnfixturedFromRaw and UnfixturedFromFixtured transforms, and the RMS error value of the fixturing computation.

No error results if the fixtured space already exists in the coordinate space tree of the input image prior to running this method. Execute(ICogImage), in this case, simply updates the existing definition of the fixtured space using the computed UnfixturedFromFixtured transform. If an error does occur during execution, no result object is returned. Instead, the result is Null or Nothing.