as_transfr {transfR}

Create transfR object

Description

Create a transfR object or add new attributes to a transfR object.

Usage

as_transfr(
  object,
  st,
  uc,
  lagtime,
  surface,
  delineation,
  outlet,
  centroid,
  uh,
  hl
)

Arguments

object

object of class transfR

st

spatio-temporal arrays of class stars. Observed discharge must be described by the column name 'Qobs'. Time should be the first dimension, space the second dimension. If no unit is provided, Qobs is assumed to be in [m3/s] and RnInv is assumed to be in [mm/h] (or [mm/d] at daily time step).

uc

vector of the streamflow velocities of the catchments. If no unit is provided, uc is assumed to be in [m/s].

lagtime

vector of the lag times of the catchments. If no unit is provided, lagtime is assumed to be in [h].

surface

vector of the surfaces of the catchments. If no unit is provided, surface is assumed to be in [km2].

delineation

spatial layer of the boundary of the catchments of class sfc_POLYGON.

outlet

spatial layer of the outlets of the catchments of class sfc_POINT.

centroid

spatial layer of the centroids of the catchments of class sfc_POINT.

uh

list of the unit hydrographs of the catchments.

hl

hydraulic length of class stars, matrix or vector. If no unit is provided, hl is assumed to be in [m]. See details below.

Details

This function creates an object of class transfR or increment an existing transfR object with new attributes. It can be used to gather and organize most of the inputs and outputs of the other functions like streamflow velocities, unit hydrograph, a priori on net rainfall, inversions and simulations of every catchments.

This function can be used to organise the two user inputs required for a conventional use of the package, namely st and hl. The hydraulic lengths are defined as the flow path length from each pixel to the outlet within the river network (Cudennec et al. 2004; Aouissi et al. 2013). Catchment delineations and hydraulic lengths need to be prepared beforehand by the user. This package does not provide functions to create them. However, several GIS software offer possibilities to extract them from a digital elevation model such as GRASS toolkits (Jasiewicz and Metz 2011), Whitebox GAT (see Lindsay (2016) or WhiteboxTools), TauDEM (D. Tarboton, Utah State University) or online services (see Squividant et al. (2015) for catchment delineation in the Brittany French region).

Value

An object of class transfR.

References

Aouissi J, Pouget J, Boudhraâ H, Storer G, Cudennec C (2013). “Joint spatial, topological and scaling analysis framework of river-network geomorphometry.” Géomorphologie : relief, processus, environnement, 19(1), 7–16. doi:10.4000/geomorphologie.10082.

Cudennec C, Fouad Y, Gatot IS, Duchesne J (2004). “A geomorphological explanation of the unit hydrograph concept.” Hydrological Processes, 18(4), 603–621. doi:10.1002/hyp.1368.

Jasiewicz J, Metz M (2011). “A new GRASS GIS toolkit for Hortonian analysis of drainage networks.” Computers & Geosciences, 37(8), 1162–1173. doi:10.1016/j.cageo.2011.03.003.

Lindsay JB (2016). “Whitebox GAT: A case study in geomorphometric analysis.” Computers & Geosciences, 95, 75–84. doi:10.1016/j.cageo.2016.07.003.

Squividant H, Bera R, Aurousseau P, Cudennec C (2015). “Online watershed boundary delineation: sharing models through Spatial Data Infrastructures.” Proceedings of the International Association of Hydrological Sciences, 368, 144–149. doi:10.5194/piahs-368-144-2015.

Examples

data(Oudon)
object <- as_transfr(st = Oudon$obs, hl = Oudon$hl)