GRIT-ADB: A Global Attribute Database for the GRIT Hydrography

Zhang, Boen; Wortmann, Michel; Liu, Yinxue; Kratzert, Frederik; Moulds, Simon; Slater, Louise

doi:10.5194/essd-2026-279

Preprints

https://doi.org/10.5194/essd-2026-279

Preprints

26 Jun 2026

| 26 Jun 2026

Status: this preprint is currently under review for the journal ESSD.

GRIT-ADB: A Global Attribute Database for the GRIT Hydrography

Boen Zhang, Michel Wortmann, Yinxue Liu, Frederik Kratzert, Simon Moulds, and Louise Slater

Abstract. Global hydro-environmental databases provide essential information for large-scale hydrological, ecological, geomorphological, and Earth system analyses. Most existing global databases are built upon convergent river representations that do not explicitly capture bifurcating, multi-channel river systems. In addition, these databases primarily characterise long-term climatological means or static representations of environmental conditions derived from earlier-generation global datasets, limiting their applicability for time-varying analyses of hydroclimatic and geomorphological processes. Here we present GRIT-ADB, a new attribute database for the vectorised Global River Topology (GRIT), a new river hydrography dataset created from a 30 m resolution river mask and terrain data that provides a topology-explicit and physically realistic representation of river networks including divergent flow pathways. GRIT-ADB provides standardised hydro-environmental information for 19.6 million km of rivers and streams. It currently comprises 64 time-varying (multi-dimensional embeddings) and 35 static variables (>300 attributes), spanning five categories: hydrology, physiography, climate, land cover and use, and soils and geology. Attributes are derived by aggregating and harmonising data from state-of-the-art global datasets and are accumulated along the river network from headwaters to basin outlets, while preserving the topology of divergent and complex flow pathways. The attributes are linked to multiple GRIT scales, including hierarchically-nested subbasins, individual river reaches of up to 1 km long, and coarser-scale river segments of several kilometres long, providing a flexible framework that can accommodate future extensions of GRIT and additional attributes. By combining a standardised attribute framework with explicit representation of bifurcating river hydrography, GRIT-ADB enables improved large-scale yet high-resolution analyses of river connectivity, hydrological extremes, hydro-ecological processes, and climate impacts in complex river systems, supporting a wide range of global hydrological and environmental applications.

Received: 13 Apr 2026 – Discussion started: 26 Jun 2026

Publisher's note: Copernicus Publications remains neutral with regard to jurisdictional claims made in the text, published maps, institutional affiliations, or any other geographical representation in this paper. While Copernicus Publications makes every effort to include appropriate place names, the final responsibility lies with the authors. Views expressed in the text are those of the authors and do not necessarily reflect the views of the publisher.

Download & links

Preprint (PDF, 15937 KB)

Supplement (3183 KB)

Download & links

Preprint (15937 KB)
Metadata XML
Supplement (3183 KB)
BibTeX
EndNote

Boen Zhang, Michel Wortmann, Yinxue Liu, Frederik Kratzert, Simon Moulds, and Louise Slater

Status: open (until 31 Aug 2026)

Post a comment Subscribe to comment alert

RC1:
'Comment on essd-2026-279', Anonymous Referee #1, 13 Jul 2026 reply
Zhang and colleagues provide an extremely exciting and useful new dataset for the large-sample hydrology community. Overall the paper is well-written, structured and following a nice flow, which is greatly appreciated from a reviewer’s perspective. I do have some minor comments that should be addressed/answered before the manuscript could be accepted for publication.
What do the authors mean by “>300 attributes”? This expression is also used elsewhere in the text (e.g., L211 and L9–10). Does it mean that summing all the attributes listed in Table 1 results in more than 300 attributes? Is this because the dataset provides yearly values for some of them? Do the authors also provide the 12 monthly mean values, as is done in HydroATLAS? I feel that this is still somewhat unclear based on the current wording. A table in the Appendix or Supporting Information, similar to those provided for Caravan (Kratzert et al., Tables 1 to 5), for example, would make this easier for readers to understand.

Does ADB stand for something? Is it an abbreviation, or is it simply the name of the product?

Is the upstream accumulated value provided for each reach or for each segment?

L52: This may be a matter of preference, but I feel that the text would flow more naturally if a connector were added here, for example, “Therefore, to address…”. This impression may arise because “To address this” has already been used in L46.

Table 1: Are the authors citing the underlying dataset, the aggregation methodology, or both? Woods (2009) introduces the methodology for calculating precipitation seasonality, correct? I appreciate and agree with citing the methodology used, but it would also be useful to cite the underlying dataset.

L60: GRIT has already been defined. The authors could simply use “GRIT hydrography” here.

L101: Has this point not already been mentioned earlier in the same paragraph? I am not necessarily against the repetition, but, as currently written, it sounds like new information and confused me briefly. Could the authors rephrase the sentence if this is indeed a repetition? The sentence I am referring to is: “The accumulation statistic depends on the…” For example: “The details of the accumulation statistic, which depend on the variable, are…”. This is only a preliminary wording suggestion, so please feel free to find a more suitable formulation.

Figure 2: Given that the labels “a” and “b” are used elsewhere in the manuscript, please consider adding them to the corresponding panels.

Table 1: Could the authors add a description of each attribute in the Appendix or Supplementary Material? While reading Section 3.1, I started to wonder what exactly the authors mean by “sinuosity” and “stream gradient” — “river width” is completely clear, of course. This made me think that a table containing definitions and descriptions of the attributes would be very useful.

Such a table could also help clarify the citation of Woods (2009). For example, the authors could write: “Precipitation seasonality, representing XX, as defined by Woods (2009).” If the table were included in the Appendix, the citation would remain part of the paper and would appropriately acknowledge the original methodological contribution.

Another example is the aridity index. What definition do the authors use? Depending on the study, this may refer to P/PET, PET/P, or even normalized indices with values ranging from −1 to 1. A table containing explicit definitions would make these attributes much clearer.

L129: When the authors describe the values as heterogeneous, is this inferred visually from the figure, or did they also calculate a coefficient of variation or standard deviation? If the statement is based on the figure, perhaps add “(Figure 4a)” after “heterogeneous.” Although the claim may appear evident, this would make the basis for the statement clearer.

Figure 4: I am reviewing the manuscript using a printed copy, and in this format it is very difficult to distinguish catchments with values above 2%. Figure 2 uses a similar colour gradient for the variables but is considerably easier to read. Could the authors perhaps try using the same background colour as in Figure 2 and assess whether this improves readability?

I also have a question about the legend in Figure 4. Do the values range only from 0 to 2 because they have been normalized, or do they actually exceed 2? If values above 2 are included in the highest class, should the label not be “>2”? Apologies for being overly pedantic. The same comment applies to panel b.

Still regarding Figure 4, given that the panels are labelled “a” and “b,” the caption could simply refer to these letters, or use “Panel a” and “Panel b,” rather than “top panel” and “bottom panel.”

Section 3.3: Do the authors happen to have a global map showing these regions? Such a map could potentially be included in the Appendix or Supporting Information.

L144: While I agree that there are no clearly visible major differences in panel c, I have the impression that soil sand content differs considerably among the zones. For example, there appears to be, on average, more sand in arid areas than in the other zones, while the spread in the polar regions appears particularly large.

Perhaps Table A1 could be expanded to serve as the table describing each variable.

Figure 6: Out of curiosity, do the authors have any explanation for the concentrated area in the central-eastern part of the map, which appears particularly red in panel m? This does not necessarily need to be addressed in the manuscript, but it is a pattern that may also have caught the authors’ attention.

Table 2: Do the authors also have information on the upstream drainage-area threshold used for the other datasets?

What ordering is used for the variables in Table A1? Could the authors use the same order as in Table 1 to facilitate a more seamless comparison?

Reply
Citation: https://doi.org/10.5194/essd-2026-279-RC1
RC2:
'Comment on essd-2026-279', Anonymous Referee #2, 06 Aug 2026 reply
General comments
GRIT-ADB is a useful and timely contribution. The community has needed an attribute layer on top of GRIT since the hydrography was published, and building it as a general, extensible framework is the right design decision. The scope of harmonised source data is respectable, the multi-scale structure (reach / segment / subbasin, local / upstream) is sensible, and the inclusion of AlphaEarth embeddings is forward-looking. I expect this dataset to be useful to the community.
The most immediate problem is that the global dataset described by the manuscript is not available for review. Section 6 provides only a Congo River basin example and states that the full product will be deposited before final publication. This prevents assessment of global completeness, internal consistency, regional quality variation, and practical usability. The ESSD data policy requires the data described by a submission to be accessible during review, and the journal asks reviewers to assess the dataset itself, not only the manuscript.
Beyond accessibility, there is no dedicated validation or quantified quality assessment of the derived product. The Discussion acknowledges that biases in the source datasets will propagate into GRIT-ADB, but provides no uncertainty characterisation, independent cross-check, internal consistency assessment, or sensitivity analysis on consequential processing choices. Figure 7 shows that GRIT-ADB differs from HydroATLAS; it does not show that GRIT-ADB is closer to reality.
Second, the manuscript repeatedly claims that bifurcation-aware accumulation materially improves attribute estimates, but never quantifies the magnitude or spatial distribution of the effect. This is the claimed advantage of the product and can be tested using the GRIT network and source data already available to the authors.
I therefore recommend major revision and re-review once the complete dataset is accessible and a substantive quality assessment has been added.
Major comments
1. Make the complete global dataset available for review
The Data Availability section provides only a Congo River basin example and promises the global product before final publication. That is not sufficient for a data-description paper whose subject is a global database. The complete release should be made accessible through a functional DOI or an anonymous repository review link before the review can be completed.
2. Add a data-quality, validation, and uncertainty assessment
The qualitative statement that source-data biases propagate into GRIT-ADB is not an assessment of the derived product. The ESSD criteria for data-description articles call for validation against independent reference data or, if that is unavailable, a structured plausibility assessment. Please add a dedicated section that addresses the following:
Completeness. Report valid, missing, and imputed observations by attribute and geographic domain, including the spatial pattern of failures and coastal filling.

Internal invariants. Test conservation of extensive quantities across bifurcations and reconvergences.

Source-to-product checks. Re-extract a documented sample of raster and vector inputs and compare the independently calculated values with the released fields.

Independent or semi-independent plausibility checks. Examples could include GRIT drainage area against gauge metadata, known reservoir or lake totals in selected basins.

Sensitivity. Quantify sensitivity to bifurcation weights, midpoint versus catchment extraction and resampling choices.

Specific comments
l. 8-10 / Table 2 / repository metadata: 35 static variables plus 64 embedding dimensions equals 99, whereas Table 2 reports 98 and the example repository describes approximately 60 attributes. Reconcile all totals and define consistently what counts as a variable, embedding dimension, stored field, and expanded attribute.

Abstract l. 13-14 versus l. 63-64: The statements that reaches are up to 1 km long and that each segment is divided into equal-length reaches shorter than 1 km are compatible, but they do not uniquely specify the subdivision algorithm. State the exact rule, including treatment of short remainders and segment nodes, and provide the distribution of reach lengths.

l. 71-74: State the raster reprojection and resampling method for every data type. Nearest-neighbour, bilinear, and area-conservative resampling have materially different implications for categorical classes, continuous variables, and totals.

Table 1, "Year" column: "Most recent" is not a reproducible date. Give the exact source version, release date, and retrieval date used for GRanD v1.3, SoilGrids v2, FABDEM, GRIT, and any other rolling or versioned source.

Table 1, air-temperature seasonality: "Climatology" is capitalised and the citation is parenthesised inconsistently with adjacent rows.

Units across figures and Table A1: Sand fraction appears as percent in Figures 2 and 7 but as g/kg in Figure 5 and Table A1. Stream gradient appears as m/m in Figures 3 and 5 but m/km in Table A1. Harmonise units or explicitly annotate every conversion.

Figure 5 and l. 144-145: The statement that no visible differences occur in sand fraction across climate regions appears stronger than the boxplots support. Quantify the comparison or soften the statement.

Data availability and licensing: State the licence of the derived product and substantiate the assertion at l. 77-79 by listing the relevant licence and redistribution terms for each source dataset. Confirm that redistribution of the derived attributes is compatible with the entire source chain.

Reply
Citation: https://doi.org/10.5194/essd-2026-279-RC2

Boen Zhang, Michel Wortmann, Yinxue Liu, Frederik Kratzert, Simon Moulds, and Louise Slater

Supplement

https://doi.org/10.5194/essd-2026-279-supplement

Data sets

GRIT-ADB: A Global Hydro-Environmental Attribute Database for the GRIT Hydrography B. Zhang et al. https://doi.org/10.5281/zenodo.19363178

Boen Zhang, Michel Wortmann, Yinxue Liu, Frederik Kratzert, Simon Moulds, and Louise Slater

Viewed

Total article views: 188 (including HTML, PDF, and XML)

HTML	PDF	XML	Total	Supplement	BibTeX	EndNote
127	48	13	188	31	16	22

HTML: 127
PDF: 48
XML: 13
Total: 188
Supplement: 31
BibTeX: 16
EndNote: 22

Views and downloads (calculated since 26 Jun 2026)

Month	HTML	PDF	XML	Total
Jul 2026	92	38	6	136
Aug 2026	35	10	7	52

Cumulative views and downloads (calculated since 26 Jun 2026)

Month	HTML	PDF	XML	Total
Jul 2026	92	38	6	136
Aug 2026	35	10	7	52

Viewed (geographical distribution)

Total article views: 129 (including HTML, PDF, and XML) Thereof 129 with geography defined and 0 with unknown origin.

Country	#	Views	%

Latest update: 25 Aug 2026

Download

Preprint (15937 KB)
Metadata XML

Short summary

We created a new global hydro-environmental database to better describe how rivers are connected and how surrounding environments vary across space and time. Most existing databases simplify river networks, miss complex flow paths, and are largely based on older global datasets. Our database provides more than 300 attributes for 19.6 million km of rivers and streams. It supports more accurate study of water movement, environmental change, and climate impacts worldwide.


Total:	0
HTML:	0
PDF:	0
XML:	0