Skip to content

distance_point_pluecker_linedistance_point_pluecker_lineDistancePointPlueckerLineDistancePointPlueckerLinedistance_point_pluecker_linedistance_point_pluecker_line🔗

Short description🔗

distance_point_pluecker_linedistance_point_pluecker_lineDistancePointPlueckerLineDistancePointPlueckerLinedistance_point_pluecker_linedistance_point_pluecker_line — Calculate the distance between a 3D point and a 3D line given by Plücker coordinates.

Signature🔗

distance_point_pluecker_line( point3d.x PointX, point3d.y PointY, point3d.z PointZ, point3d.x LineDirectionX, point3d.y LineDirectionY, point3d.z LineDirectionZ, point3d.x LineMomentX, point3d.y LineMomentY, point3d.z LineMomentZ, out real Distance )distance_point_pluecker_line( : : PointX, PointY, PointZ, LineDirectionX, LineDirectionY, LineDirectionZ, LineMomentX, LineMomentY, LineMomentZ : Distance )void DistancePointPlueckerLine( const HTuple& PointX, const HTuple& PointY, const HTuple& PointZ, const HTuple& LineDirectionX, const HTuple& LineDirectionY, const HTuple& LineDirectionZ, const HTuple& LineMomentX, const HTuple& LineMomentY, const HTuple& LineMomentZ, HTuple* Distance )static void HOperatorSet.DistancePointPlueckerLine( HTuple pointX, HTuple pointY, HTuple pointZ, HTuple lineDirectionX, HTuple lineDirectionY, HTuple lineDirectionZ, HTuple lineMomentX, HTuple lineMomentY, HTuple lineMomentZ, out HTuple distance )def distance_point_pluecker_line( point_x: MaybeSequence[float], point_y: MaybeSequence[float], point_z: MaybeSequence[float], line_direction_x: MaybeSequence[Union[float, int]], line_direction_y: MaybeSequence[Union[float, int]], line_direction_z: MaybeSequence[Union[float, int]], line_moment_x: MaybeSequence[Union[float, int]], line_moment_y: MaybeSequence[Union[float, int]], line_moment_z: MaybeSequence[Union[float, int]] ) -> Sequence[float]

def distance_point_pluecker_line_s( point_x: MaybeSequence[float], point_y: MaybeSequence[float], point_z: MaybeSequence[float], line_direction_x: MaybeSequence[Union[float, int]], line_direction_y: MaybeSequence[Union[float, int]], line_direction_z: MaybeSequence[Union[float, int]], line_moment_x: MaybeSequence[Union[float, int]], line_moment_y: MaybeSequence[Union[float, int]], line_moment_z: MaybeSequence[Union[float, int]] ) -> floatHerror distance_point_pluecker_line( double PointX, double PointY, double PointZ, double LineDirectionX, double LineDirectionY, double LineDirectionZ, double LineMomentX, double LineMomentY, double LineMomentZ, double* Distance )

Herror T_distance_point_pluecker_line( const Htuple PointX, const Htuple PointY, const Htuple PointZ, const Htuple LineDirectionX, const Htuple LineDirectionY, const Htuple LineDirectionZ, const Htuple LineMomentX, const Htuple LineMomentY, const Htuple LineMomentZ, Htuple* Distance )

static HTuple HMisc::DistancePointPlueckerLine( const HTuple& PointX, const HTuple& PointY, const HTuple& PointZ, const HTuple& LineDirectionX, const HTuple& LineDirectionY, const HTuple& LineDirectionZ, const HTuple& LineMomentX, const HTuple& LineMomentY, const HTuple& LineMomentZ )

static double HMisc::DistancePointPlueckerLine( double PointX, double PointY, double PointZ, double LineDirectionX, double LineDirectionY, double LineDirectionZ, double LineMomentX, double LineMomentY, double LineMomentZ )

static HTuple HMisc.DistancePointPlueckerLine( HTuple pointX, HTuple pointY, HTuple pointZ, HTuple lineDirectionX, HTuple lineDirectionY, HTuple lineDirectionZ, HTuple lineMomentX, HTuple lineMomentY, HTuple lineMomentZ )

static double HMisc.DistancePointPlueckerLine( double pointX, double pointY, double pointZ, double lineDirectionX, double lineDirectionY, double lineDirectionZ, double lineMomentX, double lineMomentY, double lineMomentZ )

Description🔗

distance_point_pluecker_lineDistancePointPlueckerLine calculates the orthogonal distance between 3D points and 3D lines. The result is returned in Distancedistancedistance. The input tuples can define 1 or n points \(\mathbf{P}\) and lines, respectively. The points are specified by (PointXpointXpoint_x, PointYpointYpoint_y, PointZpointZpoint_z). The lines are given in Plücker coordinates \(\mathbf{L}\) (LineDirectionXlineDirectionXline_direction_x, LineDirectionYlineDirectionYline_direction_y, LineDirectionZlineDirectionZline_direction_z) and \(\mathbf{M}\) (LineMomentXlineMomentXline_moment_x, LineMomentYlineMomentYline_moment_y, LineMomentZlineMomentZline_moment_z). For the definition of Plücker coordinates, see [``Solving machine vision tasks > Machine vision basics

Transformations > 3D Transformations Dual quaternions’‘](https://docs.mvtec.com/hdevelopevo/26.11/content/mvtasks/machine_vision_basics/transformations/3d/dual_quaternions/index.html).

Let \(\mathbf{P}\) denote the point (PointXpointXpoint_x, PointYpointYpoint_y, PointZpointZpoint_z), \(\mathbf{L}\) the direction (LineDirectionXlineDirectionXline_direction_x, LineDirectionYlineDirectionYline_direction_y, LineDirectionZlineDirectionZline_direction_z), and \(\mathbf{M}\) the moment (LineMomentXlineMomentXline_moment_x, LineMomentYlineMomentYline_moment_y, LineMomentZlineMomentZline_moment_z) of the Plücker line. Furthermore, let \(D\) denote the distance Distancedistancedistance. Then, \(D = \| \mathbf{P}\times\mathbf{L}-\mathbf{M} \|\), where \(\times\) denotes the cross product of two vectors.

Execution information🔗

Execution information
  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).

  • Multithreading scope: global (may be called from any thread).

  • Processed without parallelization.

Parameters🔗

PointXpointXpoint_x (input_control) point3d.x(-array) → (real)(real)HTuple (double)HTuple (double)MaybeSequence[float]Htuple (double)

X coordinates of the original points.

PointYpointYpoint_y (input_control) point3d.y(-array) → (real)(real)HTuple (double)HTuple (double)MaybeSequence[float]Htuple (double)

Y coordinates of the original points.

PointZpointZpoint_z (input_control) point3d.z(-array) → (real)(real)HTuple (double)HTuple (double)MaybeSequence[float]Htuple (double)

Z coordinates of the original points.

LineDirectionXlineDirectionXline_direction_x (input_control) point3d.x(-array) → (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)MaybeSequence[Union[float, int]]Htuple (double / Hlong)

X component of the direction vector of the corresponding line.

LineDirectionYlineDirectionYline_direction_y (input_control) point3d.y(-array) → (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)MaybeSequence[Union[float, int]]Htuple (double / Hlong)

Y component of the direction vector of the corresponding line.

LineDirectionZlineDirectionZline_direction_z (input_control) point3d.z(-array) → (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)MaybeSequence[Union[float, int]]Htuple (double / Hlong)

Z component of the direction vector of the corresponding line.

LineMomentXlineMomentXline_moment_x (input_control) point3d.x(-array) → (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)MaybeSequence[Union[float, int]]Htuple (double / Hlong)

X component of the moment vector of the corresponding line.

LineMomentYlineMomentYline_moment_y (input_control) point3d.y(-array) → (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)MaybeSequence[Union[float, int]]Htuple (double / Hlong)

Y component of the moment vector of the corresponding line.

LineMomentZlineMomentZline_moment_z (input_control) point3d.z(-array) → (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)MaybeSequence[Union[float, int]]Htuple (double / Hlong)

Z component of the moment vector of the corresponding line.

Distancedistancedistance (output_control) real(-array) → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)

Distance between the points and the lines.

Combinations with other operators🔗

Combinations

Possible predecessors

points_to_pluecker_linePointsToPlueckerLine, point_direction_to_pluecker_linePointDirectionToPlueckerLine

Alternatives

distance_point_lineDistancePointLine

See also

point_pluecker_line_to_hom_mat3dPointPlueckerLineToHomMat3d

Module🔗

Foundation