Cusp Comparison Grids

Kerykeion introduces cusp comparison grids for Transit, Synastry, and Dual Return charts. These tables show how each subject’s house cusps fall into the other subject’s house system.

Synastry Cusp Comparison

from pathlib import Path
from kerykeion import AstrologicalSubjectFactory
from kerykeion.chart_data_factory import ChartDataFactory
from kerykeion.charts.chart_drawer import ChartDrawer

person_a = AstrologicalSubjectFactory.from_birth_data(
    name="Person A",
    year=1990, month=5, day=15,
    hour=10, minute=30,
    lng=12.4964,
    lat=41.9028,
    tz_str="Europe/Rome",
    online=False,
)
person_b = AstrologicalSubjectFactory.from_birth_data(
    name="Person B",
    year=1992, month=8, day=23,
    hour=14, minute=45,
    lng=9.19,
    lat=45.4642,
    tz_str="Europe/Rome",
    online=False,
)

chart_data = ChartDataFactory.create_synastry_chart_data(
    first_subject=person_a,
    second_subject=person_b,
    include_house_comparison=True,
)

drawer = ChartDrawer(
    chart_data=chart_data,
    show_cusp_position_comparison=True,
)

output_dir = Path("charts_output")
output_dir.mkdir(exist_ok=True)

drawer.save_svg(
    output_path=output_dir,
    filename="synastry-with-cusp-comparison",
)

This produces:

• two house comparison tables (points in partner houses)
• two cusp comparison tables (cusps in partner houses), labelled with localized "cusp" and "house" strings

Accessing Cusp Comparison in Reports

When a dual chart includes house comparison, reports also expose cusp overlays:

from kerykeion import ReportGenerator

report = ReportGenerator(chart_data)
text = report.generate_report()
print(text)

Look for sections such as:

• "Person A cusps in Person B houses"
• "Person B cusps in Person A houses"