carla/Docs/index.md

225 lines
7.5 KiB
Markdown
Raw Normal View History

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.
<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.