1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
// SPDX-License-Identifier: AGPL-3.0-or-later
// Copyright (C) 2026 Vallés Puig, Ramon
//! # Celestial Mechanics Calculus Module
//!
//! This module provides the core algorithms and data structures for high-precision
//! celestial mechanics calculations in siderust. It is the computational backbone
//! for planetary, lunar, and solar ephemerides, as well as for general orbital mechanics.
//!
//! ## Overview
//!
//! The `calculus` module is organized into several submodules, each responsible for
//! a specific aspect of astronomical computation. The main functionalities include:
//!
//! - **VSOP87 planetary theory**: High-precision positions for the major planets.
//! - **ELP2000 lunar theory**: Accurate lunar positions using the ELP2000-82B model.
//! - **Solar calculations**: Solar coordinates and related phenomena.
//! - **Keplerian orbits**: General elliptical orbit propagation and Kepler's equation solvers.
//! - **Math core**: Reusable root-finding, extrema, intervals, and bracketing algorithms.
//!
//! ## Submodules
//!
//! ### `vsop87`
//! Implements the VSOP87 theory for planetary positions. This includes:
//! - Data tables for VSOP87A/E (and potentially other variants).
//! - Efficient evaluation of planetary heliocentric coordinates (X, Y, Z) as a function of time.
//! - Traits and structures for extensibility and abstraction over different VSOP versions.
//!
//! ### `elp2000`
//! Implements the ELP2000-82B theory for the Moon's position. Features:
//! - Series expansions for lunar longitude, latitude, and distance.
//! - Precession corrections and planetary perturbations.
//! - Functions to compute geocentric ecliptic coordinates of the Moon for any Julian date.
//!
//! ### `solar`
//! Contains algorithms for solar coordinates and related calculations, such as:
//! - Apparent and mean solar longitude/latitude.
//! - Solar equations of time, declination, and related phenomena.
//! - Utility functions for solar ephemerides.
//!
//! ### `kepler_equations`
//! Provides general-purpose routines for elliptical orbit propagation, including:
//! - Solvers for Kepler's equation (Newton-Raphson and bisection methods).
//! - Calculation of true anomaly, eccentric anomaly, and orbital positions.
//! - Conversion between orbital elements and Cartesian coordinates.
//! - Orbital period and mean motion calculations.
//!
//! ### `math_core`
//! Reusable numerical primitives shared by all body-specific modules:
//! - Root-finding (Brent, bisection).
//! - Extremum detection (golden-section, scan+refine).
//! - Interval algebra (crossing detection, above/below/range periods, complement, intersect).
//! - Bracketing/seeding policies.
//!
//! ## Usage
//!
//! This module is intended for internal use by higher-level ephemeris and observer modules,
//! but its public API can be used directly for custom calculations. For example:
//!
//! ```rust
//! use siderust::calculus::kepler_equations::solve_keplers_equation;
//! use qtty::*;
//!
//! let m = 1.0 * RAD;
//! let e = 0.0167;
//! let eccentric_anomaly = solve_keplers_equation(m, e);
//! ```
//!
//! ## Re-exports
//!
//! The module re-exports the most important functions and types from its submodules for convenience:
//! - `kepler_equations::*`
//! - `solar::*`
//!
//! ## References
//!
//! - VSOP87: P. Bretagnon & G. Francou, "Planetary theories in rectangular and spherical variables. VSOP87 solutions", A&A 1988
//! - ELP2000: M. Chapront-Touzé & J. Chapront, "ELP2000-82B: A semi-analytical lunar ephemeris", A&A 1983
//! - Duffett-Smith & Zwart, "Practical Astronomy with your Calculator or Spreadsheet", 4th ed.
//!
//! ## File Structure
//!
//! - `vsop87/` — VSOP87 planetary theory implementation
//! - `elp2000/` — ELP2000 lunar theory implementation
//! - `solar/` — Solar coordinate calculations
//! - `lunar/` — Lunar coordinate calculations
//! - `stellar/` — Stellar altitude period finding (analytical sinusoidal model)
//! - `kepler_equations/`— General orbital mechanics
//! - `math_core/` — Reusable numerical primitives
//! - `altitude.rs` — Unified altitude computation & event API
//!
//! ## See Also
//!
//! - [`coordinates`](../coordinates/index.html): Coordinate systems and transformations
//! - [`units`](../units/index.html): Physical and astronomical units
//! - [`astro`](../astro/index.html): Higher-level astronomical models
//!
//! ---
//! _This module is designed for extensibility and scientific rigor, supporting both
//! high-precision ephemerides and general-purpose celestial mechanics._
//!
pub use Pluto;
pub use VSOP87;