PARSES LS-DYNA KEYWORD INPUT TO GET HOLE SPECIMEN INFORMATION¶
Parses an LS-DYNA keyword input file to extract geometric and nodal information for a hole-type material specimen. Given a specimen part ID and reference node IDs for the punch, blank, die, and hole components, it returns a structured key-value summary of the specimen configuration. Use this worker when setting up or auditing hole-specimen simulations in a material characterization workflow.
When to use¶
Tagged: hole_specimen, keyword_parsing, lsdyna, node_extraction, part_id, specimen_geometry.
Inputs¶
| Label | ID | Type | Default | Required | Description |
|---|---|---|---|---|---|
| LS-DYNA Keyword File | file_input | file | — | ✓ | LS-DYNA keyword (.k / .key / .dyn) input file containing the mesh and part definitions for the hole specimen simulation. |
| Specimen PID | specimen_pid | scalar | 1 | ✓ | Part ID (PID) of the hole specimen blank shell/solid part within the keyword file; default 1. |
| Punch Node 1 | punch_node_1 | scalar | 1 | ✓ | Node ID of the first reference node on the punch tool used to define its position/orientation; default 1. |
| Punch Node 2 | punch_node_2 | scalar | 2 | ✓ | Node ID of the second reference node on the punch tool; default 2. |
| Punch Node 3 | punch_node_3 | scalar | 3 | ✓ | Node ID of the third reference node on the punch tool; default 3. |
| Blank Node 1 | blank_node_1 | scalar | 4 | ✓ | Node ID of the first reference node on the sheet blank used to track blank deformation; default 4. |
| Blank Node 2 | blank_node_2 | scalar | 5 | ✓ | Node ID of the second reference node on the sheet blank; default 5. |
| Blank Node 3 | blank_node_3 | scalar | 6 | ✓ | Node ID of the third reference node on the sheet blank; default 6. |
| Die Node 1 | die_node_1 | scalar | 4 | ✓ | Node ID of the first reference node on the die tool used to define its position/orientation; default 4. |
| Die Node 2 | die_node_2 | scalar | 5 | ✓ | Node ID of the second reference node on the die tool; default 5. |
| Die Node 3 | die_node_3 | scalar | 6 | ✓ | Node ID of the third reference node on the die tool; default 6. |
| Hole Node 1 | hole_node_1 | scalar | 7 | ✓ | Node ID of the first reference node located at or around the pre-punched hole edge; default 7. |
| Hole Node 2 | hole_node_2 | scalar | 8 | ✓ | Node ID of the second reference node at the hole edge; default 8. |
| Hole Node 3 | hole_node_3 | scalar | 9 | ✓ | Node ID of the third reference node at the hole edge; default 9. |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| Hole Specimen Info | hole_specimen_info | keyvalue | Key-value map containing parsed specimen metadata — including part ID, initial nodal coordinates for punch, blank, die, and hole reference nodes — ready for downstream characterization or calibration workers. |
Disciplines¶
- cae.preprocessing.setup
- engineering.material.characterization
- engineering.material.specimen
Auto-generated from platform schema. Worker id: lsdyna_parse_hole_specimen_info_from_file. Schema hash: 060b11b8c28a. Hand-curated docs in workerexamples/ override this page when present.