ccsds-ndm-py 0.0.9

Parse and generate CCSDS Navigation Data Messages (NDM) in KVN and XML formats

CCSDS NDM

Python bindings for the ccsds-ndm Rust core, for parsing, validating, and generating CCSDS Navigation Data Messages (NDM) in both KVN and XML formats.

Supported Message Types

Message	Description
OPM	Orbit Parameter Message – Single state vector and orbital parameters
OMM	Orbit Mean-Elements Message – Mean orbital elements (e.g., TLE-like)
OEM	Orbit Ephemeris Message – Orbit state time series with covariance
OCM	Orbit Comprehensive Message – Detailed orbit data with maneuvers
CDM	Conjunction Data Message – Collision assessment data
TDM	Tracking Data Message – Ground station tracking measurements
RDM	Reentry Data Message – Reentry prediction information
APM	Attitude Parameter Message – Single attitude state and attitude parameters
AEM	Attitude Ephemeris Message – Attitude state time series
ACM	Attitude Comprehensive Message – Detailed attitude data with maneuvers and covariance
NDM	Combined NDM Instantiation – Container for multiple CCSDS messages

Installation

pip install ccsds-ndm-py

Requires Python 3.9+.

Quick Start

import ccsds_ndm

# Parse any NDM file (auto-detects format and type)
msg = ccsds_ndm.from_file("example.ndm")

if isinstance(msg, ccsds_ndm.Opm):
    print(f"Object: {msg.segment.metadata.object_name}")
    print(f"Epoch: {msg.segment.data.state_vector.epoch}")

    # Validate (raises on error by default)
    msg.validate()

    # Serialize
    msg.to_file("output.opm", "kvn")
    msg.to_file("output.xml", "xml")

Features

• Type-safe: Strongly typed structures matching CCSDS XSD schemas
• Auto-detection: Automatically detects message format and type
• Validation API: validate(strict=True|False) available on message objects
• Native bindings: PyO3 + maturin wrapping the Rust core implementation

Documentation

• User Guide & API Reference
• CCSDS NDM Standards

License

MPL-2.0