distance_point_line_sqrd_xy

compas.geometry.distance_point_line_sqrd_xy(point, line)[source]

Compute the squared distance between a point and a line lying in the XY-plane.

Parameters:
point[float, float] or [float, float, float] | compas.geometry.Point

XY(Z) coordinates of a 2D or 3D point (Z will be ignored).

line[point, point] | compas.geometry.Line

Line defined by two points.

Returns:
float

The squared distance between the point and the line.

Notes

This implementation computes the orthogonal squared distance from a point P to a line defined by points A and B as twice the area of the triangle ABP divided by the length of AB [1].

References

[1]

Wikipedia. Distance from a point to a line. Available at: https://en.wikipedia.org/wiki/Distance_from_a_point_to_a_line.