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-02-22 00:39:16 +08:00
|
|
|
This page contains the index with a brief explanation on the different sections for clarity.
|
|
|
|
Feel free to explore the documentation on your own, however, here are a few tips for newcomers:
|
2020-02-21 21:50:40 +08:00
|
|
|
|
2020-03-02 21:35:50 +08:00
|
|
|
* __Install CARLA__: visit the [Quickstart installation](start_quickstart.md) to get the CARLA releases or make the build for a desired platform.
|
|
|
|
* __Start using CARLA__: there is a section titled [First steps](core_concepts.md), highly recommended for newcomers.
|
|
|
|
* __Doubts on the API__: there is a handy [Python API reference](python_api.md) to consult classes and methods.
|
2020-02-21 21:50:40 +08:00
|
|
|
|
2020-02-22 00:39:16 +08:00
|
|
|
Besides that, there is also the CARLA forum where the community gathers to share issues, suggestions and solutions:
|
|
|
|
<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-02-22 00:39:16 +08:00
|
|
|
This is documentation for CARLA 0.9.0 or later. Previous documentation is in 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-02 21:35:50 +08:00
|
|
|
<a href="../start_introduction"><b>
|
2020-02-22 00:39:16 +08:00
|
|
|
Introduction
|
|
|
|
</b></a>
|
|
|
|
— Capabilities and intentions behind the project.
|
2020-03-02 21:35:50 +08:00
|
|
|
<a href="../start_quickstart"><b>
|
2020-02-22 00:39:16 +08:00
|
|
|
Quickstart installation
|
|
|
|
</b></a>
|
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-02 21:35:50 +08:00
|
|
|
<a href="../build_linux"><b>
|
2020-02-22 00:39:16 +08:00
|
|
|
Linux build
|
|
|
|
</b></a>
|
|
|
|
— Make the build on Linux.
|
2020-03-02 21:35:50 +08:00
|
|
|
<a href="../build_windows"><b>
|
2020-02-22 00:39:16 +08:00
|
|
|
Windows build
|
|
|
|
</b></a>
|
|
|
|
— Make the build on Windows.
|
2020-03-02 21:35:50 +08:00
|
|
|
<a href="../build_update"><b>
|
2020-02-22 00:39:16 +08:00
|
|
|
Update CARLA
|
|
|
|
</b></a>
|
|
|
|
— Get up to date with the latest content.
|
2020-03-02 21:35:50 +08:00
|
|
|
<a href="../build_system"><b>
|
2020-02-22 00:39:16 +08:00
|
|
|
Build system
|
|
|
|
</b></a>
|
|
|
|
— Learn about the build and how it is made.
|
2020-03-02 21:35:50 +08:00
|
|
|
<a href="../build_docker"><b>
|
2020-02-22 00:39:16 +08:00
|
|
|
Running in a Docker
|
|
|
|
</b></a>
|
|
|
|
— Run CARLA using a container solution.
|
2020-03-02 21:35:50 +08:00
|
|
|
<a href="../build_faq"><b>
|
2020-02-22 00:39:16 +08:00
|
|
|
F.A.Q.
|
|
|
|
</b></a>
|
2020-03-02 23:31:54 +08:00
|
|
|
— Some of the most frequent issues for newcomers.
|
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">
|
|
|
|
<a href="../core_concepts"><b>
|
|
|
|
Core concepts
|
|
|
|
</b></a>
|
|
|
|
— Overview of the basic concepts in CARLA.
|
|
|
|
<a href="../core_world"><b>
|
|
|
|
1st. World and client
|
|
|
|
</b></a>
|
|
|
|
— Manage and access the simulation.
|
|
|
|
<a href="../core_actors"><b>
|
|
|
|
2nd. Actors and blueprints
|
|
|
|
</b></a>
|
|
|
|
— Learn about actors and how to handle them.
|
|
|
|
<a href="../core_map"><b>
|
|
|
|
3rd. Maps and navigation
|
|
|
|
</b></a>
|
|
|
|
— Discover the different maps and how to move around.
|
|
|
|
<a href="../core_sensors"><b>
|
2020-03-02 21:35:50 +08:00
|
|
|
4th. Sensors and data
|
2020-02-22 00:39:16 +08:00
|
|
|
</b></a>
|
|
|
|
— Retrieve simulation data using sensors.
|
|
|
|
|
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-02 21:35:50 +08:00
|
|
|
<a href="../adv_recorder"><b>
|
2020-02-22 00:39:16 +08:00
|
|
|
Recorder
|
|
|
|
</b></a>
|
|
|
|
— Store all the events in a simulation a play it again.
|
2020-03-02 21:35:50 +08:00
|
|
|
<a href="../adv_rendering_options"><b>
|
2020-02-22 00:39:16 +08:00
|
|
|
Rendering options
|
|
|
|
</b></a>
|
|
|
|
— Different settings, from quality to no-render or off-screen runs.
|
2020-03-02 21:35:50 +08:00
|
|
|
<a href="../adv_synchrony_timestep"><b>
|
2020-02-22 00:39:16 +08:00
|
|
|
Synchrony and time-step
|
|
|
|
</b></a>
|
|
|
|
— Client-server communication and simulation time.
|
2020-03-04 01:10:51 +08:00
|
|
|
<a href="../adv_traffic_manager"><b>
|
|
|
|
Traffic Manager
|
|
|
|
</b></a>
|
2020-02-22 00:39:16 +08:00
|
|
|
— Feature to handle autopilot vehicles and emulate traffic.
|
|
|
|
|
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">
|
|
|
|
<a href="../python_api"><b>
|
|
|
|
Python API reference
|
|
|
|
</b></a>
|
|
|
|
— Classes and methods in the Python API.
|
2020-03-02 21:35:50 +08:00
|
|
|
<a href="../ref_code_recipes"><b>
|
2020-02-22 00:39:16 +08:00
|
|
|
Code recipes
|
|
|
|
</b></a>
|
|
|
|
— Code fragments commonly used.
|
|
|
|
<a href="../bp_library"><b>
|
|
|
|
Blueprint library
|
|
|
|
</b></a>
|
|
|
|
— Blueprints provided to spawn actors.
|
2020-03-02 21:35:50 +08:00
|
|
|
<a href="../ref_cpp"><b>
|
2020-02-22 00:39:16 +08:00
|
|
|
C++ reference
|
|
|
|
</b></a>
|
|
|
|
— Classes and methods in CARLA C++.
|
2020-03-02 21:35:50 +08:00
|
|
|
<a href="../ref_recorder_binary_file_format"><b>
|
2020-02-22 00:39:16 +08:00
|
|
|
Recorder binary file format
|
|
|
|
</b></a>
|
|
|
|
— Detailed explanation of the recorder file format.
|
|
|
|
<a href="../ref_sensors"><b>
|
2020-03-02 21:35:50 +08:00
|
|
|
Sensors reference
|
2020-02-22 00:39:16 +08:00
|
|
|
</b></a>
|
|
|
|
— 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">
|
|
|
|
<a href="../ros_installation"><b>
|
|
|
|
ROS bridge installation
|
|
|
|
</b></a>
|
|
|
|
— How to install the ROS bridge's package or repository.
|
|
|
|
<a href="../ros_msgs"><b>
|
|
|
|
CARLA messages reference
|
|
|
|
</b></a>
|
2020-03-06 19:41:54 +08:00
|
|
|
— Contains explanations and fields for every type of CARLA message available in ROS.
|
2020-03-04 22:00:35 +08:00
|
|
|
<a href="../ros_launchs"><b>
|
|
|
|
Launchfiles reference
|
|
|
|
</b></a>
|
2020-03-06 19:41:54 +08:00
|
|
|
— Explains the launchfiles provided, its nodes, and the topics that are being consumed and published.
|
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-02 21:35:50 +08:00
|
|
|
<a href="../tuto_G_add_friction_triggers"><b>
|
2020-02-22 00:39:16 +08:00
|
|
|
Add friction triggers
|
|
|
|
</b></a>
|
|
|
|
— Define dynamic box triggers for wheels.
|
2020-03-02 21:35:50 +08:00
|
|
|
<a href="../tuto_G_control_vehicle_physics"><b>
|
2020-02-22 00:39:16 +08:00
|
|
|
Control vehicle physics
|
|
|
|
</b></a>
|
|
|
|
— Set runtime changes on a vehicle physics.
|
2020-03-02 21:35:50 +08:00
|
|
|
<a href="../tuto_G_control_walker_skeletons"><b>
|
2020-02-22 00:39:16 +08:00
|
|
|
Control walker skeletons
|
|
|
|
</b></a>
|
|
|
|
— Skeleton and animation for walkers explained.
|
|
|
|
|
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-02 21:35:50 +08:00
|
|
|
<a href="../tuto_A_import_assets"><b>
|
2020-02-22 00:39:16 +08:00
|
|
|
Import new assets
|
|
|
|
</b></a>
|
|
|
|
— Use personal assets in CARLA.
|
2020-03-02 21:35:50 +08:00
|
|
|
<a href="../tuto_A_map_creation"><b>
|
2020-02-22 00:39:16 +08:00
|
|
|
Map creation
|
|
|
|
</b></a>
|
|
|
|
— Guidelines to create a new map.
|
2020-03-02 21:35:50 +08:00
|
|
|
<a href="../tuto_A_map_customization"><b>
|
|
|
|
Map customization
|
|
|
|
</b></a>
|
|
|
|
— Edit an existing map.
|
|
|
|
<a href="../tuto_A_standalone_packages"><b>
|
2020-02-22 00:39:16 +08:00
|
|
|
Standalone asset packages
|
|
|
|
</b></a>
|
|
|
|
— Import assets into Unreal Engine and prepare them for package distribution.
|
2020-03-02 21:35:50 +08:00
|
|
|
<a href="../tuto_A_epic_automotive_materials"><b>
|
|
|
|
Use Epic's Automotive materials
|
2020-02-22 00:39:16 +08:00
|
|
|
</b></a>
|
|
|
|
— Apply Epic's set of Automotive materials to vehicles for a more realistic painting.
|
2020-03-02 21:35:50 +08:00
|
|
|
<a href="../tuto_A_vehicle_modelling"><b>
|
2020-02-22 00:39:16 +08:00
|
|
|
Vehicle modelling
|
|
|
|
</b></a>
|
|
|
|
— Guidelines to create a new vehicle for CARLA.
|
|
|
|
|
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-02 21:35:50 +08:00
|
|
|
<a href="../tuto_D_contribute_assets"><b>
|
|
|
|
Contribute with new assets
|
|
|
|
</b></a>
|
|
|
|
— Add new content to CARLA.
|
|
|
|
<a href="../tuto_D_create_sensor"><b>
|
2020-02-22 00:39:16 +08:00
|
|
|
Create a sensor
|
|
|
|
</b></a>
|
|
|
|
— The basics on how to add a new sensor to CARLA.
|
2020-03-02 21:35:50 +08:00
|
|
|
<a href="../tuto_D_make_release"><b>
|
2020-02-22 00:39:16 +08:00
|
|
|
Make a release
|
|
|
|
</b></a>
|
|
|
|
— For developers who want to publish a release.
|
2020-03-02 21:35:50 +08:00
|
|
|
<a href="../tuto_D_generate_pedestrian_navigation"><b>
|
|
|
|
Generate pedestrian navigation
|
2020-02-22 00:39:16 +08:00
|
|
|
</b></a>
|
|
|
|
— Generate the information needed for walkers to navigate a map.
|
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-02 21:35:50 +08:00
|
|
|
<a href="../cont_contribution_guidelines"><b>
|
|
|
|
Contribution guidelines
|
2020-02-22 00:39:16 +08:00
|
|
|
</b></a>
|
|
|
|
— The different ways to contribute to CARLA.
|
2020-03-02 21:35:50 +08:00
|
|
|
<a href="../cont_code_of_conduct"><b>
|
|
|
|
Code of conduct
|
|
|
|
</b></a>
|
|
|
|
— Some standards for CARLA, rights and duties for contributors.
|
|
|
|
<a href="../cont_coding_standard"><b>
|
2020-02-22 00:39:16 +08:00
|
|
|
Coding standard
|
|
|
|
</b></a>
|
|
|
|
— Guidelines to write proper code.
|
2020-03-02 21:35:50 +08:00
|
|
|
<a href="../cont_doc_standard"><b>
|
2020-02-22 00:39:16 +08:00
|
|
|
Documentation standard
|
|
|
|
</b></a>
|
2020-03-02 21:35:50 +08:00
|
|
|
— Guidelines to write proper documentation.
|