sidereon_core/
constants.rs

1//! Shared GNSS constants.
2//!
3//! These are semantic constants used across multiple GNSS modules. A parity
4//! target may still keep a local alias or comment when the operation order of a
5//! formula matters, but the source value lives here so modules do not drift.
6
7pub use crate::astro::constants::astro::{AU_KM, AU_M};
8pub use crate::astro::constants::earth::{
9    MEAN_EARTH_RADIUS_KM, MEAN_EARTH_RADIUS_M, OMEGA_E_DOT_RAD_S, WGS84_A_KM, WGS84_A_M, WGS84_E2,
10    WGS84_F,
11};
12pub use crate::astro::constants::geometry::AZIMUTH_ZENITH_EPS;
13pub use crate::astro::constants::time::{
14    DAYS_PER_JULIAN_YEAR, J2000_JD, SECONDS_PER_DAY, SECONDS_PER_HOUR, SECONDS_PER_MINUTE,
15    SECONDS_PER_WEEK,
16};
17pub use crate::astro::constants::units::{
18    DEGREES_PER_CIRCLE, DEGREES_PER_SEMICIRCLE, DEG_TO_RAD, KM_TO_M, MICROSECONDS_PER_SECOND,
19    MM_PER_M, M_PER_KM, NS_TO_S, RAD_TO_DEG, US_TO_S,
20};
21
22/// Seconds in half a GNSS week, the rollover fold threshold.
23pub const HALF_WEEK_S: f64 = SECONDS_PER_WEEK / 2.0;
24
25/// Speed of light in vacuum (m/s), IS-GPS-200. Re-exported from the canonical
26/// core home so the value is defined once for the whole workspace.
27pub const C_M_S: f64 = crate::astro::constants::physics::SPEED_OF_LIGHT_M_S;
28
29/// GPS L1 carrier frequency (Hz). Galileo E1 shares this frequency.
30pub const F_L1_HZ: f64 = 1_575.42e6;
31
32/// GPS L2 carrier frequency (Hz).
33pub const F_L2_HZ: f64 = 1_227.60e6;
34
35/// Galileo E1 carrier frequency (Hz). GPS L1 shares this frequency.
36pub const F_E1_HZ: f64 = F_L1_HZ;
37
38/// Galileo E5a carrier frequency (Hz).
39pub const F_E5A_HZ: f64 = 1_176.45e6;
40
41/// BeiDou B1I carrier frequency (Hz).
42pub const F_B1I_HZ: f64 = 1_561.098e6;
43
44/// BeiDou B3I carrier frequency (Hz).
45pub const F_B3I_HZ: f64 = 1_268.52e6;
46
47/// Seconds from GPS epoch (1980-01-06 00:00) to J2000 (2000-01-01 12:00).
48pub const GPS_EPOCH_TO_J2000_S: f64 = 630_763_200.0;
49
50/// GPS Time minus BeiDou Time (seconds): BDT = GPST - 14 s.
51pub const GPST_MINUS_BDT_S: f64 = 14.0;
52
53/// GPS/Galileo/QZSS and BeiDou system-time-minus-TAI offsets. Canonically
54/// defined in the always-on astro time-constants module (the always-present
55/// `astro::time` scale layer needs them); re-exported here for GNSS consumers.
56pub use crate::astro::constants::time::{BDT_MINUS_TAI_S, GPST_MINUS_TAI_S};
57
58/// Seconds from the GPS epoch to the BeiDou epoch (2006-01-01).
59pub const BDS_EPOCH_MINUS_GPS_EPOCH_S: f64 = 1356.0 * SECONDS_PER_WEEK;
60
61/// Fixed transmit-time iterations for SPP residuals.
62///
63/// The SPP solver is pinned to two iterations by the SPP trace fixtures. The
64/// observable predictor deliberately uses a separate three-iteration policy
65/// because it mirrors Sidereon `Observables.predict` and its own SP3 oracle.
66pub const SPP_TRANSMIT_TIME_ITERATIONS: usize = 2;
67
68/// Fixed transmit-time iterations for observable prediction.
69///
70/// Kept distinct from [`SPP_TRANSMIT_TIME_ITERATIONS`] after oracle
71/// reconciliation: the public observable predictor performs three light-time
72/// refinement iterations plus the final transmit-epoch evaluation.
73pub const OBSERVABLE_TRANSMIT_TIME_ITERATIONS: usize = 3;
74
75/// Default SP3 provenance comment emitted when a product has no comments.
76pub const SP3_DEFAULT_PROVENANCE_COMMENT: &str = "Generated by sidereon-core";
sidereon_core/constants.rs

sidereon_core/
constants.rs
