dhidb

dhidb provides read-only Python access to the global 300 m Dynamic Habitat Indices database stored as a dense TileDB array on public S3-compatible object storage. It supports point, bounding-box, and polygon queries without first downloading the complete database.

Installation

pip install dhidb

For development:

python -m pip install -e ".[test]"

Requirements and optional dependencies

DHIDB requires Python 3.10 or newer. The runtime dependencies and the compatibility ranges published by the package are:

Optional features are installed with package extras. There is no generic dhidb[dependency] extra; use the feature-specific extra you need:

For local development and testing:

python -m pip install -e ".[test,netcdf,zarr]"

The documentation website has its own Node.js dependencies in website/package.json; they are not part of the Python package extras.

Quick start

from dhidb import DHIProvider

with DHIProvider() as db:
    print(db.years)
    print(db.variables)

    germany = db.query_bbox(
        bounds=(5.8, 47.2, 15.1, 55.1),
        years=[2020, 2021, 2022],
        variables=["dhi_cum", "dhi_min", "dhi_var", "valid_count"],
    )

Documentation

The Docusaurus website source is in website/. Build it locally with:

npm --prefix website install
npm --prefix website run start

Data variables

License

MIT