# Tropical Western Astrology Engine Architecture V2.0: Decoupled Astronomy-Interpretation Model, Condition Engine, and Multilingual Evidence Fusion

## Abstract

Tropical Western Astrology is a celestial geometric analytical framework based on the ecliptic coordinates of the Sun, Moon, and planets projected across twelve zodiacal signs referenced from the Vernal Equinox ($\lambda_\odot = 0^\circ$). In contemporary digital implementations, horoscope software predominantly succumbs to two fatal architectural flaws: either static, non-astronomical text libraries assigned arbitrarily, or flawed hybrid models that synthesize fictitious birth charts at latitude zero to approximate daily sun-sign horoscopes.

This paper presents the formal architecture of the Quizzman Zodiac Engine V2.0 (`@quizzman/qm-zodiacsign`), an empirical astrological computing system directly linked to the Quizzman Astro Support API [REF-QP-ASTRO-001] and the Quizzman Calendar temporal infrastructure [REF-QP-CAL-001]. The work establishes four architectural contributions: (1) A complete decoupling between physical planetary ephemeris computation and symbolic rule interpretation, eradicating the latitude-zero artificial natal chart anti-pattern; (2) A whole-sign symbolic projection method mapping a single authentic astronomical snapshot (Today's Sky) across twelve tropical signs; (3) A 40-group Condition Engine standardizing planetary kinematics, solar proximity (Cazimi, Combust), aspect exactness (applying/separating), and lunar phases into weighted feature vectors; and (4) An Evidence Fusion model employing conflict damping and orb-tightness weighting across a normalized 0-100 scale, powering a hallucination-free natural language generation (NLG) pipeline across eleven languages.

## 1 Scope

This document specifies the technical architecture, geometrical algorithms, and data processing pipelines for the Quizzman Zodiac Engine V2.0 (`@quizzman/qm-zodiacsign`), encompassing:
1. Ingestion protocols for geocentric ecliptic coordinates from the Quizzman Astro Support API [REF-QP-ASTRO-001].
2. Decoupled execution paths separating personal natal charts from daily sun-sign horoscopes.
3. The 40-group Astrological Condition Engine.
4. The weighted Evidence Fusion model with confidence capping.
5. Evidence-bound natural language generation rules across eleven target locales (`vi`, `en`, `zht`, `zh`, `jp`, `kr`, `fr`, `es`, `th`, `pt`, `de`).

## 2 Normative references

The following referenced documents are indispensable for the application of this document:
- [REF-ISO-8601] ISO 8601-1:2019 Date and time — Representations for information interchange.
- [REF-ISO-2145] ISO 2145:1978 Documentation — Numbering of divisions and subdivisions in written documents.
- [REF-ISO-690] ISO 690:2021 Information and documentation — Guidelines for bibliographic references and citations.
- [REF-QP-ASTRO-001] Quizzman Astronomy & Astrodynamics Group. Kiến trúc hệ thống tính toán thiên văn học và giao diện lập trình vị trí thiên thể Quizzman Astro.
- [REF-QP-CAL-001] Quizzman Research & Engineering Team. Kiến trúc hệ thống tính toán lịch pháp âm dương và mô hình quy chiếu thiên văn Quizzman.
- [REF-PTOLEMY-TETRABIBLOS] Claudius Ptolemy. Tetrabiblos (Quadripartitum). c. 150.
- [REF-MEEUS-1998] Jean Meeus. Astronomical Algorithms. 2nd edition. Willmann-Bell, 1998.
- [REF-HAND-1976] Robert Hand. Planets in Transit: Life Cycles for Living. Para Research, 1976.
- [REF-LILLY-1647] William Lilly. Christian Astrology. London, 1647.
- [REF-AUDIT-ZODIAC-2026] Quizzman Engineering Group. Báo cáo Kiến trúc & Nâng cấp Zodiac 2.0 Condition Engine — Dossier AUD-2026-ZODIAC-02.

## 3 Terms and definitions

### 3.1 Tropical zodiac
An ecliptic coordinate frame anchored to the Vernal Equinox ($\lambda = 0^\circ$), uniformly divided into twelve $30^\circ$ segments.

### 3.2 Whole sign houses
A house division system wherein the entire zodiacal sign containing the Ascendant constitutes the 1st House ($0^\circ - 30^\circ$), with subsequent signs corresponding to Houses 2 through 12.

### 3.3 Cazimi and Combust
Angular proximity states between a celestial body and the center of the solar disk: Cazimi ("in the heart of the Sun") when angular separation $\le 17'$, and Combust when angular separation $\le 8^\circ 30'$.

### 3.4 Scored evidence
A standardized data structure quantifying the impact of a verified astrological condition upon a specific life domain, modulated by angular orb tightness.

## 4 Decoupled astronomical architecture and Today's Sky projection

### 4.1 Eradication of the latitude zero artificial natal probe anti-pattern

In legacy V1.0 implementations, daily horoscopes across twelve signs were generated by deploying artificial probe charts placed at seasonal midpoints on the equator (latitude $0^\circ$). This approach erroneously synthesized a fictitious personal Ascendant and arbitrary house angles for entire demographic cohorts.

Quizzman Zodiac Engine V2.0 [REF-AUDIT-ZODIAC-2026] eliminates this anti-pattern through a rigorous two-tier architecture:
1. **Unified Sky Snapshot (Today's Sky):** The system samples exactly one real-time astronomical snapshot from the Quizzman Astro API [REF-QP-ASTRO-001], retrieving geocentric coordinates, velocities, aspect matrices, and lunar phases.
2. **Whole-Sign Symbolic Projection (ZODIAC-R001):** For each evaluated sun sign (index $S \in [0, 11]$), the symbolic Ascendant is defined at $S \times 30^\circ$. All twelve houses are mapped via Whole Sign Houses relative to that sign. No synthetic geographic latitude or clock time is fabricated.
3. **Strict Path Decoupling:** Daily sun-sign readings and personal natal charts represent separate execution pipelines. Sun-sign mode never fabricates a personal Ascendant.

```
[Target Timestamp when]
          │
          ▼
┌──────────────────────────────────────────────┐
│  Astro Support API (astro.quizzman.com)      │  [REF-QP-ASTRO-001]
│  - Geocentric Ecliptic Longitudes lambda_i   │
│  - Kinematic Velocities & Retrogrades        │
│  - Exact Planetary Aspects & Lunar Phase     │
└──────────────────────┬───────────────────────┘
                       │
                       ▼
┌──────────────────────────────────────────────┐
│  Zodiac Rule & Condition Engine (V2.0)       │
│  - 40 Astrological Condition Groups          │
│  - Decoupled Pipeline:                       │
│    ├─ By Sign: Today's Sky ×12 Whole-Sign    │
│    └─ By Birth: Full Natal Spherical Houses  │
└──────────────────────┬───────────────────────┘
                       │
                       ▼
┌──────────────────────────────────────────────┐
│  Evidence Fusion & Multilingual NLG Pipeline │
│  - Baseline 50 Domain Scoring Model          │
│  - Conflict Damping & Orb Tightness Decay    │
│  - 11-Locale Hallucination-Free Generation   │
└──────────────────────────────────────────────┘
```

## 5 Forty-group condition engine and solar proximity formalization

### 5.1 Classification of forty astrological condition groups

The Condition Engine converts raw ephemeris data into structured condition objects classified across seven operational categories:
1. **Kinematics:** Direct motion, Retrograde motion, Stationary points.
2. **Aspects:** Major Ptolemaic aspects (Conjunction $0^\circ$, Sextile $60^\circ$, Square $90^\circ$, Trine $120^\circ$, Opposition $180^\circ$) categorized as Applying or Separating based on relative velocities.
3. **Lunar Conditions:** Phase cycle (New, Full, Quarter), Void-of-Course (VOC) moon, Solar and Lunar eclipses.
4. **Solar Proximity:** Cazimi, Combust, Under the Beams.
5. **Planetary Dignities:** Essential (Domicile, Exaltation, Detriment, Fall), Mutual Reception, Accidental house angularity.
6. **Geometric Patterns:** Stellium ($\ge 3$ co-located planets), Grand Trine, T-Square, Grand Cross, Yod.
7. **Elemental Balances:** Elemental weighting (Fire, Earth, Air, Water) and quadruplicity modalities (Cardinal, Fixed, Mutable).

### 5.2 Formalization of Cazimi and Combust thresholds (ZODIAC-R002)

The absolute angular separation $\Delta \theta = |\lambda_{\text{planet}} - \lambda_{\odot}| \pmod{360^\circ}$ governs solar proximity classification:
$$\text{Condition}(\Delta \theta) = \begin{cases} 
\text{Cazimi} & \text{for } \Delta \theta \le \frac{17}{60}^\circ \ (17') \\
\text{Combust} & \text{for } \frac{17}{60}^\circ < \Delta \theta \le 8^\circ 30' \\
\text{Under the Beams} & \text{for } 8^\circ 30' < \Delta \theta \le 17^\circ 00' \\
\text{Free} & \text{for } \Delta \theta > 17^\circ 00'
\end{cases}$$

Cazimi represents an exceptional positive dignity enhancement (weight $+0.9$), whereas Combust imposes severe debilitating penalties (weight $-0.75$).

## 6 Evidence fusion and eleven-locale natural language generation

### 6.1 Orb-weighted evidence fusion with conflict damping (ZODIAC-R003)

Each detected condition contributes domain delta vectors $\Delta S_i$ into target life sectors (Career, Love, Health, Wealth, Family/Study). The tightness of the angular orb provides a linear decay function:
$$w_{\text{orb}} = 1 - \frac{|\text{actual\_orb}|}{\text{max\_orb}}$$

The domain score $S_{\text{domain}}$ is calculated from a neutral baseline of $50$, incorporating a conflict damping factor $\gamma \in (0, 1]$ when harmonious and challenging indicators occur simultaneously:
$$S_{\text{domain}} = \text{clamp}\left(50 + \sum_{i} \Delta S_{\text{pos}, i} \cdot w_{\text{orb}, i} + \gamma \sum_{j} \Delta S_{\text{neg}, j} \cdot w_{\text{orb}, j}, \ 0, \ 100\right)$$

Confidence caps are enforced: daily sun-sign readings are clamped at a maximum confidence of $0.72$, whereas full personal natal charts can reach $0.95$.

### 6.2 Evidence-bound natural language generation (ZODIAC-R004)

The Natural Language Generation (NLG) engine consumes exclusively the Scored Condition Bag. The pipeline strictly forbids the generation of prose discussing celestial events not present within verified conditions. Eleven localized discourse composers (`vi`, `en`, `zht`, `zh`, `jp`, `kr`, `fr`, `es`, `th`, `pt`, `de`) assemble structured, readable interpretations directly from evidence tokens.

## 7 Verification and regression suite

The engine is validated through rigorous CI test suites:
1. **Astro Support API 1.1 Contract Verification:** Ensuring 100% field parity across ephemeris responses.
2. **Aspect Boundary Tests:** Continuous validation of 1,000 aspect boundary edge cases across orb limits.
3. **Path Separation Tests:** Verification that `/v1/sunsign` never leaks artificial latitude-zero natal constructs.

## 8 Limitations and application scope

1. **Tropical Frame Exclusivity:** The engine operates exclusively in the Tropical Zodiac. Sidereal and Vedic (Jyotish) systems are not supported.
2. **House Granularity Boundary:** Sun-sign mode utilizes Whole Sign houses as a symbolic statistical framework; personal topocentric house cusps require exact geographic coordinates and timestamps.
3. **Scientific Demarcation:** The system produces psychological and symbolic interpretations; it makes no claims of prophetic certainty or deterministic destiny.

## 9 Conclusion

Quizzman Zodiac Engine V2.0 establishes an empirical paradigm for digital Western astrology by replacing fictitious latitude-zero chart probes with authentic Today's Sky projections, standardizing 40 condition groups, and enforcing conflict-damped evidence fusion. The resulting platform delivers transparent, mathematically grounded, and multilingual astrological computation without hallucinations.

## Bibliography

- [REF-ISO-8601] International Organization for Standardization. ISO 8601-1:2019 Date and time — Representations for information interchange. Geneva: ISO, 2019.
- [REF-ISO-2145] International Organization for Standardization. ISO 2145:1978 Documentation — Numbering of divisions and subdivisions in written documents. Geneva: ISO, 1978.
- [REF-ISO-690] International Organization for Standardization. ISO 690:2021 Information and documentation — Guidelines for bibliographic references and citations to information resources. Geneva: ISO, 2021.
- [REF-QP-ASTRO-001] Quizzman Astronomy & Astrodynamics Group. Kiến trúc hệ thống tính toán thiên văn học và giao diện lập trình vị trí thiên thể Quizzman Astro. Quizzman Paper, 2026. Available at: https://paper.quizzman.com/papers/QP-ASTRO-001/
- [REF-QP-CAL-001] Quizzman Research & Engineering Team. Kiến trúc hệ thống tính toán lịch pháp âm dương và mô hình quy chiếu thiên văn Quizzman. Quizzman Paper, 2026. Available at: https://paper.quizzman.com/papers/QP-CAL-001/
- [REF-PTOLEMY-TETRABIBLOS] Claudius Ptolemy. Tetrabiblos (Quadripartitum). Alexandria, c. 150.
- [REF-MEEUS-1998] Jean Meeus. Astronomical Algorithms. 2nd edition. Richmond, Virginia: Willmann-Bell, 1998.
- [REF-HAND-1976] Robert Hand. Planets in Transit: Life Cycles for Living. Rockport: Para Research, 1976.
- [REF-LILLY-1647] William Lilly. Christian Astrology. London, 1647.
- [REF-AUDIT-ZODIAC-2026] Quizzman Engineering Group. Báo cáo Kiến trúc & Nâng cấp Zodiac 2.0 Condition Engine — Dossier AUD-2026-ZODIAC-02. Quizzman Lab Internal Audit Series, 2026. Available at: https://insight.quizzman.com/tool/about-zodiac.md
