HydroBASINS / BasinATLAS#

hydrobasins · theme hydro · live

Global nested sub-basin polygons (Pfafstetter levels 1-12). BasinATLAS adds several hundred hydro-environmental attributes per basin.

import easysnowdata as esd

aoi = (-121.94, 46.72, -121.54, 46.99)   # Mount Rainier
data = esd.hydro.basins.hydrobasins(aoi, level=8)

No account needed for the default route

source="figshare-basinatlas" is open. source="gee" needs earthengine — see the credentials page.

Sources#

3 routes serve this product; the first is the default and source= picks another. The return contract is the same either way.

source

provider

credentials

resolution

extent

temporal

latency

notes

figshare-basinatlas (default)

vector_http

none

—

global

static (v1.0, 2019)

—

2.7 GB file geodatabase read with mask pushdown, so only the intersecting basins are fetched; carries the BasinATLAS attributes

hydrosheds

vector_http

none

—

per region (9 regions)

static (v1c)

—

~50-300 MB per region instead of 2.7 GB, cached on first use; geometry and the basic Pfafstetter fields, no BasinATLAS attributes

gee

gee

earthengine

—

global

static (v1.0)

—

server-side query, no download

Where each route points#

figshare-basinatlas — figshare BasinATLAS gdb live

https://ndownloader.figshare.com/files/20082137/BasinATLAS_Data_v10.gdb.zip

hydrosheds — HydroSHEDS regional zips live

https://data.hydrosheds.org/file/HydroBASINS/standard/hybas_<region>_lev01-12_v1c.zip

gee — Earth Engine live

WWF/HydroATLAS/v1/Basins/level{level}

Provenance#

Licence · CC BY 4.0

DOI · 10.1038/s41597-019-0300-6

Cite the data as

Linke, S., Lehner, B., Ouellet Dallaire, C., et al. (2019). Global hydro-environmental sub-basin and river reach characteristics at high spatial resolution. Scientific Data 6, 283.

Documentation

Loader · easysnowdata.hydro.basins.hydrobasins