2017-10-25 01:46:58 +08:00
|
|
|
|
CARLA Simulator
|
|
|
|
|
===============
|
2017-03-30 01:05:26 +08:00
|
|
|
|
|
2018-01-31 00:38:23 +08:00
|
|
|
|
[![Build Status](https://travis-ci.org/carla-simulator/carla.svg?branch=master)](https://travis-ci.org/carla-simulator/carla)
|
2018-02-08 03:14:59 +08:00
|
|
|
|
[![Documentation](https://readthedocs.org/projects/carla/badge/?version=latest)](http://carla.readthedocs.io)
|
2018-02-02 21:39:29 +08:00
|
|
|
|
[![Waffle.io](https://badge.waffle.io/carla-simulator/carla.svg?columns=Next,In%20Progress,Review)](https://waffle.io/carla-simulator/carla)
|
2018-01-31 00:38:23 +08:00
|
|
|
|
|
2018-05-14 21:34:32 +08:00
|
|
|
|
[![carla.org](Docs/img/btn/web.png)](http://carla.org)
|
2018-07-30 20:10:23 +08:00
|
|
|
|
[![download](Docs/img/btn/download.png)](https://github.com/carla-simulator/carla/blob/master/Docs/download.md)
|
2018-05-14 21:34:32 +08:00
|
|
|
|
[![documentation](Docs/img/btn/docs.png)](http://carla.readthedocs.io)
|
2018-06-14 17:31:16 +08:00
|
|
|
|
[![discord](Docs/img/btn/chat.png)](https://discord.gg/8kqACuC)
|
2018-05-14 21:34:32 +08:00
|
|
|
|
<!-- [![forum](Docs/img/btn/forum.png)](link here) -->
|
|
|
|
|
|
2017-11-11 00:54:06 +08:00
|
|
|
|
CARLA is an open-source simulator for autonomous driving research. CARLA has
|
|
|
|
|
been developed from the ground up to support development, training, and
|
|
|
|
|
validation of autonomous urban driving systems. In addition to open-source code
|
|
|
|
|
and protocols, CARLA provides open digital assets (urban layouts, buildings,
|
|
|
|
|
vehicles) that were created for this purpose and can be used freely. The
|
|
|
|
|
simulation platform supports flexible specification of sensor suites and
|
|
|
|
|
environmental conditions.
|
2017-10-31 00:56:39 +08:00
|
|
|
|
|
2017-11-11 01:11:06 +08:00
|
|
|
|
[![CARLA Video](Docs/img/video_thumbnail.png)](https://youtu.be/Hp8Dz-Zek2E)
|
2017-10-31 00:56:39 +08:00
|
|
|
|
|
2018-01-23 20:03:15 +08:00
|
|
|
|
If you want to benchmark your model in the same conditions as in our CoRL’17
|
|
|
|
|
paper, check out
|
2018-04-20 22:52:07 +08:00
|
|
|
|
[Benchmarking](http://carla.readthedocs.io/en/latest/benchmark_start/).
|
2017-10-31 00:56:39 +08:00
|
|
|
|
|
2017-11-27 23:22:57 +08:00
|
|
|
|
Roadmap
|
|
|
|
|
-------
|
|
|
|
|
|
2017-11-27 23:44:43 +08:00
|
|
|
|
We are continuously working on improving CARLA, and we appreciate contributions
|
|
|
|
|
from the community. Our most immediate goals are:
|
|
|
|
|
|
2018-03-20 02:03:01 +08:00
|
|
|
|
- [ ] Releasing the methods evaluated in the CARLA paper
|
|
|
|
|
- [x] Adding a Lidar sensor
|
|
|
|
|
- [ ] Allowing for flexible and user-friendly import and editing of maps
|
|
|
|
|
- [ ] Allowing the users to control non-player characters (and therefore set up user-specified scenarios)
|
2017-11-27 23:22:57 +08:00
|
|
|
|
|
2017-10-31 00:56:39 +08:00
|
|
|
|
Paper
|
|
|
|
|
-----
|
|
|
|
|
|
|
|
|
|
If you use CARLA, please cite our CoRL’17 paper.
|
|
|
|
|
|
|
|
|
|
_CARLA: An Open Urban Driving Simulator_<br>Alexey Dosovitskiy, German Ros,
|
|
|
|
|
Felipe Codevilla, Antonio Lopez, Vladlen Koltun; PMLR 78:1-16
|
|
|
|
|
[[PDF](http://proceedings.mlr.press/v78/dosovitskiy17a/dosovitskiy17a.pdf)]
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
@inproceedings{Dosovitskiy17,
|
|
|
|
|
title = {{CARLA}: {An} Open Urban Driving Simulator},
|
|
|
|
|
author = {Alexey Dosovitskiy and German Ros and Felipe Codevilla and Antonio Lopez and Vladlen Koltun},
|
|
|
|
|
booktitle = {Proceedings of the 1st Annual Conference on Robot Learning},
|
|
|
|
|
pages = {1--16},
|
|
|
|
|
year = {2017}
|
|
|
|
|
}
|
|
|
|
|
```
|
|
|
|
|
|
2018-01-19 23:10:27 +08:00
|
|
|
|
Building CARLA
|
|
|
|
|
--------------
|
|
|
|
|
|
|
|
|
|
Use `git clone` or download the project from this page. Note that the master
|
|
|
|
|
branch contains the latest fixes and features, for the latest stable code may be
|
2018-05-14 23:06:17 +08:00
|
|
|
|
best to switch to the latest release tag.
|
2018-01-19 23:10:27 +08:00
|
|
|
|
|
2018-06-12 22:28:54 +08:00
|
|
|
|
Then follow the instruction at [How to build on Linux][buildlinuxlink] or
|
|
|
|
|
[How to build on Windows][buildwindowslink].
|
2018-01-19 23:10:27 +08:00
|
|
|
|
|
2018-06-12 22:28:54 +08:00
|
|
|
|
Unfortunately we don't have official instructions to build on Mac yet, please
|
|
|
|
|
check the progress at [issue #150][issue150].
|
2018-01-19 23:10:27 +08:00
|
|
|
|
|
2018-06-12 22:28:54 +08:00
|
|
|
|
[buildlinuxlink]: http://carla.readthedocs.io/en/latest/how_to_build_on_linux
|
|
|
|
|
[buildwindowslink]: http://carla.readthedocs.io/en/latest/how_to_build_on_windows
|
2018-01-19 23:10:27 +08:00
|
|
|
|
[issue150]: https://github.com/carla-simulator/carla/issues/150
|
|
|
|
|
|
2018-01-15 21:55:26 +08:00
|
|
|
|
Contributing
|
|
|
|
|
------------
|
|
|
|
|
|
|
|
|
|
Please take a look at our [Contribution guidelines][contriblink].
|
|
|
|
|
|
|
|
|
|
[contriblink]: http://carla.readthedocs.io/en/latest/CONTRIBUTING
|
|
|
|
|
|
2018-01-18 00:33:17 +08:00
|
|
|
|
F.A.Q.
|
|
|
|
|
------
|
|
|
|
|
|
|
|
|
|
If you run into problems, check our
|
|
|
|
|
[FAQ](http://carla.readthedocs.io/en/latest/faq/).
|
|
|
|
|
|
2017-10-31 00:56:39 +08:00
|
|
|
|
License
|
|
|
|
|
-------
|
|
|
|
|
|
|
|
|
|
CARLA specific code is distributed under MIT License.
|
|
|
|
|
|
|
|
|
|
CARLA specific assets are distributed under CC-BY License.
|
|
|
|
|
|
2018-04-09 20:21:25 +08:00
|
|
|
|
Note that UE4 itself follows its own license terms.
|