Where Kshana sits
Kshana is an open, reproducible PNT (positioning, navigation and timing) resilience evidence engine. You describe a scenario — the sensors or clocks, a GNSS (global navigation satellite system) outage, a jamming or spoofing attack, a budget — and it tells you how well time and position hold up, scored against operational figures of merit (FoMs). Each capability behind those figures is labelled in a machine-checked matrix as VALIDATED (checked against an independent external oracle), MODELLED (internally consistent, not externally checked) or PARTNER (owned by a hardware partner). This page says where it leads, what it is for, and what it is not.
Where it leads: timing and holdover for critical infrastructure#
The best-validated part of the engine is timing. Telecom networks, power grids and financial venues take their time from GNSS, and each has to size holdover: how long a local clock can free-run through a GNSS loss before its time error breaks the budget.
- What is VALIDATED. The frequency-stability estimators a holdover answer is built
from — Allan deviation (ADEV), modified Allan deviation (MDEV), time deviation (TDEV),
maximum time interval error (MTIE) and the extended-range Theo1 estimator — are checked
against Stable32 reference deviations, the independent
allantoolslibrary and a real measured caesium clock. The holdover coast-variance calculation and its inversion to a holdover time are checked against SciPy. SeeVERIFICATION-MATRIX.mdfor each row, its test and its oracle. - What stays MODELLED. The per-clock-class noise floors (for example the long-term floor of a given oscillator class) set the answer for a stable clock, and they are representative figures, not measurements of your device. Supply measured floors for a number you intend to defend.
- Telecom units. The
telecom-timingscenario kind reports MTIE and TDEV, checks them against the masks of the International Telecommunication Union Telecommunication Standardization Sector (ITU-T) — G.8272 for a primary reference time clock (PRTC), G.8272.1 for an enhanced PRTC (ePRTC), G.8273.2 for a telecom boundary clock (T-BC) and G.8271.1 for the network limits at reference point C — and reports how long a holdover stays inside each time-error budget. SeeTELECOM-TIMING.md.
What makes it different#
The physics and the standards are not the difference: Simplified General Perturbations 4 (SGP4) propagation, Allan deviation, reference frames and dilution of precision are available, free and correct, in other libraries, and Kshana checks itself against several of them. The difference is the evidence discipline:
- Open. The engine is under the GNU Affero General Public License (AGPL), so anyone can read and rerun it. A commercial licence exists for closed integration.
- Reproducible. A result is determined by
scenario + seed + engine version, bit for bit, and a run can be shared as a link to the browser playground. - Provenance-labelled. Every sensor parameter is traced to a published source
(
PROVENANCE.md), and every capability carries its VALIDATED / MODELLED / PARTNER tier. A continuous-integration (CI) guard refuses a VALIDATED row with no independent external oracle, so an internal self-check cannot be presented as a validation.
We have not found another open tool that combines these across holdover, integrity, inertial coasting and quantum sensors, but a search that finds nothing is not proof that nothing exists; we do not claim to be the only one.
Quantum: a neutral trade method, results labelled MODELLED#
Kshana compares quantum and classical clocks and inertial sensors on the same scenario
with the same code: each device is an error model, and the engine does not know which
one is "quantum". Treat it as a neutral quantum-vs-classical trade method whose results
are labelled MODELLED. Most inputs are published Allan/noise-budget coefficients; the
cold-atom-interferometer accelerometer has a first-principles layer that derives its noise
coefficient. A partner's measured Allan-deviation data can be fed in through the
quantum-trade kind, which is the route for promoting a specific device's figures. See
QUANTUM.md and QUANTUM-MODELS.md.
Lunar, cislunar and deep space: maintained, not the headline#
The lunar / cislunar suite (lunar integrity monitoring, the Earth–Moon three-body core, lunar time scales, service-volume analysis) and the deep-space radiometric-navigation engine are maintained capabilities. Most of their rows are MODELLED, and dedicated tools already serve lunar navigation, so they are offered as capabilities of the same engine, each with its own tier, rather than as the lead.
The rest of the engine#
The same engine, with the same tiers, also covers:
- Low Earth orbit (LEO) PNT, end to end. Signal design (
leo-signal), pass and per-band link budget (leo-pass), broadcast navigation message (leo-navmsg), fused medium- and low-Earth-orbit positioning (leo-pvt), precise point positioning (PPP) convergence with LEO augmentation (leo-ppp), positioning from a 5G non-terrestrial network (ntn-positioning), andleo-pnt-chain, which hands each stage's output to the next for one system. - Spectrum. An L-band (and ultra-high-frequency (UHF), S- and C-band) power-spectral-density waterfall under
a scripted jammer timeline, with per-band jammer-to-signal ratio and effective
carrier-to-noise density (
spectrum), and Signal Metadata Format (SigMF) recording in and out. - The solar system and any central body. Positions and physical constants of the
planets and major moons (
solar-system), positioning around any of those bodies (body-pnt), and Walker and published-slot constellation design with coverage and dilution-of-precision maps around any of them (constellation-design). - Campaigns. Existing kinds chained on one shared timeline, swept, run as seeded Monte
Carlo ensembles, or run side by side under shared conditions (
campaign). - Outputs. Every run writes a result document, a chart and a report in HTML
(HyperText Markup Language) and JSON (JavaScript Object Notation);
--animatewrites an SVG (Scalable Vector Graphics), HTML or frame-sequence animation;--exportwrites CZML (Cesium Language), KML (Keyhole Markup Language), GeoJSON or STK (Systems Tool Kit) ephemeris for the kinds that place things on the Earth, and SigMF forspectrum.
Most of these rows are MODELLED; the verification matrix names the few that are VALIDATED (for example the International Telecommunication Union rain and scintillation recommendations, the Galileo broadcast-ephemeris algorithm, the CRC-24Q (24-bit cyclic redundancy check) frame check and the planetary light-time solver).
What Kshana is not#
- Not a radio-frequency (RF) signal simulator or hardware-in-the-loop (HIL) rig.
Kshana drives no radio hardware and transmits nothing. Most of it works at the level of
error models and link budgets, before hardware or lab time is bought. At the signal level
it is software only: the GNSS IQ layer (
iq) writes baseband in-phase/quadrature (IQ) sample files of legitimate GNSS signals for software receivers and runs its own software receiver on them; thespectrumkind's[iq]section (since 0.29.0) writes a SigMF (Signal Metadata Format) snapshot of its analytic model that includes the configured jammers (noise-like jammers bin by bin, tones and chirps as waveforms); andspoof_capturesums an authentic and a spoofer replica signal in memory to test loop capture, without writing it out. Testing a hardware receiver against real RF stimulus is the job of an RF simulator. - Not a replacement for MATLAB/Simulink, STK or Orekit. It sits next to them. It reads and writes the exchange formats they use — CCSDS (Consultative Committee for Space Data Systems) Orbit Ephemeris Messages, SP3 (Standard Product 3) precise orbits, RINEX (Receiver Independent Exchange Format) — writes CZML, KML, GeoJSON and STK ephemeris for their viewers, and its numerical force model is cross-checked against Orekit rather than offered in its place.
- Not a carrier-phase GNSS processing engine or positioning service (see below).
- Not a certification authority. A VALIDATED label means a capability matches an external oracle; it is not a certification of any product or operator.
What Kshana is, and is not, next to a GNSS processing engine#
Kshana is not a carrier-phase GNSS processing engine, and no scenario kind is a
positioning service. It does have a foot in the measurement domain, as library code that
the performance study leans on and that is checked against independent references. Short-baseline
real-time kinematic (RTK) positioning with LAMBDA (least-squares ambiguity decorrelation
adjustment) integer fixing runs on real dual-frequency RINEX observations, as does a static
float precise point positioning (PPP) filter with IGS final orbits and clocks, and the
receiver clock that filter estimates is a time solution against the IGS final station clock.
Each of the three is a VALIDATED row of the verification matrix,
against the IGS station data it names there, and each runs on static, short observation
windows, not as a streaming service with ambiguity resolution over long baselines, carrier
smoothing or a kinematic rover. The leo-ppp kind runs a float PPP filter on code and
carrier phase, but on measurements it simulates itself, to study convergence time with and
without LEO augmentation; it does not process an observation file. The pvt kind (position, velocity and time) solves a receiver
position from real RINEX code pseudoranges plus broadcast ephemeris, validated against a
surveyed coordinate of the International GNSS Service (IGS) (station ABMF, 2018-05-13) to
5.7 m 3-D RMS (root mean square) / 1.1 m horizontal. But the product is the performance
study, not the positioning service, and the framing below is meant to save a prospective
user the wrong-tool disappointment.
| Kshana | A GNSS processing engine (RTKLIB, an open-source real-time kinematic positioning library; gLAB, the GNSS laboratory tool suite of the gAGE group at the Technical University of Catalonia) | |
|---|---|---|
| Input | a scenario: sensor error models, outage windows, geometry — or, for pvt, a real RINEX observation file plus broadcast navigation |
real GNSS observations (RINEX), ephemerides, corrections |
| Output | performance FoMs: holdover, timing/position error, availability, integrity/security bounds — plus a code single-point-positioning (SPP) position from the pvt kind |
a position/velocity/time solution (SPP, PPP, RTK) |
| Question it answers | "how good would this architecture be, and where does it break?" | "given these measurements, where am I now?" |
| Quantum / optical sensors | modelled as error models (optical clocks, cold-atom inertial measurement unit (IMU), optical time transfer), results labelled MODELLED | not modelled |
| Real-observation processing | code SPP from real RINEX observations (pvt, metre-level); short-baseline RTK with LAMBDA and static float PPP on real carrier phase, as library code checked against IGS stations (VALIDATED, static and short windows, not a streaming service); plus geometry / dilution of precision (DOP) / availability |
the core competency, through to carrier-phase PPP/RTK |
| Install | zero — runs in a browser tab (WebAssembly) | native build / toolchain |
Complementary, not competing — RTKLIB and gLAB#
RTKLIB and gLAB
are mature, widely used GNSS processing suites. They take real measurements and
produce a positioning solution (SPP/PPP/RTK; gLAB is also a superb teaching
tool with strong heritage at the European Space Agency (ESA) and the European
Geostationary Navigation Overlay Service (EGNOS)). Kshana does not replace them and does
not try to. Its observation path is narrow: code single-point positioning (pvt), and, as
checked library code, short-baseline RTK with LAMBDA integer fixing and a static float PPP
filter on real dual-frequency observations, each VALIDATED against IGS station data (the PPP
filter also against an RTKLIB run on the same inputs). It has no carrier smoothing, no
kinematic or streaming processing and no long-baseline ambiguity resolution, and pvt
does not estimate the troposphere or ionosphere — it applies the Saastamoinen/Niell
troposphere models and the L1/L2 ionosphere-free combination, it does not solve for them as
states.
The pipeline is complementary:
- RTKLIB / gLAB answer "where am I, from these signals?"
- Kshana answers "how long do I keep a good answer when those signals stop — and how much does a better clock or inertial sensor, classical or quantum, buy me?"
A natural workflow uses a processing engine for the GNSS-available segment and Kshana to study the holdover behaviour and the sensor trade space around it. If you need a carrier-phase positioning service — kinematic PPP or RTK, long baselines, network ambiguity resolution — use RTKLIB or gLAB; if you need reproducible, labelled evidence about resilience and holdover, that is the job Kshana is built for.
A zero-install browser tier#
Most simulation tools in this space (RTKLIB, gLAB, the General Mission Analysis Tool (GMAT), Orekit, STK) require a native install or a licence, and a learning curve before the first result. Kshana compiles to WebAssembly and runs entirely in the browser — the playground loads a worked scenario, runs the real engine client-side (nothing is uploaded), and shows the result in seconds. Guided sliders and one-click scenarios mean the first useful result needs no TOML (Tom's Obvious Minimal Language, the scenario file format) and no toolchain.
That zero-install tier is a deliberate position:
- Reach — a reviewer, student, or procurement officer can try the actual engine from a link, on any device, with no setup.
- Reproducibility — the same engine that ships in the browser is the library that
ships on crates.io, the Python Package Index (PyPI) and npm; a result is reproducible
from
scenario + seed + engine version, and a run is shareable as a URL (web address). - Honesty — running the engine yourself, in the open, is the strongest counter to "trust the numbers": the browser tier is the audit surface.
The browser tier does not make Kshana a replacement for a desktop processing suite — it makes the performance-trade-study question approachable to people who would never install one.
See also#
CAPABILITY.md— the row-by-row scope map (thepvtsolver's full scope and residuals are in the GNSS / PNT processing row).VALIDATION.md— what is validated, with evidence.TELECOM-TIMING.md— the telecom timing kind and its masks.GLOSSARY.md— plain-language definitions of the terms used here.web/README.md— the browser playground.