xrspatial.hydro.stream_link_dinf.stream_link_dinf

xrspatial.hydro.stream_link_dinf.stream_link_dinf(flow_dir_dinf: DataArray, flow_accum: DataArray, threshold: float = 100, name: str = 'stream_link_dinf') → DataArray

Assign unique IDs to stream link segments (D-infinity).

Each contiguous stream segment between junctions, headwaters, and outlets receives a distinct positive integer ID. Non-stream cells are NaN.

Parameters:

• flow_dir_dinf (xarray.DataArray or xr.Dataset) – 2D D-infinity flow direction grid. Values are continuous angles in radians in the range [0, 2*pi). -1.0 indicates a pit or flat. NaN indicates nodata.

• flow_accum (xarray.DataArray) – 2D flow accumulation grid. Cells with flow_accum >= threshold are stream cells.

• threshold (float, default 100) – Minimum accumulation for stream classification.

• name (str, default 'stream_link_dinf') – Name of output DataArray.

Returns:

2D float64 grid where each stream link has a unique positive integer ID. Non-stream cells are NaN.

Return type:

xarray.DataArray or xr.Dataset

References

Tarboton, D.G. (1997). A new method for the determination of flow directions and upslope areas in grid digital elevation models. Water Resources Research, 33(2), 309-319.