empyrean.StallDelivery

class StallDelivery(underlying_stop, gn_qnorm, convergence_tol, optical_reduced_chi2)

Bases: object

The numbers behind a fit delivered by the stable-stall acceptance — one whose final solve latched no convergence criterion but was stationary to a small fraction of its own formal σ, with χ² clearing the fit-quality bars.

Present as DetermineResult.stall_delivery exactly when DetermineResult.termination is "stalled_delivered". None is the ordinary case; a consumer that wants the strict convergence contract checks for it.

Methods

__init__(underlying_stop, gn_qnorm, ...)

Attributes

step_sigmas	The remaining undamped Gauss-Newton step in units of the fit's own formal 1σ, √q — the number to quote when saying how far from stationary the delivered iterate is.
underlying_stop	What the SOLVER reported before the acceptance overrode the verdict — always "damping_exhausted" or "inner_trials_exhausted", the only two stops the acceptance considers.
gn_qnorm	q of the undamped Gauss-Newton step at the delivered iterate — the quantity convergence_tol bounds and did not bound here.
convergence_tol	The resolved tolerance the stall was judged against.
optical_reduced_chi2	Reduced χ² of the OPTICAL family alone at the delivered iterate.

Parameters:

• underlying_stop (str)

• gn_qnorm (float)

• convergence_tol (float)

• optical_reduced_chi2 (float)

underlying_stop: str

What the SOLVER reported before the acceptance overrode the verdict — always "damping_exhausted" or "inner_trials_exhausted", the only two stops the acceptance considers. Kept beside DetermineResult.termination so the delivery’s verdict and the solver’s own are both readable and neither is inferred from the other.

gn_qnorm: float

q of the undamped Gauss-Newton step at the delivered iterate — the quantity convergence_tol bounds and did not bound here. √q is the remaining step in the fit’s own formal σ.

convergence_tol: float

The resolved tolerance the stall was judged against.

Delivered because ODConfig.convergence_tol carries a “use the engine default” sentinel, so the value actually enforced is not recoverable from the config that was passed in.

optical_reduced_chi2: float

Reduced χ² of the OPTICAL family alone at the delivered iterate.

The full objective’s reduced χ² and the bar both were held to are already on DetermineResult.acceptability, and the delivery’s μ and iteration count are already DetermineResult.mu_final and DetermineResult.final_solve_iterations — a stall-delivered fit’s final solve IS the stalled solve.

property step_sigmas: float

The remaining undamped Gauss-Newton step in units of the fit’s own formal 1σ, √q — the number to quote when saying how far from stationary the delivered iterate is.