API Reference¶

from vedic_calc import calculate_chart

chart = calculate_chart(
    year=1990,
    month=3,
    day=15,
    hour=10,
    minute=30,
    second=0,
    latitude=19.0760,     # Mumbai
    longitude=72.8777,
    timezone_offset=5.5,  # IST = UTC+5:30
)

from vedic_calc import calculate_chart, calculate_dasha

chart = calculate_chart(1990, 3, 15, 10, 30, 0, 19.076, 72.878, 5.5)
periods = calculate_dasha(chart, levels=2)

# Print mahadashas
for p in periods:
    if p.level == "mahadasha":
        print(f"{p.lord.name}: {p.start.date()} → {p.end.date()} ({p.duration_years:.1f} yrs)")

from vedic_calc import get_current_dasha
from datetime import datetime

current = get_current_dasha(chart, datetime(2026, 3, 8))
print(f"Mahadasha:       {current[0].lord.name}")   # e.g., SATURN
print(f"Antardasha:      {current[1].lord.name}")   # e.g., VENUS
print(f"Pratyantardasha: {current[2].lord.name}")   # e.g., KETU

from vedic_calc import calculate_panchanga

p = calculate_panchanga(
    year=2026, month=3, day=8,
    latitude=19.076, longitude=72.878,
    timezone_offset=5.5,
)

print(f"Vara:      {p.vara}")
print(f"Tithi:     {p.tithi_name}")
print(f"Nakshatra: {p.nakshatra.name}")
print(f"Yoga:      {p.yoga_name}")
print(f"Karana:    {p.karana_name}")
print(f"Sunrise:   {p.sunrise}")
print(f"Sunset:    {p.sunset}")

from vedic_calc import calculate_panchanga_transitions

t = calculate_panchanga_transitions(
    year=2026, month=3, day=8,
    latitude=19.076, longitude=72.878,
    timezone_offset=5.5,
)

print(f"Sunrise: {t.sunrise}")
for m in t.transitions:
    print(f"  {m.transition_time.strftime('%H:%M')} — {m.element}: {m.from_name} → {m.to_name}")

from vedic_calc import calculate_chart, render_south_indian

chart = calculate_chart(1990, 3, 15, 10, 30, 0, 19.076, 72.878, 5.5)
print(render_south_indian(chart))

from vedic_calc import render_north_indian
print(render_north_indian(chart))

from vedic_calc import render_svg

# South Indian (default)
svg = render_svg(chart, style="south")

# North Indian
svg = render_svg(chart, style="north")

# Save to file
with open("chart.svg", "w") as f:
    f.write(svg)

chart.planets          # dict[Planet, PlanetPosition] — all 9 planets
chart.houses           # list[HousePosition] — 12 houses
chart.ascendant        # PlanetPosition — the rising sign
chart.ayanamsa         # Ayanamsa — which mode was used
chart.ayanamsa_degrees # float — ayanamsa value in degrees
chart.birth_datetime   # datetime — birth date/time (local)
chart.latitude         # float
chart.longitude        # float
chart.timezone_offset  # float

# Serialize to JSON
json_str = chart.model_dump_json(indent=2)

# Convert to dict
data = chart.model_dump()

pos = chart.planets[Planet.MOON]

pos.planet            # Planet.MOON
pos.longitude         # 192.55 (sidereal degrees, 0-360)
pos.sign              # Sign.LIBRA
pos.degree_in_sign    # 12.55 (degrees within the sign, 0-30)
pos.nakshatra_info    # NakshatraInfo (see below)
pos.is_retrograde     # False

nak = pos.nakshatra_info

nak.nakshatra            # Nakshatra.SWATI
nak.pada                 # 2 (quarter, 1-4)
nak.lord                 # Planet.RAHU (ruling planet)
nak.degree_in_nakshatra  # 5.88 (degrees within this nakshatra)

house = chart.houses[0]  # 1st house

house.house_number  # 1
house.sign          # Sign.TAURUS
house.lord          # Planet.VENUS

period.lord            # Planet.SATURN
period.level           # "mahadasha", "antardasha", or "pratyantardasha"
period.start           # datetime(2016, 4, 4, ...)
period.end             # datetime(2035, 4, 5, ...)
period.duration_years  # 19.0

p.date            # datetime — the date
p.vara            # "Sunday (Ravivara)"
p.tithi_number    # 20 (1-30)
p.tithi_name      # "Krishna Panchami"
p.nakshatra       # Nakshatra.SWATI
p.yoga_number     # 12 (1-27)
p.yoga_name       # "Dhruva"
p.karana_number   # 39 (1-60)
p.karana_name     # "Kaulava"
p.sunrise         # datetime or None
p.sunset          # datetime or None

from vedic_calc.core.constants import Planet

Planet.SUN      # 0
Planet.MOON     # 1
Planet.MARS     # 2
Planet.MERCURY  # 3
Planet.JUPITER  # 4
Planet.VENUS    # 5
Planet.SATURN   # 6
Planet.RAHU     # 7
Planet.KETU     # 8

from vedic_calc.core.constants import Sign

Sign.ARIES       # 1
Sign.TAURUS      # 2
# ... through ...
Sign.PISCES      # 12

from vedic_calc.core.constants import Nakshatra

Nakshatra.ASHWINI   # 1
Nakshatra.BHARANI   # 2
# ... through ...
Nakshatra.REVATI    # 27

from vedic_calc.core.constants import Ayanamsa

Ayanamsa.LAHIRI              # 1 — most common in India
Ayanamsa.RAMAN               # 3
Ayanamsa.KP                  # 5 — Krishnamurti Paddhati
Ayanamsa.TRUE_CHITRAPAKSHA   # 27

from vedic_calc import calculate_chart, calculate_divisional_chart

chart = calculate_chart(1990, 3, 15, 10, 30, 0, 19.076, 72.878, 5.5)
navamsa = calculate_divisional_chart(chart, division=9)

for planet, pos in navamsa.planets.items():
    print(f"{planet.name}: {pos.sign.name}")

from vedic_calc import calculate_chart, calculate_aspects

chart = calculate_chart(1990, 3, 15, 10, 30, 0, 19.076, 72.878, 5.5)
aspects = calculate_aspects(chart)

for a in aspects:
    print(f"{a.aspecting_planet.name} aspects house {a.aspected_house} ({a.aspect_type})")

from vedic_calc import calculate_chart, calculate_combustion

chart = calculate_chart(1990, 3, 15, 10, 30, 0, 19.076, 72.878, 5.5)
combustion = calculate_combustion(chart)

for c in combustion:
    if c.is_combust:
        print(f"{c.planet.name} is combust ({c.angular_distance:.1f}° from Sun)")

from vedic_calc import calculate_chart, calculate_planet_states

chart = calculate_chart(1990, 3, 15, 10, 30, 0, 19.076, 72.878, 5.5)
states = calculate_planet_states(chart)

for planet, state in states.items():
    print(f"{planet.name}: {state.dignity}, vargottama={state.is_vargottama}")

from vedic_calc import calculate_chart, analyze_houses

chart = calculate_chart(1990, 3, 15, 10, 30, 0, 19.076, 72.878, 5.5)
houses = analyze_houses(chart)

for h in houses:
    print(f"House {h.house_number}: {h.sign.name}, lord={h.lord.name}, "
          f"occupants={[p.name for p in h.occupants]}")

from vedic_calc import calculate_transit_chart

transit = calculate_transit_chart(
    year=2026, month=3, day=17,
    hour=12, minute=0,
    latitude=19.076, longitude=72.878,
    timezone_offset=5.5,
)

for planet, pos in transit.planets.items():
    print(f"{planet.name}: {pos.sign.name} {pos.degree_in_sign:.1f}°")

from vedic_calc import calculate_chart, calculate_event_timeline
from datetime import datetime

chart = calculate_chart(1990, 3, 15, 10, 30, 0, 19.076, 72.878, 5.5)
timeline = calculate_event_timeline(chart, datetime(1990, 1, 1), datetime(2050, 1, 1))

for event in timeline.events:
    print(f"{event.date.date()} [{event.event_type}] {event.description}")

from vedic_calc import calculate_chart, detect_yogas

chart = calculate_chart(1990, 3, 15, 10, 30, 0, 19.076, 72.878, 5.5)
yogas = detect_yogas(chart)

for y in yogas:
    if y.is_present:
        print(f"{y.name} ({y.category}): {y.description}")

from vedic_calc import calculate_chart, score_yogas

chart = calculate_chart(1990, 3, 15, 10, 30, 0, 19.076, 72.878, 5.5)
scored = score_yogas(chart)

for y in scored:
    if y.is_present:
        print(f"{y.name}: strength={y.strength}/100")
        for f in y.factors:
            print(f"  {f.name}: {f.description}")

from vedic_calc import calculate_chart, detect_doshas

chart = calculate_chart(1990, 3, 15, 10, 30, 0, 19.076, 72.878, 5.5)
doshas = detect_doshas(chart)

for d in doshas:
    status = "PRESENT" if d.is_present else "absent"
    cancelled = " (cancelled)" if d.is_cancelled else ""
    print(f"{d.name}: {status}{cancelled}")

from vedic_calc import calculate_chart, score_doshas

chart = calculate_chart(1990, 3, 15, 10, 30, 0, 19.076, 72.878, 5.5)
scored = score_doshas(chart)

for d in scored:
    if d.is_present:
        print(f"{d.name}: severity={d.severity_score}/100")
        for f in d.factors:
            print(f"  {f.name}: {f.description}")

from vedic_calc import calculate_chart, calculate_compatibility

chart1 = calculate_chart(1990, 3, 15, 10, 30, 0, 19.076, 72.878, 5.5)
chart2 = calculate_chart(1992, 7, 20, 14, 0, 0, 19.076, 72.878, 5.5)

result = calculate_compatibility(chart1, chart2)
print(f"Total: {result.total_points}/36")
for factor in result.factors:
    print(f"  {factor.name}: {factor.obtained}/{factor.maximum}")

from vedic_calc import calculate_chart, calculate_porutham
result = calculate_porutham(chart1, chart2)

from vedic_calc import calculate_chart, calculate_papasamyam

chart1 = calculate_chart(1990, 3, 15, 10, 30, 0, 19.076, 72.878, 5.5)
chart2 = calculate_chart(1992, 7, 20, 14, 0, 0, 19.076, 72.878, 5.5)

result = calculate_papasamyam(chart1, chart2)
print(f"Person 1: {result.person1.total:.1f} pts, Person 2: {result.person2.total:.1f} pts")
print(f"Balanced: {result.is_balanced}")
print(result.description)

from vedic_calc import calculate_chart, calculate_shadbala

chart = calculate_chart(1990, 3, 15, 10, 30, 0, 19.076, 72.878, 5.5)
strengths = calculate_shadbala(chart)

for planet, sb in strengths.items():
    print(f"{planet.name}: total={sb.total_rupas:.2f} rupas "
          f"(required={sb.required_rupas:.2f})")

from vedic_calc import calculate_chart, calculate_ashtakavarga

chart = calculate_chart(1990, 3, 15, 10, 30, 0, 19.076, 72.878, 5.5)
av = calculate_ashtakavarga(chart)

# Sarvashtakavarga (sum across all planets per sign)
for sign, points in av.sarvashtakavarga.items():
    print(f"{sign.name}: {points} bindus")

from vedic_calc import calculate_muhurta

m = calculate_muhurta(2026, 3, 17, 19.076, 72.878, 5.5)
rk_start, rk_end = m.rahu_kalam
print(f"Rahu Kalam: {rk_start.strftime('%H:%M')} - {rk_end.strftime('%H:%M')}")
print(f"Abhijit: {m.abhijit_muhurta[0].strftime('%H:%M')} - {m.abhijit_muhurta[1].strftime('%H:%M')}")

from vedic_calc import find_muhurta_windows

result = find_muhurta_windows(
    activity="marriage",
    start_date=(2026, 4, 1),
    end_date=(2026, 4, 30),
    latitude=19.076, longitude=72.878,
    timezone_offset=5.5,
    natal_moon_nakshatra=4,  # Rohini
    natal_moon_sign=2,       # Taurus
    max_results=5,
)

for w in result.windows:
    print(f"{w.start.date()} score={w.score:.0f}: {', '.join(w.reasoning)}")

from vedic_calc import cast_prashna_chart

chart = cast_prashna_chart(
    year=2026, month=3, day=17,
    hour=14, minute=30,
    latitude=19.076, longitude=72.878,
    timezone_offset=5.5,
)

from vedic_calc import cast_prashna_chart, evaluate_prashna

chart = cast_prashna_chart(2026, 3, 17, 14, 30, 0, 19.076, 72.878, 5.5)
verdict = evaluate_prashna(chart, query_house=10)  # Career question

print(f"Verdict: {verdict.verdict}")  # "favorable" / "unfavorable" / "mixed"
for reason in verdict.reasoning:
    print(f"  - {reason}")

from vedic_calc import cast_prashna_chart, detect_tajika_yogas

chart = cast_prashna_chart(2026, 3, 17, 14, 30, 0, 19.076, 72.878, 5.5)
yogas = detect_tajika_yogas(chart, query_house=10)

for y in yogas:
    if y.is_present:
        print(f"{y.name}: {y.significance} — {y.description}")

from vedic_calc import calculate_chart, calculate_chara_karakas

chart = calculate_chart(1990, 3, 15, 10, 30, 0, 19.076, 72.878, 5.5)
karakas = calculate_chara_karakas(chart)

for k in karakas:
    print(f"{k.karaka_name}: {k.planet.name} ({k.degree_in_sign:.1f}°)")

from vedic_calc import calculate_chart, calculate_arudha_padas

chart = calculate_chart(1990, 3, 15, 10, 30, 0, 19.076, 72.878, 5.5)
arudhas = calculate_arudha_padas(chart)

for a in arudhas:
    print(f"A{a.house_number} ({a.name}): {a.sign.name}")

from vedic_calc import calculate_chart, calculate_varshaphal

birth_chart = calculate_chart(1990, 3, 15, 10, 30, 0, 19.076, 72.878, 5.5)
varsha = calculate_varshaphal(birth_chart, target_year=2026)

print(f"Year Lord: {varsha.year_lord.name}")
print(f"Muntha: {varsha.muntha.sign.name} (house {varsha.muntha.house})")
for md in varsha.mudda_dasha[:3]:
    print(f"  {md.lord.name}: {md.start.date()} - {md.end.date()}")

from vedic_calc import calculate_chart, calculate_varshaphal, calculate_panchavargeeya_bala

birth = calculate_chart(1990, 3, 15, 10, 30, 0, 19.076, 72.878, 5.5)
varsha = calculate_varshaphal(birth, year=2026)
bala = calculate_panchavargeeya_bala(varsha.annual_chart)

for b in bala:
    print(f"{b.planet.name}: D1={b.d1_dignity} D2={b.d2_dignity} D3={b.d3_dignity} "
          f"D9={b.d9_dignity} D12={b.d12_dignity} → {b.total_points}/20")

from vedic_calc import calculate_chart, calculate_kp_chart

chart = calculate_chart(1990, 3, 15, 10, 30, 0, 19.076, 72.878, 5.5)
kp = calculate_kp_chart(chart)

for cusp in kp.cusps:
    print(f"House {cusp.house_number}: {cusp.sign.name} {cusp.degree:.1f}° "
          f"(sub-lord: {cusp.sublord.name})")

from vedic_calc import get_kp_sublord

info = get_kp_sublord(45.0)  # 15° Taurus
print(f"Star lord: {info.star_lord.name}, Sub-lord: {info.sub_lord.name}")

from vedic_calc import calculate_chart, get_kp_significators

chart = calculate_chart(1990, 3, 15, 10, 30, 0, 19.076, 72.878, 5.5)
sigs = get_kp_significators(chart)

for s in sigs:
    print(f"{s.planet.name}: L1={s.level1_houses} L2={s.level2_houses} "
          f"L3={s.level3_houses} L4={s.level4_houses} → {s.all_signified_houses}")

from vedic_calc import calculate_chart, get_kp_house_significators

chart = calculate_chart(1990, 3, 15, 10, 30, 0, 19.076, 72.878, 5.5)
house_sigs = get_kp_house_significators(chart)

for h in house_sigs:
    names = [p.name for p in h.significators]
    print(f"House {h.house_number}: {', '.join(names)}")

from vedic_calc import calculate_numerology

result = calculate_numerology(
    year=1990, month=3, day=15,
    full_name="Rahul Sharma",
)

print(f"Destiny: {result.destiny_number}")
print(f"Radical: {result.radical_number}")
print(f"Name: {result.name_number}")
print(f"Lucky numbers: {result.lucky_numbers}")

from vedic_calc import calculate_chart, calculate_sudarshana_chakra

chart = calculate_chart(1990, 3, 15, 10, 30, 0, 19.076, 72.878, 5.5)
chakra = calculate_sudarshana_chakra(chart)

for ring_name, ring in [("Lagna", chakra.lagna_ring), ("Moon", chakra.moon_ring), ("Sun", chakra.sun_ring)]:
    print(f"\n{ring_name} Ring:")
    for h in ring:
        planets = [p.name for p in h.planets]
        print(f"  House {h.house_number}: {h.sign.name} {planets or ''}")

from vedic_calc import calculate_chart, calculate_yogini_dasha

chart = calculate_chart(1990, 3, 15, 10, 30, 0, 19.076, 72.878, 5.5)
periods = calculate_yogini_dasha(chart)

from vedic_calc import calculate_chart, calculate_ashtottari_dasha

chart = calculate_chart(1990, 3, 15, 10, 30, 0, 19.076, 72.878, 5.5)
periods = calculate_ashtottari_dasha(chart)

from vedic_calc import calculate_chart, calculate_narayana_dasha

chart = calculate_chart(1990, 3, 15, 10, 30, 0, 19.076, 72.878, 5.5)
periods = calculate_narayana_dasha(chart)

from vedic_calc import calculate_chart, calculate_special_lagnas

chart = calculate_chart(1990, 3, 15, 10, 30, 0, 19.076, 72.878, 5.5)
lagnas = calculate_special_lagnas(chart)

for l in lagnas:
    print(f"{l.name}: {l.sign.name} {l.degree_in_sign:.1f}°")

from vedic_calc import calculate_chart, calculate_upagrahas

chart = calculate_chart(1990, 3, 15, 10, 30, 0, 19.076, 72.878, 5.5)
upagrahas = calculate_upagrahas(chart)

for u in upagrahas:
    print(f"{u.name}: {u.sign.name} {u.degree_in_sign:.1f}°")

from vedic_calc import calculate_chart, calculate_sahams

chart = calculate_chart(1990, 3, 15, 10, 30, 0, 19.076, 72.878, 5.5)
sahams = calculate_sahams(chart)

for s in sahams:
    print(f"{s.name}: {s.sign.name} {s.degree_in_sign:.1f}°")

from vedic_calc import get_festivals

festivals = get_festivals(2026, 19.076, 72.878, 5.5)
for f in festivals:
    print(f"{f.date.date()}: {f.name} — {f.description}")

from vedic_calc.core.constants import (
    SIGN_LORDS,            # {Sign.ARIES: Planet.MARS, ...}
    NAKSHATRA_LORDS,       # {Nakshatra.ASHWINI: Planet.KETU, ...}
    PLANET_NAMES,          # {Planet.SUN: "Sun (Surya)", ...}
    SIGN_NAMES,            # {Sign.ARIES: "Aries (Mesha)", ...}
    NAKSHATRA_NAMES,       # {Nakshatra.ASHWINI: "Ashwini", ...}
    VIMSOTTARI_YEARS,      # {Planet.KETU: 7, Planet.VENUS: 20, ...}
    VIMSOTTARI_ORDER,      # [Planet.KETU, Planet.VENUS, Planet.SUN, ...]
    TITHI_NAMES,           # {1: "Shukla Pratipada", ..., 30: "Amavasya"}
    YOGA_NAMES,            # {1: "Vishkambha", ..., 27: "Vaidhriti"}
    KARANA_NAMES,          # {1: "Kimstughna", ..., 60: "Nagava"}
    VARA_NAMES,            # {0: "Monday (Somavara)", ..., 6: "Sunday (Ravivara)"}
    PLANET_ABBREVIATIONS,  # {Planet.SUN: "Su", ...}
    SIGN_ABBREVIATIONS,    # {Sign.ARIES: "Ar", ...}
)