Skip to content

Commit b360af4

Browse files
feat: add split map tutorial (#477)
* docs: add using-divided-map tutorial Signed-off-by: kminoda <koji.minoda@tier4.jp> * update google drive link Signed-off-by: kminoda <koji.minoda@tier4.jp> * add related links Signed-off-by: kminoda <koji.minoda@tier4.jp> * style(pre-commit): autofix * add instruction for playing rosbag Signed-off-by: kminoda <koji.minoda@tier4.jp> --------- Signed-off-by: kminoda <koji.minoda@tier4.jp> Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
1 parent 6c5d6d6 commit b360af4

File tree

1 file changed

+30
-0
lines changed

1 file changed

+30
-0
lines changed
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
# Using divided pointcloud map
2+
3+
Divided pointcloud map is necessary when handling large pointcloud map, in which case Autoware may not be capable of sending the whole map via ROS 2 topic or loading the whole map into memory. By using the pre-divided map, Autoware will dynamically load the pointcloud map according to the vehicle's position.
4+
5+
## Tutorial
6+
7+
Download the [sample-map-rosbag_split](TODO) and locate the map under `$HOME/autoware_map/`.
8+
9+
```bash
10+
gdown -O ~/autoware_map/ 'https://docs.google.com/uc?export=download&id=11tLC9T4MS8fnZ9Wo0D8-Ext7hEDl2YJ4'
11+
unzip -d ~/autoware_map/ ~/autoware_map/sample-rosbag_split.zip
12+
```
13+
14+
Then, you may launch logging_simulator with the following command to load the divided map.
15+
Note that you need to specify the `map_path` and `pointcloud_map_file` arguments.
16+
17+
```bash
18+
source ~/autoware/install/setup.bash
19+
ros2 launch autoware_launch logging_simulator.launch.xml \
20+
map_path:=$HOME/autoware_map/sample-map-rosbag pointcloud_map_file:=pointcloud_map \
21+
vehicle_model:=sample_vehicle_split sensor_model:=sample_sensor_kit
22+
```
23+
24+
For playing rosbag to simulate Autoware, please refer to the instruction in [the tutorial for rosbag replay simulation](https://autowarefoundation.github.io/autoware-documentation/main/tutorials/ad-hoc-simulation/rosbag-replay-simulation/).
25+
26+
## Related links
27+
28+
- For specific format definition of the divided map, please refer to [Map component design page](https://autowarefoundation.github.io/autoware-documentation/main/design/autoware-architecture/map/)
29+
- [The Readme of map_loader](https://github.com/autowarefoundation/autoware.universe/tree/main/map/map_loader) may be useful specific instructions for dividing maps
30+
- When dividing your own pointcloud map, you may use [pointcloud_divider](https://github.com/MapIV/pointcloud_divider), which can divide the map as well as generating the compatible metadata

0 commit comments

Comments
 (0)