carla/Docs/index.md

157 lines
7.1 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
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
* __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
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
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">
[__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">
[__Linux build__](build_linux.md)
2020-02-22 00:39:16 +08:00
— Make the build on Linux.
[__Windows build__](build_windows.md)
2020-02-22 00:39:16 +08:00
— Make the build on Windows.
[__Update CARLA__](build_update.md)
2020-02-22 00:39:16 +08:00
— Get up to date with the latest content.
[__Build system__](build_system.md)
2020-02-22 00:39:16 +08:00
— Learn about the build and how it is made.
[__Running in a Docker__](build_docker.md)
2020-02-22 00:39:16 +08:00
— Run CARLA using a container solution.
[__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">
[__Core concepts__](core_concepts.md)
2020-02-22 00:39:16 +08:00
— Overview of the basic concepts in CARLA.
[__1st. World and client__](core_world.md)
2020-02-22 00:39:16 +08:00
— Manage and access the simulation.
[__2nd. Actors and blueprints__](core_actors.md)
2020-02-22 00:39:16 +08:00
— Learn about actors and how to handle them.
[__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.
</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-04-14 07:06:16 +08:00
[__OpenDRIVE standalone mode__](adv_opendrive.md)
2020-04-15 08:51:17 +08:00
— Use any OpenDRIVE file as a CARLA map.
[__PTV-Vissim co-simulation__](adv_ptv.md)
— Run a synchronous simulation between CARLA and PTV-Vissim.
[__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.
[__RSS sensor__](adv_rss.md)
— An implementation of RSS in the CARLA client library.
2020-04-14 07:06:16 +08:00
[__SUMO co-simulation__](adv_sumo.md)
— Run a synchronous simulation between CARLA and SUMO.
[__Synchrony and time-step__](adv_synchrony_timestep.md)
2020-02-22 00:39:16 +08:00
— Client-server communication and simulation time.
[__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">
[__Python API reference__](python_api.md)
2020-02-22 00:39:16 +08:00
— Classes and methods in the Python API.
[__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.
[__C++ reference__](ref_cpp.md)
2020-02-22 00:39:16 +08:00
— Classes and methods in CARLA C++.
[__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.
[__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">
[__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.
[__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">
[__Add friction triggers__](tuto_G_add_friction_triggers.md)
2020-02-22 00:39:16 +08:00
— Define dynamic box triggers for wheels.
[__Control vehicle physics__](tuto_G_control_vehicle_physics.md)
2020-02-22 00:39:16 +08:00
— Set runtime changes on a vehicle physics.
[__Control walker skeletons__](tuto_G_control_walker_skeletons.md)
— Animate walkers using skeletons.
[__Retrieve simulation data__](tuto_G_retrieve_data.md)
— A step by step guide to properly gather data using the recorder.
</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">
[__Add a new map__](tuto_A_add_map.md)
— Create and ingest a new map.
[__Add a new vehicle__](tuto_A_add_vehicle.md)
— Prepare a vehicle to be used in CARLA.
[__Add new props__](tuto_A_add_props.md)
— Import additional props into CARLA.
[__Create standalone packages__](tuto_A_create_standalone.md)
— Generate and handle standalone packages for assets.
[__Map customization__](tuto_A_map_customization.md)
2020-03-02 21:35:50 +08:00
— Edit an existing map.
[__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">
[__Contribute with new assets__](tuto_D_contribute_assets.md)
2020-03-02 21:35:50 +08:00
— Add new content to CARLA.
[__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.
[__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">
[__Contribution guidelines__](cont_contribution_guidelines.md)
2020-02-22 00:39:16 +08:00
— The different ways to contribute to CARLA.
[__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.
[__Documentation standard__](cont_doc_standard.md)
— Guidelines to write proper documentation.
</p>