Custom Reference Frame

You are currently viewing the documentation for the latest version (2.4.1). 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.

The custom reference frame can display the depth map and point cloud in Mech-Eye Viewer. The point cloud in the custom reference frame can be saved through the Save Data function.

Suitable Applications

Suitable applications of the custom reference frame include:

  • laser profiler is not mounted directly above the target object. However, you need to adjust the Z-axis of the reference frame for the depth map and point cloud so that the Z-axis is perpendicular to the surface of the target object or the plane where the target object locates.

  • You need to output the point cloud in the custom reference frame to reduce the amount of data to be processed.

custom reference frame

Adjust the Custom Reference Frame

Click Tools in the menu bar and select Custom Reference Frame to open the Custom Reference Frame tool.

Before opening the Custom Reference Frame tool, you need to trigger one round of data acquisition to acquire the point cloud.

When the tool is opened for the first time, the custom reference frame is displayed at the initial position, where it completely overlaps with the laser profiler reference frame. With this tool, you can adjust the position and direction of the custom reference frame and apply the settings.

The custom reference frame can be adjusted through the following two methods:

Adjust the Custom Reference Frame Based on the Guide Reference Frame

You can translate or rotate the custom reference frame based on the guide reference frame using the options for Align reference frames.

Generally, the guide reference frame is created based on the surface of the target object. You can then drag it to modify its position and direction.

Follow these steps to create a guide reference frame, and adjust the custom reference frame based on it:

  1. Click Create guide reference frame in the right panel.

  2. Adjust the position of the point cloud and find the surface to be used as the XY-plane of the custom reference frame.

  3. Hold the Shift key and click on the point cloud to select three points. The three points serve the following functions:

    • The first point is the origin of the reference frame.

    • The second point determines the positive direction of the X-axis.

    • The third point determines the positive direction of the Y-axis.

    After the three points are selected, a guide reference frame is generated according to the right-hand rule.

  4. Rotate and zoom the point cloud to check if the reference frame meets your needs:

    • Check if the three points are located on the same surface.

    • Check if the orientation of the Z-axis is correct.

    If not, you can drag the guide reference frame to adjust its position and direction, or repeat step 3 to create a new guide reference frame.

  5. After creating the guide reference frame, click Complete in the right panel.

    • If you need to adjust the guide reference frame after creating it, click Edit guide reference frame in the right panel.

    • The reference frame marked with XYZ is the reference frame, and that marked with X’Y’Z' is the guide reference frame.

  6. Select the needed option in the drop-down menu of Align reference frames in the right panel. Then, click Confirm.

    For detailed explanations of the options for Align reference frames, refer to the section Options for Align Reference Frames.
  7. After adjusting the custom reference frame, click Apply at the bottom right. After the settings are applied, you can display or save data in the custom reference frame.

    • Clicking Reset will reset the custom reference frame to the initial position, where it completely overlaps with the laser profiler reference frame.

    • After the settings of the custom reference frame are applied, the guide reference frame will not be saved.

Options for Align Reference Frames

The table below explains the options for Align reference frames and their suitable applications:

Option Description Suitable Applications

Overlap origins

Translates the custom reference frame so that its origin overlaps with the origin of the guide reference frame (no rotation).

custom overlap origin

laser profiler is not mounted directly above the target object, but the output depth map and point cloud should be as if laser profiler were directly above the target object.

Parallel X-axes

Rotates the custom reference frame so that its X-axis has the same positive direction as the X-axis of the guide reference frame (no translation).

custom parallel x axis

laser profiler is not mounted directly above the target object and is tilted at an angle. However, the output data has specific angle requirements for one of the axes. For example, the Z-axis needs to be perpendicular to the surface of the target object.

Parallel Y-axes

Rotates the custom reference frame so that its Y-axis has the same positive direction as the Y-axis of the guide reference frame (no translation).

custom parallel y axis

Parallel Z-axes

Rotates the custom reference frame so that its Z-axis has the same positive direction as the Z-axis of the guide reference frame (no translation).

custom parallel z axis

Overlap reference frames

Translates and rotates the custom reference frame so that it overlaps with the guide reference frame.

custom overlap full

In the output depth map and point cloud, the origin of the reference frame should be on the surface of the target object, and the Z-axis should be perpendicular to the surface.

Drag and Adjust the Reference Frame

You can adjust the position and direction of the custom reference frame and guide reference frame by dragging.

  • Hold the Ctrl key and select an axis of the reference frame to translate the reference frame along the axis.

  • Hold the Ctrl key and select a circle manipulator on the reference frame to rotate the reference frame around the manipulator.

The selected axis or manipulator turns yellow.
manipulator

Use the Custom Reference Frame

The custom reference frame can display the depth map and point cloud in Mech-Eye Viewer. The point cloud in the custom reference frame can be saved through the Save Data function.

  • To display the depth map and point cloud in the custom reference frame, follow these steps:

    1. In the data display area, switch to Depth Map or Point Cloud.

    2. At the top of the left panel, click the Reference Frame drop-down menu and select Custom. The depth map and point cloud will be displayed in the custom reference frame.

    The reference frame setting is simultaneously applied to both the depth map and point cloud.
  • To save the point cloud in the custom reference frame, select Point cloud in the Save Data window, and select Custom in the drop-down menu of Reference frame.

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.