← Layers catalog
FLW · Hydrology

Flow Accumulation

pysheds fill → flow direction → accumulation on the Copernicus DEM; channels at an accumulation threshold, Euclidean distance + TWI derived per cell · v0.1 · 2026-07

The drainage structure of the land surface, derived entirely from the Copernicus DEM so Petrel owns the result outright. Distance-to-drainage and TWI feed the landslide, soil-erosion, flood, and lahar chains. v0.1 is structurally validated (qualitative) — the quantitative HydroRIVERS benchmark lands with v1.

Flow Accumulation preview
Distance to nearest drainage channel — DEM-derived, global 278 m

What ships in the bundle

2 global ~278 m (9 arcsec) GeoTIFFs (~7.5 GB total) plus the full documentation set. All files are Cloud-Optimized GeoTIFFs with internal tiling and overviews — fast for both bulk download and windowed reads.

FileDtypeUnitsDescription
flow_distance_to_drainage_278m_90m.tifuint16 (SCALE)m (0–50 000)Euclidean distance to the nearest drainage channel
flow_twi_278m_90m.tifuint16 (SCALE)ln(a/tanβ)Topographic wetness index

Note: filenames carry a legacy _90m suffix; the native grid resolution for this Layer is ~278 m (9 arcsec).

Method

Inputs · Copernicus GLO-30 DEM — a single permissive input (clean-room HydroSHEDS/HydroRIVERS replacement, no copyleft flow-down)

Training labels ·

Method · pysheds fill → flow direction → accumulation on the Copernicus DEM; channels at an accumulation threshold, Euclidean distance + TWI derived per cell

Documentation

Download

Free for non-commercial use. Account required.

# $PETREL_API_KEY = your API key (tlk.…) from the dashboard — free tier works.

# 1. Fetch 1-hour signed URLs for every file in the bundle:
curl -s -H "X-API-Key: $PETREL_API_KEY" \
  https://api.petreldata.io/v1/layer/flow_accumulation/v0.1/bundle > bundle.json

# 2. Download the full layer (~7.5 GB):
mkdir -p flow_accumulation_v0.1
jq -r '.files[] | [.url, .name] | @tsv' bundle.json | \
  while IFS=$'\t' read -r url name; do
    curl -s "$url" -o "flow_accumulation_v0.1/$name"
  done
Sign up freeRead API docs

License & citation

License: CC-BY-NC-4.0. Free for academic, research, and other non-commercial use. For commercial licensing, contact licensing@petreldata.io.

Citation:

Petrel (2026). Petrel Flow Accumulation v0.1.
https://petreldata.io/layers/flow_accumulation
CC-BY-NC-4.0

Download Flow Accumulation with a free key.

See pricing →