732642856
f83db2fac1
- add external validation reports and open-source comparison references - integrate Jaimini arudha/graha pada, enhanced argala, and additional synastry kutas - update skill docs and capability matrices - add smoke tests for open-source integrations
Jaimini Tropical Astrology Engine
A high-precision Jaimini astrology computation engine using the Tropical Zodiac (Sayana). Built from scratch based on Iranganti Rangacharya's authoritative works — Jaimini Sutramritam and Jyotish-Prasana.
Key differentiator: All existing Jaimini/Vedic libraries use the Sidereal zodiac (Lahiri Ayanamsa). This is the first engine built for the Tropical zodiac, making Jaimini techniques compatible with classical Western astrology (Hermetic Lots, etc.).
Design Principles
-
Purely Jaimini — No Parashara/BPHS contamination. No Vimshottari Dasha, no Shadbala, no planetary aspects. Jaimini is treated as a self-contained, independent system per Iranganti Rangacharya's teachings.
-
Tropical (Sayana) — Default tropical zodiac for compatibility with classical Western techniques. No ayanamsa applied.
-
Whole Sign Houses — Per Brhat Jataka 1.4: Rasi = Bhava. One sign = one house.
-
High Precision — NASA JPL DE421 ephemeris via Skyfield. Sun position accurate to <1 arcsecond, Moon to <10 arcseconds.
-
Data over Graphics — Output is precise numerical tables, not visual chart wheels. Every calculation is transparent and reproducible.
Features
Layer 1: Planetary Positions (JPL DE421)
- All 7 classical planets + Rahu/Ketu + outer planets
- Tropical longitude to 6 decimal places
- Speed (deg/day), retrograde detection, ecliptic latitude
Layer 2: Chara Karaka & Arudha Pada
- 7 Chara Karakas (Atmakaraka through Darakaraka) by degree-within-sign ranking
- 12 Arudha Padas (A1-A12) with standard exception rules
- Upapada (UL) for spouse analysis
Layer 3: Special Lagnas (Ghati-based time differentiation)
- Hora Lagna (HL / Yin-Yang Fortune) — ~1 hour sensitivity
- Ghatika Lagna (GL / Five-Element Fortune) — 24 minute sensitivity
- Varnada Lagna (VL / Palace Origin) — derived from Ascendant
Layer 4: Divisional Charts
- D-9 Navamsa — Jaimini's Yang-forward/Yin-reverse mapping
- D-3 Drekkana — Parivrittitraya method
- D-12 Dwadashamsha
Argala Analysis (Jaimini Judgment System)
- Primary Argala (houses 2, 4, 11) — positive planetary intervention
- Virodhargala obstruction (houses 12, 10, 3)
- Specific Argala (house 3 with 2+ malefics)
- Secondary Argala (houses 5, 9)
- Argala Rajayoga classification (Poorna/Tripada/Ardha/Padargala)
- Karakamsa Rajayoga (AK in Navamsa analysis)
Chara Dasha (Variable-Period System)
- Full 12-sign Mahadasha timeline from birth
- Prakriti Chakra sign sequence
- Antar (Bhukti) sub-periods with proportional year distribution
Quick Start
pip install skyfield numpy
python run_jaimini.py "1949-10-01" "15:00:00" "+8" "39.907" "116.397"
Input Format
python run_jaimini.py <date> <time> <timezone> <latitude> <longitude> [options]
Options:
--name, -n Chart name/label
--house-system, -hs House system: W=Whole Sign (default), P=Placidus, E=Equal
--include-rahu, -r Use 8-karaka system (includes Rahu)
--dasha-only, -d Show only Dasha timeline
--karakas-only, -k Show only Karaka assignments
--output, -o Save output to file
Examples
# New China chart (Beijing, 1949-10-01 15:00 CST)
python run_jaimini.py "1949-10-01" "15:00:00" "+8" "39.907" "116.397" --name "New China"
# DMS format coordinates
python run_jaimini.py "2025-06-15" "06:30:00" "+5.5" "28°36′50″" "77°12′30″" --dasha-only
# Save full analysis to file
python run_jaimini.py "1949-10-01" "15:00:00" "+8" "39.907" "116.397" -o chart.txt
Project Structure
jaimini/
├── engine/ # Astronomical engine (Skyfield/JPL DE421)
│ ├── ephemeris.py # Planetary positions — tropical
│ ├── houses.py # Whole Sign / Placidus houses + sunrise
│ └── time_utils.py # Julian Day, DMS conversion, timezone
├── core/ # Jaimini-specific calculations
│ ├── karakas.py # Chara Karaka (7-planet system)
│ ├── dashas.py # Chara Dasha + Antar/Bhukti
│ ├── padas.py # Arudha Pada (A1-A12, Upapada)
│ ├── lagnas.py # HL, GL, VL special lagnas
│ ├── divisions.py # Jaimini D-9, D-3, D-12
│ └── argala.py # Argala/Virodhargala + Rajayoga
├── chart/ # Chart integration
│ └── chart.py # Chart object (all calculations)
├── cli/ # Command-line interface
│ └── main.py
├── tests/ # Validation tests (31/31 passing)
│ ├── test_engine.py # Astronomical accuracy tests
│ └── test_jaimini.py # Jaimini calculation tests
└── run_jaimini.py # Entry point
Accuracy
| Measurement | Accuracy | Verification |
|---|---|---|
| Sun longitude | <0.002° (~7 arcsec) | Swiss Ephemeris swetest64.exe |
| Moon longitude | <0.01° (~36 arcsec) | Swiss Ephemeris swetest64.exe |
| DE421 vs DE431 | ~0.5 arcsec (Sun) | JPL ephemeris version difference |
Reference: 1949-10-01 07:00 UTC chart verified against official swetest64.exe output.
Sources
- Iranganti Rangacharya, Jaimini Sutramritam (Translation and Commentary in English)
- Umang Taneja, Jyotish-Prasana: A Contemporary Treatise Using KP Prasna
- Skyfield — NASA JPL DE421 ephemeris (MIT licensed)
- dashaflow — Algorithm reference for Arudha Pada and Karakamsa (MIT licensed)
License
MIT License — see LICENSE file.
Running Tests
python -m jaimini.tests.test_engine # 13 tests: planetary accuracy, houses, time
python -m jaimini.tests.test_jaimini # 18 tests: karakas, dashas, padas, argala