https://github.com/commonroad/commonroad-prediction
A collection and interface for CommonRoad prediction algorithms.
https://github.com/commonroad/commonroad-prediction
autonomous-driving autonomous-vehicles prediction
Last synced: 5 months ago
JSON representation
A collection and interface for CommonRoad prediction algorithms.
- Host: GitHub
- URL: https://github.com/commonroad/commonroad-prediction
- Owner: CommonRoad
- License: bsd-3-clause
- Created: 2024-03-04T14:32:17.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-10-22T07:06:59.000Z (8 months ago)
- Last Synced: 2026-01-06T07:29:35.639Z (5 months ago)
- Topics: autonomous-driving, autonomous-vehicles, prediction
- Language: Python
- Homepage: https://commonroad.in.tum.de/tools/commonroad-prediction
- Size: 770 KB
- Stars: 6
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# CommonRoad-Prediction
[](https://pypi.python.org/pypi/commonroad-prediction/)
[](https://pypi.python.org/pypi/commonroad-prediction/)
[](https://pypi.python.org/pypi/commonroad-prediction/)
[](https://pypi.python.org/pypi/commonroad-prediction/)
[](https://pypi.python.org/pypi/commonroad-prediction/)
A collection and interface for CommonRoad-based prediction algorithms.
## Project status
Currently implemented and tested models:
- Constant Velocity Linear Predictor [1]
- Constant Velocity Curvilinear Predictor [1]
- Constant Acceleration Linear Predictor [1]
- Constant Acceleration Curvilinear Predictor [1]
In development:
- Intelligent Driver Model (IDM) Predictor [2]
- Lane-Changing Model MOBIL Predictor [3]
We highly welcome your contribution.
If you want to contribute a prediction algorithm, please create an issue/pull request in our [GitHub repository](https://github.com/commonroad/commonroad-prediction).
## Installation and Usage
We recommend to use PyCharm (Professional) as IDE.
### Usage in other projects
We provide an PyPI package which can be installed with the following command
```shell
pip install commonroad-prediction
```
### Development
It is recommended to use [poetry](https://python-poetry.org/) as an environment manager.
Clone the repository and install it with poetry.
```shell
git clone git@github.com:commonroad/commonroad-prediction.git
poetry shell
poetry install
```
### Examples
We recommend to use PyCharm (Professional) as IDE.
An example script for visualizing predictions is provided [here](example.md).
## Documentation
You can generate the documentation within your activated Poetry environment using.
```bash
poetry shell
mkdocs build
```
The documentation will be located under site, where you can open `index.html` in your browser to view it.
For updating the documentation you can also use the live preview:
```bash
poetry shell
mkdocs serve
```
## Authors
Responsible: Roland Stolz, Sebastian Maierhofer
## References
The implemented algorithms are based on the subsequent publications:
[1] R. Schubert, E. Richter and G. Wanielik,
"Comparison and evaluation of advanced motion models for vehicle tracking,"
Proc. of the IEEE Int. Conf. on Information Fusion, 2008, pp. 1-6.
[2] M. Treiber, A. Hennecke, and D. Helbing,
"Congested traffic states in empirical observations and microscopic simulations,"
Physical Review E, vol. 62, no. 2, pp. 1805–1824, 2000.
[3] A. Kesting, M. Treiber, and D. Helbing,
“General lane-changing model MOBIL for car-following models,”
Transportation Research Record, vol. 1999, pp. 86–94, Jan. 2007