.. _auto_lsdyna_binout_summary:

*LSDYNA BINOUT SUMMARY*
=======================

Walks a simulation's binout once and returns precomputed peak axial / peak shear per id across swforc, secforc, and deforc, plus a per-part energy (ΔE) profile from matsum. Use this as a single-call replacement for the per-id curve fetches that power the BINOUT Explorer's Connections and Load Path tabs.

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

Tagged: ``binout``, ``connections``, ``deforc``, ``fastener``, ``load_path``, ``lsdyna``, ``matsum``, ``peaks``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Simulation
     - simulation_id
     - remote_lookup
     - —
     - 
     - Reference to the LS-DYNA simulation whose binout will be summarised.
   * - Top-N per source
     - top_n_per_source
     - integer
     - 200
     - 
     - Cap on how many ids per branch (secforc / swforc / deforc / matsum) are extracted. Default 200; max 5000.
   * - Load-path segments
     - lp_segments
     - integer
     - 10
     - 
     - Number of time buckets to differentiate cumulative internal_energy into ΔE per window (default 10).

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Connections
     - connections
     - dataset
     - Object keyed by branch (swforc / secforc / deforc); each value is an array of {id, label, peak_axial, peak_axial_t, peak_shear, peak_shear_t} rows.
   * - Load Path
     - load_path
     - dataset
     - Array of {id, name, profile[lp_segments], total} rows from matsum, sorted by total ΔE descending.
   * - Summary
     - summary
     - string
     - Human-readable summary string with row counts per branch.

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

- cae.postprocessing.extraction
- cae.postprocessing.response
- 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_binout_summary</code>. Schema hash: <code>fa4d8bf4d8ac</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>