hydromt_wflow.workflows.hydrography

hydromt_wflow.workflows.hydrography(ds: xarray.core.dataset.Dataset, res: float, xy: typing.Optional[geopandas.geodataframe.GeoDataFrame] = None, upscale_method: str = 'ihu', flwdir_name: str = 'flwdir', uparea_name: str = 'uparea', basins_name: str = 'basins', strord_name: str = 'strord', ftype: str = 'infer', logger=<Logger hydromt_wflow.workflows.basemaps (WARNING)>)[source]

Returns hydrography maps (see list below) and FlwdirRaster object based on gridded flow direction and elevation data input.

The output maps are: - flwdir : flow direction [-] - basins : basin map [-] - uparea : upstream area [km2] - strord : stream order [-] If the resolution is lower than the source resolution, the flow direction data is upscaled and river length and slope are based on subgrid flow paths and the following maps are added: - subare : contributing area to each subgrid outlet pixel (unit catchment area) [km2] - subelv : elevation at subgrid outlet pixel [m+REF] :param ds: Dataset containing gridded flow direction and elevation data. :type ds: xarray.DataArray :param res: output resolution :type res: float :param xy: Subbasin pits. Only required when upscaling a subbasin. :type xy: geopandas.GeoDataFrame, optional :param upscale_method: Upscaling method for flow direction data, by default ‘ihu’, see 1 :type upscale_method: {‘ihu’, ‘eam’, ‘dmm’} :param ftype: name of flow direction type, infer from data if ‘infer’, by default is ‘infer’ :type ftype: {‘d8’, ‘ldd’, ‘nextxy’, ‘nextidx’, ‘infer’}, optional :param flwdir_name: Name of flow direction [-], elevation [m], upstream area [km2], basin index [-]

and stream order [-] variables in ds

Parameters

elevtn_name (str, optional) – Name of flow direction [-], elevation [m], upstream area [km2], basin index [-] and stream order [-] variables in ds
uparea_name (str, optional) – Name of flow direction [-], elevation [m], upstream area [km2], basin index [-] and stream order [-] variables in ds
basins_name (str, optional) – Name of flow direction [-], elevation [m], upstream area [km2], basin index [-] and stream order [-] variables in ds
strord_name (str, optional) – Name of flow direction [-], elevation [m], upstream area [km2], basin index [-] and stream order [-] variables in ds

Returns

ds_out (xarray.DataArray) – Dataset containing gridded hydrography data
flwdir_out (pyflwdir.FlwdirRaster) – Flow direction raster object.

References

1: Eilander et al. (2021). A hydrography upscaling method for scale-invariant parametrization of distributed hydrological models. Hydrology and Earth System Sciences, 25(9), 5287–5313. https://doi.org/10.5194/hess-25-5287-2021