weldx.transformations.orientation_point_plane#

weldx.transformations.orientation_point_plane(point, p_a, p_b, p_c)#

Determine a points orientation relative to an arbitrary plane.

The side is defined by the winding order of the triangle ‘A - B - C’. When looking at it from the left-hand side, the ordering is clockwise and counter-clockwise when looking from the right-hand side.

The function returns 1 if the point lies left of the plane, -1 if it is on the right and 0 if it lies on the plane.

Note, that this function is not appropriate to check if a point lies on a plane since it has no tolerance to compensate for numerical errors.

Parameters:
  • point – Point

  • p_a – First point of the triangle ‘A - B - C’.

  • p_b – Second point of the triangle ‘A - B - C’.

  • p_c – Third point of the triangle ‘A - B - C’.

Returns:

1, -1 or 0 (see description)

Return type:

int