xdem.DEM.min_curvature

xdem.DEM.min_curvature#

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

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

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

Directional derivative minimum curvature is the maximum 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 minimal or minimum curvature array of the DEM.