Calendar / Specifications / QP-ZODIAC-001
METHOD PAPER · QP-ZODIAC-001 · VERSION 1.0.0

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

Kiến trúc hệ thống tính toán chiêm tinh Tây phương nhiệt đới V2.0: mô hình tách biệt thiên văn - luận giải, động cơ điều kiện và tổng hợp bằng chứng đa ngữ
Quizzman Research & Engineering Team (Quizzman Research Lab) · 1 October 2026 · Version 1.0.0 · ● Stable

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 (λ⊙=0∘\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 [1] and the Quizzman Calendar temporal infrastructure [2]. 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 [1].
  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:

  • [3] ISO 8601-1:2019 Date and time — Representations for information interchange.
  • [4] ISO 2145:1978 Documentation — Numbering of divisions and subdivisions in written documents.
  • [5] ISO 690:2021 Information and documentation — Guidelines for bibliographic references and citations.
  • [1] 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.
  • [2] 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.
  • [6] Claudius Ptolemy. Tetrabiblos (Quadripartitum). c. 150.
  • [7] Jean Meeus. Astronomical Algorithms. 2nd edition. Willmann-Bell, 1998.
  • [8] Robert Hand. Planets in Transit: Life Cycles for Living. Para Research, 1976.
  • [9] William Lilly. Christian Astrology. London, 1647.
  • [10] 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 (λ=0∘\lambda = 0^\circ), uniformly divided into twelve 30∘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∘−30∘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 ≤17′\le 17', and Combust when angular separation ≤8∘30′\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∘0^\circ). This approach erroneously synthesized a fictitious personal Ascendant and arbitrary house angles for entire demographic cohorts.

Quizzman Zodiac Engine V2.0 [10] 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 [1], retrieving geocentric coordinates, velocities, aspect matrices, and lunar phases.
  2. Whole-Sign Symbolic Projection (ZODIAC-R001): For each evaluated sun sign (index S∈[0,11]S \in [0, 11]), the symbolic Ascendant is defined at S×30∘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)      │  <sup><a href="#ref-REF-QP-ASTRO-001" class="cite-ref">[1]</a></sup>
│  - 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∘0^\circ, Sextile 60∘60^\circ, Square 90∘90^\circ, Trine 120∘120^\circ, Opposition 180∘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 (≥3\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 Δθ=∣λplanet−λ⊙∣(mod360∘)\Delta \theta = |\lambda_{\text{planet}} - \lambda_{\odot}| \pmod{360^\circ} governs solar proximity classification: Condition(Δθ)={Cazimifor Δθ≤1760∘ (17′)Combustfor 1760∘<Δθ≤8∘30′Under the Beamsfor 8∘30′<Δθ≤17∘00′Freefor Δθ>17∘00′\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+0.9), whereas Combust imposes severe debilitating penalties (weight −0.75-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 ΔSi\Delta S_i into target life sectors (Career, Love, Health, Wealth, Family/Study). The tightness of the angular orb provides a linear decay function: worb=1−∣actual_orb∣max_orbw_{\text{orb}} = 1 - \frac{|\text{actual_orb}|}{\text{max_orb}}

The domain score SdomainS_{\text{domain}} is calculated from a neutral baseline of 5050, incorporating a conflict damping factor γ∈(0,1]\gamma \in (0, 1] when harmonious and challenging indicators occur simultaneously: Sdomain=clamp(50+∑iΔSpos,i⋅worb,i+γ∑jΔSneg,j⋅worb,j, 0, 100)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.720.72, whereas full personal natal charts can reach 0.950.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

  • [3] International Organization for Standardization. ISO 8601-1:2019 Date and time — Representations for information interchange. Geneva: ISO, 2019.
  • [4] International Organization for Standardization. ISO 2145:1978 Documentation — Numbering of divisions and subdivisions in written documents. Geneva: ISO, 1978.
  • [5] International Organization for Standardization. ISO 690:2021 Information and documentation — Guidelines for bibliographic references and citations to information resources. Geneva: ISO, 2021.
  • [1] 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/
  • [2] 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/
  • [6] Claudius Ptolemy. Tetrabiblos (Quadripartitum). Alexandria, c. 150.
  • [7] Jean Meeus. Astronomical Algorithms. 2nd edition. Richmond, Virginia: Willmann-Bell, 1998.
  • [8] Robert Hand. Planets in Transit: Life Cycles for Living. Rockport: Para Research, 1976.
  • [9] William Lilly. Christian Astrology. London, 1647.
  • [10] 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

Bibliography (ISO 690 Profile)

  1. [3] International Organization for Standardization. ISO 8601-1:2019 Date and time — Representations for information interchange — Part 1: Basic rules. ISO, 2019. [URL] (Governing international standard for date and time representation and midnight boundary definitions.)
  2. [4] International Organization for Standardization. ISO 2145:1978 Documentation — Numbering of divisions and subdivisions in written documents. ISO, 1978. [URL] (Governing standard for decimal hierarchy numbering without trailing periods.)
  3. [5] International Organization for Standardization. ISO 690:2021 Information and documentation — Guidelines for bibliographic references and citations to information resources. ISO, 2021. [URL] (Standard profile for bibliographic records and citation structures.)
  4. [1] 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 Publishing System, 2026. [URL] (High-precision planetary ephemeris service providing geocentric ecliptic coordinates, station points, lunar phases, and eclipse boundaries.)
  5. [2] 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 Publishing System, 2026. [URL] (Foundational astronomical specification providing VSOP87 solar terms, Julian Day continuous counting, and True Solar Time reductions.)
  6. [6] Ptolemy, Claudius. Tetrabiblos (Quadripartitum). 150. (Foundational classical treatise of Western astrology establishing the tropical zodiac, planetary dignities, aspects, and house principles.)
  7. [7] Meeus, Jean. Astronomical Algorithms. Edition 2nd edition. Willmann-Bell, Inc., 1998. (Standard algorithmic reference for planetary coordinate reductions, Equation of Time, and solar longitude tracking.)
  8. [8] Hand, Robert. Planets in Transit: Life Cycles for Living. Para Research, 1976. (Systematic formulation of transit aspects, orbs, and planetary cycles in Western psychological astrology.)
  9. [9] Lilly, William. Christian Astrology. 1647. (Foundational traditional treatise formalizing planetary debilities, combust/cazimi conditions, void of course moon, and essential dignities.)
  10. [10] 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. [URL] (Comprehensive architectural audit eliminating the artificial latitude-0 mid-season natal probe and establishing decoupled Today's Sky projection and 40-condition fusion.)