Satellite catalogue API#
Evidence-backed spacecraft and space-power component catalogues.
JSONL is canonical; Parquet and browser JSON are reproducible derived snapshots. No network requests, live positions, telemetry or model estimates are implicit.
- orbitalpv.catalogue.build_snapshot(output, root=None)[source]#
Build immutable typed Parquet tables, verified browser projections and manifest.
Requires
orbital-pv[catalogue]. Same inputs and PyArrow version produce the same bytes; the manifest records PyArrow’s version. Output must not exist.
- orbitalpv.catalogue.coverage(records=None)[source]#
Counts and completeness; deliberately no sum of unlike PV power ratings.
- orbitalpv.catalogue.load_records(entity_type=None, root=None)[source]#
Read canonical records, sorted by UUID. Unknown fields remain absent/null.
- orbitalpv.catalogue.load_schema()[source]#
Return the installed versioned field dictionary.
- Return type:
- orbitalpv.catalogue.load_sources(root=None)[source]#
Return source IDs mapped to exact URLs and retrieval/reuse metadata.
- orbitalpv.catalogue.merge_records(existing, incoming, *, now)[source]#
Fill unknowns only; any conflicting assertion leaves that record unchanged.
Pure operation: validate the complete result before writing it. Ratings and nested extensions are atomic, so a different EOL value cannot silently replace a BOL assertion. Identical observations do not churn timestamps.
- orbitalpv.catalogue.record_id(entity_type, identity_key)[source]#
Stable UUID5; preserve case, punctuation and explicit configuration identity.
- orbitalpv.catalogue.stage_omm(objects, *, source_id, now)[source]#
Stage identities from supplied CelesTrak/CCSDS OMM; never infer PV capacity.
Review against existing aliases/COSPAR IDs before admission. Exact source bytes, hash and provider terms belong in the caller’s source registry. This function makes no HTTP requests and does not write canonical data.
- orbitalpv.catalogue.validate_catalogue(root=None)[source]#
Validate packaged or custom canonical data and return coverage statistics.