xdem.DEM.planform_curvature

xdem.DEM.planform_curvature#

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

Calculates planform (or plan) curvature in units of m-1 multiplied by 100., defined as the curvature of a projection of the contour line onto a horizontal plane. Sometimes known as the horizontal curvature, although this terminology has been shared with tangential curvature.

Geometric and directional derivatives are identical, following method based on Sobolevsky (1932) 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)