LSDYNA ELEMENT FAILURE TIMELINE¶
Parses LS-DYNA solver logs (ALL_MESSAGES.txt, mes0000–mes0003, or solver.log) into a structured failure timeline, extracting per-element failure events, per-timestep aggregates, node deletions, termination error codes (e.g. 40455/40456/negative-volume), and the NaN node list from out-of-range-forces blocks. Use this as the primary diagnostic tool for error-terminated LS-DYNA simulations to rapidly identify the sequence and root cause of element failures without manual log parsing.
When to use¶
Tagged: ALL_MESSAGES, diagnostics, element_failure, error_terminated, failure_timeline, lsdyna, mes0000, nan_nodes.
Inputs¶
| Label | ID | Type | Default | Required | Description |
|---|---|---|---|---|---|
| Simulation | simulation_id | remote_lookup | — | ✓ | Required. Platform simulation record to parse; drives resolution of the solver log sources (ALL_MESSAGES.txt, mes000x, or solver.log) for the target run. |
| Max Events | max_events | integer | 1000 | Maximum number of element-failure rows to return across all log sources; accepts 1–100000, default 1000. Reduce for very large sims to limit memory; increase when the full failure sequence is needed. | |
| Include Node Deletions | include_node_deletions | select | yes | Whether to populate the node_deletions output with ‘node number N deleted at time T’ events; set to ‘no’ to skip node-deletion parsing and reduce output size. | |
| Time Window | time_window | string | — | Optional simulation-time filter in ‘tmin:tmax’ format (e.g. ‘38.0:39.0’ to capture only the last millisecond before a crash at t=38.25 ms); leave blank to parse the entire log. |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| Failure Timeline | failure_timeline | dataset | Dataset of individual element failure events sorted by log order; columns: time (s), element_type (solid/shell/tshell/beam), element_id, failure_reason (e.g. negative-volume, GISSMO), source_file, and line_num. |
| Failure Summary | failure_summary | dataset | Dataset of per-timestep failure aggregates; columns: time (s), n_solid, n_shell, n_tshell, n_beam — useful for plotting the failure rate as a function of simulation time. |
| Node Deletions | node_deletions | dataset | Dataset of node-deletion events; columns: time (s), node_id, source_file, line_num. Populated only when include_node_deletions is ‘yes’. |
| Termination Error Codes | termination_error_codes | dataset | Dataset capturing all ‘*** Error N (SOL+M)’ termination messages; columns: error_code, sol_code, processor, source_file, line_num — covers codes such as 40455, 40456, and negative-volume errors. |
| NaN Node List | nan_node_list | string | Space-delimited string of node IDs extracted from the ‘*** termination due to out-of-range forces’ block; empty string if no NaN nodes were found. |
| Parsed From | parsed_from | string | Semicolon-joined absolute file paths of every log source actually read (e.g. ‘/run/1234/ALL_MESSAGES.txt;/run/1234/mes0000’); useful for provenance and debugging. |
| Status | status | string | Human-readable summary string reporting counts of failure events, node deletions, error codes, and NaN nodes parsed, along with the source files used; contains a diagnostic message if no log sources were found. |
Disciplines¶
- cae.postprocessing.extraction
- cae.solver
- engineering.crash.dynamics
Auto-generated from platform schema. Worker id: lsdyna_element_failure_timeline. Schema hash: 871b825b31f8. Hand-curated docs in workerexamples/ override this page when present.