Fetching and aggregation of traffic data from Finnish roads
Project description
Python package for:
fetching raw historical traffic data from Finnish Transport Infrastructure Agency,
aggregating said data,
building directional graph between provinces/ervas and mapping the edges to the appropriate sections of the aggregated traffic data, and
visualizing the aggregated data.
Installation
pip3 install fin-traffic-data
Fetching raw traffic data
The console script fin-traffic-fetch-raw-data allows you to fetch the raw traffic data of all traffic measuring stations between two dates. Usage:
fin-traffic-fetch-raw-data --begin-date 2020-01-01 --end-date 2020-02-01
The dates are formatted as YYYY-MM-DD. The script spits out HDF5 files storing pandas dataframes with the filenaming convention fin_traffic_raw_<begin-date>_<end_date>.h5.
The output file contains the raw traffic data for each TMS in a dataset called tms_<tms id>.
Pre-existing raw traffic data
You can download a pre-existing raw traffic data (2020-01-01 - 2020-09-16) from Pouta.
Aggregating raw data
The console script fin-traffic-aggregate-raw-data allows you the aggregate pre-fetched traffic data. Usage:
fin-traffic-aggregate-raw-data --dir raw_data/ --time-resolution 1h
Here the options are
- –dir
Directory from which to load the datafiles for raw traffic data
- –time-resolution
Time-resolution of the aggregation. Use the literals w for weeks, d for days, and h for hours.
The script spits out a file named fin_traffic_aggregated_<begin-date>_<end-date>_<time-resolution>.h5.
Computing traffic between provinces and university hospital catchment areas
The console script fin-traffic-compute-traffic-between-areas can be used to compute traffic between different regions. For computing traffic between provinces, use the command:
fin-traffic-compute-traffic-between-areas --area province --input aggregated_data/fi_traffic_aggregated-2020-01-01 00:00:00-2020-09-16 00:00:00-1:00:00.h5
For traffic between university hospital catchment areas, use the flag –area erva. This tool spits out a file named tms_between_ervas.h5 or tms_between_provinces.h5.
Converting province/ERVA level traffic to CSV format
For converting province/ERVA level traffic to a compressed archive of CSV-files, use the command:
fin-traffic-export-traffic-between-areas-to-csv --area erva
This requires the file tms_between_ervas.h5 and outputs the archive tms_between_ervas.tar.bz2.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for fin_traffic_data-0.0.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | fc60ea513a6a8a28a95a966ec984aecb758396fe7b320274b97eb27e1dcbb195 |
|
MD5 | b9a8df71250e4ff1a2cb5e344107ed05 |
|
BLAKE2b-256 | 720789252f12fe3b007169cf6e9e4c008b99662832d6ccecfac6cdb5d1b1a3ad |