points_to_pluecker_linepoints_to_pluecker_linePointsToPlueckerLinePointsToPlueckerLinepoints_to_pluecker_linepoints_to_pluecker_line
Short description
points_to_pluecker_linepoints_to_pluecker_linePointsToPlueckerLinePointsToPlueckerLinepoints_to_pluecker_linepoints_to_pluecker_line โ Convert a 3D line given by two points to Plรผcker coordinates.
Signature
points_to_pluecker_line( point3d.x Point1X, point3d.y Point1Y, point3d.z Point1Z, point3d.x Point2X, point3d.y Point2Y, point3d.z Point2Z, out point3d.x LineDirectionX, out point3d.y LineDirectionY, out point3d.z LineDirectionZ, out point3d.x LineMomentX, out point3d.y LineMomentY, out point3d.z LineMomentZ )points_to_pluecker_line( : : Point1X, Point1Y, Point1Z, Point2X, Point2Y, Point2Z : LineDirectionX, LineDirectionY, LineDirectionZ, LineMomentX, LineMomentY, LineMomentZ )void PointsToPlueckerLine( const HTuple& Point1X, const HTuple& Point1Y, const HTuple& Point1Z, const HTuple& Point2X, const HTuple& Point2Y, const HTuple& Point2Z, HTuple* LineDirectionX, HTuple* LineDirectionY, HTuple* LineDirectionZ, HTuple* LineMomentX, HTuple* LineMomentY, HTuple* LineMomentZ )static void HOperatorSet.PointsToPlueckerLine( HTuple point1X, HTuple point1Y, HTuple point1Z, HTuple point2X, HTuple point2Y, HTuple point2Z, out HTuple lineDirectionX, out HTuple lineDirectionY, out HTuple lineDirectionZ, out HTuple lineMomentX, out HTuple lineMomentY, out HTuple lineMomentZ )def points_to_pluecker_line( point_1x: MaybeSequence[float], point_1y: MaybeSequence[float], point_1z: MaybeSequence[float], point_2x: MaybeSequence[float], point_2y: MaybeSequence[float], point_2z: MaybeSequence[float] ) -> Tuple[Sequence[float], Sequence[float], Sequence[float], Sequence[float], Sequence[float], Sequence[float]]
def points_to_pluecker_line_s( point_1x: MaybeSequence[float], point_1y: MaybeSequence[float], point_1z: MaybeSequence[float], point_2x: MaybeSequence[float], point_2y: MaybeSequence[float], point_2z: MaybeSequence[float] ) -> Tuple[float, float, float, float, float, float]Herror points_to_pluecker_line( double Point1X, double Point1Y, double Point1Z, double Point2X, double Point2Y, double Point2Z, double* LineDirectionX, double* LineDirectionY, double* LineDirectionZ, double* LineMomentX, double* LineMomentY, double* LineMomentZ )
Herror T_points_to_pluecker_line( const Htuple Point1X, const Htuple Point1Y, const Htuple Point1Z, const Htuple Point2X, const Htuple Point2Y, const Htuple Point2Z, Htuple* LineDirectionX, Htuple* LineDirectionY, Htuple* LineDirectionZ, Htuple* LineMomentX, Htuple* LineMomentY, Htuple* LineMomentZ )
static void HMisc::PointsToPlueckerLine( const HTuple& Point1X, const HTuple& Point1Y, const HTuple& Point1Z, const HTuple& Point2X, const HTuple& Point2Y, const HTuple& Point2Z, HTuple* LineDirectionX, HTuple* LineDirectionY, HTuple* LineDirectionZ, HTuple* LineMomentX, HTuple* LineMomentY, HTuple* LineMomentZ )
static void HMisc::PointsToPlueckerLine( double Point1X, double Point1Y, double Point1Z, double Point2X, double Point2Y, double Point2Z, double* LineDirectionX, double* LineDirectionY, double* LineDirectionZ, double* LineMomentX, double* LineMomentY, double* LineMomentZ )
static void HMisc.PointsToPlueckerLine( HTuple point1X, HTuple point1Y, HTuple point1Z, HTuple point2X, HTuple point2Y, HTuple point2Z, out HTuple lineDirectionX, out HTuple lineDirectionY, out HTuple lineDirectionZ, out HTuple lineMomentX, out HTuple lineMomentY, out HTuple lineMomentZ )
static void HMisc.PointsToPlueckerLine( double point1X, double point1Y, double point1Z, double point2X, double point2Y, double point2Z, out double lineDirectionX, out double lineDirectionY, out double lineDirectionZ, out double lineMomentX, out double lineMomentY, out double lineMomentZ )
Description
points_to_pluecker_linePointsToPlueckerLine converts the 3D line given by the
two points (Point1Xpoint1Xpoint_1x, Point1Ypoint1Ypoint_1y, Point1Zpoint1Zpoint_1z)
and (Point2Xpoint2Xpoint_2x, Point2Ypoint2Ypoint_2y, Point2Zpoint2Zpoint_2z) 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 first point
(Point1Xpoint1Xpoint_1x, Point1Ypoint1Ypoint_1y, Point1Zpoint1Zpoint_1z)
and \(\mathbf{Q}\) the second point
(Point2Xpoint2Xpoint_2x, Point2Ypoint2Ypoint_2y, Point2Zpoint2Zpoint_2z) on the line.
To compute the line direction \(\mathbf{L}\), the
vector \(\mathbf{D} = \mathbf{Q} - \mathbf{P}\) and
its length \(\|\mathbf{D}\|\) are computed.
If \(\|\mathbf{D}\| = 0\), the points do not define a line
and an error is returned.
The line direction is given by
\(\mathbf{L} = \mathbf{D} / \|\mathbf{D}\|\).
The line moment is given by the cross product
\(\mathbf{M} = \mathbf{P} \times \mathbf{L}\).
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
Point1Xpoint1Xpoint_1x (input_control) point3d.x(-array) โ (real)(real)HTuple (double)HTuple (double)MaybeSequence[float]Htuple (double)
X coordinates of the first point on the line.
Point1Ypoint1Ypoint_1y (input_control) point3d.y(-array) โ (real)(real)HTuple (double)HTuple (double)MaybeSequence[float]Htuple (double)
Y coordinates of the first point on the line.
Point1Zpoint1Zpoint_1z (input_control) point3d.z(-array) โ (real)(real)HTuple (double)HTuple (double)MaybeSequence[float]Htuple (double)
Z coordinates of the first point on the line.
Point2Xpoint2Xpoint_2x (input_control) point3d.x(-array) โ (real)(real)HTuple (double)HTuple (double)MaybeSequence[float]Htuple (double)
X coordinates of the second point on the line.
Point2Ypoint2Ypoint_2y (input_control) point3d.y(-array) โ (real)(real)HTuple (double)HTuple (double)MaybeSequence[float]Htuple (double)
Y coordinates of the second point on the line.
Point2Zpoint2Zpoint_2z (input_control) point3d.z(-array) โ (real)(real)HTuple (double)HTuple (double)MaybeSequence[float]Htuple (double)
Z coordinates of the second point on 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 predecessors
get_line_of_sightGetLineOfSight
Possible successors
distance_point_pluecker_lineDistancePointPlueckerLine, point_pluecker_line_to_hom_mat3dPointPlueckerLineToHomMat3d
Alternatives
point_direction_to_pluecker_linePointDirectionToPlueckerLine
See also
pluecker_line_to_pointsPlueckerLineToPoints
Module
Foundation