mobility-tools 0.2.1

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

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. The recommended install path uses Pixi to prepare the project environment and install Mobility from PyPI as mobility-tools. The mamba environment file is still provided as a fallback for now.

Start Here

• Install Mobility, then run the local quickstart.
• Run the quickstart to build a small Limoges model and read first indicators.
• Read the full documentation when you want to adapt the workflow to a real study.
• Visit the French project website
• Open an issue

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.