.. _auto_lsdyna_element_to_part_lookup:

*LSDYNA ELEMENT-TO-PART LOOKUP*
===============================

Given a list of LS-DYNA element IDs and either a simulation_id or a file reference, walks *ELEMENT_* and *PART blocks across the main keyword deck and all included files to map each element to its owning part. Returns a per-element resolution table, a per-part summary sorted by match count, and any unresolved IDs — primarily used in error-termination diagnostics to localize a failure cascade to a specific part.

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

Tagged: ``deck_scan``, ``diagnostics``, ``element``, ``element_to_part``, ``error_termination``, ``failure_cascade``, ``include``, ``keyword``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Simulation
     - simulation_id
     - remote_lookup
     - —
     - 
     - ID of the registered simulation whose main keyword file and all *INCLUDE'd files will be scanned; mutually exclusive with 'file' — exactly one of the two must be provided.
   * - File
     - file
     - text
     - —
     - 
     - Single keyword file to scan, specified as an attachment ID, attachment name, or absolute file-system path; used instead of simulation_id when no simulation record exists — exactly one of the two must be provided.
   * - Element IDs
     - element_ids
     - text
     - —
     - ✓
     - Comma-separated list of positive integer LS-DYNA element IDs to look up (e.g. '14112,14966,15237'); at least one ID is required.
   * - Element Type Hint
     - element_type_hint
     - select
     - auto
     - 
     - Restricts the scan to a single *ELEMENT_* block type (solid, shell, tshell, or beam) to reduce parse time; leave at the default 'auto' to search all element types.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Element to Part
     - element_to_part
     - dataset
     - Dataset with one row per resolved element ID containing columns element_id, element_type, part_id, part_name, and source_file (the keyword file in which the element was found).
   * - Part Summary
     - part_summary
     - dataset
     - Dataset with columns part_id, part_name, and matched_element_count, sorted descending by matched_element_count so the dominant part (most matched elements) appears in the first row.
   * - Unresolved Elements
     - unresolved_elements
     - dataset
     - Dataset listing element IDs (column element_id) that were not found in any scanned keyword file; an empty dataset indicates full resolution.
   * - Files Scanned
     - files_scanned
     - number
     - Integer count of keyword files (main deck + includes) that were actually opened and parsed during the lookup.
   * - Status
     - status
     - string
     - Human-readable summary string describing the outcome of the lookup, including any warnings such as no keyword files found.

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

- cae.postprocessing.extraction
- cae.preprocessing.deck_authoring
- engineering.crash.dynamics

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