.. _auto_curves_intrusion_local:

*COMPUTE THE INTRUSION OF TWO GLOBAL POINTS IN LOCAL SYSTEM*
============================================================

Computes the intrusion (relative displacement) between two global points transformed into a local coordinate system defined by three reference nodes. Use this worker to extract crush/intrusion measurements along a specified axis within a body-fixed or tracking reference frame from time-history coordinate curves.

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

Classification: **process**.

Tagged: ``coordinate_transform``, ``crush``, ``global_to_local``, ``intrusion``, ``local_coordinate_system``, ``lsdyna``, ``reference_frame``, ``relative_displacement``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Reference Origin X Y Z Coord Curves
     - reference_origin_xyz_coord_curves
     - vector
     - —
     - 
     - Time-history curves for the X, Y, Z coordinates (mm) of the local coordinate system origin node (Node 1); defines the origin of the local frame at each time step.
   * - Reference Node2 X Y Z Coord Curves
     - reference_node2xyz_coord_curves
     - vector
     - —
     - 
     - Time-history curves for the X, Y, Z coordinates (mm) of the second reference node (Node 2); used together with Node 1 to define the primary axis of the local frame.
   * - Reference Node3 X Y Z Coord Curves
     - reference_node3xyz_coord_curves
     - vector
     - —
     - 
     - Time-history curves for the X, Y, Z coordinates (mm) of the third reference node (Node 3); completes the three-point definition of the local coordinate system plane.
   * - Global Point 1 XYZ Curves
     - global_point1xyz_curves
     - vector
     - —
     - 
     - Time-history curves for the X, Y, Z global coordinates (mm) of the first measurement point whose displacement is to be tracked in the local frame.
   * - Global Point 2 XYZ Curves
     - global_point2xyz_curves
     - vector
     - —
     - 
     - Time-history curves for the X, Y, Z global coordinates (mm) of the second measurement point; intrusion is computed as the relative displacement between Point 1 and Point 2 in the local frame.
   * - Reference System
     - reference_system
     - local_fixed
     - coord
     - 
     - Coordinate transformation mode: 'local_fixed' uses the initial frame orientation throughout, 'local_translate' follows translation only, 'local_rotate_translate' tracks both rotation and translation, and 'no_transform' skips transformation; defaults to 'local_fixed'.
   * - Axis
     - axis
     - string
     - x
     - 
     - Local axis along which intrusion is measured ('x', 'y', or 'z'); defaults to 'x'.
   * - Coord Orientation Type
     - coord_orientation_type
     - string
     - lsdyna
     - 
     - 
   * - return_type
     - return_type
     - string
     - length
     - 
     - 

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curves_intrusion_local_output_1
     - curves_intrusion_local_output_1
     - vector
     - Time-history curve of the intrusion (relative displacement or length, in mm) between the two global points projected onto the specified local axis.

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

- data.curve.pair
- data.curve.transform
- data.units
- engineering.crash.dynamics

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

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

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