.. _auto_energy_balance_verdict:

*ENERGY BALANCE VERDICT*
========================

Adjudicate an LS-DYNA run's global energy balance: 6 advisory metrics (hourglass/IE, eroded-KE/KE, eroded-IE/IE, total-energy drift, sliding-interface contact energy [negative = unambiguous failure], added-mass %) -> PASS/FLAG verdict. Input is the glstat energy curves (from a binout_user_extractor run); thresholds are advisory rules of thumb, not absolute acceptance gates.

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

Tagged: ``energy``, ``balance``, ``glstat``, ``hourglass``, ``erosion``, ``contact``, ``added_mass``, ``verdict``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - glstat Curves (JSON)
     - curves
     - text
     - —
     - ✓
     - JSON array of {"component": name, "points": {"y": [...]}} -- the binout_output.curves from a glstat binout_user_extractor run with components total_energy, internal_energy, kinetic_energy, hourglass_energy, eroded_kinetic_energy, eroded_internal_energy, sliding_interface_energy, added_mass, energy_ratio, percent_increase.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Energy Balance Verdict
     - verdict_result
     - keyvalue
     - Assoc: verdict (PASS/FLAG/ERROR), flag_count, metrics_with_insufficient_data, metrics (per-metric value/threshold/pass/note), channels (first/last/n_states), advisory.

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

- engineering.crash.dynamics
- engineering.material.characterization

.. raw:: html

   <hr style="margin-top:2em">
   <p style="font-size:11px;color:#888">
   Auto-generated from <code>platform</code> schema. Worker id: <code>energy_balance_verdict</code>. Schema hash: <code>2ca3feded364</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>