Home

Awesome

<p align="center"> <img src="https://github.com/bark-simulator/bark/raw/master/docs/source/bark_logo.jpg" alt="BARK" /> </p>

$${\color{red}\text{BARK is not actively developed and maintained any longer.}}$$

$${\color{red}\text{Feel free to fork the repository and continue using BARK under the terms of the MIT license.}}$$

Ubtuntu-CI Build Ubtuntu-ManyLinux Build NIGHTLY LTL Build CI RSS Build NIGHTLY Rules MCTS Build Codacy Badge

BARK - A Tool for Behavior benchmARKing

BARK is a semantic simulation framework for autonomous driving. Its behavior model-centric design allows for the rapid development, training, and benchmarking of various decision-making algorithms. It is especially suited for computationally expensive tasks, such as reinforcement learning. A a good starting point, have a look at the content of our BARK-Tutorial on IROS 2020.

Usage

(A) Pip Package

For whom it is: Python evangelists implementing python behavior models or ML scientists using BARK-ML for learning behaviors.

Bark is available as PIP-Package for Ubuntu and MacOS for Python>=3.7. You can install the latest version with pip install bark-simulator. The Pip package supports full benchmarking functionality of existing behavior models and development of your models within python.

After installing the package, you can have a look at the examples to check how to use BARK.

Highway ExampleMerging ExampleIntersection Example
IntersectionIntersectionIntersection

(B) Build it from Source

For whom it is: C++ developers creating C++ behavior models, researchers performing benchmarks, or contributors to BARK.

Use git clone https://github.com/bark-simulator/bark.git or download the repository from this page. Then follow the instructions at How to Install BARK.

To get step-by-step instructions on how to use BARK, you can run our IPython Notebook tutorials using bazel run //docs/tutorials:run. For a more detailed understanding of how BARK works, its concept and use cases have a look at our documentation.

Example Benchmark is a running example of how to use BARK for benchmarking for scientific purposes.

Scientific Publications using BARK

BARK Ecosystem

The BARK ecosystem is composed of multiple components that all share the common goal to develop and benchmark behavior models:

Paper

If you use BARK, please cite us using the following paper:

@inproceedings{Bernhard2020,
    title = {BARK: Open Behavior Benchmarking in Multi-Agent Environments},
    author = {Bernhard, Julian and Esterle, Klemens and Hart, Patrick and Kessler, Tobias},
    booktitle = {2020 IEEE/RSJ International Conference on Intelligent Robots and Systems (IROS)},
    url = {https://arxiv.org/pdf/2003.02604.pdf},
    year = {2020}
}

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

License

BARK specific code is distributed under MIT License.