First iteration

This commit is contained in:
sergi-e 2020-09-16 23:06:42 +02:00 committed by Marc Garcia Puig
parent 8e52da614c
commit 634383f1aa
4 changed files with 44 additions and 11 deletions

View File

@ -86,8 +86,13 @@ cd PythonAPI/examples
python3 spawn_npc.py
# Terminal B
cd PythonAPI/examples
python3 spawn_npc.py # Support for Python2 was provided until 0.9.10 (not included)
python3 dynamic_weather.py # Support for Python2 was provided until 0.9.10 (not included)
# Optionally, to compile the PythonAPI for Python2, run the following command in the root CARLA directory.
make PythonAPI ARGS="--python-version=2"
```
</details>
---
@ -300,6 +305,12 @@ python3 dynamic_weather.py
!!! Important
If the simulation is running at very low FPS rates, go to `Edit/Editor preferences/Performance` in the UE editor and disable __Use less CPU when in background__.
Optionally, to compile the PythonAPI for Python2, run the following command in the root CARLA directory.
```sh
make PythonAPI ARGS="--python-version=2"
```
Now CARLA is ready to go. Here is a brief summary of the most useful `make` commands available.
<table class ="defTable">

View File

@ -23,9 +23,6 @@ The build process can be quite long and tedious. The **[F.A.Q.](build_faq.md)**
<br>
To execute the <code>make</code> commands below, you <b>must</b> use the Visual Studio 2017 native console x64 <b>with</b> administrator rights, otherwise you may be getting permission errors.
!!! Important
To execute the ```make``` commands below, you **must** use the Visual Studio 2017 native console x64 **with** administrator rights, otherwise you may be getting permission errors.
```sh
# Make sure to meet the minimum requirements.
@ -46,13 +43,17 @@ git clone https://github.com/carla-simulator/carla
make PythonAPI
make launch
# Press play in the Editor to initialize the server, and run example scripts to test CARLA.
# Press play in the Editor to initialize the server
# Run example scripts to test CARLA
# Terminal A
cd PythonAPI/examples
python3 spawn_npc.py
# Terminal B
cd PythonAPI/examples
python3 dynamic_weather.py # Support for Python2 was provided until 0.9.10 (not included)
python3 dynamic_weather.py
# The PythonAPI will be built based on the installed Python version
# The docs will use Python3, as support for Python2 was provided until 0.9.10 (not included)
```
</details>
@ -161,18 +162,20 @@ The project may ask to build other instances such as `UE4Editor-Carla.dll` the f
Finally, let's test the simulator. Inside `PythonAPI/examples` and `PythonAPI/util` there are some example scripts that may be especially useful for starters. The following commands will spawn some life into the town, and create a weather cycle. Each script should be run in one terminal
```sh
# Support for Python2 was provided until 0.9.10 (not included)
# Terminal A
cd PythonAPI/examples
python3 spawn_npc.py
# Terminal B
cd PythonAPI/examples
python3 dynamic_weather.py
# The PythonAPI will be built based on the installed Python version
# The docs will use Python3, as support for Python2 was provided until 0.9.10 (not included)
```
!!! Important
If the simulation is running at very low FPS rates, go to `Edit/Editor preferences/Performance` in the UE editor and disable __Use less CPU when in background__.
Now CARLA is ready to go. Here is a brief summary of the most useful `make` commands available.
Now CARLA is ready to go. Here is a brief summary of the most useful `make` commands available.
<table class ="defTable">
<thead>

View File

@ -1,6 +1,7 @@
# ROS bridge installation
* [__Requirements__](#requirements)
* [Python2](#python2)
* [__Bridge installation__](#bridge-installation)
* [A. Using Debian repository](#a-using-debian-repository)
* [B. Using source repository](#b-using-source-repository)
@ -11,7 +12,6 @@ The ROS bridge enables two-way communication between ROS and CARLA. The informat
---
## Requirements
### ROS Kinetic/Melodic
* __ROS Kinetic/Melodic.__ Install ROS [Melodic](http://wiki.ros.org/melodic/Installation/Ubuntu), for Ubuntu 18.04, or [Kinetic](http://wiki.ros.org/kinetic/Installation), for Ubuntu 16.04. ROS packages may be required, depending on the user needs. [rviz](http://wiki.ros.org/rviz) to visualize ROS data.j
* __CARLA 0.9.7 or later.__ Previous versions are not compatible with the ROS bridge. Follow the [quick start installation](start_quickstart.md) or make the build for the corresponding platform.
@ -19,9 +19,22 @@ The ROS bridge enables two-way communication between ROS and CARLA. The informat
!!! Important
Make sure that both CARLA and ROS work properly before continuing with the installation.
### Python2
Those using ROS Kinetic or Melodic will need Python2 in order to run the ROS bridge. This is no problem for previous versions of CARLA. However, since 0.9.10 (included), CARLA does not provide support for Python2.
In order to compile the necessary `.egg` file of the PythonAPI for Python2, run the following command in the root CARLA directory.
```sh
make PythonAPI ARGS="--python-version=2"
```
---
## Bridge installation
!!! Important
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.
### A. Using Debian repository
Set up the Debian repository in the system.
@ -40,9 +53,6 @@ This repository contains features from CARLA 0.9.10 and later versions. To insta
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 the Debian revision.
```
!!! Important
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.
### 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.

View File

@ -49,6 +49,9 @@ cd /opt/carla-simulator
cd PythonAPI/examples
python3 spawn_npc.py # Support for Python2 was provided until 0.9.10 (not included)
# Optionally, to compile the PythonAPI for Python2, run the following command in the root CARLA directory.
make PythonAPI ARGS="--python-version=2"
```
</details>
@ -149,6 +152,12 @@ Now it is time to start running scripts. The following example will spawn some l
> python3 spawn_npc.py # Support for Python2 was provided until 0.9.10 (not included)
```
Optionally, to compile the PythonAPI for Python2, run the following command in the root CARLA directory.
```sh
make PythonAPI ARGS="--python-version=2"
```
#### Command-line options
There are some configuration options available when launching CARLA.