Computing Eclipses, Occultations and Transits

Shadow geometry and enlargement

workingupdated 2026-10-17lunar-eclipseumbrapenumbrashadow-enlargementdanjonchauvenetherald-sinnott
  • The Earth's shadow at the Moon is computed from three angles. The umbral radius is the Moon's horizontal parallax minus the Sun's semidiameter plus the Sun's parallax, and the penumbral radius is the sum of all three. Every almanac then enlarges the result, because the observed umbra is larger than the airless geometry predicts 1 2.
  • Three enlargement rules are in use. Chauvenet multiplies both radii by 1.02. Danjon adds a fixed layer of about 1/85 of the Earth's radius through the factor 1.01 on the lunar parallax. Herald and Sinnott add a layer 0.0136 Earth radii, or 87 km, above an oblate Earth whose apparent radius depends on the contact point 3 4 5.
  • Who uses which. The Astronomical Almanac and Stellarium's default use Chauvenet. The Connaissance des Temps, Meeus, the NASA Five Millennium Canon of Lunar Eclipses (NASA/TP-2009-214172) and Skyfield use Danjon. EclipseWise pages updated in 2022 use Herald and Sinnott. Astronomy Engine uses a sphere of 6371 km plus 88 km 2 6 7 8 9.
  • Danjon gives umbral magnitudes about 0.005 smaller and penumbral magnitudes about 0.026 smaller than Chauvenet. That moves umbral contacts by roughly 20 to 30 seconds and penumbral contacts by about 1.5 minutes. It also changes the type of an eclipse near a boundary, for example 1988 March 3 10 4.
  • Crater timings favour a constant layer height over a constant percentage. From 22,539 timings at 94 eclipses between 1842 and 2011, the percentage enlargement depends on the lunar distance and the layer height does not. The mean height is 86.9 ± 0.2 km, and single eclipses range from 82.2 to 90.7 km 5.
  • The umbra's flattening is the Earth's, projected. Herald and Sinnott find no latitude trend in the layer height, which rejects the older claims of an extra-flattened umbra such as Soulsby's 1/102 5 10.

The question. How are the angular radii of the Earth's umbra and penumbra at the Moon's distance computed, which atmospheric enlargement does each almanac and program apply, and how large are the resulting differences in magnitude, contact times and eclipse type?

The airless geometry

A lunar eclipse is the Moon entering the Earth's umbraEarth's umbraThe cone behind the Earth, bounded by the exterior common tangents of the Sun and Earth, inside which the Earth hides the whole Sun. At the Moon's distance its radius is about 41 to 42 arcminutes, about 1.3 lunar diameters, so the umbra is about 2.7 Moon diameters across. or penumbraEarth's penumbraThe region around the Earth's umbra, bounded by the interior common tangents of the Sun and Earth, inside which the Earth hides part of the Sun. At the Moon's distance its radius is about 74 arcminutes.. The geometry is the solar-eclipse geometry with the Earth as the shadow-casting body. The 1992 Explanatory Supplement derives the penumbral radius RpR_p, as seen from the Earth's centre, from three known angles. They are the Moon's horizontal parallaxhorizontal parallaxThe angle subtended by the Earth's equatorial radius at a body's distance. The Moon's horizontal parallax πm_m gives its distance in Earth radii as 1/sinπm1/_m. The Sun's at 1 au is 8.794 arcseconds. πm\pi_m, the Sun's apparent semidiameter s⊙s_\odot and the Sun's horizontal parallax π⊙\pi_\odot 1:

Rp=πm+π⊙+s⊙(8.231-1)R_p = \pi_m + \pi_\odot + s_\odot \qquad (8.231\text{-}1)

The umbra is bounded by the exterior tangents of the Sun and Earth, with its vertex beyond the Moon. Its radius at the Moon's distance is 1

Ru=πm+π⊙−s⊙.R_u = \pi_m + \pi_\odot - s_\odot .

The Supplement writes these radii as f1f_1 and f2f_2. In this corpus f1f_1 and f2f_2 are the vertex half-angles of the Moon's shadow cones, so this topic uses NASA's RpR_p and RuR_u instead 4. All three inputs are geocentric angles, usually in arcseconds. The Moon's own semidiameter sms_m enters only when the radii are turned into contact conditions, as described in Enumeration, elements and contacts.

For a mean lunar parallax of 3422.6 arcseconds and the Sun at 1 au, with s⊙=959.63s_\odot = 959.63 arcseconds and π⊙=8.794\pi_\odot = 8.794 arcseconds, the airless umbra on the 45-degree radius is about 2466 arcseconds, or 41.1 arcminutes. The Moon's diameter at this distance is about 1865 arcseconds, so the airless umbral diameter is about 2.6 times the Moon's diameter. The enlarged umbra of the table below is about 2.7 times. These figures are computed here from the formulas above. The Canon quotes "~2.7x" for the umbral diameter 2.

The oblate Earth in the classical rules

The Earth is not a sphere, so its shadow is not a circular cone. The classical rules replace the Earth by a sphere of the radius at latitude 45 degrees. The 1992 Supplement does this by "substituting for πm\pi_m a parallax reduced to latitude 45°, so that π1=0.998340πm\pi_1 = 0.998340\,\pi_m" 1. The 1961 Supplement printed the factor as 0.998333 and noted the change to 0.998340 "for 1968 onwards" 11. NASA explains the factor as "0.998340 ≅ 1 - 0.5 * 1/300", half of a flattening of about 1/300 4. The Connaissance des Temps uses 1/594, which is half of its flattening of 1/297 2.

The true cross-section is an ellipse whose flattening changes during the year. Herald and Sinnott state that the flattening of the base of the umbral cone "varies between about 1/298 for eclipses near an equinox, to about 1/355 for eclipses near a solstice" 5. The cause is the tilt of the polar axis towards the Sun, which changes the apparent polar radius 5. At the Moon's distance the flattening grows for geometric reasons, and Ahnert and Meeus give 1/214 as the mean 5 10. Meeus adds that Soulsby found "a mean oblateness of 1/102 from observations made at 18 lunar eclipses in the period 1974 - 1989" 10 12.

The enlargement problem

The observed umbra is larger than the geometry predicts, and the correction for it is called shadow enlargementshadow enlargementThe empirical increase of the Earth's computed shadow radii needed to match observed lunar eclipses, caused by the atmosphere. It is applied as Chauvenet's 2 per cent, Danjon's 1/85 of the Earth's radius, or Herald and Sinnott's 87 km layer.. Philippe de La Hire found in the early 1700s that the predicted radius "needed to be enlarged by about 1/41" to fit timings 2. Herald and Sinnott trace the practice to de La Hire's tables of 1687, which added 90 arcseconds to the umbral radius "because of the shadow of the atmosphere", revised to 60 arcseconds from the 1702 edition 5. Enlargements of 1/40 to 1/65 appear in the eighteenth and nineteenth century literature 5.

The physical cause is the atmosphere, but the edge is a perception. NASA states that "there is no abrupt boundary between the umbra and penumbra" and that, by Kuhl's 1928 contrast theory, "the edge of the umbra is perceived at the point of inflexion in the shadow density" 4. The Canon equates that inflexion with "a layer in Earth's atmosphere at an altitude of about 120 to 150 km" 2. Herald and Sinnott avoid any physical claim: their layer is "merely a single quantity, derived from timings and free of the effect of the known oblateness of the solid Earth, that represents the effects of the Earth's atmosphere" 5.

Chauvenet's rule: 2 per cent of both radii

Chauvenet's 1863 Manual multiplies the umbral radius by 51/50. His equation (587) reads App. semid. of shadow=5150(π−s′+π′)\text{App. semid. of shadow} = \tfrac{51}{50}(\pi - s' + \pi'), with π\pi the lunar and π′\pi' the solar parallax and s′s' the solar semidiameter 3. His footnote cites Lambert's 1/40, Mayer's 1/60, and 1/50 from Beer and Mädler's timings of "eclipses of lunar spots" on 1833 December 26 3. The modern almanac form adds the 45-degree factor 1 4:

Rp=1.02(0.998340πm+s⊙+π⊙),Ru=1.02(0.998340πm−s⊙+π⊙).R_p = 1.02\,(0.998340\,\pi_m + s_\odot + \pi_\odot), \qquad R_u = 1.02\,(0.998340\,\pi_m - s_\odot + \pi_\odot).

Herald and Sinnott confirm that this expression "with E set to 1.02, is still used today in the Astronomical Almanac for predicting the primary contacts of lunar eclipses", citing page A83 of the 2014 volume 5. No source cited here states the Almanac's rule for any later year.

Danjon's rule: a fixed layer on the Earth's radius

Danjon argued in 1951 that a relative enlargement of both radii is wrong. The NASA page summarises his argument: "the only reasonable way of accounting for a layer of opaque air surrounding Earth is to increase the planet's radius by the altitude of the layer", so that both shadows receive "the same absolute correction and not the same relative correction" 4 13. Danjon put the layer at 75 km, "an enlargement of Earth's radius and the Moon's parallax of about 1/85" 4. The rounded factor 1.01 adds 1.01−0.998340=0.011661.01 - 0.998340 = 0.01166 Earth radii to the 45-degree radius, which is 74 km. This topic quotes 75 km for Danjon's stated layer and 74 km for the layer that the factor 1.01 implies. The 74 km value is computed here. The Connaissance des Temps adopted the rule in 1951 2:

Rp=1.01πm+s⊙+π⊙,Ru=1.01πm−s⊙+π⊙,1.01≅1+185−1594.R_p = 1.01\,\pi_m + s_\odot + \pi_\odot, \qquad R_u = 1.01\,\pi_m - s_\odot + \pi_\odot, \qquad 1.01 \cong 1 + \tfrac{1}{85} - \tfrac{1}{594}.

Herald and Sinnott write the same rule as ru=(0.998340+h)πMoon−sSun+πSunr_u = (0.998340 + h)\,\pi_\mathrm{Moon} - s_\mathrm{Sun} + \pi_\mathrm{Sun} with h=0.0118h = 0.0118 Earth radii 5.

Danjon's own paper derives the factor slightly differently. It writes the umbral and penumbral semidiameters as ρ=p+p′−s\rho = p + p' - s and σ=p+p′+s\sigma = p + p' + s, with pp and p′p' the parallaxes of the Sun and Moon and ss the Sun's semidiameter 13. The penumbral condition is d<σ+s′d < \sigma + s', with s′s' the Moon's semidiameter 13. In this notation ρ\rho and σ\sigma are Danjon's, not Meeus's radii in Earth radii. Danjon first argues that the empirical correction should be the same absolute amount for both shadows, equal to 1/50 of the umbral semidiameter, "en moyenne 50″" 13. He then states the Connaissance des Temps value: an effective atmosphere of 75 km, "soit 1 : 85 du rayon équatorial de la Terre", applied to the lunar parallax, less 1/586 "pour la ramener au rayon moyen de l'ombre", so that "la correction totale est ainsi très voisine de 1 : 100" 13. On average this enlarges ρ\rho by 1/73 and σ\sigma by only 1/123 13. NASA's 1/594 for the oblateness term is therefore a later value. Danjon printed 1/586.

Danjon's worked case is the eclipse of 1951 February 21, at 21h 29m UT. He takes d=5380.5″d = 5380.5'', p=8.8″p = 8.8'', p′=3405.7″p' = 3405.7'', s=971.7″s = 971.7'' and s′=927.3″s' = 927.3'', so that σ=4386.2″\sigma = 4386.2'' 13. The 1/50 rule adds 87.7 arcseconds and gives a penumbral eclipse of magnitude 0.011, as the Handbook of the British Astronomical Association (BAA) predicted. The Connaissance des Temps correction of 34.1 arcseconds leaves the lunar limb 32.9 arcseconds outside the penumbra, so no eclipse occurs 13. NASA's list of penumbral eclipses that exist only under Chauvenet's rule includes this date 4. This account covers pages 51 and 52 of the paper. Page 53 is not reproduced here.

The note of the Institut de mécanique céleste et de calcul des éphémérides (IMCCE) for the penumbral eclipse of 2023 May 5 shows the rule in current French practice. The note gives the Moon's equatorial parallax as 57 arcminutes 40.11 arcseconds and the Sun's as 8.72 arcseconds. It gives the umbral cone diameter as 85.07 arcminutes and the penumbral cone diameter as 148.51 arcminutes 14. With the Sun's semidiameter taken as 959.63 arcseconds divided by the Earth–Sun distance of 1.0086 au, Danjon's formulas give 85.06 and 148.50 arcminutes. Chauvenet's give 85.39 and 150.10 arcminutes. This reduction is computed here and is not stated in the IMCCE note.

Herald and Sinnott: a layer above an oblate Earth

Herald and Sinnott reduce each timing to the height of a "notional eclipse-forming layer", the NELnotional eclipse-forming layer (NEL)Herald and Sinnott's name for the height above the oblate Earth at which a straight solar ray must graze to reach the observed umbral edge. It is a fitted quantity, about 87 km on average, not a physical opaque layer., above the oblate Earth 5. Their geometry uses the fundamental plane through the Earth's centre perpendicular to the umbral axis. With RR the Earth's effective radius in equatorial radii at the tangent point, the half-angle at the vertex of the shadow cone is f=sSun−RπSunf = s_\mathrm{Sun} - R\,\pi_\mathrm{Sun}. The umbral radius on the fundamental plane is R/cosfR/\cos f, and through a crater at distance ZcZ_c beyond the plane it is 5

ru=Rcosf−Zctanf.[3]r_u = \frac{R}{\cos f} - Z_c \tan f . \qquad [3]

This ff is the Earth's umbral vertex angle, the analogue of the corpus's f2f_2 for the Moon's shadow. The rur_u of equation [3] is a linear radius in equatorial Earth radii, measured on the plane through the crater. Herald and Sinnott use it only to reduce crater and contact timings. Equation [2] and the recommended rule below give instead an angular rur_u in the units of the parallaxes. That angular radius is the RuR_u that enters L2L_2 and L3L_3. ZcZ_c comes from the Moon's distance ZmZ_m in the Besselian elements and from projecting the crater with the heliocentric libration 5. The Earth's apparent radius seen from the Sun at an angle θ\theta around the umbra is 5

R=1+h−0.003353sin2θcos2(δSun+fsinθ),[4]R = 1 + h - 0.003353\,\sin^2\theta\,\cos^2(\delta_\mathrm{Sun} + f\sin\theta), \qquad [4]

where 0.003353 is the Earth's flattening, 1/298.256, and δSun\delta_\mathrm{Sun} is the Sun's declination. The angle θ\theta is measured "northward (+) or southward (-) from the east-west direction on the sky", by analogy with latitude 5. This topic writes the angle θ\theta.

Their recommendation for predicting primary contacts is 5

ru=RπMoon−sSun+πSun,h=0.0136,r_u = R\,\pi_\mathrm{Moon} - s_\mathrm{Sun} + \pi_\mathrm{Sun}, \qquad h = 0.0136,

with RR from equation [4], θ\theta the position angle of the contact point about the umbra, and f=sSun−RπSunf = s_\mathrm{Sun} - R\,\pi_\mathrm{Sun}. "The calculation requires only a single iteration to generate mutually consistent values of R and θ" 5. RR and θ\theta depend on where the Moon meets the umbra, so the iteration is made separately for each umbral contact: U1, U2, U3 and U4 each have their own θ\theta, RR and ff. This reading of the rule is made here from the definition of θ\theta. The value h=0.0136h = 0.0136 corresponds to 87 km. The paper gives no penumbral counterpart, because the penumbral contacts are not observed. How EclipseWise forms its penumbral radius under this rule is not stated in the EclipseWise pages cited here.

The paper's reasons for the recommendation are explicit. "The traditional predictions using either the Chauvenet or Danjon approach include the simplification of a spherical Earth having a radius equal to that at 45° latitude. But this simplification can lead to errors of the order of 1 minute of time" 5. And the Chauvenet rule "leads to an error that is dependent upon the lunar distance. The Danjon method is clearly preferable in this respect" 5.

Atmospheric layer height implied by three umbra-enlargement rulesA line chart. The horizontal axis is the Moon's distance from 56 to 64 equatorial Earth radii. The vertical axis is the height in kilometres of the atmospheric layer that each rule effectively adds to the Earth. Chauvenet's 2 per cent rule is a solid line falling from about 94 km at 56 Earth radii to about 90 km at 64 Earth radii. Danjon's factor 1.01 is a dashed horizontal line near 74 km. Herald and Sinnott's 0.0136 Earth radii, evaluated at a contact angle of 45 degrees, is a dotted horizontal line near 86.6 km. A shaded band from 82.2 to 90.7 km shows the spread of single-eclipse mean heights that Herald and Sinnott report.single-eclipse means, 82.2 to 90.7 km (Herald and Sinnott)5658606264lunar distance, equatorial Earth radii708090100implied layer height, kmChauvenet, 1.02solid; varies with distanceHerald and Sinnott, h = 0.0136dotted; 86.6 km at θ = 45°Danjon, 1.01dashed; 74 kmComputed from the quoted formulas with the Sun at 1 au; heights are above the 45-degree radius 0.998340.

The measured layer

Herald and Sinnott's dataset holds 22,539 observations, or 26,685 individual timings, at 94 lunar eclipses from 1842 to 2011 5. They base their statistics on 20,678 records of craters and small spots, excluding limb contacts and extended features 5. The results are 5:

  • percentage enlargement: mode 1.7 per cent, median 1.8 per cent, mean 1.88 per cent;
  • NEL height: mode 78 km, median 85 km, mean 86.9 ± 0.2 km;
  • "As expected, the percentage enlargement depends somewhat on the lunar distance, but the NEL value does not."

The paper finds no cycle with the 11-year solar cycle or with the season, and no long-term trend once a few poorly observed eclipses of 1943 to 1974 are set aside 5. It does find real eclipse-to-eclipse variation: 1,164 timings of 1982 July 6 give 90.7 ± 1.2 km and 1,119 timings of 1989 August 17 give 82.2 ± 1.0 km 5. Ingresses give a layer 3.5 km higher than egresses on average, which the authors judge "insufficient to support a predictable, systematic difference" between the sunset and sunrise terminators 5.

On the shape, the NEL heights binned in 10-degree steps of θ\theta show no trend. "The absence of any such trend demonstrates that the shape of the umbral shadow is fully attributable to the oblateness of the Earth" 5. This rejects the extra flattening reported by Kosik, Bouška, Link, Ashbrook and Soulsby 5.

Earlier determinations agree with the 1.7 to 2.2 per cent range. The Canon tabulates Sky & Telescope crater-timing enlargements of 1.69 and 1.68 per cent for 1972 January 30, 1.79 and 1.61 for 1975 May 24, 2.02 and 2.24 for 1982 July 5 (date as printed), and 1.74 and 1.74 for 1982 December 30, for entrances and exits respectively 2. It cites Link's 1969 mean of 2.3 per cent from 57 eclipses over 150 years 2 15.

Effect on magnitude, contacts and type

At a mean lunar parallax of 3422.6 arcseconds and the Sun at 1 au, the rules give these angular radii. The values are computed here from the formulas quoted above.

Rule RuR_u, arcseconds RpR_p, arcseconds Umbral radius minus Danjon, arcseconds
Airless, 45° radius 2466.1 not computed −39.9
Danjon, factor 1.01 2506.0 4425.3 0
Chauvenet, factor 1.02 2515.4 4473.0 +9.4
Herald and Sinnott, θ=0∘\theta = 0^{\circ} 2518.3 not given +12.3
Herald and Sinnott, θ=45∘\theta = 45^{\circ} 2512.6 not given +6.6
Herald and Sinnott, θ=90∘\theta = 90^{\circ} 2506.8 not given +0.8

The Herald and Sinnott rows assume the Sun on the equator. Dividing by the Moon's diameter, about 1865 arcseconds at this distance, turns a radius difference into a magnitude difference. Chauvenet minus Danjon is then +0.0050 in umbral magnitude and +0.0256 in penumbral magnitude. NASA states "approximately 0.006 and 0.026" 4. Meeus states "about 0.005 for umbral eclipses, by about 0.026 for penumbral eclipses" 10. NASA's example is the partial eclipse of 2008 August 16, umbral magnitude 0.813 in the Astronomical Almanac and 0.806 in Meeus and Mucke 4 16.

Meeus gives the two rules as alternative constants in Earth radii at the Moon's distance. For the Danjon rule the penumbral radius is ρ=1.2848+u\rho = 1.2848 + u and the umbral radius is σ=0.7403−u\sigma = 0.7403 - u. For the traditional rule Meeus says to "replace 1.2848 by 1.2985, 0.7403 by 0.7432, 1.5573 by 1.5710, 1.0128 by 1.0157, 0.4678 by 0.4707" 10. The semiduration of a phase is 60nL2−γ2\tfrac{60}{n}\sqrt{L^2 - \gamma^2} minutes, with LL one of 1.5573 + u, 1.0128 − u or 0.4678 − u and n=0.5458+0.0400cosM′n = 0.5458 + 0.0400\cos M' 10. Differentiating gives the shift of a contact for a change ΔL\Delta L in the limiting distance:

Δt=LΔLnL2−γ2hours.\Delta t = \frac{L\,\Delta L}{n\sqrt{L^2-\gamma^2}} \ \text{hours}.

This derivative is derived here from Meeus's formula. For γ=0.35\gamma = 0.35, u=0u = 0 and n=0.5458n = 0.5458, the Chauvenet minus Danjon shift is about 20 seconds at U1 and U4, about 29 seconds at U2 and U3, and about 93 seconds at P1 and P4. A rule change therefore lengthens or shortens totality by about one minute. A reimplementation of Meeus's method, computed here over the 228 catalogued eclipses of 1951 to 2050, agrees. Switching from the Danjon to the traditional constants raised the mean total-phase duration difference against the NASA catalogue from −0.75 to +0.32 minutes, consistent with that estimate 10 17. The details of that check are in Observation, brightness and validation.

One kilometre of layer height subtends about 0.54 arcseconds at the mean lunar distance. The Moon moves against the shadow at about 0.52 arcseconds per second of time. A change of 1 km in the layer therefore moves a contact by about 1 second of time, more where the Moon meets the edge obliquely. This rule of thumb is derived here and matches Herald and Sinnott's statement that a 25 to 30 second timing error gives "an uncertainty of about 25 to 30 km in NEL height" 5.

Near a type boundary the rule decides the type. NASA lists five eclipses from 1501 to 3000 that are total under Chauvenet and partial under Danjon, for example 1540 September 16 at 1.0007 against 0.9947 4. It lists partial-to-penumbral cases, for example 1988 March 3 at 0.0028 against −0.0017 and 2042 September 29 at 0.0027 against −0.0031 4. Nine penumbral eclipses of 1801 to 2300 in Liu and Fiala's Chauvenet-based canon do not occur at all under Danjon, among them 2016 August 18 at penumbral magnitude 0.0165 4 18. "It is important to note which shadow enlargement convention is used because it is critical in comparing predictions from different sources" 4.

The Herald and Sinnott rule and the Danjon rule can be compared on three total eclipses that both NASA and EclipseWise list. The NASA catalogue uses Danjon with VSOP87 and ELP-2000/82. The EclipseWise pages use Herald and Sinnott with the Jet Propulsion Laboratory (JPL) ephemeris DE430 2 19 8 20.

Eclipse Umbral magnitude, NASA Umbral magnitude, EclipseWise Totality, NASA Totality, EclipseWise
2022 Nov 08 1.3589 1.36069 85.0 min 85.66 min
2025 Mar 14 1.1784 1.18038 65.4 min 66.07 min
2025 Sep 07 1.3619 1.36379 82.1 min 82.69 min

The EclipseWise values are about 0.002 larger in umbral magnitude and about 0.6 minutes longer in totality 21 19 8 20. The ephemerides also differ between the two sources, so the table bounds the combined effect rather than isolating the enlargement rule. Gamma agrees to 0.0001 in all three cases.

Which implementation uses which rule

Product or program Rule Earth figure Other constants Source
Astronomical Almanac Chauvenet, 1.02 45° radius, 0.998340 not stated in the cited sources 5 1
Connaissance des Temps, IMCCE Danjon, 1.01 since 1951 45° radius, flattening 1/297 IMCCE 2023 shadow diameters match Danjon 2 14
Meeus, Astronomical Algorithms Danjon, with 1/50 constants given circular radii in Earth radii 10
NASA Five Millennium Canon and Catalogue (2009) Danjon, 1.01 45° radius VSOP87, ELP-2000/82, k=0.2724880k = 0.2724880 2
EclipseWise prime pages (2022) Herald and Sinnott oblate, layer 87 km JPL DE430, "Shadow Enlargement: 1.000" 8 22
NASA crater-timing page (2009) Danjon "1/85", with oblateness oblate not stated 23
Skyfield eclipselib Danjon, pi_1 = 1.01 * pi_m equatorial radius ERAD Sun 696,340 km, Moon 1,737.1 km 6
Stellarium Chauvenet by default, Danjon optional 45° radius in the Chauvenet branch Moon and Sun equatorial radii from its data 7
Astronomy Engine sphere 6371 km plus 88 km spherical Moon 1737.4 km 9
Occult 4 not documented in the cited sources not documented not documented 24

Three details matter when comparing these. Skyfield's comment says "Use Danjon's method", and it applies the factor 1.01 to the parallax computed from the equatorial radius without the arcsine, as its comment notes 6. Stellarium reads the setting astro/shadow_enlargement_danjon with a default of false, and its Danjon branch uses 1+1./85.-1./594. 7. The function carries the comment "The application of this shadow enlargement is not according to the books, but looks close enough for now", although the radii it returns follow the printed formulas 7. Astronomy Engine's comment for the 88 km layer cites the NASA shadow page, but 6371 plus 88 km on a sphere is closer to Herald and Sinnott's 87 km than to Danjon's 75 km 9.

Sources compared

Source Rule given Constants What it adds
Chauvenet 1863 3 51/50 on the umbral radius Lambert 1/40, Mayer 1/60, Beer and Mädler 1/50 The origin of the 2 per cent rule
Explanatory Supplement 1961, 1992 11 1 Chauvenet with 0.998333 or 0.998340 RpR_p, RuR_u derivation The almanac formulation and type conditions
NASA shadow page and Canon 4 2 Chauvenet and Danjon 1.01 = 1 + 1/85 − 1/594 Magnitude differences and type-change tables 1501 to 3000
Meeus 1991 10 Danjon, with 1/50 alternatives ρ, σ, semiduration constants Closed forms in Earth radii, umbra flattening 1/214
Herald and Sinnott 2014 5 Layer above oblate Earth h=0.0136h = 0.0136, flattening 0.003353 22,539 timings, NEL statistics, rejection of extra flattening
EclipseWise 8 22 Herald and Sinnott DE430 Current predictions under the new rule
IMCCE 2023 note 14 Danjon by reduction shadow cone diameters Evidence of current French practice
Skyfield, Stellarium, Astronomy Engine code 6 7 9 Danjon, Chauvenet default, sphere plus 88 km as in the table above What open-source users actually get

What a developer should do

Implement the shadow radii as a pluggable rule with three options: Chauvenet, Danjon and Herald and Sinnott. Report the rule with every result, because the rule alone moves umbral magnitudes by 0.005, penumbral magnitudes by 0.026 and penumbral contacts by about 1.5 minutes. Use Herald and Sinnott with h=0.0136h = 0.0136 as the default for new predictions of umbral contacts, and solve for RR and θ\theta at each contact with the single iteration the paper describes. For comparisons with the NASA Five Millennium Canon or with Meeus, switch to Danjon with the factor 1.01. For comparisons with the Astronomical Almanac, use Chauvenet with 0.998340. Read Herald and Sinnott 2014 in full first, then the NASA shadow page. Use VizieR VI/140 to test a crater-timing implementation, as described in Observation, brightness and validation.

What this changes

A lunar-eclipse pipeline needs one input that solar eclipses do not: an atmospheric enlargement model. It plays the role that the lunar radius and the limb profile play for solar contacts. The Besselian stage can stay as it is, because the rule enters only through the radii L1L_1, L2L_2 and L3L_3. The output schema must carry the rule name and the layer height.

Open questions

  • Obtain page 53 of Danjon 1951, L'Astronomie 65, for the rest of his argument 13.
  • Obtain the current Astronomical Almanac section A on lunar eclipses, or the USNO lunar eclipse data service page https://aa.usno.navy.mil/data/LunarEclipses, to establish whether the Almanac still uses Chauvenet's 1.02 after 2014.
  • Obtain EclipseWise's PDF "21CCLE Shadows" from the 21st Century Canon of Lunar Eclipses to learn how the penumbral radius is formed under the Herald and Sinnott rule and what "Shadow Enlargement: 1.000" means 22.
  • Obtain Occult 4's lunar eclipse help topic or code to establish its enlargement rule 24.
  • Obtain the 2013 Explanatory Supplement, section 11.2.3, which Skyfield cites, to see whether the third edition changed the 1992 rule 25.
  • Obtain Soulsby 1990, JBAA 100, 293 to 305, and Link 1969 to compare their flattening and enlargement methods with Herald and Sinnott's NEL reduction 12 15.

References

  1. 1peer-reviewed Explanatory Supplement to the Astronomical Almanac (1992), chapter 8 Eclipses of the Sun and Moon, by Alan D. Fiala and John A. Bangert: sections 8.23 (occurrence of lunar eclipses) and 8.4 (lunar eclipses) Read in full in the OCR text for these sections. Section 8.231: penumbral and umbral radii f1 = pi_m + pi_s + s_s (8.231-1), the 0.998340 reduction to latitude 45 degrees and the 1.02 enlargement (8.231-2, 8.231-3). Sections 8.2321 to 8.2331: conditions for penumbral, partial and total eclipses. Section 8.4: elements x y about the antisolar point, L1 L2 L3 (8.42-1), the 10-minute discriminant tabulation, centre-of-figure and Delta T corrections, Table 8.422.1 of contact order, greatest eclipse, magnitude (8.424), position angles (8.425), sublunar points and the horizon circle (8.426-1, 8.426-2). Same book as glob-es1992, which covers the solar sections.
  2. 2primary Espenak, F. and Meeus, J. (2009). Five Millennium Canon of Lunar Eclipses: -1999 to +3000, NASA/TP-2009-214172, text sections 1 to 5 Read in full (text PDF, 3.2 MB, extracted with pdftotext). Source of the contact definitions, gamma and magnitude definitions, eclipse statistics (12,064 eclipses), VSOP87 D and truncated ELP-2000/82, k = 0.2724880, secular acceleration -25.858 arcsec/cy^2 and the c correction, the enlargement section 1.5 (Chauvenet and Danjon formulas, Tables 1-3 to 1-6), map accuracy and Delta T uncertainty zones, Danjon scale wording, Saros and Inex behaviour. Some tables are misaligned in extraction and were cross-checked against the web pages.
  3. 3primary Chauvenet, W., A Manual of Spherical and Practical Astronomy, Vol. I (1863), chapter on Eclipses, Arts. 288 to 296 Read Arts. 288 to 291 and the cone-angle precepts in OCR text (garbled in places). Original almanac form of Bessel's method: point Z as the Sun seen from the Moon's centre, equations (482) for x y z, principal plane of reference, log k = 9.435000, c = z ± k/sin f, l = c tan f.
  4. 4primary Espenak, F. NASA GSFC Eclipse Web Site, Enlargement of Earth's Shadows (page dated 2009 Feb 02) Read in full. Web version of Canon section 1.5 with correctly aligned Tables 1-3 to 1-6: Chauvenet formula with 0.998340, Danjon formula with 1.01 = 1 + 1/85 - 1/594, magnitude differences 0.006 and 0.026, type-change lists, and which sources use which rule.
  5. 5peer-reviewed Herald, D. and Sinnott, R. W. (2014). Analysis of lunar crater timings, 1842-2011. J. Br. Astron. Assoc. 124(5), 247-253 Read in full from the ADS scan (text extracted; Greek letters in the Symbol font are lost, so equation [4]'s angle is written theta here). Source of equations [1] to [4], the recommended rule with h = 0.0136, the NEL statistics (mean 86.9 +/- 0.2 km, mode 78, median 85), the per-eclipse heights, the ingress-egress and limb-contact biases, the shape result and the 1963 Dec 30 case.
  6. 6company Skyfield skyfield/eclipselib.py Read live (raw). Constants for the lunar routine; no solar routine.
  7. 7company Stellarium source, src/core/modules/SolarSystem.cpp, getEarthShadowRadiiAtLunarDistance, commit 77d52ea34a6b6c78dc544938c3903b6fcf314e93 Read the function and the setting astro/shadow_enlargement_danjon (default false). Chauvenet 1.02 with 0.998340 by default, Danjon 1+1/85-1/594 as an option.
  8. 8company Espenak, F. EclipseWise, Total Lunar Eclipse of 2025 Mar 14 (prime page, last updated 2022 Feb 27) Read via a fetch summary that quoted the page values. Contacts in UT1 to 0.1 s, magnitudes, gamma, Delta T 71.7 s, ephemeris JPL DE430, shadow rule Herald and Sinnott, shadow enlargement 1.000.
  9. 9company Astronomy Engine source/c/astronomy.c Raw source downloaded 2026-09-15 (122 KB) and grepped. CalcShadow, GeoidIntersect, LocalEclipse, Obscuration, EclipseKindFromUmbra.
  10. 10trade Meeus J. (1991) Astronomical Algorithms, first edition, Willmann-Bell, Chapter 52 Eclipses Read from the Internet Archive OCR text (chapter 52 in the 1991 edition, chapter 54 in the 1998 edition). Source of the |sin F| > 0.36 rule, the corrections to the time of maximum, P, Q, W, gamma, u, the thresholds 0.9972, 1.0260, 1.5433, 0.0047, 0.00464, the partial-magnitude formula and the stated accuracy of 0.36 min mean and 1.1 min maximum for 1951 to 2050. Graded trade as a recognised practitioner's own algorithm text.
  11. 11peer-reviewed Explanatory Supplement to the Astronomical Ephemeris and the American Ephemeris and Nautical Almanac (1961), section 9E Lunar eclipses, and Example 4.12 Semi-diameter of the Moon Read in full in the OCR text for these sections. Section 9E (from page 258), with Example 9.23: types of lunar eclipse, shadow radii with 0.998333 (0.998340 for 1968 onwards) and 1.02, limits on the Moon's latitude at opposition, x y about the antisolar point in arcseconds, the contact quadratic with n, Delta and the sign rule, the type tests, greatest eclipse, position angles, and the 1960 March 13 example (Example 9.23). Example 4.12: sin s = 0.2724880 sin pi and s = 0.0799 + 0.272453 pi for 1968 onwards. Same book as bes-es1961, which covers section 9B.
  12. 12peer-reviewed Soulsby, B. W. (1990). Improved lunar eclipse ephemerides. J. Br. Astron. Assoc. 100(6), 293-305 First page read from the ADS scan image; the rest was not read. The abstract reports umbra enlargement and oblateness derived from more than 7,000 observations of 18 eclipses of 1972 to 1989, with revised primary contact predictions compared against the eclipses of 1988 and 1989. The 1/102 flattening is cited through Meeus 1991.
  13. 13trade Danjon, A. (1951). Les eclipses de Lune par la penombre en 1951. L'Astronomie 65, 51-53 Pages 51 and 52 read from the ADS scan images; the scan holds no page 53. Source of the rho, sigma notation, the argument for an equal absolute correction, the Connaissance des Temps rule (75 km = 1/85 of the equatorial radius, less 1/586, total close to 1/100), the average 1/73 and 1/123 enlargements, and the 1951 Feb 21 worked case.
  14. 14primary Rocher, P. IMCCE, L'eclipse de Lune par la penombre du 5 mai 2023 (newsletter note) Read in full. Contacts, magnitude 0.9637796, umbral and penumbral cone diameters 85.07 and 148.51 arcmin, lunar and solar parallax, position-angle convention and map conventions. The enlargement rule is not stated; the Danjon match is a reduction made in this topic.
  15. 15survey Link, F. (1969). Eclipse Phenomena in Astronomy. Springer-Verlag Not read. Cited through the Canon for a mean enlargement of 2.3 per cent from 57 eclipses and through Garcia Munoz et al. for the classical refraction theory.
  16. 16primary Meeus, J. and Mucke, H. (1979). Canon of Lunar Eclipses -2002 to +2526. Astronomisches Buero, Vienna Not read. Described in the Five Millennium Catalog preface (Besselian elements of 10,936 lunar eclipses, Newcomb and Brown theories) and cited by NASA for the 2008 Aug 16 magnitude under Danjon's rule. The URL is the NASA page that cites it; the book is not online.
  17. 17primary Espenak, F. and Meeus, J. NASA GSFC, 5MKLEcatalog.txt, ASCII Five Millennium Catalog of Lunar Eclipses (dated 2011 May 23) Downloaded 2026-10-17 (12,077 lines, 12,064 data rows) and parsed. Used for sample rows and as the reference in the reimplementation check of Meeus's method for 1951 to 2050.
  18. 18trade Liu, B.-L. and Fiala, A. D. (1992). Canon of Lunar Eclipses 1500 B.C. - A.D. 3000. Willmann-Bell Not read. Cited through the NASA shadow page as a Chauvenet-rule source with nine shallow penumbral eclipses that vanish under Danjon. The URL is the NASA page that cites it; the book is not online.
  19. 19company Espenak, F. EclipseWise, Total Lunar Eclipse of 2022 Nov 08 (prime page, last updated 2022 Feb 27) Read via a fetch summary that quoted the page values. Umbral magnitude 1.36069, gamma 0.25703, totality 01h25m39.5s, DE430, Herald and Sinnott.
  20. 20company Espenak, F. EclipseWise, Total Lunar Eclipse of 2025 Sep 07 (prime page, last updated 2022 Feb 27) Read via a fetch summary that quoted the page values. Umbral magnitude 1.36379, gamma -0.27521, totality 01h22m41.4s, DE430, Herald and Sinnott.
  21. 21primary Espenak, F. and Meeus, J. NASA GSFC, Catalog of Lunar Eclipses: 2001 to 2100 Read in full. 21st-century counts (228: 86 N, 57 P, 85 T), extremes (2018 Jul 27 longest, 2015 Apr 04 shortest total) and the rows for 2022 Nov 08, 2025 Mar 14 and 2025 Sep 07.
  22. 22company Espenak, F. EclipseWise, Enlargement of Earth's Shadows and Lunar Eclipses (last updated 2022 Feb 25) Read via a fetch summary (the site blocks direct download). States that the 21st Century Canon of Lunar Eclipses and the EclipseWise predictions for 2001 to 2100 use the Herald and Sinnott method with an 87 km layer; gives no formulas.
  23. 23primary Espenak, F. NASA GSFC, Crater Timings During Lunar Eclipses (page dated 2009 Aug 16) Read via a fetch summary that quoted the page. Timing protocol (0.1 min, steepest gradient across crater centre, both edges of large craters), predicted times for up to 20 craters, and Danjon 1/85 with oblateness for those predictions.
  24. 24company Occult v4 (David Herald) home page Fetched with curl 2026-09-15. Feature list, C#/.NET 4.5, 42 data files, installer sizes. Eclipse-specific help is inside the Windows help file and was not read.
  25. 25peer-reviewed Explanatory Supplement to the Astronomical Almanac, 3rd edition, S. E. Urban and P. K. Seidelmann eds. (University Science Books, 2013) Not read for this note. Cited by the Photo Ephemeris technical note as one basis of its eclipse paths. Its eclipse chapter should be checked for changes to the 1992 formulas.