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

kerykeion/charts/charts_utils.py

@@ -1,11 +1,42 @@
 import math
 import datetime
 from kerykeion.kr_types import KerykeionException, ChartType
-from typing import Union
-from kerykeion.kr_types.kr_models import AspectModel
+from typing import Union, Literal
+from kerykeion.kr_types.kr_models import AspectModel, KerykeionPointModel
 from kerykeion.kr_types.settings_models import KerykeionLanguageCelestialPointModel, KerykeionSettingsAspectModel
 
 
+def get_decoded_kerykeion_celestial_point_name(input_planet_name: str, celestial_point_language: KerykeionLanguageCelestialPointModel) -> str:
+    """
+    Decode the given celestial point name based on the provided language model.
+
+    Args:
+        input_planet_name (str): The name of the celestial point to decode.
+        celestial_point_language (KerykeionLanguageCelestialPointModel): The language model containing celestial point names.
+
+    Returns:
+        str: The decoded celestial point name.
+    """
+
+    # Dictionary for special house names
+    special_house_names = {
+        "First_House": "Asc",
+        "Seventh_House": "Dsc",
+        "Tenth_House": "Mc",
+        "Fourth_House": "Ic"
+    }
+
+    # Get the language model keys
+    language_keys = celestial_point_language.model_dump().keys()
+
+    # Check if the input planet name exists in the language model
+    if input_planet_name in language_keys:
+        return celestial_point_language[input_planet_name]
+
+    # Return the special house name if it exists, otherwise return an empty string
+    return special_house_names.get(input_planet_name, "")
+
+
 def decHourJoin(inH: int, inM: int, inS: int) -> float:
     """Join hour, minutes, seconds, timezone integer to hour float.
 
@@ -132,10 +163,10 @@ def draw_zodiac_slice(
         - seventh_house_degree_ut (Union[int, float]): The degree of the seventh house.
         - num (int): The number of the sign. Note: In OpenAstro it did refer to self.zodiac,
             which is a list of the signs in order, starting with Aries. Eg:
-            {"name": "aries", "element": "fire"}
+            {"name": "Ari", "element": "fire"}
         - r (Union[int, float]): The value of r.
         - style (str): The CSS inline style.
-        - type (str): The type ?. In OpenAstro, it was the symbol of the sign. Eg: "aries".
+        - type (str): The type ?. In OpenAstro, it was the symbol of the sign. Eg: "Ari".
             self.zodiac[i]["name"]
 
     Returns:
@@ -146,7 +177,7 @@ def draw_zodiac_slice(
     offset = 360 - seventh_house_degree_ut
     # check transit
     if chart_type == "Transit" or chart_type == "Synastry":
-        dropin = 0
+        dropin: Union[int, float] = 0
     else:
         dropin = c1
     slice = f'<path d="M{str(r)},{str(r)} L{str(dropin + sliceToX(num, r - dropin, offset))},{str(dropin + sliceToY(num, r - dropin, offset))} A{str(r - dropin)},{str(r - dropin)} 0 0,0 {str(dropin + sliceToX(num + 1, r - dropin, offset))},{str(dropin + sliceToY(num + 1, r - dropin, offset))} z" style="{style}"/>'
@@ -242,12 +273,11 @@ def draw_aspect_line(
     x2 = sliceToX(0, ar, second_offset) + (r - ar)
     y2 = sliceToY(0, ar, second_offset) + (r - ar)
 
-    out = ""
-    out += f'<g kr:node="Aspect" kr:aspectname="{aspect['aspect']}" kr:to="{aspect['p1_name']}" kr:tooriginaldegrees="{aspect["p1_abs_pos"]}" kr:from="{aspect["p2_name"]}" kr:fromoriginaldegrees="{aspect["p2_abs_pos"]}">'
-    out += f'<line class="aspect" x1="{x1}" y1="{y1}" x2="{x2}" y2="{y2}" style="stroke: {color}; stroke-width: 1; stroke-opacity: .9;"/>'
-    out += f"</g>"
-
-    return out
+    return (
+        f'<g kr:node="Aspect" kr:aspectname="{aspect["aspect"]}" kr:to="{aspect["p1_name"]}" kr:tooriginaldegrees="{aspect["p1_abs_pos"]}" kr:from="{aspect["p2_name"]}" kr:fromoriginaldegrees="{aspect["p2_abs_pos"]}">'
+        f'<line class="aspect" x1="{x1}" y1="{y1}" x2="{x2}" y2="{y2}" style="stroke: {color}; stroke-width: 1; stroke-opacity: .9;"/>'
+        f"</g>"
+    )
 
 
 def draw_elements_percentages(
@@ -282,48 +312,45 @@ def draw_elements_percentages(
     air_percentage = int(round(100 * air_points / total))
     water_percentage = int(round(100 * water_points / total))
 
-    out = '<g transform="translate(-30,79)">'
-    out += f'<text y="0" style="fill:#ff6600; font-size: 10px;">{fire_label}  {str(fire_percentage)}%</text>'
-    out += f'<text y="12" style="fill:#6a2d04; font-size: 10px;">{earth_label} {str(earth_percentage)}%</text>'
-    out += f'<text y="24" style="fill:#6f76d1; font-size: 10px;">{air_label}   {str(air_percentage)}%</text>'
-    out += f'<text y="36" style="fill:#630e73; font-size: 10px;">{water_label} {str(water_percentage)}%</text>'
-    out += "</g>"
-
-    return out
+    return (
+        f'<g transform="translate(-30,79)">'
+        f'<text y="0" style="fill: var(--kerykeion-chart-color-fire-percentage); font-size: 10px;">{fire_label}  {str(fire_percentage)}%</text>'
+        f'<text y="12" style="fill: var(--kerykeion-chart-color-earth-percentage); font-size: 10px;">{earth_label} {str(earth_percentage)}%</text>'
+        f'<text y="24" style="fill: var(--kerykeion-chart-color-air-percentage); font-size: 10px;">{air_label}   {str(air_percentage)}%</text>'
+        f'<text y="36" style="fill: var(--kerykeion-chart-color-water-percentage); font-size: 10px;">{water_label} {str(water_percentage)}%</text>'
+        f"</g>"
+    )
 
 
-def convert_decimal_to_degree_string(dec: float, type="3") -> str:
+def convert_decimal_to_degree_string(dec: float, format_type: Literal["1", "2", "3"] = "3") -> str:
     """
-    Coverts decimal float to degrees in format a°b'c".
+    Converts a decimal float to a degrees string in the specified format.
 
     Args:
-        - dec (float): decimal float
-        - type (str): type of format:
-            - 1: a°
-            - 2: a°b'
-            - 3: a°b'c"
+        dec (float): The decimal float to convert.
+        format_type (str): The format type:
+            - "1": a°
+            - "2": a°b'
+            - "3": a°b'c" (default)
 
     Returns:
-        str: degrees in format a°b'c"
+        str: The degrees string in the specified format.
     """
-
+    # Ensure the input is a float
     dec = float(dec)
-    a = int(dec)
-    a_new = (dec - float(a)) * 60.0
-    b_rounded = int(round(a_new))
-    b = int(a_new)
-    c = int(round((a_new - float(b)) * 60.0))
-
-    if type == "3":
-        out = f"{a:02d}&#176;{b:02d}&#39;{c:02d}&#34;"
-    elif type == "2":
-        out = f"{a:02d}&#176;{b_rounded:02d}&#39;"
-    elif type == "1":
-        out = f"{a:02d}&#176;"
-    else:
-        raise KerykeionException(f"Wrong type: {type}, it must be 1, 2 or 3.")
 
-    return str(out)
+    # Calculate degrees, minutes, and seconds
+    degrees = int(dec)
+    minutes = int((dec - degrees) * 60)
+    seconds = int(round((dec - degrees - minutes / 60) * 3600))
+
+    # Format the output based on the specified type
+    if format_type == "1":
+        return f"{degrees}°"
+    elif format_type == "2":
+        return f"{degrees}°{minutes:02d}'"
+    elif format_type == "3":
+        return f"{degrees}°{minutes:02d}'{seconds:02d}\""
 
 
 def draw_transit_ring_degree_steps(r: Union[int, float], seventh_house_degree_ut: Union[int, float]) -> str:
@@ -464,7 +491,7 @@ def draw_third_circle(
     stroke_color: str,
     fill_color: str,
     chart_type: ChartType,
-    c3: Union[int, float, None] = None,
+    c3: Union[int, float]
 ) -> str:
     """
     Draws the third circle in an SVG chart.
@@ -487,59 +514,68 @@ def draw_third_circle(
         return f'<circle cx="{radius}" cy="{radius}" r="{radius - c3}" style="fill: {fill_color}; fill-opacity:.8; stroke: {stroke_color}; stroke-width: 1px" />'
 
 
-def draw_aspect_grid(stroke_color: str, available_planets_list: list, aspects_list: list) -> str:
+def draw_aspect_grid(
+        stroke_color: str, 
+        available_planets: list, 
+        aspects: list,
+        x_start: int = 380,
+        y_start: int = 468,
+    ) -> str:
     """
-    Draws the aspect grid.
+    Draws the aspect grid for the given planets and aspects.
 
     Args:
-        - stroke_color (str): The color of the stroke.
-        - available_planets_list (list): List of all the planets, they will be actually filtered to so if they have
-            the "is_active" key set to True inside the function to have the correct list of just the active planets.
-        - aspects_list (list): List of aspects.
+        stroke_color (str): The color of the stroke.
+        available_planets (list): List of all planets. Only planets with "is_active" set to True will be used.
+        aspects (list): List of aspects.
+        x_start (int): The x-coordinate starting point.
+        y_start (int): The y-coordinate starting point.
 
+    Returns:
+        str: SVG string representing the aspect grid.
     """
-
-    out = ""
-    style = f"stroke:{stroke_color}; stroke-width: 1px; stroke-opacity:.6; fill:none"
-    xindent = 380
-    yindent = 468
-    box = 14
-    counter = 0
-
-    actual_planets = []
-    for planet in available_planets_list:
-        if planet.is_active:
-            actual_planets.append(planet)
-
-    first_iteration_revers_planets = actual_planets[::-1]
-    for index, a in enumerate(first_iteration_revers_planets):
-        counter += 1
-        out += f'<rect x="{xindent}" y="{yindent}" width="{box}" height="{box}" style="{style}"/>'
-        out += f'<use transform="scale(0.4)" x="{(xindent+2)*2.5}" y="{(yindent+1)*2.5}" xlink:href="#{a["name"]}" />'
-
-        xindent = xindent + box
-        yindent = yindent - box
-
-        xorb = xindent
-        yorb = yindent + box
-
-        second_iteration_revers_planets = first_iteration_revers_planets[index + 1 :]
-        for b in second_iteration_revers_planets:
-            out += f'<rect x="{xorb}" y="{yorb}" width="{box}" height="{box}" style="{style}"/>'
-            xorb = xorb + box
-
-            for aspect in aspects_list:
-                if (aspect["p1"] == a["id"] and aspect["p2"] == b["id"]) or (
-                    aspect["p1"] == b["id"] and aspect["p2"] == a["id"]
+    svg_output = ""
+    style = f"stroke:{stroke_color}; stroke-width: 1px; fill:none"
+    box_size = 14
+
+    # Filter active planets
+    active_planets = [planet for planet in available_planets if planet.is_active]
+
+    # Reverse the list of active planets for the first iteration
+    reversed_planets = active_planets[::-1]
+
+    for index, planet_a in enumerate(reversed_planets):
+        # Draw the grid box for the planet
+        svg_output += f'<rect x="{x_start}" y="{y_start}" width="{box_size}" height="{box_size}" style="{style}"/>'
+        svg_output += f'<use transform="scale(0.4)" x="{(x_start + 2) * 2.5}" y="{(y_start + 1) * 2.5}" xlink:href="#{planet_a["name"]}" />'
+
+        # Update the starting coordinates for the next box
+        x_start += box_size
+        y_start -= box_size
+
+        # Coordinates for the aspect symbols
+        x_aspect = x_start
+        y_aspect = y_start + box_size
+
+        # Iterate over the remaining planets
+        for planet_b in reversed_planets[index + 1:]:
+            # Draw the grid box for the aspect
+            svg_output += f'<rect x="{x_aspect}" y="{y_aspect}" width="{box_size}" height="{box_size}" style="{style}"/>'
+            x_aspect += box_size
+
+            # Check for aspects between the planets
+            for aspect in aspects:
+                if (aspect["p1"] == planet_a["id"] and aspect["p2"] == planet_b["id"]) or (
+                    aspect["p1"] == planet_b["id"] and aspect["p2"] == planet_a["id"]
                 ):
-                    out += f'<use  x="{xorb-box+1}" y="{yorb+1}" xlink:href="#orb{aspect["aspect_degrees"]}" />'
+                    svg_output += f'<use  x="{x_aspect - box_size + 1}" y="{y_aspect + 1}" xlink:href="#orb{aspect["aspect_degrees"]}" />'
 
-    return out
+    return svg_output
 
 
 def draw_houses_cusps_and_text_number(
     r: Union[int, float],
-    first_subject_houses_list_ut: list,
+    first_subject_houses_list: list[KerykeionPointModel],
     standard_house_cusp_color: str,
     first_house_color: str,
     tenth_house_color: str,
@@ -548,15 +584,15 @@ def draw_houses_cusps_and_text_number(
     c1: Union[int, float],
     c3: Union[int, float],
     chart_type: ChartType,
-    second_subject_houses_list_ut: list = None,
-    transit_house_cusp_color: str = None,
+    second_subject_houses_list: Union[list[KerykeionPointModel], None] = None,
+    transit_house_cusp_color: Union[str, None] = None,
 ) -> str:
     """
     Draws the houses cusps and text numbers for a given chart type.
 
     Parameters:
     - r: Radius of the chart.
-    - first_subject_houses_list_ut: List of house cusps for the first subject.
+    - first_subject_houses_list: List of house for the first subject.
     - standard_house_cusp_color: Default color for house cusps.
     - first_house_color: Color for the first house cusp.
     - tenth_house_color: Color for the tenth house cusp.
@@ -565,25 +601,22 @@ def draw_houses_cusps_and_text_number(
     - c1: Offset for the first subject.
     - c3: Offset for the third subject.
     - chart_type: Type of the chart (e.g., Transit, Synastry).
-    - second_subject_houses_list_ut: List of house cusps for the second subject (optional).
+    - second_subject_houses_list: List of house for the second subject (optional).
     - transit_house_cusp_color: Color for transit house cusps (optional).
 
     Returns:
     - A string containing the SVG path for the houses cusps and text numbers.
     """
-    if chart_type in ["Transit", "Synastry"]:
-        if second_subject_houses_list_ut is None or transit_house_cusp_color is None:
-            raise KerykeionException("second_subject_houses_list_ut or transit_house_cusp_color is None")
 
     path = ""
     xr = 12
 
     for i in range(xr):
         # Determine offsets based on chart type
-        dropin, roff, t_roff = (160, 72, 36) if chart_type in ["Transit", "Synastry"] else (c3, c1, None)
+        dropin, roff, t_roff = (160, 72, 36) if chart_type in ["Transit", "Synastry"] else (c3, c1, False)
 
         # Calculate the offset for the current house cusp
-        offset = (int(first_subject_houses_list_ut[int(xr / 2)]) / -1) + int(first_subject_houses_list_ut[i])
+        offset = (int(first_subject_houses_list[int(xr / 2)].abs_pos) / -1) + int(first_subject_houses_list[i].abs_pos)
 
         # Calculate the coordinates for the house cusp lines
         x1 = sliceToX(0, (r - dropin), offset) + dropin
@@ -594,7 +627,7 @@ def draw_houses_cusps_and_text_number(
         # Calculate the text offset for the house number
         next_index = (i + 1) % xr
         text_offset = offset + int(
-            degreeDiff(first_subject_houses_list_ut[next_index], first_subject_houses_list_ut[i]) / 2
+            degreeDiff(first_subject_houses_list[next_index].abs_pos, first_subject_houses_list[i].abs_pos) / 2
         )
 
         # Determine the line color based on the house index
@@ -603,9 +636,12 @@ def draw_houses_cusps_and_text_number(
         )
 
         if chart_type in ["Transit", "Synastry"]:
+            if second_subject_houses_list is None or transit_house_cusp_color is None:
+                raise KerykeionException("second_subject_houses_list_ut or transit_house_cusp_color is None")
+
             # Calculate the offset for the second subject's house cusp
-            zeropoint = 360 - first_subject_houses_list_ut[6]
-            t_offset = (zeropoint + second_subject_houses_list_ut[i]) % 360
+            zeropoint = 360 - first_subject_houses_list[6].abs_pos
+            t_offset = (zeropoint + second_subject_houses_list[i].abs_pos) % 360
 
             # Calculate the coordinates for the second subject's house cusp lines
             t_x1 = sliceToX(0, (r - t_roff), t_offset) + t_roff
@@ -615,7 +651,7 @@ def draw_houses_cusps_and_text_number(
 
             # Calculate the text offset for the second subject's house number
             t_text_offset = t_offset + int(
-                degreeDiff(second_subject_houses_list_ut[next_index], second_subject_houses_list_ut[i]) / 2
+                degreeDiff(second_subject_houses_list[next_index].abs_pos, second_subject_houses_list[i].abs_pos) / 2
             )
             t_linecolor = linecolor if i in [0, 9, 6, 3] else transit_house_cusp_color
             xtext = sliceToX(0, (r - 8), t_text_offset) + 8
@@ -624,7 +660,7 @@ def draw_houses_cusps_and_text_number(
             # Add the house number text for the second subject
             fill_opacity = "0" if chart_type == "Transit" else ".4"
             path += f'<g kr:node="HouseNumber">'
-            path += f'<text style="fill: #00f; fill-opacity: {fill_opacity}; font-size: 14px"><tspan x="{xtext - 3}" y="{ytext + 3}">{i + 1}</tspan></text>'
+            path += f'<text style="fill: var(--kerykeion-chart-color-house-number); fill-opacity: {fill_opacity}; font-size: 14px"><tspan x="{xtext - 3}" y="{ytext + 3}">{i + 1}</tspan></text>'
             path += f"</g>"
 
             # Add the house cusp line for the second subject
@@ -645,17 +681,17 @@ def draw_houses_cusps_and_text_number(
 
         # Add the house number text for the first subject
         path += f'<g kr:node="HouseNumber">'
-        path += f'<text style="fill: #f00; fill-opacity: .6; font-size: 14px"><tspan x="{xtext - 3}" y="{ytext + 3}">{i + 1}</tspan></text>'
+        path += f'<text style="fill: var(--kerykeion-chart-color-house-number); fill-opacity: .6; font-size: 14px"><tspan x="{xtext - 3}" y="{ytext + 3}">{i + 1}</tspan></text>'
         path += f"</g>"
 
     return path
 
 
-def draw_aspect_transit_grid(
+def draw_transit_aspect_list(
     grid_title: str,
     aspects_list: Union[list[AspectModel], list[dict]],
-    celestial_point_language: KerykeionLanguageCelestialPointModel,
-    aspects_settings: KerykeionSettingsAspectModel,
+    celestial_point_language: Union[KerykeionLanguageCelestialPointModel, dict],
+    aspects_settings: Union[KerykeionSettingsAspectModel, dict],
 ) -> str:
     """
     Generates the SVG output for the aspect transit grid.
@@ -669,10 +705,16 @@ def draw_aspect_transit_grid(
     Returns:
     - A string containing the SVG path data for the aspect transit grid.
     """
+    
+    if isinstance(celestial_point_language, dict):
+        celestial_point_language = KerykeionLanguageCelestialPointModel(**celestial_point_language)
+
+    if isinstance(aspects_settings, dict):
+        aspects_settings = KerykeionSettingsAspectModel(**aspects_settings)
 
     # If not instance of AspectModel, convert to AspectModel
     if isinstance(aspects_list[0], dict):
-        aspects_list = [AspectModel(**aspect) for aspect in aspects_list]
+        aspects_list = [AspectModel(**aspect) for aspect in aspects_list] # type: ignore
 
     line = 0
     nl = 0
@@ -714,13 +756,13 @@ def draw_aspect_transit_grid(
         inner_path += f"</g>"
 
         # difference in degrees
-        inner_path += f'<text y="8" x="45" style="fill:#000000; font-size: 10px;">{convert_decimal_to_degree_string(aspects_list[i]["orbit"])}</text>'
+        inner_path += f'<text y="8" x="45" style="fill: var(--kerykeion-chart-color-paper-0); font-size: 10px;">{convert_decimal_to_degree_string(aspects_list[i]["orbit"])}</text>'
         # line
         inner_path += f"</g>"
         line = line + 14
 
-    out = f'<g style="transform: translate(47%, 61%) scale({scale})">'
-    out += f'<text y="-15" x="0" style="fill:#000000; font-size: 14px;">{grid_title}:</text>'
+    out = f'<g style="transform: translate(47%, 59%) scale({scale})">'
+    out += f'<text y="-15" x="0" style="fill: var(--kerykeion-chart-color-paper-0); font-size: 14px;">{grid_title}:</text>'
     out += inner_path
     out += "</g>"
 
@@ -729,10 +771,7 @@ def draw_aspect_transit_grid(
 
 def draw_moon_phase(
     degrees_between_sun_and_moon: float,
-    latitude: float,
-    lunar_phase_outline_color: str = "#000000",
-    dark_color: str = "#000000",
-    light_color: str = "#ffffff",
+    latitude: float
 ) -> str:
     """
     Draws the moon phase based on the degrees between the sun and the moon.
@@ -750,8 +789,6 @@ def draw_moon_phase(
     deg = degrees_between_sun_and_moon
 
     # Initialize variables for lunar phase properties
-    fill_color_foreground = None
-    fill_color_background = None
     circle_center_x = None
     circle_radius = None
 
@@ -762,8 +799,6 @@ def draw_moon_phase(
             max_radius = max_radius * max_radius
         circle_center_x = 20.0 + (deg / 90.0) * (max_radius + 10.0)
         circle_radius = 10.0 + (deg / 90.0) * max_radius
-        fill_color_foreground = dark_color
-        fill_color_background = light_color
 
     elif deg < 180.0:
         max_radius = 180.0 - deg
@@ -771,8 +806,6 @@ def draw_moon_phase(
             max_radius = max_radius * max_radius
         circle_center_x = 20.0 + ((deg - 90.0) / 90.0 * (max_radius + 10.0)) - (max_radius + 10.0)
         circle_radius = 10.0 + max_radius - ((deg - 90.0) / 90.0 * max_radius)
-        fill_color_foreground = light_color
-        fill_color_background = dark_color
 
     elif deg < 270.0:
         max_radius = deg - 180.0
@@ -780,8 +813,6 @@ def draw_moon_phase(
             max_radius = max_radius * max_radius
         circle_center_x = 20.0 + ((deg - 180.0) / 90.0 * (max_radius + 10.0))
         circle_radius = 10.0 + ((deg - 180.0) / 90.0 * max_radius)
-        fill_color_foreground = light_color
-        fill_color_background = dark_color
 
     elif deg < 361.0:
         max_radius = 360.0 - deg
@@ -789,8 +820,6 @@ def draw_moon_phase(
             max_radius = max_radius * max_radius
         circle_center_x = 20.0 + ((deg - 270.0) / 90.0 * (max_radius + 10.0)) - (max_radius + 10.0)
         circle_radius = 10.0 + max_radius - ((deg - 270.0) / 90.0 * max_radius)
-        fill_color_foreground = dark_color
-        fill_color_background = light_color
 
     else:
         raise KerykeionException(f"Invalid degree value: {deg}")
@@ -802,8 +831,253 @@ def draw_moon_phase(
     # Return the SVG element as a string
     return (
         f'<g transform="rotate({lunar_phase_rotate} 20 10)">'
-        f'    <circle cx="20" cy="10" r="10" style="fill: {fill_color_background}" />'
-        f'    <circle cx="{circle_center_x}" cy="10" r="{circle_radius}" style="fill: {fill_color_foreground}" clip-path="url(#moonPhaseCutOffCircle)" />'
-        f'    <circle cx="20" cy="10" r="10" style="fill: none; stroke: {lunar_phase_outline_color}; stroke-width: 0.5px; stroke-opacity: 0.5" />'
-        f"</g>"
+        f'    <defs>'
+        f'        <clipPath id="moonPhaseCutOffCircle">'
+        f'        <circle cx="20" cy="10" r="10" />'
+        f'        </clipPath>'
+        f'    </defs>'
+        f'    <circle cx="20" cy="10" r="10" style="fill: var(--kerykeion-chart-color-lunar-phase-0)" />'
+        f'    <circle cx="{circle_center_x}" cy="10" r="{circle_radius}" style="fill: var(--kerykeion-chart-color-lunar-phase-1)" clip-path="url(#moonPhaseCutOffCircle)" />'
+        f'    <circle cx="20" cy="10" r="10" style="fill: none; stroke: var(--kerykeion-chart-color-lunar-phase-0); stroke-width: 0.5px; stroke-opacity: 0.5" />'
+        f'</g>'
+    )
+
+
+def draw_house_grid(
+        main_subject_houses_list: list[KerykeionPointModel],
+        chart_type: ChartType,
+        secondary_subject_houses_list: Union[list[KerykeionPointModel], None] = None,
+        text_color: str = "#000000",
+        house_cusp_generale_name_label: str = "Cusp",
+    ) -> str:
+    """
+    Generate SVG code for a grid of astrological houses.
+
+    Parameters:
+    - main_houses (list[KerykeionPointModel]): List of houses for the main subject.
+    - chart_type (ChartType): Type of the chart (e.g., Synastry, Transit).
+    - secondary_houses (list[KerykeionPointModel], optional): List of houses for the secondary subject.
+    - text_color (str): Color of the text.
+    - cusp_label (str): Label for the house cusp.
+
+    Returns:
+    - str: The SVG code for the grid of houses.
+    """
+    
+    if chart_type in ["Synastry", "Transit"] and secondary_subject_houses_list is None:
+        raise KerykeionException("secondary_houses is None")
+
+    svg_output = '<g transform="translate(610,-20)">'
+
+    line_increment = 10
+    for i, house in enumerate(main_subject_houses_list):
+        cusp_number = f"&#160;&#160;{i + 1}" if i < 9 else str(i + 1)
+        svg_output += (
+            f'<g transform="translate(0,{line_increment})">'
+            f'<text text-anchor="end" x="40" style="fill:{text_color}; font-size: 10px;">{house_cusp_generale_name_label} {cusp_number}:</text>'
+            f'<g transform="translate(40,-8)"><use transform="scale(0.3)" xlink:href="#{house["sign"]}" /></g>'
+            f'<text x="53" style="fill:{text_color}; font-size: 10px;"> {convert_decimal_to_degree_string(house["position"])}</text>'
+            f'</g>'
+        )
+        line_increment += 14
+
+    svg_output += "</g>"
+
+    if chart_type == "Synastry":
+        svg_output += '<!-- Synastry Houses -->'
+        svg_output += '<g transform="translate(850, -20)">'
+        line_increment = 10
+
+        for i, house in enumerate(secondary_subject_houses_list): # type: ignore
+            cusp_number = f"&#160;&#160;{i + 1}" if i < 9 else str(i + 1)
+            svg_output += (
+                f'<g transform="translate(0,{line_increment})">'
+                f'<text text-anchor="end" x="40" style="fill:{text_color}; font-size: 10px;">{house_cusp_generale_name_label} {cusp_number}:</text>'
+                f'<g transform="translate(40,-8)"><use transform="scale(0.3)" xlink:href="#{house["sign"]}" /></g>'
+                f'<text x="53" style="fill:{text_color}; font-size: 10px;"> {convert_decimal_to_degree_string(house["position"])}</text>'
+                f'</g>'
+            )
+            line_increment += 14
+
+        svg_output += "</g>"
+
+    return svg_output
+
+
+def draw_planet_grid(
+        planets_and_houses_grid_title: str,
+        subject_name: str,
+        available_kerykeion_celestial_points: list[KerykeionPointModel],
+        chart_type: ChartType,
+        celestial_point_language: KerykeionLanguageCelestialPointModel,
+        second_subject_name: Union[str, None] = None,
+        second_subject_available_kerykeion_celestial_points: Union[list[KerykeionPointModel], None] = None,
+        text_color: str = "#000000",
+    ) -> str:
+    """
+    Draws the planet grid for the given celestial points and chart type.
+
+    Args:
+        planets_and_houses_grid_title (str): Title of the grid.
+        subject_name (str): Name of the subject.
+        available_kerykeion_celestial_points (list[KerykeionPointModel]): List of celestial points for the subject.
+        chart_type (ChartType): Type of the chart.
+        celestial_point_language (KerykeionLanguageCelestialPointModel): Language model for celestial points.
+        second_subject_name (str, optional): Name of the second subject. Defaults to None.
+        second_subject_available_kerykeion_celestial_points (list[KerykeionPointModel], optional): List of celestial points for the second subject. Defaults to None.
+        text_color (str, optional): Color of the text. Defaults to "#000000".
+
+    Returns:
+        str: The SVG output for the planet grid.
+    """
+    line_height = 10
+    offset = 0
+    offset_between_lines = 14
+
+    svg_output = (
+        f'<g transform="translate(510,-20)">'
+        f'<g transform="translate(140, -15)">'
+        f'<text text-anchor="end" style="fill:{text_color}; font-size: 14px;">{planets_and_houses_grid_title} {subject_name}:</text>'
+        f'</g>'
     )
+
+    end_of_line = "</g>"
+
+    for i, planet in enumerate(available_kerykeion_celestial_points):
+        if i == 27:
+            line_height = 10
+            offset = -120
+
+        decoded_name = get_decoded_kerykeion_celestial_point_name(planet["name"], celestial_point_language)
+        svg_output += (
+            f'<g transform="translate({offset},{line_height})">'
+            f'<text text-anchor="end" style="fill:{text_color}; font-size: 10px;">{decoded_name}</text>'
+            f'<g transform="translate(5,-8)"><use transform="scale(0.4)" xlink:href="#{planet["name"]}" /></g>'
+            f'<text text-anchor="start" x="19" style="fill:{text_color}; font-size: 10px;">{convert_decimal_to_degree_string(planet["position"])}</text>'
+            f'<g transform="translate(60,-8)"><use transform="scale(0.3)" xlink:href="#{planet["sign"]}" /></g>'
+        )
+
+        if planet["retrograde"]:
+            svg_output += '<g transform="translate(74,-6)"><use transform="scale(.5)" xlink:href="#retrograde" /></g>'
+
+        svg_output += end_of_line
+        line_height += offset_between_lines
+
+    if chart_type in ["Transit", "Synastry"]:
+        if second_subject_available_kerykeion_celestial_points is None:
+            raise KerykeionException("second_subject_available_kerykeion_celestial_points is None")
+
+        if chart_type == "Transit":
+            svg_output += (
+                f'<g transform="translate(320, -15)">'
+                f'<text text-anchor="end" style="fill:{text_color}; font-size: 14px;">{second_subject_name}:</text>'
+            )
+        else:
+            svg_output += (
+                f'<g transform="translate(380, -15)">'
+                f'<text text-anchor="end" style="fill:{text_color}; font-size: 14px;">{planets_and_houses_grid_title} {second_subject_name}:</text>'
+            )
+
+        svg_output += end_of_line
+
+        second_line_height = 10
+        second_offset = 250
+
+        for i, t_planet in enumerate(second_subject_available_kerykeion_celestial_points):
+            if i == 27:
+                second_line_height = 10
+                second_offset = -120
+
+            second_decoded_name = get_decoded_kerykeion_celestial_point_name(t_planet["name"], celestial_point_language)
+            svg_output += (
+                f'<g transform="translate({second_offset},{second_line_height})">'
+                f'<text text-anchor="end" style="fill:{text_color}; font-size: 10px;">{second_decoded_name}</text>'
+                f'<g transform="translate(5,-8)"><use transform="scale(0.4)" xlink:href="#{t_planet["name"]}" /></g>'
+                f'<text text-anchor="start" x="19" style="fill:{text_color}; font-size: 10px;">{convert_decimal_to_degree_string(t_planet["position"])}</text>'
+                f'<g transform="translate(60,-8)"><use transform="scale(0.3)" xlink:href="#{t_planet["sign"]}" /></g>'
+            )
+
+            if t_planet["retrograde"]:
+                svg_output += '<g transform="translate(74,-6)"><use transform="scale(.5)" xlink:href="#retrograde" /></g>'
+
+            svg_output += end_of_line
+            second_line_height += offset_between_lines
+
+    svg_output += end_of_line
+    return svg_output
+
+
+def draw_transit_aspect_grid(
+        stroke_color: str, 
+        available_planets: list, 
+        aspects: list,
+        x_indent: int = 50,
+        y_indent: int = 250,
+        box_size: int = 14
+    ) -> str:
+    """
+    Draws the aspect grid for the given planets and aspects. The default args value are specific for a stand alone
+    aspect grid.
+
+    Args:
+        stroke_color (str): The color of the stroke.
+        available_planets (list): List of all planets. Only planets with "is_active" set to True will be used.
+        aspects (list): List of aspects.
+        x_indent (int): The initial x-coordinate starting point.
+        y_indent (int): The initial y-coordinate starting point.
+
+    Returns:
+        str: SVG string representing the aspect grid.
+    """
+    svg_output = ""
+    style = f"stroke:{stroke_color}; stroke-width: 1px; fill:none"
+    x_start = x_indent
+    y_start = y_indent
+
+    # Filter active planets
+    active_planets = [planet for planet in available_planets if planet.is_active]
+
+    # Reverse the list of active planets for the first iteration
+    reversed_planets = active_planets[::-1]
+    for index, planet_a in enumerate(reversed_planets):
+        # Draw the grid box for the planet
+        svg_output += f'<rect x="{x_start}" y="{y_start}" width="{box_size}" height="{box_size}" style="{style}"/>'
+        svg_output += f'<use transform="scale(0.4)" x="{(x_start + 2) * 2.5}" y="{(y_start + 1) * 2.5}" xlink:href="#{planet_a["name"]}" />'
+        x_start += box_size
+
+    x_start = x_indent - box_size
+    y_start = y_indent - box_size
+
+    for index, planet_a in enumerate(reversed_planets):
+        # Draw the grid box for the planet
+        svg_output += f'<rect x="{x_start}" y="{y_start}" width="{box_size}" height="{box_size}" style="{style}"/>'
+        svg_output += f'<use transform="scale(0.4)" x="{(x_start + 2) * 2.5}" y="{(y_start + 1) * 2.5}" xlink:href="#{planet_a["name"]}" />'
+        y_start -= box_size
+
+    x_start = x_indent
+    y_start = y_indent
+    y_start = y_start - box_size
+
+    for index, planet_a in enumerate(reversed_planets):
+        # Draw the grid box for the planet
+        svg_output += f'<rect x="{x_start}" y="{y_start}" width="{box_size}" height="{box_size}" style="{style}"/>'
+
+        # Update the starting coordinates for the next box
+        y_start -= box_size
+
+        # Coordinates for the aspect symbols
+        x_aspect = x_start
+        y_aspect = y_start + box_size
+
+        # Iterate over the remaining planets
+        for planet_b in reversed_planets:
+            # Draw the grid box for the aspect
+            svg_output += f'<rect x="{x_aspect}" y="{y_aspect}" width="{box_size}" height="{box_size}" style="{style}"/>'
+            x_aspect += box_size
+
+            # Check for aspects between the planets
+            for aspect in aspects:
+                if (aspect["p1"] == planet_a["id"] and aspect["p2"] == planet_b["id"]):
+                    svg_output += f'<use  x="{x_aspect - box_size + 1}" y="{y_aspect + 1}" xlink:href="#orb{aspect["aspect_degrees"]}" />'
+
+    return svg_output