.. _auto_lsdyna_atd_injury_analyzer:

*LSDYNA ATD INJURY ANALYZER (NCAP / FMVSS SCORING)*
===================================================

Reads binout NODOUT / SECFORC / DEFORC for an LS-DYNA simulation, auto-detects dummy (ATD) channels by label substring (head, neck, chest, femur, tibia, pelvis), and scores standard injury criteria — HIC15, head 3 ms clip, BrIC, Nij, upper-neck tension, chest deflection, chest 3 ms clip, femur axial force, tibia index, tibia compression, pelvis lateral force, viscous criterion. Each scored row carries the measured value, peak time, and pass/fail + star-rating against US-NCAP / Euro-NCAP / C-NCAP / FMVSS208 thresholds curated in injury_protocols.json. Drives the Response Extractor's Injury tab.

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

Tagged: ``atd``, ``binout``, ``bric``, ``chest_deflection``, ``c_ncap``, ``crash``, ``dummy``, ``euro_ncap``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Simulation
     - simulation_id
     - remote_lookup
     - —
     - 
     - Reference to the LS-DYNA simulation whose binout will be scored.
   * - Dummy / ATD model
     - dummy_type
     - string
     - HIII_50M
     - 
     - Anthropometric Test Device (dummy) family used for the threshold table lookup.
   * - Acceleration units
     - acceleration_units
     - string
     - g
     - 
     - Acceleration units in the binout nodout channels. Used to normalize head / chest acceleration channels to g before applying HIC and 3 ms clip criteria.
   * - Criteria filter (CSV)
     - criteria_id_csv
     - text
     - —
     - 
     - Optional comma-separated list of criterion ids (HIC15, Nij, CHEST_D, FEMUR_FZ, ...) to score. Empty = run every criterion in injury_protocols.json.
   * - Channel override (CSV)
     - channel_override_csv
     - text
     - —
     - 
     - Explicit criterion-to-channel-id mapping for models that don't label dummy channels. Format: one line per criterion as CRITERION_ID=id1,id2,... (e.g. HIC15=3001235 then NECK_FZ_TENS=2500003 then FEMUR_FZ=2500004,2500005). Each id is taken literally from the criterion's source branch.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Scored ATD Injury Criteria
     - injury_rows
     - dataset
     - Per-criterion / per-channel rows: criterion_id, criterion, body_region, channel_id, channel_label, source, mapping (auto/override), measured, measured_units, peak_time, best_threshold, dummy, and a protocols map of {protocol_id: {threshold, ratio, pass, star}}.
   * - Summary
     - summary
     - dataset
     - {dummy, criteria_count, overshoot_count, channels_by_region, protocol_list}.
   * - Protocols Reference
     - protocols
     - dataset
     - The protocols dictionary from injury_protocols.json (id, label, agency, tests) for the UI to render the protocol picker.
   * - Criteria Catalog
     - criteria_catalog
     - dataset
     - Flat list of every criterion (id, label, body_region, source, channel_components, output_units, expected_patterns) so the Mapper UI can render rows even when auto-detect found no channels.
   * - Branch Catalog
     - branch_catalog
     - dataset
     - For each binout branch present, {ids: {id->label}, components: [...]}. Lets the Mapper UI populate ID dropdowns scoped to each criterion's source branch.

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

- cae.postprocessing.extraction
- cae.postprocessing.response
- engineering.safety.atd
- engineering.safety.injury_criteria
- engineering.safety.ncap

.. raw:: html

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