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
// SPDX-License-Identifier: AGPL-3.0-or-later
// Copyright (C) 2026 Vallés Puig, Ramon
//! # Astro Module
//!
//! Top-level entry point for siderust's astronomical calculations, gathering
//! the IAU-aligned models for Earth rotation, sidereal time, precession,
//! nutation, aberration, light deflection, proper motion, and orbital
//! mechanics under a single namespace.
//!
//! ## Scientific scope
//!
//! The submodules implement the standard chain of effects required to relate
//! catalogue (BCRS/GCRS) directions to the apparent positions seen by a
//! ground- or space-based observer at a given epoch: precession and nutation
//! of the Earth's equator, Earth Orientation Parameters, sidereal/Earth-
//! rotation angles, polar motion, stellar aberration, gravitational light
//! deflection, proper motion of stars, and Keplerian/conic orbital
//! propagation. Together they provide an IAU 2006/2000A-compliant
//! astrometric reduction pipeline.
//!
//! ## Technical scope
//!
//! Each submodule is a thin, typed wrapper around the relevant SOFA/IERS
//! algorithms expressed in terms of `qtty` quantities and `tempoch` time
//! scales rather than raw `f64`. Models are selected at compile time via
//! marker types (e.g. the [`nutation`] family) so that transform paths
//! remain zero-cost. The [`orientation`] re-export exposes the IAU pole and
//! prime-meridian rotation parameters used for planetary body frames.
//!
//! ## Submodules
//!
//! - [`aberration`]: stellar aberration via the full Lorentz transform.
//! - [`cio`]: CIP `(X, Y)` coordinates and CIO locator `s`.
//! - [`conic`], [`orbit`]: conic-section and Keplerian orbital mechanics.
//! - [`earth_rotation`], [`earth_rotation_provider`], [`era`]: TT↔UT1, ERA,
//! and the composite ITRS→equatorial rotation.
//! - [`eop`]: Earth Orientation Parameters backed by `tempoch` EOP data.
//! - [`iers_data`]: IERS EOP data re-exported from `tempoch`.
//! - [`light_deflection`]: GR deflection by the Sun and planets.
//! - [`nutation`]: IAU 2000A/2000B/2006A nutation models.
//! - [`orientation`]: IAU body pole / prime-meridian parameters.
//! - [`polar_motion`]: polar-motion matrix `W`.
//! - [`precession`]: IAU 2006 (Fukushima-Williams) precession.
//! - [`proper_motion`]: stellar proper-motion propagation.
//! - [`sidereal`][]: GMST/GAST/LST.
//! - [`units`]: astronomical units (e.g. Gaussian year) not covered by `qtty`.
//!
//! ## References
//!
//! * IERS Conventions (2010)
//! * IAU 2000 Resolution B1, IAU 2006 Resolution B1
//! * SOFA software collection
pub use ;