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¶
| 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¶
| 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
Auto-generated from platform schema. Worker id: lsdyna_element_to_part_lookup. Schema hash: ea40083538e5. Hand-curated docs in workerexamples/ override this page when present.