Eclipses, occultations, transits and shadow transits
- Four phenomena, two viewpoints. An eclipse and a shadow transit are decided by the satellite's position as seen from the Sun. An occultation and a transit are decided by its position as seen from the Earth. The two views differ by Jupiter's phase angle, at most about 12 degrees 1 2.
- The classical computation is two cones and an ellipsoid. Thuillot (1983) puts a point Sun or a point Earth at the vertex of a cone tangent to an oblate Jupiter, . An event is the instant the satellite centre crosses the cone, solved by iteration with separate light-time rules for each phenomenon 2.
- Published times are mid-events in TT. The Institut de mécanique céleste et de calcul des éphémérides (IMCCE) times an eclipse at half the satellite's light and the other events at bisection of the satellite. A visual observer sees the last or first speck instead, 1 to 2 minutes away for Io and Europa and up to 15 minutes for Callisto 3 4.
- Jupiter's penumbra at the satellites is 750 to 3400 km wide. That width is . It reproduces Westfall's table, as do the ingress durations of 4.2 minutes for Io to 16.6 minutes for Callisto that follow from it 4 5.
- Jupiter's atmosphere blurs the eclipse. Refracted and scattered light makes a "refractive tail" lasting minutes in the red. The cloud tops cut the light off at about 9 magnitudes of darkening. The height of the half-light level is not established in the eclipse literature cited here, and Horizons and Thuillot both leave the atmosphere out 6 7.
- The phase correction is minutes, not seconds. Taking the limb or terminator instead of the ellipsoid shifts shadow and transit contacts by up to 3 minutes for Io and 6 minutes for Callisto near quadrature 2.
- Eclipses of Io gave the first finite speed of light. Cassini announced a delay of "ten or eleven minutes" across half the Earth's orbit on 22 August 1676. Rømer explained it as light's travel time in the Journal des Sçavans on 7 December 1676 8.
The question. How are the start and end of an eclipse, an occultation, a transit and a shadow transit of a Galilean satellite computed? Which geometry is used for the shadow and for Jupiter's disc, how do light-time and Jupiter's phase enter, what instant does a published time refer to, and how accurate are the published tables?
Four phenomena and two viewpoints
The observing guide of IMCCE's Natural Satellites Data Center (NSDC) defines the satellite-planet phenomena by viewpoint. "When the Sun passes through the orbital plane of a satellite, the shadow of the planet may eclipse the satellite and the umbra of the satellite may pass on the disk of the planet." These are the eclipseeclipse of a satelliteThe passage of a satellite through Jupiter's shadow. It depends only on the Sun's direction. Disappearance (EC D) and reappearance (EC R) are timed at half the satellite's normal light. and the transit of the umbrashadow transitThe passage of a satellite's shadow across the disc of its planet, seen as a small dark spot on the cloud tops. It is fixed by the Sun's direction, like an eclipse, and its contacts are the shadow's contacts with the planet's limb. (shadow transit), and they "are observable independantly of the observer". When the Earth passes through the orbital plane, the observer sees an occultationoccultation by JupiterThe passage of a satellite behind Jupiter's disc as seen from the Earth. Disappearance (OC D) and reappearance (OC R) are timed when the limb bisects the satellite. or a transittransit of a satelliteThe passage of a satellite in front of Jupiter's disc as seen from the Earth, from ingress (TR I) to egress (TR E). of the satellite, which "depend on the observer" 1.
IMCCE's prediction files use eight codes. EC D and EC R are the disappearance and reappearance of an eclipse. OC D and OC R are those of an occultation. TR I and TR E are the ingress and egress of a transit, and SH I and SH E those of a shadow transit 3. The French files write E. c., E. f., Im., Em., P. c., P. f., O. c. and O. f. 3.
The phase angle is the angle Sun-Jupiter-Earth. Its maximum is for an Earth-Sun distance and a Jupiter-Sun distance . Jupiter's perihelion distance is about 4.957 au, the minimum of Meeus's 9. With au that gives 11.6 degrees. With the Earth also at aphelion, au, it gives 11.8 degrees, the largest value. The separation between the Sun zones and the Earth zones has two consequences. Before opposition only Io's disappearances into the shadow can be seen, and after opposition only its reappearances, because Jupiter hides the other end 4. For Ganymede and Callisto both ends are often visible within a few hours 4.
Jupiter's shadow at the satellites
Jupiter's shadowJupiter's shadowThe umbral and penumbral cones cast by Jupiter away from the Sun. At the Galilean satellites the umbra is barely narrower than Jupiter and the penumbra is a rim about 750 to 3400 km wide. has the same construction as the Moon's in the Besselian elements. A cone of exterior tangents to the Sun and Jupiter bounds the umbra. A cone of interior tangents bounds the penumbra. For a satellite at distance behind Jupiter, measured along the shadow axis, with Jupiter at distance from the Sun, the small-angle radii are
The cone with its vertex at the Sun's centre, Thuillot's "Soleil ponctuel" 2, has the radius
which is the mid-line of the penumbra. This follows from the small-angle forms above, since exactly. It is a derivation, not a statement of the cited sources. A small satellite on that line sees Jupiter's limb pass through the Sun's centre, so about half the Sun's light reaches it. That is why a computation for the satellite's centre and a point Sun approximates the half-flux instant that IMCCE publishes 3.
The umbral cone is about 1250 Jupiter radii long, so all four satellites pass through the full shadow. The table evaluates the formulas with km and km from the IAU 2015 values in NAIF's PCK 5. It uses au, the constant term of Meeus's Jupiter-Sun distance 9, and the orbital radii, speeds and diameters of the Association of Lunar and Planetary Observers (ALPO) instructions by Westfall 4. The solar radius is the IAU 2015 nominal value. The rest of this corpus predicts solar eclipses with 696,000 km. That value would widen each by 0.04 per cent, less than 2 km for Callisto.
| Satellite | (km) | (km) | (km) | (km) | Westfall penumbra (km) | Central ingress (min) | Westfall ingress (min) | Central eclipse (min) | Westfall eclipse (min) |
|---|---|---|---|---|---|---|---|---|---|
| Io | 421,800 | 71,154 | 71,907 | 753 | 754 | 4.2 | 4.2 to 4.5 | 137.6 | 128 to 138 |
| Europa | 671,100 | 70,954 | 72,153 | 1198 | 1200 | 5.3 | 5.2 to 6.4 | 173.6 | 135 to 174 |
| Ganymede | 1,070,400 | 70,635 | 72,546 | 1911 | 1915 | 11.0 | 10.9 to 18.2 | 219.3 | 126 to 220 |
| Callisto | 1,882,700 | 69,984 | 73,346 | 3362 | 3367 | 16.6 | 16.8 to 134.8 | 291.0 | 0 to 290 |
Here is the satellite's diameter and its orbital speed. The formulas give the lower bound of each ingress range and the upper bound of each eclipse range. Those are the central, perpendicular crossings, and Westfall's ranges cover oblique ones 4. Callisto's long ingress and zero-length eclipses are grazing passages. Callisto's centre enters the shadow only when with the equatorial radius, or with the polar radius. Jupiter's equator is inclined to its orbit 9. Callisto therefore "has eclipses only half the time", for three-year periods separated by three years 4.
Jupiter's figure in the test
Jupiter is an oblate spheroid with radii 71,492, 71,492 and 66,854 km in the IAU 2015 values 5. Its flatteningJupiter's flatteningThe fractional difference between Jupiter's equatorial and polar radii, with the IAU 2015 radii. It makes the disc and the shadow ellipses about 6.5 per cent shorter north to south. is , and . JPL's satellite kernels adopt the same equatorial radius 10 11.
Thuillot's formulation keeps the spheroid exact. In a jovicentric equatorial frame Jupiter is
with the equatorial radius and the geometric flattening 2. A satellite at lies on the cone with vertex at the Sun's centre , tangent to the spheroid, when
The cone of visibility from the Earth's centre is the same expression with for , 2. means the satellite is inside the shadow cone. means it is inside the cone of visibility, that is, behind or in front of the disc 2. Which of the two depends on whether the satellite is beyond Jupiter or between Jupiter and the Sun or Earth. Thuillot takes the pole of Jupiter from Null (1976) and solves the equations by successive approximation 2.
Simpler implementations stretch Y. PyMeeus multiplies the coordinate by 1.071374 and tests . It uses the Earth-view coordinates for occultations and the Sun-view coordinates for eclipses, and the sign of for which side of Jupiter the satellite is on 12. The factor 1.071374 does not equal the IAU 2015 ratio 1.069375. The code does not say where it comes from 12 5. The test also uses a cylinder of radius 1. It ignores both the converging umbra and the half-flux cone . Its event times therefore refer to neither the half-flux instant nor the umbra contact. Horizons ignores the flattening altogether. Its visibility codes take "the equatorial value" for both the primary and the satellite, and "Atmospheric effects and oblateness aspect are NOT currently considered" 7.
A rigorous program applies the flattening to the projected disc. A spheroid seen from a direction at jovicentric latitude projects to an ellipse with semi-major axis and semi-minor axis , where is the polar radius. Use for the disc and for the shadow. Thuillot's cone equation contains this projection implicitly 2.
Light-time: two clocks
The phenomena mix two light paths. Thuillot gives the rules for a time in Ephemeris Time, with and the Earth-satellite and Earth-Jupiter distances and the speed of light. For occultations and transits the paper prints that "le satellite doit être considéré dans sa position à t − TQ/C et la Terre dans sa position à t − TJ/C". The date that satisfies the equations is "la date du phénomène perçu sur Terre" 2. As printed, the second clause delays the Earth. Since is the date of reception at the Earth, the physically consistent reading delays Jupiter, the occulting body, to and keeps the Earth at . This note takes that reading, as its own correction of the printed text. For eclipses and shadow transits, the Sun is taken at . The date seen from the Earth is then for an eclipse and for a shadow transit 2. With a phase correction, the terminator is set by the Sun at , and the limb that bounds a shadow is the one seen from the Earth at 2.
With the Earth-Jupiter distance between about 4.0 and 6.4 au, the light-timelight-timeThe travel time of light to the observer, about 499 seconds from the Sun and 1.3 seconds from the Moon. A reception correction evaluates the target at emission time and the observer at reception time. Observer aberration is separate. days is 33 to 53 minutes 9. That full span needs several apparitions, because Jupiter's distance from the Sun runs from about 4.96 to 5.46 au over its 12-year orbit. Within one synodic period changes by about 2 au, the diameter of the Earth's orbit, so the light-time changes by about 16 minutes. That drift was the first evidence for a finite speed of light. Within the satellite system, Meeus's high-accuracy method applies the differential light-timedifferential light-timeThe correction for a satellite being nearer to or farther from the Earth than Jupiter, so that its light left at a slightly different time. In Meeus's form it shifts X by times a geometric factor, with K close to the speed of light divided by the satellite's orbital speed. to X, where Z is the satellite's distance along the line of sight in Jupiter radii 9. For Io at Jupiter radii it is about Jupiter radii, or 25 km. That is 1.4 seconds of Io's motion. Refraction, light-time and frames covers the observer-side corrections, which are the same as for the Sun and Moon.
The IMCCE tables give the instants in TT. To convert to UT, subtract TT − UT 3. Their table of TT − UT runs from 61 s in 1994 to 69 s from 2017 on, and the 2026 UT edition uses 69 s 3 13. The difference is ΔTΔTThe difference TT − UT1 between uniform Terrestrial Time, in which the elements are computed, and Universal Time, which follows the Earth's irregular rotation. About 69 s in 2024. It converts the hour angle μ to a geographic longitude, is known only by prediction for future eclipses, and is the largest error source for historical ones..
The phase correction
Thuillot's basic cones rest on the spheroid. They give the right answer when the satellite and the Sun, or the satellite and the Earth, are on opposite sides of the Sun-Earth-Jupiter line. In the other cases the cone must rest "non plus sur l'ellipsoïde mais sur le limbe dans le cas des ombres, ou sur le terminateur dans le cas des passages" 2. Thuillot lists the affected events. Before opposition they are the beginnings of shadow transits and the ends of transits. After opposition they are the ends of shadow transits and the beginnings of transits 2. For those cases he replaces and by and 2.
The limb seen from the Earth is the intersection of the ellipsoid with the plane . Thuillot substitutes the generator of the Sun's cone, , and eliminates the parameter . The result, his equation 4, replaces equation 2 for shadow transits with a phase correction 2:
His equation 5 is the same construction for transits, with the cone from the Earth resting on the terminator, the plane 2:
Here , and are the column vectors of the Sun's centre, the Earth's centre and the satellite in the jovicentric equatorial frame, and and are as above. The sign convention is reversed from and . means the satellite is inside the phase-corrected shadow cone, and means it is inside the phase-corrected cone of visibility 2.
The phase correctionphase correctionThe shift in a predicted contact caused by Jupiter's terminator not coinciding with its limb when the Sun and Earth directions differ. Thuillot gives up to 3 minutes for Io and 6 minutes for Callisto near quadrature. "atteint près de la quadrature 3 min de temps pour le satellite 1 et 6 min pour le satellite 4" 2. A shadow seen against the unlit part of the disc beyond the terminator is invisible. A satellite crossing the terminator is still in front of the disc. A program that tests only the sky-plane disc gets these events wrong by minutes near quadrature.
What "start" and "end" mean
Four conventions are in use:
| Convention | Used by | Instant |
|---|---|---|
| Half flux for eclipses, bisection by the limb or shadow edge for the others | IMCCE phenomena files and the Connaissance des Temps | satellite centre on the point-Sun cone or on the limb 3 |
| Half flux, or the instant computed from first or last speck | IMCCE's archive of observed eclipses 1652 to 1983 | mid-event, with the semi-duration TQ to the last or first speck recorded 14 |
| Centre of the satellite touching the limb | Juptool (Nagoya) | centre contact 15 |
| Limb-to-limb with equatorial radii | Horizons observer tables, quantity 12 | first and last contact, no flattening 7 |
IMCCE states the convention twice. "The dates t of the mid event (the satellite or its umbra is bissected) are given in the TT time scale". "Each event is computed for the center of the satellites: for the eclipses these dates are approximately the half brightness (or mid event), for the other phenomena they correspond to the bissection of the satellites" 3. The NSDC guide adds that published eclipse times are "commonly the time of the mid-extinction or mid-reappartion of the satellite (half flux of the satellite visible unless another specification in the comments)" 1. This is the mid-event conventionmid-event conventionThe rule that a published eclipse time is the instant of half flux, and an occultation, transit or shadow transit time the instant the limb or shadow edge bisects the satellite. A visual observer sees the last or first speck instead, a minute or more away..
A visual observer does not see the mid-event. Westfall's instructions say to time "the 'last speck'" at disappearance and the "first speck" at reappearance. They warn that "Io and Europa typically reappear about 1-2 minutes 'early' and disappear the same amount 'late.' Ganymede's time difference is more like 4-8 minutes, and can be up to about 15 minutes for Callisto" 4. Juptool's manual makes the same point for centre contacts: "the real starting or ending time may be a few minutes earlier/later than the center contact time" 15.
Horizons reports a visibility code per output step, not event times. The codes are /t transiting, /O occulted, /p partial umbral eclipse, /P occulted partial umbral eclipse, /u total umbral eclipse, /U occulted total umbral eclipse and /* free and clear. They refer to "limb-to-limb" contact, and "Light-time is considered" 7. The list has no code for a shadow transit, and no code for a penumbral-only eclipse 7.
Simultaneous events
Thuillot warns that the end or the start of an eclipse or an occultation can be invisible when the satellite is already occulted or eclipsed. All four phases, OC.D and OC.F, EC.D and EC.F in Thuillot's notation, must therefore be computed before any one is declared visible 2. The combined events that observers look for follow by the same logic. Each phenomenon is a time interval, from its start event to its end event in the per-satellite lists. A double or triple shadow transit is the overlap of two or three SH I to SH E intervals. A satellite in transit with its own shadow on the disc is the overlap of its TR and SH intervals. Jupiter with no Galilean satellite visible beside it is the time when each of the four satellites is inside one of its own OC, EC or TR intervals. That is the intersection, over the four satellites, of each satellite's union of those intervals. These rules are derived here from the interval structure of the published lists, not quoted from a source.
Jupiter's atmosphere and the eclipse light curve
The shadow edge is not sharp, and not only because of the penumbra. Shorthill, Greene and Smith observed twelve eclipse light curves at 30 wavelengths with the 200-inch Hale telescope. "Sun light is refracted and scattered into the geometric shadow resulting in a 'refractive-tail'" 6. At 7300 Å the refractive tailrefractive tailThe slow final fading of an eclipse light curve caused by sunlight refracted and scattered through Jupiter's atmosphere into the geometric shadow. It lasts minutes at red and near-infrared wavelengths. lasts several minutes. At 11000 Å it lasts longer. At 5000 Å the light curve "falls very rapidly and may show no refractive-tail at all" 6. "At some point (mv≈9) a ray passing tangentially through the atmosphere will be cut off by the cloud tops" 6. Eclipses probe the atmosphere "to greater depths ... in some cases, to the cloud deck" than stellar occultations do 6. Even in totality the satellites are not dark. Tsumura et al. measured Europa, Ganymede and Callisto at to of their uneclipsed brightness near 1.5 micrometres 16.
The altitude above the 1-bar level, or the radius in km, at which the half-flux point of a Galilean eclipse falls is not stated by Shorthill et al., Thuillot, IMCCE or the Horizons manual. Thuillot's predictions are made "sans considérer l'influence de l'atmosphère de Jupiter" 2. Horizons does not model it 7. So the published instants are geometric half-flux instants for a solid spheroid. The observed half-flux instant differs from them by an amount that depends on the wavelength band. The size and sign of that offset are an open question.
Published products
IMCCE phenomena files. IMCCE publishes yearly prediction files for all four phenomena 3. They are computed by V. Lainey, M. Gastineau and J. Nepper from 2023 and by W. Thuillot from 1996 to 2022 3. The phenE.yyyy file lists each month's events in four columns in TT. Eclipse times are given to 0.1 minute and other events to the minute, for example "26 1 1 1546.3 I EC D" 13. The xyE.yyyy file gives "the differential coordinates X and Y of the Galilean satellites (X towards the East and Y towards the North) during an eclipse at a date near the middle of each month" 3. The JovianEventsUTyyyy.txt file gives UT rounded to the minute, the conjunctions and the dates when Jupiter is not observable 3. In 2026 that period runs from July 2 to August 25 (TT) 13.
Connaissance des Temps. IMCCE also distributes the phenomena "under the form of Chebychev polynomials as published in the ephemeris Connaissance des Temps" 17. Thuillot designed that form. For each satellite and each phenomenon, 15 ChebyshevChebyshev polynomialsThe piecewise polynomial form in which SPK type 2 ephemerides store positions. Velocity is obtained by differentiating the polynomial, and evaluation needs no interpolation tables. coefficients represent the residual after removing the synodic period . That residual is mostly the light-time variation 2. The date of the next event is with and . Iterating once more makes the date converge to about a second 2. Against the full computation the maximum error was 51 s, for Ganymede in 1985 2. The 1984 coefficients were computed from G-5 2.
Almanacs and magazines. Westfall lists The Astronomical Almanac, the Handbook of the British Astronomical Association (BAA), the Handbook of the Royal Astronomical Society of Canada (RASC) and the Sky & Telescope website as sources of predictions 4. Sky & Telescope's tables are reported to be computed by the Bureau des Longitudes. That is reported secondhand and unconfirmed 18. The Astronomical Almanac's theory and accuracy statement for its satellite phenomena are not established in the sources cited here.
Open software. Stellarium's AstroCalc tool has a "Shadows" mode. It finds the minimum of the heliocentric angle between a moon and its planet and labels the instant "Shadow transit", or "Eclipse" when the moon is the farther body 19. Its conjunction mode labels a geocentric close approach "Transit" or "Occultation" from the two discs' sizes 19. Both report one central instant, not the start and end. PyMeeus returns, for one instant, a signed distance from Jupiter's centre in the Y-stretched metric 12. A caller must search that function for its crossings of ±1 to get contact times.
SPICE. NAIF's gfoclt_c finds occultation intervals between two bodies modelled as ellipsoids, of type FULL, ANNULAR, PARTIAL or ANY 20. Placed at a satellite with the Sun as the back body and Jupiter as the front body, it returns the satellite centre's passage through the penumbra (PARTIAL) and the umbra (FULL). That set-up follows from the routine's definition. The routine does not model the atmosphere, and it does not return the half-flux instant. An occultation of the satellite is the same call from the Earth with the satellite as a point target and type ANY 20.
Accuracy of the predictions
| Product | Error stated | Source |
|---|---|---|
| Thuillot's Chebyshev form against his full computation | 51 s maximum (1984 to 1987) | 2 |
| Horizons satellite eclipse circumstances | "may not be accurate to less than a minute" | 7 |
| Juptool event times | "3-4 minutes off" accurate tables | 15 |
| Visual timing against mid-event | 1 to 2 min (Io, Europa), 4 to 8 min (Ganymede), up to 15 min (Callisto) | 4 |
| Seventeenth-century timings | Cassini claimed 15 s; observers differed by half a minute | 8 |
The theory error is now small against these. A satellite moving at about 10 km/s covers 10 km in one second of time, so "an error of one second of time corresponds ... to 10km" 1. A JUP365 position good to tens of km therefore times an eclipse to a few seconds 21. The remaining error of a geometric prediction comes from the atmosphere and from the definition of the instant, not from the orbit. IMCCE's archive holds 16,802 eclipse observations from 1652 to 1983 from 426 observatories, each with its O − CO − C residualObserved minus computed: the difference between an observed position or time and the value predicted by an ephemeris or theory. Its root mean square over a campaign measures how well the theory fits the data., its a priori uncertainty and its semi-duration TQ. These are the data that test such definitions 14.
Longitude and the speed of light
Galileo proposed the satellites as a clock soon after he discovered them. Cassini wrote in 1692 that astronomers observed Jupiter "in order to obtain an exact knowledge of longitudes". He meant a rapid phenomenon seen at the same instant from distant places 8. With clocks synchronised by an eclipse, the difference in the local times of a star's meridian transit gave the difference in longitude. That corrected "a large quantity of errors" in the maps 8. Cassini claimed 15 s accuracy for an immersion or emersion. A study by Débarbat found that observers could differ by half a minute, even for Io 8.
The same timings showed an anomaly. On 22 August 1676 Cassini announced a new inequality, "the same for all the satellites", that could reach a quarter of an hour. He predicted that Io's emersion of 16 November would be about 10 minutes late. He also wrote that light seemed to take "ten or eleven minutes [to cross] a distance equal to the half-diameter of the annual orbit" 8. An emersion observed on 9 November 1676 was 10 minutes late. Rømer read his account to the Academy on 21 November, and the Journal des Sçavans published it on 7 December 1676 8. Bobis and Lequeux argue from a Paris Observatory manuscript that Cassini first proposed the "successive motion" of light and later abandoned it 8. The light-time term in every modern prediction is the effect that these two astronomers measured.
Sources compared
| Source | What it gives that the others do not |
|---|---|
| Thuillot (1983) 2 | The cone equations with an oblate Jupiter, the phase correction, the light-time rules, the Chebyshev form and its error |
| IMCCE phenjupiter README and files 3 13 | Event codes, TT, the mid-event convention, the precision of the published times, the theory used |
| NSDC guide and eclipse README 1 14 | Viewpoint definitions, half-flux convention, the 1652 to 1983 eclipse archive |
| Westfall (ALPO) 4 | Penumbral widths, durations, the visual-timing offsets |
| Shorthill et al. (1974) 6 | The atmosphere's effect on the eclipse light curve |
| Horizons manual 7 | What the most used online service models and omits |
| Stellarium, PyMeeus, Juptool code and manuals 19 12 15 | What hobby software reports and with which convention |
| Bobis and Lequeux (2008) 8 | The documented history of the longitude method and of the 1676 discovery |
What a developer should do
- Compute two sets of satellite coordinates. Use the Earth-view coordinates, with light-time to the Earth, for occultations and transits. Use the Sun-view coordinates, with light-time from the Sun, for eclipses and shadow transits. Then add the satellite-to-Earth or Jupiter-to-Earth light-time to the eclipse or shadow instant, as Thuillot does 2.
- Model Jupiter as the IAU spheroid, 71,492 by 66,854 km, and project it with for the disc and for the shadow 5 2.
- Publish the mid-event in TT and say so. Use the point-Sun cone for eclipse half-flux and the bisection of the satellite for the other events, to match IMCCE 3. If a product shows first and last contact as well, compute them from , and the satellite radius, and label them separately.
- Apply the phase correction for shadow-transit and transit contacts on the terminator side, or accept errors of up to 6 minutes near quadrature 2.
- Validate against the IMCCE files for the same year, and record which theory those files used 3. Expect agreement within a minute for eclipses if the ephemeris is modern and the conventions match. Check the sign of X before comparing positions. The
xyEfiles give "X towards the East and Y towards the North" 3. Meeus's X is positive to the west. That follows from his low-accuracy formulas: gives , the near side of the orbit, so grows along the satellite's prograde motion across the disc, which is westward 9. - Do not use Horizons visibility codes as event times. They are per-step flags with equatorial radii and no flattening 7.
Read first: Thuillot (1983), the IMCCE phenjupiter README, Westfall's ALPO instructions.
What this changes
The pipeline's shadow-cone and contact machinery carries over from solar eclipses with three changes. The body casting the shadow is an oblate spheroid whose projection depends on the jovicentric declination. Two light-time paths must be kept separately, one for the shadow and one for the disc. And the published instant is a mid-event, not a first contact. The contact solver in the local circumstances topic needs a mode that reports bisection or half-flux instants.
Open questions
- The Astronomical Almanac's satellite phenomena section. Obtain the explanatory text that states the theory, the conventions and the accuracy of its tables.
- Half-flux altitude. Find a paper that fits CCD eclipse light curves with a Jovian atmosphere model and states the radius of the half-flux level. Candidates are the 1970s eclipse studies that Shorthill et al. cite and the eclipse-astrometry papers cited by Tsumura et al.
- Meeus's flattening factor. Check whether 1.071374 in PyMeeus is printed in Meeus chapter 44 or is a transcription error for 1.069374.
- Sky & Telescope's tables. Confirm from the magazine which institution and theory compute the current "Jupiter's Moons" tables and app.
- Explanatory Supplement (2013), satellites chapter. Obtain its treatment of satellite phenomena for the almanac's adopted conventions.
References
- 1primary IMCCE Natural Satellites Data Center, Guide for the phenomena of the natural planetary satellites Read in full. Definitions, half-flux timing convention, the 10 km per second of time rule, time-scale advice.
- 2peer-reviewed Thuillot, W. (1983). Theorie des phenomenes des satellites galileens de Jupiter: une representation par les polynomes de Tchebychev. Astronomy and Astrophysics 127, 63-67 Pages 1 to 3 read from the ADS scan (in French). Source of the cone equations with an ellipsoidal Jupiter, the phase correction of 3 min (Io) and 6 min (Callisto), the light-time rules, the Chebyshev form and its 51 s maximum error.
- 3primary IMCCE, /pub/ephem/satel/phenjupiter/README (2021 September) Read in full. Event codes, TT time scale, mid-event convention, the theory used for each range of years (G-5 to 2014, L1 2015 to 2022, Lainey 2021 after), and the TT-UT table.
- 4trade Westfall, J. E. (2006). Timing the eclipses of Jupiter's Galilean satellites. ALPO observing instructions Read pages 1 and 2. Table of penumbral widths, ingress and egress durations and eclipse durations; the 1 to 2 minute offset of visual timings from mid-event predictions; comparison standard E-2.
- 5primary NAIF, generic_kernels/pck/pck00011.tpc (IAU rotation and shape constants) Read for BODY699, 606, 608, 799, 801, 901 and 999. Saturn radii 60268, 60268, 54364 km. Saturn pole RA 40.589 - 0.036T, Dec 83.537 - 0.004T degrees. Titan 2575.15 km, Iapetus 745.7 by 712.1 km, Triton 1352.6 km, Charon 606 km (current value, replacing the 605 km of the 2009 IAU report), Pluto 1188.3 km. Also, for Jupiter: Read the radii. BODY599_RADII = 71492, 71492, 66854 km; Galilean satellite radii; Sun 695700 km.
- 6peer-reviewed Shorthill, R. W., Greene, T. F. and Smith, D. W. (1974). Atmospheric properties of Jupiter determined from Galilean satellite eclipse light curves. IAU Symposium proceedings, Cambridge University Press Read in full. Twelve eclipse light curves in 30 colours with the Hale telescope, refractive tails, cloud-top cut-off near 9 magnitudes of darkening.
- 7primary JPL Horizons System Manual Read live. Observer table quantities, DE440/DE441, satellite eclipse circumstances; no solar eclipse product.
- 8peer-reviewed Bobis, L. and Lequeux, J. (2008). Cassini, Romer and the velocity of light. Journal of Astronomical History and Heritage 11, 97-105 Read pages 97 to 99. Longitude use of Jovian eclipses, Cassini's 1668 ephemerides, the 15 s and half-minute timing accuracies, the 22 August 1676 announcement and the 7 December 1676 publication.
- 9company Keys, S. (2013). meeus/v3/jupitermoons/jupitermoons.go, Go implementation of Astronomical Algorithms chapter 44 (MIT licence) Read in full. Third-party reimplementation. Source of the quoted low-accuracy method (Positions) and of the E5 method with differential light-time constants 17295, 21819, 27558, 36548 and perspective divisor 2095. The package documents its validation by tests that reproduce Meeus's worked examples.
- 10primary NAIF, generic_kernels/spk/satellites/jup365.cmt (BVS/NAIF, 2021-03-14) Read the header. JUP365.26 global fit, DE440 planets, 1600 to 2200, RADIUS 71492 km, Chebyshev interpolation error 16 m, GM values. The .bsp is 1,136,581,632 bytes.
- 11primary NAIF, generic_kernels/spk/satellites/a_old_versions/jup310.cmt (R. A. Jacobson, released 2013-11-25) Read in full. JUP310.2 fit to Earth-based and spacecraft data through 2013, DE430, 1799 to 2200, RADIUS 71492 km, Chebyshev error 0.5 m.
- 12unsourced Lutz, M., Scholz, S., Serra, V. and Veigl, S. (2020). PyMeeus, pymeeus/JupiterMoons.py (LGPL-3.0) Read in full. Third-party reimplementation of the chapter 44 high-accuracy method. Source of the solar (R = 0) variant for eclipses and of the Y scale factor 1.071374 used in its eclipse and occultation tests.
- 13primary IMCCE, phenE.2026, ftp_jupiter_Events_UT_2026.txt and xyE.2026 (2025-03-31) Read the headers and first months. Eclipse times to 0.1 min, other events to 1 min in the TT file. UT version rounded to the minute with TT-UT = 69 s. Monthly X, Y of eclipse positions.
- 14primary IMCCE Natural Satellites Data Center, README_EC_NSDB for Galilean eclipse observations 1652 to 1983 Read in full. 16,802 eclipse observations from 426 sites, O-C and TQ conventions.
- 15company Nagoya City Science Museum, Jupiter Tool (Juptool) manual Read. The program's own statement of method (Meeus chapter 44 high-accuracy method with truncations), centre-contact convention and 3 to 4 minute error.
- 16peer-reviewed Tsumura, K. et al. (2014). Near-infrared brightness of the Galilean satellites eclipsed in Jovian shadow. ApJ 789, 122 (arXiv:1405.5280) Read in the arXiv version. Abstract and introduction read. Eclipsed satellites at 1e-6 to 1e-7 of their normal brightness near 1.5 micrometres.
- 17primary IMCCE, /pub/ephem/satel/phenjupCDT/README (1999-02-22) Read in full. Chebyshev polynomials for the phenomena as published in the Connaissance des Temps.
- 18trade Sky & Telescope (2008). Erratum: Jupiter's moons for May 2008 Not read: the page refused automated access. Reported secondhand that the magazine's tables are computed by the Bureau des Longitudes. Unconfirmed.
- 19company Stellarium src/gui/AstroCalcDialog.cpp Read from the same clone. Eclipse tables, local circumstances export, ΔT warning text. Also, for Jupiter: Read the phenomena code. Shadow mode minimises the heliocentric angle between moon and planet and labels the result Shadow transit or Eclipse; conjunctions are labelled Transit or Occultation from disc sizes.
- 20primary NAIF CSPICE gfoclt_c documentation Official documentation read 2026-09-30. Detailed Input accepts ELLIPSOID+ELLIPSOID, ELLIPSOID+POINT, DSK+POINT. POINT requires ANY; exceptions 9 and 14 reject the proposed DSK+finite-Sun FULL search. Cached HTML SHA256 7aef5446d1b4a396bbed8eaba1201da94a2aa118fcaa757a063b7080abf33d3a.
- 21peer-reviewed Catani, L. M., Assafin, M., Morgado, B. E. et al. (2023). The 2021 mutual phenomena involving the Galilean satellites of Jupiter and the inner satellite Thebe. MNRAS, doi:10.1093/mnras/stad3006 (arXiv:2310.00807) Read in the arXiv version. Read sections 1 and 4 to 8. DE440 plus JUP365, Oren-Nayar reflectance, solar limb darkening of Hestroffer and Magnan, chi-square fit of about 900 simulated curves per event, 5 mas (15 km) average uncertainty.