Check Pose Repeatability by Statistics

You are viewing an old version of the documentation. You can switch to the documentation of the latest version by clicking the top-right corner of the page.

Function

This Step is used to evaluate the stability of the poses in the vision projects.

In the actual application, the camera will capture 10–20 images on the same workpiece at each position first, and this Step will calculate the minimum, maximum, mean, range, and standard deviation of the workpiece poses at each position, and then you can determine whether the project runs stably according to the statistics.

No matter whether the camera is mounted in the eye-in-hand or eye-to-hand mode, images of the workpiece at different positions should be captured to verify the pose stability at different positions. However, when the camera captures 10–20 images at the same position, the relative position between the camera and the workpiece should not change.

  • When the camera is mounted in the eye-to-hand mode, only the workpiece can be moved.

  • When the camera is mounted in the eye-in-hand mode, both the workpiece and camera can be moved. Under this circumstance, please ensure that the relative position between the camera and the robot does not change when the camera continuously captures images on the same workpiece at one of the positions.

Usage Scenario

This Step can be used to evaluate the robustness of the camera or verify the effectiveness of the vision project parameter tuning.

It can follow 3D matching Steps to evaluate the robustness of matching. You can also connect it before the Procedure Out Step in a project to verify the stability of positioning and recognition deviation. In the latter case, please keep the workpieces unmoved and then capture images.

After running the project, this Step will output the statistics spreadsheet to a specified directory. You can check the statistics of X, Y, Z values of the poses and X, Y, Z values of Euler angles in this file.

Input and Output

poses repeatability statistics input and output

Parameter Description

Data for Making Statistics

Input Data Type

Description: This parameter is used to select the input data type which corresponds to the input port.

Value list: PoseListInput, NumberListInput.

  • PoseListInput: Input one or more pose lists.

  • NumberListInput: Input other data.

Default value: PoseListInput

Tuning recommendation: Please select the input data type according to the actual requirement. Please refer to the tuning example for the corresponding result.

Output Data Type

Description: This parameter specifies the output data type.

Default value: Statistics of spatial positions and Euler angles.

Tuning recommendation: This parameter does not need any adjustment. Please keep the default setting.

Position Coordinate Deviation Range (0–1000)

Description: This parameter specifies the acceptable upper limit of position coordinate deviation, in mm. If the difference between the maximum and the minimum exceeds this threshold, an error may be reported according to the setting of the Outlier Handling parameter. This checking process is performed independently for the X, Y, and Z coordinates.

Value range: 0–1000

Default value: 1.0 mm

Tuning instruction: Please set the value according to the actual requirement. Please refer to the tuning example for the corresponding result.

Euler Angle Deviation Range (0–360)

Description: This parameter specifies the acceptable upper limit of Euler angle deviation, in °. If the difference between the maximum and the minimum exceeds this threshold, an error may be reported according to the setting of the Outlier Handling parameter. This checking process is performed independently for the α, β, and γ values.

Value range: 0–360

Default value: 0.100°

Tuning instruction: Please set the value according to the actual requirement. Please refer to the tuning example for the corresponding result.

Statistics Saving

Restart

Description: When the workpiece’s position changes or outliers occur in the statistics, this parameter is used to determine whether to recollect the statistics. Once this option is selected, the output data will be marked as “Restart”. In the statistics file, data collected before the “Restart” mark will be excluded from the statistics and shown in gray.

Default Value: unselected.

Tuning recommendation: If you want to recollect the statistics, select this option. Please refer to the tuning example for the corresponding result.

  • After the Step successfully executes again, this option will be reset to unselected automatically.

  • If this option is not selected, the outlier will remain in the saved statistics.

Outlier Handling

Description: This parameter is used to specify how to handle outliers when they occur in the statistics.

Value list: Raise Error on Outlier, Record and Mark Outlier.

  • Raise Error on Outlier: An error will be immediately reported when an outlier is detected and the outlier will not be recorded. The possible three causes of the error are as follows.

    • The number of elements in the data is inconsistent. In this case, you can try to use the Unpack Data Step to fix the problem.

    • The position coordinate deviation or Euler angle deviation exceeds the set threshold. In this case, you can try to adjust the Position Coordinate Deviation Range and Euler Angle Deviation Range parameters.

    • The statistics file has been opened and the new data cannot be saved. In this case, please close the statistics file and re-run the project.

  • Record and Mark Outlier: No error will be reported if an outlier occurs. The outlier will be recorded in the file and marked in red, and it will also be included in the statistics.

Default value: Raise Error on Outlier.

Tuning instruction: Please set the value according to the actual requirement. Please refer to the tuning example for the corresponding result.

Number of Decimal Places

Description: This parameter specifies the number of decimal places used for the statistics.

Default value: 3

Value range: 0–8

Tuning instruction: Please set the value according to the actual requirement.

File Base Name

Description: This parameter is used to set the name of the statistics file. If you do not name the file, the output file will be named “posesStatistics” by default. If you modified the file base name, the Restart parameter will be automatically selected and the statistics will be recollected.

Default setting: none.

Tuning instruction: Please set the value according to the actual requirement.

If the position of the workpiece changes, or outliers occur in the statistics, you can select Restart and reset the File Base Name to re-create a statistics file to record the data.

Saving Directory Path

Description: This parameter specifies the saving directory of the statistics file. If you do not select the saving directory, the statistics file will be saved in the project folder by default.

Default setting: none.

Tuning recommendation: Click the poses repeatability statistics icon 1 button to choose a saving directory.

Tuning Examples

Input Data Type

As shown below, when different Input Data Types is selected, the input port of the Step will change accordingly.

poses repeatability statistics input data type

Position Coordinate/Euler Angle Deviation Range

When the difference between the current set of data and the last set of data exceeds the set value, an error message as shown below will appear on the Step.

poses repeatability statistics threshold value error

Restart

When Restart is selected, data collected after the “Restart” mark (including the data with the Restart mark) will be included in the calculation while the data collected before the “Restart” mark will be excluded and shown in gray in the statistics file.

poses repeatability statistics restart 0

Outlier Handling

Raise Error on Outlier

The three types of error messages are shown below:

  • The number of elements in the data is inconsistent.

poses repeatability statistics error 1
  • The position coordinate deviation or Euler angle deviation exceeds the set threshold.

poses repeatability statistics threshold value error
  • The statistics file has been opened and the new data cannot be saved.

poses repeatability statistics error 3

Record and Mark Outlier

When this option is selected, the outliers (1 in the figure below) and the corresponding statistics (2 in the figure below) will be marked in red.

poses repeatability statistics outlier handling 2

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.