Enum OuterGradientFdDecomposition 

pub enum OuterGradientFdDecomposition {
    Decomposed(Box<OuterGradientFdAtoms>),
    NotDecomposed {
        reason: String,
    },
}

Whether the audited criterion decomposes into REML atoms, and the evidence either way (#2460).

The comparison above — one analytic ψ gradient against one Ridders-certified finite difference of the same objective — is available from any outer objective that declares a ψ block, because it needs only eval_cost and eval_with_order. The breakdown below is not: it exists where the criterion is fixed-β likelihood + ½log|H| − ½log|S|₊ + KKT residual and the evaluator publishes those atoms as it assembles them.

Routes that evaluate a criterion directly — the constant-curvature fair profile computes its value and derivative in closed form and never enters a REML assembly — have no atoms to publish and no selected coefficient mode to difference. Making the breakdown a PRECONDITION of the measurement is what left those routes with no audit at all, which is the wrong way round: a hand-derived derivative on a bespoke profile is the one that most wants checking.

Variants

Decomposed(Box<OuterGradientFdAtoms>)

The evaluator published every atom, and each is differenced at the step the Ridders ladder accepted for the total.

NotDecomposed

The evaluator published no atoms, no scalar criterion components and no selected coefficient mode. reason names the objective so a consumer reports which route it got rather than an empty array.

A PARTIAL publication is never reported here — it is a defect in an evaluator that means to decompose, and the capture still fails loudly.

Fields

reason: String

Implementations

impl OuterGradientFdDecomposition

pub fn atoms(&self) -> Option<&OuterGradientFdAtoms>

The atoms, or None where the criterion does not decompose.

Trait Implementations

impl Clone for OuterGradientFdDecomposition

fn clone(&self) -> OuterGradientFdDecomposition

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OuterGradientFdDecomposition

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

Formats the value using the given formatter.