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