.. _auto_curves_project_line_to_plane:

*PROJECT THE LINE IN 3D FORMED BETWEEN TWO-POINTS ONTO A PLANE PASSING THROUGH P1*
==================================================================================

Projects the 3D line segment formed between two points (P1 and P2) onto a specified plane passing through P1, then computes the angle of that projected line. Use this worker when you need to measure the planar angle of a spatial line — for example, tracking limb or component rotation in a crash event within a chosen projection plane.

When to use
-----------

Classification: **process**.

Tagged: ``3d``, ``angle``, ``degrees``, ``incremental``, ``line``, ``plane``, ``project``, ``projection``.

Inputs
------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20 20 20

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - P1 XYZ
     - p1xy_z
     - vector
     - —
     - 
     - 3-component XYZ position vector for the first point (P1), which also defines the origin of the projection plane; provide as [x, y, z] in model length units.
   * - P2 XYZ
     - p2xy_z
     - vector
     - —
     - 
     - 3-component XYZ position vector for the second point (P2) that, together with P1, defines the line to be projected; provide as [x, y, z] in model length units.
   * - Measurement Type
     - measurement_type
     - select
     - total
     - 
     - Controls whether the output angle is the cumulative total rotation from the initial orientation ('total') or the frame-to-frame incremental change ('incremental'); defaults to 'total'.
   * - Plane
     - plane
     - select
     - yz
     - 
     - The plane onto which the P1→P2 line is projected before computing the angle; currently only 'yz' (the YZ plane) is supported; defaults to 'yz'.
   * - Units
     - units
     - fixed
     - deg
     - 
     - Angular unit for the output angle — 'deg' for degrees or 'radians' for radians; fixed at 'deg' by default.

Outputs
-------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20

   * - Label
     - ID
     - Type
     - Description
   * - curves_project_line_to_plane_output_1
     - curves_project_line_to_plane_output_1
     - vector
     - Time-history vector of the projected line's angle on the specified plane, expressed in the selected units (degrees or radians); each element corresponds to one input time step.

Disciplines
-----------

- data.curve.transform
- engineering.crash.dynamics
- engineering.multibody

Runnable example
----------------

A runnable example is registered for this worker. Open the example workflow on the d3VIEW canvas: `/api/workflow/example?id=curves_project_line_to_plane <https://www.d3view.com/api/workflow/example?id=curves_project_line_to_plane>`_

.. raw:: html

   <hr style="margin-top:2em">
   <p style="font-size:11px;color:#888">
   Auto-generated from <code>transformation</code> schema. Worker id: <code>curves_project_line_to_plane</code>. Schema hash: <code>a16797f0a33c</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>