Struct WptBandEnergyResult 

#[non_exhaustive]
pub struct WptBandEnergyResult {
    pub bands: Vec<WptBandSummary>,
    pub dominant_band: WptBandSummary,
    pub energy_distribution_pct: Vec<f64>,
    pub total_energy: f64,
    pub selection: WptBandSelection,
    pub spectral_entropy: f64,
    pub normalized_entropy: f64,
}

Productized WPT band-energy result.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

bands: Vec<WptBandSummary>

Per-band summaries in canonical (level, band_index) order.

dominant_band: WptBandSummary

Argmax of bands by energy_share_pct.

energy_distribution_pct: Vec<f64>

Normalised energy distribution aligned with bands (sums to 100.0).

total_energy: f64

Sum of band energies before normalisation.

selection: WptBandSelection

Selection strategy that produced the leaf set.

spectral_entropy: f64

Raw Shannon spectral entropy of energy_distribution_pct in nats ([0, ln K], K = number of bands). Computed by the crate-internal spectral_entropy helper. Defaults to 0.0 when deserialising pre-existing payloads that predate this field.

normalized_entropy: f64

Normalised spectral entropy H / ln K ∈ [0, 1]: a regime-instability indicator. Near 0 = energy concentrated in one dominant scale (stable regime); near 1 = diffuse, fragmenting spectral structure (unstable regime). Naicker (2026, SSRN 6677659) §2.3.3; Shannon (1948).

Implementations

impl WptBandEnergyResult

pub fn validate(&self) -> Result<()>

Validate cross-band invariants:

• bands non-empty and per-band valid
• distribution length matches bands length
• distribution sums to 100.0 within tolerance
• dominant_band == argmax(bands.energy_share_pct)

Trait Implementations

impl Clone for WptBandEnergyResult

fn clone(&self) -> WptBandEnergyResult

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for WptBandEnergyResult

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for WptBandEnergyResult

fn eq(&self, other: &WptBandEnergyResult) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for WptBandEnergyResult