.. _auto_curves_iihsintrusion:

*COMPUTE THE IIHS INTRUSION BASED ON THE SEAT AND THE MEASURING POINT*
======================================================================

Computes the IIHS intrusion metric by calculating the displacement of a structural measuring point relative to a moving seat reference frame. Given time-history coordinate curves for both the seat and the measurement node, it returns the resultant intrusion curve used in IIHS side/small-overlap crashworthiness evaluations.

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

Classification: **process**.

Tagged: ``coordinate_transform``, ``crash_kinematics``, ``iihs``, ``intrusion``, ``seat_reference``, ``side_impact``, ``small_overlap``, ``time_history``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Seat X
     - seat_x
     - vector
     - —
     - 
     - Time-history curve of the seat reference point X coordinate (mm or model units); used as the moving reference frame origin in the X direction — required unless the seat remains stationary.
   * - Seat Y
     - seat_y
     - vector
     - —
     - 
     - Time-history curve of the seat reference point Y coordinate (mm or model units); used as the moving reference frame origin in the Y direction — required unless the seat remains stationary.
   * - Seat Z
     - seat_z
     - vector
     - —
     - 
     - Time-history curve of the seat reference point Z coordinate (mm or model units); used as the moving reference frame origin in the Z direction — required unless the seat remains stationary.
   * - Location X
     - location_x
     - vector
     - —
     - 
     - Time-history curve of the structural measurement node X coordinate (mm or model units); represents the intrusion measurement point position in X extracted from the simulation (e.g., binout nodout).
   * - Location Y
     - location_y
     - vector
     - —
     - 
     - Time-history curve of the structural measurement node Y coordinate (mm or model units); represents the intrusion measurement point position in Y extracted from the simulation.
   * - Location Z
     - location_z
     - vector
     - —
     - 
     - Time-history curve of the structural measurement node Z coordinate (mm or model units); represents the intrusion measurement point position in Z extracted from the simulation.
   * - Location Type
     - location_type
     - scalar
     - lower-hinge
     - 
     - Node Location
   * - X Is Outward When The Difference Is
     - xisoutwardwhenthedifferenceis
     - scalar
     - neg
     - 
     - X is outward when the difference is
   * - Y Is Outward When The Difference Is
     - yisoutwardwhenthedifferenceis
     - scalar
     - neg
     - 
     - Y is outward when the difference is

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curves_iihsintrusion_output_1
     - curves_iihsintrusion_output_1
     - vector
     - Resultant IIHS intrusion time-history curve (mm or model units) representing the displacement of the measurement node relative to the seat reference frame; peak value is the reportable IIHS intrusion KPI.

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

- cae.postprocessing.response
- data.curve.pair
- engineering.crash.dynamics
- engineering.crash.occupant_safety

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

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

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