Published May 30, 2024 | Version 0.6
Dataset Open

Global River Topology (GRIT)

  • 1. University of Oxford
  • 2. University of Bristol

Contributors

Research group:

Description

The Global River Topology (GRIT) is a vector-based, global river network that not only represents the tributary components of the global drainage network but also the distributary ones, including multi-thread rivers, canals and delta distributaries. It is also the first global hydrography (excl. Antarctica and Greenland) produced at 30m raster resolution. It is created by merging Landsat-based river mask (GRWL) with elevation-generated streams to ensure a homogeneous drainage density outside of the river mask (rivers narrower than approx. 30m). Crucially, it uses a new 30m digital terrain model (FABDEM, based on TanDEM-X) that shows greater accuracy over the traditionally used SRTM derivatives. After vectorisation and pruning, directionality is assigned by a combination of elevation, flow angle, heuristic and continuity approaches (based on RivGraph). The network topology (lines and nodes, upstream/downstream IDs) is available as layers and attribute information in the GeoPackage files (readable by QGIS/ArcMap/GDAL).

A map of GRIT segments labelled with OSM river names is available here: https://michelwortmann.com/research/gritv05-segments-river-names/

Regions

Vector files are provided in 7 regions with the following codes:

  • AF - Africa
  • AS - Asia (excl. Siberia)
  • EU - Europe
  • NA - North America
  • SA - South America
  • SI - Siberia
  • SP - South Pacific/Australia

The domain polygons (GRITv06_domain_GLOBAL.gpkg.zip) provide 60 subcontinental catchment groups that are available as vector attributes. They allow for more fine-grained subsetting of data (e.g. with ogr2ogr --where and the domain attribute).

Vector files are provided both in the original equal-area Equal Earth Greenwich projection (EPSG:8857) as well as in geographic WGS84 coordinates (EPSG:4326).

Change log

  • v0.6 - 2024-05-30
    • Rivers/streams outside of the GRWL mask forced by all OSM water lines (not only those with waterway=river/canal)
    • Some manual directions in the Irrawaddy delta and fixed erronous sink in the Volga delta
  • v0.5 - 2024-02-14
    • Cyclicity and discontinuities resolved through improved algorithms, bug fixes, more sophisticated cycle solving algorithms and some manually forced directions. Only insignificant cycles (non-sinks, less than 50) were removed.
    • Added segment and reach attributes
    • Computational domain fixes
    • Segments include OSM river names
    • Asia domain split into Siberia and rest of Asia
    • Vector files available in EPSG:8857 and EPSG:4326
  • v0.4 - 2023-03-11
    • First globally complete dataset published

Network segments

Lines between inlet, outlet, confluence and bifurcation nodes. Files have lines and nodes layers.

Attribute description of lines layer

Name Data type Description
cat integer domain internal feature ID
global_id integer global river segment ID, same as FID
catchment_id integer global catchment ID
upstream_node_id integer global segment node ID at upstream end of line
downstream_node_id integer global segment node ID at downstream end of line
upstream_line_ids text comma-separated list of global river segment IDs connecting at upstream end of line
downstream_line_ids text comma-separated list of global river segment IDs connecting at downstream end of line
direction_algorithm float code of RivGraph method used to set the direction of line
width_adjusted float median river width in m without accounting for width of segments connecting upstream/downstream
length_adjusted float segment length in m without accounting for width of segments connecting upstream/downstream in m
is_mainstem integer 1 if widest segment of bifurcated flow or no bifurcation upstream, otherwise 0
strahler_order integer Strahler order of segment, can be used to route in topological order
length float segment length in m
azimuth float direction of line connecting upstream-downstream nodes in degrees from North
sinuousity float ratio of Euclidean distance between upstream-downstream nodes and line length, i.e. 1 meaning a perfectly straight line
drainage_area_in float drainage area at beginning of segment, partitioned by width at bifurcations, in km2
drainage_area_out float drainage area at end of segment, partitioned by width at bifurcations, in km2
drainage_area_mainstem_in float drainage area at beginning of segment, following the mainstem, in km2
drainage_area_mainstem_out float drainage area at end of segment, following the mainstem, in km2
bifurcation_balance_out float (drainage_area_out - drainage_area_mainstem_out) / max(drainage_area_out, drainage_area_mainstem_out), dimensionless ratio
grwl_overlap float fraction of the segment overlapping with the GRWL river mask
grwl_value integer dominant GRWL value of segment
name text river name from Openstreetmap where available, English preferred
name_local text river name from Openstreetmap where available, local name
n_bifurcations_upstream integer number of bifurcations upstream of segment
domain text catchment group ID, see domain index file

 

Attribute description of nodes layer

Name Data type Description
cat integer domain internal feature ID
global_id integer global river node ID, same as FID
catchment_id integer global catchment ID
upstream_line_ids text comma-separated list of global river segment IDs flowing into node
downstream_line_ids text comma-separated list of global river segment IDs flowing out of node
node_type text description of node, one of bifurcation, confluence, inlet, coastal_outlet, sink_outlet, grwl_change
grwl_value integer GRWL code at node
grwl_transition text GRWL codes of change at grwl_change nodes
cycle integer >0 if segment is part of an unresolved cycle, 0 otherwise
continuity_violated integer 1 if flow continuity is violated, otherwise 0
drainage_area float drainage area, partitioned by width at bifurcations, in km2
drainage_area_mainstem float drainage area, following the mainstem, in km2
n_bifurcations_upstream integer number of bifurcations upstream of node
domain text catchment group, see domain index file

 

Network reaches

Segment lines split to not exceed 1km in length, i.e. these lines will be shorter than 1km and longer than 500m unless the segment is shorter. A simplified version with no vertices between nodes is also provided. Files have lines and nodes layers.

Attribute description of lines layer

Name Data type Description
cat integer domain internal feature ID
segment_id integer global segment ID of reach
global_id integer global river reach ID, same as FID
catchment_id integer global catchment ID
upstream_node_id integer global reach node ID at upstream end of line
downstream_node_id integer global reach node ID at downstream end of line
upstream_line_ids text comma-separated list of global river reach IDs connecting at upstream end of line
downstream_line_ids text comma-separated list of global river reach IDs connecting at downstream end of line
grwl_overlap float fraction of the reach overlapping with the GRWL river mask
grwl_value integer dominant GRWL value of node
grwl_width_median float median width of the GRWL river mask, meters
grwl_width_std float standard deviation of width of the GRWL river mask, meters
length float length of reach in meters
sinuousity float ratio of eucledian distance betwen upstream-downstream nodes and line length, i.e. 1 meaning a perfectly straight line
azimuth float direction of line connecting upstream-downstream nodes in degrees from North
domain text catchment group, see domain index file

Attribute description of nodes layer

Name Data type Description
cat integer domain internal feature ID
segment_node_id integer global ID of segment node at segment intersections, otherwise blank
n_segments integer number of segments attached to node
global_id integer global river reach node ID, same as FID
upstream_line_ids text comma-separated list of global river reach IDs flowing into node
downstream_line_ids text comma-separated list of global river reach IDs flowing out of node
domain text catchment group, see domain index file

 

Catchments

Catchment outlines for entire river basins (network components, including coastal drainage areas). Catchments for segments (aka. subbasins) and reaches are also available on request.

Attribute description

Name Data type Description
cat integer domain internal feature ID
global_id integer global catchment ID, same as global_id of segment/reach ID if is_coastal == 0 for respective catchments or the catchment_id for component_catchments, same as FID
area float catchment area in km2
is_coastal integer 1 for coastal drainage areas, 0 otherwise
domain text catchment group, see domain index file

 

Raster

Upstream drainage area and other raster-based products are also available upon request.

Files

GRITv06_domain_GLOBAL_EPSG8857.gpkg.zip

Files (27.6 GB)

Name Size Download all
md5:2d180b676910c49d871699769cb5d75e
426.7 MB Preview Download
md5:d65a1b850e206a85e0dc23a65b06fb59
162.7 MB Preview Download
md5:7595543df14f1b0d5f9791253d9bc30d
592.8 MB Preview Download
md5:d563ff495938f34658306b47d13c7b3d
249.1 MB Preview Download
md5:948a882c97e5405c1d0ab4ecd229b4e0
414.6 MB Preview Download
md5:8a4309cc96cf53998377defd08639b90
177.6 MB Preview Download
md5:0d430eb023e65d82b0b3a264e5207d18
649.1 MB Preview Download
md5:ea8c2f1e2e9f458e163fd28d0e0e9302
288.3 MB Preview Download
md5:594e1d7fbb9b0e7576b917cd8962e377
256.5 MB Preview Download
md5:1bab1ce32b1c28dfbd28c8357231758a
105.5 MB Preview Download
md5:3781d49dc4664c3b00aa79c6c716fcf9
165.3 MB Preview Download
md5:bac202983a2cabf69b45bb490ce05627
76.4 MB Preview Download
md5:b4855c74db69ce212106aa24336875fa
411.1 MB Preview Download
md5:62accde0e904ed65e50447f5b10f70d5
173.6 MB Preview Download
md5:cca629abf18b2b6899e813204dcbc42a
17.9 MB Preview Download
md5:7b833b69d04cb9dc29478585305122f6
19.0 MB Preview Download
md5:17f95e0721b3cb1dbdc9e30920ef807c
1.6 GB Preview Download
md5:513d0233547080b897911d6b1fba46b9
1.6 GB Preview Download
md5:fcc8da5875d101eaeea64fc6d9b3aa55
1.4 GB Preview Download
md5:edf1e6a02acc86bc824733b9e27d1ae5
1.4 GB Preview Download
md5:0b14b11c4bb95bcc379afcc8de2cc30f
682.8 MB Preview Download
md5:55a24e854103e1e98b1869935786e766
674.7 MB Preview Download
md5:61825026f2e1c062859590ce7e1cd465
1.2 GB Preview Download
md5:dd22b83a0e87246b1070b783643b1297
1.1 GB Preview Download
md5:e03a168c3adad6d3c8eb6081c2a9c47f
975.1 MB Preview Download
md5:479926566d31d833b84f79fef28959eb
963.0 MB Preview Download
md5:177153314fd012512bad5fd48ff891e3
762.9 MB Preview Download
md5:f54681a68837e545651e50cf5d972059
752.6 MB Preview Download
md5:bcf2ff56b59322b78ddc251bd44e819a
523.0 MB Preview Download
md5:bc88cb330074403f7080d8d53e6cbe4b
497.4 MB Preview Download
md5:64c78696ebf279a411056f7d4c5eaca5
472.0 MB Preview Download
md5:cfe719eb993643e98715a3a96caf1766
450.3 MB Preview Download
md5:dc6d0b70dbea9dd40d6edf324759b495
217.0 MB Preview Download
md5:8da16d17b7aa06bb528f80be3b93d997
207.1 MB Preview Download
md5:fac158c74e671b4eed099fe93aaca0d6
374.6 MB Preview Download
md5:2927be7e8bb155b34ad64643a9e03847
358.5 MB Preview Download
md5:c7bef37b414fdfadd3826578e36152d3
312.7 MB Preview Download
md5:948471bae063ae874a5f504b2a64f566
297.6 MB Preview Download
md5:906a4247b73adf29cf115771f2233f5a
247.5 MB Preview Download
md5:8a5346c07056bfadd8cd337820223734
235.9 MB Preview Download
md5:a10dff4305213e7328f54d931d296779
187.9 MB Preview Download
md5:d59879afd62b163df300f7e2f16d3d2b
180.5 MB Preview Download
md5:883666771da4e058586339788e0e2a18
570.9 MB Preview Download
md5:2408cbe88c5f84763c354ba469e550e3
566.5 MB Preview Download
md5:c181e07dc70d2d1c224ed14b3eccb2bd
610.0 MB Preview Download
md5:6a3b55fbdd13ea85d1d539c37cea4ff9
270.2 MB Preview Download
md5:35b86634dbbc6277dfb20803962ce43f
569.0 MB Preview Download
md5:fb906aa51c2233b36272c8734235b763
271.5 MB Preview Download
md5:bc1902743acb209a5a693109ec37183f
258.2 MB Preview Download
md5:7af602be0d4d46a6a6ad8b771f5d4e55
124.4 MB Preview Download
md5:1e3cf345dcb4f95fdce109f0871657d0
456.7 MB Preview Download
md5:82c32b99988ce20f1e45e3886f88b93b
231.7 MB Preview Download
md5:77bb553248c7d5588b659714438d612d
383.1 MB Preview Download
md5:9e5e04b790ddc9084e215b83bbbfb130
180.5 MB Preview Download
md5:c34d5a61b6706926884904cc8d6ea44a
298.0 MB Preview Download
md5:f724492e04a76ce2ccbaae25ba27553f
161.4 MB Preview Download
md5:a3b8f64a80beb7c60a8acdf7f9f4af27
11.9 MB Preview Download
md5:955931fabcf2fe3efd445ee4b6c2128c
10.0 MB Preview Download
md5:9aad8298911b6270bdb80d411298fc02
21.7 MB Preview Download
md5:49b9e9a52ab5de9b408ea57b98efcb55
18.5 MB Preview Download
md5:b174441c8e1541e210e2cedbe0065d92
8.7 MB Preview Download
md5:31ecf23a5938cfbc0cce239e5f341f90
7.3 MB Preview Download
md5:1a980e5294206904be572aad25f083a0
110.7 MB Preview Download
md5:491544731aee23b30b3319daff6cc411
94.5 MB Preview Download
md5:92027dfdf61105cd3625d0f26e0242fc
20.7 MB Preview Download
md5:9b8c04b69dbd81fe7f24f211e4fba589
18.0 MB Preview Download
md5:998cc4ea6318b3937d5323fc45d04ab9
18.8 MB Preview Download
md5:b43a92f91f5ddc8ad3e6114558e319c4
15.6 MB Preview Download
md5:4130f8f29a316a687246d46dab14c19b
23.6 MB Preview Download
md5:03961faf7b4cf7bf4967a2743d94a4d7
20.7 MB Preview Download
md5:519437ee5729c9d9402ee4d148e1d8f5
5.9 MB Preview Download
md5:cac95eee786b0e7fda3e95e0d51063b2
4.8 MB Preview Download
md5:87a9d58d033f5a395bb3f61323653bb7
224.6 MB Preview Download
md5:013f2d5d43c36417346185ada2f76f36
106.6 MB Preview Download
md5:12c2bc99c1478fa3c5470ccd30f52e72
55.1 MB Preview Download
md5:d3de5e7c863dd8288e691508d0cc62d6
19.1 MB Preview Download
md5:59d7685d6efad25746c5a2952326ff3e
14.8 kB Preview Download
md5:d498ece23616789392cebe53cf7101a3
12.9 kB Download

Additional details

Funding

THE EVOLUTION OF GLOBAL FLOOD HAZARD AND RISK [EVOFLOOD] NE/S015728/1
UK Research and Innovation

Dates

Updated
2024-05-30
v0.6