Struct OutfitCache 

pub struct OutfitCache { /* private fields */ }

Precomputed observer positions for all observations in a dataset.

OutfitCache is the top-level cache built once before any trajectory fitting, from a fully loaded ObsDataset. It encapsulates:

• a per-observation centric cache (CentricObserverCache) holding geocentric and heliocentric positions at each observation epoch;
• a per-observer body-fixed cache (BodyFixedObserverCache) holding the time-independent Earth-fixed state of each observer.

All positions are in the ecliptic mean J2000 frame (AU / AU·day⁻¹).

Build

Use OutfitCache::build to construct the cache. Accessor methods then provide O(1) lookups keyed by ObsIndex or ObserverId.

Implementations

impl OutfitCache

pub fn get_centric(&self, idx: ObsIndex) -> &ObserverCentricCache

Returns the full ObserverCentricCache entry for the observation at idx.

The returned reference gives access to the geocentric position, geocentric velocity, and heliocentric position at the epoch of that observation.

Panics

Panics if idx is out of bounds (i.e., ≥ number of observations in the dataset used to build this cache).

pub fn get_fixed(&self, observer_id: ObserverId) -> Option<&ObserverFixedCache>

Returns the ObserverFixedCache for the given observer, if present.

Returns None if observer_id is not found in the body-fixed cache (e.g., the observer was not part of the dataset used to build this cache).

pub fn build( obs_dataset: &ObsDataset, jpl: &JPLEphem, ut1_provider: &Ut1Provider, cache_velocity: bool, ) -> Result<Self, OutfitError>

Builds the cache for every observation in obs_dataset.

This is the primary constructor. It proceeds in two steps:

1. Build the BodyFixedObserverCache from the dataset’s observer list.
2. Build the CentricObserverCache by computing epoch-dependent positions for each observation using the JPL ephemeris and UT1 provider.

Arguments

• obs_dataset — the observation dataset to cache; all observers must have valid geodetic coordinates and associated observer IDs.
• jpl — JPL planetary ephemeris (DE440 or compatible) for heliocentric Earth positions.
• ut1_provider — UT1 time scale data for computing Earth’s sidereal angle at each observation epoch.
• cache_velocity — whether to compute and cache the velocity components in the resulting ObserverCentricCache. If false, the velocity fields will be set to None to save computation time and memory.

Errors

Returns OutfitError if:

• the dataset’s observer iterator fails, or
• any observer’s body-fixed position cannot be computed, or
• any observation lacks an associated observer ID, or
• the JPL ephemeris or UT1 provider cannot be evaluated at a given epoch.

pub fn get_observer_fixed_cache( &self, observer_id: ObserverId, ) -> Option<&ObserverFixedCache>

Returns the ObserverFixedCache for the given observer, if present.

Alias for OutfitCache::get_fixed, provided for explicitness when the caller already has an ObserverId.

pub fn get_observer_geocentric_position( &self, idx: ObsIndex, ) -> &ObserverGeocentricPosition

Returns the precomputed geocentric position of the observer at observation idx.

The position is in the ecliptic mean J2000 frame, in AU.

Panics

Panics if idx is out of bounds.

pub fn get_observer_geocentric_velocity( &self, idx: ObsIndex, ) -> &Option<ObserverGeocentricVelocity>

Returns the precomputed geocentric velocity of the observer at observation idx.

The velocity is in the ecliptic mean J2000 frame, in AU/day.

Panics

Panics if idx is out of bounds.

pub fn get_helio_position(&self, idx: ObsIndex) -> &ObserverHeliocentricPosition

Returns the precomputed heliocentric position of the observer at observation idx.

The position is in the ecliptic mean J2000 frame, in AU.

Panics

Panics if idx is out of bounds.

Trait Implementations

impl Debug for OutfitCache

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.