Added section explaining layered and non-layered maps. Moved map images to hyperlinks accessible from the map table
This commit is contained in:
parent
198fa38c9b
commit
c83f8dd127
|
@ -12,6 +12,8 @@ After discussing about the world and its actors, it is time to put everything in
|
|||
* [Navigating through waypoints](#navigating-through-waypoints)
|
||||
* [Generating a map navigation](#generating-a-map-navigation)
|
||||
* [__CARLA maps__](#carla-maps)
|
||||
* [Non-layered maps](#non-layered-maps)
|
||||
* [Layered maps](#layered-maps)
|
||||
|
||||
---
|
||||
## The map
|
||||
|
@ -175,49 +177,59 @@ info_map = map.to_opendrive()
|
|||
---
|
||||
## CARLA maps
|
||||
|
||||
So far there are seven different maps available. Each one has unique features and is useful for different purposes. Hereunder is a brief sum up on them.
|
||||
There are seven towns in the CARLA ecosystem and each of those towns have two kinds of map, non-layered and layered. [Layers][layer_api] refer to the grouped objects within a map and consist of the following:
|
||||
|
||||
- NONE
|
||||
- Buildings
|
||||
- Decals
|
||||
- Foliage
|
||||
- Ground
|
||||
- ParkedVehicles
|
||||
- Particles
|
||||
- Props
|
||||
- StreetLights
|
||||
- Walls
|
||||
- All
|
||||
|
||||
[layer_api]: https://carla.readthedocs.io/en/latest/python_api/#carlamaplayer
|
||||
|
||||
### Non-layered maps
|
||||
|
||||
Non-layered maps are shown in the table below (click the town name to see an overhead image of the layout). All of the layers are present at all times and cannot be toggled on or off in these maps. Up until CARLA 0.9.11, these were the only kinds of map available.
|
||||
|
||||
!!! Note
|
||||
Users can [customize a map](tuto_A_map_customization.md) or even [create a new map](tuto_A_add_map.md) to be used in CARLA.
|
||||
|
||||
| Town | Summary |
|
||||
| -------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| **Town01** | A basic town layout with all "T junctions". |
|
||||
| **Town02** | Similar to **Town01**, but smaller. |
|
||||
| **Town03** | The most complex town, with a 5-lane junction, a roundabout, unevenness, a tunnel, and much more. Essentially a medley. |
|
||||
| **Town04** | An infinite loop with a highway and a small town. |
|
||||
| **Town05** | Squared-grid town with cross junctions and a bridge. It has multiple lanes per direction. Useful to perform lane changes. |
|
||||
| **Town06** | Long highways with many highway entrances and exits. It also has a [**Michigan left**](<https://en.wikipedia.org/wiki/Michigan_left>). |
|
||||
| **Town07** | A rural environment with narrow roads, barely non traffic lights and barns. |
|
||||
| **Town10** | A city environment with with different environments such as an avenue or a promenade, and more realistic textures. |
|
||||
| Town | Summary |
|
||||
| -----------| ------ |
|
||||
| **[Town01](img/Town01.jpg)** | A basic town layout consisting of "T junctions".|
|
||||
| **[Town02](img/Town02.jpg)** | Similar to **Town01**, but smaller.|
|
||||
| **[Town03](img/Town03.jpg)** | The most complex town, with a 5-lane junction, a roundabout, unevenness, a tunnel, and more.|
|
||||
| **[Town04](img/Town04.jpg)** | An infinite loop with a highway and a small town.|
|
||||
| **[Town05](img/Town05.jpg)** | Squared-grid town with cross junctions and a bridge. It has multiple lanes per direction. Useful to perform lane changes. |
|
||||
| **[Town06](img/Town06.jpg)** | Long highways with many highway entrances and exits. It also has a [**Michigan left**](<https://en.wikipedia.org/wiki/Michigan_left>). |
|
||||
| **[Town07](img/Town07.jpg)** | A rural environment with narrow roads, barns and hardly any traffic lights. |
|
||||
| **[Town10](img/Town10.jpg)** | A city environment with different environments such as an avenue or promenade, and more realistic textures.|
|
||||
|
||||
<br>
|
||||
### Layered maps
|
||||
|
||||
The layout of layered maps is the same as non-layered maps but it is possible to toggle off and on the layers of the map. Layered maps can be idenitified by the suffix `_Opt`, for example, `Town01_Opt`. With these maps it is possible to [load][load_layer] and [unload][unload_layer] layers via the Python API:
|
||||
|
||||
![Town01](img/Town01.jpg)
|
||||
*Above: Town01*
|
||||
# Load layered map for Town 01
|
||||
world = client.load_world('Town01_Opt')
|
||||
|
||||
![Town02](img/Town02.jpg)
|
||||
*Above: Town02*
|
||||
# Toggle all buildings off
|
||||
world.unload_map_layer(carla.MapLayer.Buildings)
|
||||
|
||||
![Town03](img/Town03.jpg)
|
||||
*Above: Town03*
|
||||
# Toggle all buildings on
|
||||
world.load_map_layer(carla.MapLayer.Buildings)
|
||||
|
||||
![Town04](img/Town04.jpg)
|
||||
*Above: Town04*
|
||||
[load_layer]: https://carla.readthedocs.io/en/latest/python_api/#carla.World.load_map_layer
|
||||
[unload_layer]: https://carla.readthedocs.io/en/latest/python_api/#carla.World.unload_map_layer
|
||||
|
||||
![Town05](img/Town05.jpg)
|
||||
*Above: Town05*
|
||||
|
||||
![Town06](img/Town06.jpg)
|
||||
*Above: Town06*
|
||||
|
||||
![Town07](img/Town07.jpg)
|
||||
*Above: Town07*
|
||||
|
||||
![Town10](img/Town10.jpg)
|
||||
*Above: Town10*
|
||||
See an example of all layers being loaded and unloaded in sequence:
|
||||
|
||||
![map-layers](img/sublevels.gif)
|
||||
|
||||
<br>
|
||||
|
||||
|
|
Binary file not shown.
After Width: | Height: | Size: 3.3 MiB |
Loading…
Reference in New Issue