The Semantic Region Extractor (SRE) is a component of the Isaac AMR Navigation Stack. Its purpose is to extract the relevant semantic regions around the robot, s.t. they can then be used by other planner components. For example the extracted semantic regions can be used to prune the searching space of a planner or implement restricted zones where a robot should not drive through. The semantic objects extracted by the SRE are
Navigable Surfaces: Regions where the robot is free to move.
Regions of Interest: Special regions inside of the extracted navigable surfaces; this could include obstacles, docking stations, restricted zones etc.
Route: The global route that the robot should follow
Robot Pose: The current pose of the robot
Semantic Map: The semantic map of the environment in which the robot is located
Relevant Semantic Regions: The extracted semantic regions. This contains both navigable surfaces and regions of interest.
The Semantic Region Extractor internally consists of two steps:
Extract all semantic regions which are touched by the route.
If the extracted regions do not contain the current robot position, expand the extracted regions using a Breadth-First Search to connect the robot to the extracted regions.
NvIsaacSemanticRegionExtractor
Extension containing components for semantic region extractor.
nvidia::isaac::SemanticRegionExtractor
Extracts the relevant semantic regions from a semantic map.
Parameters:
- name
- lookup_name
- description
- flags
- type
- default
Input route
rx_route
Name of input route channel.
GXF_PARAMETER_FLAGS_NONE
GXF_PARAMETER_TYPE_HANDLE
N/A
- name
- lookup_name
- description
- flags
- type
- default
Output Semantic Region
tx_semantic_region
Name of output semantic region channel.
GXF_PARAMETER_FLAGS_NONE
GXF_PARAMETER_TYPE_HANDLE
N/A
- name
- lookup_name
- description
- flags
- type
- default
Atlas
atlas
Atlas Frontend used to access pose tree and semantic map.
GXF_PARAMETER_FLAGS_NONE
GXF_PARAMETER_TYPE_HANDLE
N/A
- name
- lookup_name
- description
- flags
- type
- default
Semantic Map
semantic_map
Semantic map used to get access to semantic regions.
GXF_PARAMETER_FLAGS_NONE
GXF_PARAMETER_TYPE_HANDLE
N/A
- name
- lookup_name
- description
- flags
- type
- default
Robot Frame
robot_frame
Robot Frame
GXF_PARAMETER_FLAGS_NONE
GXF_PARAMETER_TYPE_HANDLE
N/A
- name
- lookup_name
- description
- flags
- type
- default
Search Radius
search_radius
Search radius used when querying semantic map.
GXF_PARAMETER_FLAGS_DYNAMIC
GXF_PARAMETER_TYPE_FLOAT64
N/A
- name
- lookup_name
- description
- flags
- type
- default
Max Height Difference
max_height_difference
Max height difference used when querying semantic map.
GXF_PARAMETER_FLAGS_DYNAMIC
GXF_PARAMETER_TYPE_FLOAT64
N/A
- name
- lookup_name
- description
- flags
- type
- default
Max Waypoint Distance
max_waypoint_distance
The last waypoint considered for extracting the semantic region will have a distance closer than this parameter to the robot.
GXF_PARAMETER_FLAGS_DYNAMIC
GXF_PARAMETER_TYPE_FLOAT64
N/A