empyrean.ODConfig¶

class ODConfig(force_model=ForceModelTier.STANDARD, epsilon=1e-09, max_light_time_iterations=3, num_threads=0, frame=Frame.ICRF, weighting=<factory>, debiasing=<factory>, excluded_perturbers=<factory>, origin=<factory>, iod=<factory>, output_epoch=<factory>, max_iterations=100, convergence_tol=1e-05, use_stm_cache=True, solve_for=SolveForParams.AUTO, auto_escalation=<factory>, acceptability=<factory>, fit_station_biases=False, station_radec=<factory>, use_span_grouping=False, rejection=<factory>, auto_force_model=False, output_representation=CovarianceRepresentation.CARTESIAN)[source]

Bases: object

Unified orbit-determination configuration.

Sensible production defaults out of the box:

VFC17 station weighting + nightly de-weighting (WeightingConfig.preset)

EFCC2020 catalog debiasing enabled (DebiasingConfig.enabled)

SolveForParams.AUTO (escalates 6→9 parameters on poor fit)

Adaptive outlier rejection enabled, max_passes = 4

Methods

__init__([force_model, epsilon, ...])

Attributes

`auto_force_model`	Auto-select force-model tier from IOD orbital elements.
`convergence_tol`
`epsilon`	Adaptive integrator truncation-error tolerance.
`fit_station_biases`	Enable Schur-eliminated per-station RA/Dec bias fitting.
`force_model`
`frame`
`max_iterations`
`max_light_time_iterations`
`num_threads`	`0` = use all available cores.
`output_representation`
`solve_for`
`use_span_grouping`
`use_stm_cache`
`weighting`	Observation weighting pipeline.
`debiasing`	Catalog-bias-correction configuration.
`excluded_perturbers`	Bodies to omit from the perturber set.
`origin`	Origin-policy selector.
`iod`
`output_epoch`
`auto_escalation`
`acceptability`
`station_radec`
`rejection`

Parameters:

force_model (ForceModelTier)
epsilon (float)
max_light_time_iterations (int)
num_threads (int)
frame (Frame)
weighting (WeightingConfig)
debiasing (DebiasingConfig)
excluded_perturbers (list[Origin | str])
origin (OriginPolicy)
iod (IODConfig)
output_epoch (OutputEpoch)
max_iterations (int)
convergence_tol (float)
use_stm_cache (bool)
solve_for (SolveForParams)
auto_escalation (AutoEscalationPolicy)
acceptability (AcceptabilityThresholds)
fit_station_biases (bool)
station_radec (StationRaDecConfig)
use_span_grouping (bool)
rejection (RejectionConfig)
auto_force_model (bool)
output_representation (CovarianceRepresentation)

force_model: ForceModelTier = 'standard'

epsilon: float = 1e-09: Adaptive integrator truncation-error tolerance.

max_light_time_iterations: int = 3

num_threads: int = 0: 0 = use all available cores.

frame: Frame = 'icrf'

weighting: WeightingConfig: Observation weighting pipeline. Default = enabled + VFC17 preset. See WeightingConfig for full layered control.

debiasing: DebiasingConfig: Catalog-bias-correction configuration. Default = EFCC2020 standard resolution loaded from the engine’s default data location. See DebiasingConfig.

excluded_perturbers: list[Origin | str]: Bodies to omit from the perturber set. Pass Origin instances (or canonical names). Useful when fitting an asteroid that the force model would otherwise include as a perturber — e.g. fitting Eros while excluding Origin.asteroid(433).

origin: OriginPolicy: Origin-policy selector. Default OriginPolicyMode.AUTO (heliocentric → geocentric Earth cascade). Set origin=OriginPolicy(mode=OriginPolicyMode.EXPLICIT, origin=Origin.EARTH) to pin the pipeline to a specific central body for catalog satellites or regime-classified workflows.

iod: IODConfig

output_epoch: OutputEpoch

max_iterations: int = 100

convergence_tol: float = 1e-05

use_stm_cache: bool = True

solve_for: SolveForParams = 'auto'

auto_escalation: AutoEscalationPolicy

acceptability: AcceptabilityThresholds

fit_station_biases: bool = False: Enable Schur-eliminated per-station RA/Dec bias fitting.

station_radec: StationRaDecConfig

use_span_grouping: bool = False

rejection: RejectionConfig

auto_force_model: bool = False: Auto-select force-model tier from IOD orbital elements.

output_representation: CovarianceRepresentation = 'cartesian'