Skip to content

Commit 4431e53

Browse files
authored
Updated migration guide for new nav2 rviz panel (#826)
* Updated migration guide for new nav2 rviz panel Signed-off-by: Pau Reverté <pau.reverte@eurecat.org> * Passed pre-commit Signed-off-by: Pau Reverté <pau.reverte@eurecat.org> * Fixed title to match lenght of header text in 'Updated Nav2 RViz Panel' for migration guide Signed-off-by: Pau Reverté <pau.reverte@eurecat.org> --------- Signed-off-by: Pau Reverté <pau.reverte@eurecat.org>
1 parent 427a3a9 commit 4431e53

2 files changed

Lines changed: 29 additions & 0 deletions

File tree

migration/Kilted.rst

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -533,3 +533,32 @@ In `PR #5781 <https://github.com/ros-navigation/navigation2/pull/5781>`_, a new
533533
Default value:
534534

535535
- inscribed_obstacle_cost_value: 99
536+
537+
Updated Nav2 RViz Panel
538+
-----------------------
539+
540+
In `PR #5774 <https://github.com/ros-navigation/navigation2/pull/5774>`_, the Nav2 panel (``nav2_rviz_plugins``) has been redesigned to provide comprehensive control over navigation requests and unify goal management tools.
541+
542+
Key Improvements:
543+
544+
- **Dynamic Behavior Tree (BT) Selection**: Added a selector to specify a custom Behavior Tree XML file. This enables modifying navigation logic at runtime (e.g., specific recovery behaviors) for both ``NavigateToPose`` and ``NavigateThroughPoses`` requests.
545+
- **Manual Coordinate Entry**: Enables precise input of coordinates (X, Y, Theta) and frame_id via numeric fields, complementing the visual tool.
546+
547+
The UI workflow is now organized into two primary navigation modes:
548+
549+
1. **Single-Goal Navigation** (``NavigateToPose``) Designed for individual targets. The goal can be defined using the standard "Nav2 Goal" tool (clicking on the map) or by manually entering precise coordinates directly in the panel.
550+
551+
2. **Multiple-Goal Navigation** (``NavigateThroughPoses``, ``Waypoint Following`` ) Designed for executing sequences of poses. This mode utilizes a pose accumulation mode to build and manage a list of goals before execution:
552+
553+
- List Building: Poses can be added via a hybrid approach: using the "Nav2 Goal" tool, manually entering coordinates, or loading a YAML file.
554+
555+
- Editing: The list is fully interactive; users can modify specific pose parameters or remove individual goals from the sequence.
556+
557+
- Execution: Once the list is defined, navigation can be executed via ``NavigateThroughPoses`` or ``Waypoint Following`` actions.
558+
559+
.. image:: images/nav2_new_rviz_panel.gif
560+
:width: 800
561+
:alt: Multiple-Goal Navigation in Nav2 RViz Panel
562+
:align: center
563+
564+
GIF above shows how multiple-goal navigation is configured mixing visual goal setting and file loading for NavigateThroughPoses and Waypoint Following actions.
10.4 MB
Loading

0 commit comments

Comments
 (0)