dg-commons (Driving Games common tools)
This package contains common tools that ease the development and quick prototyping of autonomous vehicles with a focus on multi-agent planning and decision-making.
Few Highlights
|
|
|
Simulator
The simulator builds on a clear distinction between the concept of an "agent" and its corresponding physical "model".
An agent receives observations and returns commands to the simulator. A model instead represents the physical instance of the agent in the simulation. The received commands from the agent are used to update its state according to the multi-agent simulation.
Collision resolution
Collision detection is performed at each step of the physical simulation, typically higher rate than the agents' updates. The framework provides also a basic collision resolution subroutine for the models. This is based on the impulse response technique among rigid bodies used in game engines. More references are provided in the corresponding location in the docs.
Commonroad integration
Most of the scenario tools natively integrate with the Commonroad project.
Few scenarios used mainly for testing are available in the scenarios folder.
For more scenarios consider cloning the Commonroad scenarios repository.
For internal use (private) consider also dg-scenarios.
Installation
The package is distributed on PyPI. You can simply install it via
pip install dg-commons
to install also the developer tools use pip install dg-commons["all"].
Pre-commit hook (for developers)
Install pre-commit with
pip install pre-commit
pre-commit install
Run pre-commit with
pre-commit run --all-files
Compatibility
From version 0.30 onwards the package is tested against python 3.9, 3.10, 3.11. It might work also for other versions, but it is not tested.
Publications
The tools contained in this package have contributed to the following publications:
- Posetal Games: Efficiency, Existence, and Refinement of Equilibria in Games with Prioritized Metrics - A. Zanardi*, G. Zardini*, S. Srinivasan, S. Bolognani, A. Censi, F. Dörfler, E. Frazzoli - IEEE Robotics and Automation Letters, 2022
- Factorization of Dynamic Games over Spatio-Temporal Resources - A. Zanardi, S. Bolognani, A. Censi, F. Dörfler, E. Frazzoli - Proceedings of the 2022 IEEE/RSJ International Conference on Intelligent Robots and Systems (IROS), 2022
- Task-driven Modular Co-design of Vehicle Control Systems - G. Zardini, Z. Suter, A. Censi, E. Frazzoli - Proceedings of the 61th IEEE Conference on Decision and Control (CDC), 2022
- Factorization of Multi-Agent Sampling-Based Motion Planning - A. Zanardi, P. Zullo, A. Censi, E. Frazzoli - Proceedings of the 62nd IEEE Conference on Decision and Control (CDC), 2023
- A Counterfactual Safety Margin Perspective on the Scoring of Autonomous Vehicles' Riskiness - A. Zanardi, A. Censi, M. Atzei, L. Di Lillo, E. Frazzoli - ArXiv preprint, 2023
Use and contributions
If you find some of the tools provided in this repository useful, consider citing it in your research via the provided github citation. If you want to contribute with new functionalities or need help in using the provided tools consider please feel free to open an issue.
1 maintainer
Release files for dg-commons 0.0.47
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| dg_commons-0.0.47.tar.gz | 87.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| dg_commons-0.0.47-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 218.2 kB
Release files / dg_commons-0.0.47.tar.gz
| Download URL | dg_commons-0.0.47.tar.gz |
|---|---|
| Size | 87.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
40f7edb2362609f1633a0aee029822f0bbe02156d6a8fefa4da87bc317a6c804
|
|
BLAKE2b-256 checksum How to use checksums |
8aff1be10c00d13414337cae744102e850c64e7e7ea9f4c0f8e9d90b4824378f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.8.2 CPython/3.10.12 Linux/6.5.0-35-generic
|
Release files / dg_commons-0.0.47-py3-none-any.whl
| Download URL | dg_commons-0.0.47-py3-none-any.whl |
|---|---|
| Size | 130.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2a6a072d6c229ad15a273c5e02c67e29aba5d5ec07c70150629c1055126bfc2e
|
|
BLAKE2b-256 checksum How to use checksums |
b2d998169e2fe6f68c9438f3cf3cbcc7aacf7cfb46a5a612b30231ccae57c1e5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.8.2 CPython/3.10.12 Linux/6.5.0-35-generic
|
