Package Overview¶
bijux-gnss-nav owns navigation-domain science: external navigation products
become typed satellite state, corrections become explicit model evidence, and
observations become solution claims through estimators.
This crate is not generic file I/O and not receiver runtime scheduling. It is where navigation meaning is interpreted after bytes, observations, or product records have reached the navigation boundary.
Navigation Flow¶
flowchart LR
formats["formats<br/>broadcast, RINEX, SP3, CLK, ANTEX, bias SINEX"]
orbits["orbits and clocks"]
corrections["corrections<br/>atmosphere, bias, combinations"]
estimation["estimation<br/>PVT, EKF, PPP, RTK"]
claims["solution claims<br/>quality, integrity, downgrade"]
formats --> orbits --> corrections --> estimation --> claims
Owned Families¶
| family | owns | first proof |
|---|---|---|
| formats | GPS LNAV/CNAV, Galileo FNAV/INAV, BeiDou, GLONASS, RINEX navigation and observation, SP3, CLK, ANTEX, bias SINEX | format source and format guide |
| orbits | broadcast and precise satellite state for supported constellations | orbit source and orbit guide |
| corrections | atmosphere, ionosphere, group delay, code and phase bias, combinations, phase windup, measured ionosphere | correction source and correction guide |
| estimation | position, integrity, smoothing, EKF, PPP, RTK, ambiguity and baseline evidence | estimation source and estimation guide |
| models | antenna, atmosphere, celestial, NeQuick, ocean tide loading, solid earth tide support | model source and model guide |
| navigation time | GNSS-specific time utilities and rollover interpretation above core time types | navigation-time source |
Reader Rules¶
- Start here when a claim depends on navigation interpretation, not just on how a command found a file or how a receiver scheduled a run.
- Leave for
bijux-gnss-infrawhen the question is repository file discovery, dataset registry state, sidecars, run layout, or persisted provenance. - Leave for
bijux-gnss-receiverwhen the question is how observations were produced or how navigation solving was invoked inside a receiver run. - Leave for
bijux-gnss-corewhen the question is shared observation, navigation-epoch, unit, diagnostic, or artifact-envelope meaning. - Leave for
bijux-gnss-signalwhen the question is signal code, carrier, wavelength, raw-IQ, or DSP behavior before navigation interpretation.
Scientific Guardrails¶
Navigation changes must preserve the route from input product to solution claim. A parser change without estimator proof can still be correct, but the reader needs to know which tests prove parse semantics and which tests prove solution behavior. PPP and RTK claims need especially clear downgrade and quality evidence because higher-level crates can render those results without owning their scientific validity.
First Proof Check¶
Inspect the navigation crate README, format guide, correction guide, estimation guide, curated public API source, and the integration tests named in the crate README.