.. _auto_pedpro_evaluator:

*PEDESTRIAN PROTECTION EVALUATOR*
=================================

Runs pedestrian protection (PedPro) LS-DYNA simulations by combining a vehicle baseline model (or pre-positioned inputs) with one or more impactor types (headform, lower leg, upper leg) at defined strike positions. Submits a batch of HPC jobs for each position and collects the resulting study and simulation records for downstream post-processing.

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

Tagged: ``pedestrian_impact``, ``batch_simulation``, ``headform``, ``hpc``, ``impactor``, ``lower_leg``, ``ls-dyna``, ``pedestrian_protection``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Study Name
     - study_name
     - text
     - PedPro Simulations
     - ✓
     - Human-readable label assigned to the PedPro simulation study; defaults to 'PedPro Simulations' and is used to group all submitted jobs.
   * - Impactor Type
     - impactor_type
     - select
     - headform
     - 
     - Selects the pedestrian impactor type to use — 'headform', 'lower_leg', or 'upper_leg' — which determines the impactor FE model and applicable injury criteria extracted during post-processing.
   * - Vehicle Input Files
     - main_input_files
     - file
     - —
     - ✓
     - Vehicle LS-DYNA input deck(s): upload multiple flat files or a single ZIP archive; if zipped, the main include file must contain the word 'main' in its filename.
   * - Input file type
     - input_file_type
     - select
     - baseline
     - 
     - Specifies how impactor positions are encoded in the uploaded files: 'baseline' (single model with embedded positions), 'positioned_folders' (ZIP with one sub-folder per position), or 'positioned_files' (individual pre-positioned decks).
   * - Impactor Positions
     - impactor_positions
     - dataset
     - —
     - 
     - Optional dataset supplying impactor strike positions (translations, direction cosines, rotation centre, angle) when 'baseline' input_file_type is selected; leave empty if positions are baked into the file structure.
   * - Impactor Position Mapper
     - impactor_positions_col_map
     - mapper
     - —
     - 
     - Column mapper that aligns dataset fields from impactor_positions to the required position schema (X/Y/Z-Translation, X/Y/Z-Cosine, X/Y/Z-Rotation-Center, Angle); must be configured whenever impactor_positions is supplied.
   * - Part and Sensors Map for Post processing
     - part_and_sensors_map
     - keyvalue
     - *(complex)*
     - ✓
     - Key-value map of LS-DYNA part IDs and sensor/load-cell IDs used during post-processing to extract contact, tracking-node, femur, and tibia responses; defaults cover a standard single-impactor model setup.
   * - Impactor Node Set Id
     - impactor_node_set_id
     - text
     - 1
     - 
     - Impactor node set id
   * - Impactor Transform Id
     - impactor_transform_id
     - text
     - 1
     - 
     - Impactor transform id
   * - Template ID
     - template_id
     - remote_lookup
     - —
     - 
     - 
   * - Project ID
     - project_id
     - remote_lookup
     - —
     - 
     - 
   * - Study ID
     - study_id
     - remote_lookup
     - —
     - 
     - 
   * - Saved HPC Config
     - saved_hpc_config
     - remote_lookup
     - —
     - 
     - 
   * - Run Baseline Only
     - baseline_only
     - select
     - yes
     - ✓
     - Option to run baseline or all positions
   * - Impactor Position file pattern
     - position_file_pattern
     - text
     - PedShot
     - 
     - Impactor Position File Name pattern. This file will be replaced
   * - Main input file pattern
     - main_input_file_pattern
     - text
     - Main
     - 
     - Main input file pattern. This file will be used to replace the positioned files
   * - Termination Time
     - term_time
     - text
     - 0
     - 
     - Optional termination time. Only supported for positioned files
   * - Include Files pattern
     - include_files_pattern
     - text
     - INCLUDE
     - 
     - Include file pattern. Only files matching this pattern will be included in the simulation basides the main and the pedshot file
   * - Update main input file name with Impactor filename
     - update_main_file
     - select
     - no
     - ✓
     - Helps to distinguish when the filename is identical in all runs

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Study Id
     - study_id
     - integer
     - Integer identifier of the d3VIEW study created to group all submitted pedestrian-protection simulations.
   * - Simulations
     - simulations
     - dataset
     - Dataset listing each individual simulation record (one row per impactor position) with metadata linking position parameters to their respective jobs.
   * - Hpcjobs
     - hpcjobs
     - dataset
     - Dataset of HPC job records corresponding to each submitted simulation, carrying queue status and job IDs for monitoring and downstream result extraction.

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

- cae.preprocessing.scenario
- cae.solver
- engineering.crash.dynamics
- engineering.crash.occupant_safety
- platform.job_submission

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