North America
Grid 424,800 × 277,200 pixels at 1 arc-second, top-left corner 170°W, 84°N. manifest.json lists every file with its size.
Rasters — native 30 m
The two groupings into basin groups have no 30 m raster in this release; the groups are given by their tables and the simplified outlines below.
| File | What it is | Size |
|---|---|---|
| bsn_north-america_30m.tif | the basin mask at 1 arc-second: every land pixel carries the id of the outlet it drains to (all 30,077,037 outlets, not only the 105,581 basins of at least 1 km²) | 500 MB |
| rgn_north-america_30m_160deg2.tif | the region mask at 1 arc-second, capacity 160 square degrees (106 regions) | 231 MB |
| rgn_north-america_30m_80deg2.tif | the region mask at 1 arc-second, capacity 80 square degrees (201 regions) | 240 MB |
| rgn_north-america_30m_40deg2.tif | the region mask at 1 arc-second, capacity 40 square degrees (404 regions) | 251 MB |
Tables — native 30 m
The basin table: one row per basin of at least 1 km², in id order. The basin group tables and the region tables: one row per group or region, every column of the pipeline's own table, plus label_lon and label_lat, a point inside its largest part where its number goes on a map. The piece tables of the capacity partitions: one row per piece of a cut basin — the region it lies in, its outlet pixel, the inlet pixel of its parent piece (the piece it drains into) that its outlet flows into, downstream_depth (0 for the piece with the basin outlet, one more per piece upstream) and crossing_length_m, the distance in metres from the outlet pixel to the parent's inlet pixel; a piece's region is worked after the regions of the pieces upstream of it.
| File | What it is | Size |
|---|---|---|
| bat_north-america_30m_ge1km2.csv.gz | basin table, 105,581 rows (basins of at least 1 km², one row per basin in id order), gzip CSV: continental_basin_id, global_basin_id (−9999 until a numbering across continents exists), the basin's group in each grouping and its region in each partition, and every column of the 30 m table | 6 MB |
| gat_north-america_30m_l2.csv | basin group table, Level-02 units, 15 rows | 3 kB |
| gat_north-america_30m_l3.csv | basin group table, Level-03 units, 48 rows | 9 kB |
| rat_north-america_30m_160deg2.csv | region table, capacity 160 square degrees, 106 rows | 20 kB |
| rat_north-america_30m_80deg2.csv | region table, capacity 80 square degrees, 201 rows | 38 kB |
| rat_north-america_30m_40deg2.csv | region table, capacity 40 square degrees, 404 rows | 76 kB |
| pat_north-america_30m_160deg2.csv | piece table: the pieces of the cut basins, capacity 160 square degrees, 79 rows | 18 kB |
| pat_north-america_30m_80deg2.csv | piece table: the pieces of the cut basins, capacity 80 square degrees, 204 rows | 46 kB |
| pat_north-america_30m_40deg2.csv | piece table: the pieces of the cut basins, capacity 40 square degrees, 551 rows | 123 kB |
Vectors — simplified
| File | What it is | Size |
|---|---|---|
| bsn_north-america_ge1km2.gpkg | simplified basin polygons: one row per basin of at least 1 km² in id order, the same rows and ids as the basin table; color_id (1–8, no two neighbours alike) colours them without any choosing | 110 MB |
| bnd_north-america_ge1km2.gpkg | their boundaries as lines, simplified, same rows | 109 MB |
| grp_north-america_l2.gpkg | basin group outlines, Level-02 units, simplified, one row per group, with color_id | 14 MB |
| grp_north-america_l3.gpkg | basin group outlines, Level-03 units, simplified, one row per group, with color_id | 16 MB |
| rgn_north-america_160deg2.gpkg | region outlines, capacity 160 square degrees, simplified, one row per region, with color_id | 22 MB |
| rgn_north-america_80deg2.gpkg | region outlines, capacity 80 square degrees, simplified, one row per region, with color_id | 26 MB |
| rgn_north-america_40deg2.gpkg | region outlines, capacity 40 square degrees, simplified, one row per region, with color_id | 31 MB |
| bsn_rgn_north-america.pmtiles | vector tiles of the 27,618 basins of at least 10 km², their boundaries, the two basin-group layers and the three region layers (what the map draws), zoom 2–11 | 130 MB |
South America
Grid 219,600 × 259,200 pixels at 1 arc-second, top-left corner 93°W, 15°N. manifest.json lists every file with its size.
Rasters — native 30 m
The two groupings into basin groups have no 30 m raster in this release; the groups are given by their tables and the simplified outlines below.
| File | What it is | Size |
|---|---|---|
| bsn_south-america_30m.tif | the basin mask at 1 arc-second: every land pixel carries the id of the outlet it drains to (all 7,383,055 outlets, not only the 38,510 basins of at least 1 km²) | 183 MB |
| rgn_south-america_30m_160deg2.tif | the region mask at 1 arc-second, capacity 160 square degrees (59 regions) | 108 MB |
| rgn_south-america_30m_80deg2.tif | the region mask at 1 arc-second, capacity 80 square degrees (99 regions) | 113 MB |
| rgn_south-america_30m_40deg2.tif | the region mask at 1 arc-second, capacity 40 square degrees (213 regions) | 121 MB |
Tables — native 30 m
The basin table: one row per basin of at least 1 km², in id order. The basin group tables and the region tables: one row per group or region, every column of the pipeline's own table, plus label_lon and label_lat, a point inside its largest part where its number goes on a map. The piece tables of the capacity partitions: one row per piece of a cut basin — the region it lies in, its outlet pixel, the inlet pixel of its parent piece (the piece it drains into) that its outlet flows into, downstream_depth (0 for the piece with the basin outlet, one more per piece upstream) and crossing_length_m, the distance in metres from the outlet pixel to the parent's inlet pixel; a piece's region is worked after the regions of the pieces upstream of it.
| File | What it is | Size |
|---|---|---|
| bat_south-america_30m_ge1km2.csv.gz | basin table, 38,510 rows (basins of at least 1 km², one row per basin in id order), gzip CSV: continental_basin_id, global_basin_id (−9999 until a numbering across continents exists), the basin's group in each grouping and its region in each partition, and every column of the 30 m table | 2 MB |
| gat_south-america_30m_l2.csv | basin group table, Level-02 units, 9 rows | 2 kB |
| gat_south-america_30m_l3.csv | basin group table, Level-03 units, 33 rows | 6 kB |
| rat_south-america_30m_160deg2.csv | region table, capacity 160 square degrees, 59 rows | 11 kB |
| rat_south-america_30m_80deg2.csv | region table, capacity 80 square degrees, 99 rows | 19 kB |
| rat_south-america_30m_40deg2.csv | region table, capacity 40 square degrees, 213 rows | 40 kB |
| pat_south-america_30m_160deg2.csv | piece table: the pieces of the cut basins, capacity 160 square degrees, 60 rows | 14 kB |
| pat_south-america_30m_80deg2.csv | piece table: the pieces of the cut basins, capacity 80 square degrees, 191 rows | 42 kB |
| pat_south-america_30m_40deg2.csv | piece table: the pieces of the cut basins, capacity 40 square degrees, 390 rows | 86 kB |
Vectors — simplified
| File | What it is | Size |
|---|---|---|
| bsn_south-america_ge1km2.gpkg | simplified basin polygons: one row per basin of at least 1 km² in id order, the same rows and ids as the basin table; color_id (1–8, no two neighbours alike) colours them without any choosing | 38 MB |
| bnd_south-america_ge1km2.gpkg | their boundaries as lines, simplified, same rows | 38 MB |
| grp_south-america_l2.gpkg | basin group outlines, Level-02 units, simplified, one row per group, with color_id | 5 MB |
| grp_south-america_l3.gpkg | basin group outlines, Level-03 units, simplified, one row per group, with color_id | 6 MB |
| rgn_south-america_160deg2.gpkg | region outlines, capacity 160 square degrees, simplified, one row per region, with color_id | 8 MB |
| rgn_south-america_80deg2.gpkg | region outlines, capacity 80 square degrees, simplified, one row per region, with color_id | 10 MB |
| rgn_south-america_40deg2.gpkg | region outlines, capacity 40 square degrees, simplified, one row per region, with color_id | 14 MB |
| bsn_rgn_south-america.pmtiles | vector tiles of the 11,005 basins of at least 10 km², their boundaries, the two basin-group layers and the three region layers (what the map draws), zoom 2–11 | 39 MB |
Read one window over HTTP
Every file here is served with HTTP range requests, so GDAL, rasterio and DuckDB can read a window straight off the network. The basin mask is a tiled GeoTIFF (512 × 512 blocks, DEFLATE); a point query reads one block.
import rasterio
url = "https://data.fullhydro.org/hydrosheds-v2-30m/v1/north-america/bsn_north-america_30m.tif"
with rasterio.open(url) as src:
basin = next(src.sample([(-90.0, 35.0)]))[0] # the outlet id of the pixel at 90°W, 35°N
# basin k is row k of the basin table (continental_basin_id = row + 1), for basins of at least 1 km²import pandas as pd
bat = pd.read_csv("https://data.fullhydro.org/hydrosheds-v2-30m/v1/north-america/bat_north-america_30m_ge1km2.csv.gz")
row = bat.loc[basin - 1] if basin <= len(bat) else None # None: a basin below 1 km², not in the tableOriginal source data
HydroSHEDS v2 flow directions at 1 arc-second, from hydrosheds.org, licence CC BY 4.0. They are not redistributed here; the basin and region masks are computed from them.
