Convert Lengths Pixel-Wise to Physical

Function

This Step is used to calculate the actual length of a specified line segment in 2D images. A calibration board is needed when using this Step, and it should be placed in the plane where the line segment to be measured is located.

Usage Scenario

This Step applies to scenarios where 2D images are used for measuring the dimensions of objects with relatively planar surfaces.

Since a line segment to be measured should be input, this Step usually follows Steps in the Measuring category with the LineSegmentList output port, such as Measure Distances Segments to Segments, Measure Distances Points to Circles, and Measure Distances Circles to Segments.

Input and Output

../../../../_images/input_and_output1.png

Parameter Description

Conversion Method

Description: This parameter specifies the conversion method to convert the length from pixel-wise to physical.
Options: Scale, Homography
  • Scale: The actual length of the line segment is equal to the product of the length in pixels multiplied by the scale.

  • Homography: The actual length of the line segment will be calculated from the projection of the image plane onto the actual plane.

Default value: Scale

Scale

When the conversion method is Scale, the actual length of the line segment is equal to the product of the length in pixels multiplied by the scale.

Scale
Description: The conversion ratio of pixel distance to actual distance.
Default value: 1.0000

Homography

When the conversion method is Homography, the Step will project the line segment in the image plane onto the actual plane to calculate the actual length of the line segment.

There are two ways to calculate the projection of the image plane onto the actual plane.

  • Calculate without Calibration: Directly calculate the projection from the Calibration Circle Center Distance, Number of Circle Rows, and Number of Circle Columns, and then the actual length of the segment line can be obtained. The calculation with this method takes less time.

  • Calculate by Calibration: Obtain the camera’s extrinsic and intrinsic parameters according to the Calibration Circle Center Distance, Number of Circle Rows, and Number of Circle Columns of the calibration board, and then calculate the projection of the image plane onto the actual plane. Lastly, Calibration Board Plane Height and Measured Plane Height will be used for the calculation of the actual length of the line segment. The calculation result using this method is more accurate.

The parameters of the Homography conversion method are as follows:

Calibration Circle Center Distance
Default value: 1
Instruction: This parameter specifies the actual distance between two circle centers on the calibration board. Please set the value according to the actual situation.

Hint

The distances between centers of adjacent circles in a row or a column on the calibration board should be the same.

Number of Circle Rows
Default value: 7
Instruction: This parameter specifies the number of rows of circles on the calibration board. Please set the value according to the actual situation.
Number of Circle Columns
Default value: 7
Instruction: This parameter specifies the number of columns of circles on the calibration board. Please set the value according to the actual situation.
Calculate by Calibration
Default value: Unselected
Instruction: This parameter determines whether to calculate the actual length by calibration. If this option is selected, the Step will calculate the projection of the image plane onto the actual plane by calibration and then calculate the actual length of the line segment.
Image No.
Description: When there are multiple input images, you can specify the image in which the line segment will be measured.
Default value: 1
Instruction: Once the image No. is selected, you can check the visualized output of the corresponding image in the Debug Output window.
Calibration Board Plane Height
Description: This parameter specifies the distance between the plane of the calibration board and the base plane.

Note

The base plane refers to the plane on which the calibration board and the object to be measured are placed.

Default value: 0
Instruction: If the calibration board is placed on a table, and the thickness of the calibration board is about 2 cm, the Calibration Board Plane Height should be set to 2 cm.
Measured Plane Height
Description: This parameter specifies the distance between the base plane and the plane where the line segment to be measured is located.
Default value: 0
Instruction: If the object to be measured is placed on a table, and the plane of the object to be measured is 2 cm away from the plane of the table, the Measured Plane Height should be set to 2 cm.