euroflood 0.1.0__tar.gz

euroflood-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,73 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  quality:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        # Add "3.14" once rasterio/osmnx/duckdb wheels are available for it.
+        python-version: ["3.13"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --extra viz
+
+      - name: Ruff format check
+        run: uv run ruff format --check .
+
+      - name: Ruff lint
+        run: uv run ruff check .
+
+      - name: Type check (mypy)
+        run: uv run mypy src
+
+      - name: Dependency check (deptry)
+        run: uv run deptry .
+
+      - name: Tests + coverage
+        # -n auto parallelises the suite across the runner's cores (pytest-xdist);
+        # pytest-cov aggregates per-worker coverage, so fail_under still applies.
+        run: uv run pytest -n auto --cov=euroflood --cov-report=xml --cov-report=term-missing
+
+      - name: Tutorials (offline smoke)
+        # Execute the cheap-path tutorials against the committed Cologne fixture with no
+        # network. The download/hazard tutorials (04, 05) need the live index -> nightly
+        # examples.yml. Absolute paths: nbmake runs each notebook with cwd = examples/.
+        env:
+          EUROFLOOD_CACHE_DIR: ${{ github.workspace }}/tests/fixtures/realdata/index
+          EUROFLOOD_INDEX_MODE: local
+          EUROFLOOD_GEOCODER_BACKEND: local
+          EUROFLOOD_BOUNDARY_DATASET_PATH: ${{ github.workspace }}/tests/fixtures/realdata/nuts_subset.geojson
+          EUROFLOOD_SHOW_PROGRESS: "0"
+        run: >-
+          uv run pytest --nbmake --nbmake-timeout=120
+          examples/01_quickstart.ipynb
+          examples/02_discover_and_filter.ipynb
+          examples/03_visualize.ipynb
+          examples/07_cli_and_config.ipynb
+
+      - name: Docs build (strict)
+        run: uv run mkdocs build --strict
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v4
+        continue-on-error: true
+        with:
+          files: ./coverage.xml

euroflood-0.1.0/.github/workflows/docs.yml

@@ -0,0 +1,36 @@
+name: docs
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+concurrency:
+  group: docs-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  deploy:
+    # Docs are hosted from the public mirror (cisgroup.github.io/euroflood). On the
+    # private dev repo this job is skipped, so it never deploys a private-repo Pages site.
+    if: github.repository == 'cisgroup/euroflood'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+          python-version: "3.13"
+
+      - name: Install dependencies
+        # Match ci.yml: the viz extra is needed so mkdocstrings can import
+        # euroflood.viz and render the visualization reference.
+        run: uv sync --extra viz
+
+      - name: Deploy docs to GitHub Pages
+        run: uv run mkdocs gh-deploy --force

euroflood-0.1.0/.github/workflows/examples.yml

@@ -0,0 +1,32 @@
+name: Examples (live)
+
+# Nightly execution of ALL tutorials against the LIVE published index (network) — including
+# the download/hazard notebooks (04, 05) that the offline PR smoke in ci.yml can't cover.
+# Also runnable on demand. Mirrors the opt-in philosophy of the `online` test suite.
+
+on:
+  schedule:
+    - cron: "17 5 * * *" # daily 05:17 UTC
+  workflow_dispatch:
+
+concurrency:
+  group: examples-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  tutorials:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+          python-version: "3.13"
+
+      - name: Install dependencies
+        run: uv sync --extra viz
+
+      - name: Run all tutorials against the live index
+        run: uv run pytest --nbmake -n=auto --nbmake-timeout=600 examples/

euroflood-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,71 @@
+name: Release
+
+# Publish to PyPI when a version tag is pushed (e.g. `git tag v1.0.0 && git push --tags`).
+# Uses PyPI Trusted Publishing (OIDC) — no API token stored. One-time setup: add a
+# trusted publisher on PyPI for repo cisgroup/euroflood, workflow `release.yml`,
+# environment `pypi`.
+
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+          python-version: "3.13"
+
+      - name: Install dependencies
+        # Match ci.yml (--extra viz): the gate runs the full pytest suite + mkdocs, both of
+        # which need the viz deps (matplotlib/folium) — without them a viz test errors and
+        # the gate (hence the whole release) fails.
+        run: uv sync --extra viz
+
+      - name: Verify tag matches package version
+        run: |
+          pkg=$(uv run python -c "import tomllib, pathlib; print(tomllib.loads(pathlib.Path('pyproject.toml').read_text())['project']['version'])")
+          if [ "v$pkg" != "$GITHUB_REF_NAME" ]; then
+            echo "::error::Tag $GITHUB_REF_NAME does not match pyproject version v$pkg"
+            exit 1
+          fi
+
+      - name: Gate (lint, types, deps, tests, docs)
+        run: |
+          uv run ruff format --check .
+          uv run ruff check .
+          uv run mypy src
+          uv run deptry .
+          uv run pytest -q
+          uv run mkdocs build --strict
+
+      - name: Build sdist + wheel
+        run: uv build
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  pypi:
+    needs: build
+    # Only the public mirror publishes to PyPI (where the trusted publisher is registered).
+    # The private dev repo never tags for release, but guard it belt-and-suspenders.
+    if: github.repository == 'cisgroup/euroflood'
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write # OIDC — required for trusted publishing
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

euroflood-0.1.0/.gitignore

@@ -0,0 +1,223 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+#poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+#pdm.lock
+#pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+#pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# Abstra
+# Abstra is an AI-powered process automation framework.
+# Ignore directories containing user credentials, local state, and settings.
+# Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore
+#  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#  and can be added to the global gitignore or merged into this file. However, if you prefer,
+#  you could uncomment the following to ignore the entire vscode folder
+# .vscode/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Cursor
+#  Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
+#  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
+#  refer to https://docs.cursor.com/context/ignore-files
+.cursorignore
+.cursorindexingignore
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+# macOS
+.DS_Store
+**/.DS_Store
+
+# SLURM job logs (HPC run outputs — not source)
+logs/
+
+# Demo script outputs
+demo_out/
+
+# Default download/output directory (settings.output_dir)
+outputs/
+
+# Runtime geocode cache written into the test fixture during offline runs
+tests/fixtures/realdata/index/geocode/

euroflood-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,36 @@
+# Local developer convenience. CI is the enforcement boundary, so a contributor
+# who skips these hooks still cannot merge a violation. mypy is intentionally
+# left to CI only (too slow for the local commit loop).
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.20
+    hooks:
+      - id: ruff-check
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+        # mkdocs.yml uses mkdocs-material's `!!python/name:` tags, which the
+        # safe-loading check-yaml hook can't construct; `mkdocs build --strict`
+        # (CI) validates it instead.
+        exclude: ^mkdocs\.yml$
+      - id: check-toml
+      - id: check-added-large-files
+        # Tutorial notebooks embed interactive folium maps + plot outputs; the
+        # visualize tutorial's recurrence map over the bbox ROI runs ~1.2 MB, so
+        # keep a 1.5 MB guard against genuinely large files.
+        args: ["--maxkb=1536"]
+
+  # Keep each tutorial's .py:percent and .ipynb in sync (runs after ruff so any
+  # --fix on the .py propagates into the paired notebook).
+  - repo: https://github.com/mwouts/jupytext
+    rev: v1.19.4
+    hooks:
+      - id: jupytext
+        args: [--sync]
+        files: ^examples/.*\.(py|ipynb)$

euroflood-0.1.0/.python-version

@@ -0,0 +1 @@
+3.13

euroflood-0.1.0/CHANGELOG.md

@@ -0,0 +1,113 @@
+# Changelog
+
+All notable changes to EuroFlood are documented here. The format follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and the project aims to
+follow [Semantic Versioning](https://semver.org/) once it reaches a public release.
+
+## [Unreleased]
+
+### Added
+- **ROI `shape` option**: `floods()`/`hazard()` (and the `floods`/`download`/`hazard` CLI commands via
+  `--shape`) take `shape="exact"` (default, the raw admin boundary), `"bbox"` (its bounding rectangle),
+  or `"hull"` (its convex hull). Administrative boundaries are legal, not hydrological, shapes — they
+  often run down a river (excluding it), are oddly shaped, or split into exclaves; a bbox/hull ROI
+  sidesteps that (and collapses a MultiPolygon into one clean shape). Applies to every region input,
+  turns `point`+`radius_m` into a bounding square, and composes with `buffer_m` (which then grows the
+  chosen shape). Default `"exact"` keeps existing behaviour unchanged.
+- **Tutorials** (`examples/`): a top-level folder of runnable, progressive Jupyter tutorials
+  (Quickstart → Discover & filter → Visualize → Download & measure → Hazard → Quantitative
+  analysis → CLI & configuration), jupytext-paired (`.py` + `.ipynb`), rendered on the docs
+  site (mkdocs-jupyter) and executed as tests — the cheap-path ones offline against a committed
+  fixture on every PR, all of them live nightly. Supersedes the old root `demo.py`/`demo.ipynb`.
+- **Notebook/TTY progress bars**: `.download()` shows a transfer bar and the first-query index
+  mirror shows activity when running interactively (a Jupyter notebook or a TTY). Toggle with
+  `settings.show_progress` / `EUROFLOOD_SHOW_PROGRESS`.
+- **Persistent geocode cache**: resolved place-name geometries are cached on disk
+  (`cache_dir/geocode/`), so a repeat `floods("Cologne")` skips the Nominatim round-trip. Toggle
+  with `settings.geocode_cache` / `EUROFLOOD_GEOCODE_CACHE`.
+- **Quiet by default**: `import euroflood` no longer leaks structlog / pooch INFO lines to
+  stdout — the library is silent unless you call `ef.setup_logging(...)`.
+- **Faster repeat queries**: the index COG is opened once per process and reused (with GDAL's
+  in-process block cache), so a repeat `floods()` — and the `.plot()` / `.explore()` /
+  `.footprints()` recurrence views, which also read the index — are near-instant (~0.03–0.07s)
+  instead of re-opening the remote COG every call.
+- **Publishing** (`euroflood publish`): one-command upload of the built index bundle to
+  **Source Cooperative** (the live `/vsicurl` host, via the optional `euroflood[publish]`
+  extra) and/or **Zenodo** (citable DOI). The manifest is stamped with the version + public
+  URLs, and the hosted index is self-verified after upload. A reusable `verify_published()`
+  helper, a `euroflood verify-remote` CLI, and an opt-in `online` test suite check the live
+  index end-to-end (manifest, `/vsicurl` COG, a real query) without touching offline CI.
+- **Zero-config remote index**: `DEFAULT_INDEX_BASE_URL` is baked to the published Source
+  Cooperative prefix, so a plain `pip install euroflood` reads the index with no setup.
+- `euroflood.__version__` and `euroflood --version`.
+- `RELEASING.md`: the two-track (library → PyPI, index → Source Cooperative / Zenodo)
+  release procedure; `release.yml` now fails a release when the git tag ≠ the package version.
+- **Visualization** (optional `euroflood[viz]` extra): a flood-recurrence heatmap
+  as the default `FloodFrame.plot()` / `.explore()`; per-event flood extents via
+  `.footprints()` (a GeoDataFrame with `extent_km2`); an opt-in downloaded
+  depth-map view (`depth=True`, `plot_depth`, `open_depth`, `DepthRaster`); and
+  interactive folium maps with hover tooltips. Static via matplotlib, interactive
+  via folium.
+- **CLI feedback layer**: a unified `rich` console for result tables, status, and
+  progress; global options `-v/--verbose`, `-q/--quiet`, `--json`, `--no-color`;
+  clean one-line error messages with per-error-type exit codes (no tracebacks);
+  a notebook-friendly `FloodFrame` summary repr.
+- **Documentation**: a Concepts page explaining the index data model; a real
+  consumer Getting Started walkthrough; full API reference coverage for the
+  consumer API (`floods`, `hazard`, `download`, `FloodFrame`, configuration);
+  `CONTRIBUTING.md`, `CITATION.cff`, and this changelog.
+
+### Changed
+- **Leaner `viz` extra.** Removed the unused `mapclassify` dependency from the optional
+  `euroflood[viz]` extra, which drops its heavy transitive tail (scikit-learn, scipy, networkx)
+  from the install — six fewer packages. `mapclassify` only serves geopandas' choropleth
+  *classification* schemes, which EuroFlood never uses (it draws folium via direct `GeoJson`/
+  `ImageOverlay`), so `.plot()` / `.explore()` are unchanged.
+- **Documentation overhaul.** A cohesive azure "water" theme (custom palette + `extra.css`, logo +
+  favicon, light/dark toggle); a real landing page (hero flood map, feature cards, CTAs, badges) that
+  replaces the wall of text; **real Zutphen figures** with a grayscale basemap ("flooding in front of a
+  map") generated by `scripts/make_doc_images.py`, replacing the placeholder images; a **lean 5-section
+  IA** (Home · Get started · Tutorials · Concepts · API reference) that folds the redundant
+  Visualization/Cookbook/Output pages into the tutorials/reference and moves the internal Vision &
+  Related-datasets notes off the site; a tutorials **gallery** with thumbnails; and the section renamed
+  "Reference" → "API reference". Fixes the raw-`.py` tutorial links (the `docs/tutorials → examples`
+  symlink no longer leaks `.py`/run artifacts, via `exclude_docs`) and the inconsistent notebook H1s.
+  Docstring cross-references were converted from raw reStructuredText roles (`:func:`/`:class:`, which
+  rendered literally under the Google docstring style) to plain code spans, so the API reference reads
+  cleanly.
+- **`plot(basemap=True)` fix.** The contextily basemap was drawn *over* the flood raster (muting the
+  overlay); it now draws behind it (`zorder=-1`), so the flood reads clearly against the map.
+- **Tutorials & docs now headline Zutphen** (on the IJssel, NL) instead of Cologne/Valencia —
+  its recurrent river flooding makes a richer example and motivates `shape="bbox"` (its gemeente
+  boundary follows the river). The offline test fixture was regenerated for Zutphen (with an
+  appended OSM municipality boundary so the offline geocoder resolves it), tutorial 02 gained an
+  executed `shape="bbox"` beat, and a latent `point=(lat, lon)` argument-order slip in the region
+  examples was fixed.
+- **Parallel downloads**: `.download()` now fetches source rasters concurrently
+  (up to `settings.max_workers_dl`, default 8) instead of one at a time — a roughly
+  N× faster wall-clock for multi-event historic catalogues and multi-tile hazard
+  layers. Output files, paths, and cache-hit skipping are unchanged; a per-file
+  step bar replaces the byte bar for the library (notebook/TTY) path, while the CLI
+  keeps its byte bar via `on_bytes`.
+- **Fewer per-call rebuilds**: the DuckDB connection (dictionary + events lookups)
+  and the ~14 MB NUTS boundary dataset (offline `local` geocoder) are now cached
+  per process instead of being reopened/reloaded on every query — the same
+  "reuse, don't re-init" fix already applied to the index COG. Repeat queries and
+  `local`-backend batches are correspondingly faster.
+- **Faster hazard stats and streaming reads**: `hazard(...).stats()` / `.summary()`
+  read each depth raster once (was twice, to inspect the CRS first), and streaming
+  `/vsicurl` hazard reads now run under the same GDAL env as the index COG.
+- `import euroflood` no longer eagerly imports the producer pipelines
+  (`ExportPipeline`, `IngestionPipeline`) or their scraper/BeautifulSoup stack —
+  they resolve lazily on first use, so the consumer import is lighter.
+- `Settings` fields are now self-documenting via `Field(description=...)` — visible
+  in `help()`, IDE tooltips, and the Configuration reference.
+- Replaced `tqdm` with `rich` for progress; `structlog` still owns machine/JSON
+  logs on stderr (HPC-friendly), while user-facing output goes to stdout.
+
+### Removed
+- Stale `readme.org` (superseded by `README.md`).
+
+### Fixed
+- Corrected stale docstrings (geocoder default backend, the `extract` CLI verb,
+  the legacy `ExtractionPipeline` dictionary format).

euroflood-0.1.0/CITATION.cff

@@ -0,0 +1,41 @@
+cff-version: 1.2.0
+message: "If you use EuroFlood, please cite this software and the underlying dataset."
+title: "EuroFlood: query Europe's satellite flood-depth maps by place and time"
+abstract: >-
+  A lightweight, cloud-native Python tool that turns the JRC / Copernicus
+  CEMS-EFAS Satellite-Derived Flood Depth Maps for Europe into a queryable index:
+  discover which flood events touched a region (and when) and download only the
+  depth rasters you need.
+type: software
+version: "0.1.0"
+date-released: "2026-07-08"
+authors:
+  - family-names: Hackl
+    given-names: Jürgen
+    orcid: "https://orcid.org/0000-0002-8849-5751"
+    affiliation: "Princeton University, Complex Infrastructure Systems Group"
+license: MIT
+repository-code: "https://github.com/cisgroup/euroflood"
+url: "https://cisgroup.github.io/euroflood/"
+keywords:
+  - flood
+  - flood depth
+  - CEMS-EFAS
+  - GLOFAS
+  - Copernicus
+  - Sentinel-1
+  - geospatial
+  - remote sensing
+references:
+  - type: data
+    title: "Satellite-Derived Flood Depth Maps for Europe"
+    authors:
+      - family-names: Betterle
+        given-names: Andrea
+      - family-names: Salamon
+        given-names: Peter
+    year: 2025
+    publisher:
+      name: "European Commission, Joint Research Centre (JRC) / Copernicus EMS"
+    url: "https://data.jrc.ec.europa.eu/dataset/0bc96690-b89c-4909-9166-c2c322a20130"
+    notes: "Licensed CC-BY-4.0."