empyrean.CovarianceTrust

class CovarianceTrust(verdict, solved_width=None, second_order_recoverable=None, event=None)[source]

Bases: object

Event-aware trust verdict on the delivered covariance, evaluated over its validity window on the converged orbit.

trusted: no intervening close approach and a 6-state solve — the linear covariance may be used as delivered. encounter_intervenes: a close approach (or high-nonlinearity crossing) lies inside the window; do not extrapolate the linear covariance across it — escalate to nonlinear uncertainty propagation (second-order when second_order_recoverable, otherwise sampling). weakly_determined_high_n: the fit solved more than the 6-state, so the delivered 6×6 is a marginal of a wider fit (conservative flag). A DetermineResult.covariance_trust of None means the call path ran no gate — absence of a verdict is not trust.

Methods

__init__(verdict[, solved_width, ...])

Attributes

event

The earliest intervening event (encounter_intervenes only).

second_order_recoverable

Whether a second-order state-only correction can recover the encounter (encounter_intervenes only).

solved_width

Solved-for width of the fit the verdict refers to (absent for trusted).

verdict

"trusted" / "encounter_intervenes" / "weakly_determined_high_n".

Parameters:
  • verdict (str)

  • solved_width (int | None)

  • second_order_recoverable (bool | None)

  • event (TrustGateEvent | None)

verdict: str

"trusted" / "encounter_intervenes" / "weakly_determined_high_n".

solved_width: int | None = None

Solved-for width of the fit the verdict refers to (absent for trusted).

second_order_recoverable: bool | None = None

Whether a second-order state-only correction can recover the encounter (encounter_intervenes only).

event: TrustGateEvent | None = None

The earliest intervening event (encounter_intervenes only).