point_direction_to_pluecker_linepoint_direction_to_pluecker_linePointDirectionToPlueckerLinePointDirectionToPlueckerLinepoint_direction_to_pluecker_linepoint_direction_to_pluecker_line
Short description
point_direction_to_pluecker_linepoint_direction_to_pluecker_linePointDirectionToPlueckerLinePointDirectionToPlueckerLinepoint_direction_to_pluecker_linepoint_direction_to_pluecker_line — Convert a 3D line given by a point and a direction to Plücker
coordinates.
Signature
point_direction_to_pluecker_line( point3d.x PointX, point3d.y PointY, point3d.z PointZ, point3d.x DirectionX, point3d.y DirectionY, point3d.z DirectionZ, out point3d.x LineDirectionX, out point3d.y LineDirectionY, out point3d.z LineDirectionZ, out point3d.x LineMomentX, out point3d.y LineMomentY, out point3d.z LineMomentZ )point_direction_to_pluecker_line( : : PointX, PointY, PointZ, DirectionX, DirectionY, DirectionZ : LineDirectionX, LineDirectionY, LineDirectionZ, LineMomentX, LineMomentY, LineMomentZ )void PointDirectionToPlueckerLine( const HTuple& PointX, const HTuple& PointY, const HTuple& PointZ, const HTuple& DirectionX, const HTuple& DirectionY, const HTuple& DirectionZ, HTuple* LineDirectionX, HTuple* LineDirectionY, HTuple* LineDirectionZ, HTuple* LineMomentX, HTuple* LineMomentY, HTuple* LineMomentZ )static void HOperatorSet.PointDirectionToPlueckerLine( HTuple pointX, HTuple pointY, HTuple pointZ, HTuple directionX, HTuple directionY, HTuple directionZ, out HTuple lineDirectionX, out HTuple lineDirectionY, out HTuple lineDirectionZ, out HTuple lineMomentX, out HTuple lineMomentY, out HTuple lineMomentZ )def point_direction_to_pluecker_line( point_x: MaybeSequence[float], point_y: MaybeSequence[float], point_z: MaybeSequence[float], direction_x: MaybeSequence[float], direction_y: MaybeSequence[float], direction_z: MaybeSequence[float] ) -> Tuple[Sequence[float], Sequence[float], Sequence[float], Sequence[float], Sequence[float], Sequence[float]]
def point_direction_to_pluecker_line_s( point_x: MaybeSequence[float], point_y: MaybeSequence[float], point_z: MaybeSequence[float], direction_x: MaybeSequence[float], direction_y: MaybeSequence[float], direction_z: MaybeSequence[float] ) -> Tuple[float, float, float, float, float, float]Herror point_direction_to_pluecker_line( double PointX, double PointY, double PointZ, double DirectionX, double DirectionY, double DirectionZ, double* LineDirectionX, double* LineDirectionY, double* LineDirectionZ, double* LineMomentX, double* LineMomentY, double* LineMomentZ )
Herror T_point_direction_to_pluecker_line( const Htuple PointX, const Htuple PointY, const Htuple PointZ, const Htuple DirectionX, const Htuple DirectionY, const Htuple DirectionZ, Htuple* LineDirectionX, Htuple* LineDirectionY, Htuple* LineDirectionZ, Htuple* LineMomentX, Htuple* LineMomentY, Htuple* LineMomentZ )
static void HMisc::PointDirectionToPlueckerLine( const HTuple& PointX, const HTuple& PointY, const HTuple& PointZ, const HTuple& DirectionX, const HTuple& DirectionY, const HTuple& DirectionZ, HTuple* LineDirectionX, HTuple* LineDirectionY, HTuple* LineDirectionZ, HTuple* LineMomentX, HTuple* LineMomentY, HTuple* LineMomentZ )
static void HMisc::PointDirectionToPlueckerLine( double PointX, double PointY, double PointZ, double DirectionX, double DirectionY, double DirectionZ, double* LineDirectionX, double* LineDirectionY, double* LineDirectionZ, double* LineMomentX, double* LineMomentY, double* LineMomentZ )
static void HMisc.PointDirectionToPlueckerLine( HTuple pointX, HTuple pointY, HTuple pointZ, HTuple directionX, HTuple directionY, HTuple directionZ, out HTuple lineDirectionX, out HTuple lineDirectionY, out HTuple lineDirectionZ, out HTuple lineMomentX, out HTuple lineMomentY, out HTuple lineMomentZ )
static void HMisc.PointDirectionToPlueckerLine( double pointX, double pointY, double pointZ, double directionX, double directionY, double directionZ, out double lineDirectionX, out double lineDirectionY, out double lineDirectionZ, out double lineMomentX, out double lineMomentY, out double lineMomentZ )
Description
point_direction_to_pluecker_linePointDirectionToPlueckerLine converts the 3D line given
by the point (PointXpointXpoint_x, PointYpointYpoint_y, PointZpointZpoint_z) and
the direction (DirectionXdirectionXdirection_x, DirectionYdirectionYdirection_y,
DirectionZdirectionZdirection_z) to 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).
All input tuples must be of same length.
Let \(\mathbf{P}\) denote the point
(PointXpointXpoint_x, PointYpointYpoint_y, PointZpointZpoint_z)
and \(\mathbf{D}\) the direction
(DirectionXdirectionXdirection_x, DirectionYdirectionYdirection_y, DirectionZdirectionZdirection_z) of the line.
To compute the line direction \(\mathbf{L}\),
the length \(\|\mathbf{D}\|\) of the vector \(\mathbf{D}\)
is computed.
If \(\|\mathbf{D}\| = 0\), the direction \(\mathbf{D}\)
does not define a line and an error is returned.
The further calculations to Plücker coordinates are given in
points_to_pluecker_linePointsToPlueckerLine.
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 point on the line.
PointYpointYpoint_y (input_control) point3d.y(-array) → (real)(real)HTuple (double)HTuple (double)MaybeSequence[float]Htuple (double)
Y coordinates of the point on the line.
PointZpointZpoint_z (input_control) point3d.z(-array) → (real)(real)HTuple (double)HTuple (double)MaybeSequence[float]Htuple (double)
Z coordinates of the point on the line.
DirectionXdirectionXdirection_x (input_control) point3d.x(-array) → (real)(real)HTuple (double)HTuple (double)MaybeSequence[float]Htuple (double)
X coordinates of the direction of the line.
DirectionYdirectionYdirection_y (input_control) point3d.y(-array) → (real)(real)HTuple (double)HTuple (double)MaybeSequence[float]Htuple (double)
Y coordinates of the direction of the line.
DirectionZdirectionZdirection_z (input_control) point3d.z(-array) → (real)(real)HTuple (double)HTuple (double)MaybeSequence[float]Htuple (double)
Z coordinates of the direction of the line.
LineDirectionXlineDirectionXline_direction_x (output_control) point3d.x(-array) → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)
X component of the direction vector of the line.
LineDirectionYlineDirectionYline_direction_y (output_control) point3d.y(-array) → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)
Y component of the direction vector of the line.
LineDirectionZlineDirectionZline_direction_z (output_control) point3d.z(-array) → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)
Z component of the direction vector of the line.
LineMomentXlineMomentXline_moment_x (output_control) point3d.x(-array) → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)
X component of the moment vector of the line.
LineMomentYlineMomentYline_moment_y (output_control) point3d.y(-array) → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)
Y component of the moment vector of the line.
LineMomentZlineMomentZline_moment_z (output_control) point3d.z(-array) → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)
Z component of the moment vector of the line.
Combinations with other operators
Combinations
Possible successors
distance_point_pluecker_lineDistancePointPlueckerLine, point_pluecker_line_to_hom_mat3dPointPlueckerLineToHomMat3d
Alternatives
points_to_pluecker_linePointsToPlueckerLine
See also
pluecker_line_to_point_directionPlueckerLineToPointDirection
Module
Foundation