|
1 | | -.. _setup_guides: |
2 | | - |
3 | | -First-Time Robot Setup Guide |
4 | | -############################ |
5 | | - |
6 | | -This section is a collection of guides that aims to provide readers a good resource for setting up Nav2. The objectives for this section are as follows: |
7 | | - |
8 | | -- Help new users with setting up Navigation2 with a new robot |
9 | | -- Help people with custom built robots to properly set up their robots to be used in ROS/Navigation2 |
10 | | -- Act as a checklist, template or boilerplate reference for more experienced readers |
11 | | -- Provide examples which can be run on simulators/tools like Gazebo or RViz to guide readers on the Nav2 setup process even without a physical robot. |
12 | | -- Broad strokes, tips, and tricks for configuring certain packages and integrating different components of the robot platform (sensors, odometry, etc.) |
13 | | - |
14 | | -To guide you through the first-time setup of your robot, we will be tackling the following topics: |
15 | | - |
16 | | -- Introduce TF2 and setup your robot URDF & SDF |
17 | | - |
18 | | -- Setup sensor sources for robot odometry |
19 | | -- Setup sensor sources for perception |
20 | | -- Configure round or arbitrary shaped footprints for your robot |
21 | | -- Select and set up planner and controller navigation plugins for your robot's navigation tasks |
22 | | -- Lifecycle node management for easy bringup of other related sensors or nodes |
23 | | - |
24 | | -There are tutorials below for the Gazebo Classic simulator and the Gazebo simulator. Gazebo Classic is used with ROS 2 Humble and previous ROS distributions, while Gazebo (Gazebo Harmonic or newer) is used with ROS 2 Jazzy or newer. |
25 | | - |
26 | | - |
27 | | -Table of Contents |
28 | | -================= |
29 | | - |
30 | | -.. raw:: html |
31 | | - |
32 | | - <div style="display: flex; gap: 20px;"> |
33 | | - |
34 | | - <div style="flex: 1; padding: 10px; border-right: 1px solid #ccc;"> |
35 | | - |
36 | | - <h3 style="text-align: center;">Gazebo</h3> |
37 | | - |
38 | | -.. toctree:: |
39 | | - :maxdepth: 1 |
40 | | - |
41 | | - transformation/setup_transforms.rst |
42 | | - urdf/setup_urdf.rst |
43 | | - sdf/setup_sdf.rst |
44 | | - odom/setup_odom_gz.rst |
45 | | - odom/setup_robot_localization.rst |
46 | | - sensors/setup_sensors_gz.rst |
47 | | - sensors/mapping_localization.rst |
48 | | - footprint/setup_footprint.rst |
49 | | - algorithm/select_algorithm.rst |
50 | | - |
51 | | -.. raw:: html |
52 | | - |
53 | | - </div> |
54 | | - |
55 | | - <div style="flex: 1; padding: 10px;"> |
56 | | - |
57 | | - <h3 style="text-align: center;">Gazebo Classic</h3> |
58 | | - |
59 | | -.. toctree:: |
60 | | - :maxdepth: 1 |
61 | | - |
62 | | - transformation/setup_transforms.rst |
63 | | - urdf/setup_urdf.rst |
64 | | - odom/setup_odom_gz_classic.rst |
65 | | - odom/setup_robot_localization.rst |
66 | | - sensors/setup_sensors_gz_classic.rst |
67 | | - sensors/mapping_localization.rst |
68 | | - footprint/setup_footprint.rst |
69 | | - algorithm/select_algorithm.rst |
70 | | - |
71 | | -.. raw:: html |
72 | | - |
73 | | - </div> |
74 | | - </div> |
75 | | - |
76 | | -.. note:: These tutorials are not meant to be full tuning and configuration guides since they only aim to help you get your robot up and running with a basic configuration. For more detailed discussions and guides on how to customize and tune Nav2 for your robot, head on to the :ref:`configuration` section. |
| 1 | +.. _setup_guides: |
| 2 | + |
| 3 | +First-Time Robot Setup Guide |
| 4 | +############################ |
| 5 | + |
| 6 | +This section is a collection of guides that aims to provide readers a good resource for setting up Nav2. The objectives for this section are as follows: |
| 7 | + |
| 8 | +- Help new users with setting up Navigation2 with a new robot |
| 9 | +- Help people with custom built robots to properly set up their robots to be used in ROS/Navigation2 |
| 10 | +- Act as a checklist, template or boilerplate reference for more experienced readers |
| 11 | +- Provide examples which can be run on simulators/tools like Gazebo or RViz to guide readers on the Nav2 setup process even without a physical robot. |
| 12 | +- Broad strokes, tips, and tricks for configuring certain packages and integrating different components of the robot platform (sensors, odometry, etc.) |
| 13 | + |
| 14 | +To guide you through the first-time setup of your robot, we will be tackling the following topics: |
| 15 | + |
| 16 | +- Introduce TF2 and setup your robot URDF & SDF |
| 17 | + |
| 18 | +- Setup sensor sources for robot odometry |
| 19 | +- Setup sensor sources for perception |
| 20 | +- Configure round or arbitrary shaped footprints for your robot |
| 21 | +- Select and set up planner and controller navigation plugins for your robot's navigation tasks |
| 22 | +- Lifecycle node management for easy bringup of other related sensors or nodes |
| 23 | + |
| 24 | +There are tutorials below for the Gazebo Classic simulator and the Gazebo simulator. Gazebo Classic is used with ROS 2 Humble and previous ROS distributions, while Gazebo (Gazebo Harmonic or newer) is used with ROS 2 Jazzy or newer. |
| 25 | + |
| 26 | + |
| 27 | +Table of Contents |
| 28 | +================= |
| 29 | + |
| 30 | +.. raw:: html |
| 31 | + |
| 32 | + <div style="display: flex; gap: 20px;"> |
| 33 | + |
| 34 | + <div style="flex: 1; padding: 10px; border-right: 1px solid #ccc;"> |
| 35 | + |
| 36 | + <h3 style="text-align: center;">Gazebo</h3> |
| 37 | + |
| 38 | +.. toctree:: |
| 39 | + :maxdepth: 1 |
| 40 | + |
| 41 | + transformation/setup_transforms.rst |
| 42 | + urdf/setup_urdf.rst |
| 43 | + sdf/setup_sdf.rst |
| 44 | + odom/setup_odom_gz.rst |
| 45 | + odom/setup_robot_localization.rst |
| 46 | + sensors/setup_sensors_gz.rst |
| 47 | + sensors/mapping_localization.rst |
| 48 | + footprint/setup_footprint.rst |
| 49 | + algorithm/select_algorithm.rst |
| 50 | + |
| 51 | +.. raw:: html |
| 52 | + |
| 53 | + </div> |
| 54 | + |
| 55 | + <div style="flex: 1; padding: 10px;"> |
| 56 | + |
| 57 | + <h3 style="text-align: center;">Gazebo Classic</h3> |
| 58 | + |
| 59 | +.. toctree:: |
| 60 | + :maxdepth: 1 |
| 61 | + |
| 62 | + transformation/setup_transforms.rst |
| 63 | + urdf/setup_urdf.rst |
| 64 | + odom/setup_odom_gz_classic.rst |
| 65 | + odom/setup_robot_localization.rst |
| 66 | + sensors/setup_sensors_gz_classic.rst |
| 67 | + sensors/mapping_localization.rst |
| 68 | + footprint/setup_footprint.rst |
| 69 | + algorithm/select_algorithm.rst |
| 70 | + |
| 71 | +.. raw:: html |
| 72 | + |
| 73 | + </div> |
| 74 | + </div> |
| 75 | + |
| 76 | +.. note:: These tutorials are not meant to be full tuning and configuration guides since they only aim to help you get your robot up and running with a basic configuration. For more detailed discussions and guides on how to customize and tune Nav2 for your robot, head on to the :ref:`configuration` section. |
0 commit comments