0.9.0: Support CCSDS OEM and STK .e; Build covariance interpolation (PSD guaranteed) and orbital element uncertainty; add instrument kernel and Field of View calculations

[ChristopherRabotin]

🚀 Highlights

Version 0.9.0 introduces a dedicated instrument modeling module, significantly expands interoperability with industry-standard file formats (CCSDS OEM, Ansys STK), and adds "hot-swap" capabilities for kernel management.

🔭 Instrument & Field of View (Beta)

• New Module: Introduced anise.instrument containing Instrument and FovShape classes.
• Analysis: Added FovMargin and FovMarginToLocation to the scalar expression engine for event finding and reporting.
• Visual Validation: Added tests/fov_plots.py demonstrating FOV pyramid construction and projection in the Moon Principal Axis frame.

⚠️ Beta Notice: The FOV margin calculation and Almanac signatures are currently in Beta. Expect potential API changes in future minor releases as the instrument modeling fidelity evolves.

📡 Interoperability & Data Exchange

• CCSDS OEM Support:

• Added Ephemeris.from_ccsds_oem_file() to load CCSDS Orbit Ephemeris Messages (OEM).

• Added Almanac.load_ccsds_oem_file() to directly ingest OEMs into the frame system.

• Added to_ccsds_oem_file() to export ephemerides.

• STK Support: Added Ephemeris.from_stk_e_file() and Almanac.load_stk_e_file() to ingest Ansys STK .e ephemeris files.

• Covariance Interpolation: Ephemeris interpolation via Log-Euclidean Riemannian space for covariance matrices, ensuring positive definiteness and volume preservation during sampling.

🔄 Kernel Management

• Hot-Swapping: Added spk_swap() and bpc_swap() to the Almanac.
• Allows in-place replacement of SPK/BPC files using a "high watermark" memory strategy (reusing existing buffers). Use this in embedded/flight software contexts.
• Unloading: Added spk_unload() and bpc_unload().

📐 GNC & Frame Math

• TRIAD / Align-and-Clock: Added DCM.from_align_and_clock() to construct rotation matrices based on primary/secondary vector alignment constraints.
• Quaternion runtime frame checking: Fixed the Quaternion/Euler Parameter math to correctly use the Hamiltonian convention and use a passive rotation like the DCM.
• Solar Elongation: Updated sun_angle_deg documentation to explicitly define conjunction/opposition geometry and illumination phases.
• Numpy Integration: Orbit constructors now accept native numpy.array inputs for state vectors.

Pull requests

New features

• feat: state spec is now a trait by @ChristopherRabotin in feat: state spec is now a trait #586
• feat: implement visibility arcs by @ChristopherRabotin in feat: implement visibility arcs #587
• Enable DAF kernel swapping by @ChristopherRabotin in Enable DAF kernel swapping #591
• List loaded kernels + export Almanac as MetaAlmanac for reloading + load many ANISE kernels at once with aliases by @ChristopherRabotin in List loaded kernels + export Almanac as MetaAlmanac for reloading + load many ANISE kernels at once with aliases #592
• Add NumPy array constructor for astro.Orbit by @google-labs-jules[bot] in Add NumPy array constructor for astro.Orbit #598
• Highly requested feature: support CCSDS OEM with covariances, and interpolation between covariance by @ChristopherRabotin in Highly requested feature: support CCSDS OEM with covariances, and interpolation between covariance #601
• Add STK .e Ephemeris Parsing by @google-labs-jules[bot] in Add STK .e Ephemeris Parsing #612
• Feat/oem covar export by @ChristopherRabotin in Feat/oem covar export #613
• Implement orbital element uncertainty for an EphemerisRecord by @ChristopherRabotin in Implement orbital element uncertainty for an EphemerisRecord #611
• Instrument kernel, field of view margin calculation, fix frame check with quaternions passive rotation, DCM TRIAD initialization by @ChristopherRabotin in Instrument kernel, field of view margin calculation, fix frame check with quaternions passive rotation, DCM TRIAD initialization #614

Fixes

• fix Discontinuous scalar expressions which are always positive should be treated as angles #577 by ensuring that specific scalars be treated as angles by @ChristopherRabotin in fix #577 by ensuring that specific scalars be treated as angles #579
• Silence Brouwer Warning for Small Errors by @google-labs-jules[bot] in Silence Brouwer Warning for Small Errors #590
• Fix(python): Add missing comma to all by @google-labs-jules[bot] in Fix(python): Add missing comma to all #596
• Add readme to Python package by @ChristopherRabotin in Add readme to Python package #597
• Fix Continuous Event Arcs and Non-Equality Conditions by @google-labs-jules[bot] in Fix Continuous Event Arcs and Non-Equality Conditions #604
• Revert "Fix Continuous Event Arcs and Non-Equality Conditions" by @ChristopherRabotin in Revert "Fix Continuous Event Arcs and Non-Equality Conditions" #605
• Fix Event arcs on orbital element conditionals raise an error on continuous arcs #600 again since I accidentally fully reversed it by @ChristopherRabotin in Fix #600 again since I accidentally fully reversed it #609

Miscellaneous

• Make Analysis Solvers Public by @google-labs-jules[bot] in Make Analysis Solvers Public #583
• Support multi summary blocks in DAF by @ChristopherRabotin in Support multi summary blocks in DAF #584
• build(deps): update rfd requirement from 0.15.0 to 0.16.0 by @dependabot[bot] in build(deps): update rfd requirement from 0.15.0 to 0.16.0 #580
• build(deps): update criterion requirement from 0.7 to 0.8 by @dependabot[bot] in build(deps): update criterion requirement from 0.7 to 0.8 #588
• build(deps): update criterion requirement from 0.7 to 0.8 by @dependabot[bot] in build(deps): update criterion requirement from 0.7 to 0.8 #594
• Update main readme by @ChristopherRabotin in Update main readme #599
• Use LFS for the PCA files by @ChristopherRabotin in Use LFS for the PCA files #606
• Add tutorials for Analysis module and OEM support by @google-labs-jules[bot] in Add tutorials for Analysis module and OEM support #607
• Various small changes to support porting Nyx over to ANISE 0.9.0 by @ChristopherRabotin in Various small changes to support porting Nyx over to ANISE 0.9.0 #610
• build(deps): update rfd requirement from 0.16.0 to 0.17.1 by @dependabot[bot] in build(deps): update rfd requirement from 0.16.0 to 0.17.1 #616
• Add tests for Quaternion implementation by @google-labs-jules[bot] in Add tests for Quaternion implementation #617

Full Changelog: 0.8.0...0.9.0

---

This discussion was created from the release 0.9.0: Support CCSDS OEM and STK .e; Build covariance interpolation (PSD guaranteed) and orbital element uncertainty; add instrument kernel and Field of View calculations.