Point (hwx.common.math)

A mathematical representation of a point in 3D space.

Public Methods

static planeFromPoints (pt1, pt2, pt3)

along (self, towards, distance)

distance (self, x, y=None, z=None)

distanceTo (self, x, y=None, z=None)

distanceToPlane (self, a, b=None, c=None, d=None)

midpt (self, x, y=None, z=None)

Method Details

static planeFromPoints(pt1, pt2, pt3)

Computes the plane defined by the three points.

param pt1:The first point. type pt1:Point param pt2:The second point. type pt2:Point param pt3:The third point. type pt3:Point returns:The constants of the a parametric plane equation. rtype:tuple

along(self, towards, distance)

Computes the point along the line segment.

Defined by self and ‘towards’, at ‘distance’ from self.

param towards:The end point. type towards:Point param distance:The distance from the Point defined in self. type distance:float returns:The newly created point. rtype:Point

distance(self, x, y=None, z=None)

Computes the distance to the point defined by x, y, z.

If y is None, x is assumed to be a point (or list).

param x:The x coordinate or a point. type x:Union[float, list[float], Point] param y:The y coordinate. type y:float param z:The z coordinate. type z:float returns:The distance. rtype:float

distanceTo(self, x, y=None, z=None)

Computes the distance to the point defined by x, y, z.

If y is None, x is assumed to be a point (or list).

param x:The x coordinate or a point. type x:Union[float, list[float], Point] param y:The y coordinate. type y:float param z:The z coordinate. type z:float returns:The distance. rtype:float

distanceToPlane(self, a, b=None, c=None, d=None)

Computes the distance to the parametric plane.

The parametric plane is given by the equation is ax + by + cz + d = 0.

If b is None, a is assumed to be a list.

param a:The constant ‘a’ or a list of all constants. type a:Union[float, list, list[float]] param b:The constant ‘b’. type b:float param c:The constant ‘c’. type c:float param d:The constant ‘d’. type d:float returns:The distance. rtype:float

midpt(self, x, y=None, z=None)

Computes the middle point of the line segment between self and the point defined by x, y, z.

If y is None, x is assumed to be a Point (or list).

param x:The x coordinate or a Point. type x:Union[float, Point, list[float]] param y:The y coordinate. type y:float param z:The z coordinate. type z:float returns:The middle point. rtype:Point