pointpats.euclidean_median¶

pointpats.euclidean_median(points)[source]¶

pointpats.euclidean_median(points: ndarray) → ndarray[tuple[Any, ...], dtype[float64]]

pointpats.euclidean_median(points: GeoPandasBase) → Point

Calculate the Euclidean median for a point pattern.

Parameters:

pointsarraylike: array representing a point pattern

Returns:

median: Euclidean median of a given point pattern

Examples

>>> import numpy as np
>>> import geopandas as gpd

Create an array of point coordinates.

>>> coords = np.array(
...     [
...         [66.22, 32.54],
...         [22.52, 22.39],
...         [31.01, 81.21],
...         [9.47, 31.02],
...         [30.78, 60.10],
...         [75.21, 58.93],
...         [79.26, 7.68],
...         [8.23, 39.93],
...         [98.73, 77.17],
...         [89.78, 42.53],
...         [65.19, 92.08],
...     ]
... )

Passing an array of coordinates returns an array capturing the median.

>>> euclidean_median(coords)
array([53.51770575, 49.6572671 ])

Passing a GeoPandas object returns a shapely geometry.

>>> geoms = gpd.GeoSeries.from_xy(*coords.T)
>>> euclidean_median(geoms)
<POINT (53.518 49.657)>