.. _auto_curves_iihsintrusion_disp_xyzgroup:

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

Computes IIHS intrusion displacement by differencing XYZ displacement curves from an average seat reference point and a cabin measuring location. Given a specified location type (e.g., lower-hinge, brake-pedal, upper-dash) and intrusion type (raw, cm, rounded, subtracted), it returns the resulting intrusion curve group for IIHS small-overlap or side-impact assessments.

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

Classification: **process**.

Tagged: ``crash``, ``curve_group``, ``displacement``, ``iihs``, ``intrusion``, ``occupant_space``, ``side_impact``, ``small_overlap``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Avg Seat XYZ Disp Group
     - avg_seat_xyz_disp_group
     - vector
     - —
     - 
     - Group of X, Y, Z displacement time-history curves representing the average seat reference point (mm vs. time); used as the baseline from which intrusion is measured. Accepts multiple curves (one per axis).
   * - Location XYZ Disp Group
     - location_xyz_disp_group
     - vector
     - —
     - 
     - Group of X, Y, Z displacement time-history curves for the specific cabin measuring point (mm vs. time); paired against the seat average to compute relative intrusion at the chosen location.
   * - Location Type
     - location_type
     - scalar
     - lower-hinge
     - 
     - Enumerated label identifying the structural measuring location (e.g., 'lower-hinge', 'brake-pedal', 'steering-column'); drives location-specific IIHS intrusion logic. Defaults to 'lower-hinge'.
   * - Intrusion Type
     - intrusion_type
     - scalar
     - raw
     - 
     - Specifies how the raw intrusion value is post-processed: 'raw' returns values as-is, 'cm' converts to centimetres, 'rounded_to_mm'/'rounded_to_cm' round accordingly, 'subtracted_x' removes the X-component, 'subtractedx_resultant' computes the resultant after X subtraction. Defaults to 'raw'.
   * - Measurement Type
     - measurement_type
     - scalar
     - raw
     - 
     - 

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curves_iihsintrusion_disp_xyzgroup_output_1
     - curves_iihsintrusion_disp_xyzgroup_output_1
     - vector
     - Resulting IIHS intrusion curve group (vector, mm or cm depending on intrusion_type) representing the relative displacement between the seat reference and the specified cabin measuring location over time.

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_disp_xyzgroup <https://www.d3view.com/api/workflow/example?id=curves_iihsintrusion_disp_xyzgroup>`_

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