Science Score: 64.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
✓CITATION.cff file
Found CITATION.cff file -
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
○DOI references
-
✓Academic publication links
Links to: arxiv.org, ieee.org -
✓Committers with academic emails
1 of 2 committers (50.0%) from academic institutions -
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (12.5%) to scientific vocabulary
Keywords
Repository
Driving games common tools
Basic Info
Statistics
- Stars: 29
- Watchers: 10
- Forks: 6
- Open Issues: 10
- Releases: 0
Topics
Metadata Files
README.md
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
|  [Multi-agent simulation](#multi-agent-simulation) |  [Collision resolution](#collision-resolution) |  [Probabilistic sensors](#probabilistic-sensors) |
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
shell
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
shell
pip install pre-commit
pre-commit install
Run pre-commit with
shell
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. Drfler, E. Frazzoli - IEEE Robotics and Automation Letters, 2022
- Factorization of Dynamic Games over Spatio-Temporal Resources - A. Zanardi, S. Bolognani, A. Censi, F. Drfler, 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.
Owner
- Name: IDSC-Frazzoli
- Login: idsc-frazzoli
- Kind: organization
- Website: https://www.youtube.com/watch?v=tgLa25Aa8tc&t=5s&ab_channel=ETHZ%C3%BCrichFrazzoli
- Repositories: 49
- Profile: https://github.com/idsc-frazzoli
Citation (CITATION.cff)
cff-version: 1.2.0
title: Driving Games common tools
message: >-
If you use this software, please cite it using the
metadata from this file.
type: software
authors:
- email: azanardi@ethz.ch
affiliation: ETH Zurich
orcid: 'https://orcid.org/0000-0002-1341-6529'
given-names: Alessandro
family-names: Zanardi
GitHub Events
Total
- Issues event: 2
- Watch event: 4
- Delete event: 5
- Issue comment event: 9
- Push event: 42
- Pull request review event: 6
- Pull request review comment event: 13
- Pull request event: 10
- Create event: 1
Last Year
- Issues event: 2
- Watch event: 4
- Delete event: 5
- Issue comment event: 9
- Push event: 42
- Pull request review event: 6
- Pull request review comment event: 13
- Pull request event: 10
- Create event: 1
Committers
Last synced: almost 3 years ago
All Time
- Total Commits: 102
- Total Committers: 2
- Avg Commits per committer: 51.0
- Development Distribution Score (DDS): 0.01
Top Committers
| Name | Commits | |
|---|---|---|
| Alessandro Zanardi | a****i@e****h | 101 |
| Gioele Zardini | 3****i@u****m | 1 |
Committer Domains (Top 20 + Academic)
Issues and Pull Requests
Last synced: 6 months ago
All Time
- Total issues: 33
- Total pull requests: 102
- Average time to close issues: 4 months
- Average time to close pull requests: about 1 month
- Total issue authors: 4
- Total pull request authors: 6
- Average comments per issue: 0.61
- Average comments per pull request: 0.95
- Merged pull requests: 79
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 4
- Pull requests: 9
- Average time to close issues: about 1 hour
- Average time to close pull requests: 15 days
- Issue authors: 2
- Pull request authors: 3
- Average comments per issue: 0.0
- Average comments per pull request: 1.89
- Merged pull requests: 7
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
- alezana (29)
- ysli16 (2)
- TracyLeee (1)
- leonzug (1)
Pull Request Authors
- alezana (89)
- Suterz (11)
- ysli16 (5)
- zipping-suger (3)
- ywerneraris (2)
- leonzug (2)
Top Labels
Issue Labels
Pull Request Labels
Packages
- Total packages: 1
-
Total downloads:
- pypi 133 last-month
- Total dependent packages: 0
- Total dependent repositories: 2
- Total versions: 42
- Total maintainers: 1
pypi.org: dg-commons
Common tools and utilities related to Driving Games
- Homepage: https://github.com/idsc-frazzoli/dg-commons
- Documentation: https://dg-commons.readthedocs.io/
- License: LICENSE
-
Latest release: 0.0.47
published over 1 year ago
Rankings
Maintainers (1)
Dependencies
- dg-commonroad-drivability-checker ==2023.11