|
Package Summary
Tags | No category tags. |
Version | 1.1.17 |
License | Apache-2.0 |
Build type | AMENT_CMAKE |
Use | RECOMMENDED |
Repository Summary
Checkout URI | https://github.com/ros-planning/navigation2.git |
VCS Type | git |
VCS Version | humble |
Last Updated | 2024-11-26 |
Dev Status | DEVELOPED |
CI status | No Continuous Integration |
Released | RELEASED |
Tags | No category tags. |
Contributing |
Help Wanted (0)
Good First Issues (0) Pull Requests to Review (0) |
Package Description
Additional Links
Maintainers
- Alexey Merzlyakov
- Steve Macenski
Authors
Nav2 Collision Monitor
The Collision Monitor is a node providing an additional level of robot safety. It performs several collision avoidance related tasks using incoming data from the sensors, bypassing the costmap and trajectory planners, to monitor for and prevent potential collisions at the emergency-stop level.
This is analogous to safety sensor and hardware features; take in laser scans from a real-time certified safety scanner, detect if there is to be an imminent collision in a configurable bounding box, and either emergency-stop the certified robot controller or slow the robot to avoid such collision. However, this node is done at the CPU level with any form of sensor. As such, this does not provide hard real-time safety certifications, but uses the same types of techniques with the same types of data for users that do not have safety-rated laser sensors, safety-rated controllers, or wish to use any type of data input (e.g. pointclouds from depth or stereo or range sensors).
This is a useful and integral part of large heavy industrial robots, or robots moving with high velocities, around people or other dynamic agents (e.g. other robots) as a safety mechanism for high-response emergency stopping. The costmaps / trajectory planners will handle most situations, but this is to handle obstacles that virtually appear out of no where (from the robot’s perspective) or approach the robot at such high speed it needs to immediately stop to prevent collision.
Features
The Collision Monitor uses polygons relative the robot’s base frame origin to define “zones”. Data that fall into these zones trigger an operation depending on the model being used. A given instance of the Collision Monitor can have many zones with different models at the same time. When multiple zones trigger at once, the most aggressive one is used (e.g. stop > slow 50% > slow 10%).
The following models of safety behaviors are employed by Collision Monitor:
-
Stop model: Define a zone and a point threshold. If more that
N
obstacle points appear inside this area, stop the robot until the obstacles will disappear. -
Slowdown model: Define a zone around the robot and slow the maximum speed for a
%S
percent, if more thanN
points will appear inside the area. -
Approach model: Using the current robot speed, estimate the time to collision to sensor data. If the time is less than
M
seconds (0.5, 2, 5, etc…), the robot will slow such that it is now at leastM
seconds to collision. The effect here would be to keep the robot alwaysM
seconds from any collision.
The zones around the robot can take the following shapes:
- Arbitrary user-defined polygon relative to the robot base frame.
- Circle: is made for the best performance and could be used in the cases where the zone or robot could be approximated by round shape.
- Robot footprint polygon, which is used in the approach behavior model only. Will use the footprint topic to allow it to be dynamically adjusted over time.
The data may be obtained from different data sources:
- Laser scanners (
sensor_msgs::msg::LaserScan
messages) - PointClouds (
sensor_msgs::msg::PointCloud2
messages) - IR/Sonars (
sensor_msgs::msg::Range
messages)
Design
The Collision Monitor is designed to operate below Nav2 as an independent safety node.
This acts as a filter on the cmd_vel
topic coming out of the Controller Server. If no such zone is triggered, then the Controller’s cmd_vel
is used. Else, it is scaled or set to stop as appropriate.
The following diagram is showing the high-level design of Collision Monitor module. All shapes (Polygons and Circles) are derived from base Polygon
class, so without loss of generality we can call them as polygons. Subscribed footprint is also having the same properties as other polygons, but it is being obtained a footprint topic for the Approach Model.
Configuration
Detailed configuration parameters, their description and how to setup a Collision Monitor could be found at its Configuration Guide and Using Collision Monitor tutorial pages.
Metrics
Designed to be used in wide variety of robots (incl. moving fast) and have a high level of reliability, Collision Monitor node should operate at fast rates. Typical one frame processing time is ~4-5ms for laser scanner (with 360 points) and ~4-20ms for PointClouds (having 24K points). The table below represents the details of operating times for different behavior models and shapes:
Stop/Slowdown model, Polygon area | Stop/Slowdown model, Circle area | Approach model, Polygon footprint | Approach model, Circle footprint | |
---|---|---|---|---|
LaserScan (360 points) processing time, ms | 4.45 | 4.45 | 4.93 | 4.86 |
PointCloud (24K points) processing time, ms | 4.94 | 4.06 | 20.67 | 10.87 |
The following notes could be made:
- Due to sheer speed, circle shapes are preferred for the approach behavior models if you can approximately model your robot as circular.
- More points mean lower performance. Pointclouds could be culled or filtered before the Collision Monitor to improve performance.
Wiki Tutorials
Package Dependencies
Deps | Name |
---|---|
ament_cmake | |
ament_cmake_gtest | |
ament_lint_common | |
ament_lint_auto | |
rclcpp | |
rclcpp_components | |
tf2 | |
tf2_ros | |
tf2_geometry_msgs | |
sensor_msgs | |
geometry_msgs | |
nav2_common | |
nav2_util | |
nav2_costmap_2d |
System Dependencies
Dependant Packages
Name | Deps |
---|---|
navigation2 |
Launch files
Messages
Services
Plugins
Recent questions tagged nav2_collision_monitor at Robotics Stack Exchange
|
Package Summary
Tags | No category tags. |
Version | 1.2.10 |
License | Apache-2.0 |
Build type | AMENT_CMAKE |
Use | RECOMMENDED |
Repository Summary
Checkout URI | https://github.com/ros-planning/navigation2.git |
VCS Type | git |
VCS Version | iron |
Last Updated | 2024-10-02 |
Dev Status | DEVELOPED |
CI status | No Continuous Integration |
Released | RELEASED |
Tags | No category tags. |
Contributing |
Help Wanted (0)
Good First Issues (0) Pull Requests to Review (0) |
Package Description
Additional Links
Maintainers
- Alexey Merzlyakov
- Steve Macenski
Authors
Nav2 Collision Monitor
Collision Monitor
The Collision Monitor is a node providing an additional level of robot safety. It performs several collision avoidance related tasks using incoming data from the sensors, bypassing the costmap and trajectory planners, to monitor for and prevent potential collisions at the emergency-stop level.
This is analogous to safety sensor and hardware features; take in laser scans from a real-time certified safety scanner, detect if there is to be an imminent collision in a configurable bounding box, and either emergency-stop the certified robot controller or slow the robot to avoid such collision. However, this node is done at the CPU level with any form of sensor. As such, this does not provide hard real-time safety certifications, but uses the same types of techniques with the same types of data for users that do not have safety-rated laser sensors, safety-rated controllers, or wish to use any type of data input (e.g. pointclouds from depth or stereo or range sensors).
This is a useful and integral part of large heavy industrial robots, or robots moving with high velocities, around people or other dynamic agents (e.g. other robots) as a safety mechanism for high-response emergency stopping. The costmaps / trajectory planners will handle most situations, but this is to handle obstacles that virtually appear out of no where (from the robot’s perspective) or approach the robot at such high speed it needs to immediately stop to prevent collision.
Demonstration of Collision Monitor abilities presented at 6th ROS Developers Day 2023, could be found below:
Features
The Collision Monitor uses polygons relative the robot’s base frame origin to define “zones”. Data that fall into these zones trigger an operation depending on the model being used. A given instance of the Collision Monitor can have many zones with different models at the same time. When multiple zones trigger at once, the most aggressive one is used (e.g. stop > slow 50% > slow 10%).
The following models of safety behaviors are employed by Collision Monitor:
-
Stop model: Define a zone and a point threshold. If more that
N
obstacle points appear inside this area, stop the robot until the obstacles will disappear. -
Slowdown model: Define a zone around the robot and slow the maximum speed for a
%S
percent, if more thanN
points will appear inside the area. -
Approach model: Using the current robot speed, estimate the time to collision to sensor data. If the time is less than
M
seconds (0.5, 2, 5, etc…), the robot will slow such that it is now at leastM
seconds to collision. The effect here would be to keep the robot alwaysM
seconds from any collision.
The zones around the robot can take the following shapes:
- Arbitrary user-defined polygon relative to the robot base frame, which can be static in a configuration file or dynamically changing via a topic interface.
- Robot footprint polygon, which is used in the approach behavior model only. Will use the static user-defined polygon or the footprint topic to allow it to be dynamically adjusted over time.
- Circle: is made for the best performance and could be used in the cases where the zone or robot footprint could be approximated by round shape.
The data may be obtained from different data sources:
- Laser scanners (
sensor_msgs::msg::LaserScan
messages) - PointClouds (
sensor_msgs::msg::PointCloud2
messages) - IR/Sonars (
sensor_msgs::msg::Range
messages)
Design
The Collision Monitor is designed to operate below Nav2 as an independent safety node.
This acts as a filter on the cmd_vel
topic coming out of the Controller Server. If no such zone is triggered, then the Controller’s cmd_vel
is used. Else, it is scaled or set to stop as appropriate.
The following diagram is showing the high-level design of Collision Monitor module. All shapes (Polygons and Circles) are derived from base Polygon
class, so without loss of generality we can call them as polygons. Subscribed footprint is also having the same properties as other polygons, but it is being obtained a footprint topic for the Approach Model.
Configuration
Detailed configuration parameters, their description and how to setup a Collision Monitor could be found at its Configuration Guide and Using Collision Monitor tutorial pages.
Metrics
Designed to be used in wide variety of robots (incl. moving fast) and have a high level of reliability, Collision Monitor node should operate at fast rates. Typical one frame processing time is ~4-5ms for laser scanner (with 360 points) and ~4-20ms for PointClouds (having 24K points). The table below represents the details of operating times for different behavior models and shapes:
Stop/Slowdown/Limit model, Polygon area | Stop/Slowdown/Limit model, Circle area | Approach model, Polygon footprint | Approach model, Circle footprint | |
---|---|---|---|---|
LaserScan (360 points) processing time, ms | 4.45 | 4.45 | 4.93 | 4.86 |
PointCloud (24K points) processing time, ms | 4.94 | 4.06 | 20.67 | 10.87 |
The following notes could be made:
- Due to sheer speed, circle shapes are preferred for the approach behavior models if you can approximately model your robot as circular.
- More points mean lower performance. Pointclouds could be culled or filtered before the Collision Monitor to improve performance.
Collision Detector
In some cases, the user may want to be informed about the detected obstacles without affecting the robot’s velocity and instead take a different action within an external node. For example, the user may want to blink LEDs or sound an alarm when the robot is close to an obstacle. Another use case could be to detect data points in particular regions (e.g extremely close to the sensor) and warn of malfunctioning sensors. For this purpose, the Collision Detector node was introduced.
It works similarly to the Collision Monitor, but does not affect the robot’s velocity. It will only inform that data from the configured sources has been detected within the configured polygons via message to the collision_detector_state
topic.
Features
Similarly to the Collision Monitor, the Collision Detector uses polygons relative the robot’s base frame origin to define “zones”.
However, unlike the Collision Monitor that uses different behavior models, the Collision Detector does not use any of them and therefore the action_type
should always be set to none
. If set to anything else, it will implicitly be set to none
and yield a warning.
The zones around the robot and the data sources are the same as for the Collision Monitor, with the exception of the footprint polygon, which is not supported by the Collision Detector.
Configuration
Detailed configuration parameters, their description and how to setup a Collision Detector could be found at its Configuration Guide.
Wiki Tutorials
Package Dependencies
System Dependencies
Dependant Packages
Name | Deps |
---|---|
navigation2 |
Launch files
Messages
Services
Plugins
Recent questions tagged nav2_collision_monitor at Robotics Stack Exchange
|
Package Summary
Tags | No category tags. |
Version | 1.3.3 |
License | Apache-2.0 |
Build type | AMENT_CMAKE |
Use | RECOMMENDED |
Repository Summary
Checkout URI | https://github.com/ros-planning/navigation2.git |
VCS Type | git |
VCS Version | jazzy |
Last Updated | 2024-11-21 |
Dev Status | DEVELOPED |
CI status | No Continuous Integration |
Released | RELEASED |
Tags | No category tags. |
Contributing |
Help Wanted (0)
Good First Issues (0) Pull Requests to Review (0) |
Package Description
Additional Links
Maintainers
- Alexey Merzlyakov
- Steve Macenski
Authors
Nav2 Collision Monitor
Collision Monitor
The Collision Monitor is a node providing an additional level of robot safety. It performs several collision avoidance related tasks using incoming data from the sensors, bypassing the costmap and trajectory planners, to monitor for and prevent potential collisions at the emergency-stop level.
This is analogous to safety sensor and hardware features; take in laser scans from a real-time certified safety scanner, detect if there is to be an imminent collision in a configurable bounding box, and either emergency-stop the certified robot controller or slow the robot to avoid such collision. However, this node is done at the CPU level with any form of sensor. As such, this does not provide hard real-time safety certifications, but uses the same types of techniques with the same types of data for users that do not have safety-rated laser sensors, safety-rated controllers, or wish to use any type of data input (e.g. pointclouds from depth or stereo or range sensors).
This is a useful and integral part of large heavy industrial robots, or robots moving with high velocities, around people or other dynamic agents (e.g. other robots) as a safety mechanism for high-response emergency stopping. The costmaps / trajectory planners will handle most situations, but this is to handle obstacles that virtually appear out of no where (from the robot’s perspective) or approach the robot at such high speed it needs to immediately stop to prevent collision.
Demonstration of Collision Monitor abilities presented at 6th ROS Developers Day 2023, could be found below:
Features
The Collision Monitor uses polygons relative the robot’s base frame origin to define “zones”. Data that fall into these zones trigger an operation depending on the model being used. A given instance of the Collision Monitor can have many zones with different models at the same time. When multiple zones trigger at once, the most aggressive one is used (e.g. stop > slow 50% > slow 10%).
The following models of safety behaviors are employed by Collision Monitor:
-
Stop model: Define a zone and a point threshold. If more that
N
obstacle points appear inside this area, stop the robot until the obstacles will disappear. -
Slowdown model: Define a zone around the robot and slow the maximum speed for a
%S
percent, if more thanN
points will appear inside the area. -
Approach model: Using the current robot speed, estimate the time to collision to sensor data. If the time is less than
M
seconds (0.5, 2, 5, etc…), the robot will slow such that it is now at leastM
seconds to collision. The effect here would be to keep the robot alwaysM
seconds from any collision.
The zones around the robot can take the following shapes:
- Arbitrary user-defined polygon relative to the robot base frame, which can be static in a configuration file or dynamically changing via a topic interface.
- Robot footprint polygon, which is used in the approach behavior model only. Will use the static user-defined polygon or the footprint topic to allow it to be dynamically adjusted over time.
- Circle: is made for the best performance and could be used in the cases where the zone or robot footprint could be approximated by round shape.
- VelocityPolygon: allow switching of polygons based on the command velocity. When the velocity is covered by multiple sub polygons, the first sub polygon in the
velocity_polygons
list will be used. This is useful for robots to set different safety zones based on their velocity (e.g. a robot that has a larger safety zone when moving at 1.0 m/s than when moving at 0.5 m/s).
The data may be obtained from different data sources:
- Laser scanners (
sensor_msgs::msg::LaserScan
messages) - PointClouds (
sensor_msgs::msg::PointCloud2
messages) - IR/Sonars (
sensor_msgs::msg::Range
messages)
Design
The Collision Monitor is designed to operate below Nav2 as an independent safety node.
This acts as a filter on the cmd_vel
topic coming out of the Controller Server. If no such zone is triggered, then the Controller’s cmd_vel
is used. Else, it is scaled or set to stop as appropriate.
The following diagram is showing the high-level design of Collision Monitor module. All shapes (Polygon
, Circle
and VelocityPolygon
) are derived from base Polygon
class, so without loss of generality we can call them as polygons. Subscribed footprint is also having the same properties as other polygons, but it is being obtained a footprint topic for the Approach Model.
VelocityPolygon
can be configured with multiple sub polygons and can switch between them based on the velocity.
Configuration
Detailed configuration parameters, their description and how to setup a Collision Monitor could be found at its Configuration Guide and Using Collision Monitor tutorial pages.
Metrics
Designed to be used in wide variety of robots (incl. moving fast) and have a high level of reliability, Collision Monitor node should operate at fast rates. Typical one frame processing time is ~4-5ms for laser scanner (with 360 points) and ~4-20ms for PointClouds (having 24K points). The table below represents the details of operating times for different behavior models and shapes:
Stop/Slowdown/Limit model, Polygon area | Stop/Slowdown/Limit model, Circle area | Approach model, Polygon footprint | Approach model, Circle footprint | |
---|---|---|---|---|
LaserScan (360 points) processing time, ms | 4.45 | 4.45 | 4.93 | 4.86 |
PointCloud (24K points) processing time, ms | 4.94 | 4.06 | 20.67 | 10.87 |
The following notes could be made:
- Due to sheer speed, circle shapes are preferred for the approach behavior models if you can approximately model your robot as circular.
- More points mean lower performance. Pointclouds could be culled or filtered before the Collision Monitor to improve performance.
Collision Detector
In some cases, the user may want to be informed about the detected obstacles without affecting the robot’s velocity and instead take a different action within an external node. For example, the user may want to blink LEDs or sound an alarm when the robot is close to an obstacle. Another use case could be to detect data points in particular regions (e.g extremely close to the sensor) and warn of malfunctioning sensors. For this purpose, the Collision Detector node was introduced.
It works similarly to the Collision Monitor, but does not affect the robot’s velocity. It will only inform that data from the configured sources has been detected within the configured polygons via message to the collision_detector_state
topic.
Features
Similarly to the Collision Monitor, the Collision Detector uses polygons relative the robot’s base frame origin to define “zones”.
However, unlike the Collision Monitor that uses different behavior models, the Collision Detector does not use any of them and therefore the action_type
should always be set to none
. If set to anything else, it will implicitly be set to none
and yield a warning.
The zones around the robot and the data sources are the same as for the Collision Monitor, with the exception of the footprint polygon, which is not supported by the Collision Detector.
Configuration
Detailed configuration parameters, their description and how to setup a Collision Detector could be found at its Configuration Guide.
The CollisionMonitor
node makes use of a nav2_util::TwistSubscriber.
Wiki Tutorials
Package Dependencies
System Dependencies
Dependant Packages
Name | Deps |
---|---|
navigation2 |