ॐ गं गणपतये नमः

jyotishganit

Professional grade Vedic Astrology Computation Library for Python

jyotishganit is a comprehensive, high precision Python library that brings the ancient wisdom of Jyotisha (Vedic Astrology) to modern computational environments. Built with astronomical accuracy using NASA JPL ephemeris data and designed for both researchers and practitioners, it provides complete birth chart generation with traditional Indian astrological elements.

Key Features

• Astronomical Precision: NASA JPL DE421 ephemeris data via Skyfield for research grade accuracy
• Complete Birth Charts: Full D1-D60 divisional chart calculations following Vedic principles
• Panchanga System: Traditional five limb almanac with Tithi, Nakshatra, Yoga, Karana, Vaara
• Shadbala Calculations: Six fold planetary strength analysis with detailed breakdowns
• Dasha Periods: Vimshottari Dasha system with precise planetary periods. With more under development
• Cross-Platform: Works seamlessly on Windows, macOS, and Linux
• JSON-LD Output: Structured data format for modern web integration
• Developer-Friendly: Clean Python API with comprehensive documentation

🚀 Quick Start

pip install jyotishganit

from datetime import datetime
from jyotishganit import calculate_birth_chart, get_birth_chart_json_string

# Generate a complete Vedic birth chart
chart = calculate_birth_chart(
    birth_date=datetime(1996, 7, 4, 9, 10, 0), # 4th July 1996 9:10 am
    latitude=18.404,   # Karmala, India  
    longitude=75.195,
    timezone_offset=5.5,  # IST
    name="Bhampu"
)

# Access key astrological data
print(f"Ascendant: {chart.d1_chart.houses[0].sign}")
print(f"Moon Sign: {chart.d1_chart.planets[1].sign}")  # Moon is index 1
print(f"Nakshatra: {chart.panchanga.nakshatra}")

# Save the entire chart as JSON
with open("birth_chart.json", "w") as json_file:
    json_file.write(get_birth_chart_json_string(chart))

print("Birth chart saved to birth_chart.json")

Expected output:

Ascendant: Leo
Moon Sign: Aquarius
Nakshatra: Dhanishta
Birth chart saved to birth_chart.json

Comprehensive Astrological Components

Astronomical Foundation

• Planetary Positions: All 9 Vedic grahas (Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu)
• True Chitra Paksha Ayanamsa: Precise sidereal zodiac alignment using Spica star reference
• House System: Traditional whole sign houses with accurate cusp calculations
• Cross-Platform Data Storage: Follows OS conventions for ephemeris data storage

Panchanga (Vedic Almanac)

panchanga = chart.panchanga
print(f"Tithi: {panchanga.tithi}")           # Lunar day (1-30)
print(f"Nakshatra: {panchanga.nakshatra}")   # Moon's constellation
print(f"Yoga: {panchanga.yoga}")             # Sun-Moon combination
print(f"Karana: {panchanga.karana}")         # Half lunar day
print(f"Vaara: {panchanga.vaara}")           # Weekday

Expected output:

Tithi: Krishna Chaturthi
Nakshatra: Dhanishta
Yoga: Priti
Karana: Balava
Vaara: Thursday

Divisional Charts (Varga Chakra)

Complete D1-D60 chart calculations following traditional Vedic methods:

| Chart | Sanskrit Name | Significance | Usage | |-------|------------------------------|--------------------------------------------|----------------------------------------------------------------------| | D1 | Rasi | General life, personality | Primary analysis of overall tendencies and potential | | D2 | Hora | Wealth and financial potential | Detailed analysis of financial prosperity, assets, and savings | | D3 | Drekkana | Courage, siblings, and personal efforts | Analysis of relationships with siblings and personal drive | | D4 | Chaturthamsa | Fixed assets, property, happiness | Analysis of real estate, home life, and general well-being | | D7 | Saptamsa | Children, progeny, and creativity | Analysis of potential for and relationship with children | | D9 | Navamsa | Marriage, dharma, spiritual growth | Reveals inner potential, spouse characteristics, and destiny after marriage | | D10 | Dasamsa | Career, profession, social status | Detailed analysis of professional life, achievements, and public reputation | | D12 | Dwadasamsa | Parents, ancestors, lineage | Analysis of parental and ancestral karma, and inherited traits | | D16 | Shodasamsa | Vehicles, luxuries, material comforts | Evaluation of worldly pleasures, happiness, and conveyances | | D24 | Chaturvimsamsa | Education and learning | Analysis of higher education, knowledge, and academic achievements | | D27 | Bhamsha / Saptavimsamsa | Physical strength and weaknesses | Evaluation of overall vitality, stamina, and resilience | | D30 | Trimsamsa | Misfortunes, evils, and suffering | Analysis of adversities, health issues, and hidden troubles | | D60 | Shashtiamsa | Past life karmas, deep-rooted destiny | Final confirmation for predictions, revealing inherited blessings and karmic debt |

# Access any divisional chart
navamsa = chart.divisional_charts['d9']
for house in navamsa.houses:
    for planet in house.occupants:
        print(f"{planet.celestial_body} in {planet.sign}")

Expected output:

Venus in Gemini
Rahu in Gemini
Mars in Cancer
Jupiter in Virgo
Moon in Libra
Saturn in Scorpio
Ketu in Sagittarius
Mercury in Capricorn
Sun in Pisces

Shadbala (Six-Fold Strength System)

Comprehensive planetary strength analysis with traditional calculations:

sun = chart.d1_chart.planets[0]  # Sun
shadbala = sun.shadbala['Shadbala']

print(f"Total Shadbala: {shadbala['Total']:.2f}")
print(f"Strength in Rupas: {shadbala['Rupas']:.2f}")

# Detailed breakdown
print(f"Positional Strength: {shadbala['Sthanabala']:.2f}")
print(f"Temporal Strength: {shadbala['Kaalabala']:.2f}")  
print(f"Directional Strength: {shadbala['Digbala']:.2f}")
print(f"Motional Strength: {shadbala['Cheshtabala']:.2f}")
print(f"Natural Strength: {shadbala['Naisargikabala']:.2f}")
print(f"Aspectual Strength: {shadbala['Drikbala']:.2f}")

Expected output:

Total Shadbala: 587.09
Strength in Rupas: 9.79
Positional Strength: 130.87
Temporal Strength: 222.92
Directional Strength: 48.78
Motional Strength: 117.13
Natural Strength: 60.00
Aspectual Strength: 7.39

Ashtakavarga System

Traditional point-based strength calculation:

# Get Sarvashtakavarga (combined points for all planets)
sarva = chart.ashtakavarga.sav
for sign, points in sarva.items():
    print(f"{sign}: {points} points")

# Individual planet ashtakavarga (Bhinnashktakavarga)  
sun_ak = chart.ashtakavarga.bhav['Sun']
print(f"Sun's contribution to each sign: {sun_ak}")

Expected output:

Aries: 31 points
Taurus: 27 points
Gemini: 29 points
Cancer: 24 points
Leo: 27 points
Virgo: 24 points
Libra: 33 points
Scorpio: 31 points
Sagittarius: 27 points
Capricorn: 29 points
Aquarius: 22 points
Pisces: 33 points
Sun's contribution to each sign: {'Aries': 6, 'Taurus': 4, 'Gemini': 4, 'Cancer': 3, 'Leo': 3, 'Virgo': 2, 'Libra': 5, 'Scorpio': 6, 'Sagittarius': 4, 'Capricorn': 4, 'Aquarius': 3, 'Pisces': 4}

Dasha Periods (Planetary Periods)

Precise Vimshottari Dasha calculations:

dashas = chart.dashas
print('\n\n'.join(['Mahadasha: %s\n  Start: %s\n  End:   %s' % (lord, md['start'], md['end']) for lord, md in list(dashas.upcoming['mahadashas'].items())[:3]]))

Expected output:

Mahadasha: Jupiter
    Start: 2017-06-21 
    End:   2033-06-22 

Planetary Dignities

Access planetary dignities for any planet. Example (Mars):

mars = next(p for p in chart.d1_chart.planets if p.celestial_body == "Mars")
print(f"Mars dignities: {mars.dignities}")

Expected output:

Mars dignities: PlanetDignities(dignity='neutral', planet_tattva='Fire', rashi_tattva='Earth', friendly_tattvas=['Air', 'Fire'])

Graha Drishti (Planetary Aspects)

Traditional Vedic aspectual relationships:

# Planets aspecting and aspected
jupiter = next(p for p in chart.d1_chart.planets if p.celestial_body == "Jupiter")

# Houses aspected by Jupiter
houses_aspected = [aspect['to_house'] for aspect in jupiter.aspects['gives'] if 'to_house' in aspect]
print(f"Jupiter aspects houses: {houses_aspected}")

# Planets aspecting Jupiter  
aspected_by = [aspect['from_planet'] for aspect in jupiter.aspects['receives']]
print(f"Jupiter is aspected by: {aspected_by}")

Expected output:

Jupiter aspects houses: [1, 11, 9]
Jupiter is aspected by: ['Mars', 'Saturn', 'Mercury', 'Sun']

Installation

Standard Installation

pip install jyotishganit

Development Installation

git clone https://github.com/northtara/jyotishganit.git
cd jyotishganit
pip install -e .

Data Storage

Ephemeris data is automatically stored in platform-approp