.. _auto_lsdyna_element_failure_timeline:

*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
------

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

   * - 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
-------

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

   * - 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

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