.. _auto_curves_energy_distribution:

*COMPUTE THE ENERGY DISTRIBUTION*
=================================

Computes the energy distribution across a set of internal-energy time-history curves by grouping them into ranked bands (levels) and sorting within each band by a chosen criterion. Use this worker to quickly identify which parts/materials dominate the internal-energy absorption in a crash or structural simulation.

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

Classification: **process**.

Tagged: ``band_ranking``, ``crash``, ``curve_grouping``, ``energy_distribution``, ``internal_energy``, ``time_history``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Internal Energy Curves
     - internalenergycurves
     - vector
     - —
     - 
     - One or more time-history curves (X = time, Y = internal energy, typically in energy units such as kJ or mJ) extracted from a CAE solver (e.g. LS-DYNA binout/d3plot); each curve should represent a single material or part.
   * - Num Levels
     - num_levels
     - string
     - 5
     - 
     - Integer (1–10) specifying the number of energy bands into which all curves are partitioned; default is 5 — increase for finer grouping of large curve sets.
   * - Sort Criteria
     - sort_criteria
     - string
     - ymax
     - 
     - Statistic used to rank curves within each band: 'ylast' (final value), 'ymin' (minimum), 'yavg' (time average), 'slope' (overall slope), or 'max_slope' (peak slope); default is 'ymax' (peak value).
   * - Num Parts Per Level
     - num_parts_per_level
     - scalar
     - 5
     - 
     - Maximum number of curves retained and displayed per band (5, 10, 25, or 50); default is 5 — raise to surface more contributors within each energy level.
   * - Normalize
     - normalize
     - scalar
     - no
     - 
     - Within each band

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curves_energy_distribution_output_1
     - curves_energy_distribution_output_1
     - dataset
     - Dataset table where each row represents a curve ranked within its energy band, including columns for part/material ID, assigned band level, sort-criterion value, and normalised energy fraction (if normalisation was requested).

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

- cae.postprocessing.response
- data.curve.pair
- data.statistics
- engineering.crash.dynamics
- engineering.structures

Runnable example
----------------

A runnable example is registered for this worker. Open the example workflow on the d3VIEW canvas: `/api/workflow/example?id=curves_energy_distribution <https://www.d3view.com/api/workflow/example?id=curves_energy_distribution>`_

.. raw:: html

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