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.pois.library     # OSM destinations, one category per file
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.

Each data attribute — including each category under pois — 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.

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) — with attribution recorded per asset in <region>.metadata.

Development Status
- 3 - Alpha
Intended Audience
- Science/Research
License
- OSI Approved :: MIT License
Operating System
- OS Independent
Programming Language
- Python :: 3
Topic
- Scientific/Engineering :: GIS

Download files

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

Source Distribution

cafein_sampledata-2026.8.1.tar.gz (68.6 kB view details)

Uploaded Aug 11, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

cafein_sampledata-2026.8.1-py3-none-any.whl (13.9 kB view details)

Uploaded Aug 11, 2026 Python 3

File details

Details for the file cafein_sampledata-2026.8.1.tar.gz.

File metadata

Download URL: cafein_sampledata-2026.8.1.tar.gz
Upload date: Aug 11, 2026
Size: 68.6 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for cafein_sampledata-2026.8.1.tar.gz
Algorithm	Hash digest
SHA256	`161a6ac0694f1ae4486b9ef3975bf0e74756abdb23f676a84d5d4df79eefa491`
MD5	`745e091d699d2b9fc26bfae5cd832e5b`
BLAKE2b-256	`f8a2ffe0f6af06d7f3ff8b2e6173109106e205af93aa39f23fee7c0a12aa613c`

See more details on using hashes here.

Provenance

The following attestation bundles were made for cafein_sampledata-2026.8.1.tar.gz:

Publisher: release.yaml on cafein-py/cafein.sampledata

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: cafein_sampledata-2026.8.1.tar.gz
- Subject digest: 161a6ac0694f1ae4486b9ef3975bf0e74756abdb23f676a84d5d4df79eefa491
- Sigstore transparency entry: 2424305917
- Sigstore integration time: Aug 11, 2026
Source repository:
- Permalink: cafein-py/cafein.sampledata@e8c4dff8f528d15d3b7688526fbdd5d18918a08f
- Branch / Tag: refs/tags/v2026.8.1
- Owner: https://github.com/cafein-py
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yaml@e8c4dff8f528d15d3b7688526fbdd5d18918a08f
- Trigger Event: push