Module constellation

Expand description

GNSS constellation identity catalog and validation helpers.

This is a data/catalog layer: it builds normalized satellite identity records from public sources and compares those records with GNSS products. It does not alter positioning solves or infer application-specific health rules. It is deterministic and performs no network access; fetching the source bytes is the caller’s (binding’s) job.

GPS is supported first. CelesTrak gps-ops OMM/JSON is the base source for current NORAD catalog ids and PRN assignments; the PRN is parsed from OBJECT_NAME and rendered as the SP3/RINEX id ("G13"). NAVCEN’s GPS constellation status page can be parsed and merged as an optional overlay for SVN and NANU usability details.

The OMM input is the canonical Omm produced by the core OMM parser (crate::astro::omm::{parse_json, parse_json_array}): this module does not re-parse OMM from scratch, it reads OBJECT_NAME and NORAD_CAT_ID off already-parsed records.

use sidereon_core::constellation::{to_csv, BoolStyle, Record, RecordSource};
use sidereon_core::GnssSystem;

let record = Record {
    system: GnssSystem::Gps,
    prn: 3,
    svn: None,
    norad_id: 40294,
    sp3_id: "G03".to_string(),
    active: true,
    usable: true,
    source: RecordSource::default(),
};
assert_eq!(
    to_csv(&[record], BoolStyle::Lower),
    "prn,norad_cat_id,active,sp3_id\n3,40294,true,G03\n"
);

Structs§

CelestrakSource: CelesTrak gps-ops provenance fields preserved on a record.
Diff: Change report between two catalog snapshots, keyed by (system, prn).
FieldChange: A single field change on a PRN that exists in both diffed snapshots.
NavcenSource: NAVCEN status provenance fields preserved on a record or conflict.
NavcenStatus: A parsed row from NAVCEN’s GPS constellation status table.
Record: A normalized GNSS satellite identity record.
RecordSource: Per-source provenance kept on a Record.
Validation: Validation report for a constellation catalog.

Enums§

BoolStyle: How the CSV active column renders booleans.
ConstellationError: Failure modes of the constellation catalog builders.

Functions§

changed: Returns true when a diff has any findings.
diff: Compare two catalog snapshots by (system, prn) identity.
from_celestrak_omm: Build GPS records from already-parsed CelesTrak gps-ops OMM records.
gps_sp3_id: Render the canonical SP3/RINEX satellite token for a GPS PRN (7 -> G07).
is_valid: Returns true when a validation report has no findings.
merge_navcen: Merge NAVCEN status rows into normalized records by PRN.
parse_navcen: Parse NAVCEN’s GPS constellation status HTML from raw bytes.
to_csv: Export records as the compact mapping CSV.
validate: Validate catalog identity without an SP3 product.
validate_against_sp3: Validate catalog identity against a loaded SP3 product.
validate_against_sp3_ids: Validate catalog identity against a plain list of SP3/RINEX satellite tokens.
validate_against_sp3_ids_strict: Validate against a plain SP3 id list and fail unless the catalog is clean.