Struct FactorPromotion 

pub struct FactorPromotion {
    pub direction: Array1<f64>,
    pub energy: f64,
    pub persistence_alignment: f64,
    pub prev_column: usize,
}

A persistent, evidence-earning residual factor direction — a promotion candidate for the #2021 Λ nursery→promotion birth channel. Emitted by StructuredResidualModel::promotion_candidates when a column of this pass’s Λ both (a) aligns with a column of the previous pass’s Λ (it persisted across the outer alternation) and (b) explains residual energy above the idiosyncratic-noise floor (it earns its complexity). The driver accumulates persistence across passes (the nursery) and, once a direction survives long enough, promotes it to a new curved/linear atom seeded by Self::direction.

Fields

direction: Array1<f64>

Unit-norm factor direction in output space (p-vector): the L2-normalized column of Λ. This is the decoder direction a promoted atom is born with.

energy: f64

Explained residual energy ‖Λ_:,j‖² (pre-normalization squared column norm) — the factor’s contribution to Σ = c·ΛΛᵀ + D. Candidates are returned in descending energy so the driver promotes the strongest first.

persistence_alignment: f64

|cos| alignment (∈ [0, 1]) between this direction and the best-matching column of the previous pass’s Λ — the persistence score gating promotion.

prev_column: usize

Index of the best-matching previous-pass Λ column (the nursery lineage this candidate continues), so the driver can track a stable identity for a direction across passes.

Trait Implementations

impl Clone for FactorPromotion

fn clone(&self) -> FactorPromotion

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FactorPromotion

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

Formats the value using the given formatter.