This page provides a detailed overview about the Vision Inspect Node.
Vision Inspect Node
The Vision node is used to execute a vision based behavior, typically looking for part presence or absence of a trained snapshot. For details on how to use the vision functionality, refer to the tutorial.
Composite - has 0 or more children.
Auto generated and user editable
- track cycle time
Creates a shared data variable that automatically tracks the cycle time of the vision inspect execution.
- Failure Timeout
How long to wait for detection and re-registration to complete. If it doesn’t occur within that time frame, the node returns an error.
This menu gives the list of available snapshots from which to choose. Snapshots are created using the Snapshot Editor.
- Object Settings
- similarity threshold
Similarity controls how closely the new image of the object must match the initial training of the object for a successful recognition to occur. The higher the similarity setting, the more selective the system will be when looking for objects.
Enabling the symmetrical option makes tracking squares, rectangles, and circles more consistent. When tracking an object which is highly symmetrical, this option should be enabled. Enabling symmetrical automatically overrides the Start Angle and End Angle options.
- Start angle (only available for static and moving detection types)
Counter clockwise rotational difference from the object's trained position which will be detected.
- End angle (only available for static and moving detection types)
Clockwise rotational difference from the object's trained position which will be detected.
- Inspector Settings
- inspection type
Controls whether the inspector searches for the presence or absence of a part.
- presence criteria
If the inspection type is presence, the only option is ‘# of Images’. The vision system will deem the part present after a given number of frames containing the object. If the inspection type is absence, there is also the option to change the presence criteria to ‘Time’; using this option, the part will be considered absent if it is not detected for the given amount of time.
- present/absent after
Controls the specific conditions for when the part is considered present or absent. If using ‘# of Images’, this option will set how many consecutive images will be taken before the part is considered present or absent. If using time, this option will control how many seconds Sawyer will wait before considering the part absent. Adjust the ‘failure timeout’ field to control how long the robot should try to detect part presence/absence. For example, if the ‘# of Images’ is 5, the ‘inspection type’ is presence, and the ‘failure timeout’ is 5 seconds, the robot will try to take 5 consecutive images with the object of interest in the field of view. If it cannot get 5 consecutive images successfully within 5 seconds, the inspector node will time out.
- Motion Type
Defines the motion type (joint or linear) to be used when moving the arm camera into the landmark detection pose.
- Motion Preset
Defines the arm speed to be used when moving the arm camera into the landmark detection pose.