Custom Coordinate System

You can define a custom reference frame in Custom Coordinate System for displaying the depth information of depth maps and point clouds.

Click Tools ‣ Custom Coordinate System in the menu bar to access this tool.

Note

The custom reference frame is for display in Mech-Eye Viewer only. The depth values stored in the saved depth map and point cloud are unchanged.

Suitable Scenarios

Under certain circumstances, the camera cannot be mounted directly above the target objects, but has to capture images at an angle, as shown below.

../../../_images/user_coordinate_demo.png

In such cases, the Z-axis of the camera reference frame isn’t perpendicular to the object plane. Therefore, two points that appear to be at the same height in the eyes of an observer, such as points 1 and 2 in the figure above, will have different depth values in the obtained depth maps and point clouds.

When you perform image capturing with a camera mounted at an angle, the obtained 2D image and depth map will look like the following:

../../../_images/images_camera_frame.png

A surface horizontal to the observer’s eyes, such as the bottom of the bin, will have varying depth from left to right. A flat, thin object, such as the one in the orange box, seemingly disappears in the depth map, because its own thickness is too small compared to the background depth variation.

To resolve this discrepency between observed height and obtained depth data, you can define a custom reference frame in Custom Coordinate System. Once an appropriate custom reference frame is defined, the depth data will appear to be consistent to object heights that you see.

Define a Custom Reference Frame

Basic Principle

In Custom Coordinate System, you can define a reference frame by selecting three points:

  • The first selected point is the origin of your custom reference frame.

  • The second and first points together define the X-axis.

  • All three points together define the XoY plane.

  • The third point’s relative position to the X-axis determines the positive direction of the Y-axis.

The Z-axis is then determined through the right-hand rule.

Hint

To ensure that the displayed depth information is consistent with what you actually see, select the three points on a plane that appears to be horizontal to you.

Instructions

  1. Open Custom Coordinate System, press down the Shift key while clicking three points on the displayed point cloud.

    Hint

    Scroll to zoom in/out, drag to rotate the point cloud, and drag with the scrolling wheel to move your point of view.

  2. After selecting the three points, the axes of the custom reference frame will appear on the point cloud. Rotate the point cloud to check:

    • If the Z-axis is perpendicular to the plane that appears horizontal to you.

    • If the Z-axis is pointing in the direction you want. If not, choose the third point on the other side of the X-axis defined by the first two points.

    If the custom reference frame doesn’t meet your needs, click Reset to clear the reference frame and re-select the points.

  3. Click OK to save the custom reference frame.

For the following section, a custom reference frame is defined to have the XoY plane on the surface where the bin is placed:

../../../_images/custom_reference_frame.png

Use the Custom Reference Frame

  1. Once you have a custom reference frame defined, perform image capturing again with icon_single_cap or icon_continuous_cap.

  2. In the Image Display area, select Depth Map or Point Cloud. In the left panel, select Customized from the drop-down menu of Coordinate System.

  3. Now the depth information is displayed in the custom reference frame: the bin bottom has the same color that represents the same depth.

    ../../../_images/images_custom_frame.png