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
-
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