How Electional decides which windows rise to the top.
This page shows the same scoring logic the product uses live. The goal is simple: help you understand why a window looks strong before you decide to trust it.
Bigger sky conditions matter first. Natal fit matters more than transit-to-transit pattern noise. Additive caps and hard gates keep later refinements from overpowering the core signal.
1
Baseline
5 layers · Tier 1
Macro weather first. The engine checks Moon condition, a single continuous phase term, sign, true void-of-course, eclipse pressure, Via Combusta, besiegement, and overall benefic versus malefic pressure before later refinements matter.
2
House Alignment
4 layers · Tier 1-2
The scorer uses the real election Ascendant, Midheaven, and house frame at the peak moment instead of natal-angle proxies. Natal topical house rulers still come from the birth Ascendant frame; temporary election Ascendant ruler condition is a light chart-context modifier. Discovery contacts live in their own bounded Pass 7 lane.
3
Intent Fit
10 layers · Tier 1-2
Primary significators are judged as actual actors: dignity, debility, under-beams/combust/cazimi, speed, ingress risk, angularity, planetary day/hour, house joy, hayz, out-of-bounds state, and oriental/occidental condition.
4
Natal Compatibility
6 layers · Tier 3
Transit-to-natal remains deliberately stronger than transit-to-transit. The engine grades natal targets as ally, usable, developmental, or red-flag; checks topical natal occupants; reports annual profections and solar-return / Lord-of-the-Year context beside the timing score; identifies the chart's more difficult malefic; and scores planetary return windows with Jupiter returns leading.
5
Finalization
5 layers · Tier 4
Once the chart already works, the engine adds advanced traditional refinements: transit-to-transit sky patterns, lunar mansions, lots of Fortune and Spirit, antiscia and contra-antiscia, node contacts, translation or collection of light, and prohibition mechanics.
6
Solar Return Transits
5 layers · Secondary
On by default when solar return / annual context is enabled. Scores current transits against the solar-return chart's own angles and key points as a tightly-bounded confirmation layer. It is deliberately secondary: it can corroborate or lightly time, never override the natal-anchored result, and never creates a window. The annual story still anchors to the natal chart (spec: docs/solar-returns-electional.md §10–§12).
7
Discovery Contacts
5 layers · Secondary
On by default, and only populated when the request enables the asteroid and/or fixed-star finder. Reads curated asteroid, fixed-star, and galactic contacts as minor testimonies. Deliberately secondary: hard-capped well below the planetary lanes, never creates a candidate window, never defines a window's span, and never overrides a gate.
Full Calculation Map
Every step, every rule, in one chart
From raw transit hits to the ranked window list: candidate selection, the capped scoring passes and their rule layers, hard gates, global modifiers, the score formula, and the band cutoffs. This is the same chart kept in our internal engine docs.
Drag to pan. Wheel or controls to zoom. Default view is magnified for readability.
145%
Pass 1
Baseline - Tier 1
Macro weather first. The engine checks Moon condition, a single continuous phase term, sign, true void-of-course, eclipse pressure, Via Combusta, besiegement, and overall benefic versus malefic pressure before later refinements matter.
dominant
Moon next applicationThe first Ptolemaic Moon-to-planet perfection before sign exit carries the heaviest lunar weight. Minor aspects cannot displace it; conjunctions to Mars or Saturn are malefic testimony.
major
True void-of-courseComputed by sign-exit logic, with a softer penalty for severing or banishing work.
major
Phase and sign affinityTopic-fitting Moon signs remain a Tier 1 filter. One continuous phase term follows the intent mode: increase favors waxing, decrease favors waning, reveal peaks at Full Moon, and stabilize stays phase-neutral.
major
Eclipse geometryEclipse pressure requires both a nearby syzygy and that syzygy's longitude near the nodal axis; an ordinary Moon-node crossing cannot fire it.
moderate
Via Combusta and besiegementTraditional distress markers for the Moon or key significators are calculated directly.
Pass 2
House Alignment - Tier 1-2
The scorer uses the real election Ascendant, Midheaven, and house frame at the peak moment instead of natal-angle proxies. Natal topical house rulers still come from the birth Ascendant frame; temporary election Ascendant ruler condition is a light chart-context modifier. Discovery contacts live in their own bounded Pass 7 lane.
dominant
Topical house ruler supportIf the target house ruler is opened, the election can work. If it is damaged, refinements do not rescue it.
light
Election Ascendant ruler conditionTemporary Ascendant ruler dignity, debility, retrogradation, combustion, and topical links are scored as secondary chart context.
major
Real election chart geometryPlanet houses, angularity, and angle overlays are computed from the actual peak chart.
moderate
Angular benefics and maleficsBenefics on angles help; a malefic tightly occupying any elected angle can hard-cap non-decrease work.
Pass 3
Intent Fit - Tier 1-2
Primary significators are judged as actual actors: dignity, debility, under-beams/combust/cazimi, speed, ingress risk, angularity, planetary day/hour, house joy, hayz, out-of-bounds state, and oriental/occidental condition.
dominant
Primary significator dignityOne shared five-tier engine resolves domicile, exaltation, triplicity, term, and face plus debility, once per planet.
major
Visibility and speedUnder the beams, combustion, cazimi, retrogradation, swiftness, slowness, and ingress risk are each chart-state receipts scored once per planet.
moderate
Declination decorrelationA parallel is suppressed from scoring when the same pair already has a zodiacal aspect; otherwise only the tightest declination contact per transiting planet contributes. The complete contact list remains visible in exports.
major
Rarity & high-impact transit weightingOrdinary hits carry 1.2x, Jupiter 1.8x, outer planets (Saturn/Uranus/Neptune/Pluto) 2.4x, and slow outers 3.8x; a true station (|velocity| ≤ ~0.012°/day) adds a further 1.3x. A source in detriment or fall delivers only 65% of its aspect potency across direct, pressure, and aspect-family lanes. Outer-to-outer Tr-Tr aspects get an additional 1.4x compound bonus, and harmonious Venus-Jupiter Tr-Tr hits get a 1.35x bonus, amplified by 1.2x when either benefic is in domicile or exaltation. Tr-Na dominance remains 1.5x.
major
Planetary returnsTransiting planet conjunct its own natal degree within 2° fires a once-per-cycle anchor activation bonus (distinct from natal-echo pattern reproduction).
major
Eclipse axis on natal anchorEclipse axis within ~3° of a natal angle, luminary, or significator escalates the eclipse signal — heavier penalty for constructive intents, release-tenor bonus for destructive intents.
Planetary day and hourThe day/hour stack remains one of the strongest refinements after the macro chart is acceptable.
moderate
House joy and hayzTraditional placement refinements are included instead of being left as prose-only lore.
light
Orientation and out-of-bounds stateOriental/occidental and declination-driven volatility are included as smaller adjustments.
Pass 4
Natal Compatibility - Tier 3
Transit-to-natal remains deliberately stronger than transit-to-transit. The engine grades natal targets as ally, usable, developmental, or red-flag; checks topical natal occupants; reports annual profections and solar-return / Lord-of-the-Year context beside the timing score; identifies the chart's more difficult malefic; and scores planetary return windows with Jupiter returns leading.
dominant
Transit-to-natal dominancePersonalized windows are still ranked with a hard Tr-Na bias over sky-only patterns.
dominant
Natal target conditionThe condition of the natal planet being activated materially changes the score.
major
Topical natal occupantsThe relevant natal house is not reduced to its ruler; occupants are also scored as first-class targets.
major
Planetary returnsJupiter returns lead the return family, but Venus, Mercury, Mars, Saturn, and lunar returns are also checked.
moderate
Solar return & profection (annual context)Profected house, Lord of the Year, and the solar-return chart are capped, receipted background context. They do not enter minute-level totals or ranking, never create windows, and never relocate the natal chart. On by default; see docs/solar-returns-electional.md.
moderate
Worst-malefic filteringThe chart's more difficult malefic is tracked separately instead of treating Mars and Saturn as interchangeable.
Pass 5
Finalization - Tier 4
Once the chart already works, the engine adds advanced traditional refinements: transit-to-transit sky patterns, lunar mansions, lots of Fortune and Spirit, antiscia and contra-antiscia, node contacts, translation or collection of light, and prohibition mechanics.
major
Sky-pattern contextTransit-to-transit configurations including grand trines, T-squares, kites, minor grand trines, cradles, and stellia refine the window after the personalized layers have spoken.
moderate
Lunar mansion matchingThe Moon's mansion remains an active traditional filter, not a marketing-only concept.
moderate
Lots and lots contactsFortune and Spirit are calculated and checked for benefic support or malefic affliction.
light
Antiscia and node contactsLower-weight but real hidden-contact and nodal amplifying/severing logic is included.
light
Translation, collection, prohibitionPerfection mechanics are tracked as subtle support or obstruction layers.
Pass 6
Solar Return Transits - Secondary
On by default when solar return / annual context is enabled. Scores current transits against the solar-return chart's own angles and key points as a tightly-bounded confirmation layer. It is deliberately secondary: it can corroborate or lightly time, never override the natal-anchored result, and never creates a window. The annual story still anchors to the natal chart (spec: docs/solar-returns-electional.md §10–§12).
moderate
Transits to SR anglesOuter planets to SR Asc/MC/Desc/IC are the heaviest, year-defining contacts; partile (≤1°) angle hits carry the most weight.
moderate
Transits to SR Sun / Moon / rulerTransits to SR Sun, SR Moon, the SR Ascendant ruler, and the profected Lord of the Year in the SR.
light
Mars as triggerTransiting Mars is weighted as the short-term timing trigger; applying contacts outweigh separating.
light
Tight Discepolo orbsOuter planets ≤2°, all other transiting bodies ≤3°, angle contacts ≤1°; major aspects only.
light
Natal de-duplication & capContacts that merely echo a natal transit at the same degree are down-weighted; the whole layer is hard-capped well below the natal lane.
Pass 7
Discovery Contacts - Secondary
On by default, and only populated when the request enables the asteroid and/or fixed-star finder. Reads curated asteroid, fixed-star, and galactic contacts as minor testimonies. Deliberately secondary: hard-capped well below the planetary lanes, never creates a candidate window, never defines a window's span, and never overrides a gate.
light
Curated catalog onlyOnly bodies in the curated discovery catalog score; broader Swiss Ephemeris fixed-star matches stay display-only context.
moderate
Nature against the operation axisSupportive natures favour build operations, challenging natures (Algol, Antares) penalize build and favour release/severing work.
light
Fixed stars over minor bodiesFixed stars outweigh asteroids, which outweigh galactic points, matching traditional rank.
light
Tight finder geometryConjunction/opposition within 1° only; contacts decay as the window peak moves away from their own exactitude.
light
Significator and natal emphasisContacts on angles, intent significators, or luminaries weigh more; asteroid-to-natal contacts outrank sky-only ones.
Global Modifiers
Applied across the whole engine
These settings adjust emphasis without changing the product's overall ranking philosophy.
Pass capsabsolute caps/floors
Each pass is capped additively; empty buckets no longer refill themselves to a fixed score budget.
Strictness0.85x / 1.0x / 1.2x
Relaxed, standard, and strict modes scale the whole rule set without changing its ordering philosophy.
Natal weight0.0 - 2.0
User-controlled emphasis on natal compatibility while preserving the engine's hard Tr-Na preference.
Applying vs separatingweighted
Applying contacts remain stronger than separating ones, especially for the Moon.
Orb strengthtightest wins
Partile contacts outrank loose ones, and minor advanced layers stay on tight orbs.
