cafein.sampledata

Sample datasets for cafein: up-to-date, openly licensed data for the Helsinki Metropolitan Area, downloaded on first access and cached locally.

import cafein.sampledata.helsinki as helsinki

helsinki.osm_pbf          # OpenStreetMap extract, capital region
helsinki.gtfs             # HSL GTFS feed
helsinki.dem              # NLS 10 m elevation model
helsinki.population_grid  # HSY 250 m population grid
helsinki.air_quality      # FMI-ENFUSER air quality, one pinned hour
helsinki.green_view       # Green View Index (street-level greenery)
helsinki.noise            # Helsinki noise survey 2022, zone polygons
helsinki.pois.library     # OSM destinations, one category per file
helsinki.statistics.income # Paavo income variables by postal code area
helsinki.mobility.od_weekday # dynamic population & derived OD (DGL)
helsinki.emission_factors # cafein's default GHG factors as a CSV

Destination categories under pois — library, kindergarten, university, supermarket, shopping_centre, sports_centre, swimming_hall — each a GeoPackage of points (layer pois, EPSG:4326) extracted from the same OpenStreetMap release as osm_pbf.

Statistics layers under statistics — currently income, Statistics Finland's Paavo disposable-income variables (median and average income, income-category counts, for inhabitants and households) by postal-code area, polygons in EPSG:3067 (layer income). Values Paavo protects for privacy are nulls.

Mobility layers under mobility — the Digital Geography Lab's 24-hour population presence for the HMA (Müürisepp et al. 2026): hourly presence linked to home neighbourhoods as Parquet tables (presence_weekday, presence_weekend), a derived home-to-location OD per day type (od_weekday, od_weekend — a demand proxy, not observed trips), and the 298 neighbourhoods polygons (EPSG:3067).

Each data attribute — including each category under pois and each layer under statistics — is a pathlib.Path; the file downloads and verifies on first use. A package release pins exact data snapshots — upgrade the package to get newer data.

Data files are cached under the platform user-cache directory; set CAFEIN_SAMPLEDATA_DIR to relocate the cache.

Exposure layers

air_quality is a multi-band GeoTIFF of ONE model hour of FMI-ENFUSER (the hour and model origin are stamped in the metadata) — not a climatology — on its native ~13 m EPSG:4326 grid. Band names and units also travel in the file's band descriptions:

green_view is the published Green View Index dataset for the capital region (Data in Brief, doi:10.1016/j.dib.2020.105601), columns verbatim as published, EPSG:3067:

(92 126 points, 56 074 segments; the road attribute codes are the MetropAccess street network's own, published as-is)

noise holds Helsinki's 2022 noise survey zones as polygons in EPSG:3067, Helsinki-city extent; the 2022 round's calculation method is not comparable with 2017's:

Data licenses

The package code is MIT. The datasets carry their own open licenses — OpenStreetMap (ODbL 1.0, the extract and the POI layers derived from it), HSL GTFS (CC BY 4.0), National Land Survey of Finland elevation model (CC BY 4.0), HSY population grid (CC BY 4.0), Statistics Finland Paavo (CC BY 4.0), the DGL population-presence dataset (CC BY 4.0), FMI-ENFUSER air quality (CC BY 4.0), the Green View Index dataset (CC BY 4.0, Toikka et al. 2020), and the Helsinki noise survey (CC BY 4.0) — with attribution recorded per asset in <region>.metadata.