Generate Pedestrian Navigation
To allow pedestrians to navigate a map, you will need to generate a pedestrian navigation file. This guide details what meshes to use and how to generate the file.
- Before you begin
- Pedestrian navigable meshes
- Optional pedestrian navigation options
- Generate the pedestrian navigation
Before you begin
Map customization (adding buildings, painting the road, adding landscape features, etc.) should be completed before generating the pedestrian navigation in order to avoid interference or collisions between the two, resulting in the need to generate the pedestrian navigation a second time.
Pedestrian navigable meshes
Pedestrians can only navigate specific meshes. You need to name the meshes you want to include in pedestrian navigation according to the nomenclature in the table below:
||Pedestrians will walk over these meshes freely.|
||Pedestrians will walk over these meshes as a second option if no ground is found.|
||Pedestrians won't walk on this mesh unless you specify a percentage of them to do so.|
||Pedestrians will only cross roads through these meshes.|
Optional pedestrian navigation options
The following step is not necessary for generating a pedestrian navigation, but allows you to customize pedestrian activity to a certain extent.
- Generate new crosswalks.
Avoid doing this if the crosswalk is already defined the
.xodr file as this will lead to duplication:
- Create a plane mesh that extends a bit over two sidewalks that you want to connect.
- Place the mesh overlapping the ground and disable it's physics and rendering.
- Change the name of the mesh to
Generate the pedestrian navigation
1. To prevent the map being too large to export, select the BP_Sky object and add a tag
NoExport to it. If you have any other particularly large meshes that are not involved in the pedestrian navigation, add the
NoExport tag to them as well.
2. Double check your mesh names. Mesh names should start with any of the appropriate formats listed below in order to be recognized as areas where pedestrians can walk. By default, pedestrians will be able to walk over sidewalks, crosswalks, and grass (with minor influence over the rest):
- Sidewalk =
- Crosswalk =
- Grass =
ctrl + A to select everything and export the map by selecting
Carla Exporter. A
<mapName>.obj file will be created in
4. Move the
<mapName>.obj and the
5. Run the following command to generate the navigation file:
build.bat <mapName> # <mapName> has no extension
./build.sh <mapName> # <mapName> has no extension
<mapName>.bin file will be created. This file contains the information for pedestrian navigation on your map. Move this file to the
Nav folder of the package that contains the map.
7. Test the pedestrian navigation by starting a simulation and running the example script
If you have any questions about the process, then you can ask in the forum.