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 (). 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:
- Ingestion protocols for geocentric ecliptic coordinates from the Quizzman Astro Support API [1].
- Decoupled execution paths separating personal natal charts from daily sun-sign horoscopes.
- The 40-group Astrological Condition Engine.
- The weighted Evidence Fusion model with confidence capping.
- 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 (), uniformly divided into twelve segments.
3.2 Whole sign houses
A house division system wherein the entire zodiacal sign containing the Ascendant constitutes the 1st House (), 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 , and Combust when angular separation .
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 ). 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:
- 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.
- Whole-Sign Symbolic Projection (ZODIAC-R001): For each evaluated sun sign (index ), the symbolic Ascendant is defined at . All twelve houses are mapped via Whole Sign Houses relative to that sign. No synthetic geographic latitude or clock time is fabricated.
- 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:
- Kinematics: Direct motion, Retrograde motion, Stationary points.
- Aspects: Major Ptolemaic aspects (Conjunction , Sextile , Square , Trine , Opposition ) categorized as Applying or Separating based on relative velocities.
- Lunar Conditions: Phase cycle (New, Full, Quarter), Void-of-Course (VOC) moon, Solar and Lunar eclipses.
- Solar Proximity: Cazimi, Combust, Under the Beams.
- Planetary Dignities: Essential (Domicile, Exaltation, Detriment, Fall), Mutual Reception, Accidental house angularity.
- Geometric Patterns: Stellium ( co-located planets), Grand Trine, T-Square, Grand Cross, Yod.
- 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 governs solar proximity classification:
Cazimi represents an exceptional positive dignity enhancement (weight ), whereas Combust imposes severe debilitating penalties (weight ).
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 into target life sectors (Career, Love, Health, Wealth, Family/Study). The tightness of the angular orb provides a linear decay function:
The domain score is calculated from a neutral baseline of , incorporating a conflict damping factor when harmonious and challenging indicators occur simultaneously:
Confidence caps are enforced: daily sun-sign readings are clamped at a maximum confidence of , whereas full personal natal charts can reach .
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:
- Astro Support API 1.1 Contract Verification: Ensuring 100% field parity across ephemeris responses.
- Aspect Boundary Tests: Continuous validation of 1,000 aspect boundary edge cases across orb limits.
- Path Separation Tests: Verification that
/v1/sunsignnever leaks artificial latitude-zero natal constructs.
8 Limitations and application scope
- Tropical Frame Exclusivity: The engine operates exclusively in the Tropical Zodiac. Sidereal and Vedic (Jyotish) systems are not supported.
- 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.
- 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)
- [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.)
- [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.)
- [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.)
- [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.)
- [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] Ptolemy, Claudius. Tetrabiblos (Quadripartitum). 150. (Foundational classical treatise of Western astrology establishing the tropical zodiac, planetary dignities, aspects, and house principles.)
- [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] 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] Lilly, William. Christian Astrology. 1647. (Foundational traditional treatise formalizing planetary debilities, combust/cazimi conditions, void of course moon, and essential dignities.)
- [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.)