Methodology — Calculation Engine, House Systems, Orbs, Dignities | DestinyKey
DestinyKey  ·  About  ·  Methodology  ·  Author

Methodology

This page documents every technical choice DestinyKey makes in its astrological calculations and the interpretive frameworks I use. I have written it for two audiences: astrologers who want to evaluate the platform against their own methods, and curious readers who want to understand what is happening behind the chart wheel. Nothing here is hidden behind generated text — if DestinyKey computes a value or makes a recommendation, this page explains the rule it followed.

Calculation engine

All planetary positions are computed using the Swiss Ephemeris, the same astronomical library used by professional astrology software such as Solar Fire, Janus, and Riyal. Swiss Ephemeris is derived from the JPL DE431 ephemeris developed by the Jet Propulsion Laboratory of NASA, with corrections for asteroid positions and stellar fixed points. Positional accuracy is at the arc-second level — for context, the disc of the Moon is approximately 1,800 arc-seconds across, so an arc-second is finer than any astrological orb in any school of practice.

The platform's city database holds more than 167,000 entries with verified coordinates and historical time-zone data. This matters because chart accuracy is bounded by birth-place accuracy: a one-degree longitude error shifts the Midheaven by approximately four minutes of arc, which can be the difference between two house cusps.

Historical date support

The chart engine works for any date in the Swiss Ephemeris range, which covers approximately 13,201 BCE to 17,191 CE. In practice this means DestinyKey produces accurate charts for:

Most public chart calculators fail before 1800 CE or produce visibly wrong house cusps for early dates. The DestinyKey archive of 200+ historical events is possible only because the engine handles the full historical range, and because the platform's city coordinates and time-zone tables are corrected for historical changes (the Julian-to-Gregorian transition, Soviet-era time zones, mid-20th-century US time-zone reforms, and similar historical complications).

Beyond individual chart calculation, the engine supports systematic historical scanning. The methodology paper underlying the platform's astropsychological reading of the 2025–2030 outer-planet bisextile, for example, drew on a 17,000-year scan (12,000 BCE to 5,000 CE — the full reliable range of the Swiss Ephemeris) of Uranus / Neptune / Pluto positions at 7-day resolution, identifying every moment in recorded astrological history when the three planets formed a partile triangle in the fire-air hemisphere with apex on the Vernal Point. This kind of large-scale pattern search is computationally inexpensive — roughly three minutes for a full seventeen-thousand-year scan — and gives any specific configuration a verifiable historical context rather than a rhetorical one.

House system

The default house system is Placidus, the most widely used system in modern Western astrology, based on the diurnal proportion of arc travelled by a degree of the ecliptic. This is the system I work with in my own practice for natal interpretation and for transits.

Alternative house systems available in the calculator:

For polar latitudes (above approximately 66° N or S), Placidus cusps become undefined for portions of the year. The platform automatically falls back to Whole Sign in those cases and notes this in the chart output.

Aspects and orbs

DestinyKey calculates the five major Ptolemaic aspects as the default set: conjunction (0°), sextile (60°), square (90°), trine (120°), and opposition (180°). The following minor aspects can be enabled in chart settings: quincunx (150°), semi-sextile (30°), semi-square (45°), sesqui-square (135°), quintile (72°), and bi-quintile (144°).

Six built-in orb systems govern how wide an aspect can be before it is no longer considered active:

System Conjunction Major aspects Minor aspects
Strict
Standard (default)
Soft 10°
Classic (Lilly) 10–12° for luminaries
New Age 12° 10°
Custom user-defined per planet pair user-defined user-defined

In my own practice I use Standard for general analysis and tighten to Strict when investigating specific behavioural patterns. Luminaries (Sun and Moon) receive a slightly wider orb than other planets in every system except Custom, following classical convention.

Essential dignities

For dignity scoring DestinyKey uses the Lilly / Ben Ezra system, the canonical traditional approach as articulated by William Lilly (1647) and Avraham Ibn Ezra (12th century):

Dignity Score
Domicile (rulership) +5
Exaltation +4
Triplicity +3
Term (Egyptian) +2
Face (decan, Chaldean) +1
Peregrine 0
Detriment −5
Fall −4

Triplicities follow the day/night chart distinction: the platform automatically detects whether the Sun is above or below the horizon and applies the appropriate triplicity ruler (Dorothean order: Sun/Jupiter/Saturn for fire, etc.). Terms use the Egyptian system (the most common in surviving traditional texts), not the Ptolemaic variant. Faces follow the Chaldean order.

A planet's total essential dignity score ranges from −5 to approximately +15 depending on how many dignities it holds simultaneously. I treat scores above +4 as strong dignity and below −2 as significant debility; values in between are interpretively neutral.

Rulership

The platform uses modern rulership as default: Pluto for Scorpio, Uranus for Aquarius, Neptune for Pisces. Traditional rulers (Mars, Saturn, and Jupiter respectively) are computed in parallel and used for dispositor chain analysis when the user toggles "traditional rulers" in settings.

This is a methodological compromise. I believe modern rulers carry interpretive weight that the tradition does not capture — Pluto in particular is too important to be subsumed under Mars — but traditional rulers carry a structural logic that the modern set does not. The platform makes both available rather than choosing for the user.

Lunar nodes

Mean nodes are used by default — the smoothed lunar node position. True nodes (the instantaneous osculating position) are available as an option. The difference between mean and true is typically within a degree but can matter for tight aspects to the node.

The platform also computes the lunar apogee (Black Moon Lilith) in both mean and osculating forms, alongside the Galactic Center and Vernal Point as supplementary reference points.

Asteroids and additional bodies

The four major asteroids — Ceres, Pallas, Juno, Vesta — are computed by default. Chiron is treated as a planet-class body and is always included; its interpretive weight in the modern tradition (Melanie Reinhart, Barbara Hand Clow) justifies this. Eris and additional Kuiper Belt bodies (Sedna, Haumea, Makemake) are available as optional inclusions for users specifically interested in them.

Fixed stars

DestinyKey includes a catalog of approximately 50 major fixed stars with conjunction detection (default orb 1°) and paran analysis (rising, culminating, setting, and anti-culminating at the same moment). The star catalog uses the Bright Star designations and includes the canonical names from Vivian Robson's Fixed Stars and Constellations in Astrology (1923).

Pattern detection

The chart engine automatically detects twelve classical configurations:

These figures are computed automatically and shown as overlays on the chart wheel.

Hellenistic luminary entourage

DestinyKey is one of the few public astrology platforms that displays the luminary entourage — the doryphoros (spearbearer, the planet leading the Sun or Moon) and the heniochos (charioteer, the planet following them). This technique comes from Hellenistic astrology (Vettius Valens, Anonymous of 379) and refers to the planet that rises just before a luminary (doryphoros) or just after it (heniochos), measured by zodiacal degree within an orb of 17° of the luminary in classical practice.

The interpretive value is structural: the doryphoros indicates what authority a person carries before them (how they enter situations, what announces them), and the heniochos indicates what supports them from behind (the resources they draw on, what completes their effort). When the doryphoros is benefic (Jupiter, Venus) the person carries authority easily; when malefic (Saturn, Mars) the entry into situations carries weight and friction.

This technique fell out of standard astrological education during the medieval period and was revived in the modern era through the work of Robert Schmidt and the Hellenistic translation projects. I include it because three decades of practice have shown it to be diagnostically valuable.

Dispositor chains

For each planet in the chart, the engine identifies its sign ruler, follows that ruler to its sign and ruler, and continues until either (a) a planet reaches its own sign and becomes a terminal disposer, or (b) the chain enters a closed loop (a mutual reception, or a larger cycle). The result is a directed graph showing the structural hierarchy of the chart.

Dispositor analysis reveals which planets carry the energy of others — which planet ultimately disposes of the chart's resources. A chart with a single terminal disposer concentrates great interpretive weight on that planet. A chart dominated by cycles distributes energy through reciprocity rather than hierarchy. The platform displays this as a diagram rather than hiding it in text.

Forecasts: daily, weekly, monthly editorial readings

DestinyKey publishes layered forecasts at three rhythms, each calculated from the actual sky for that period and read through the same astropsychological framework I use for natal interpretation.

Daily forecasts are generated with a fourteen-day rolling horizon for every locale. Each day carries its own unique signature, calculated from the Moon's sign and phase, the lunar day in the 28-day lunar cycle, the day's planetary ruler in the classical seven-day-week scheme (Sun on Sunday, Moon on Monday, Mars on Tuesday, Mercury on Wednesday, Jupiter on Thursday, Venus on Friday, Saturn on Saturday), and a numerological signature derived from the date. From these inputs the platform composes the day's reading and assigns a guiding colour of the day, a corresponding folk stone, and a thematic frame. No two days share the same combination — every reading is structurally distinct.

Weekly forecasts are published per ISO calendar week with their own dominant colour of the week, lunar phase progression, ingressions, and the week's planetary emphasis based on the active transits.

Monthly forecasts are full-length editorial readings covering:

The nested colour system (day → week → month) is the practical entry point to the platform's broader teaching on astrological harmonization through colour — described in detail in the next section. A reader does not need to understand the underlying harmonic theory to benefit from it: a person who simply wears the colour of the day, or surrounds themselves with the colour of the month, is already in an active resonant practice with the sky.

Forecasts are written in 18 languages and archived as a continuous library. This is not generic horoscope-column writing — each reading takes the actual configuration of the sky for that period and reads it through the same astropsychological framework I use for natal interpretation.

Astrological harmonization

A natal chart is not a verdict. It is a description of a person's psychological structure under tension. Some configurations carry ease — trines, sextiles, well-dignified planets. Others carry friction — squares, oppositions, planets in detriment or fall, tight malefic conjunctions. Astrological harmonization is the practical side of astrology: ways to work with the friction so that the underlying potential of the chart can express itself more freely.

I work with five harmonization vectors, drawn from both Western psychological astrology (Liz Greene, Howard Sasportas, Bruno and Louise Huber) and from older symbolic traditions documented in the practical Western canon. These are not magical promises; they are working practices that I have refined over three decades of consultation.

Relocation. Moving — even temporarily — changes the angular positions of the chart for the new location. A square that dominates the radix may relax in another city; a hidden trine may become angular and active. The Relocation tool on DestinyKey maps this by projecting your natal chart to any location worldwide, showing which planets gain and lose strength in each place. Pure mathematics, classical technique, no metaphysics needed.

Partner selection. Synastry can be used not only to predict compatibility but to consciously choose relationships that harmonize a difficult natal chart. A person with a heavy Saturn benefits from partners whose Jupiter or Venus contacts that Saturn; a person with Mars under stress benefits from partners whose Moon or Venus softens the Mars expression. This is partner selection as psychological structural work — not as romantic prediction.

Colour. The classical tradition associates each planet with characteristic colours — Mars with red, Venus with green and pink, Saturn with dark blue and black, the Sun with gold, the Moon with silver, Jupiter with purple, Mercury with yellow. Surrounding oneself with the colour of a planet that needs strengthening (through clothing, environment, art) is a low-key resonant practice with a long history in symbolic astrology. The mechanism is environmental and perceptual: what we see daily shapes what we attend to internally. DestinyKey integrates this directly into its forecasting layer — the colour of the day, week, and month assigned in every forecast reading is calculated from the dominant planetary energies of that period. A reader who simply wears the day's colour, or chooses a piece of jewellery in the month's stone, is already in active harmonization practice with the sky, whether or not they engage with the theoretical framework underneath.

Sound. The same principle extended to sound — musical modes, mantras, even specific composers and works associated with particular planetary energies. The tradition draws on Pythagorean correspondences and is documented in the modern practical literature (Joscelyn Godwin, Harmonies of Heaven and Earth; Marsilio Ficino, De Vita Coelitus Comparanda). For practical purposes: matching one's listening to the planetary themes one wants to strengthen.

Meditative practice on strong placements. Focused meditation on a strongly placed planet — the chart's Sun, a dignified planet at the angles, a ruler with multiple trines — can amplify its expression in daily life. This is structural psychological work, not metaphysical belief: a person with a strong Jupiter who consciously attends to Jupiter's themes (vision, generosity, learning) finds those themes strengthened in their actual experience.

These are not predictions, not guarantees, and not substitutes for medical, legal, or therapeutic care. They are working practices drawn from astrological tradition and refined through observation of what actually shifts in clients' lives. I describe them here for transparency — so the platform's recommendations on harmonization can be evaluated against the underlying logic.

Birth time rectification

Rectification — determining an unknown or uncertain birth time from life events — uses a two-step approach:

1. ASC sign identification. The user provides three to five major life events with dates. The engine tests each possible Ascendant sign (twelve candidates) against the transit/progression history of those events and ranks them by fit. This narrows the search to a two-hour window.

2. Precise rectification within the window. Once the ASC sign is determined, a finer search refines the exact birth time within the corresponding two-hour window by matching event timing to symbolic and secondary progressions, with transit caching to avoid recomputation. A typical rectification of this style runs approximately 80–100 chart computations rather than the 1,500+ a naive search would require.

This is not a substitute for a known birth time, but it produces a usable approximation when the certificate is missing or ambiguous.

What this site does not do

For full transparency: I do not predict death, illness onset, or specific medical events from a chart. I do not provide stock-picking or investment timing. I do not offer legal opinions. I do not produce predictions about other people based on a single person's chart — every reading is grounded in the chart of the person being read. The harmonization recommendations are practices, not guarantees.

Astrology, used as I use it, is interpretive and reflective. It maps patterns. It does not foretell outcomes.

Sources

The methodology above draws on the following primary and modern sources:

Questions and corrections

If you find an error in the calculations, or want to discuss a specific methodological choice, write to me at the email address on the author page. I read everything personally and will correct any factual error.