Planetary Ingress Dashboard [BlueprintResearch]

Visualizes when planetary ingresses, the moments when celestial bodies cross from one zodiac sign into the next, clustering them together in time. A centered rolling window counts how many bodies have recently changed or will soon change signs, revealing periods of concentrated sign-change activity as a color-coded histogram.

Powered by the open-source BlueprintResearch Planetary Ephemeris library — 511 of the 31,577 original VSOP87D terms (just 1.6%) — yet achieving sub-0.1° accuracy against NASA JPL's DE440 reference ephemeris. All celestial longitude calculations (VSOP87D planets, ELP2000-82 Moon, Meeus Pluto) run entirely in Pine Script.


█ CONCEPTS

An ingress occurs when a planet's ecliptic longitude crosses a 30° sign boundary (0° Aries, 0° Taurus, etc.). Individual ingresses are meaningful on their own, but when multiple planets change signs within a narrow time window, that convergence may carry additional significance for cycle-based analysis.

This concept draws on the extensive research of Patrick Mikula, whose published works on W.D. Gann's methods detail how clustered planetary sign changes can serve as a timing framework. The visual design pays homage to the cover art of Gann's Tunnel Thru the Air — the cityscape silhouette along the bottom of the cover inspired the histogram outline, the sand-dune terrain, and the blueprint-blue palette. This indicator provides tools to study and visualize that idea on any instrument and timeframe.

This indicator applies a centered ±N window (configurable in days or bars) around each chart bar. For each enabled body, it checks:
• Whether the body ingressed within the past N units (using a binary-search refinement to pinpoint exact crossing times)
• Whether the body will ingress within the next N units (by evaluating its longitude at a future timestamp)

The sum of these counts determines the histogram's height at each bar. Higher bars indicate more sign changes clustering around that moment in time.


█ FEATURES

Celestial Bodies
• 11 toggleable bodies — Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, and Lunar Nodes
• Each body has a unique color, shown in both histogram labels and future projection markers
• Sun, Moon, and Nodes are always geocentric; planets respect the Geocentric/Heliocentric toggle

Histogram Display
• Fill-based histogram with no drawing-object limits — works across the full chart history
• 5-tier discrete color gradient (1 ingress through 5+) — fully customizable
• Rolling sand-dune ground band with adjustable waviness for visual depth
• Dark blueprint-blue gradient background (toggle on/off, colors customizable)
• Histogram outline for building-silhouette definition

Future Projections
• Scans up to 500 bars ahead for upcoming ingresses
• Per-bar colored boxes indicate projected cluster intensity
• Individual planet symbol labels at each projected ingress, with hover tooltips showing the sign, date, and time
• Timezone selector for future date/time display (10 major zones)
• Sand dune and blueprint background extend seamlessly into the projection area

Performance
• Configurable bar calculation limit (default: 500 bars) for faster loading on instruments with deep history
• Set to 0 for unlimited calculation across all available bars

Ingress Timing
• A 15-iteration binary search between adjacent bars pinpoints the exact ingress moment
• Planet symbols are placed on the bar where the crossing actually occurred, not on the detection bar


█ HOW TO USE

1 — Enable the celestial bodies you want to track in the Celestial Bodies group
2 — Choose Geocentric (traditional, Earth-centered) or uncheck for Heliocentric (Sun-centered)
3 — Adjust the Rolling Window (±) to control cluster sensitivity — smaller values (1–2) highlight tight clusters, while larger values (5–10) reveal broader convergence zones
4 — Select Days or Bars for the window unit — Days uses calendar days (consistent across timeframes), while Bars uses chart bar duration (scales with your timeframe)
5 — Histogram bars appear in the lower pane — taller bars with warmer colors indicate more sign changes clustering near that date
6 — Planet symbols above histogram bars identify which bodies ingressed
7 — The future projection extends to the right of the current bar, showing where upcoming clusters are forming
8 — Hover over any future label to see the projected sign entry and date/time in your selected timezone
9 — If performance is slow on long-history instruments, reduce Limit Calculation (Bars) or keep the default of 500


█ LIMITATIONS & ACCURACY

The underlying ephemeris uses only 511 of the 31,577 original VSOP87D terms — just 1.6% — yet achieves sub-0.1° accuracy for every planet. It has been cross-validated against NASA JPL's DE440 reference ephemeris (via Skyfield).

Positional Accuracy (RMS vs JPL DE440):
• Sun: 0.004°
• Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune: 0.005°–0.017°
• Moon: 0.062°
• Pluto: 0.059° (Meeus method, valid 1900–2100)

All planets achieve sub-0.1° RMS accuracy. In practice, ingress timing has been manually verified against professional ephemerides:
• Sun, Moon, Mercury, Venus, Mars: Within minutes to ~1 hour
• Jupiter, Saturn: Within a few hours
• Uranus, Neptune, Pluto: Same-day accuracy — typically within ~18 hours, even for the slowest-moving bodies

Accuracy validation plots (Pine Script vs JPL DE440) are available in the library release notes.

Moon on Daily+ Charts:
The Moon changes signs approximately every 2.5 days. On daily or higher timeframes, some Moon ingresses may fall between bars and be missed. For best Moon coverage, use a 12-hour or lower timeframe. A warning label appears when the Moon is enabled on daily or higher timeframes.

Recommendation: For mission-critical timing, always cross-reference with professional tools such as JPL Horizons, Swiss Ephemeris, or Astro.com.


█ WHAT MAKES THIS ORIGINAL

Most planetary indicators on TradingView show individual planet positions or single-planet events. This dashboard takes a fundamentally different approach: it aggregates sign-change events across all enabled bodies into a unified time-density visualization, answering the question "When are multiple planets changing signs at the same time?"

Key technical contributions:
• Multi-body ingress clustering algorithm with a centered rolling window
• Binary-search ingress refinement (15 iterations) for sub-bar timing precision
• Fill-based historical histogram (unlimited data) combined with polyline/box-based future projection
• Full VSOP87D + ELP2000-82 + Meeus ephemeris computed in real time within Pine Script — 511 terms (1.6% of the full theory) delivering sub-0.1° accuracy against JPL DE440


█ COMPANION INDICATOR

• Planetary Ingress — A single-planet ingress indicator with on-chart labels, retrograde markers, and per-sign alerts. Use it with this dashboard to view individual planet details while monitoring cluster activity here.


█ OPEN SOURCE

This indicator is part of the fully open-source Planetary Ephemeris project. The core ephemeris library is publicly available for study, modification, and reuse in your own scripts:
• BlueprintResearch/blueprint_ephemeris_lib — Planetary calculation engine (VSOP87D, ELP2000-82, Meeus)


█ FURTHER READING

For the research on ingress clustering as a timing method, see Patrick Mikula, Gann's Scientific Methods Unveiled, Volume 1, Chapter 7: Planetary Ingress.