empyrean.generate_ephemeris

generate_ephemeris(orbits, observers, config=None, *, force_model=None, uncertainty_method=None)[source]

Generate predicted ephemeris (RA/Dec) for orbits at observer locations.

Parameters:

  • orbits (CartesianOrbits | KeplerianOrbits | CometaryOrbits | SphericalOrbits) – Input orbits with optional covariance and non-gravitational parameters.

  • observers (Observers) – Observer states from get_observer_states().

  • config (EphemerisConfig | None) – Full configuration. Construct with EphemerisConfig(propagation=PropagationConfig(...), ...). If omitted, one is built from the sugar kwargs below (or defaults).

  • force_model (ForceModelTier | str | None) – Quick override for config.propagation.force_model. Ignored if config is given.

  • uncertainty_method (UncertaintyMethod | SigmaPoint | MonteCarlo | str | None) – Quick override for config.propagation.uncertainty_method. SECOND_ORDER is what populates observation Hessians on the resulting ObservationSensitivity. Ignored if config is given.

Return type:

EphemerisResult

Returns:

EphemerisResult – Wraps the Ephemeris table and, when input covariance is carried, the observation-partials ObservationSensitivity container.

Examples

Defaults (Standard force model, FirstOrder uncertainty):

>>> result = empyrean.generate_ephemeris(orbits, observers)

With a config object:

>>> cfg = EphemerisConfig(
...     propagation=PropagationConfig(
...         force_model=ForceModelTier.FULL,
...         uncertainty_method=UncertaintyMethod.SECOND_ORDER,
...     ),
...     compute_diagnostics=False,
... )
>>> result = empyrean.generate_ephemeris(orbits, observers, cfg)