Skip to content

Commit

Permalink
docs(map creation): update information (autowarefoundation#524)
Browse files Browse the repository at this point in the history
* docs(map creation): update information

Signed-off-by: Takamasa Horibe <[email protected]>

* Update docs/tutorials/ad-hoc-simulation/planning-simulation.md

Co-authored-by: Maxime CLEMENT <[email protected]>

---------

Signed-off-by: Takamasa Horibe <[email protected]>
Co-authored-by: Maxime CLEMENT <[email protected]>
  • Loading branch information
TakaHoribe and maxime-clem authored Feb 28, 2024
1 parent 70a2509 commit 1484051
Show file tree
Hide file tree
Showing 5 changed files with 19 additions and 1 deletion.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
14 changes: 13 additions & 1 deletion docs/how-to-guides/integrating-autoware/creating-maps/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,9 +12,21 @@ If you prefer proprietary software that is easy to use, you can try a fully auto

## Creating a vector map

The easiest way to create an Autoware-compatible vector map is to use [Vector Map Builder](https://tools.tier4.jp/feature/vector_map_builder_ll2/), a free web-based tool provided by [TIER IV, Inc.](https://www.tier4.jp/).
### Quick way to create simple maps

[bag2lanelet](https://autowarefoundation.github.io/autoware_tools/main/bag2lanelet/) is a tool to create virtual lanes from self-location data. Whether in a real environment or a simulation, you can use this tool to generate simple lanelets from a rosbag with self-location information, allowing you to quickly test Autoware's performance. A key use case for this tool is to emulate autonomous driving on routes that were initially driven manually.

![bag2lanelet](images/bag2lanelet.png)

However, it is important to note that this tool has very limited functionalities and can only generate single-lane maps. To enable more comprehensive mapping and navigation capabilities, we recommend using the 'Vector Map Builder' described in the next section.

### Tools for a vector map creation

The recommended way to create an Autoware-compatible vector map is to use [Vector Map Builder](https://tools.tier4.jp/feature/vector_map_builder_ll2/), a free web-based tool provided by [TIER IV, Inc.](https://www.tier4.jp/).
Vector Map Builder allows you to create lanes and add additional regulatory elements such as stop signs or traffic lights using a point cloud map as a reference.

![vector_map_builder](images/vector_map_builder.png)

For open-source software options, [MapToolbox](https://github.com/autocore-ai/MapToolbox) is a plugin for [Unity](https://unity.com/) specifically designed to create Lanelet2 maps for Autoware.
Although [JOSM](https://josm.openstreetmap.de/) is another open-source tool that can be used to create Lanelet2 maps, be aware that a number of modifications must be done manually to make the map compatible with Autoware. This process can be tedious and time-consuming, so the use of JOSM is not recommended.

Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
6 changes: 6 additions & 0 deletions docs/tutorials/ad-hoc-simulation/planning-simulation.md
Original file line number Diff line number Diff line change
Expand Up @@ -264,3 +264,9 @@ This section provides a step-by-step guide on using the Autoware Launch GUI for
- **Real-Time Monitoring:** Use the GUI to monitor CPU/Memory usage and Autoware logs in real-time.
- **Profile Management:** Save your simulation profiles for quick access in future simulations.
- **Adjusting Parameters:** Easily modify simulation parameters on-the-fly through the GUI.

## Want to Try Autoware with Your Custom Map?

The above content describes the process for conducting some operations in the planning simulator using a sample map. If you are interested in running Autoware with maps of your own environment, please visit the [How to Create Vector Map](https://autowarefoundation.github.io/autoware-documentation/main/how-to-guides/integrating-autoware/creating-maps/#creating-maps) section for guidance.

![psim-custom-map](images/planning/others/psim-custom-map.png)

0 comments on commit 1484051

Please sign in to comment.