Struct OuterResult 

pub struct OuterResult {
    pub rho: Array1<f64>,
    pub final_value: f64,
    pub iterations: usize,
    pub final_grad_norm: Option<f64>,
    pub final_gradient: Option<Array1<f64>>,
    pub final_hessian: Option<Array2<f64>>,
    pub converged: bool,
    pub plan_used: OuterPlan,
    pub operator_trust_radius: Option<f64>,
    pub operator_stop_reason: Option<OperatorTrustRegionStopReason>,
    pub criterion_certificate: Option<CriterionCertificate>,
    pub rho_uncertainty_diagnostic: Option<RhoUncertaintyDiagnostic>,
}

Result of a completed outer optimization.

Fields

rho: Array1<f64>

Optimized log-smoothing parameters.

final_value: f64

Final objective value.

iterations: usize

Total outer iterations across all solver restarts.

final_grad_norm: Option<f64>

Final gradient norm, when the solver computed an actual gradient.

final_gradient: Option<Array1<f64>>

Final gradient when the solver is gradient-based.

final_hessian: Option<Array2<f64>>

Final Hessian when the solver tracks one.

converged: bool

Whether the optimizer converged to a stationary point.

plan_used: OuterPlan

Which plan was actually used (may differ from initial if fallback fired).

operator_trust_radius: Option<f64>

Final trust radius for the internal operator trust-region solver.

A non-converged operator-ARC attempt may be restarted by the budget ladder. Restarting only from the last θ but resetting the trust radius is not a warm start: it replays the same rejected large trial steps. Carry this globalization state so retries resume from the scale the previous attempt already learned.

operator_stop_reason: Option<OperatorTrustRegionStopReason>

Why the internal operator trust-region solver stopped.

criterion_certificate: Option<CriterionCertificate>

First-order optimality self-audit at the returned point (#934).

None when no analytic gradient was measured at termination (gradient-free solvers, cache-hit short-circuits, per-atom EFS) or when an audit probe failed to evaluate. Populated once by [run_outer] after the solver ladder returns, outside all hot loops.

rho_uncertainty_diagnostic: Option<RhoUncertaintyDiagnostic>

Post-fit PSIS diagnostic for whether sampled smoothing-parameter weights show evidence that plug-in REML/LAML intervals are unreliable. Populated once by [run_outer] when the exact rho Hessian is cheap enough to use.

Implementations

impl OuterResult

pub fn new( rho: Array1<f64>, final_value: f64, iterations: usize, converged: bool, plan_used: OuterPlan, ) -> Self

pub fn final_grad_norm_report(&self) -> String

Human-readable rendering of final_grad_norm for diagnostics. Returns "n/a" when no gradient was measured (gradient-free / cache-hit paths).

Trait Implementations

impl Clone for OuterResult

fn clone(&self) -> OuterResult

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OuterResult

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

Formats the value using the given formatter.