Set Calibration Origin

Use this tool to reset the coordinate system based on "Calibration Data" that have been previously determined, e.g., with Calibrate Camera. This enables you to set the origin and orientation of the coordinate system according to the actual position and orientation of the object.

Parameters

Basic Parameters

Image:

This parameter represents the image within which the origin of the calibration is visualized.

Origin:

This parameter contains the origin of the calibration in the form of a point region of interest. By default no ROI is defined for the origin. To define the origin of the x-axis and the y-axis, you either have to connect the parameter to an appropriate ROI result of a previous tool to make sure that an ROI is transmitted to this tool or you have to draw a new ROI into the image using the available ROI button.

This tool only supports the use of a single ROI. If the parameter contains multiple ROIs, either from a connection from a previous tool or by drawing multiple ROIs with the ROI buttons, only the last created ROI will be used for the processing.

Calibration Data:

This parameter contains the calibration data to be adapted. To define the "Calibration Data" that shall be used to specify the coordinate system anew, you have to connect the parameter to the respective result of a previous tool, e.g., Calibrate Camera, to make sure that calibration data are transmitted to this tool. They will be instantly applied to the image.

Orientation:

This parameter defines the orientation, i.e., the rotation, of the new coordinate system within the x-y plane. The rotation takes place around the axis perpendicular to the plane in counterclockwise direction, leading to a clockwise rotation for negative angles. The rotation angle is given in degrees. As default, it is set to 0°. This means that the x-axis of the new coordinate system is horizontally oriented and points to the right. To change the rotation angle, modify the angle for the Orientation at the corresponding parameter. The result, the new orientation of the calibration, is immediately displayed as rotated x- and y-axis.

Value	Description
0	The x-axis is not rotated.
1 to 180	The x-axis is rotated in counterclockwise direction.
−1 to −180	The x-axis is rotated in clockwise direction

Additional Parameters

Alignment Data:

This parameter represents the alignment data that are used to align the coordinate system. By default the alignment data are defined so that no effect is visible. If you want to use specific alignment data, you have to connect the parameter to an appropriate result of a previous tool such as Determine Alignment with Matching, Determine Alignment with Straight Border, Align Image, or Rotate Image. The new coordinate system remains consistent with respect to the aligned object for each position and orientation of the object.

Handedness:

This parameter enables you to select the handedness of the new coordinate system. As default, a "right handed" coordinate system is used. This means that the rotation from the "X Axis" to the "Y Axis" represents a counterclockwise rotation of 90°. However, you can also select a "left handed" coordinate system corresponding connector. In case of a left-handed coordinate system the rotation from the "X Axis" to the "Y Axis" represents a clockwise rotation of 90°.

Results

Basic Results

Adapted Calibration Data:

This result contains the "Adapted Calibration Data" which correspond to the new coordinate system. The parameter can be used by subsequent tools for further image processing.

Tool State:

"Tool State" returns information about the state of the tool and thus can be used for error handling. For more information, see Tool State Result

Additional Results

X Axis:

This result returns the determined x-axis of the new coordinate system. The result is returned as a contour and visualized in red.

Y Axis:

This result returns the determined y-axis of the new coordinate system. The result is returned as a contour and visualized in green.

Processing Time:

This result returns the duration of the most recent execution of the tool in milliseconds. The result is provided as additional result. Therefore, it is hidden by default but it can be displayed via the button beside the tool results. For more information see the section Processing Time in the tool reference overview.