.. _auto_injury_star_rating:

*COMPUTE THE OCCUPANT INJURY STAR-RATING BASED ON THE HICD AND PEAK VALUE SOF CHEST, FEMUR AND NECK VALUES*
===========================================================================================================

Computes the occupant injury STAR rating from a set of peak injury criteria — HICd, chest deflection, femur load, and neck loads (NIJ, tension, compression) — for a specified dummy type and unit system. Use this worker to roll up individual biomechanical peak values into a single NCAP-style star-rating score for occupant safety assessment.

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

Classification: **process**.

Tagged: ``H3-5``, ``H3-50``, ``HICd``, ``NCAP``, ``chest_deflection``, ``femur_load``, ``injury_criteria``, ``neck_NIJ``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - HICd
     - hi_cd
     - scalar
     - —
     - 
     - Head Injury Criterion (HICd) scalar value (dimensionless); computed from head acceleration time history — leave null if head injury is not part of the rating scenario.
   * - Peak Chest Deflection in mm
     - peak_chest_deflectioninmm
     - scalar
     - —
     - 
     - Peak chest deflection in millimetres (mm); maximum thoracic compression recorded during the crash event — leave null if chest injury is not evaluated.
   * - Peak Femur Load in kN
     - peak_femur_loadink_n
     - scalar
     - —
     - 
     - Peak femur compressive load in kilonewtons (kN); maximum axial force measured at the femur load cell — leave null if femur injury is not evaluated.
   * - Peak Neck NIJ in kN
     - peak_neck_ni_jink_n
     - scalar
     - —
     - 
     - Peak Neck Injury Index (NIJ) value in kN (normalised combined neck load/moment); leave null if neck NIJ is not part of the rating.
   * - Peak Neck Tension in kN
     - peak_neck_tensionink_n
     - scalar
     - —
     - 
     - Peak neck tensile force in kilonewtons (kN); maximum upper-neck tension recorded during the event — leave null if neck tension is not evaluated.
   * - Peak Neck Compression in kN
     - peak_neck_compressionink_n
     - scalar
     - —
     - 
     - Peak neck compressive force in kilonewtons (kN); maximum upper-neck compression recorded during the event — leave null if neck compression is not evaluated.
   * - Occupant Type
     - occupant_type
     - string
     - H3-5
     - 
     - Dummy family selector — 'H3-5' for the 5th-percentile Hybrid III female and 'H3-50' for the 50th-percentile male; defaults to 'H3-5' and governs the injury-limit thresholds applied in the rating algorithm.
   * - Unit System
     - unit_system
     - string
     - mm-kN-ms
     - 
     - Unit system used for all input scalars; select 'mm-kN-ms' (millimetre / kilonewton / millisecond) or 'mm-N-sec' (millimetre / newton / second) to ensure correct dimensional scaling inside the rating function — defaults to 'mm-kN-ms'.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - injury_star_rating_output_1
     - injury_star_rating_output_1
     - scalar
     - Computed occupant injury STAR rating (numeric scalar, typically 1–5); aggregated score derived from all supplied peak injury criteria against the thresholds for the selected dummy type and unit system.

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

- engineering.crash.occupant_safety

.. raw:: html

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