2020-03-02 21:35:50 +08:00
# CARLA Documentation
2017-09-07 21:55:41 +08:00
2020-02-22 00:39:16 +08:00
Welcome to the CARLA documentation.
2020-02-21 21:50:40 +08:00
2020-03-11 20:53:27 +08:00
This home page contains an index with a brief description of the different sections in the documentation. Feel free to read in whatever order preferred. In any case, here are a few suggestions for newcomers.
2020-02-21 21:50:40 +08:00
2020-03-11 20:53:27 +08:00
* __Install CARLA.__ Either follow the [Quick start installation ](start_quickstart.md ) to get a CARLA release or [make the build ](build_linux.md ) for a desired platform.
* __Start using CARLA.__ The section titled [First steps ](core_concepts.md ) is an introduction to the most important concepts.
* __Check the API.__ there is a handy [Python API reference ](python_api.md ) to look up the classes and methods available.
2020-02-21 21:50:40 +08:00
2020-03-11 20:53:27 +08:00
The CARLA forum is available to post any doubts or suggestions that may arise during the reading.
2020-02-22 00:39:16 +08:00
< div class = "build-buttons" >
< a href = "https://forum.carla.org/" target = "_blank" class = "btn btn-neutral" title = "Go to the latest CARLA release" >
CARLA forum< / a >
< / div >
2017-09-07 21:55:41 +08:00
2020-03-02 21:35:50 +08:00
!!! Important
2020-03-11 20:53:27 +08:00
This documentation refers to CARLA 0.9.0 or later. To read about previous versions, check the [stable branch ](https://carla.readthedocs.io/en/stable/ ).
2017-09-07 21:55:41 +08:00
2020-03-02 21:35:50 +08:00
---
## Getting started
2020-02-22 00:39:16 +08:00
< p style = "padding-left:30px;line-height:1.8" >
2020-03-11 20:53:27 +08:00
[__Introduction__ ](start_introduction.md )
— What to expect from CARLA.
[__Quick start__ ](start_quickstart.md )
2020-03-02 23:31:54 +08:00
— Get the CARLA releases.
2020-02-22 00:39:16 +08:00
< / p >
2017-09-07 21:55:41 +08:00
2020-03-02 21:35:50 +08:00
## Building CARLA
2020-02-22 00:39:16 +08:00
< p style = "padding-left:30px;line-height:1.8" >
2020-03-11 20:53:27 +08:00
[__Linux build__ ](build_linux.md )
2020-02-22 00:39:16 +08:00
— Make the build on Linux.
2020-03-11 20:53:27 +08:00
[__Windows build__ ](build_windows.md )
2020-02-22 00:39:16 +08:00
— Make the build on Windows.
2020-03-11 20:53:27 +08:00
[__Update CARLA__ ](build_update.md )
2020-02-22 00:39:16 +08:00
— Get up to date with the latest content.
2020-03-11 20:53:27 +08:00
[__Build system__ ](build_system.md )
2020-02-22 00:39:16 +08:00
— Learn about the build and how it is made.
2020-03-11 20:53:27 +08:00
[__Running in a Docker__ ](build_docker.md )
2020-02-22 00:39:16 +08:00
— Run CARLA using a container solution.
2020-03-11 20:53:27 +08:00
[__F.A.Q.__ ](build_faq.md )
— Some of the most frequent installation issues.
2020-02-22 00:39:16 +08:00
< / p >
2018-03-22 01:16:56 +08:00
2020-03-02 21:35:50 +08:00
## First steps
2020-02-22 00:39:16 +08:00
< p style = "padding-left:30px;line-height:1.8" >
2020-03-11 20:53:27 +08:00
[__Core concepts__ ](core_concepts.md )
2020-02-22 00:39:16 +08:00
— Overview of the basic concepts in CARLA.
2020-03-11 20:53:27 +08:00
[__1st. World and client__ ](core_world.md )
2020-02-22 00:39:16 +08:00
— Manage and access the simulation.
2020-03-11 20:53:27 +08:00
[__2nd. Actors and blueprints__ ](core_actors.md )
2020-02-22 00:39:16 +08:00
— Learn about actors and how to handle them.
2020-03-11 20:53:27 +08:00
[__3rd. Maps and navigation__ ](core_map.md )
— Discover the different maps and how do vehicles move around.
[__4th. Sensors and data__ ](core_sensors.md )
2020-02-22 00:39:16 +08:00
— Retrieve simulation data using sensors.
2020-03-11 20:53:27 +08:00
< / p >
2020-02-22 00:39:16 +08:00
2020-03-02 21:35:50 +08:00
## Advanced steps
2020-02-22 00:39:16 +08:00
< p style = "padding-left:30px;line-height:1.8" >
2020-03-11 20:53:27 +08:00
[__Recorder__ ](adv_recorder.md )
— Register the events in a simulation and play it again.
[__Rendering options__ ](adv_rendering_options.md )
— From quality settings to no-render or off-screen modes.
[__Synchrony and time-step__ ](adv_synchrony_timestep.md )
2020-02-22 00:39:16 +08:00
— Client-server communication and simulation time.
2020-03-11 20:53:27 +08:00
[__Traffic Manager__ ](adv_traffic_manager.md )
— Simulate urban traffic by setting vehicles to autopilot mode.
< / p >
2020-02-22 00:39:16 +08:00
2020-03-02 21:35:50 +08:00
## References
2020-02-22 00:39:16 +08:00
< p style = "padding-left:30px;line-height:1.8" >
2020-03-11 20:53:27 +08:00
[__Python API reference__ ](python_api.md )
2020-02-22 00:39:16 +08:00
— Classes and methods in the Python API.
2020-03-11 20:53:27 +08:00
[__Code recipes__ ](ref_code_recipes.md )
— Some code fragments commonly used.
[__Blueprint library__ ](bp_library.md )
2020-02-22 00:39:16 +08:00
— Blueprints provided to spawn actors.
2020-03-11 20:53:27 +08:00
[__C++ reference__ ](ref_cpp.md )
2020-02-22 00:39:16 +08:00
— Classes and methods in CARLA C++.
2020-03-11 20:53:27 +08:00
[__Recorder binary file format__ ](ref_recorder_binary_file_format.md )
2020-02-22 00:39:16 +08:00
— Detailed explanation of the recorder file format.
2020-03-11 20:53:27 +08:00
[__Sensors reference__ ](ref_sensors.md )
2020-02-22 00:39:16 +08:00
— Everything about sensors and the data they retrieve.
2020-03-04 22:00:35 +08:00
## ROS bridge
< p style = "padding-left:30px;line-height:1.8" >
2020-03-11 20:53:27 +08:00
[__ROS bridge installation__ ](ros_installation.md )
— The different ways to install the ROS bridge.
[__CARLA messages reference__ ](ros_msgs.md )
2020-03-06 19:41:54 +08:00
— Contains explanations and fields for every type of CARLA message available in ROS.
2020-03-11 20:53:27 +08:00
[__Launchfiles reference__ ](ros_launchs.md )
— Lists the launchfiles and nodes provided, and the topics being consumed and published.
< / p >
2020-03-04 22:00:35 +08:00
2020-03-02 21:35:50 +08:00
## Tutorials — General
2020-02-22 00:39:16 +08:00
< p style = "padding-left:30px;line-height:1.8" >
2020-03-11 20:53:27 +08:00
[__Add friction triggers__ ](tuto_G_add_friction_triggers.md )
2020-02-22 00:39:16 +08:00
— Define dynamic box triggers for wheels.
2020-03-11 20:53:27 +08:00
[__Control vehicle physics__ ](tuto_G_control_vehicle_physics.md )
2020-02-22 00:39:16 +08:00
— Set runtime changes on a vehicle physics.
2020-03-11 20:53:27 +08:00
[__Control walker skeletons__ ](tuto_G_control_walker_skeletons.md )
— Animate walkers using skeletons.
< / p >
2020-02-22 00:39:16 +08:00
2020-03-02 21:35:50 +08:00
## Tutorials — Assets
2020-02-22 00:39:16 +08:00
< p style = "padding-left:30px;line-height:1.8" >
2020-03-11 20:53:27 +08:00
[__Import new assets__ ](tuto_A_import_assets.md )
2020-02-22 00:39:16 +08:00
— Use personal assets in CARLA.
2020-03-11 20:53:27 +08:00
[__Map creation__ ](tuto_A_map_creation.md )
— Create a new map following simple guidelines.
[__Map customization__ ](tuto_A_map_customization.md )
2020-03-02 21:35:50 +08:00
— Edit an existing map.
2020-03-11 20:53:27 +08:00
[__Standalone asset packages__ ](tuto_A_standalone_packages.md )
— Import assets into UE and set them for package distribution.
[__Use Epic's Automotive materials__ ](tuto_A_epic_automotive_materials.md )
— Apply Epic's set of Automotive materials to vehicles.
[__Vehicle modelling__ ](tuto_A_vehicle_modelling.md )
— Create a new vehicle for CARLA.
< / p >
2020-02-22 00:39:16 +08:00
2020-03-02 21:35:50 +08:00
## Tutorials — Developers
2020-02-22 00:39:16 +08:00
< p style = "padding-left:30px;line-height:1.8" >
2020-03-11 20:53:27 +08:00
[__Contribute with new assets__ ](tuto_D_contribute_assets.md )
2020-03-02 21:35:50 +08:00
— Add new content to CARLA.
2020-03-11 20:53:27 +08:00
[__Create a sensor__ ](tuto_D_create_sensor.md )
— Develop a new sensor to be used in CARLA.
[__Make a release__ ](tuto_D_make_release.md )
2020-02-22 00:39:16 +08:00
— For developers who want to publish a release.
2020-03-11 20:53:27 +08:00
[__Generate pedestrian navigation__ ](tuto_D_generate_pedestrian_navigation.md )
— Obtain the information needed for walkers to move around.
< / p >
2018-03-22 01:16:56 +08:00
2020-03-02 21:35:50 +08:00
## Contributing
2020-02-22 00:39:16 +08:00
< p style = "padding-left:30px;line-height:1.8" >
2020-03-11 20:53:27 +08:00
[__Contribution guidelines__ ](cont_contribution_guidelines.md )
2020-02-22 00:39:16 +08:00
— The different ways to contribute to CARLA.
2020-03-11 20:53:27 +08:00
[__Code of conduct__ ](cont_code_of_conduct.md )
— Standard rights and duties for contributors.
[__Coding standard__ ](cont_coding_standard.md )
2020-02-22 00:39:16 +08:00
— Guidelines to write proper code.
2020-03-11 20:53:27 +08:00
[__Documentation standard__ ](cont_doc_standard.md )
— Guidelines to write proper documentation.
< / p >