Version: 1.3 Date: 2026-04-09 Runtime target: Python 3.14 Validation philosophy: external astrology software where stable and meaningful; canonical formulas and doctrine tables where no stable oracle exists; Moira as regression baseline once behavior is validated
This document covers the astrological convention layer of Moira: techniques that are built on top of the astronomy engine but involve definitional choices specific to astrological tradition.
The validation standard here differs from the astronomy layer:
swetest is used as a sanity oracle where a
stable external chart-software reference actually exists.| Domain | Oracle / basis | Enforcement | Status |
|---|---|---|---|
| Sidereal systems / ayanamshas (34 systems) | Astro.com swetest offline fixture |
pytest |
Validated (31 of 33 in fixture; 2 without Swiss oracle) |
| House systems (15 systems, 7416 iterations) | Swiss setest/t.exp offline fixture |
pytest + validator script |
Validated |
| Aspects (major, tight-orb) | Horizons-validated position substrate + angular-distance geometry | pytest |
Validated (unit + integration) |
| Antiscia / contra-antiscia | Formula derivation + invariants (Valens, Lilly) | pytest |
Validated |
| Midpoints | Formula derivation + invariants (Ebertin, Witte) | pytest |
Validated |
| Lots / Arabic Parts | Formula derivation, day/night reversal (Paulus, Valens) | pytest |
Validated |
| Dignities | Essential table lookups, accidental scoring (Lilly, Ptolemy) | pytest |
Validated |
| Harmonics | Formula derivation + round-trip invariant (Addey) | pytest |
Validated |
| Profections | Annual/monthly arithmetic, 12-year cycle (Brennan, Valens) | pytest |
Validated |
| Planetary hours | Chaldean sequence + day-ruler derivation (Porphyry, Hephaestio) | pytest |
Validated |
| Secondary progressions | Offline Swiss swetest fixture at progressed dates + doctrine validation |
pytest |
Validated |
| Solar arc directions | Offline Swiss swetest fixture for arc and directed longitudes + doctrine validation |
pytest |
Validated |
| Primary directions | Placidus speculum doctrine, arc algebra, and symbolic time-key validation | pytest |
Validated |
| Dashas | Canonical Vimshottari doctrine: nakshatra entry, proportional hierarchy, ayanamsa/year-basis settings | pytest |
Validated |
| Parans | Horizons-derived offline paran fixture + validated event substrate + paran logic tests | pytest |
Validated |
| Gauquelin sectors | Canonical diurnal-arc formula + plus-zone invariants (Gauquelin) | pytest |
Validated |
| Manazil / lunar mansions | Equal-station arithmetic + canonical boundary assignments (al-Biruni) | pytest |
Validated |
| Timelords (Firdaria / Zodiacal Releasing) | Canonical tables, structural invariants, and doctrine validation | pytest |
Validated |
Status language in this table is intentional:
Validated means there is a finished validation story appropriate to the
technique as currently implemented.Internally validated means the subsystem has substantial doctrinal,
structural, and invariant coverage but the project is still intentionally
reserving a stronger validation label for a later external comparison.Needs external oracle means the technique still lacks the external
comparison needed to close that part of the validation story.Oracle: Official Astro.com swetest CGI output, captured offline
Fixture: tests/fixtures/sidereal_swetest_reference.json
Thresholds:
Test file: tests/integration/test_sidereal_external_reference.py
34 ayanamsha systems are exposed. 31 have direct Swiss-mappable fixture data. 2 systems are permanently excluded from the Swiss fixture:
Aryabhata 522 — Moira-specific lineage (Pingree & Plofker); no Swiss
sid_mode equivalent exists.Galactic Equator (IAU 1958) — Swiss sid_mode=32 exists but carries a 190″
base anchor difference (different galactic-ecliptic node computation, not drift).
1 (Galactic Center 5 Sag) is validated by invariant: Galactic Center 0 SagValidated systems include Lahiri, Fagan-Bradley, Krishnamurti, Raman, Yukteshwar, Djwhal Khul, Hipparchos, Suryasiddhanta, Aryabhata, SS Revati, SS Citra, True Chitrapaksha, True Revati, True Pushya, Aldebaran (15 Tau), Babylonian variants, Galactic Center (0 Sag), Galactic Center (Cochrane), Galactic Center (RGB), and others.
Fixture coverage is 2 epochs x 31 systems x 2 modes (mean/true) plus invariant and coverage guards. 129 tests pass.
Five systems (True Chitrapaksha, True Revati, Aldebaran (15 Tau), True Pushya, True Mula) compute the ayanamsa from the live tropical longitude of a reference star rather than a polynomial formula. Because Moira uses IAU 2006 Fukushima-Williams precession while Swiss Ephemeris uses an older precession model, and because Moira’s star pipeline does not include annual aberration (~20.5″ maximum effect), a systematic residual exists between Moira and Swiss for these systems:
| System | Anchor star | Residual envelope | Dominant cause |
|---|---|---|---|
| True Chitrapaksha | Spica | 5–19″ | Annual aberration (~20.5″) |
| True Pushya | δ Cancri | 12–18″ | Aberration + proper motion |
| True Revati | ζ Piscium | 5–20″ | Aberration + proper motion |
| Aldebaran (15 Tau) | Aldebaran | 91–109″ | High proper motion (−189 mas/yr dec) + precession model |
These residuals are model-basis differences where Moira’s IAU 2006 pipeline is the stronger model. The 126″ threshold envelope accommodates the worst case (Aldebaran at historical epochs). Mean-mode results for the same systems pass at the standard 3.6″ threshold because mean mode uses polynomial formulas calibrated to Swiss.
Fixes applied 2026-04-05:
Oracle: Official Swiss Ephemeris setest/t.exp
Fixture: tests/fixtures/swe_t.exp
Threshold: 0.001 degrees (3.6 arcseconds)
Test files:
tests/integration/test_houses_external_reference.pytests/unit/test_polar_houses.pyscripts/compare_swetest.py --offline15 house systems are validated: Placidus, Koch, Campanus, Regiomontanus, Porphyry, Equal, Whole Sign, Alcabitius, Morinus, Topocentric, Vehlow, Meridian, Azimuthal, Krusinski-Pisa, APC.
The Swiss setest/t.exp fixture contains 12,757 raw ITERATION blocks across
six test sections. After analysis, the 7,416 validated iterations are drawn
from two distinct calling conventions:
| Source | Blocks | API exercised | Notes |
|---|---|---|---|
Standard tropical (no flag / iflag=0) |
3,888 | swe_houses() + swe_houses_ex(iflag=0) |
Degree output, tropical; iflag=0 is equivalent to no flag |
| ARMC-direct | 3,528 | swe_houses_armc() |
ARMC supplied directly from fixture; obliquity computed independently by Moira |
| Total | 7,416 | All pass at 3.6″ threshold |
The remaining 5,341 blocks are excluded for documented reasons:
| Category | Count | Reason |
|---|---|---|
iflag=8192 (radians output) |
720 | Swiss returns cusps in radians under this flag; same computation, different units — excluded by design |
Sidereal (iflag=65536 + isid) |
1,080 | Requires ayanamsa-adjusted house computation; see §4.3 |
swe_house_pos() blocks |
1,536 | Single-point house membership query, no cusp array |
Unsupported system (G) |
312 | Not mapped in Moira’s HouseSystem constants |
| Missing coordinates | 18 | Incomplete fixture records |
| Total excluded | 5,341 |
Stress cases covered across all 7,416 validated iterations:
Two systems (Azimuthal, APC) were found genuinely wrong during earlier validation and corrected. All 7,416 iterations now pass.
The 3,528 ARMC-direct blocks exercise houses_from_armc() — Moira’s
equivalent of Swiss swe_houses_armc(). In these blocks the fixture supplies
the ARMC value directly (degrees) rather than deriving it from a Julian date
and geographic longitude. Moira computes obliquity independently from the
block’s JD_UT via its own TT conversion and IAU 2006 pipeline.
This makes ARMC-direct validation a clean geometric test: given the exact ARMC that Swiss used, do Moira’s house cusp algorithms produce the same 12 cusp longitudes? Any residual here is attributable solely to the cusp computation itself, not to ARMC derivation. All 3,528 pass at 3.6″.
The 1,080 sidereal blocks (iflag=65536, isid ∈ {0, 18, 27}) were audited
but not included in the passing test surface. The residuals are entirely
in ayanamsa computation, not in house cusp geometry. When Swiss’s ARMC is
supplied directly and Moira’s ayanamsa is applied, all discrepancy traces to
the ayanamsa value alone.
isid |
System | Moira constant | Ayanamsa diff at 2013 | House cusp residual | Category |
|---|---|---|---|---|---|
| 0 | Fagan-Bradley | Ayanamsa.FAGAN_BRADLEY |
+1.24″ | 1.24″ max | Precession rate |
| 27 | True Chitrapaksha | Ayanamsa.TRUE_CHITRAPAKSHA |
−9.71″ | 10.0″ max | Precession rate + absent aberration |
| 18 | J2000 | None | — | — | No Moira constant |
Fagan-Bradley (+1.24″): This is not a calibration offset. Decomposition shows:
The Moira J2000 anchor was calibrated against Swiss at J2000 (difference is 0.018″). The growing component is the precession rate difference between Moira’s IAU 2006 Fukushima-Williams model and Swiss Ephemeris’s older model. At J2000 the total residual is ≈0.02″; at 13 years it is 1.24″; projected to 100 years it reaches ≈9.3″ in magnitude. This is not fixable by adjusting the J2000 anchor — the source is the precession rate, not the epoch value.
True Chitrapaksha (−9.71″): Same IAU 2006 vs Swiss precession rate difference applies (~0.09″/year), but the dominant source is Moira’s fixed-star pipeline not including annual aberration (~20.5″ maximum effect). The anchor star Spica’s apparent position differs between Moira and Swiss by the aberration amount. This matches the documented residual envelope already recorded in §3.1 for star-anchored ayanamsas.
Conclusion: Both residuals arise from the same root cause — Moira’s stronger IAU 2006 precession substrate produces ayanamsa values that diverge from Swiss as epochs depart from J2000, with star-anchored systems carrying an additional aberration contribution. Neither is a calibration error. Neither is fixable without downgrading the precession model. The house cusp computation itself is correct; the residual lives entirely in the ayanamsa layer.
isid=18 (J2000 ayanamsa): Swiss SE_SIDM_J2000 anchors the tropical and
sidereal zodiacs to coincide at J2000.0, accumulating purely from precession
thereafter. Moira does not yet have a corresponding constant. If added, it
would carry the same precession rate residual as Fagan-Bradley (~0.09″/year),
since the J2000 anchor would be exact by construction.
Validation layers:
planet_at() pipeline, which is externally validated against JPL
Horizons. Storing those positions in the fixture anchors aspect geometry to a
validated astronomical substrate.Fixture: tests/fixtures/aspects_reference.json
Generated by: scripts/build_aspects_fixture.py
Threshold: 1e-6 degrees
Test file: tests/integration/test_aspects_external_reference.py
Aspect tier: major aspects only
Tight-orb window: 1.0 degree
Epochs: J1900, J1950, J2000, J2024
Bodies: 10 major bodies (Sun through Pluto)
Minor aspects remain covered by the larger unit suite in
tests/unit/test_aspects.py.
Primary test file: tests/unit/test_rule_engine_validation.py
The following modules are pure arithmetic / rule-table engines with no ephemeris dependency. Their validation is therefore formula-derivation and invariant-based rather than external-oracle comparison.
Canon: Vettius Valens, Anthology II.37; William Lilly, Christian
Astrology (1647) p. 90
Formula: antiscion = (180 - lon) mod 360; contra = (360 - lon) mod 360
Validation: hand-derived reference table, round-trip invariants, contact
detection, and seam-edge cases
Canon: Reinhold Ebertin, The Combination of Stellar Influences (1940);
Alfred Witte, Rules for Planetary Pictures
Formula: shorter-arc midpoint; 90-degree dial projection
Validation: hand-derived midpoint table, commutativity, self-midpoint,
pair-count, sort-order, and seam-crossing invariants
Canon: Chris Brennan, Hellenistic Astrology (2017), Ch. 9; Vettius
Valens, Anthology, Book IV
Formula: profected ASC = (natal_asc + age * 30) mod 360; house =
(age mod 12) + 1
Validation: hand-derived table across ages 0-30, house-range guard,
monthly-lord length and first-lord invariants, and 12-year cycle identity
Canon: Porphyry, Introduction to Tetrabiblos; Hephaestio of Thebes,
Apotelesmatika I
Validation: Chaldean sequence, weekday day-ruler mapping, first night-hour
derivation, 24-hour completeness, and the next-day +3 shift invariant
Canon: John Addey, Harmonics in Astrology (1976)
Formula: harmonic longitude = (natal_lon * H) mod 360
Validation: hand-derived table, H1 identity, output-range invariant,
sorting, and harmonic-number clamping
Canon: Paulus Alexandrinus, Introductory Matters; Vettius Valens,
Anthology Books II-IV
Formula: ASC + Add - Sub modulo 360, with night reversal where doctrine
requires it
Validation: Fortune and Spirit day/night formulas, range guards, and the
Fortune/Spirit complement invariant
Canon: William Lilly, Christian Astrology Book I; Ptolemy,
Tetrabiblos I.17-22
Validation: essential dignity cases, accidental scoring bands, retrograde
penalties, cazimi / combust boundaries, mutual reception, total-score
invariant, traditional sort order, sect-light logic, and hayz conditions
The techniques below are not correctly described as “untested.” They already have real validation surfaces. The distinction is whether that surface is a finished external-oracle comparison or a strong internal / doctrinal pass.
Current validation surface: tests/unit/test_moira_progressions.py,
tests/unit/test_progressions_public_api.py,
tests/integration/test_progressions_external_reference.py
Backend standard: moira/docs/PROGRESSIONS_BACKEND_STANDARD.md
What is already validated:
swetest longitudes for secondary progressions at curated progressed datesWhat is not yet externally validated:
Fixture: tests/fixtures/progressions_swetest_reference.json
Builder: scripts/build_progressions_swetest_fixture.py
Threshold: 1.0 arcsecond
Status: externally validated for planetary positions and solar-arc values against offline Swiss references; angle-specific extensions remain desirable.
Current validation surface: tests/unit/test_dasha.py
Backend standard: moira/docs/DASHA_BACKEND_STANDARD.md
What is already validated:
Research conclusion:
Oracle harness now present:
tests/fixtures/vimshottari_reference.manual.jsonscripts/build_vimshottari_manual_fixture.pytests/integration/test_vimshottari_external_reference.pyReference doctrine adopted for Moira validation:
Lahirijulian_365.25 by default, with alternate basis handling tested explicitlyStatus: validated against doctrine and invariants. External Vedic software comparison is optional supplemental cross-checking, not a prerequisite for claiming a truthful validation story.
Current validation surface: tests/unit/test_primary_directions.py
What is now validated:
Status:
Current validation surface: tests/unit/test_parans.py,
tests/integration/test_parans_external_reference.py
Backend standard: moira/docs/PARANS_BACKEND_STANDARD.md
What is already validated:
Fixture: tests/fixtures/parans_horizons_reference.json
Builder: scripts/build_parans_horizons_fixture.py
Status: validated against an external event oracle for curated paran cases, plus the existing internal coverage for matching, policy, and field behavior.
Current validation surface: tests/unit/test_experimental_validation.py
Validated against the canonical diurnal-arc sector model:
This technique is already validated and should not be described as merely “mentioned.”
Current validation surface: tests/unit/test_experimental_validation.py
Validated as canonical equal-station arithmetic:
MANSION_SPAN = 360 / 28degrees_in stays in range for all tested longitudesThis is a real validation pass for the current doctrine. A future comparison to published mansion tables would be supplemental, not the first validation.
Current validation surface: tests/unit/test_timelords.py and
moira/docs/VALIDATION_EXPERIMENTAL.md
What is already validated:
Status: validated against doctrine and invariants. External software comparison may still be useful as supplemental cross-checking.
Recommended oracle: Astro.com chart output or Solar Fire
Threshold: 0.001 degrees
Useful next checks:
The current Placidus mundane implementation is now doctrine-validated.
Useful supplemental expansion:
External oracle coverage is already in place via the offline Swiss swetest
fixture in tests/fixtures/progressions_swetest_reference.json.
Useful supplemental expansion:
External oracle coverage is already in place for solar-arc values and directed
planetary longitudes via the offline Swiss swetest fixture.
Useful supplemental expansion:
External-software comparison for Vimshottari is now treated as supplemental, not foundational.
If performed, it must declare at minimum:
Useful supplemental checks:
Implementation note:
The subsystem is now externally anchored through Horizons-derived event timing for curated paran cases.
Useful supplemental expansion:
Recommended oracle: published lunar-mansion tables (Ibn Arabi, Picatrix, al-Biruni variants as implemented)
What to validate:
| Domain | Current state | Recommended oracle | Priority |
|---|---|---|---|
| House corpus expansion | Resolved 2026-04-09. Standard iterations expanded from 3,168 to 3,888 by including iflag=0 blocks (previously mislabelled as potentially radian-output; they are tropical degree output). ARMC-direct corpus added: 3,528 iterations exercising houses_from_armc() directly. Total validated corpus: 7,416 iterations, all passing at 3.6″. Sidereal blocks (1,080) audited: residuals are entirely in the ayanamsa layer (precession model difference), not house computation. Full audit documented in §4.3. |
Swiss setest/t.exp |
Closed |
| Sidereal true-ayanamsa target fixes | Fixed 2026-04-05. TRUE_REVATI target corrected 0° → 359°50′; TRUE_PUSHYA target corrected 106.667° → 106°. Errors dropped from 580–2413″ to 5–20″. Remaining residuals are model-basis differences (IAU 2006 vs Swiss precession). | Astro.com swetest |
Closed |
| Sidereal fixture coverage gap | Resolved 2026-04-05. Babyl Britton (sid=38) and True Mula (sid=35) added to fixture — 31 of 33 now covered. Aryabhata 522 has no Swiss equivalent (Moira-specific lineage). GALEQU_IAU1958 has 190″ base anchor difference vs Swiss sid_mode=32 (methodological, not drift). Both permanently excluded. | Astro.com swetest |
Closed |
| Aspects integration fixture | Resolved 2026-04-05. aspects_reference.json built from Horizons-validated positions. 7 cases across 4 epochs, 9 integration tests pass (J1900 skipped — no tight-orb aspects). |
Horizons-validated substrate | Closed |
| Vimshottari integration fixture | Resolved 2026-04-05. 3 cases populated (J2000 noon, India 1947, Aug 1985), all Lahiri + Julian year. 9 mahadasha + 9 antardasha per case verified by doctrinal self-consistency: nakshatra-lord sequence, canonical durations, proportional first-period balance. 4 integration tests pass. | Doctrinal self-consistency | Closed |