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
139 lines
5.7 KiB
Markdown
139 lines
5.7 KiB
Markdown
# 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
|
||
|
||
1. **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.
|
||
|
||
2. **Tropical (Sayana)** — Default tropical zodiac for compatibility with classical Western techniques. No ayanamsa applied.
|
||
|
||
3. **Whole Sign Houses** — Per Brhat Jataka 1.4: Rasi = Bhava. One sign = one house.
|
||
|
||
4. **High Precision** — NASA JPL DE421 ephemeris via Skyfield. Sun position accurate to <1 arcsecond, Moon to <10 arcseconds.
|
||
|
||
5. **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
|
||
|
||
```bash
|
||
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
|
||
|
||
```bash
|
||
# 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
|
||
|
||
```bash
|
||
python -m jaimini.tests.test_engine # 13 tests: planetary accuracy, houses, time
|
||
python -m jaimini.tests.test_jaimini # 18 tests: karakas, dashas, padas, argala
|
||
```
|