.. _auto_curves_threepointangle:

*COMPUTE ANGLE FORMED BY THREE POINTS*
======================================

Computes the angle formed at a base (vertex) node by two arms extending to P1 and P2, using time-history XYZ coordinate curves in the global system. Supports both total angle and incremental (change) measurement, with output in degrees or radians. Use this worker to track joint or articulation angles over a simulation or test time history.

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

Classification: **process**.

Tagged: ``angle``, ``coordinates``, ``degrees``, ``geometry``, ``kinematics``, ``radians``, ``three_point_angle``, ``time_history``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Base XYZ
     - base_xy_z
     - vector
     - —
     - 
     - Time-history vector of XYZ coordinates (global system) for the vertex/origin node that forms the apex of the angle; accepts multiple curves — leave default (null) if the vertex is fixed at the origin.
   * - P1 XYZ
     - p1xy_z
     - vector
     - —
     - 
     - Time-history vector of XYZ coordinates (global system) for the first arm point P1; defines one ray of the angle emanating from the base node.
   * - P2 XYZ
     - p2xy_z
     - vector
     - —
     - 
     - Time-history vector of XYZ coordinates (global system) for the second arm point P2; defines the other ray of the angle emanating from the base node.
   * - Measurement Type
     - measurement_type
     - fixed
     - total
     - 
     - Selects whether the output is the absolute angle at each time step ('total') or the incremental change in angle relative to the initial value ('change'); defaults to 'total'.
   * - Units
     - units
     - fixed
     - deg
     - 
     - Output angular units — 'deg' for degrees or 'radians' for radians; defaults to 'deg'.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curves_threepointangle_output_1
     - curves_threepointangle_output_1
     - vector
     - Time-history curve of the computed angle (in the selected units — degrees or radians) formed at the base node between the vectors Base→P1 and Base→P2 at each time step.

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

- data.curve.transform
- data.signal_processing
- 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_threepointangle <https://www.d3view.com/api/workflow/example?id=curves_threepointangle>`_

.. 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_threepointangle</code>. Schema hash: <code>822bc129542c</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>