LibEphemeris Documentation #

Getting Started #

• Getting Started – Installation, ephemeris tiers, first calculations, thread safety
• Migration from PySwissEph – API mapping and behavioral differences
• Precision Tuning – Configuring optional dependencies for maximum precision
• Computation Tracing – Discover which backend computed each body (ContextVar + DEBUG logging)

Architecture #

• Calculation Backends – Auto/LEB/Horizons/Skyfield mode selection
• Horizons API Backend – Zero-install ephemeris via NASA JPL Horizons REST API
• Architecture Overview – Codebase metrics, module structure, performance analysis

Reference #

• Flag Reference – Complete calculation flag documentation with examples
• Precision Report – Measured accuracy across all body categories
• Known Divergences – Documented differences vs reference implementations
• House Systems – Mathematical documentation for all 25 house systems (26 codes with A/E alias)
• Ayanamsha Modes – Complete reference for all 43 sidereal zodiac modes
• Known Bugs – Active issues and Horizons limitations
• Comparison Report – 1,619 cross-validation tests

Methodology #

• Overview – Principal computational approaches
• Planet Centers – Barycenter vs body center corrections for outer planets
• Lunar Apsides – Perigee and apogee computation
• Interpolated Apogee – SE_INTP_APOG and SE_INTP_PERG
• Interpolated Perigee – Passage-interpolated harmonic fitting
• True Lilith – Osculating lunar apogee calculation
• pyerfa Integration – IAU standard nutation, precession, obliquity
• REBOUND Integration – N-body minor body orbit propagation

LEB Binary Ephemeris #

• Technical Guide – Format specification, reader, fast-path pipeline, LEB2 compressed format
• Algorithms & Theory – Chebyshev polynomials, Clenshaw, gravitational deflection, error analysis
• Comparison Testing – LEB vs Skyfield comparison methodology

Development #

• Testing – Test suites, commands, expected failures
• Roadmap – Project status and open tasks
• Precision History – Record of precision fixes and investigations
• Keplerian Improvements – Fallback orbit propagation improvements
• Full Range Coverage – Extending minor body coverage

Manuals #

Beginner-friendly introductions to astronomical and astrological calculations. No prior knowledge of astronomy or programming required.

• Manuale (Italiano) – 15 capitoli
• Manual (English) – 15 chapters