DynamicalSystemFramework
The aim of this project is to rework the original Traffic Flow Dynamics Model. This rework consists of a full code rewriting, in order to implement more features (like intersections) and get advantage from the latest C++ updates.
Table of Contents
- Installation
- Installation (from source)
- Examples
- Visualization & GUI
- Projects Using DSF
- For Developers
- Citing
- Bibliography
Installation
The library is available on PyPI:
pip install dsf-suite
To check the installation you can simply run:
import dsf
print(dsf.__version__)
Installation (from source)
Requirements
The project requires C++20 or greater, cmake, tbb, simdjson, spdlog, csv-parser, and SQLiteCpp.
To install requirements on Ubuntu:
sudo apt install cmake libtbb-dev
To install requirements on macOS:
brew install cmake tbb
Installation (C++)
The library can be installed using CMake. To build and install the project in the default folder run:
cmake -B build -DCMAKE_BUILD_TYPE=Release && cmake --build build -j$(nproc)
sudo cmake --install build
Otherwise, it is possible to customize the installation path:
cmake -B build -DCMAKE_INSTALL_PREFIX=/path/to/install
then building and installing it with:
cmake --build build
cmake --install build
Installation (Python)
If you want to use the library from Python, you can build the Python bindings using nanobind. Make sure you have tbb installed:
sudo apt install libtbb-dev
Then, the installation is automatic via uv:
uv build
or via standard pip:
pip install .
After installation, verify the import in Python:
import dsf
print(dsf.__version__)
If you encounter issues, ensure that the installation path is in your PYTHONPATH environment variable.
Examples
Examples in this repository are being migrated. You can build legacy C++ examples by passing -DDSF_EXAMPLES=ON to CMake; output binaries will be generated under the examples/ directory.
Updated and active examples are maintained in dsf-examples.
Visualization & GUI
For real-time dynamic visualization and visual inspection of network flows, see dsf-gui. It offers an interactive front-end designed specifically for monitoring simulations, analyzing queue dynamics, and visual debugging.
Projects Using DSF
- bdt-mobility — Bologna Digital Twin Mobility Toolkit: Data extraction pipeline and policy-impact traffic simulation framework built for defined Zones of Interest (ZOI).
For Developers
This project includes a pre-commit hook setup.
To enable it locally, run:
pip install pre-commit
pre-commit install
Testing
This project uses Doctest for unit testing.
Tests are built automatically in Debug or Coverage mode. To manually force test compilation:
cmake -B build -DDSF_TESTS=ON
cmake --build build -j$(nproc)
To execute the test suite:
ctest --test-dir build -j$(nproc) --output-on-failure
Benchmarking
Core performance critical components are benchmarked using Google Benchmark.
To build benchmark targets:
cmake -B build -DDSF_BENCHMARKS=ON
cmake --build build -j$(nproc)
To run all benchmark executables:
cd benchmark
for f in ./*.out ; do ./$f ; done
Citing
If you use this software, please cite it using the metadata in CITATION.cff (GitHub's "Cite this repository" button exports it as BibTeX/APA), or via Zenodo DOI: 10.5281/zenodo.18745492.
Bibliography
- Mungai, Veronica (2024) Studio dell'ottimizzazione di una rete semaforica. University of Bologna, Bachelor's Degree in Physics [L-DM270]. Link to Thesis.
- Berselli, Gregorio (2024) Advanced queuing traffic model for accurate congestion forecasting and management. University of Bologna, Master's Degree in Physics [LM-DM270]. Link to Thesis.
- Berselli, Gregorio (2022) Modelli di traffico per la formazione della congestione su una rete stradale. University of Bologna, Bachelor's Degree in Physics [L-DM270]. Link to Thesis.
1 maintainer
Metadata
1 maintainer
Release files for dsf-suite 7.5.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| dsf_suite-7.5.0.tar.gz | 192.5 kB | Without provenance | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| dsf_suite-7.5.0-cp314-cp314-win_amd64.whl | CPython 3.14 | CPython 3.14 | Windows x86-64 | Details |
| dsf_suite-7.5.0-cp314-cp314-manylinux_2_28_x86_64.whl | CPython 3.14 | CPython 3.14 | Linux glibc 2.28+ x86-64 | Details |
| dsf_suite-7.5.0-cp314-cp314-macosx_26_0_arm64.whl | CPython 3.14 | CPython 3.14 | macOS 26.0+ ARM64 | Details |
| dsf_suite-7.5.0-cp313-cp313-win_amd64.whl | CPython 3.13 | CPython 3.13 | Windows x86-64 | Details |
| dsf_suite-7.5.0-cp313-cp313-manylinux_2_28_x86_64.whl | CPython 3.13 | CPython 3.13 | Linux glibc 2.28+ x86-64 | Details |
| dsf_suite-7.5.0-cp313-cp313-macosx_26_0_arm64.whl | CPython 3.13 | CPython 3.13 | macOS 26.0+ ARM64 | Details |
| dsf_suite-7.5.0-cp312-cp312-win_amd64.whl | CPython 3.12 | CPython 3.12 | Windows x86-64 | Details |
| dsf_suite-7.5.0-cp312-cp312-manylinux_2_28_x86_64.whl | CPython 3.12 | CPython 3.12 | Linux glibc 2.28+ x86-64 | Details |
| dsf_suite-7.5.0-cp312-cp312-macosx_26_0_arm64.whl | CPython 3.12 | CPython 3.12 | macOS 26.0+ ARM64 | Details |
Total release size: 17.1 MB
Release files / dsf_suite-7.5.0.tar.gz
| Download URL | dsf_suite-7.5.0.tar.gz |
|---|---|
| Size | 192.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7990dda45b2115bb9ca23cfc7b8235ea3c25900397df08d50d54c5beb3e29b30
|
|
BLAKE2b-256 checksum How to use checksums |
f8cca13ef21325f1da033dff7b696916578be22df49d3d44cb67944e792cac2b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Release files / dsf_suite-7.5.0-cp314-cp314-win_amd64.whl
| Download URL | dsf_suite-7.5.0-cp314-cp314-win_amd64.whl |
|---|---|
| Size | 1.7 MB |
| Tags | CPython 3.14 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
c2f4e62acc95592b13c7f5249f5557eb969510f32de786c1c68966a5fcb1da68
|
|
BLAKE2b-256 checksum How to use checksums |
ffdeff1f6a2dda0674239c4b8dcb850ebd168594dbe678bfe3b07a110939a30f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Release files / dsf_suite-7.5.0-cp314-cp314-manylinux_2_28_x86_64.whl
| Download URL | dsf_suite-7.5.0-cp314-cp314-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 2.4 MB |
| Tags | CPython 3.14 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
4e716ac9d849325c0dc57292b05c608fa53a7d101200d0f3220ca35430beb0bd
|
|
BLAKE2b-256 checksum How to use checksums |
5fdc56e6013cde5458559da544319d568923a0842001d61bce350dc54da46dd2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Release files / dsf_suite-7.5.0-cp314-cp314-macosx_26_0_arm64.whl
| Download URL | dsf_suite-7.5.0-cp314-cp314-macosx_26_0_arm64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.14 macOS 26.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
eca0f1fdb491b68592485eea37499fcbd81a8643751acdcdb899318f1634ef1d
|
|
BLAKE2b-256 checksum How to use checksums |
801af05bfd8174e01a63ba809fcd3e41c36987015720401c991f69bbc8c03685
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Release files / dsf_suite-7.5.0-cp313-cp313-win_amd64.whl
| Download URL | dsf_suite-7.5.0-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 1.7 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
e73ccbfb3fe011709300bfa1a1b03b661609d56fac92d5b0f6a8c0c0bbc36ccc
|
|
BLAKE2b-256 checksum How to use checksums |
3cd315d283f4e6372012de69651e1756c64e798a0c1b658949d4572aece49b5e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Release files / dsf_suite-7.5.0-cp313-cp313-manylinux_2_28_x86_64.whl
| Download URL | dsf_suite-7.5.0-cp313-cp313-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 2.4 MB |
| Tags | CPython 3.13 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
de46e61ee50d1fe73e56a1e0fe86eb782189f090e090c617e0498a00f0e185b3
|
|
BLAKE2b-256 checksum How to use checksums |
f3ed62360ed8313f9cde406e94700dbb51923ddf8c5e64082c215dd90bc5ff97
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Release files / dsf_suite-7.5.0-cp313-cp313-macosx_26_0_arm64.whl
| Download URL | dsf_suite-7.5.0-cp313-cp313-macosx_26_0_arm64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.13 macOS 26.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
2e7bf5f8bccef161398013f0708180d02ff786b0d1bb18f502e2f80a7307df4a
|
|
BLAKE2b-256 checksum How to use checksums |
7427e175fe34b31ed1b4c28c58c45a015db44a056a55b1cdf74d1a52b9608557
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Release files / dsf_suite-7.5.0-cp312-cp312-win_amd64.whl
| Download URL | dsf_suite-7.5.0-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 1.7 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
0a0af1114a374ac9700e0f0e5f887367b7c574b59f9de49899a81efe2fd8f5a6
|
|
BLAKE2b-256 checksum How to use checksums |
a6a94aaa0cb9aa29fd91330ba5088cc13435b1ea77fd22b43fb4c5fa073ecd06
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Release files / dsf_suite-7.5.0-cp312-cp312-manylinux_2_28_x86_64.whl
| Download URL | dsf_suite-7.5.0-cp312-cp312-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 2.4 MB |
| Tags | CPython 3.12 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
f658fa401256ffd1978c9613eeaf1bfc9bfdf9114820c5cbaed6734f138fcd91
|
|
BLAKE2b-256 checksum How to use checksums |
301e96ccaa5f6416d78bdac05e391029b56053fc66fed289e9f05463520232d3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Release files / dsf_suite-7.5.0-cp312-cp312-macosx_26_0_arm64.whl
| Download URL | dsf_suite-7.5.0-cp312-cp312-macosx_26_0_arm64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.12 macOS 26.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
9693bb2a403075e9dce5208118a60c5b35cbcf89baaf0df3f25e95007343f316
|
|
BLAKE2b-256 checksum How to use checksums |
cddfc37d6534cbb33997c1af90cca71e3699e0234fc1b2af9d68235c9abec860
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Security for dsf-suite 7.5.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
