empyrean.refine

refine(orbit, observations, *, config=None)[source]

Refine an orbit with new observations using a Bayesian prior.

The orbit must carry a covariance matrix; the seed orbit’s covariance is always used as the prior constraint by the underlying empyrean_refine C ABI entry point. (Unlike determine, there is no opt-out — calling refine IS the prior-based path.)

Parameters:

  • orbit (CartesianOrbits | KeplerianOrbits | CometaryOrbits | SphericalOrbits) – Single orbit with covariance (must contain exactly one entry). Parameter name is singular to match the Rust wrapper’s Context::refine; the type is a quivr table because Python orbits are always table-shaped, but only the first row is used.

  • observations (ADESObservations) – ADES optical observations.

  • config (ODConfig | None) – Configuration. Defaults to ODConfig defaults.

Return type:

DetermineResult

Returns:

DetermineResult – Refined orbit, residuals, and summary statistics.