pysal.lib.cg.get_segment_point_dist

pysal.lib.cg.get_segment_point_dist(seg, pt)[source]

Returns the distance between a line segment and point and distance along the segment of the closest point on the segment to the point as a ratio of the length of the segment.

get_segment_point_dist(LineSegment, Point) -> (number, number)

Parameters:
seg : a line segment to compute distance from
pt : a point to compute distance from

Examples

>>> seg = LineSegment(Point((0, 0)), Point((10, 0)))
>>> pt = Point((5, 5))
>>> get_segment_point_dist(seg, pt)
(5.0, 0.5)
>>> pt2 = Point((0, 0))
>>> get_segment_point_dist(seg, pt2)
(0.0, 0.0)