Skip to main content

Estimation of movements from snapshots

Project description

Estimate flows of people from snapshots using the method of [Akagi2018].

There are two parts to this package

  • a fake data generator

  • an estimator

A couple IPython notebooks are included as demonstrations. One of these generates fake data and attempts to recover the underlying parameters. It is most useful for demonstration and testing.

Another is designed to run on real world data. It requires the user to supply additional data: counts of people in New Zealand SA2 regions and properties of those regions. The later information is available from StatsNZ:

We have assumed that the centroid-to-centroid distance separating regions is an appropriate metric. In principle, the user can specify an arbitrary distance measure on the space, allowing distances to be set by actual driving time, non-local travel via airports, or even asymmetry during commutes.

There are still some rough edges and there may be more corner cases to be taken care of.


A conda environment specification is included. This environment has been testing on Linux and OS X.

conda env create -f environment.yml
conda activate movement
pip install -e .
  1. Akagi, T. Nishimura, T. Kurashima, and H. Toda, “A Fast and Accurate Method for Estimating People Flow from Spatiotemporal Population Data,” in Proceedings of the Twenty-Seventh International Joint Conference on Artificial Intelligence, Stockholm, Sweden, Jul. 2018, pp. 3293–3300, doi: 10.24963/ijcai.2018/457.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

flowstock-0.0.1.dev0.tar.gz (12.9 kB view hashes)

Uploaded source

Built Distribution

flowstock-0.0.1.dev0-py3-none-any.whl (13.5 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page