dashaflow 1.0.0__py3-none-any.whl

dashaflow/__init__.py

@@ -0,0 +1,241 @@
+"""
+DashaFlow — Vedic Astrology Calculation Engine
+===============================================
+
+Swiss Ephemeris with Sidereal Lahiri ayanamsha.
+Rooted in Brihat Parashara Hora Shastra (BPHS) and B.V. Raman's Hindu Predictive Astrology.
+
+Quick start::
+
+    import dashaflow
+
+    chart = dashaflow.cast_chart("1990-04-15", "14:30", 28.6139, 77.2090, "Asia/Kolkata")
+    print(chart["lagna"]["sign"])       # e.g. "Leo"
+    print(chart["planets"]["Moon"])      # full Moon data
+    print(chart["yogas"])               # detected yogas
+"""
+
+from ._version import __version__
+from ._validation import validate_birth_input
+from .vedic_calculator import calculate_vedic_chart, calculate_transit
+from .matchmaking import calculate_ashtakoot, calc_kuja_dosha, match_kuja_dosha
+from .muhurtha import evaluate_muhurtha, ACTIVITY_RULES
+from .career import analyze_career as _analyze_career_internal
+from .constants import ZODIAC_SIGNS
+
+__all__ = [
+    "__version__",
+    "cast_chart",
+    "cast_transit",
+    "calculate_compatibility",
+    "check_muhurtha",
+    "analyze_career",
+]
+
+
+def cast_chart(
+    dob: str,
+    time: str,
+    lat: float,
+    lon: float,
+    timezone: str,
+    query_date: str = None,
+    ephe_path: str = '',
+) -> dict:
+    """
+    Cast a complete Vedic natal chart (Sidereal Lahiri ayanamsha).
+
+    Returns a dict with: metadata, panchang, lagna, planets (with dignity,
+    combustion, aspects, 14 varga signs), dashas (5 levels), yogas (24 types),
+    ashtakavarga, jaimini_karakas, shadbala, bhava_chalit, avasthas,
+    kaal_sarpa, graha_yuddha, gandanta, arudha_padas, upapada, karakamsha.
+
+    Parameters
+    ----------
+    dob : str
+        Date of birth as "YYYY-MM-DD"
+    time : str
+        Time of birth as "HH:MM" (24-hour)
+    lat : float
+        Birth latitude (-90 to 90)
+    lon : float
+        Birth longitude (-180 to 180)
+    timezone : str
+        IANA timezone (e.g. "Asia/Kolkata")
+    query_date : str, optional
+        Date for Dasha lookup as "YYYY-MM-DD". Defaults to today.
+    ephe_path : str, optional
+        Path to Swiss Ephemeris data files. Defaults to '' (bundled).
+
+    Returns
+    -------
+    dict
+        Complete chart data.
+
+    Raises
+    ------
+    ValueError
+        If any input parameter is invalid.
+    """
+    validate_birth_input(dob, time, lat, lon, timezone)
+    return calculate_vedic_chart(
+        dob_str=dob,
+        time_str=time,
+        lat=lat,
+        lon=lon,
+        timezone_str=timezone,
+        query_date_str=query_date,
+        ephe_path=ephe_path,
+    )
+
+
+def cast_transit(
+    transit_date: str,
+    natal_chart: dict,
+    timezone: str = "Asia/Kolkata",
+) -> dict:
+    """
+    Calculate planetary transits overlaid on a natal chart.
+
+    Parameters
+    ----------
+    transit_date : str
+        Date to compute transits as "YYYY-MM-DD"
+    natal_chart : dict
+        Full dict output from cast_chart()
+    timezone : str, optional
+        IANA timezone. Defaults to "Asia/Kolkata".
+
+    Returns
+    -------
+    dict
+        Transit planets with house positions, SAV points, Sade Sati, Rahu-Ketu axis.
+    """
+    return calculate_transit(
+        transit_date_str=transit_date,
+        natal_chart=natal_chart,
+        timezone_str=timezone,
+    )
+
+
+def calculate_compatibility(
+    dob1: str, time1: str, lat1: float, lon1: float, tz1: str,
+    dob2: str, time2: str, lat2: float, lon2: float, tz2: str,
+) -> dict:
+    """
+    Calculate 36-point Ashtakoot compatibility + Kuja Dosha.
+
+    Person 1 = Male, Person 2 = Female (by tradition for accurate scoring).
+
+    Parameters
+    ----------
+    dob1, time1, lat1, lon1, tz1 : Birth details for Person 1 (Male)
+    dob2, time2, lat2, lon2, tz2 : Birth details for Person 2 (Female)
+
+    Returns
+    -------
+    dict
+        8 Ashtakoot kutas (36 pts), extended kutas (Mahendra, Stree Deergha,
+        Vedha, Rajju, etc.), Kuja Dosha analysis with compatibility verdict.
+    """
+    validate_birth_input(dob1, time1, lat1, lon1, tz1)
+    validate_birth_input(dob2, time2, lat2, lon2, tz2)
+
+    chart1 = calculate_vedic_chart(dob1, time1, lat1, lon1, tz1)
+    chart2 = calculate_vedic_chart(dob2, time2, lat2, lon2, tz2)
+
+    m_moon = chart1["planets"]["Moon"]
+    f_moon = chart2["planets"]["Moon"]
+
+    m_lon = ZODIAC_SIGNS.index(m_moon["sign"]) * 30 + m_moon["degree"]
+    f_lon = ZODIAC_SIGNS.index(f_moon["sign"]) * 30 + f_moon["degree"]
+
+    score = calculate_ashtakoot(m_lon, f_lon, male_chart=chart1, female_chart=chart2)
+
+    male_dosha = calc_kuja_dosha(chart1)
+    female_dosha = calc_kuja_dosha(chart2)
+    kuja_match = match_kuja_dosha(male_dosha["total_score"], female_dosha["total_score"])
+    score["kuja_dosha"] = {
+        "male": male_dosha,
+        "female": female_dosha,
+        "compatibility": kuja_match,
+    }
+
+    return score
+
+
+def check_muhurtha(
+    activity: str,
+    date: str,
+    time: str,
+    lat: float,
+    lon: float,
+    timezone: str,
+) -> dict:
+    """
+    Check if a date/time is auspicious for a specific activity.
+
+    Parameters
+    ----------
+    activity : str
+        One of: 'marriage', 'travel', 'business', 'education', 'house_entry', 'medical'
+    date : str
+        Date as "YYYY-MM-DD"
+    time : str
+        Time as "HH:MM" (24-hour)
+    lat : float
+        Location latitude
+    lon : float
+        Location longitude
+    timezone : str
+        IANA timezone string
+
+    Returns
+    -------
+    dict
+        Verdict (auspicious/mixed/inauspicious), score, factors, panchang_suddhi.
+    """
+    validate_birth_input(date, time, lat, lon, timezone)
+    if activity not in ACTIVITY_RULES:
+        raise ValueError(f"Unknown activity '{activity}'. Supported: {list(ACTIVITY_RULES.keys())}")
+
+    chart = calculate_vedic_chart(date, time, lat, lon, timezone)
+    panchang = chart.get("panchang", {})
+    planets = chart.get("planets", {})
+    lagna_sign = chart.get("lagna", {}).get("sign")
+    return evaluate_muhurtha(activity, panchang, planets, lagna_sign)
+
+
+def analyze_career(
+    dob: str,
+    time: str,
+    lat: float,
+    lon: float,
+    timezone: str,
+) -> dict:
+    """
+    Analyze career potential using the 10th house, D10 Dashamsha, and planetary significations.
+
+    Parameters
+    ----------
+    dob : str
+        Date of birth as "YYYY-MM-DD"
+    time : str
+        Time of birth as "HH:MM" (24-hour)
+    lat : float
+        Birth latitude
+    lon : float
+        Birth longitude
+    timezone : str
+        IANA timezone string
+
+    Returns
+    -------
+    dict
+        10th house analysis, D10 indicators, career themes, strength factors.
+    """
+    validate_birth_input(dob, time, lat, lon, timezone)
+    chart = calculate_vedic_chart(dob, time, lat, lon, timezone)
+    planets = chart.get("planets", {})
+    lagna_sign = chart.get("lagna", {}).get("sign")
+    return _analyze_career_internal(planets, lagna_sign)

dashaflow/_validation.py

@@ -0,0 +1,21 @@
+"""Input validation for DashaFlow public API."""
+
+import re
+import pytz
+
+_DATE_RE = re.compile(r"^\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\d|3[01])$")
+_TIME_RE = re.compile(r"^(?:[01]\d|2[0-3]):[0-5]\d$")
+
+
+def validate_birth_input(dob: str, time: str, lat: float, lon: float, timezone: str):
+    """Validate common birth chart inputs. Raises ValueError on bad data."""
+    if not isinstance(dob, str) or not _DATE_RE.match(dob):
+        raise ValueError(f"Invalid date format '{dob}'. Expected YYYY-MM-DD.")
+    if not isinstance(time, str) or not _TIME_RE.match(time):
+        raise ValueError(f"Invalid time format '{time}'. Expected HH:MM (24h).")
+    if not (-90 <= lat <= 90):
+        raise ValueError(f"Latitude {lat} out of range [-90, 90].")
+    if not (-180 <= lon <= 180):
+        raise ValueError(f"Longitude {lon} out of range [-180, 180].")
+    if timezone not in pytz.all_timezones:
+        raise ValueError(f"Unknown timezone '{timezone}'. Use IANA format (e.g. 'Asia/Kolkata').")

dashaflow/_version.py

@@ -0,0 +1 @@
+__version__ = "1.0.0"

dashaflow/ashtakavarga.py

@@ -0,0 +1,128 @@
+from .constants import ZODIAC_SIGNS
+
+# 1-indexed houses from the placement of the planet
+ASHTAKAVARGA_TABLES = {
+    "Sun": {
+        "Sun": [1, 2, 4, 7, 8, 9, 10, 11],
+        "Moon": [3, 6, 10, 11],
+        "Mars": [1, 2, 4, 7, 8, 9, 10, 11],
+        "Mercury": [3, 5, 6, 9, 10, 11, 12],
+        "Jupiter": [5, 6, 9, 11],
+        "Venus": [6, 7, 12],
+        "Saturn": [1, 2, 4, 7, 8, 9, 10, 11],
+        "Ascendant": [3, 4, 6, 10, 11, 12]
+    },
+    "Moon": {
+        "Sun": [3, 6, 7, 8, 10, 11],
+        "Moon": [1, 3, 6, 7, 10, 11],
+        "Mars": [2, 3, 5, 6, 9, 10, 11],
+        "Mercury": [1, 3, 4, 5, 7, 8, 10, 11],
+        "Jupiter": [1, 4, 7, 8, 10, 11, 12],
+        "Venus": [3, 4, 5, 7, 9, 10, 11],
+        "Saturn": [3, 5, 6, 11],
+        "Ascendant": [3, 6, 10, 11]
+    },
+    "Mars": {
+        "Sun": [3, 5, 6, 10, 11],
+        "Moon": [3, 6, 11],
+        "Mars": [1, 2, 4, 7, 8, 10, 11],
+        "Mercury": [3, 5, 6, 11],
+        "Jupiter": [6, 10, 11, 12],
+        "Venus": [6, 8, 11, 12],
+        "Saturn": [1, 4, 7, 8, 9, 10, 11],
+        "Ascendant": [1, 3, 6, 10, 11]
+    },
+    "Mercury": {
+        "Sun": [5, 6, 9, 11, 12],
+        "Moon": [2, 4, 6, 8, 10, 11],
+        "Mars": [1, 2, 4, 7, 8, 9, 10, 11],
+        "Mercury": [1, 3, 5, 6, 9, 10, 11, 12],
+        "Jupiter": [6, 8, 11, 12],
+        "Venus": [1, 2, 3, 4, 5, 8, 9, 11],
+        "Saturn": [1, 2, 4, 7, 8, 9, 10, 11],
+        "Ascendant": [1, 2, 4, 6, 8, 10, 11]
+    },
+    "Jupiter": {
+        "Sun": [1, 2, 3, 4, 7, 8, 9, 10, 11],
+        "Moon": [2, 5, 7, 9, 11],
+        "Mars": [1, 2, 4, 7, 8, 10, 11],
+        "Mercury": [1, 2, 4, 5, 6, 9, 10, 11],
+        "Jupiter": [1, 2, 3, 4, 7, 8, 10, 11],
+        "Venus": [2, 5, 6, 9, 10, 11],
+        "Saturn": [3, 5, 6, 12],
+        "Ascendant": [1, 2, 4, 5, 6, 7, 9, 10, 11]
+    },
+    "Venus": {
+        "Sun": [8, 11, 12],
+        "Moon": [1, 2, 3, 4, 5, 8, 9, 11, 12],
+        "Mars": [3, 5, 6, 9, 11, 12],
+        "Mercury": [3, 5, 6, 9, 11],
+        "Jupiter": [5, 8, 9, 10, 11],
+        "Venus": [1, 2, 3, 4, 5, 8, 9, 10, 11],
+        "Saturn": [3, 4, 5, 8, 9, 10, 11],
+        "Ascendant": [1, 2, 3, 4, 5, 8, 9, 11]
+    },
+    "Saturn": {
+        "Sun": [1, 2, 4, 7, 8, 10, 11],
+        "Moon": [3, 6, 11],
+        "Mars": [3, 5, 6, 10, 11, 12],
+        "Mercury": [6, 8, 9, 10, 11, 12],
+        "Jupiter": [5, 6, 11, 12],
+        "Venus": [6, 11, 12],
+        "Saturn": [3, 5, 6, 11],
+        "Ascendant": [1, 3, 4, 6, 10, 11]
+    }
+}
+
+def calculate_ashtakavarga(planets_in_signs: dict, ascendant_sign_idx: int):
+    """
+    Calculates Sarvashtakavarga (SAV) and Bhinnashtakavarga (BAV).
+    planets_in_signs dict maps "Sun", "Moon", etc. to their 0-11 sign index.
+    
+    Returns a dict with 'sarvashtakavarga' (list of 12 ints mapping to ZODIAC_SIGNS)
+    and 'bhinnashtakavarga' mapping each planet to their 12-sign array.
+    """
+    # Initialize all BAV arrays with 0
+    bav = {p: [0]*12 for p in ASHTAKAVARGA_TABLES.keys()}
+    sav = [0]*12
+    
+    # Extend planets dict with Ascendant for calculation
+    positions = planets_in_signs.copy()
+    positions["Ascendant"] = ascendant_sign_idx
+    
+    for target_planet, contributions in ASHTAKAVARGA_TABLES.items():
+        for source_point, houses_list in contributions.items():
+            source_idx = positions[source_point]
+            for h in houses_list:
+                # h is 1-indexed house from the source planet.
+                # So if source is at idx 0 (Aries) and h=1, target sign is 0 (Aries)
+                target_sign_idx = (source_idx + (h - 1)) % 12
+                bav[target_planet][target_sign_idx] += 1
+                sav[target_sign_idx] += 1
+                
+    # Return as a dict mapped to Zodiac Sign names for easier LLM reading
+    sav_dict = {ZODIAC_SIGNS[i]: sav[i] for i in range(12)}
+    
+    bav_dict = {}
+    for p, arr in bav.items():
+        bav_dict[p] = {ZODIAC_SIGNS[i]: arr[i] for i in range(12)}
+
+    # Prashtarashtakavarga (expanded scatter chart)
+    # For each target planet, shows which source contributed bindus to which sign
+    prashtara = {}
+    for target_planet, contributions in ASHTAKAVARGA_TABLES.items():
+        prashtara[target_planet] = {}
+        for source_point, houses_list in contributions.items():
+            source_idx = positions[source_point]
+            row = [0] * 12
+            for h in houses_list:
+                target_sign_idx = (source_idx + (h - 1)) % 12
+                row[target_sign_idx] = 1
+            prashtara[target_planet][source_point] = {ZODIAC_SIGNS[i]: row[i] for i in range(12)}
+
+    return {
+        "sarvashtakavarga": sav_dict,
+        "bhinnashtakavarga": bav_dict,
+        "prashtarashtakavarga": prashtara,
+        "total_bindus": sum(sav) # Should be 337
+    }

dashaflow/career.py

@@ -0,0 +1,171 @@
+"""
+Career Analysis Framework — D10 Dashamsha interpretation
+Uses D10 chart, 10th house analysis, and planetary significations.
+"""
+
+from .constants import ZODIAC_SIGNS, SIGN_LORDS, EXALTATION, OWN_SIGNS
+
+# Planet -> career significations (Jyotish standard)
+CAREER_SIGNIFICATIONS = {
+    "Sun": ["government", "politics", "administration", "medicine", "leadership", "authority"],
+    "Moon": ["nursing", "hospitality", "public_relations", "agriculture", "shipping", "dairy"],
+    "Mars": ["military", "engineering", "surgery", "sports", "police", "real_estate", "fire_services"],
+    "Mercury": ["writing", "accounting", "commerce", "communication", "IT", "teaching", "astrology"],
+    "Jupiter": ["law", "education", "finance", "banking", "religion", "philosophy", "consulting"],
+    "Venus": ["arts", "entertainment", "fashion", "luxury_goods", "hotel", "cosmetics", "music"],
+    "Saturn": ["mining", "agriculture", "labor", "construction", "oil", "manufacturing", "judiciary"],
+    "Rahu": ["technology", "foreign_trade", "aviation", "research", "pharmaceuticals", "diplomacy"],
+    "Ketu": ["spirituality", "occult", "research", "computing", "alternative_medicine", "languages"],
+}
+
+# Sign -> professional domains
+SIGN_CAREERS = {
+    "Aries": ["military", "sports", "engineering", "entrepreneurship"],
+    "Taurus": ["banking", "agriculture", "luxury_goods", "arts", "food_industry"],
+    "Gemini": ["communication", "writing", "media", "IT", "trading"],
+    "Cancer": ["nursing", "hospitality", "real_estate", "food_industry"],
+    "Leo": ["government", "entertainment", "leadership", "politics"],
+    "Virgo": ["healthcare", "accounting", "analysis", "service", "editing"],
+    "Libra": ["law", "diplomacy", "arts", "fashion", "counseling"],
+    "Scorpio": ["research", "surgery", "occult", "insurance", "investigation"],
+    "Sagittarius": ["education", "law", "religion", "publishing", "travel"],
+    "Capricorn": ["administration", "mining", "construction", "management"],
+    "Aquarius": ["technology", "social_work", "aviation", "research", "NGO"],
+    "Pisces": ["spirituality", "arts", "healthcare", "shipping", "charity"],
+}
+
+KENDRA_HOUSES = {1, 4, 7, 10}
+TRIKONA_HOUSES = {1, 5, 9}
+DUSTHANA_HOUSES = {6, 8, 12}
+
+
+def _is_strong(planet_name, sign):
+    """Check if planet is exalted or in own sign."""
+    if planet_name in EXALTATION and EXALTATION[planet_name][0] == sign:
+        return True
+    if planet_name in OWN_SIGNS and sign in OWN_SIGNS[planet_name]:
+        return True
+    return False
+
+
+def analyze_career(planets, lagna_sign):
+    """
+    Comprehensive career analysis using 10th house, D10, and planetary influences.
+
+    Parameters
+    ----------
+    planets : dict — Planet data from calculate_vedic_chart (needs house, sign, d10_sign, dignity)
+    lagna_sign : str — Ascendant sign
+
+    Returns
+    -------
+    dict with career indicators, D10 analysis, and recommendations
+    """
+    lagna_idx = ZODIAC_SIGNS.index(lagna_sign)
+    tenth_sign = ZODIAC_SIGNS[(lagna_idx + 9) % 12]
+    tenth_lord = SIGN_LORDS[tenth_sign]
+
+    # D10 analysis
+    d10_indicators = {}
+    for p_name, pd in planets.items():
+        d10_sign = pd.get("d10_sign")
+        if d10_sign:
+            d10_lord = SIGN_LORDS.get(d10_sign)
+            d10_indicators[p_name] = {
+                "d10_sign": d10_sign,
+                "d10_lord": d10_lord,
+                "d10_strong": _is_strong(p_name, d10_sign),
+            }
+
+    # Planets in 10th house
+    tenth_house_planets = []
+    for p_name, pd in planets.items():
+        if pd.get("house") == 10:
+            tenth_house_planets.append(p_name)
+
+    # 10th lord analysis
+    tenth_lord_data = planets.get(tenth_lord, {})
+    tenth_lord_house = tenth_lord_data.get("house")
+    tenth_lord_sign = tenth_lord_data.get("sign", "")
+    tenth_lord_d10 = tenth_lord_data.get("d10_sign", "")
+    tenth_lord_dignity = tenth_lord_data.get("dignity", "neutral")
+
+    # Career themes from 10th house planets
+    career_themes = set()
+    primary_planets = []
+
+    # From 10th house occupants
+    for p_name in tenth_house_planets:
+        for theme in CAREER_SIGNIFICATIONS.get(p_name, []):
+            career_themes.add(theme)
+        primary_planets.append(p_name)
+
+    # From 10th lord's significations
+    for theme in CAREER_SIGNIFICATIONS.get(tenth_lord, []):
+        career_themes.add(theme)
+    if tenth_lord not in primary_planets:
+        primary_planets.append(tenth_lord)
+
+    # From 10th sign's domains
+    for theme in SIGN_CAREERS.get(tenth_sign, []):
+        career_themes.add(theme)
+
+    # From D10 10th lord placement
+    if tenth_lord in d10_indicators:
+        d10_info = d10_indicators[tenth_lord]
+        for theme in SIGN_CAREERS.get(d10_info["d10_sign"], []):
+            career_themes.add(theme)
+
+    # Strength assessment
+    strength_factors = []
+    if tenth_lord_dignity in ("exalted", "own_sign", "mooltrikona"):
+        strength_factors.append(f"10th lord {tenth_lord} in {tenth_lord_dignity} — strong career foundation")
+    if tenth_lord_house in KENDRA_HOUSES:
+        strength_factors.append(f"10th lord {tenth_lord} in kendra (house {tenth_lord_house}) — career prominence")
+    if tenth_lord_house in TRIKONA_HOUSES:
+        strength_factors.append(f"10th lord {tenth_lord} in trikona (house {tenth_lord_house}) — fortune in career")
+    if tenth_lord_house in DUSTHANA_HOUSES:
+        strength_factors.append(f"10th lord {tenth_lord} in dusthana (house {tenth_lord_house}) — career challenges")
+
+    for p_name in tenth_house_planets:
+        pd = planets.get(p_name, {})
+        if pd.get("dignity") in ("exalted", "own_sign"):
+            strength_factors.append(f"{p_name} strong in 10th house — powerful career planet")
+        if pd.get("is_retrograde"):
+            strength_factors.append(f"{p_name} retrograde in 10th — unconventional career path")
+
+    # D10 strength check
+    d10_strong_planets = [p for p, info in d10_indicators.items() if info.get("d10_strong")]
+    if d10_strong_planets:
+        strength_factors.append(f"Strong in D10: {', '.join(d10_strong_planets)} — career success in their domains")
+
+    # 6th lord analysis (competition/service)
+    sixth_sign = ZODIAC_SIGNS[(lagna_idx + 5) % 12]
+    sixth_lord = SIGN_LORDS[sixth_sign]
+    sixth_lord_data = planets.get(sixth_lord, {})
+    if sixth_lord_data.get("house") == 10:
+        strength_factors.append(f"6th lord {sixth_lord} in 10th — career in service, healthcare, or competition")
+
+    # 7th lord analysis (business/partnerships)
+    seventh_sign = ZODIAC_SIGNS[(lagna_idx + 6) % 12]
+    seventh_lord = SIGN_LORDS[seventh_sign]
+    seventh_lord_data = planets.get(seventh_lord, {})
+    if seventh_lord_data.get("house") == 10 or tenth_lord_house == 7:
+        strength_factors.append("10th-7th lord connection — career through partnerships or business")
+
+    return {
+        "tenth_house": {
+            "sign": tenth_sign,
+            "lord": tenth_lord,
+            "lord_house": tenth_lord_house,
+            "lord_sign": tenth_lord_sign,
+            "lord_d10": tenth_lord_d10,
+            "lord_dignity": tenth_lord_dignity,
+            "occupants": tenth_house_planets,
+        },
+        "d10_indicators": d10_indicators,
+        "career_themes": sorted(career_themes),
+        "primary_planets": primary_planets,
+        "strength_factors": strength_factors,
+        "d10_strong_planets": d10_strong_planets,
+    }