kerykeion 4.12.3__py3-none-any.whl → 4.14.2__py3-none-any.whl

kerykeion/charts/templates/chart.xml

@@ -3,17 +3,18 @@
 <svg
     xmlns="http://www.w3.org/2000/svg"
     xmlns:xlink="http://www.w3.org/1999/xlink"
-    width="$svgWidth"
-    height="$svgHeight"
+    xmlns:kr="https://www.kerykeion.net/"
+    width="100%"
+    height="100%"
     viewBox="$viewbox"
     preserveAspectRatio="xMidYMid"
 >
     <title>$stringTitle | Kerykeion</title>
     <!--- Main Chart -->
-    <g transform="rotate($cfgRotate)">
-        <g transform="scale($cfgZoom)">
-            <rect class="background-rectangle" x="0" y="0" width="$chart_width"
-                height="$chart_height" style="fill: $paper_color_1" />
+    <g kr:node="Main_Chart" transform="rotate($cfgRotate)">
+
+        <g kr:node="Main_Text">
+            <rect class="background-rectangle" x="0" y="0" width="$chart_width" height="$chart_height" style="fill: $paper_color_1" />
             <text x="20" y="22" style="fill: $paper_color_0; font-size: 24px">$stringTitle</text>
             <text x="20" y="50" style="fill: $paper_color_0; font-size: 11px">$stringName</text>
             <text x="20" y="62" style="fill: $paper_color_0; font-size: 11px">$stringLocation</text>
@@ -26,77 +27,80 @@
             <text x="20" y="480" style="fill: $paper_color_0; font-size: 10px">$bottomLeft2</text>
             <text x="20" y="494" style="fill: $paper_color_0; font-size: 10px">$bottomLeft3</text>
             <text x="20" y="508" style="fill: $paper_color_0; font-size: 10px">$bottomLeft4</text>
-            <!-- Lunar Phase -->
-            <g transform="translate(20,518)">
-                <g transform="rotate($lunar_phase_rotate 20 10)">
-                    <defs>
-                        <clipPath id="cut-off-circle">
-                            <circle cx="20" cy="10" r="10" />
-                        </clipPath>
-                    </defs>
-                    <circle cx="20" cy="10" r="10" style="fill: $lunar_phase_bg" />
-                    <circle
-                        cx="$lunar_phase_cx"
-                        cy="10"
-                        r="$lunar_phase_r"
-                        style="fill: $lunar_phase_fg"
-                        clip-path="url(#cut-off-circle)"
-                    />
-                    <circle
-                        cx="20"
-                        cy="10"
-                        r="10"
-                        style="fill: none; stroke: $lunar_phase_outline; stroke-width: 0.5px; stroke-opacity: 0.5"
-                    />
-                </g>
-            </g>
-            <g transform="translate(50,50)">
-                <g transform="translate($circleX,$circleY)">
-                    <!-- Zodiac -->
-                    $makeZodiac 
+        </g>
 
-                    <!-- First Circle -->
-                    $first_circle
+        <!-- Lunar Phase -->
+        <g kr:node="Lunar_Phase" transform="translate(20,518)">
+            $moon_phase
+        </g>
 
-                    <!-- Second Circle -->
-                    $second_circle
+        <g kr:node="Main_Content" transform="translate(50,50)">
+            <!-- Zodiac -->
+            <g kr:node="Zodiac">
+                $makeZodiac 
+            </g>
 
-                    <!-- Third Circle -->
-                    <circle $c3 style="$c3style" />
+            <!-- First Circle -->
+            <g kr:node="First_Circle">
+                $first_circle
+            </g>
 
-                    <!-- TransitRing -->
-                    $transitRing 
+            <!-- Second Circle -->
+            <g kr:node="Second_Circle">
+                $second_circle
+            </g>
 
-                    <!-- Degree Ring -->
-                    $degreeRing
+            <!-- Third Circle -->
+            <g kr:node="Third_Circle">
+                $third_circle
+            </g>
 
-                    <!-- Houses -->
-                    $makeHouses
+            <!-- Transit_Ring -->
+            <g kr:node="Transint_Ring">
+                $transitRing 
+            </g>
 
-                    <!-- Planets -->
-                    $makePlanets
+            <!-- Degree Ring -->
+            <g kr:node="Degree_Ring">
+                $degreeRing
+            </g>
 
-                    <!-- Aspects -->
-                    $makeAspects 
-                </g>
+            <!-- Houses -->
+            <g kr:node="Houses_Wheel">
+                $makeHouses
+            </g>
+
+            <!-- Planets -->
+            <g kr:node="Planets_Wheel">
+                $makePlanets
+            </g>
 
-                <!-- makePatterns -->
-                $makePatterns
+            <!-- Aspects -->
+            <g kr:node="Aspects_Wheel">
+                $makeAspects
+            </g>
 
-                <!-- AspectGrid -->
+            <!-- AspectGrid -->
+            <g kr:node="Aspect_Grid">
                 $makeAspectGrid
+            </g>
 
-                <!-- Elements -->
+            <!-- Elements -->
+            <g kr:node="Elements_Percentages">
                 $elements_percentages 
+            </g>
 
-                <!-- Planet Grid -->
+            <!-- Planet Grid -->
+            <g kr:node="Planet_Grid">
                 $makePlanetGrid
+            </g>
 
-                <!-- Houses Grid -->
+            <!-- Houses Grid -->
+            <g kr:node="Houses_Grid">
                 $makeHousesGrid
-
             </g>
         </g>
+        
     </g>
 
     <!-- Symbols Definitions -->
@@ -228,6 +232,13 @@
                 d="M 10.019873,13.068981 L 10.185542,0.80951431 M 10.195591,6.7442901 L 15.496983,2.2712408 M 10.214831,6.6321726 L 15.516217,11.105216 M 17.192934,17.998774 C 17.192934,20.8646 14.867052,23.190487 12.001226,23.190487 C 9.1353988,23.190487 6.8095128,20.8646 6.8095128,17.998774 C 6.8095128,15.132953 9.1353988,12.807066 12.001226,12.807066 C 14.867052,12.807066 17.192934,15.132953 17.192934,17.998774 z "
                 style="stroke: $planets_color_16;stroke-width:2px; fill:none;" />
         </symbol>
+        <symbol id="Mean_Lilith">
+          <g transform="translate(1,2)">
+            <path
+              d="M 5.2255055,0.5001842 C 4.5318761,0.5265765 3.8737679,0.6459111 3.2335607,0.83217502 C 6.682099,1.8494555 9.2093951,5.0469634 9.2093951,8.8236674 C 9.2093953,12.600373 6.682099,15.797873 3.2335607,16.815161 C 3.9722573,17.030079 4.7497456,17.147152 5.5574963,17.147152 C 6.4110015,17.147152 7.2245796,17.006704 8,16.767734 L 8,19.803079 L 4.490383,19.803079 L 4.490383,21.629028 L 8,21.629028 L 8,23.739541 L 9.7785222,23.739541 L 9.7785222,21.629028 L 13.430421,21.629028 L 13.430421,19.803079 L 9.7785222,19.803079 L 9.7785222,15.985184 C 12.226487,14.535184 13.88098,11.873186 13.88098,8.8236674 C 13.88098,4.2284374 10.152727,0.5001842 5.5574963,0.5001842 C 5.4497948,0.5001842 5.3322206,0.4961168 5.2255055,0.5001842 z"
+              style="fill: $planets_color_16;" />
+          </g>
+        </symbol>
         <symbol id="First_House">
             <text y="20" style="font-size: 22px; fill: $planets_color_12">As</text>
         </symbol>
@@ -518,5 +529,12 @@
                 style="fill: $paper_color_0"
             />
         </symbol>
+
+        <!-- Moon Phases Cut Off Circle -->
+        <defs>
+            <clipPath id="moonPhaseCutOffCircle">
+                <circle cx="20" cy="10" r="10" />
+            </clipPath>
+        </defs>
     </defs>
 </svg>

kerykeion/enums.py

@@ -15,6 +15,7 @@ class Planets(Enum):
     CHIRON = "Chiron"
     TRUE_NODE = "True_Node"
     MEAN_NODE = "Mean_Node"
+    MEAN_LILITH = "Mean_Lilith"
 
 
 class Aspects(Enum):

kerykeion/ephemeris_data.py

@@ -0,0 +1,174 @@
+from kerykeion import AstrologicalSubject
+from kerykeion.astrological_subject import DEFAULT_HOUSES_SYSTEM_IDENTIFIER, DEFAULT_PERSPECTIVE_TYPE, DEFAULT_ZODIAC_TYPE
+from kerykeion.kr_types import EphemerisDictModel
+from kerykeion.kr_types import SiderealMode, HousesSystemIdentifier, PerspectiveType, ZodiacType
+from datetime import datetime, timedelta
+from typing import Literal, Union
+import logging
+
+
+class EphemerisDataFactory:
+    """
+    This class is used to generate ephemeris data for a given date range.
+
+    Parameters:
+    - start_datetime: datetime object representing the start date and time.
+    - end_datetime: datetime object representing the end date and time.
+    - step_type: string representing the step type. It can be "days", "hours", or "minutes". Default is "days".
+    - step: integer representing the step value. Default is 1.
+    - lat: float representing the latitude. Default is 51.4769 (Greenwich).
+    - lng: float representing the longitude. Default is 0.0005 (Greenwich).
+    - tz_str: string representing the timezone. Default is "Etc/UTC".
+    - is_dst: boolean representing if daylight saving time is active. Default is False.
+    - disable_chiron_and_lilith: boolean representing if Chiron and Lilith should be disabled. Default is False.
+    - zodiac_type: ZodiacType object representing the zodiac type. Default is DEFAULT_ZODIAC_TYPE.
+    - sidereal_mode: SiderealMode object representing the sidereal mode. Default is None.
+    - houses_system_identifier: HousesSystemIdentifier object representing the houses system identifier. Default is DEFAULT_HOUSES_SYSTEM_IDENTIFIER.
+    - perspective_type: PerspectiveType object representing the perspective type. Default is DEFAULT_PERSPECTIVE_TYPE.
+    - max_days: integer representing the maximum number of days.
+        Set it to None to disable the check. Default is 730.
+    - max_hours: integer representing the maximum number of hours.
+        Set it to None to disable the check. Default is 8760.
+    - max_minutes: integer representing the maximum number of minutes.
+        Set it to None to disable the check. Default is 525600.
+
+    Raises:
+    - ValueError: if the step type is invalid.
+    - ValueError: if the number of days, hours, or minutes is greater than the maximum allowed.
+    """
+
+    def __init__(
+        self,
+        start_datetime: datetime,
+        end_datetime: datetime,
+        step_type: Literal["days", "hours", "minutes"] = "days",
+        step: int = 1,
+        lat: float = 51.4769,
+        lng: float = 0.0005,
+        tz_str: str = "Etc/UTC",
+        is_dst: bool = False,
+        disable_chiron_and_lilith: bool = False,
+        zodiac_type: ZodiacType = DEFAULT_ZODIAC_TYPE,
+        sidereal_mode: Union[SiderealMode, None] = None,
+        houses_system_identifier: HousesSystemIdentifier = DEFAULT_HOUSES_SYSTEM_IDENTIFIER,
+        perspective_type: PerspectiveType = DEFAULT_PERSPECTIVE_TYPE,
+        max_days: int = 730,
+        max_hours: int = 8760,
+        max_minutes: int = 525600,
+    ):
+        self.start_datetime = start_datetime
+        self.end_datetime = end_datetime
+        self.step_type = step_type
+        self.step = step
+        self.lat = lat
+        self.lng = lng
+        self.tz_str = tz_str
+        self.is_dst = is_dst
+        self.disable_chiron_and_lilith = disable_chiron_and_lilith
+        self.zodiac_type = zodiac_type
+        self.sidereal_mode = sidereal_mode
+        self.houses_system_identifier = houses_system_identifier
+        self.perspective_type = perspective_type
+        self.max_days = max_days
+        self.max_hours = max_hours
+        self.max_minutes = max_minutes
+
+        self.dates_list = []
+        if self.step_type == "days":
+            self.dates_list = [self.start_datetime + timedelta(days=i) for i in range((self.end_datetime - self.start_datetime).days)]
+            if max_days and (len(self.dates_list) > max_days):
+                raise ValueError(f"Too many days: {len(self.dates_list)} > {self.max_days}. To prevent this error, set max_days to a higher value or reduce the date range.")
+
+        elif self.step_type == "hours":
+            self.dates_list = [self.start_datetime + timedelta(hours=i) for i in range((self.end_datetime - self.start_datetime).days * 24)]
+            if max_hours and (len(self.dates_list) > max_hours):
+                raise ValueError(f"Too many hours: {len(self.dates_list)} > {self.max_hours}. To prevent this error, set max_hours to a higher value or reduce the date range.")
+
+        elif self.step_type == "minutes":
+            self.dates_list = [self.start_datetime + timedelta(minutes=i) for i in range((self.end_datetime - self.start_datetime).days * 24 * 60)]
+            if max_minutes and (len(self.dates_list) > max_minutes):
+                raise ValueError(f"Too many minutes: {len(self.dates_list)} > {self.max_minutes}. To prevent this error, set max_minutes to a higher value or reduce the date range.")
+
+        else:
+            raise ValueError(f"Invalid step type: {self.step_type}")
+
+        if not self.dates_list:
+            raise ValueError("No dates found. Check the date range and step values.")
+
+        if len(self.dates_list) > 1000:
+            logging.warning(f"Large number of dates: {len(self.dates_list)}. The calculation may take a while.")
+
+    def get_ephemeris_data(self) -> list:
+        """
+        Generate ephemeris data for the specified date range.
+        The data is structured as a list of dictionaries, where each dictionary contains the date, planets, and houses data.
+        Eg. [{"date": "2020-01-01T00:00:00", "planets": [{...}, {...}, ...], "houses": [{...}, {...}, ...]}, ...]
+
+        Args:
+        - as_model: boolean representing if the ephemeris data should be returned as model instances. Default is False.
+        - as_dict: boolean representing if the ephemeris data should be returned as dictionaries. Default is False.
+
+        Returns:
+        - list of dictionaries representing the ephemeris data.
+        """
+        ephemeris_data_list = []
+        for date in self.dates_list:
+            subject = AstrologicalSubject(
+                year=date.year,
+                month=date.month,
+                day=date.day,
+                hour=date.hour,
+                minute=date.minute,
+                lng=self.lng,
+                lat=self.lat,
+                tz_str=self.tz_str,
+                city="Placeholder",
+                nation="Placeholder",
+                online=False,
+                disable_chiron_and_lilith=self.disable_chiron_and_lilith,
+                zodiac_type=self.zodiac_type,
+                sidereal_mode=self.sidereal_mode,
+                houses_system_identifier=self.houses_system_identifier,
+                perspective_type=self.perspective_type,
+                is_dst=self.is_dst,
+            )
+
+            ephemeris_data_list.append({"date": date.isoformat(), "planets": subject.planets_list, "houses": subject.houses_list})
+
+        return ephemeris_data_list
+
+    def get_ephemeris_data_as_model(self) -> list[EphemerisDictModel]:
+        """
+        Generate ephemeris data as model instances for the specified date range.
+        The data is structured as a list of EphemerisDictModel instances.
+
+        Returns:
+        - list of EphemerisDictModel instances representing the ephemeris data.
+        """
+        return [EphemerisDictModel(**data) for data in self.get_ephemeris_data()]
+
+
+if "__main__" == __name__:
+    start_date = datetime.fromisoformat("2020-01-01")
+    end_date = datetime.fromisoformat("2020-01-03")
+
+    factory = EphemerisDataFactory(
+        start_datetime=start_date,
+        end_datetime=end_date,
+        step_type="minutes",
+        step=1,
+        lat=37.9838,
+        lng=23.7275,
+        tz_str="Europe/Athens",
+        is_dst=False,
+        max_hours=None,
+        max_minutes=None,
+        max_days=None,
+    )
+
+    ephemeris_data = factory.get_ephemeris_data_as_model()
+    print(ephemeris_data[0])
+    print(len(ephemeris_data))
+
+    for ephe in ephemeris_data:
+        print(ephe.planets[0]["abs_pos"])

kerykeion/fetch_geonames.py

@@ -79,12 +79,11 @@ class FetchGeonames:
 
         params = {
             "q": city_name,
-            "contry": country_code,
+            "country": country_code,
             "username": self.username,
             "maxRows": 1,
             "style": "SHORT",
-            "featureClass": "A",
-            "featureClass": "P",
+            "featureClass": ["A", "P"],
         }
 
         prepared_request = Request("GET", self.base_url, params=params).prepare()

kerykeion/kr_types/chart_types.py

@@ -6,17 +6,11 @@ class ChartTemplateDictionary(TypedDict):
     degreeRing: str
     first_circle: str
     second_circle: str
-    c3: str
-    c3style: str
+    third_circle: str
     makeAspects: str
     makeAspectGrid: str
-    makePatterns: str
     chart_height: float
     chart_width: float
-    circleX: str
-    circleY: str
-    svgWidth: str
-    svgHeight: str
     viewbox: str
     stringTitle: str
     stringName: str
@@ -42,7 +36,7 @@ class ChartTemplateDictionary(TypedDict):
     # Background color of the chart
     paper_color_1: str
     
-    # Planets colors, from 1 to 15 (0 is the Sun)
+    # Planets colors, from 0 to 16 (0 is the Sun)
     planets_color_0: str
     planets_color_1: str
     planets_color_2: str
@@ -59,6 +53,7 @@ class ChartTemplateDictionary(TypedDict):
     planets_color_13: str
     planets_color_14: str
     planets_color_15: str
+    planets_color_16: str
     
     # Zodiac colors, from 0 to 11 (0 is Aries)
     zodiac_color_0: str
@@ -87,7 +82,6 @@ class ChartTemplateDictionary(TypedDict):
     orb_color_150: str
     orb_color_180: str
 
-    cfgZoom: str
     cfgRotate: str
     cfgTranslate: str
     makeZodiac: str

kerykeion/kr_types/kr_literals.py

@@ -25,7 +25,7 @@ HouseNumbers = Literal[1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12]
 """Literal type for House Numbers, starting from the First House (1) to the Twelfth House (12)"""
 
 
-Planet = Literal["Sun", "Moon", "Mercury", "Venus", "Mars", "Jupiter", "Saturn", "Uranus", "Neptune", "Pluto", "Mean_Node", "True_Node", "Chiron"]
+Planet = Literal["Sun", "Moon", "Mercury", "Venus", "Mars", "Jupiter", "Saturn", "Uranus", "Neptune", "Pluto", "Mean_Node", "True_Node", "Chiron", "Mean_Lilith"]
 """Literal type for Planets"""
 
 
@@ -98,4 +98,4 @@ Literal type for perspective types.
 - "True Geocentric": Earth-centered, true positions.
 
 Usually the standard is "Apparent Geocentric"
-"""
+"""

kerykeion/kr_types/kr_models.py

@@ -7,12 +7,29 @@
 from typing import Union, Optional
 from pydantic import BaseModel
 
-from kerykeion.kr_types import LunarPhaseEmoji, LunarPhaseName, Planet, Houses, Quality, Element, Sign, ZodiacType, SignNumbers, HouseNumbers, PointType, SiderealMode, HousesSystemIdentifier
+from kerykeion.kr_types import (
+    LunarPhaseEmoji,
+    LunarPhaseName,
+    Planet,
+    Houses,
+    Quality,
+    Element,
+    Sign,
+    ZodiacType,
+    SignNumbers,
+    HouseNumbers,
+    PointType,
+    SiderealMode,
+    HousesSystemIdentifier,
+    Houses,
+)
+
 
 class SubscriptableBaseModel(BaseModel):
     """
     Pydantic BaseModel with subscriptable support, so you can access the fields as if they were a dictionary.
     """
+
     def __getitem__(self, key):
         return getattr(self, key)
 
@@ -25,6 +42,7 @@ class SubscriptableBaseModel(BaseModel):
     def get(self, key, default):
         return getattr(self, key, default)
 
+
 class LunarPhaseModel(SubscriptableBaseModel):
     degrees_between_s_m: Union[float, int]
     moon_phase: int
@@ -47,7 +65,7 @@ class KerykeionPointModel(SubscriptableBaseModel):
     abs_pos: float
     emoji: str
     point_type: PointType
-    house: Optional[HouseNumbers] = None
+    house: Optional[Houses] = None
     retrograde: Optional[bool] = None
 
 
@@ -73,6 +91,11 @@ class AstrologicalSubjectModel(SubscriptableBaseModel):
     iso_formatted_utc_datetime: str
     julian_day: float
 
+    # Deprecated properties -->
+    utc_time: float
+    local_time: float
+    # <-- Deprecated properties
+
     # Planets
     sun: KerykeionPointModel
     moon: KerykeionPointModel
@@ -87,6 +110,7 @@ class AstrologicalSubjectModel(SubscriptableBaseModel):
 
     # Optional Planets:
     chiron: Union[KerykeionPointModel, None]
+    mean_lilith: Union[KerykeionPointModel, None]
 
     # Houses
     first_house: KerykeionPointModel
@@ -109,32 +133,28 @@ class AstrologicalSubjectModel(SubscriptableBaseModel):
     # Lunar Phase
     lunar_phase: LunarPhaseModel
 
-    # Deprecated properties
-    utc_time: float
-    local_time: float
-
     # Lists
     # houses_list: list[KerykeionPointModel]
     # planets_list: list[KerykeionPointModel]
     # planets_degrees_ut: list[float]
     # houses_degree_ut: list[float]
 
-if __name__ == "__main__":
-    from kerykeion.utilities import setup_logging
-
-    setup_logging(level="debug")
-
-    sun = KerykeionPointModel(
-        name="Sun",
-        element="Air",
-        quality="Fixed",
-        sign="Aqu",
-        sign_num=1,
-        position=0,
-        abs_pos=12.123123,
-        emoji="♈",
-        point_type="Planet",
-    )
-
-    print(sun.model_dump_json())
-    print(sun)
+
+class EphemerisDictModel(SubscriptableBaseModel):
+    date: str
+    planets: list[KerykeionPointModel]
+    houses: list[KerykeionPointModel]
+
+
+class AspectModel(SubscriptableBaseModel):
+    p1_name: str
+    p1_abs_pos: float
+    p2_name: str
+    p2_abs_pos: float
+    aspect: str
+    orbit: float
+    aspect_degrees: int
+    aid: int
+    diff: float
+    p1: int
+    p2: int

kerykeion/kr_types/settings_models.py

@@ -64,6 +64,8 @@ class KerykeionSettingsChartColorsModel(SubscriptableBaseModel):
     zodiac_transit_ring_3: str = Field(title="Zodiac Transit Ring Color 3", description="Zodiac Transit Ring Color 3")
     houses_radix_line: str = Field(title="Houses Radix Line Color", description="Houses Radix Line Color")
     houses_transit_line: str = Field(title="Houses Transit Line Color", description="Houses Transit Line Color")
+
+    # Deprecated: Not used anymore
     lunar_phase_0: str = Field(title="Lunar Phase Color 0", description="Lunar Phase Color 0")
     lunar_phase_1: str = Field(title="Lunar Phase Color 1", description="Lunar Phase Color 1")
     lunar_phase_2: str = Field(title="Lunar Phase Color 2", description="Lunar Phase Color 2")
@@ -109,6 +111,7 @@ class KerykeionLanguageCelestialPointModel(SubscriptableBaseModel):
     Mc: str = Field(title="Medium Coeli", description="The name of Medium Coeli in the chart, in the language")
     Dsc: str = Field(title="Descendant", description="The name of Descendant in the chart, in the language")
     Ic: str = Field(title="Imum Coeli", description="The name of Imum Coeli in the chart, in the language")
+    Mean_Lilith: str = Field(title="Mean Lilith", description="The name of Mean Lilith in the chart, in the language")
 
 
 class KerykeionLanguageModel(SubscriptableBaseModel):
@@ -160,4 +163,4 @@ class KerykeionSettingsModel(SubscriptableBaseModel):
     aspects: List[KerykeionSettingsAspectModel] = Field(title="Aspects", description="The list of the aspects of the chart")
     language_settings: dict[str, KerykeionLanguageModel] = Field(title="Language Settings", description="The language settings of the chart")
     general_settings: KerykeionGeneralSettingsModel = Field(title="General Settings", description="The general settings of the chart")
-    chart_settings: KerykeionChartSettingsModel = Field(title="Chart Settings", description="The chart settings of the chart")
+    chart_settings: KerykeionChartSettingsModel = Field(title="Chart Settings", description="The chart settings of the chart")

kerykeion/settings/kr.config.json

@@ -38,7 +38,8 @@
         "Ic": "Ic",
         "True_Node": "North Node",
         "Mean_Node": "Mean Node",
-        "Chiron": "Chiron"
+        "Chiron": "Chiron",
+        "Mean_Lilith": "Lilith"
       }
     },
     "FR": {
@@ -79,7 +80,8 @@
         "Ic": "Ic",
         "True_Node": "Noeud Nord",
         "Mean_Node": "Noeud Moyen",
-        "Chiron": "Chiron"
+        "Chiron": "Chiron",
+        "Mean_Lilith": "Lilith"
       }
     },
     "PT": {
@@ -120,7 +122,8 @@
         "Ic": "Ic",
         "True_Node": "Nodo Norte",
         "Mean_Node": "Nodo Médio",
-        "Chiron": "Quíron"
+        "Chiron": "Quíron",
+        "Mean_Lilith": "Lilith"
       }
     },
     "IT": {
@@ -161,7 +164,8 @@
         "Ic": "Ic",
         "True_Node": "Nodo Nord",
         "Mean_Node": "Nodo Medio",
-        "Chiron": "Chirone"
+        "Chiron": "Chirone",
+        "Mean_Lilith": "Lilith"
       }
     },
     "CN": {
@@ -202,7 +206,8 @@
         "Ic": "下中天",
         "True_Node": "北交點",
         "Mean_Node": "平交點",
-        "Chiron": "凱龍星"
+        "Chiron": "凱龍星",
+        "Mean_Lilith": "黑月亮"
       }
     }
   },
@@ -471,6 +476,15 @@
       "element_points": 0,
       "related_zodiac_signs": [],
       "label": "Ic"
+    },
+    {
+      "id": 17,
+      "name": "Mean_Lilith",
+      "color": "#000",
+      "is_active": true,
+      "element_points": 0,
+      "related_zodiac_signs": [],
+      "label": "Mean_Lilith"
     }
   ],
   "chart_colors": {

kerykeion/utilities.py

@@ -35,6 +35,8 @@ def get_number_from_name(name: Planet) -> int:
         return 11
     elif name == "Chiron":
         return 15
+    elif name == "Mean_Lilith":
+        return 12
     else:
         raise KerykeionException(f"Error in getting number from name! Name: {name}")
 
@@ -356,7 +358,7 @@ def get_moon_phase_name_from_phase_int(phase: int) -> LunarPhaseName:
     return result
 
 
-def check_and_adjust_polar_latitude(latitude: float, longitude: float) -> bool:
+def check_and_adjust_polar_latitude(latitude: float) -> float:
     """
         Utility function to check if the location is in the polar circle.
         If it is, it sets the latitude to 66 or -66 degrees.
@@ -367,4 +369,6 @@ def check_and_adjust_polar_latitude(latitude: float, longitude: float) -> bool:
 
     elif latitude < -66.0:
         latitude = -66.0
-        logging.info("Polar circle override for houses, using -66 degrees")
+        logging.info("Polar circle override for houses, using -66 degrees")
+
+    return latitude