Skip to content

Commit 58e07af

Browse files
committed
add launch map page
Signed-off-by: ismetatabay <[email protected]> asd
1 parent c891e67 commit 58e07af

File tree

5 files changed

+57
-9
lines changed

5 files changed

+57
-9
lines changed

docs/how-to-guides/integrating-autoware/launch-autoware/.pages

+1
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,7 @@ nav:
22
- index.md
33
- Launch vehicle: vehicle
44
- Launch system: system
5+
- Launch map: map
56
- Launch sensing: sensing
67
- Launch localization: localization
78
- Launch perception: perception

docs/how-to-guides/integrating-autoware/launch-autoware/map/images/map_launch_flow.svg

+4
Loading
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
# Map Launch Files
2+
3+
## Overview
4+
5+
The Autoware map stacks start
6+
launching at `autoware_launch.xml` as we mentioned at [Launch Autoware](../index.md) page.
7+
The `autoware_launch` package includes `tier4_map_component.launch.xml`
8+
for starting map launch files invocation from `autoware_launch.xml`.
9+
This diagram describes some of the Autoware map launch files flow at `autoware_launch`
10+
and `autoware.universe` packages.
11+
12+
<figure markdown>
13+
![map-launch-flow](images/map_launch_flow.svg){ align=center }
14+
<figcaption>
15+
Autoware map launch flow diagram
16+
</figcaption>
17+
</figure>
18+
19+
The map.launch.py launch file from the tier4_map_launch package directly includes
20+
the necessary node definitions for mapping. In the current design of Autoware, the `lanelet2_map_loader`,
21+
`lanelet2_map_visualization`, `pointcloud_map_loader`, and `vector_map_tf_generator` composable
22+
nodes are included in the `map_container`.
23+
24+
We don't have many modification options in the map launching files
25+
(as the parameters are included in the config files).
26+
However, you can specify the names for your pointcloud and lanelet2 map during the launch
27+
(the default values are pointcloud_map.pcd and lanelet2_map.osm).
28+
For instance, if you wish to change your map file names, you can run Autoware using
29+
the following command line arguments:
30+
31+
```bash
32+
ros2 launch autoware_launch autoware.launch.xml ... pointcloud_map_file:=<YOUR-PCD-FILE-NAME> lanelet2_map_file:=<YOUR-LANELET2-MAP-NAME> ...
33+
```
34+
35+
Or you can change it on your `autoware.launch.xml` launch file:
36+
37+
```diff
38+
- <arg name="lanelet2_map_file" default="lanelet2_map.osm" description="lanelet2 map file name"/>
39+
+ <arg name="lanelet2_map_file" default="<YOUR-LANELET2-MAP-NAME>" description="lanelet2 map file name"/>
40+
- <arg name="pointcloud_map_file" default="pointcloud_map.pcd" description="pointcloud map file name"/>
41+
+ <arg name="pointcloud_map_file" default="<YOUR-PCD-FILE-NAME>" description="pointcloud map file name"/>
42+
```

docs/how-to-guides/integrating-autoware/launch-autoware/system/index.md

+5-5
Original file line numberDiff line numberDiff line change
@@ -39,11 +39,11 @@ the `system.launch.xml` from the `tier4_system_launch` package directly launches
3939
- [mrm_emergency_stop_operator](https://autowarefoundation.github.io/autoware.universe/main/system/mrm_emergency_stop_operator/)
4040
- [dummy_diag_publisher](https://autowarefoundation.github.io/autoware.universe/main/system/dummy_diag_publisher/)
4141

42-
We don't have many modification options here,
43-
but you can change your system_error_monitor parameter file path.
44-
For example,
45-
you can run autoware with the following command line arguments
46-
if you want to change your system_error_monitor.param.yaml file path:
42+
We don't have many modification options in the system launching files
43+
(as the parameters are included in config files),
44+
but you can modify the file path for the system_error_monitor parameter.
45+
For instance, if you want to change the path for your system_error_monitor.param.yaml file,
46+
you can run Autoware with the following command line argument:
4747

4848
```bash
4949
ros2 launch autoware_launch autoware.launch.xml ... system_error_monitor_param_path:=<YOUR-SYSTEM-ERROR-PARAM-PATH> ...

docs/how-to-guides/integrating-autoware/launch-autoware/vehicle/index.md

+5-4
Original file line numberDiff line numberDiff line change
@@ -25,10 +25,11 @@ the Autoware vehicle launch file flow within the `autoware_launch` and `autoware
2525
if we define an argument at the top-level launch,
2626
it will override the value on lower-level launches.
2727

28-
We don't have many modification options here, but you can disable vehicle_interface launching.
29-
For example,
30-
if you want
31-
to run robot_state_publisher but not `vehicle_interface` you can run autoware with the following command line arguments:
28+
We don't have many modification options in the vehicle launching files
29+
(as the parameters are included in the vehicle_launch repository),
30+
but you can choose to disable the vehicle_interface launch.
31+
For instance, if you want to run robot_state_publisher but not vehicle_interface,
32+
you can launch Autoware with the following command line arguments:
3233

3334
```bash
3435
ros2 launch autoware_launch autoware.launch.xml ... launch_vehicle_interface:=false ...

0 commit comments

Comments
 (0)