Developer’s Guide

This guide describes the architecture, module layout, and conventions for developers working on rms-ephemeris-tools.

Contents

• Architecture
  • Overview
  • High-level flow
  • Package layout
  • Data flow
  • Dependencies
  • Testing and quality
• Module descriptions
  • Root package (ephemeris_tools)
  • CLI (ephemeris_tools.cli)
  • Planets (ephemeris_tools.planets)
  • SPICE (ephemeris_tools.spice)
  • Rendering (ephemeris_tools.rendering)
• Porting from FORTRAN
  • Porting methodology
  • FORTRAN bugs
  • Python-vs-FORTRAN differences
  • Summary of match status by tool
• FORTRAN Compatibility Reference
  • Compatibility Fixes (Python Matches FORTRAN)
  • FORTRAN Bugs Not Replicated in Python
  • Python Improvements Over FORTRAN
  • Floating-Point Precision
• Comparison Workflows
  • Random query generation
  • Predefined test-file comparison
  • Batch FORTRAN comparison script (random URLs)
  • Output and failure directories
  • Failure artifact collection
  • Server comparison
  • Parameter sweep scripts
  • Quality checks
• FORTRAN vs Python Comparison Framework
  • Prerequisites
  • Usage
  • Complete command-line options
  • Comparison rules
  • FORTRAN setup
  • Programmatic use
• Server Comparison Tests
  • Operations
  • Command-line options
• CGI Parameter Reference
  • General Notes
  • Viewer Parameters
  • Tracker Parameters
  • Ephemeris Generator Parameters