Skip to main content

spacelab_estimation/
lib.rs

1//! Orbit-determination kernels.
2//!
3//! The one decision that governs the whole layer: **least squares by orthogonal factorisation, never
4//! by the normal equations.** Forming `HᵀWH` squares the condition number, and orbit-determination
5//! Jacobians are ill-conditioned enough that the difference is between eight correct digits and
6//! one. Everything here is built on the square-root information filter [`Srif`], and the nonlinear
7//! solver [`GaussNewton`] wraps it.
8//!
9//! This is the linear-algebra core. Wiring it to a measurement model (range, range-rate, angles) and
10//! the state transition matrix — which maps an observation's partials back to the epoch state — is
11//! the next layer; the STM it needs is built (`spacelab_propagation::variational`).
12
13#![cfg_attr(not(test), no_std)]
14
15pub mod conjunction;
16pub mod conjunction_domain;
17pub mod consider;
18pub mod consistency;
19pub mod converter;
20pub mod ensemble;
21pub mod ephemeris;
22pub mod fixed_lag;
23pub mod gauss_newton;
24pub mod hinf;
25pub mod iekf;
26pub mod imm;
27pub mod kalman;
28pub mod lie;
29pub mod light_time;
30pub mod lincov;
31pub mod measurement;
32pub mod mekf;
33pub mod mixture;
34pub mod modifier;
35pub mod multistatic;
36pub mod observed;
37pub mod particle;
38pub mod process_noise;
39pub mod radiometric;
40pub mod richardson;
41pub mod robust;
42pub mod rts;
43pub mod sampling;
44pub mod screening;
45pub mod se23;
46pub mod se3;
47pub mod srif;
48pub mod srukf;
49pub mod unscented;
50
51pub use conjunction::{ConjunctionError, ConjunctionGeometry, EncounterPlane};
52pub use conjunction_domain::{
53    CurvilinearEncounter, DomainError, RectilinearEncounter, RelativeSample, UsageViolations,
54    usage_violations,
55};
56pub use consider::{consider_covariance, consider_sensitivity};
57pub use consistency::{
58    chi_square_mean_interval, chi_square_scale_factor, is_consistent, normalized_squared,
59    scalar_nis,
60};
61pub use converter::{
62    ConverterError, ConverterFit, DifferentiablePropagator, PropagatorBuilder, PropagatorConverter,
63    SampledPropagator, TrajectoryResiduals, TrajectorySample, residual_statistics,
64};
65pub use ensemble::{EnsembleError, EnsembleKalman};
66pub use ephemeris::{Component, StateComponent};
67pub use fixed_lag::FixedLagSmoother;
68pub use gauss_newton::{GaussNewton, GaussNewtonReport, ResidualModel};
69pub use hinf::{HInfinityError, HInfinityFilter};
70pub use iekf::InvariantEkf;
71pub use imm::{ImmError, InteractingMultipleModel};
72pub use kalman::SquareRootKalman;
73pub use lie::UnitQuaternion;
74pub use light_time::{SPEED_OF_LIGHT, Transit, down_leg};
75pub use lincov::LinearCovariance;
76pub use measurement::{
77    Station, Topocentric, azimuth, declination, elevation, range, range_rate, right_ascension,
78};
79pub use mekf::MultiplicativeEkf;
80pub use mixture::{GaussianComponent, GaussianMixture};
81pub use modifier::{
82    AtmosphericDelay, Azimuth, Bias, Declination, Elevation, EstimatedBias, EstimatedDrift,
83    EstimatedShapiroDelay, Modified, Modifier, ModifierError, Observable, Partials, Range,
84    RangeRate, RightAscension, ShapiroDelay, SlantDelay, SolarCoronaDelay, partials, shapiro_delay,
85    shapiro_delay_ppn,
86};
87pub use multistatic::{
88    BistaticGeometry, BistaticRange, BistaticRangeRate, Fdoa, InterSatelliteRange,
89    InterSatelliteRangeRate, MultistaticError, PairObservable, PairPartials, Tdoa, TdoaGeometry,
90    Terminal, bistatic_range, bistatic_range_rate, fdoa, inter_satellite_range,
91    inter_satellite_range_rate, pair_partials, tdoa,
92};
93pub use observed::{Observed, Signal, partials_at_emission, reduce};
94pub use particle::{ParticleError, ParticleFilter, Resampling};
95pub use process_noise::{
96    DiscreteStep, ProcessNoiseError, dynamic_model_compensation, matrix_exp, process_noise_sqrt,
97    rotate_position_velocity, state_noise_compensation, van_loan,
98};
99pub use radiometric::{
100    AKSIM_PAVLOV_2022, Band, CASSINI_KA_TURNAROUND_RATIO, CoronaSeries, CoronaTerm, DopplerLink,
101    DopplerReference, DopplerSignature, PLASMA_DELAY_COEFFICIENT, PlasmaSignature, Quasar,
102    RadiometricError, RampSegment, RampTable, SOLAR_RADIUS, averaged_doppler, delta_dor,
103    measured_frequency, range_modulus, sequential_range, solar_corona_delay,
104};
105pub use richardson::{richardson_extrapolate, richardson2};
106pub use robust::{RobustOutcome, RobustPolicy, RobustTally, chi_square_gate, robust_update};
107pub use rts::{RtsError, RtsSmoother, SmoothingStep};
108pub use sampling::Rng;
109pub use screening::{
110    CloseApproach, MAX_SAMPLES, ScreeningError, closest_approaches, radially_separated,
111};
112pub use se3::Se3;
113pub use se23::{ImuNoise, NavigationEkf, Se23};
114pub use srif::{Srif, SrifError};
115pub use srukf::SquareRootUnscentedKalman;
116pub use unscented::{UnscentedParams, unscented_transform};