# airGRdatasets: Hydro-Meteorological Catchments
Datasets for the 'airGR' Packages. Manual of the R
package version 0.2.1

Olivier Delaigue, Pierre Brigode, Guillaume Thirel

<figure><img src="image_1.png" /></figure>

## To cite this version:

Olivier Delaigue, Pierre Brigode, Guillaume Thirel. airGRdatasets: Hydro-Meteorological Catchments Datasets for the 'airGR' Packages. Manual of the R package version 0.2.1. 2023. hal-04162960v2

HAL Id: hal-04162960

https://hal.inrae.fr/hal-04162960v2

Submitted on 17 Jul 2023

HAL is a multi-disciplinary open access
archive for the deposit and dissemination of sci-
entific research documents, whether they are pub-
lished or not. The documents may come from
teaching and research institutions in France or
abroad, or from public or private research centers.

L'archive ouverte pluridisciplinaire HAL, est
destinée au dépôt et à la diffusion de documents
scientifiques de niveau recherche, publiés ou non,
émanant des établissements d'enseignement et de
recherche français ou étrangers, des laboratoires
publics ou privés.

<figure><img src="image_2.png" /></figure>

Distributed under a Creative Commons Attribution - NonCommercial - ShareAlike 4.0 International
License
# airGRdatasets: Hydro-Meteorological Catchments
Datasets for the 'airGR' Packages. Manual of the R
package version 0.2.3

Olivier Delaigue, Pierre Brigode, Guillaume Thirel

► To cite this version:

Olivier Delaigue, Pierre Brigode, Guillaume Thirel. airGRdatasets: Hydro-Meteorological Catchments Datasets for the 'airGR' Packages. Manual of the R package version 0.2.3. 2025. hal-04162960v4

HAL Id: hal-04162960

https://hal.inrae.fr/hal-04162960v4

Submitted on 9 Dec 2025

HAL is a multi-disciplinary open access
archive for the deposit and dissemination of sci-
entific research documents, whether they are pub-
lished or not. The documents may come from
teaching and research institutions in France or
abroad, or from public or private research centers.

L'archive ouverte pluridisciplinaire HAL, est
destinée au dépôt et à la diffusion de documents
scientifiques de niveau recherche, publiés ou non,
émanant des établissements d'enseignement et de
recherche français ou étrangers, des laboratoires
publics ou privés.

<figure><img src="image_1.png" /></figure>

Distributed under a Creative Commons Attribution 4.0 International License
# Package 'airGRdatasets'

July 13, 2023

**Type** Package

**Title** Hydro-Meteorological Catchments Datasets for the 'airGR' Packages

**Version** 0.2.1

**Date** 2023-07-11

**Description** Sample of hydro-meteorological datasets extracted from the 'CAMELS-FR' French database <https://hal.inrae.fr/hal-03687235>. It provides metadata and catchment-scale aggregated hydro-meteorological time series on a pool of French catchments for use by the 'airGR' packages.

**License** CC BY-NC-SA 4.0

**Encoding** UTF-8

**Depends** R (>= 3.5.0)

**Suggests** testthat

**URL** https://gitlab.irstea.fr/HYCAR-Hydro/airgrgalaxy/airgrdatasets

**BugReports** https://gitlab.irstea.fr/HYCAR-Hydro/airgrgalaxy/airgrdatasets/-/issues

**NeedsCompilation** no

**LazyData** true

**Author** Olivier Delaigue [aut, cre] (<https://orcid.org/0000-0002-7668-8468>), Pierre Brigode [aut] (<https://orcid.org/0000-0001-8257-0741>), Guillaume Thirel [aut] (<https://orcid.org/0000-0002-1444-1830>), Benoît Génot [ctb], Guilherme Mendoza Guimarães [ctb] (<https://orcid.org/0000-0002-4580-6089>)

**Maintainer** Olivier Delaigue <airGR@inrae.fr>

**Repository** CRAN

**Date/Publication** 2023-07-12 22:40:02 UTC

## R topics documented:

<table><tr><td>airGRdatasets-package</td><td>2</td></tr><tr><td>lumped_daily</td><td>2</td></tr></table>
# Package 'airGRdatasets'

December 4, 2025

**Type** Package

**Title** Hydro-Meteorological Catchments Datasets for the 'airGR' Packages

**Version** 0.2.3

**Date** 2025-12-04

**Description** Sample of hydro-meteorological datasets extracted from the 'CAMELS-FR' French database <doi:10.57745/WH7FJR>. It provides metadata and catchment-scale aggregated hydro-meteorological time series on a pool of French catchments for use by the 'airGR' packages.

**License** CC BY 4.0

**Encoding** UTF-8

**Depends** R (>= 3.5.0)

**Suggests** testthat

**URL** https://gitlab.irstea.fr/HYCAR-Hydro/airgrgalaxy/airgrdatasets

**BugReports** https://gitlab.irstea.fr/HYCAR-Hydro/airgrgalaxy/airgrdatasets/-/issues

**NeedsCompilation** no

**LazyData** true

**Author** Olivier Delaigue [aut, cre] (ORCID: <https://orcid.org/0000-0002-7668-8468>), Pierre Brigode [aut] (ORCID: <https://orcid.org/0000-0001-8257-0741>), Guillaume Thirel [aut] (ORCID: <https://orcid.org/0000-0002-1444-1830>), Benoît Génot [ctb], Guilherme Mendoza Guimarães [ctb] (ORCID: <https://orcid.org/0000-0002-4580-6089>)

**Maintainer** Olivier Delaigue <airGR@inrae.fr>

**Repository** CRAN

**Date/Publication** 2025-12-04 15:30:02 UTC
airGRdatasets-package Hydro-Meteorological Catchments Datasets for the 'airGR' Packages

## Description

Sample of hydro-meteorological datasets extracted from the 'CAMELS-FR' French database <https://hal.inrae.fr/hal-03687235>. It provides metadata and catchment-scale aggregated hydro-meteorological time series on a pool of French catchments for use by the 'airGR' packages. More especially, it can be used by teachers and students for hydrological modeling exercises adapted to the 'airGRteaching' package as described in Delaigue et al. (submitted) and in the 'airGRteaching' vignettes.

The package contains the following types of datasets:

* lumped_daily: a set of lumped catchment daily hydrometeorological time series, and associated metadata.

## Source

Delaigue, O., Brigode, P., Andréassian, V., Perrin, C., Etchevers, P., Soubeyroux, J.-M., Janet, B. and Addor, N. (2022). CAMELS-FR: A large sample hydroclimatic dataset for France to explore hydrological diversity and support model benchmarking. 11th edition of the IAHS Scientific Assembly. International Association of Hydrological Sciences, Montpellier, 29 May - 3 Jun. 2022. hal-03687235

## References

Delaigue, O., Brigode, P., Thirel, G. and Coron, L. (submitted). airGRteaching: an open-source tool for teaching hydrological modelling. Hydrology and Earth System Sciences.

lumped_daily Metadata and daily time series of catchment-scale hydro-meteorological observations

## Description

The meteorological forcing is derived from the SAFRAN reanalysis (8 km resolution grid) produced by Météo-France (Vidal et al., 2010).

The meteorological forcing is aggregated at the catchment scale and merged to streamflow data in the CAMELS-FR database from INRAE (Delaigue et al., 2022). To do that, boundaries, area and elevation are calculated using the SRTM DEM (Werner, 2001); the stations were snaped on a theorical river network by INRAE (100 m resolution grid).

The streamflows, codes and name of hydrometric station are provided by the SCHAPI (the French Central Hydrometeorological and Flood Forecasting Support Service) on the Hydroportail website (SCHAPI, 2022). Streamflows are converted into mm/d using the DEM-based area.
# Contents

<table><tr><td>airGRdatasets-package</td><td>2</td></tr><tr><td>lumped_daily</td><td>3</td></tr></table>

<table><tr><td>Index</td><td>7</td></tr></table>

airGRdatasets-package Hydro-Meteorological Catchments Datasets for the 'airGR' Packages

## Description

Sample of hydro-meteorological datasets extracted from the 'CAMELS-FR' French database <doi:10.57745/WH7FJR>. It provides metadata and catchment-scale aggregated hydro-meteorological time series on a pool of French catchments for use by the 'airGR' packages. More especially, it can be used by teachers and students for hydrological modeling exercises adapted to the 'airGRteaching' package (doi:10.32614/CRAN/package.airGRteaching), as described in Delaigue et al. (2023) and in the 'airGRteaching' vignettes.

The package contains the following types of datasets:

* lumped_daily: a collection of daily hydrometeorological time series of lumped catchments, along with associated metadata.

## Source

Delaigue, O., Guimarães, G. M., Brigode, P., Génot, B., Perrin, C., and Andréassian, V. (2024). CAMELS-FR dataset, V1, Recherche Data Gouv [data set], doi:10.57745/WH7FJR.

## References

Delaigue, O., Brigode, P., Thirel, G., and Coron, L. (2023). airGRteaching: an open-source tool for teaching hydrological modeling with R, Hydrol. Earth Syst. Sci., 27, 3293–3327, doi:10.5194/hess2732932023.

Delaigue, O., Guimarães, G. M., Brigode, P., Génot, B., Perrin, C., Soubeyroux, J.-M., Janet, B., Addor, N., and Andréassian, V. (2025). CAMELS-FR dataset: a large-sample hydroclimatic dataset for France to explore hydrological diversity and support model benchmarking, Earth Syst. Sci. Data, 17, 1461–1479, doi:10.5194/essd1714612025.
## Usage

```
A273011002
A605102001
B222001001
E540031001
E645651001
H010002001
H120101001
F439000101
H622101001
J171171001
J421191001
K134181001
K265401001
K731261001
V123521001
X031001001
X045401001
Y643401001
Y862000101
```

## Format

[list] of 3 elements:

Meta [list] metadata

* Code [list] of 2 [character] codes of the hydrometric station (H3: code since 2022, H2: former code)

* Name [character] name of the hydrometric station (H3)

* Coor [list] of 2 [numeric] coordinates (X and Y) of the catchment outlet [decimal degrees; epsg: 4326]

* Area [numeric] area of the catchment [km²]

TS [data.frame] catchment daily time series from 1999-01-01 to 2018-12-31

* Date [POSIXct] dates (timezone = "UTC")

* Ptot [numeric] total precipitation (liquid + solid) [mm/d]

* Temp [numeric] mean air temperature [°C]

* Evap [numeric] total potential evapotranspiration computed with Oudin's Formula (Oudin et al., 2005)

* Q1s [numeric] outlet streamflow [l/s]

* Qmmd [numeric] outlet streamflow [mm/d]

Hypso [numeric] hypsometric values (101 quantiles from 0 to 100 % of the elevation range of the catchment) [m]
<table><tr><td>lumped_daily</td><td>Metadata and daily time series of catchment-scale hydro-meteorological observations</td></tr></table>

## Description

Meteorological forcing is derived from the SAFRAN reanalysis (8 km resolution grid) produced by Météo-France (Quintana-Seguí et al., 2008; Vidal et al., 2010).

Meteorological forcing is aggregated at the catchment scale and merged with streamflow data within the CAMELS-FR database from INRAE (Delaigue et al., 2024; Delaigue et al., 2025). To accomplish this, catchment boundaries, area, and elevation are determined using two digital terrain models (DTMs). For continental metropolitan France, we used the 100 m × 100 m resolution DTM from the Shuttle Radar Topography Mission (SRTM) project (Rabus et al., 2003; Farr et al., 2007), while for Corsica, the BD ALTI v1.0 with 25 m × 25 m resolution from IGN (2001) was employed. Stations were snapped to a theoretical river network derived from the DTMs, with flow directions constrained using the stream-burning method and the CARTHAGE river network (French water agencies, 2017) after channel removal.

The streamflow data, as well as the codes and names of hydrometric stations, are provided by SCHAPI (the French Central Hydrometeorological and Flood Forecasting Support Service) via the Hydroportail website (SCHAPI, 2022). Streamflows are converted to mm/d using the DEM-based catchment area

## Usage

```
A273011002
A605102001
B222001001
E540031001
E645651001
H010002001
H120101001
F439000101
H622101001
J171171001
J421191001
K134181001
K265401001
K731261001
V123521001
X031001001
X045401001
Y643401001
Y862000101
```
Note

List of available catchments:

<table><thead><tr><td>station_code</td><td>id_map</td><td>station_name</td></tr></thead><tbody><tr><td>A273011002</td><td>A</td><td>the Bruche at Russ [Wisches]</td></tr><tr><td>A605102001</td><td>B</td><td>the Meurthe at Saint-Dié-des-Vosges</td></tr><tr><td>B222001001</td><td>C</td><td>the Meuse at Saint-Mihiel</td></tr><tr><td>E540031001</td><td>D</td><td>the Canche at Brimeux</td></tr><tr><td>E645651001</td><td>E</td><td>the Nièvre at Étoile</td></tr><tr><td>F439000101</td><td>F</td><td>the Loing at Épisy</td></tr><tr><td>H010002001</td><td>G</td><td>the Seine at Plaines-Saint-Lange</td></tr><tr><td>H120101001</td><td>H</td><td>the Aube at Bar-sur-Aube</td></tr><tr><td>H622101001</td><td>I</td><td>the Aisne at Givry</td></tr><tr><td>J171171001</td><td>J</td><td>the Trieux at Saint-Péver - Pont Locminé</td></tr><tr><td>J421191001</td><td>K</td><td>the Odet at Ergué-Gabéric - Treodet</td></tr><tr><td>K134181001</td><td>L</td><td>the Arroux at Rigny-sur-Arroux</td></tr><tr><td>K265401001</td><td>M</td><td>the Couze Pavin at Saint-Floret</td></tr><tr><td>K731261001</td><td>N</td><td>the Indre at Saint-Cyran-du-Jambot</td></tr><tr><td>V123521001</td><td>O</td><td>the Ire at Doussard</td></tr><tr><td>X031001001</td><td>P</td><td>the Durance at Embrun [La Clapière] - DREAL PACA</td></tr><tr><td>X045401001</td><td>Q</td><td>the Ubaye at Lauzet-Ubaye [Roche-Rousse] - DREAL PACA</td></tr><tr><td>Y643401001</td><td>R</td><td>the Esteron at Broc [La Clave]</td></tr><tr><td>Y862000101</td><td>S</td><td>the Taravo at Zigliara [Pont d'Abra]</td></tr></tbody></table>

<figure><img src="image_3.png" /></figure>

Source

Delaigue, O., Brigode, P., Andréassian, V., Perrin, C., Etchevers, P., Soubeyroux, J.M., Janet, B. and Addor, N. (2022). CAMELS-FR: A large sample hydroclimatic dataset for france to explore hydrological diversity and support model benchmarking. 11th edition of the IAHS Scientific Assembly. International Association of Hydrological Sciences, Montpellier, 29 May - 3 Jun. 2022. hal-03687235
## Format

[list] of 3 elements:

Meta [list] metadata

* Code [list] of 2 [character] codes of the hydrometric station (H3: code since 2022, H2: former code)

* Name [character] name of the hydrometric station (H3)

* Coor [list] of 2 [numeric] coordinates (X and Y) of the catchment outlet [decimal degrees; epsg: 4326]

* Area [numeric] area of the catchment [km²]

TS [data.frame] catchment daily time series from 1999-01-01 to 2018-12-31

* Date [POSIXct] dates (timezone = "UTC")

* Ptot [numeric] total precipitation (liquid + solid) [mm/d]

* Temp [numeric] mean air temperature [°C]

* Evap [numeric] total potential evapotranspiration computed with Oudin's Formula (Oudin et al., 2005)

* Qls [numeric] outlet streamflow [l/s]

* Qmmd [numeric] outlet streamflow [mm/d]

Hypso [numeric] hypsometric values (101 quantiles from 0 to 100 % of the elevation range of the catchment) [m]

## Note

List of available catchments:

<table><thead><tr><td>station_code</td><td>id_map</td><td>station_name</td></tr></thead><tbody><tr><td>A273011002</td><td>A</td><td>the Bruche at Russ [Wisches]</td></tr><tr><td>A605102001</td><td>B</td><td>the Meurthe at Saint-Dié-des-Vosges</td></tr><tr><td>B222001001</td><td>C</td><td>the Meuse at Saint-Mihiel</td></tr><tr><td>E540031001</td><td>D</td><td>the Canche at Brimeux</td></tr><tr><td>E645651001</td><td>E</td><td>the Nièvre at Étoile</td></tr><tr><td>F439000101</td><td>F</td><td>the Loing at Épisy</td></tr><tr><td>H010002001</td><td>G</td><td>the Seine at Plaines-Saint-Lange</td></tr><tr><td>H120101001</td><td>H</td><td>the Aube at Bar-sur-Aube</td></tr><tr><td>H622101001</td><td>I</td><td>the Aisne at Givry</td></tr><tr><td>J171171001</td><td>J</td><td>the Trieux at Saint-Péver - Pont Locminé</td></tr><tr><td>J421191001</td><td>K</td><td>the Odet at Ergué-Gabéric - Treodet</td></tr><tr><td>K134181001</td><td>L</td><td>the Arroux at Rigny-sur-Arroux</td></tr><tr><td>K265401001</td><td>M</td><td>the Couze Pavin at Saint-Floret</td></tr><tr><td>K731261001</td><td>N</td><td>the Indre at Saint-Cyran-du-Jambot</td></tr><tr><td>V123521001</td><td>O</td><td>the Ire at Doussard</td></tr><tr><td>X031001001</td><td>P</td><td>the Durance at Embrun [La Clapière] - DREAL PACA</td></tr><tr><td>X045401001</td><td>Q</td><td>the Ubaye at Lauzet-Ubaye [Roche-Rousse] - DREAL PACA</td></tr></tbody></table>
## References

Oudin, L., Hervieu, F., Michel, C., Perrin, C., Andréassian, V., Anctil, F. and Loumagne, C. (2005). Which potential evapotranspiration input for a lumped rainfall-runoff model? Part 2 - Towards a simple and efficient potential evapotranspiration model for rainfall-runoff modelling. Journal of Hydrology, 303(1-4), 290-306, doi:10.1016/j.jhydrol.2004.08.026.

SCHAPI (2022). Hydroportail website. Retrieve hydrometric data from the French National Surface Water Quantity Database. https://www.hydro.eaufrance.fr/.

Vidal, J.-P., Martin, E., Franchistéguy, L., Baillon, M. and Soubeyroux, J. (2010). A 50-year high-resolution atmospheric reanalysis over France with the Safran system. International Journal of Climatology, 30, 1627–1644, doi:10.1002/joc.2003.

Jarvis A., Reuter H.I., Nelson A. & Guevara E. (2008). Hole-filled SRTM for the globe V4. International Centre for Tropical Agriculture (CIAT).

## Examples

```r
library(airGRdatasets)
```

```r
# list the datasets in the 'airGRdatasets' package
list_ds <- try(data/package = "airGRdatasets"), silent = TRUE)
list_ds$results[, "Item"]
```

```r
# load the 'A273011002' catchment data
data(A273011002)
```

```r
# display the structure of the data
str(A273011002)
```
Y643401001 R the Esteron at Broc [La Clave]

Y862000101 S the Taravo at Zigliara [Pont d'Abra]

<figure><img src="image_2.png" /></figure>

## Source

Delaigue, O., Guimarães, G. M., Brigode, P., Génot, B., Perrin, C., and Andréassian, V. (2024). CAMELS-FR dataset, V1, Recherche Data Gouv [data set], doi:10.57745/WH7FJR.

## References

Delaigue, O., Guimarães, G. M., Brigode, P., Génot, B., Perrin, C., Soubeyroux, J.-M., Janet, B., Addor, N., and Andréassian, V. (2025). CAMELS-FR dataset: a large-sample hydroclimatic dataset for France to explore hydrological diversity and support model benchmarking, Earth Syst. Sci. Data, 17, 1461–1479, doi:10.5194/essd1714612025.

Farr, T. G., Rosen, P. A., Caro, E., Crippen, R., Duren, R., Hensley, S., Kobrick, M., Paller, M., Rodriguez, E., Roth, L., Seal, D., Shaffer, S., Shimada, J., Umland, J., Werner, M., Oskin, M., Burbank, D., and Alsdorf, D. (2007). The Shuttle Radar Topography Mission, Rev. Geophys., 45, RG2004, doi:10.1029/2005RG000183.

French water agencies: BD Carthage (2017). Cours d'eau de Métropole 2017, version 2019-10-24, Eaufrance [data set], https://www.sandre.eaufrance.fr/atlas/sandre.eaufrance.fr/bd-carthage

IGN (2001). BD ALTI, version 1.0., Institut national de l'information géographique et forestière (IGN) [data set], https://geoservices.ign.fr/bdalti.

Oudin, L., Hervieu, F., Michel, C., Perrin, C., Andréassian, V., Anctil, F., and Loumagne, C. (2005). Which potential evapotranspiration input for a lumped rainfall-runoff model? Part 2 - Towards a simple and efficient potential evapotranspiration model for rainfall-runoff modelling. Journal of Hydrology, 303(1-4), 290-306, doi:10.1016/j.jhydrol.2004.08.026.

Quintana-Segui, P., Le Moigne, P., Durand, Y., Martin, E., Habets, F., Baillon, M., Canellas, C., Franchisteguy, L., and Morel, S. (2008). Analysis of near-surface atmospheric variables: Validation of the SAFRAN analysis over France, J. Appl. Meteorol. Clim., 47, 92–107, doi:10.1175/
# Index

## Hydroportail

airGRdatasets-package, 2

## PHyC

airGRdatasets-package, 2

## SAFRAN

airGRdatasets-package, 2

## airGR

airGRdatasets-package, 2

A273011002 (lumped_daily), 2

A605102001 (lumped_daily), 2

airGRdatasets (airGRdatasets-package), 2

airGRdatasets-package, 2

B222001001 (lumped_daily), 2

E540031001 (lumped_daily), 2

E645651001 (lumped_daily), 2

F439000101 (lumped_daily), 2

H010002001 (lumped_daily), 2

H120101001 (lumped_daily), 2

H622101001 (lumped_daily), 2

J171171001 (lumped_daily), 2

J421191001 (lumped_daily), 2

K134181001 (lumped_daily), 2

K265401001 (lumped_daily), 2

K731261001 (lumped_daily), 2

lumped_daily, 2, 2

V123521001 (lumped_daily), 2

X031001001 (lumped_daily), 2

X045401001 (lumped_daily), 2

Y643401001 (lumped_daily), 2

Y862000101 (lumped_daily), 2
2007JAMC1636.1.

Rabus, B., Eineder, M., Roth, A., and Bamler, R. (2003). The shuttle radar topography mission—a new class of digital elevation models acquired by spaceborne radar, ISPRS J. Photogramm., 57, 241–262, doi:10.1016/S09242716(02)001247.

SCHAPI (2022). Hydroportail website. Retrieve hydrometric data from the French National Surface Water Quantity Database. https://www.hydro.eaufrance.fr/.

Vidal, J.-P., Martin, E., Franchistéguy, L., Baillon, M., and Soubeyroux, J. (2010). A 50-year high-resolution atmospheric reanalysis over France with the Safran system. International Journal of Climatology, 30, 1627–1644, doi:10.1002/joc.2003.

## Examples

```r
library(airGRdatasets)
```

```r
# list the datasets in the 'airGRdatasets' package
list_ds <- try(data/package = "airGRdatasets"), silent = TRUE)
list_ds$results[, "Item"]
```

```r
# load the 'A273011002' catchment data
data(A273011002)
```

```r
# display the structure of the data
str(A273011002)
```
# Index

* Hydroportail

airGRdatasets-package, 2

* PHyC

airGRdatasets-package, 2

* SAFRAN

airGRdatasets-package, 2

* airGR

airGRdatasets-package, 2

A273011002 (lumped_daily), 3

A605102001 (lumped_daily), 3

airGRdatasets (airGRdatasets-package), 2

airGRdatasets-package, 2

B222001001 (lumped_daily), 3

E540031001 (lumped_daily), 3

E645651001 (lumped_daily), 3

F439000101 (lumped_daily), 3

H010002001 (lumped_daily), 3

H120101001 (lumped_daily), 3

H622101001 (lumped_daily), 3

J171171001 (lumped_daily), 3

J421191001 (lumped_daily), 3

K134181001 (lumped_daily), 3

K265401001 (lumped_daily), 3

K731261001 (lumped_daily), 3

lumped_daily, 2, 3

V123521001 (lumped_daily), 3

X031001001 (lumped_daily), 3

X045401001 (lumped_daily), 3

Y643401001 (lumped_daily), 3

Y862000101 (lumped_daily), 3