quetzal
What is it?
quetzal is a Python package providing flexible models for transport planning and traffic forecasting. Quetzal is highly optimized to run fast on big cities.
Copyright
(c) SYSTRA
License
Documentation
The official documentation is hosted on https://systragroup.github.io/quetzal
Backward compatibility
In order to improve the ergonomics, the code may be re-factored and a few method calls may be re-designed. As a consequence, the backward compatibility of the library is not guaranteed. Therefore, the version of quetzal used for a project should be specified in its requirements.
Installation
https://pypi.org/project/quetzal-transport/
pip install quetzal-transport
Installation from sources
For Linux
uv
- Install uv (if not already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh
- install dependencies (this will create a new virtualenv at
.venv/and fetch Python 3.12 if needed)
uv sync
- activate the env
source .venv/bin/activate
- (optional) add the env to ipykernel (to use in jupyter)
python -m ipykernel install --user --name=quetzal_env
poetry (alternative)
- You may need to set the default (or local) python version in the project
pyenv local 3.12
- install dependancies (this will create a new virtualenv)
poetry install
- activate the env
poetry shell
- (optional) add the env to ipykernel (to use in jupyter)
python -m ipykernel install --user --name=quetzal_env
For Windows
uv (recommended)
No prior installation of Python or uv is required — the batch file handles both. Open a command prompt and run the windows-install batch file
C:\users\you\path\to\quetzal> windows-install.bat
press enter to accept the default kernel name or enter a custom name
poetry (alternative)
Requires Anaconda 3 with Python 3.12. Run the poetry batch file instead:
C:\users\you\path\to\quetzal> windows-install-poetry.bat
press enter to accept the default kernel name or enter a custom name
If you are facing DLL or dependencies issues
Anaconda and Pip do not get along well, your Anaconda install may have been corrupted at some point.
- Remove your envs
- Uninstall Anaconda
- Delete your Python and Anaconda folders (users\you\Anaconda3, users\you\Appdata\Roaming\Python, ...etc)
- Install Anaconda
If you are facing SSL issues
pip config set global.trusted-host "pypi.org files.pythonhosted.org"
C:\users\you\path\to\quetzal> windows-install.bat
security warning: the host is added to pip.ini
Tests
to run unittest:
uv run python -W ignore -m unittest discover
Or with poetry:
poetry run python -W ignore -m unittest discover
Deploying
- change the version in pyproject.toml
[project]
name = "quetzal-transport"
version = "3.1.1"
- edit CHANGELOG.md with the changes
## [3.1.1] (2026-01-15)
## changes
* some changes
- commit your changes
git commit -m 'description'
- create a tag matching the version (starting with v)
git tag -a v3.1.1 -m 'description'
- push the tag
git push origin v3.1.1
that's it. A Github action will
- build
- create a release
- update the package on pipy.
1 maintainer
Metadata
1 maintainer
Release files for quetzal-transport 3.10.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| quetzal_transport-3.10.2.tar.gz | 907.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| quetzal_transport-3.10.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.0 MB
Release files / quetzal_transport-3.10.2.tar.gz
| Download URL | quetzal_transport-3.10.2.tar.gz |
|---|---|
| Size | 907.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c7abe1e03a9292370435e0fbfc76f40bf7ca2153eddd62641e2a8668bf3ecbce
|
|
BLAKE2b-256 checksum How to use checksums |
26bcfa874c43d7eae5fb5cb4663d5b16f24ef554a355b5105aaca36af48a07bc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / quetzal_transport-3.10.2-py3-none-any.whl
| Download URL | quetzal_transport-3.10.2-py3-none-any.whl |
|---|---|
| Size | 1.1 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
55c28a05d0d1e210ea95a8f3a2c443575da7f358bcfa26b85025b69dca9a731e
|
|
BLAKE2b-256 checksum How to use checksums |
4bb3719bb1712f93eaa216244d1432558c533deb062ca507efa2d20d6b9b7b39
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
