# 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.
Inputs

The TransPatternsToWorld function has the following syntax:

TransPatternsToWorld(Calib, Patterns, Number to Convert)

See the table for a description of the available parameters.

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)

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.