Skip to content

Commit 3d4ce55

Browse files
Re-order the launch items for the Nav2 tutorials; the previous order appeared unreliable. See clearpathrobotics/clearpath_nav2_demos#29 (#445)
1 parent 91e456a commit 3d4ce55

File tree

3 files changed

+19
-28
lines changed

3 files changed

+19
-28
lines changed

docs_versioned_docs/version-ros2jazzy/ros/tutorials/navigation_demos/localization.mdx

Lines changed: 4 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -29,12 +29,11 @@ to `false`.
2929

3030
:::
3131

32-
**1.** [Start the simulation and Nav2](nav2.mdx#launching-the-simulation-and-nav2)
33-
by following steps 1-3 of the Nav2 startup
34-
35-
**2.** Open a terminal and run
32+
To start localization using [AMCL](https://docs.nav2.org/configuration/packages/configuring-amcl.html)
33+
[follow the steps](nav2.mdx#launching-the-simulation-and-nav2) described in the Nav2
34+
startup. When you get to step 4, run
3635
```bash
37-
ros2 launch clearpath_nav2_demos localization.launch.py use_sim_time:=true
36+
ros2 launch clearpath_nav2_demos localiztion.launch.py use_sim_time:=true
3837
```
3938

4039
The default map used by `localization.launch.py` is a
@@ -43,8 +42,3 @@ If you are using a custom map, pass it in with the `map` launch argument:
4342
```bash
4443
ros2 launch clearpath_nav2_demos localization.launch.py use_sim_time:=true map:=/path/to/my/map.yaml
4544
```
46-
47-
**3.** [Start Rviz](nav2.mdx#launching-the-simulation-and-nav2) and set the robot's initial pose
48-
estimate by following steps 5-6 of the Nav2 startup
49-
50-
**4.** Give the robot a navigation goal using the [Nav2 Goal](nav2.mdx#nav2-goal) tool.

docs_versioned_docs/version-ros2jazzy/ros/tutorials/navigation_demos/nav2.mdx

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -30,23 +30,23 @@ ros2 launch clearpath_gz simulation.launch.py
3030

3131
If the simulation does not start automatically, press the large orange "play" button in the bottom left corner.
3232

33-
**3.** Open a second terminal and launch nav2:
34-
33+
**3.** Open a second terminal and start Rviz. If you are using a physical robot or running the simulation
34+
on an external server, this step must be should on your workstation, not on the robot or simulation server itself.
3535
```
36-
ros2 launch clearpath_nav2_demos nav2.launch.py use_sim_time:=true
36+
ros2 launch clearpath_viz view_navigation.launch.py namespace:=a300_0000 use_sim_time:=true
3737
```
3838

3939
**4.** Open a third terminal and start either [SLAM](slam.mdx) or [Localization](localization.mdx), depdending on
4040
whether or not you want to create a new map or use a pre-existing map.
4141

42-
**5.** Open a fourth terminal and start Rviz. If you are using a physical robot or running the simulation
43-
on an external server, this step must be should on your workstation, not on the robot or simulation server itself.
42+
**5.** Set the initial pose of the robot using the [**2D Pose Estimate**](#2d-pose-estimate) tool in RViz.
43+
44+
**6.** Open fourth second terminal and launch nav2:
45+
4446
```
45-
ros2 launch clearpath_viz view_navigation.launch.py namespace:=a300_0000
47+
ros2 launch clearpath_nav2_demos nav2.launch.py use_sim_time:=true
4648
```
4749

48-
**6.** Set the initial pose of the robot using the [**2D Pose Estimate**](#2d-pose-estimate) tool in RViz.
49-
5050
**7.** Give the robot a navigation goal using the [**Nav2 Goal**](#nav2-goal) tool in RViz.
5151

5252
## Nav2 Tools in Rviz

docs_versioned_docs/version-ros2jazzy/ros/tutorials/navigation_demos/slam.mdx

Lines changed: 7 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -32,18 +32,15 @@ to `false`.
3232

3333
:::
3434

35-
**1.** [Start the simulation and Nav2](nav2.mdx#launching-the-simulation-and-nav2)
36-
by following steps 1-3 of the Nav2 startup
37-
38-
**2.** Open a terminal and run
35+
To start SLAM, [follow the steps](nav2.mdx#launching-the-simulation-and-nav2) described in the Nav2
36+
startup. When you get to step 4, run
3937
```bash
4038
ros2 launch clearpath_nav2_demos slam.launch.py use_sim_time:=true
4139
```
4240

43-
**3.** [Start Rviz](nav2.mdx#launching-the-simulation-and-nav2) and set the robot's initial pose
44-
estimate by following steps 5-6 of the Nav2 startup
41+
### Building the map
4542

46-
**4.** Drive the robot around the world. Ensure you have mapped the region you want the robot
43+
Drive the robot around the world. Ensure you have mapped the region you want the robot
4744
to navigate through autonomously.
4845

4946
<center>
@@ -56,10 +53,10 @@ to navigate through autonomously.
5653
</figure>
5754
</center>
5855

59-
**5.** Save the map by opening a new terminal and running
56+
### Saving the map
57+
58+
To save the map, open a new terminal and run
6059
```bash
6160
ros2 run nav2_map_server map_saver_cli -f "map_name"
6261
--ros-args -p map_subscribe_transient_local:=true -r __ns:=/a300_0000
6362
```
64-
65-
**6.** Give the robot a navigation goal using the [Nav2 Goal](nav2.mdx#nav2-goal) tool.

0 commit comments

Comments
 (0)