jyotish 1.0.0

Jyotish — astronomical computation engine for planetary positions, calendar systems, and celestial event prediction
Documentation 
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
119
120

//! # Jyotish
//!
//! **Jyotish** (ज्योतिष — Sanskrit for "science of light", the traditional term
//! for Vedic astrology and astronomical computation) — astronomical computation
//! engine for the AGNOS ecosystem.
//!
//! Provides planetary position computation, calendar system conversions, celestial
//! event prediction, zodiac/constellation mapping, house systems, aspect
//! computation, and transit tracking.
//!
//! ## Optional features
//!
//! - **`orbital`** — high-fidelity orbital mechanics integration via
//!   [falak](https://crates.io/crates/falak).
//! - **`logging`** — tracing-subscriber initialization via `JYOTISH_LOG` env var.

#![warn(missing_docs)]
#![forbid(unsafe_code)]

/// Error types for jyotish computations.
pub mod error;

/// Numerical utilities (compensated summation, etc.).
pub mod num;

/// Delta T (TT − UT1) computation and time scale conversions.
pub mod delta_t;

/// Planetary bodies and position data.
pub mod planet;

/// Calendar systems — Julian, Gregorian, sidereal time, Julian Day Number conversions.
pub mod calendar;

/// Coordinate systems and transformations.
pub mod coords;

/// Solar position computation.
pub mod sun;

/// Lunar position computation.
pub mod moon;

/// Planetary position computation (Mercury through Pluto).
pub mod planetary;

/// Nutation and precession corrections.
pub mod nutation;

/// ELP2000-82 lunar theory — high-precision geocentric lunar coordinates.
pub mod elp2000;

/// VSOP87D planetary theory — heliocentric ecliptic coordinates (J2000.0).
pub mod vsop87;

/// Annual aberration and light-time correction.
pub mod aberration;

/// Apparent position pipeline (geometric → aberration → nutation → apparent).
pub mod apparent;

/// Lunar phase computation — New Moon, First Quarter, Full Moon, Last Quarter.
pub mod phase;

/// Eclipse prediction — solar and lunar eclipse detection and classification.
pub mod eclipse;

/// Celestial events — eclipses, conjunctions, oppositions, transits, equinoxes, solstices.
pub mod event;

/// Zodiac signs and constellations — tropical, sidereal, bounds, cusps.
pub mod zodiac;

/// House systems — Placidus, Koch, Equal, Whole Sign, Porphyry.
pub mod house;

/// Planetary aspects — conjunction, opposition, trine, square, sextile, orbs.
pub mod aspect;

/// Planetary transits — ingress, retrograde, station, direct motion.
pub mod transit;

/// Rise, set, and meridian transit times.
pub mod riseset;

/// Parallax correction for topocentric positions.
pub mod parallax;

/// Physical ephemerides — apparent diameter, phase angle, illumination, elongation.
pub mod physical;

/// Fixed star catalog — navigational stars with proper motion.
pub mod star;

/// Atmospheric refraction corrections.
pub mod refraction;

/// Planetary phenomena — elongation, opposition, conjunction, station detection.
pub mod phenomena;

#[cfg(feature = "orbital")]
/// High-fidelity orbital mechanics via falak.
pub mod orbital;

#[cfg(feature = "logging")]
/// Logging initialization for the jyotish crate.
pub mod logging;

// --- Core re-exports ---
pub use apparent::{
    PositionType, TypedPosition, apparent_moon, apparent_position, apparent_sun, geometric_position,
};
pub use calendar::{
    DAYS_PER_JULIAN_CENTURY, J2000_0, JD_UNIX_EPOCH, day_of_week, gmst_degrees, gmst_degrees_tt,
    gmst_hours, gregorian_to_jd, gregorian_to_jdn, is_gregorian_leap_year, is_julian_leap_year,
    jd_to_gregorian, jd_to_unix, jdn_to_gregorian, jdn_to_julian, julian_centuries, julian_to_jdn,
    local_sidereal_time, local_sidereal_time_tt, unix_to_jd,
};
pub use error::{JyotishError, Result};
pub use planet::{Planet, PlanetaryPosition};