Mobility

An open-source solution to compute the carbon emissions due to the mobility of a local population.
https://github.com/mobility-team/mobility

Category: Consumption
Sub Category: Mobility and Transportation

Keywords

carbon carbon-footprint mobility open-source transport transportation

Last synced: about 1 hour ago
JSON representation

Repository metadata

Mobility, an open-source library for mobility modelisation

README.md

Mobility, an open-source package for transport modelling

Mobility is an open-source Python package for modelling how people move in a local territory, from short trips to longer trips, for personal and work-related motives, on multimodal transport networks.

It was built for transport modellers, urban planners, students, and analysts who want to work with a full mobility workflow: define a study area, build a synthetic population, describe transport options, simulate daily trips, and compare scenarios. It can be used on regions made of hundreds of communes or zones, mainly in France and Switzerland today.

Mobility estimates travel diaries for a local sample population. The model uses individual socio-economic characteristics, expected daily activity programmes, opportunities at places of interest, congestion on transport networks, and generalized transport costs. Most inputs can be prepared from open data. The package provides default parameters so a modeller can build a first working base case. These defaults still need local checks and calibration.

Mobility can help you explore questions such as:

  • how many trips are made by car, bicycle, walking, or public transport,
  • where the main origin-destination flows are,
  • how travel distances, travel times, and emissions change between scenarios,
  • what happens when a new line, a cost change, or a land-use change is added to the model.

After a first run, you can inspect simulated daily plan steps, aggregate indicators by mode or activity, origin-destination flow plots, diagnostics by iteration, and scenario comparisons.

The package is mainly focused today on French and Swiss territories. It uses open data, mobility surveys, Python, R, and compiled tools such as osmium-tool. Users install the mamba environment from a release file, then install Mobility from PyPI as mobility-tools.

Start Here

Mobility has been developed mainly by AREP and Elioth with ADEME support, but anyone can join the project.

More project history, contributors, and example uses are listed in the documentation.


Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 2 days ago

Total Commits: 680
Total Committers: 16
Avg Commits per committer: 42.5
Development Distribution Score (DDS): 0.516

Commits in past year: 257
Committers in past year: 8
Avg Commits per committer in past year: 32.125
Development Distribution Score (DDS) in past year: 0.37

Name Email Commits
Felix Pouchain f****n@g****m 329
Cap c****n@a****r 205
AntoineGauchot a****t@a****r 36
BENYEKKOU ADAM a****u@a****r 32
matt-gau m****t@m****h 18
alahmar a****r@m****r 15
l.gontier l****r@e****r 10
cpequign c****t@e****r 9
F. Ayoub 1****U 8
lucas_bohnenkamp0 l****p@a****r 6
POUCHAIN FÉLIX f****n@a****r 3
mariegrandclement m****t@a****r 2
lucas-boh 8****h 2
dependabot[bot] 4****] 2
GIROT Anne-Sophie a****t@e****r 2
Adam Benyekkou 6****u 1

Committer domains:


Issue and Pull Request metadata

Last synced: 1 day ago

Total issues: 122
Total pull requests: 146
Average time to close issues: 4 months
Average time to close pull requests: about 1 month
Total issue authors: 11
Total pull request authors: 15
Average comments per issue: 2.41
Average comments per pull request: 1.04
Merged pull request: 98
Bot issues: 0
Bot pull requests: 8

Past year issues: 57
Past year pull requests: 64
Past year average time to close issues: 26 days
Past year average time to close pull requests: 11 days
Past year issue authors: 5
Past year pull request authors: 6
Past year average comments per issue: 1.74
Past year average comments per pull request: 1.28
Past year merged pull request: 42
Past year bot issues: 0
Past year bot pull requests: 8

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/mobility-team/mobility

Top Issue Authors

  • Mind-the-Cap (52)
  • FlxPo (47)
  • AntoineGauchot (5)
  • lucas-boh (4)
  • matt-gau (4)
  • louisegontier (3)
  • adam-benyekkou (3)
  • acerioni (1)
  • Nouhaila13 (1)
  • Adelaide-Aublet (1)
  • AyoubFOUNDOU (1)

Top Pull Request Authors

  • FlxPo (52)
  • Mind-the-Cap (47)
  • BaptisteD35 (10)
  • dependabot[bot] (8)
  • be22-bnm (5)
  • louisegontier (4)
  • lucas-boh (3)
  • adam-benyekkou (3)
  • AntoineGauchot (3)
  • AyoubFOUNDOU (3)
  • mariegrandclement (2)
  • cpequign (2)
  • LyesKaya (2)
  • ranms25 (1)
  • Nouhaila13 (1)

Top Issue Labels

  • enhancement (24)
  • bug (21)
  • to-improve (8)
  • documentation (7)
  • ready-for-dev (7)
  • communication (4)
  • ready-soon (3)
  • good first issue (3)
  • standard (1)
  • question (1)
  • déploiement (1)

Top Pull Request Labels

  • enhancement (16)
  • python (8)
  • dependencies (8)
  • bug (6)
  • documentation (1)

Package metadata

pypi.org: mobility-tools

A tool to simulate the mobility behaviours of the inhabitants of a given region.

  • Homepage: https://github.com/mobility-team/mobility
  • Documentation: https://mobility-tools.readthedocs.io/
  • Licenses: mit
  • Latest release: 0.0.1 (published about 4 years ago)
  • Last Synced: 2026-04-01T00:02:27.716Z (2 months ago)
  • Versions: 2
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 106 Last month
  • Rankings:
    • Dependent packages count: 6.633%
    • Stargazers count: 18.624%
    • Average: 29.973%
    • Forks count: 30.492%
    • Dependent repos count: 30.611%
    • Downloads: 63.504%
  • Maintainers (1)

Dependencies

environment.yml conda
  • osmium-tool 1.18.0
  • python 3.12
  • r-base 4.5.1
  • uv 0.8.4
docs/requirements.txt pypi
  • myst_parser *
  • sphinx_copybutton *
  • sphinx_rtd_theme *
.github/workflows/install-mac.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v3 composite
  • mamba-org/setup-micromamba v1 composite
  • r-lib/actions/setup-r v2 composite
  • r-lib/actions/setup-r-dependencies v2 composite
DESCRIPTION cran
  • FNN * imports
  • arrow * imports
  • cluster * imports
  • cppRouting * imports
  • data.table * imports
  • dbscan * imports
  • dodgr * imports
  • dplyr * imports
  • duckdb * imports
  • future * imports
  • future.apply * imports
  • geos * imports
  • ggplot2 * imports
  • gtfsrouter * imports
  • hms * imports
  • jsonlite * imports
  • log4r * imports
  • lubridate * imports
  • nngeo * imports
  • osmdata * imports
  • readxl * imports
  • remotes * imports
  • sf * imports
  • sfheaders * imports
.devcontainer/Dockerfile docker
  • python 3.12-slim build
.github/workflows/install-and-test.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v3 composite
  • codecov/codecov-action v4 composite
  • mamba-org/setup-micromamba v1 composite
  • r-lib/actions/setup-r v2 composite
  • r-lib/actions/setup-r-dependencies v2 composite
pyproject.toml pypi
  • geojson *
  • geopandas *
  • gtfs-kit *
  • kaleido *
  • matplotlib *
  • networkx *
  • numpy *
  • openpyxl *
  • pandas *
  • plotly *
  • polars *
  • psutil *
  • py7zr *
  • pyarrow *
  • pyogrio *
  • python-dotenv *
  • requests *
  • rich *
  • scikit-learn *
  • scipy *
  • seaborn *
  • shortuuid *

Score: 12.207591491499443