# TransPatternsToFixture

Converts a Patterns data structure from image coordinates to fixture A fixture is a coordinate location on the image that keeps the tool in the place determined by the fixture. coordinates. 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 pattern response points with respect to the specified fixture.

Inputs

The TransPatternsToFixture function has the following syntax:

TransPatternsToFixture(X, Y, Theta, Patterns, Number to Convert)

See the table for a description of the available parameters.

Parameter | Description
--- | ---
Fixture | Specifies the fixture coordinate system.
X | The X-offset of the origin, in fixture coordinates.
Y | The Y-offset of the origin, in fixture coordinates.
Theta | The rotation from the image X-axis, in the image coordinate system. (+/-360 degrees clockwise)
Patterns | This argument must reference a spreadsheet cell that contains a valid Patterns data structure.
Number to Convert | Number of instances to convert to real-world coordinates between 1 and 1024. The default number is one.

Outputs

Returns | Patterns structure translated to fixtured coordinates, or #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.

Vision Data Access functions

The Patterns Vision Data Access functions automatically inserted into the spreadsheet is similar to those automatically inserted by the functions used find and sort Patterns data structures.