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¶
| 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¶
| 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
Auto-generated from transformation schema. Worker id: curves_energy_distribution. Schema hash: c3a5422eea43. Hand-curated docs in workerexamples/ override this page when present.