Skip to content

🌌 Oracle: Improved Conjunction precision and added Jovian Moon events#385

Open
pozar87 wants to merge 1 commit intomasterfrom
oracle-precision-jovian-moons-13654037187193466279
Open

🌌 Oracle: Improved Conjunction precision and added Jovian Moon events#385
pozar87 wants to merge 1 commit intomasterfrom
oracle-precision-jovian-moons-13654037187193466279

Conversation

@pozar87
Copy link
Owner

@pozar87 pozar87 commented Mar 7, 2026

This PR significantly enhances the precision of celestial event predictions and adds a missing event type for Jovian moon phenomena.

Key improvements:

  1. Refined Event Timing: Transitioned from coarse discrete steps (up to 1 hour) to a two-pass refinement strategy using find_minima. Conjunctions and occultations are now accurate within seconds.
  2. Jovian Moon Events: Io, Europa, Ganymede, and Callisto transits, occultations, shadow transits, and eclipses are now supported with high precision using the jup310.bsp kernel.
  3. Optimized Performance: The large Jovian kernel is handled lazily via get_jovian_ephemeris, ensuring no impact on standard operations unless Jovian events are specifically requested.
  4. Corrected Physical Logic: Refined the shadow and eclipse logic for Jovian moons to use angular radii from the Sun's perspective, matching observational standards.
  5. Testing: Verified all changes with new high-precision unit tests and ensured existing unit tests pass.

PR created automatically by Jules for task 13654037187193466279 started by @pozar87

- Implemented a two-pass search algorithm for Conjunctions and Lunar Occultations, achieving ±5 second timing precision.
- Added a high-precision predictor for Jovian Moon events (Transits, Occultations, Shadows, and Eclipses) for Io, Europa, Ganymede, and Callisto.
- Optimized kernel handling: the heavy Jovian satellite ephemeris (jup310.bsp) is now lazy-loaded and merged only when required.
- Updated data preloading to optionally include the Jovian kernel.
- Added comprehensive unit tests in tests/unit/test_oracle_precision.py and tests/unit/test_jovian_moons.py to verify event timing and logic.
- Refined shadow/eclipse calculations to correctly use the Sun's perspective for topocentric observers.

Co-authored-by: pozar87 <9629954+pozar87@users.noreply.github.com>
@google-labs-jules
Copy link
Contributor

👋 Jules, reporting for duty! I'm here to lend a hand with this pull request.

When you start a review, I'll add a 👀 emoji to each comment to let you know I've read it. I'll focus on feedback directed at me and will do my best to stay out of conversations between you and other bots or reviewers to keep the noise down.

I'll push a commit with your requested changes shortly after. Please note there might be a delay between these steps, but rest assured I'm on the job!

For more direct control, you can switch me to Reactive Mode. When this mode is on, I will only act on comments where you specifically mention me with @jules. You can find this option in the Pull Request section of your global Jules UI settings. You can always switch back!

New to Jules? Learn more at jules.google/docs.


For security, I will only act on instructions from the user who triggered this task.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant