empyrean.AcceptabilityReport¶

class AcceptabilityReport(fit_acceptable, extrapolation_acceptable, converged_ok, reduced_chi2_ok, reduced_chi2_value, reduced_chi2_threshold, rms_ok, rms_value_arcsec, rms_threshold_arcsec, residual_isotropy_ok, at_ct_ratio_value, at_ct_ratio_threshold, covariance_ok, arc_coverage_ok, arc_days_value, arc_days_threshold, fractional_sigma_a_ok, fractional_sigma_a_value, fractional_sigma_a_threshold, selection_fraction_ok, selection_fraction_value, selection_fraction_threshold, selected_arc_coverage_ok, selected_arc_days_value, selected_arc_fraction_value, selected_arc_fraction_threshold, trailing_gap_ok, trailing_gap_days_value, trailing_gap_threshold, radar_fit_ok)[source]

Bases: object

Structured fit-quality verdict — mirrors scott::od::AcceptabilityReport.

Each *_ok flag is the verdict; *_value is the measured statistic; *_threshold is the bound it was compared against. Override the thresholds via AcceptabilityThresholds on ODConfig (e.g. tighten fractional_sigma_a for Sentry-grade impact monitoring).

Methods

__init__(fit_acceptable, ...)

Attributes

`fit_acceptable`	converged AND positive-definite covariance AND reduced $\chi^2$ AND RMS AND residual-isotropy thresholds all met.
`extrapolation_acceptable`	`fit_acceptable` AND arc-coverage AND $\sigma_a / \|a\|$ thresholds met.
`converged_ok`	DC iteration reached the configured update-norm tolerance within the iteration budget.
`reduced_chi2_ok`	Reduced $\chi^2$ at or below `AcceptabilityThresholds.reduced_chi2`.
`reduced_chi2_value`	Measured reduced $\chi^2$ of the post-DC fit.
`reduced_chi2_threshold`	Threshold the value was compared against.
`rms_ok`	Combined astrometric RMS at or below `AcceptabilityThresholds.rms_arcsec`.
`rms_value_arcsec`	Combined RA·cos(δ) and Dec residual RMS (arcsec).
`rms_threshold_arcsec`	Threshold the value was compared against.
`residual_isotropy_ok`	Residual cloud is roughly isotropic in the sky plane: $\max(AT/CT,\; CT/AT)$ at or below `AcceptabilityThresholds.at_ct_ratio`.
`at_ct_ratio_value`	Measured $\max(AT/CT,\; CT/AT)$ ratio.
`at_ct_ratio_threshold`	Threshold the value was compared against.
`covariance_ok`	Final 6×6 state covariance is finite and positive-definite.
`arc_coverage_ok`	Observation-arc length at or above `AcceptabilityThresholds.min_arc_days`.
`arc_days_value`	Length of the observation arc actually used in the fit (days).
`arc_days_threshold`	Threshold the value was compared against.
`fractional_sigma_a_ok`	Fractional uncertainty $\sigma_a / \|a\|$ at or below `AcceptabilityThresholds.fractional_sigma_a`.
`fractional_sigma_a_value`	Measured $\sigma_a / \|a\|$ .
`fractional_sigma_a_threshold`	Threshold the value was compared against.
`selection_fraction_ok`	Did the fit retain enough of its input? `False` means the residual bars above describe a heavily pruned subset.
`selection_fraction_value`	Fraction of observations retained (n_selected / n_obs).
`selection_fraction_threshold`	Minimum retained fraction the gate required.
`selected_arc_coverage_ok`	Do the selected observations still span enough of the arc to extrapolate across it? This is the coverage axis `extrapolation_acceptable` gates on — a strict tightening of the full-span `arc_coverage_ok`, which keeps its original meaning for callers that want it.
`selected_arc_days_value`	Arc span (days) over the selected observations only.
`selected_arc_fraction_value`	Selected-span / full-span ratio.
`selected_arc_fraction_threshold`	Minimum span ratio the gate required.
`trailing_gap_ok`	Were the most-recent observations kept? The absolute, asymmetric backstop the span ratio cannot provide: it catches a short recent tail rejected off a long arc, where the ratio still passes but the discarded rows are the ones nearest a forward extrapolation target.
`trailing_gap_days_value`	Days between the last selected and the last full-arc observation.
`trailing_gap_threshold`	Largest trailing gap the gate allowed (days).
`radar_fit_ok`	Radar astrometry joint-fit acceptability.

Parameters:

fit_acceptable (bool)
extrapolation_acceptable (bool)
converged_ok (bool)
reduced_chi2_ok (bool)
reduced_chi2_value (float)
reduced_chi2_threshold (float)
rms_ok (bool)
rms_value_arcsec (float)
rms_threshold_arcsec (float)
residual_isotropy_ok (bool)
at_ct_ratio_value (float)
at_ct_ratio_threshold (float)
covariance_ok (bool)
arc_coverage_ok (bool)
arc_days_value (float)
arc_days_threshold (float)
fractional_sigma_a_ok (bool)
fractional_sigma_a_value (float)
fractional_sigma_a_threshold (float)
selection_fraction_ok (bool)
selection_fraction_value (float)
selection_fraction_threshold (float)
selected_arc_coverage_ok (bool)
selected_arc_days_value (float)
selected_arc_fraction_value (float)
selected_arc_fraction_threshold (float)
trailing_gap_ok (bool)
trailing_gap_days_value (float)
trailing_gap_threshold (float)
radar_fit_ok (bool | None)

fit_acceptable: bool

converged AND positive-definite covariance AND reduced $\chi^2$ AND RMS AND residual-isotropy thresholds all met. Trustworthy state vector at the arc epoch.

Type:: Top-level pass

extrapolation_acceptable: bool: fit_acceptable AND arc-coverage AND $\sigma_a / |a|$ thresholds met. Gate that VA sampling / close-approach prediction / follow-up scheduling should check before relying on extrapolated state.

converged_ok: bool: DC iteration reached the configured update-norm tolerance within the iteration budget.

reduced_chi2_ok: bool: Reduced $\chi^2$ at or below AcceptabilityThresholds.reduced_chi2.

reduced_chi2_value: float: Measured reduced $\chi^2$ of the post-DC fit.

reduced_chi2_threshold: float: Threshold the value was compared against.

rms_ok: bool: Combined astrometric RMS at or below AcceptabilityThresholds.rms_arcsec.

rms_value_arcsec: float: Combined RA·cos(δ) and Dec residual RMS (arcsec).

rms_threshold_arcsec: float: Threshold the value was compared against.

residual_isotropy_ok: bool: Residual cloud is roughly isotropic in the sky plane: $\max(AT/CT,\; CT/AT)$ at or below AcceptabilityThresholds.at_ct_ratio. NaN when no along/cross-track decomposition was computed (no sky-motion rates available).

at_ct_ratio_value: float: Measured $\max(AT/CT,\; CT/AT)$ ratio.

at_ct_ratio_threshold: float: Threshold the value was compared against.

covariance_ok: bool: Final 6×6 state covariance is finite and positive-definite.

arc_coverage_ok: bool: Observation-arc length at or above AcceptabilityThresholds.min_arc_days.

arc_days_value: float: Length of the observation arc actually used in the fit (days).

arc_days_threshold: float: Threshold the value was compared against.

fractional_sigma_a_ok: bool: Fractional uncertainty $\sigma_a / |a|$ at or below AcceptabilityThresholds.fractional_sigma_a. The default is a loose general-purpose gate; tighten it for Sentry-grade impact monitoring.

fractional_sigma_a_value: float: Measured $\sigma_a / |a|$ .

fractional_sigma_a_threshold: float: Threshold the value was compared against.

selection_fraction_ok: bool

Did the fit retain enough of its input? False means the residual bars above describe a heavily pruned subset. Gates extrapolation_acceptable; deliberately not part of fit_acceptable.

Reproduce the fraction from selection_fraction_value, not from ResidualSummary — the summary counts merged radar / occultation stub rows that were never candidates for outlier pruning, so its ratio is a different (smaller) number.

selection_fraction_value: float: Fraction of observations retained (n_selected / n_obs).

selection_fraction_threshold: float: Minimum retained fraction the gate required.

selected_arc_coverage_ok: bool: Do the selected observations still span enough of the arc to extrapolate across it? This is the coverage axis extrapolation_acceptable gates on — a strict tightening of the full-span arc_coverage_ok, which keeps its original meaning for callers that want it.

selected_arc_days_value: float: Arc span (days) over the selected observations only. NaN when nothing was selected.

selected_arc_fraction_value: float: Selected-span / full-span ratio.

selected_arc_fraction_threshold: float: Minimum span ratio the gate required.

trailing_gap_ok: bool: Were the most-recent observations kept? The absolute, asymmetric backstop the span ratio cannot provide: it catches a short recent tail rejected off a long arc, where the ratio still passes but the discarded rows are the ones nearest a forward extrapolation target.

trailing_gap_days_value: float: Days between the last selected and the last full-arc observation. 0.0 when the last kept observation is the last observation; NaN when nothing was selected.

trailing_gap_threshold: float: Largest trailing gap the gate allowed (days).

radar_fit_ok: bool | None: Radar astrometry joint-fit acceptability. None when no radar contributed to the fit — which is never the same as False.