p71924506
/
carla
mirror of https://github.com/carla-simulator/carla.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

sergi-e/p098-index (#2573) 

* Fixing links and style.

* Command line summary added

* New table attempt

* Codacy fixes + default table css
This commit is contained in:
sergi.e 2020-03-11 13:53:27 +01:00 committed by GitHub
parent c7114e436b
commit e4cc150a3c
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
5 changed files with 198 additions and 217 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
Docs/extra.css
View File

@ -11,3 +11,28 @@
.vector-zero { .vector-zero {
text-align: center; text-align: center;
} }
table.defTable {
border: 1px solid #242424;
background-color: #f3f6f6;
text-align: left;
border-collapse: collapse;
}
table.defTable thead {
background: #ffffff;
border-bottom: 1px solid #444444;
}
table.defTable tr:nth-child(even) {
background: #ffffff;
}
table.defTable thead th {
padding: 7px 13px;
}
table.defTable tbody td{
padding: 7px 13px;
}

226
Docs/index.md
View File

@ -2,224 +2,144 @@
Welcome to the CARLA documentation. Welcome to the CARLA documentation.
This page contains the index with a brief explanation on the different sections for clarity. 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.
Feel free to explore the documentation on your own, however, here are a few tips for newcomers:
* __Install CARLA__: visit the [Quickstart installation](start_quickstart.md) to get the CARLA releases or make the build for a desired platform. * __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__: there is a section titled [First steps](core_concepts.md), highly recommended for newcomers. * __Start using CARLA.__ The section titled [First steps](core_concepts.md) is an introduction to the most important concepts.
* __Doubts on the API__: there is a handy [Python API reference](python_api.md) to consult classes and methods. * __Check the API.__ there is a handy [Python API reference](python_api.md) to look up the classes and methods available.
Besides that, there is also the CARLA forum where the community gathers to share issues, suggestions and solutions: The CARLA forum is available to post any doubts or suggestions that may arise during the reading.
<div class="build-buttons"> <div class="build-buttons">
<a href="https://forum.carla.org/" target="_blank" class="btn btn-neutral" title="Go to the latest CARLA release"> <a href="https://forum.carla.org/" target="_blank" class="btn btn-neutral" title="Go to the latest CARLA release">
CARLA forum</a> CARLA forum</a>
</div> </div>
!!! Important !!! Important
This is documentation for CARLA 0.9.0 or later. Previous documentation is in the [stable branch](https://carla.readthedocs.io/en/stable/). 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/).
--- ---
## Getting started ## Getting started
<p style="padding-left:30px;line-height:1.8"> <p style="padding-left:30px;line-height:1.8">
<a href="../start_introduction"><b> [__Introduction__](start_introduction.md)
Introduction — What to expect from CARLA.
</b></a> [__Quick start__](start_quickstart.md)
— Capabilities and intentions behind the project.
<a href="../start_quickstart"><b>
Quickstart installation
</b></a>
— Get the CARLA releases. — Get the CARLA releases.
</p> </p>
## Building CARLA ## Building CARLA
<p style="padding-left:30px;line-height:1.8"> <p style="padding-left:30px;line-height:1.8">
<a href="../build_linux"><b> [__Linux build__](build_linux.md)
Linux build
</b></a>
— Make the build on Linux. — Make the build on Linux.
<a href="../build_windows"><b> [__Windows build__](build_windows.md)
Windows build
</b></a>
— Make the build on Windows. — Make the build on Windows.
<a href="../build_update"><b> [__Update CARLA__](build_update.md)
Update CARLA
</b></a>
— Get up to date with the latest content. — Get up to date with the latest content.
<a href="../build_system"><b> [__Build system__](build_system.md)
Build system
</b></a>
— Learn about the build and how it is made. — Learn about the build and how it is made.
<a href="../build_docker"><b> [__Running in a Docker__](build_docker.md)
Running in a Docker
</b></a>
— Run CARLA using a container solution. — Run CARLA using a container solution.
<a href="../build_faq"><b> [__F.A.Q.__](build_faq.md)
F.A.Q. — Some of the most frequent installation issues.
</b></a>
— Some of the most frequent issues for newcomers.
</p> </p>
## First steps ## First steps
<p style="padding-left:30px;line-height:1.8"> <p style="padding-left:30px;line-height:1.8">
<a href="../core_concepts"><b> [__Core concepts__](core_concepts.md)
Core concepts
</b></a>
— Overview of the basic concepts in CARLA. — Overview of the basic concepts in CARLA.
<a href="../core_world"><b> [__1st. World and client__](core_world.md)
1st. World and client
</b></a>
— Manage and access the simulation. — Manage and access the simulation.
<a href="../core_actors"><b> [__2nd. Actors and blueprints__](core_actors.md)
2nd. Actors and blueprints
</b></a>
— Learn about actors and how to handle them. — Learn about actors and how to handle them.
<a href="../core_map"><b> [__3rd. Maps and navigation__](core_map.md)
3rd. Maps and navigation — Discover the different maps and how do vehicles move around.
</b></a> [__4th. Sensors and data__](core_sensors.md)
— Discover the different maps and how to move around.
<a href="../core_sensors"><b>
4th. Sensors and data
</b></a>
— Retrieve simulation data using sensors. — Retrieve simulation data using sensors.
</p>
## Advanced steps ## Advanced steps
<p style="padding-left:30px;line-height:1.8"> <p style="padding-left:30px;line-height:1.8">
<a href="../adv_recorder"><b> [__Recorder__](adv_recorder.md)
Recorder — Register the events in a simulation and play it again.
</b></a> [__Rendering options__](adv_rendering_options.md)
— Store all the events in a simulation a play it again. — From quality settings to no-render or off-screen modes.
<a href="../adv_rendering_options"><b> [__Synchrony and time-step__](adv_synchrony_timestep.md)
Rendering options
</b></a>
— Different settings, from quality to no-render or off-screen runs.
<a href="../adv_synchrony_timestep"><b>
Synchrony and time-step
</b></a>
— Client-server communication and simulation time. — Client-server communication and simulation time.
<a href="../adv_traffic_manager"><b> [__Traffic Manager__](adv_traffic_manager.md)
Traffic Manager — Simulate urban traffic by setting vehicles to autopilot mode.
</b></a> </p>
— Feature to handle autopilot vehicles and emulate traffic.
## References ## References
<p style="padding-left:30px;line-height:1.8"> <p style="padding-left:30px;line-height:1.8">
<a href="../python_api"><b> [__Python API reference__](python_api.md)
Python API reference
</b></a>
— Classes and methods in the Python API. — Classes and methods in the Python API.
<a href="../ref_code_recipes"><b> [__Code recipes__](ref_code_recipes.md)
Code recipes — Some code fragments commonly used.
</b></a> [__Blueprint library__](bp_library.md)
— Code fragments commonly used.
<a href="../bp_library"><b>
Blueprint library
</b></a>
— Blueprints provided to spawn actors. — Blueprints provided to spawn actors.
<a href="../ref_cpp"><b> [__C++ reference__](ref_cpp.md)
C++ reference
</b></a>
— Classes and methods in CARLA C++. — Classes and methods in CARLA C++.
<a href="../ref_recorder_binary_file_format"><b> [__Recorder binary file format__](ref_recorder_binary_file_format.md)
Recorder binary file format
</b></a>
— Detailed explanation of the recorder file format. — Detailed explanation of the recorder file format.
<a href="../ref_sensors"><b> [__Sensors reference__](ref_sensors.md)
Sensors reference
</b></a>
— Everything about sensors and the data they retrieve. — Everything about sensors and the data they retrieve.
## ROS bridge ## ROS bridge
<p style="padding-left:30px;line-height:1.8"> <p style="padding-left:30px;line-height:1.8">
<a href="../ros_installation"><b> [__ROS bridge installation__](ros_installation.md)
ROS bridge installation — The different ways to install the ROS bridge.
</b></a> [__CARLA messages reference__](ros_msgs.md)
— How to install the ROS bridge's package or repository.
<a href="../ros_msgs"><b>
CARLA messages reference
</b></a>
— Contains explanations and fields for every type of CARLA message available in ROS. — Contains explanations and fields for every type of CARLA message available in ROS.
<a href="../ros_launchs"><b> [__Launchfiles reference__](ros_launchs.md)
Launchfiles reference — Lists the launchfiles and nodes provided, and the topics being consumed and published.
</b></a> </p>
— Explains the launchfiles provided, its nodes, and the topics that are being consumed and published.
## Tutorials — General ## Tutorials — General
<p style="padding-left:30px;line-height:1.8"> <p style="padding-left:30px;line-height:1.8">
<a href="../tuto_G_add_friction_triggers"><b> [__Add friction triggers__](tuto_G_add_friction_triggers.md)
Add friction triggers
</b></a>
— Define dynamic box triggers for wheels. — Define dynamic box triggers for wheels.
<a href="../tuto_G_control_vehicle_physics"><b> [__Control vehicle physics__](tuto_G_control_vehicle_physics.md)
Control vehicle physics
</b></a>
— Set runtime changes on a vehicle physics. — Set runtime changes on a vehicle physics.
<a href="../tuto_G_control_walker_skeletons"><b> [__Control walker skeletons__](tuto_G_control_walker_skeletons.md)
Control walker skeletons — Animate walkers using skeletons.
</b></a> </p>
— Skeleton and animation for walkers explained.
## Tutorials — Assets ## Tutorials — Assets
<p style="padding-left:30px;line-height:1.8"> <p style="padding-left:30px;line-height:1.8">
<a href="../tuto_A_import_assets"><b> [__Import new assets__](tuto_A_import_assets.md)
Import new assets
</b></a>
— Use personal assets in CARLA. — Use personal assets in CARLA.
<a href="../tuto_A_map_creation"><b> [__Map creation__](tuto_A_map_creation.md)
Map creation — Create a new map following simple guidelines.
</b></a> [__Map customization__](tuto_A_map_customization.md)
— Guidelines to create a new map.
<a href="../tuto_A_map_customization"><b>
Map customization
</b></a>
— Edit an existing map. — Edit an existing map.
<a href="../tuto_A_standalone_packages"><b> [__Standalone asset packages__](tuto_A_standalone_packages.md)
Standalone asset packages — Import assets into UE and set them for package distribution.
</b></a> [__Use Epic's Automotive materials__](tuto_A_epic_automotive_materials.md)
— Import assets into Unreal Engine and prepare them for package distribution. — Apply Epic's set of Automotive materials to vehicles.
<a href="../tuto_A_epic_automotive_materials"><b> [__Vehicle modelling__](tuto_A_vehicle_modelling.md)
Use Epic's Automotive materials — Create a new vehicle for CARLA.
</b></a> </p>
— Apply Epic's set of Automotive materials to vehicles for a more realistic painting.
<a href="../tuto_A_vehicle_modelling"><b>
Vehicle modelling
</b></a>
— Guidelines to create a new vehicle for CARLA.
## Tutorials — Developers ## Tutorials — Developers
<p style="padding-left:30px;line-height:1.8"> <p style="padding-left:30px;line-height:1.8">
<a href="../tuto_D_contribute_assets"><b> [__Contribute with new assets__](tuto_D_contribute_assets.md)
Contribute with new assets
</b></a>
— Add new content to CARLA. — Add new content to CARLA.
<a href="../tuto_D_create_sensor"><b> [__Create a sensor__](tuto_D_create_sensor.md)
Create a sensor — Develop a new sensor to be used in CARLA.
</b></a> [__Make a release__](tuto_D_make_release.md)
— The basics on how to add a new sensor to CARLA.
<a href="../tuto_D_make_release"><b>
Make a release
</b></a>
— For developers who want to publish a release. — For developers who want to publish a release.
<a href="../tuto_D_generate_pedestrian_navigation"><b> [__Generate pedestrian navigation__](tuto_D_generate_pedestrian_navigation.md)
Generate pedestrian navigation — Obtain the information needed for walkers to move around.
</b></a> </p>
— Generate the information needed for walkers to navigate a map.
## Contributing ## Contributing
<p style="padding-left:30px;line-height:1.8"> <p style="padding-left:30px;line-height:1.8">
<a href="../cont_contribution_guidelines"><b> [__Contribution guidelines__](cont_contribution_guidelines.md)
Contribution guidelines
</b></a>
— The different ways to contribute to CARLA. — The different ways to contribute to CARLA.
<a href="../cont_code_of_conduct"><b> [__Code of conduct__](cont_code_of_conduct.md)
Code of conduct — Standard rights and duties for contributors.
</b></a> [__Coding standard__](cont_coding_standard.md)
— Some standards for CARLA, rights and duties for contributors.
<a href="../cont_coding_standard"><b>
Coding standard
</b></a>
— Guidelines to write proper code. — Guidelines to write proper code.
<a href="../cont_doc_standard"><b> [__Documentation standard__](cont_doc_standard.md)
Documentation standard
</b></a>
— Guidelines to write proper documentation. — Guidelines to write proper documentation.
</p>

14
Docs/start_introduction.md
View File

@ -21,12 +21,12 @@ The client side consists of a sum of client modules controlling the logic of act
That summarizes the basic structure of the simulator. Understanding CARLA though is much more than that, as many different features and elements coexist within it. Some of these are listed hereunder, as to gain perspective on the capabilities of what CARLA can achieve. That summarizes the basic structure of the simulator. Understanding CARLA though is much more than that, as many different features and elements coexist within it. Some of these are listed hereunder, as to gain perspective on the capabilities of what CARLA can achieve.
* __Traffic manager:__ A built-in system that takes control of the vehicles besides the one used for learning. It acts as a conductor provided by CARLA to recreate urban-like environments with realistic behaviours. * __Traffic manager.__ A built-in system that takes control of the vehicles besides the one used for learning. It acts as a conductor provided by CARLA to recreate urban-like environments with realistic behaviours.
* __Sensors:__ Vehicles rely on them to dispense information of their surroundings. In CARLA they are a specific kind of actor attached the vehicle and the data they receive can be retrieved and stored to ease the process. Currently the project supports different types of these, from cameras to radars, lidar and many more. * __Sensors.__ Vehicles rely on them to dispense information of their surroundings. In CARLA they are a specific kind of actor attached the vehicle and the data they receive can be retrieved and stored to ease the process. Currently the project supports different types of these, from cameras to radars, lidar and many more.
* __Recorder:__ This feature is used to reenact a simulation step by step for every actor in the world. It grants access to any moment in the timeline anywhere in the world, making for a great tracing tool. * __Recorder.__ This feature is used to reenact a simulation step by step for every actor in the world. It grants access to any moment in the timeline anywhere in the world, making for a great tracing tool.
* __ROS bridge and Autoware implementation:__ As a matter of universalization, the CARLA project ties knots and works for the integration of the simulator within other learning environments. * __ROS bridge and Autoware implementation.__ As a matter of universalization, the CARLA project ties knots and works for the integration of the simulator within other learning environments.
* __Open assets:__ CARLA facilitates different maps for urban settings with control over weather conditions and a blueprint library with a wide set of actors to be used. However, these elements can be customized and new can be generated following simple guidelines. * __Open assets.__ CARLA facilitates different maps for urban settings with control over weather conditions and a blueprint library with a wide set of actors to be used. However, these elements can be customized and new can be generated following simple guidelines.
* __Scenario runner:__ In order to ease the learning process for vehicles, CARLA provides a series of routes describing different situations to iterate on. These also set the basis for the [CARLA challenge](https://carlachallenge.org/), open for everybody to test their solutions and make it to the leaderboard. * __Scenario runner.__ In order to ease the learning process for vehicles, CARLA provides a series of routes describing different situations to iterate on. These also set the basis for the [CARLA challenge](https://carlachallenge.org/), open for everybody to test their solutions and make it to the leaderboard.
--- ---
## The project ## The project
@ -34,7 +34,7 @@ That summarizes the basic structure of the simulator. Understanding CARLA though
CARLA grows fast and steady, widening the range of solutions provided and opening the way for the different approaches to autonomous driving. It does so while never forgetting its open-source nature. The project is transparent, acting as a white box where anybody is granted access to the tools and the development community. In that democratization is where CARLA finds its value. CARLA grows fast and steady, widening the range of solutions provided and opening the way for the different approaches to autonomous driving. It does so while never forgetting its open-source nature. The project is transparent, acting as a white box where anybody is granted access to the tools and the development community. In that democratization is where CARLA finds its value.
Talking about how CARLA grows means talking about a community of developers who dive together into the thorough question of autonomous driving. Everybody is free to explore with CARLA, find their own solutions and then share their achievements with the rest of the community. Talking about how CARLA grows means talking about a community of developers who dive together into the thorough question of autonomous driving. Everybody is free to explore with CARLA, find their own solutions and then share their achievements with the rest of the community.
This documentation will be a companion along the way. The next page contains the __quickstart__ instructions for those eager to start. However, a build guide (Linux and Windows) is available for those who want to dive full-length into CARLA with all its features. This documentation will be a companion along the way. The next page contains __[Quick start](start_quickstart.md)__ instructions for those eager to install a CARLA release. There is also a build guide for Linux and Windows. This will make CARLA from repository and allow to dive full-length into its features.
Welcome to CARLA. Welcome to CARLA.

144
Docs/start_quickstart.md
View File

@ -1,50 +1,88 @@
# Quick start # Quick start
* [Requirements](#requirements) * __[Installation summary](#installation-summary)__
* [Downloading CARLA](#downloading-carla) * __[Requirements](#requirements)__
* a) apt-get installation * __[Downloading CARLA](#downloading-carla)__
* b) Repository download * a) deb CARLA installation
* [Running CARLA](#running-carla) * b) GitHub repository installation
* __[Running CARLA](#running-carla)__
* Command-line options * Command-line options
* [Updating CARLA](#updating-carla) * __[Updating CARLA](#updating-carla)__
* [Summary](#summary) * __[Follow-up](#follow-up)__
---
## Installation summary
<details>
<summary>
Show command line summary for the quick start installation
</summary>
```sh
# Install required modules Pygame and Numpy.
pip install --user pygame numpy
# Option A) deb package installation (only Linux)
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys DB53A429E64554FC &&
sudo add-apt-repository "deb [trusted=yes] http://dist.carla.org/carla-0.9.7/ bionic main"
sudo apt-get update
sudo apt-get install carla
cd /opt/carla/bin
./CarlaUE4.sh
# Option B) GitHub repository installation
# Go to: https://github.com/carla-simulator/carla/blob/master/Docs/download.md
# Download the desired package and additional assets.
# Extract the package.
# Extract the additional assets in `/Import`
# Run CARLA (Linux)
./CarlaUE.sh
# Run CARLA (Windows)
> CarlaUE4.exe
# Run a script to test CARLA
cd PythonAPI/examples
python3 spawn_npc.py
```
</details>
--- ---
## Requirements ## Requirements
The quickstart installation uses a pre-packaged version of CARLA. This comprises the content in a boundle that can run automatically with no build installation needed. The API can be accesseded fully but in exchange, advanced customization and developing options are unavailable. The quick start installation uses a pre-packaged version of CARLA. The content is comprised in a boundle that can run automatically with no build installation needed. The API can be accesseded fully but advanced customization and development options are unavailable.
However, some requirements are still a must. The requirements are simpler than those for the build installation.
* __Server side:__ A good GPU will be needed to run a highly realistic environment (4GB minimum). A dedicated GPU is highly advised for machine learning. * __Server side.__ A 4GB minimum GPU will be needed to run a highly realistic environment. A dedicated GPU is highly advised for machine learning.
* __Client side:__ The API is accessed via command line. To do so, [Python](https://www.python.org/downloads/) is necessary, and also a good internet connection and two TCP ports (2000 and 2001 by default). * __Client side.__ [Python](https://www.python.org/downloads/) is necessary to access the API via command line. Also, a good internet connection and two TCP ports (2000 and 2001 by default).
* __System requirements:__ Any 64-bits OS should run the corresponding version of CARLA. * __System requirements.__ Any 64-bits OS should run CARLA.
* __Other requirements:__ Only two specific Python modules: [Pygame](https://www.pygame.org/download.shtml), to create graphics directly with Python and [Numpy](https://pypi.org/project/numpy/) for great calculus. * __Other requirements.__ Two Python modules: [Pygame](https://www.pygame.org/download.shtml) to create graphics directly with Python, and [Numpy](https://pypi.org/project/numpy/) for great calculus.
If you have [pip](https://pip.pypa.io/en/stable/installing/) in your system, you can geth both modules simply by running the following commands: To install both modules using [pip](https://pip.pypa.io/en/stable/installing/), run the following commands.
```sh ```sh
pip install --user pygame numpy pip install --user pygame numpy
``` ```
--- ---
## Downloading CARLA ## Downloading CARLA
The easiest way to get the latest release in Linux is using the __apt repository__. The __deb installation__ is the easiest way to get the latest release in Linux.
To get either a specific release or get the Windows version of CARLA: __download the repository__. __Download the GitHub repository__ to get either a specific release or the Windows version of CARLA.
Both methods will set CARLA ready to run.
<h4>a) apt-get CARLA 0.9.7</h4> ### a) deb CARLA installation
First, add the repository to the system: Add the repository to the system.
```sh ```sh
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys DB53A429E64554FC && sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys DB53A429E64554FC &&
sudo add-apt-repository "deb [trusted=yes] http://dist.carla.org/carla-0.9.7/ bionic main" sudo add-apt-repository "deb [trusted=yes] http://dist.carla.org/carla-0.9.7/ bionic main"
``` ```
Then, simply install it. CARLA will be in the `/opt/` folder, where other software such as ROS install themselves: Install CARLA and check for the installation in the `/opt/` folder.
```sh ```sh
sudo apt-get update sudo apt-get update
sudo apt-get install carla sudo apt-get install carla
cd /opt/carla
``` ```
<h4>b) Downloading the repository</h4> ### b) GitHub repository installation
<div class="build-buttons"> <div class="build-buttons">
<p> <p>
@ -53,77 +91,75 @@ sudo apt-get install carla
</p> </p>
</div> </div>
The repository contains the different versions of the simulator available. The _development_ and _stable_ sections, contain the packages for the different official releases. The later the version the more experimental it is. The _nightly build_ is the current development version as today and so, the most unstable (developers are currently working with this build). If you want a more robust version, you may search for the latest tagged version. The repository contains the different versions of the simulator available. _Development_ and _stable_ sections list the packages for the different official releases. The later the version the more experimental it is. The _nightly build_ is the current development version as today and so, the most unstable.
!!! note There may be many files per release. The package is a compressed file named as __CARLA_version.number__. Other elements such as __Town06_0.9.5.tar.gz__ are additional assets.
Latest Windows release is __CARLA 0.9.5__, but this is to be updated soon.
There may be many files per release. The package is named as __CARLA_version.number__ (compressed file format _.tar.gz_ for Linux and _.zip_ for Windows). Other elements such as __Town06_0.9.5.tar.gz__ are additional assets for Linux releases. Download and extract the release file. It contains a precompiled version of the simulator, the Python API module and some scripts to be used as examples.
Move any additional assets to the _Import_ folder in the release and extract them. The script _ImportAssets_ in the main CARLA folder should extract these automatically.
Download and extract the release in a folder of your choice. It contains a precompiled version of the simulator, the Python API module and some scripts to be used as examples.
If you downloaded any additional assets in Linux, move them to the _Import_ folder that has appeared (there is no need to extract them). Open a terminal in the folder where you extracted CARLA and run the script _ImportAssets_ to get the additional content automatically:
```sh ```sh
./ImportAssets.sh > cd ~/carla
> ./ImportAssets.sh
``` ```
--- ---
## Running CARLA ## Running CARLA
Open a terminal in the folder where CARLA was extracted. The following command will execute the package file and start the simulation: Open a terminal in the main CARLA folder. Run the following command to execute the package file and start the simulation:
```sh ```sh
Linux: # Linux:
./CarlaUE4.sh > ./CarlaUE4.sh
# Windows:
Windows: > CarlaUE4.exe
CarlaUE4.exe
``` ```
!!! Important !!! Important
In the __apt-get__ installation, `CarlaUE4.sh` can be found in `/opt/carla/bin/`, instead of the main `/carla/` folder where it normally is. In the __deb installation__, `CarlaUE4.sh` will be in `/opt/carla/bin/`, instead of the main `/carla/` folder where it normally is.
A window will open, containing a view over the city. This is the "spectator" view. To fly around the city use the mouse and WASD keys (while clicking). The simulator is now running as a server, waiting for a client app to connect and interact with the world. A window containing a view over the city will pop up. This is the _spectator view_. To fly around the city use the mouse and `WASD` keys (while clicking). The server simulator is now running and waiting for a client to connect and interact with the world.
Now it is time to start running scripts. The following example will spawn some life into the city:
!!! note ```sh
If the firewall or any other application are blocking the TCP ports needed, these can be manually changed by adding to the previous command the argument: `-carla-port=N`, being `N` the desired port. The second will be automatically set to `N+1`. # Go to the folder containing example scripts
> cd PythonAPI/examples
> python3 spawn_npc.py
```
#### Command-line options #### Command-line options
There are some configuration options available when launching CARLA: There are some configuration options available when launching CARLA.
* `-carla-rpc-port=N` Listen for client connections at port N, streaming port is set to N+1 by default. * `-carla-rpc-port=N` Listen for client connections at port `N`. Streaming port is set to `N+1` by default.
* `-carla-streaming-port=N` Specify the port for sensor data streaming, use 0 to get a random unused port. * `-carla-streaming-port=N` Specify the port for sensor data streaming. Use 0 to get a random unused port. The second port will be automatically set to `N+1`.
* `-quality-level={Low,Epic}` Change graphics quality level. * `-quality-level={Low,Epic}` Change graphics quality level. Find out more in [rendering options](adv_rendering_options.md).
* [Full list of UE4 command-line arguments][ue4clilink] (note that many of these won't work in the release version). * __[Full list of UE4 command-line arguments][ue4clilink].__ There is a lot of options provided by UE. However, not all of these will be available in CARLA.
[ue4clilink]: https://docs.unrealengine.com/en-US/Programming/Basics/CommandLineArguments [ue4clilink]: https://docs.unrealengine.com/en-US/Programming/Basics/CommandLineArguments
```sh ```sh
> ./CarlaUE4.sh -carla-rpc-port=3000 > ./CarlaUE4.sh -carla-rpc-port=3000
``` ```
However, some may not be available (especially those provided by UE). For said reason, the script in `PythonAPI/util/config.py` provides for some more configuration options: The script `PythonAPI/util/config.py` provides for more configuration options.
```sh ```sh
> ./config.py --no-rendering # Disable rendering > ./config.py --no-rendering # Disable rendering
> ./config.py --map Town05 # Change map > ./config.py --map Town05 # Change map
> ./config.py --weather ClearNoon # Change weather > ./config.py --weather ClearNoon # Change weather
```
To check all the available configurations, run the following command: > ./config.py --help # Check all the available configuration options.
```sh
> ./config.py --help
``` ```
--- ---
## Updating CARLA ## Updating CARLA
The packaged version requires no updates. The content is bundled and thus, tied to a specific version of CARLA. Everytime there is a release, the repository will be updated. To run this latest or any other version, delete the previous one and repeat the installation steps with the desired. The packaged version requires no updates. The content is bundled and thus, tied to a specific version of CARLA. Everytime there is a release, the repository will be updated. To run this latest or any other version, delete the previous and install the one desired.
--- ---
## Summary ## Follow-up
That concludes the quickstart installation process. In case any unexpected error or issue occurs, the [CARLA forum](https://forum.carla.org/) is open to everybody. There is an _Installation issues_ category to post this kind of problems and doubts. Thus concludes the quick start installation process. In case any unexpected error or issue occurs, the [CARLA forum](https://forum.carla.org/) is open to everybody. There is an _Installation issues_ category to post this kind of problems and doubts.
So far, CARLA should be operative in the desired system. Terminals will be used to contact the server via script and retrieve data. Thus will access all of the capabilities that CARLA provides. Next step should be visiting the __First steps__ section to learn more about this. However, all the information about the Python API regarding classes and its methods can be accessed in the [Python API reference](python_api.md). So far, CARLA should be operative in the desired system. Terminals will be used to contact the server via script, interact with the simulation and retrieve data. To do so, it is essential to understand the core concepts in CARLA. Read the __First steps__ section to learn on those. Additionally, all the information about the Python API regarding classes and its methods can be accessed in the [Python API reference](python_api.md).
<div class="build-buttons"> <div class="build-buttons">
<p> <p>

2
mkdocs.yml
View File

@ -9,7 +9,7 @@ nav:
- Home: 'index.md' - Home: 'index.md'
- Getting started: - Getting started:
- 'Introduction': 'start_introduction.md' - 'Introduction': 'start_introduction.md'
- 'Quickstart installation': 'start_quickstart.md' - 'Quick start installation': 'start_quickstart.md'
- Building CARLA: - Building CARLA:
- 'Linux build': 'build_linux.md' - 'Linux build': 'build_linux.md'
- 'Windows build': 'build_windows.md' - 'Windows build': 'build_windows.md'