First draft

This commit is contained in:
sergi-e 2020-09-01 10:27:17 +02:00 committed by bernat
parent f4fc32f911
commit 29cb90f8aa
2 changed files with 48 additions and 51 deletions

View File

@ -2,8 +2,8 @@
* [__Requirements__](#requirements) * [__Requirements__](#requirements)
* [__Bridge installation__](#bridge-installation) * [__Bridge installation__](#bridge-installation)
* a) using apt repository * [A. Using deb repository](#a-using-deb-repository)
* b) using source repository * [B. Using source repository](#b-using-source-repository)
* [__Run the ROS bridge__](#run-the-ros-bridge) * [__Run the ROS bridge__](#run-the-ros-bridge)
* [__Setting CARLA__](#setting-carla) * [__Setting CARLA__](#setting-carla)
@ -22,29 +22,28 @@ The ROS bridge enables two-way communication between ROS and CARLA. The informat
--- ---
## Bridge installation ## Bridge installation
### a) Using apt repository ### A. Using deb repository
Add the apt repository. Set up the deb repository in the system.
* __Bridge for ROS Melodic.__
```sh ```sh
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 81061A1A042F527D && sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 1AF1527DE64CB8D9
sudo add-apt-repository "deb [arch=amd64 trusted=yes] http://dist.carla.org/carla-ros-bridge-melodic/ bionic main" sudo add-apt-repository "deb [arch=amd64] http://dist.carla.org/carla $(lsb_release -sc) main"
```
Install CARLA and check for the installation in the `/opt/` folder.
```sh
sudo apt-get update # Update the repository
sudo apt-get install carla-ros-bridge # Install the latest ROS bridge version, or update the current installation
``` ```
* __Bridge for ROS Kinetic.__ This repository contains features from CARLA 0.9.10 and later versions. To install a specific version add the version tag to the installation command.
```sh ```sh
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 9BE2A0CDC0161D6C && sudo apt-get install carla-ros-bridge==0.9.10-1 # In this case, "0.9.10" refers to the ROS bridge version, and "-1" to a deb tag, which usually will always be the same.
sudo add-apt-repository "deb [arch=amd64 trusted=yes] http://dist.carla.org/carla-ros-bridge-kinetic xenial main"
``` ```
Install the ROS bridge. !!! Important
```sh To install ROS bridge versions prior to 0.9.10, change to a previous version of the documentation using the pannel in the bottom right corner of the window, and follow the old instructions.
sudo apt update &&
sudo apt install carla-ros-bridge-<melodic or kinetic>
```
### b) Using source repository ### B. Using source repository
A catkin workspace is needed to use the ROS bridge. It should be cloned and built in there. The following code creates a new workspace, and clones the repository in there. A catkin workspace is needed to use the ROS bridge. It should be cloned and built in there. The following code creates a new workspace, and clones the repository in there.

View File

@ -3,11 +3,11 @@
* __[Installation summary](#installation-summary)__ * __[Installation summary](#installation-summary)__
* __[Requirements](#requirements)__ * __[Requirements](#requirements)__
* __[CARLA installation](#carla-installation)__ * __[CARLA installation](#carla-installation)__
* a) deb CARLA installation * [A. deb CARLA installation](#a-deb-carla-installation)
* b) GitHub repository installation * [B. Package installation](#b-package-installation)
* __[Import additional assets](#import-additional-assets)__ * __[Import additional assets](#import-additional-assets)__
* __[Running CARLA](#running-carla)__ * __[Running CARLA](#running-carla)__
* Command-line options * [Command-line options](#command-line-options)
* __[Updating CARLA](#updating-carla)__ * __[Updating CARLA](#updating-carla)__
* __[Follow-up](#follow-up)__ * __[Follow-up](#follow-up)__
@ -23,39 +23,29 @@
# Install required modules Pygame and Numpy. # Install required modules Pygame and Numpy.
pip install --user pygame numpy pip install --user pygame numpy
# Option A) deb package installation of CARLA 0.9.9 (only Linux) # There are two different ways to install CARLA.
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 92635A407F7A020C
sudo add-apt-repository "deb [arch=amd64 trusted=yes] http://dist.carla.org/carla-0.9.9/ all main" # Option A) deb package installation
# This repository contains CARLA 0.9.10 and later. To install previous CARLA versions, change to a previous version of the docs using the pannel in the bottom right part of the window.
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 1AF1527DE64CB8D9
sudo add-apt-repository "deb [arch=amd64] http://dist.carla.org/carla $(lsb_release -sc) main"
sudo apt-get update sudo apt-get update
sudo apt-get install carla-simulator sudo apt-get install carla-simulator # Install the latest CARLA version or update the current installation.
cd /opt/carla-simulator/bin sudo apt-get install carla-simulator==0.9.10-1 # install a specific CARLA version.
./CarlaUE4.sh
# To install CARLA 0.9.8 instead
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 304F9BC29914A77D &&
sudo add-apt-repository "deb [arch=amd64 trusted=yes] http://dist.carla.org/carla-0.9.8/ all main"
sudo apt-get update
sudo apt-get install carla-simulator
cd /opt/carla-simulator/bin
./CarlaUE4.sh
# To install CARLA 0.9.7 instead
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys DB53A429E64554FC &&
sudo add-apt-repository "deb [arch=amd64 trusted=yes] http://dist.carla.org/carla-0.9.7/ all main"
sudo apt-get update
sudo apt-get install carla-simulator
cd /opt/carla-simulator/bin cd /opt/carla-simulator/bin
./CarlaUE4.sh ./CarlaUE4.sh
# Option B) GitHub repository installation # Option B) Package installation
# Go to: https://github.com/carla-simulator/carla/blob/master/Docs/download.md # Go to: https://github.com/carla-simulator/carla/blob/master/Docs/download.md
# Download the desired package and additional assets. # Download the desired package and additional assets.
# Extract the package. # Extract the package.
# Extract the additional assets in `/Import` # Extract the additional assets in `/Import`.
# Run CARLA (Linux) # Run CARLA (Linux).
./CarlaUE.sh ./CarlaUE.sh
# Run CARLA (Windows) # Run CARLA (Windows).
> CarlaUE4.exe > CarlaUE4.exe
# Run a script to test CARLA # Run a script to test CARLA.
cd PythonAPI/examples cd PythonAPI/examples
python3 spawn_npc.py python3 spawn_npc.py
@ -83,21 +73,29 @@ To install both modules using [pip](https://pip.pypa.io/en/stable/installing/),
The __deb installation__ is the easiest way to get the latest release in Linux. The __deb installation__ is the easiest way to get the latest release in Linux.
__Download the GitHub repository__ to get either a specific release or the Windows version of CARLA. __Download the GitHub repository__ to get either a specific release or the Windows version of CARLA.
### a) deb CARLA installation ### A. deb CARLA installation
Add the CARLA 0.9.9 repository to the system. Set up the deb repository in the system.
```sh ```sh
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 92635A407F7A020C sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 1AF1527DE64CB8D9
sudo add-apt-repository "deb [arch=amd64 trusted=yes] http://dist.carla.org/carla-0.9.9/ all main" sudo add-apt-repository "deb [arch=amd64] http://dist.carla.org/carla $(lsb_release -sc) main"
``` ```
Install CARLA and check for the installation in the `/opt/` folder. Install CARLA and check for the installation in the `/opt/` folder.
```sh ```sh
sudo apt-get update sudo apt-get update # Update the repository
sudo apt-get install carla-simulator sudo apt-get install carla-simulator # Install the latest CARLA version, or update the current installation
cd /opt/carla-simulator cd /opt/carla-simulator # Open the folder where CARLA is installed
``` ```
### b) Package installation This repository contains CARLA 0.9.10 and later versions. To install a specific version add the version tag to the installation command.
```sh
sudo apt-get install carla-simulator==0.9.10-1 # In this case, "0.9.10" refers to a CARLA version, and "-1" to a deb tag, which usually will always be the same.
```
!!! Important
To install CARLA versions prior to 0.9.10, change to a previous version of the documentation using the pannel in the bottom right corner of the window, and follow the old instructions.
### B. Package installation
<div class="build-buttons"> <div class="build-buttons">
<p> <p>