xdem.DEM.max_curvature

xdem.DEM.max_curvature#

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

Calculate the maximal (geometric) or maximum (directional derivative) curvature in units of m-1 multiplied by 100. Defined as curvature of the normal section of slope with the greatest curvature value.

Geometric (default) maximal curvature is calculated following Shary (1995, https://doi.org/10.1007/BF02084608) and is equal to the minimal curvature of Euler (1760).

Directional derivative maximum curvature is the minimum second derivative following Wood (1996), https://lra.le.ac.uk/handle/2381/34503

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 maximal or maximum curvature array of the DEM.