Skip to content

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๐Ÿ”—

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