Transform Feature Pose

You are currently viewing the documentation for the latest version (2.2.0). To access a different version, click the "Switch version" button located in the upper-right corner of the page.

■ If you are not sure which version of the product you are currently using, please feel free to contact Mech-Mind Technical Support.

Description

This Step is used to transform the pose of a feature (e.g., point, circle, rectangle, oblong hole, cylinder) from one reference frame to another.

Additionally, this Step supports coordinate transformation for independent 3D pose data.

Usage Scenario

This Step applies to scenarios where feature poses need to be transferred or unified across different reference frames, such as those of the 3D camera, surface data, and robot. This Step is typically used for robot guidance, reference frame calibration, pose compensation, and subsequent measurement or picking processes.

Before using this Step, add the Structured-Light 3D Camera Step to the previous workflow and ensure that the hand-eye calibration results are applied. After the above configuration, the Transform Feature Pose Step can transform the feature or pose data between the surface data coordinate system, camera coordinate system, and robot coordinate system based on the hand-eye calibration result.

Pose Transformation Instructions

In the Mech-MSR, the data acquired by the Structured Light 3D Camera Step is not directly output in the camera reference frame, but is first transformed to the surface data reference frame. Therefore, when using this Step for fixed transformation, the reference frame mapping displayed in the interface essentially corresponds to a two-stage transformation process involving the camera reference frame.

  • Surface→robot

    This process actually performs the transformation from the surface data reference frame to the camera reference frame, and then to the robot reference frame.

  • Robot → Surface

    This process actually performs the transformation from the robot reference frame to the camera reference frame, and then to the surface data reference frame.

The results in the camera reference frame are output as the intermediate features (camera reference frame) of the Step, allowing you to check the pose during the intermediate transformation stage.

Input Description

Input item Description

Feature

The input feature whose pose will be transformed to the target frame.

Transformation Matrix

The transformation matrix used to convert the feature pose between reference frames.

Parameter Description

Parameter Description

Transformation Mode

Specifies the method for feature pose transformation.

The available modes are as follows:

  • Fixed transformation: Transforms poses using predefined reference frame mappings in the software.

  • Custom transformation: Transforms feature poses using the input transformation matrix.

Reference Frame Mapping

This parameter is only available when Transformation Mode is set to Fixed Transformation.

Specifies a predefined pose transformation between reference frames.

Available options are as follows:

  • Surface→Robot: Transforms the pose from the surface data frame to the robot frame.

  • Robot→Surface: Transforms the pose from the robot frame to the surface data frame.

Transformation Direction

This parameter is only available when Transform Mode is set to Custom Transformation.

Specifies how the transformation matrix is applied.

Available options are as follows:

  • Forward transformation: applies the input transformation matrix to transform the pose.

  • Inverse transformation: applies the inverse of the input transformation matrix to transform the pose.

If the input transformation matrix describes the reference frame relationship opposite to the target direction, select Inverse Transformation.

Output Description

Select the output item(s) to add the output port(s) to the Step, which outputs the specific data when the Step runs.

Output item Description

Transformed Feature

The feature obtained by transforming the input feature pose to the target frame.

Intermediate Feature (Camera Frame)

The intermediate feature expressed in the camera frame during transformation.

Troubleshooting

  • For common errors, see Error Code List.

  • If the error code is inconsistent with the error message, please contact Technical Support for help.

Invalid Input

Symptom:

When connecting the input data, an error message saying “Invalid input” popped up.

Possible cause:

The input data type is not supported.

Solution:

Check the input data type to ensure the data is a 3D feature (Shape3D) or a 3D pose (Pose).

Is this page helpful?

You can give a feedback in any of the following ways:

We Value Your Privacy

We use cookies to provide you with the best possible experience on our website. By continuing to use the site, you acknowledge that you agree to the use of cookies. If you decline, a single cookie will be used to ensure you're not tracked or remembered when you visit this website.