environmentaltools.spatiotemporal.bme.coordinates_to_distance

environmentaltools.spatiotemporal.bme.coordinates_to_distance(pi, *args)

Compute distances between coordinate points.

Calculates pairwise distances for spatial (2D) or temporal (1D) coordinates, or distances from points to a reference location.

Parameters:

• pi (np.ndarray) – Coordinate array. Shape (n,) for temporal or (n, 2) for spatial coordinates.

• *args (tuple, optional) – Reference coordinates for computing distances to a single point. If provided, computes distances from all points in pi to this reference.

Returns:

dist – Distance matrix or array. If no args provided, returns symmetric distance matrix between all points. If args provided, returns distances to reference.

Return type:

np.ndarray or pd.DataFrame

Notes

• For spatial data (2D): Euclidean distance

• For temporal data (1D): Absolute difference

• Distance matrices are symmetric with zeros on diagonal