TransPatternsToWorld

Applies a coordinate transform to a Patterns structure. The function Functions are tools that are available in Spreadsheet for processing and analyzing acquisitions or other results. You can add functions to your Spreadsheet job to create tool chains and produce results for specific applications. computes the offset and orientation of the patterns response points with respect to the specified real-world coordinate system.

Note: The output of any vision tool that reports in real-world coordinates cannot be used as a fixture A fixture is a coordinate location on the image that keeps the tool in the place determined by the fixture. or region input to another vision tool.

Outputs

Returns

Patterns structure translated to real-world coordinates, or returns #ERR if any of the input parameters are invalid.

Results

When the function is initially inserted into a cell, a result table is created in the spreadsheet using the following Patterns Vision Data Access functions:

Label	Function	Description
Index		Indexed Position
X	GetX(Patterns, Index)	The X-coordinate of the pattern position.
Y	GetY(Patterns, Index)	The Y-coordinate of the pattern position.
Angle	GetAngle(Patterns, Index)	The orientation of the pattern position.
Scale	GetScale(Patterns, Index)	The size of the pattern found compared to the trained model, as a percentage of the model size.
Score	GetScore(Patterns, Index)	The pattern response score.

Parameter	Description
Calib	A reference to a spreadsheet cell containing a valid Calib data structure.
Patterns	A reference to a spreadsheet cell containing a valid Patterns data structure.
Number to Convert	Specifies the number of patterns from the original Patterns data structure to convert to real-world coordinates. (0 to 1024; default = 1)