xdem.DEM.flowline_curvature

xdem.DEM.flowline_curvature#

DEM.flowline_curvature(surface_fit='Florinsky', curv_method='geometric', mp_config=None)[source]#

Calculates flow line curvature in units of m-1 multiplied by 100. Defined as the curvature of a projection of the slope line onto a horizontal plane. Sometimes known as the rotor or steam line curvature.

Geometric (default) flowline curvature follows the contour torsion described by Minár et al. (2020), https://doi.org/10.1016/j.earscirev.2020.103414

Directional derivative flowline curvature follows Shary, 1991 in Minár et al. (2020), https://doi.org/10.1016/j.earscirev.2020.103414

Parameters:

  • surface_fit (Literal['ZevenbergThorne', 'Florinsky']) – The surface fit to use, either ‘ZevenbergThorne’ or ‘Florinsky’.

  • curv_method (Literal['geometric', 'directional']) – The method to use to calculate the curvature, either ‘geometric’ or ‘directional’.

  • mp_config (MultiprocConfig | None) – Multiprocessing configuration, run the function in multiprocessing if not None.

  • engine – Engine to use for computing the attribute, “scipy” or “numba”.

Raises:

ValueError – If the inputs are poorly formatted.

Return type:

TypeVar(RasterType, bound= Raster)

Returns:

The flowline curvature array of the DEM.