ITS Path Planner Workshop#
This tutorial runs the ITS path planner in a workshop. ITS is a Nav2 global planner plugin: it builds a roadmap from the 2D costmap and searches it from both ends. The workshop runs it in the TurtleBot3 Gazebo simulation, so no robot is needed.
You will:
Request a path from ITS without a display, to check the stack.
Plan and drive to goals interactively in Gazebo and RViz.
Prerequisites#
A host set up as described in Getting Started.
A local desktop session for the interactive simulation.
Launch the workshop#
cd src/components/its-planner/workshop
workshop launch its-planner
Check the planner#
Run the headless check:
workshop run its-planner plan-check
It starts the Nav2 stack with ITS, sets the robot’s spawn pose, requests a path, and prints its length and end points. On Jazzy, ITS returns a path of 78 poses and 4.07 m that ends on the goal. The action returns non-zero if ITS returns no path.
Plan interactively#
Connect the desktop and start the simulation:
workshop connect its-planner/robotics-ai-suite:desktop workshop run its-planner simulation
Gazebo and RViz open with a TurtleBot3 Waffle.
In RViz, click 2D Pose Estimate and set the robot’s pose on the map.
Click Nav2 Goal and set a goal. ITS plans a path, and the robot drives to the goal.
Press Ctrl+C in the terminal to stop the simulation.
To try the Ackermann variant, which plans with Dubins paths, run simulation-ackermann instead.
Actions#
Action |
Description |
|---|---|
|
The documented |
|
The same, with the Ackermann (Dubins path) variant |
|
Headless: the same Nav2 stack. Requests one path and prints it. Returns non-zero if ITS returns no path |
The planner saves its roadmap as road_map.txt in the working directory, so the actions run in ~/its_planner.
Humble#
Use its-planner-humble in every command. plan-check returns 81 poses and 4.12 m, ending on the goal.
its-planner and its-planner-humble were also run side by side on one ROS domain to test Humble and Jazzy interoperability. See Humble and Jazzy on the same domain.
Source#
The definitions, package list and check script are in src/components/its-planner/workshop/.