.. _auto_pedpro_measure_metrics:

*PEDESTRIAN PROTECTION MEASURE METRICS*
=======================================

For each target impact position, measures the distance to the nearest hood connection and the clearance under the hood (straight down and along the impact direction), recording the part each clearance ray hits and its Young's modulus.

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

Tagged: ``pedestrian_protection``, ``pedpro``, ``clearance``, ``connection``, ``cnrb``, ``geometry``, ``ls-dyna``, ``post_processing``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Vehicle / hood model
     - model_file
     - file
     - —
     - ✓
     - Baseline or vehicle LS-DYNA deck. Accepts a single file name or a comma-separated list of the deck plus its include files (e.g. "main.k,part1.k,part2.k"); all listed files are staged together and the main input file is detected automatically. Optional when a Simulation is selected.
   * - Target positions
     - target_positions
     - dataset
     - —
     - ✓
     - Dataset of target impact positions (x, y, z, name, optional angle).
   * - Target positions column map
     - target_positions_col_map
     - mapper
     - —
     - 
     - Maps dataset columns to x, y, z, name and an optional angle.
   * - Hood part ids
     - hood_part_ids
     - text
     - —
     - 
     - Comma-separated hood part ids. Use this and/or the name pattern.
   * - Hood part name pattern
     - hood_part_name_pattern
     - text
     - —
     - 
     - Match against *PART titles to select hood parts.
   * - Impact direction (x,y,z)
     - impact_direction
     - text
     - —
     - 
     - Global fallback impact direction vector, e.g. 0,0,-1. Used when the positions dataset has no angle column.
   * - Windshield part id
     - windshield_part_id
     - text
     - —
     - 
     - Optional. Reduces the clearance search to parts forward of this part; the front/rear axis is auto-detected from the hood vs windshield.
   * - Parser type
     - use_c_extractor
     - select
     - auto
     - 
     - Auto (recommended) parses small decks in-process and automatically switches to the accelerated parser for large full-vehicle decks, avoiding memory limits. Default always parses in-process. Fast always uses the accelerated parser. Fast/Auto fall back to in-process if the accelerated parser is unavailable.
   * - Head-form diameter
     - head_impactor_diameter
     - text
     - 0
     - 
     - Optional. Diameter of the head-form; when > 0 the clearance is cast over a disc of that radius around each point and aggregated. 0 = single ray at the point.
   * - Clearance aggregation
     - clearance_aggregation
     - select
     - min
     - 
     - How to combine the disc rays when a head-form diameter is set.
   * - Clearance target part ids
     - clearance_target_part_ids
     - text
     - —
     - 
     - Optional. Comma-separated part ids to measure the clearance TO. When set, the ray reports the first of these parts below the hood (skipping everything else). Leave blank to measure to the first non-hood part.
   * - Clearance target part name
     - clearance_target_part_name_pattern
     - text
     - —
     - 
     - Optional. Name substring of the part(s) to measure the clearance TO (e.g. 'EngineCover'). Alternative to target part ids.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Metrics
     - metrics
     - dataset
     - One row per target: x,y,z, min connection distance, and the -z and impact-direction clearances with the part hit and its Young's modulus.

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

- cae.solver
- engineering.crash.occupant_safety
- platform.post_processing

.. raw:: html

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