r.hydro.hbv.forcing - GRASS manual

NAME

r.hydro.hbv.forcing - Reduces a climate STRDS (ERA5/ERA5-Land, MODIS, or any other daily raster time series) to a per-basin daily long-format (station_id,date,value) DB table for r.hydro.hbv's *_table= options.

KEYWORDS

temporal, hydrology, HBV

SYNOPSIS

r.hydro.hbv.forcing

r.hydro.hbv.forcing --help

r.hydro.hbv.forcing strds=name basins=name basins_vector=name [basin_id_column=name] output_table=name [--help] [--verbose] [--quiet] [--ui]

Flags:

--help: Print usage summary
--verbose: Verbose module output
--quiet: Quiet module output
--ui: Force launching GUI dialog

Parameters:

strds=name [required]: Daily raster time series (precipitation, temperature, ...)
basins=name [required]: Delineated basins raster (r.hydro.hbv.basins' basins= output)
basins_vector=name [required]: Name of input vector map; Delineated basins vector, for the basin_id attribute (r.hydro.hbv.basins' basins_vector= output)
basin_id_column=name: Column in basins_vector holding the basin identifier; Default: basin_id
output_table=name [required]: Name for the output long-format (station_id,date,value) DB table

DESCRIPTION
EXAMPLE
SEE ALSO
AUTHOR

DESCRIPTION

r.hydro.hbv.forcing turns a daily raster time series (a space-time raster dataset, STRDS -- e.g. an ERA5-Land precipitation or temperature series already imported with t.rast.import, or any other daily raster series registered into a STRDS) into the long-format (station_id, date, value) DB table that r.hydro.hbv's precipitation_table=/temperature_table=/etc. options expect, via one t.rast.univar zonal-mean call against a r.hydro.hbv.basins-delineated basins raster.

basins is the delineated basins raster (r.hydro.hbv.basins' basins= output); basins_vector is its vectorized counterpart (basins_vector= output), used only to look up each basin's basin_id_column value (default basin_id) so the output table's station_id matches what r.hydro.hbv (or r.hydro.hbv.basins itself) already uses.

EXAMPLE

# basins already delineated by r.hydro.hbv.basins as basins/basins_v
t.create output=era5_precip type=strds temporaltype=absolute \
  title="ERA5-Land precipitation" description="..."
t.register input=era5_precip maps=`g.list type=raster pattern="era5_precip_*" separator=,` \
  start="2001-01-01" increment="1 days"

r.hydro.hbv.forcing strds=era5_precip basins=basins basins_vector=basins_v \
  output_table=era5_precip_table

r.hydro.hbv dataset=custom precipitation_table=era5_precip_table \
  temperature=temp.csv evapotranspiration=evap.csv eta_observed=etobs.csv \
  discharge_observed=dischargeobs.csv basins_vector=basins_v \
  n_calib_steps=1000 n_years=3 warmup=100 n_realizations=1000 \
  output=/tmp/hbv_era5

AUTHOR

Yann Chemin

SOURCE CODE

Available at: r.hydro.hbv.forcing source code (history)

Accessed: Monday Jul 27 12:29:27 2026