Orbit determination constant biases + measurement ambiguity and moduli

[ChristopherRabotin]

Summary

• Support ambiguity resolution as per JPL DESCANSO 214 - Pseudo-Noise and regenerative ranging
• Support moduli as per CCSDS TDM Blue Book
• Fix path in Nyx-built TDMs, accounting for whether the measurement type is one or two way, fixes CCSDS TDM blue book checks and other OD checks #397
• Add serde for (most) every input, outputs (like event evaluations) should still go in parquet, fixes Add serde support where relevant + various cleanups #396

Architectural Changes

• Add moduli to tracking data arc
• Add optional constant to stochastic models

New Features

• Accounts for ambiguity resolution / modulus in orbit determination

Improvements

No change

Bug Fixes

• Fix TDM parsing for two-way measurements

Testing and validation

As per #397 :
Simulate a tracking arc with the JPL DSN Code whose modulus is 75660 km. To ensure testing of the ambiguity intervals, fix the apply_moduli function to account for that ambiguity. Then, build two tests:

• Solve the OD with a properly configured moduli
• Solve the OD with a constant bias

Measurements for reference (2x):

So we see that nearly from the start of the arc, we're already at factor of 2x the JPL code. The comforts the properly configured moduli test.

Solving with properly configured moduli

No tuning done at all

The results without any tuning look reasonable, especially in the range component where we've put a full 75 Mm ambiguity from the JPL DSN code.

Solving with a constant bias

No tuning done at all

We see step function residuals and ratios on range around the time the range measurement is > 2x the JPL code ambiguity, causing the filter to rely on Doppler instead.

Documentation

Greatly expanded ODProcess documentation.

[github-actions]

Visit the preview URL for this PR (updated for commit 84e4f43):

https://nyx-rustdoc--pr398-feat-gh-396-moar-ser-8k6vbtsw.web.app

_{(expires Tue, 21 Jan 2025 21:45:39 GMT)}

_{🔥 via Firebase Hosting GitHub Action 🌎}

_{Sign: d8e2a55934352d850c15d11866c39eb2d2e029be}

[codecov]

Codecov Report

Attention: Patch coverage is 81.32296% with 48 lines in your changes missing coverage. Please review.

Project coverage is 67.83%. Comparing base (0f9ed48) to head (84e4f43).
Report is 14 commits behind head on master.

Files with missing lines	Patch %	Lines
src/od/msr/trackingdata/io_ccsds_tdm.rs	73.87%	29 Missing ⚠️
src/od/noise/white.rs	0.00%	7 Missing ⚠️
src/od/msr/trackingdata/io_parquet.rs	50.00%	3 Missing ⚠️
src/md/events/mod.rs	50.00%	2 Missing ⚠️
src/od/ground_station/mod.rs	91.66%	2 Missing ⚠️
src/od/msr/measurement.rs	90.00%	1 Missing ⚠️
src/od/msr/trackingdata/mod.rs	93.33%	1 Missing ⚠️
src/od/msr/types.rs	80.00%	1 Missing ⚠️
src/od/noise/mod.rs	91.66%	1 Missing ⚠️
src/od/simulator/trackdata.rs	93.75%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master     #398      +/-   ##
==========================================
+ Coverage   67.81%   67.83%   +0.01%     
==========================================
  Files          86       86              
  Lines       13756    13928     +172     
==========================================
+ Hits         9329     9448     +119     
- Misses       4427     4480      +53     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.