kundali-chart-mcp 0.2.7 → 0.3.0

package/azure-function/python/kundali_lib/vedic/inauspicious_times.py

@@ -0,0 +1,303 @@
+"""Inauspicious time periods (Kala) calculations.
+
+Calculates:
+- Rahu Kala (Rahu's inauspicious period)
+- Yamaganda Kala (Yama's inauspicious period)
+- Gulika Kala (Gulika's inauspicious period)
+- Choghadiya (8 time divisions of the day)
+- Abhijit Muhurta (auspicious midday window)
+- Brahma Muhurta (pre-dawn auspicious time)
+"""
+
+from __future__ import annotations
+
+from datetime import datetime, timedelta
+from typing import Any
+
+# Weekday lords for Rahu Kala calculation
+WEEKDAY_LORDS = {
+    "Sunday": "Sun",
+    "Monday": "Moon",
+    "Tuesday": "Mars",
+    "Wednesday": "Mercury",
+    "Thursday": "Jupiter",
+    "Friday": "Venus",
+    "Saturday": "Saturn",
+}
+
+# Rahu Kala order (8 parts of the day, starting from Sunday)
+# Each day has a different 8th part that is Rahu Kala
+RAHU_KALA_ORDER = {
+    "Sunday": 8,  # 4:30-6:00 PM (if sunrise 6AM, sunset 6PM)
+    "Monday": 2,  # 7:30-9:00 AM
+    "Tuesday": 7,  # 3:00-4:30 PM
+    "Wednesday": 5,  # 12:00-1:30 PM
+    "Thursday": 6,  # 1:30-3:00 PM
+    "Friday": 4,  # 10:30-12:00 PM
+    "Saturday": 3,  # 9:00-10:30 AM
+}
+
+# Yamaganda Kala order
+YAMAGANDA_ORDER = {
+    "Sunday": 5,  # 12:00-1:30 PM
+    "Monday": 4,  # 10:30-12:00 PM
+    "Tuesday": 3,  # 9:00-10:30 AM
+    "Wednesday": 2,  # 7:30-9:00 AM
+    "Thursday": 1,  # 6:00-7:30 AM
+    "Friday": 7,  # 3:00-4:30 PM
+    "Saturday": 6,  # 1:30-3:00 PM
+}
+
+# Gulika Kala order
+GULIKA_ORDER = {
+    "Sunday": 7,  # 3:00-4:30 PM
+    "Monday": 6,  # 1:30-3:00 PM
+    "Tuesday": 5,  # 12:00-1:30 PM
+    "Wednesday": 4,  # 10:30-12:00 PM
+    "Thursday": 3,  # 9:00-10:30 AM
+    "Friday": 2,  # 7:30-9:00 AM
+    "Saturday": 1,  # 6:00-7:30 AM
+}
+
+# Choghadiya names and their nature
+CHOGHADIYA_NAMES = [
+    "Udveg",  # Anxiety (inauspicious)
+    "Chal",  # Moving (neutral)
+    "Labh",  # Gain (auspicious)
+    "Amrit",  # Nectar (most auspicious)
+    "Kaal",  # Death (inauspicious)
+    "Shubh",  # Auspicious (good)
+    "Rog",  # Disease (inauspicious)
+    "Char",  # Moving (neutral)
+]
+
+CHOGHADIYA_NATURE = {
+    "Udveg": "Inauspicious — avoid new beginnings",
+    "Chal": "Neutral — okay for travel and routine",
+    "Labh": "Auspicious — good for business and gains",
+    "Amrit": "Most Auspicious — best for all activities",
+    "Kaal": "Inauspicious — avoid important work",
+    "Shubh": "Auspicious — good for ceremonies",
+    "Rog": "Inauspicious — avoid health-related activities",
+    "Char": "Neutral — okay for communication",
+}
+
+
+def calculate_inauspicious_times(
+    date: datetime,
+    sunrise: datetime | None = None,
+    sunset: datetime | None = None,
+) -> dict[str, Any]:
+    """Calculate all inauspicious time periods for a given date.
+
+    Args:
+        date: The date to calculate for
+        sunrise: Optional sunrise time (defaults to 6:00 AM)
+        sunset: Optional sunset time (defaults to 6:00 PM)
+
+    Returns:
+        Dictionary with Rahu Kala, Yamaganda, Gulika, and Choghadiya
+    """
+    if sunrise is None:
+        sunrise = date.replace(hour=6, minute=0, second=0)
+    if sunset is None:
+        sunset = date.replace(hour=18, minute=0, second=0)
+
+    weekday = date.strftime("%A")
+
+    # Calculate day duration in minutes
+    day_duration = int((sunset - sunrise).total_seconds() / 60)
+    part_duration = day_duration / 8
+
+    # Rahu Kala
+    rahu_part = RAHU_KALA_ORDER.get(weekday, 1)
+    rahu_start = sunrise + timedelta(minutes=part_duration * (rahu_part - 1))
+    rahu_end = rahu_start + timedelta(minutes=part_duration)
+
+    # Yamaganda Kala
+    yama_part = YAMAGANDA_ORDER.get(weekday, 1)
+    yama_start = sunrise + timedelta(minutes=part_duration * (yama_part - 1))
+    yama_end = yama_start + timedelta(minutes=part_duration)
+
+    # Gulika Kala
+    gulika_part = GULIKA_ORDER.get(weekday, 1)
+    gulika_start = sunrise + timedelta(minutes=part_duration * (gulika_part - 1))
+    gulika_end = gulika_start + timedelta(minutes=part_duration)
+
+    # Choghadiya (daytime)
+    choghadiya_day = []
+    for i in range(8):
+        start = sunrise + timedelta(minutes=part_duration * i)
+        end = start + timedelta(minutes=part_duration)
+        name_index = (CHOGHADIYA_NAMES.index(_get_choghadiya_start(weekday)) + i) % 8
+        choghadiya_day.append(
+            {
+                "period": f"{start.strftime('%H:%M')}-{end.strftime('%H:%M')}",
+                "name": CHOGHADIYA_NAMES[name_index],
+                "nature": CHOGHADIYA_NATURE[CHOGHADIYA_NAMES[name_index]],
+            }
+        )
+
+    # Abhijit Muhurta (midday, ~48 minutes centered on noon)
+    noon = sunrise + timedelta(minutes=day_duration / 2)
+    abhijit_start = noon - timedelta(minutes=24)
+    abhijit_end = noon + timedelta(minutes=24)
+
+    # Brahma Muhurta (pre-dawn, ~48 minutes before sunrise)
+    brahma_start = sunrise - timedelta(minutes=48)
+    brahma_end = sunrise - timedelta(minutes=0)
+
+    return {
+        "date": date.strftime("%Y-%m-%d"),
+        "weekday": weekday,
+        "sunrise": sunrise.strftime("%H:%M"),
+        "sunset": sunset.strftime("%H:%M"),
+        "rahu_kala": {
+            "start": rahu_start.strftime("%H:%M"),
+            "end": rahu_end.strftime("%H:%M"),
+            "description": "Rahu's inauspicious period — avoid starting new ventures, travel, or important work",
+        },
+        "yamaganda": {
+            "start": yama_start.strftime("%H:%M"),
+            "end": yama_end.strftime("%H:%M"),
+            "description": "Yama's inauspicious period — avoid travel and new activities",
+        },
+        "gulika_kala": {
+            "start": gulika_start.strftime("%H:%M"),
+            "end": gulika_end.strftime("%H:%M"),
+            "description": "Gulika's inauspicious period — avoid important decisions and ceremonies",
+        },
+        "choghadiya": choghadiya_day,
+        "abhijit_muhurta": {
+            "start": abhijit_start.strftime("%H:%M"),
+            "end": abhijit_end.strftime("%H:%M"),
+            "description": "Most auspicious midday window — ideal for starting important work",
+        },
+        "brahma_muhurta": {
+            "start": brahma_start.strftime("%H:%M"),
+            "end": brahma_end.strftime("%H:%M"),
+            "description": "Pre-dawn auspicious time — best for meditation, yoga, and spiritual practices",
+        },
+    }
+
+
+def _get_choghadiya_start(weekday: str) -> str:
+    """Get the starting Choghadiya name for a given weekday."""
+    starts = {
+        "Sunday": "Udveg",
+        "Monday": "Amrit",
+        "Tuesday": "Kaal",
+        "Wednesday": "Labh",
+        "Thursday": "Shubh",
+        "Friday": "Rog",
+        "Saturday": "Chal",
+    }
+    return starts.get(weekday, "Udveg")
+
+
+def is_time_auspicious(
+    check_time: datetime,
+    sunrise: datetime | None = None,
+    sunset: datetime | None = None,
+) -> dict[str, Any]:
+    """Check if a given time is auspicious or inauspicious.
+
+    Args:
+        check_time: The time to check
+        sunrise: Optional sunrise time
+        sunset: Optional sunset time
+
+    Returns:
+        Dictionary with auspiciousness assessment
+    """
+    times = calculate_inauspicious_times(check_time, sunrise, sunset)
+
+    check_str = check_time.strftime("%H:%M")
+
+    inauspicious = []
+
+    # Check Rahu Kala
+    if _time_in_range(
+        check_str, times["rahu_kala"]["start"], times["rahu_kala"]["end"]
+    ):
+        inauspicious.append("Rahu Kala")
+
+    # Check Yamaganda
+    if _time_in_range(
+        check_str, times["yamaganda"]["start"], times["yamaganda"]["end"]
+    ):
+        inauspicious.append("Yamaganda")
+
+    # Check Gulika
+    if _time_in_range(
+        check_str, times["gulika_kala"]["start"], times["gulika_kala"]["end"]
+    ):
+        inauspicious.append("Gulika Kala")
+
+    # Check Abhijit Muhurta
+    is_abhijit = _time_in_range(
+        check_str, times["abhijit_muhurta"]["start"], times["abhijit_muhurta"]["end"]
+    )
+
+    # Check Brahma Muhurta
+    is_brahma = _time_in_range(
+        check_str, times["brahma_muhurta"]["start"], times["brahma_muhurta"]["end"]
+    )
+
+    # Find current Choghadiya
+    current_choghadiya = None
+    for c in times["choghadiya"]:
+        start, end = c["period"].split("-")
+        if _time_in_range(check_str, start, end):
+            current_choghadiya = c
+            break
+
+    if is_abhijit:
+        rating = "Highly Auspicious"
+        recommendation = (
+            "Excellent time for starting new ventures, ceremonies, or important work"
+        )
+    elif is_brahma:
+        rating = "Highly Auspicious"
+        recommendation = "Best time for spiritual practices, meditation, and yoga"
+    elif inauspicious:
+        rating = "Inauspicious"
+        recommendation = f"Avoid important activities. Current inauspicious periods: {', '.join(inauspicious)}"
+    elif current_choghadiya and "Auspicious" in current_choghadiya["nature"]:
+        rating = "Auspicious"
+        recommendation = "Good time for most activities"
+    elif current_choghadiya and "Inauspicious" in current_choghadiya["nature"]:
+        rating = "Inauspicious"
+        recommendation = current_choghadiya["nature"]
+    else:
+        rating = "Neutral"
+        recommendation = "Okay for routine activities"
+
+    return {
+        "time": check_str,
+        "rating": rating,
+        "recommendation": recommendation,
+        "inauspicious_periods": inauspicious,
+        "is_abhijit_muhurta": is_abhijit,
+        "is_brahma_muhurta": is_brahma,
+        "current_choghadiya": current_choghadiya,
+    }
+
+
+def _time_in_range(check: str, start: str, end: str) -> bool:
+    """Check if a time string is within a range."""
+    check_min = _to_minutes(check)
+    start_min = _to_minutes(start)
+    end_min = _to_minutes(end)
+
+    if start_min <= end_min:
+        return start_min <= check_min <= end_min
+    else:
+        # Crosses midnight
+        return check_min >= start_min or check_min <= end_min
+
+
+def _to_minutes(time_str: str) -> int:
+    """Convert HH:MM to minutes."""
+    parts = time_str.split(":")
+    return int(parts[0]) * 60 + int(parts[1])