Skip to content

Commit c9ef1af

Browse files
authored
Add OMNI analytic expansion migration guide entry for Kilted (#891)
Add documentation for PR #5965 which adds omnidirectional (OMNI) analytic expansion support to SmacPlannerLattice, with before/after images illustrating the path improvement for holonomic robots. Signed-off-by: Ron Danon <rondanon@gmail.com>
1 parent 5b2b926 commit c9ef1af

5 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
@@ -804,6 +804,35 @@ Add support for switching between SMAC planners
804804

805805
Prior to `PR 5840 <https://github.com/ros-navigation/navigation2/pull/5840>`_, switching between SMAC planners at runtime was not supported due to static variables in the SMAC planner implementations causing conflicts when multiple instances were created. The PR addressed this issue by refactoring the SMAC planner code to eliminate the use of static variables, allowing multiple instances of different SMAC planners to coexist without conflicts.
806806

807+
OMNI Analytic Expansion Support in SmacPlannerLattice
808+
-----------------------------------------------------
809+
810+
`PR #5965 <https://github.com/ros-navigation/navigation2/pull/5965>`_ adds omnidirectional (OMNI) analytic expansion support to ``SmacPlannerLattice``.
811+
When a lattice primitives file specifies ``motion_model: "omni"`` in its metadata, the planner now automatically:
812+
813+
- Uses ``SE2StateSpace`` (straight-line with linear heading interpolation) instead of Dubins/Reeds-Shepp for analytic expansion and distance heuristics
814+
- Skips turning-radius refinement in analytic path expansion (SE2 paths are radius-independent)
815+
- Configures the path smoother in holonomic mode
816+
- Disables ``allow_reverse_expansion`` with a warning (meaningless for omnidirectional robots)
817+
818+
No parameter changes are required — the OMNI motion model is auto-detected from the lattice file metadata.
819+
820+
Before:
821+
822+
.. image:: images/smac_lattice_omni_before_1.png
823+
:width: 418
824+
825+
.. image:: images/smac_lattice_omni_before_2.png
826+
:width: 418
827+
828+
After:
829+
830+
.. image:: images/smac_lattice_omni_after_1.png
831+
:width: 418
832+
833+
.. image:: images/smac_lattice_omni_after_2.png
834+
:width: 418
835+
807836
New bt_log_idle_transitions parameter in bt_navigator
808837
-----------------------------------------------------
809838

15.5 KB
Loading
14.2 KB
Loading
15.1 KB
Loading
16.2 KB
Loading

0 commit comments

Comments
 (0)