Check Pose Repeatability by Statistics¶
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.
Note
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¶
Parameter Tuning¶
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: PoseListInputTuning recommendation: Please select the input data type according to the actual requirement. Please refer to tuning example for the corresponding results. - Output Data Type
- Description: This parameter specifies the output data type.Default value: Statistics of spatial positions and Euler anglesTuning 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. 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–1000Default value: 1.0 mmTuning recommendation: Please set the value according to the actual requirement. Please refer to the tuning example for the corresponding results.
- Euler Angle Deviation Range (0–360)
- Description: This parameter specifies the acceptable upper limit of Euler angle deviation. 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–360Default value: 0.100°Tuning recommendation: Please set the value according to the actual requirement. Please refer to the tuning example for the corresponding results.
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: UnselectTuning recommendation: If you want to recollect the statistics, select this option. Please refer to the tuning example for the specific result.
Hint
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 3 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 recommendation: Please set the value according to the actual requirement. Please refer to the tuning example for the corresponding results. - Number of Decimal Places
- Description: This parameter specifies the number of decimal places used for the statistics.Default value: 3Value range: 0–8Tuning recommendation: 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 value: NoneTuning recommendation: Please adjust this parameter according to the actual requirement.
Hint
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
Tuning Examples¶
Input Data Type¶
As shown below, when different Input Data Types is selected, the input port of the Step will change accordingly.
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.
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.
Outlier Handling¶
Raise Error on Outlier¶
The 3 types of error messages are shown below:
The number of elements in the data is inconsistent.
The position coordinate deviation or Euler angle deviation exceeds the set threshold.
The statistics file has been opened and the new data cannot be saved.
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.