Monday 2 August 2027

Sources and methods

Where the data come from, how the predictions are computed, how they were checked and what their limits are.

Computation method

  • Local circumstances are computed in the browser and at build time from NASA's polynomial Besselian elements, with the method of the Explanatory Supplement to the Astronomical Almanac (1992) and of J. Meeus (Elements of Solar Eclipses, 1989). The instants of contact are found by root finding with a precision better than 0.01 s; the maximum by Newton iteration.
  • ΔT = TT − UT is set to 69.2 s (measured value about 69.1 s in 2025, expected to remain within about ±1 s in 2027). NASA used 76.0 s. A 1 s error on ΔT shifts the path by about 0.4 km in longitude and changes local times by less than 1 s.
  • Coordinates are geodetic WGS 84 (EPSG:4326). The observer is placed at sea level. The Sun’s altitude is geometric (without refraction, which is below 1′ at these altitudes). Times are given in UTC and in Tunisian time (UTC+1, no daylight saving time).
  • The path of totality, the central line and the isolines on the map are computed from the same elements, meridian by meridian (every 0.02° of longitude over Tunisia), so the map, the calculator and the tables are consistent with one another.
  • Magnitude is the fraction of the Sun’s diameter covered by the Moon at maximum; obscuration is the fraction of the Sun’s area covered. For a partial eclipse the displayed values are truncated, never rounded up, so that a very deep partial eclipse can never appear as 100 %.

Validation 1 — comparison with NASA’s path table

For each line of NASA’s table over Tunisia and its surroundings, the engine (with NASA’s ΔT of 76 s) computes the duration on NASA’s central-line point and the latitude of the limits on NASA’s meridians. Largest differences: 0.16 s on the duration and 0.22 km on the limits (NASA’s coordinates are rounded to 0.1′ ≈ 0.18 km).

UTCentral lineDuration NASADuration engineΔ north limit (km)Δ south limit (km)
09:0035.477° N, 3.818° E322.4 s322.3 s-0.22-0.15
09:0235.360° N, 5.105° E326.5 s326.4 s-0.15-0.08
09:0435.225° N, 6.350° E330.5 s330.4 s-0.10-0.02
09:0635.073° N, 7.555° E334.3 s334.2 s-0.15-0.08
09:0834.905° N, 8.725° E338.0 s337.9 s-0.02-0.14
09:1034.723° N, 9.858° E341.5 s341.4 s-0.07-0.08
09:1234.527° N, 10.960° E344.8 s344.7 s0.07-0.02
09:1434.318° N, 12.032° E348.0 s347.9 s-0.00-0.04
09:1634.097° N, 13.075° E351.1 s351.0 s0.110.06
09:1833.863° N, 14.090° E354.0 s353.9 s0.170.02
09:2033.618° N, 15.080° E356.8 s356.6 s0.170.03

Validation 2 — comparison with an independent library

Astronomy Engine (D. Cross) uses its own ephemerides. With the same ΔT (69.2 s), the differences below are engine − Astronomy Engine, in seconds. The partial-phase contacts and the maximum agree within about 2–3 s. For totality, the two engines agree on the northern side of the path (Kairouan, Mahdia: same durations), but Astronomy Engine places the southern limit about 2–4 km further south: its totality is longer in the south (Gabès, Djerba, Tozeur) and it classifies as total two places that are just outside NASA’s path (Kébili 3 km and Matmata 2 km outside). This is consistent with its larger lunar radius combined with small differences in the lunar ephemeris. It illustrates the real uncertainty near the limits: this site flags every location within 5 km of a limit. These differences are documented rather than hidden.

TownEngineAstronomy EngineLimit (km)C1C2MaxC3C4Totality engineTotality AE
SfaxTotal eclipseTotal eclipse106.8-2.0+1.3-0.5-2.1+1.45 min 39 s5 min 43 s
Sidi BouzidTotal eclipseTotal eclipse97.3-2.0+1.1+0.4-2.0+1.45 min 31 s5 min 34 s
GafsaTotal eclipseTotal eclipse73.7-2.0+2.9-0.4-3.8+1.35 min 09 s5 min 16 s
GabèsTotal eclipseTotal eclipse38.1-2.0+4.6-0.5-5.5+1.34 min 06 s4 min 16 s
Houmt Souk (Djerba)Total eclipseTotal eclipse53.2-2.0+3.7-0.4-4.6+1.34 min 42 s4 min 50 s
El JemTotal eclipseTotal eclipse45.4-2.1+0.3-0.6-1.1+1.44 min 22 s4 min 24 s
KairouanTotal eclipseTotal eclipse15.2-2.1-0.4-0.4-0.4+1.42 min 41 s2 min 41 s
MahdiaTotal eclipseTotal eclipse15.8-2.1-0.4-0.4-0.4+1.42 min 45 s2 min 45 s
TozeurTotal eclipseTotal eclipse6.3-1.9+11.6-0.5-12.6+1.31 min 46 s2 min 10 s
KebiliPartial eclipseTotal eclipse−3.1-2.5—-0.4—+1.3—0 s
MatmataPartial eclipseTotal eclipse−1.9-1.9—-0.4—+1.3—49 s
SoussePartial eclipsePartial eclipse−11.5-2.1—-0.4—+1.4——
MonastirPartial eclipsePartial eclipse−9.9-2.1—-0.4—+1.4——
TunisPartial eclipsePartial eclipse−113.0-2.1—-0.4—+1.5——
BizertePartial eclipsePartial eclipse−158.3-2.2—-0.4—+1.5——
TataouinePartial eclipsePartial eclipse−60.6-1.9—-0.4—+1.3——

Validation 3 — published values

Durations published for Tunisian towns by an independent eclipse guide (nationaleclipse.com, method not documented): Sfax 5 min 39 s, Sidi Bouzid 5 min 31 s, Gafsa about 5 min 10 s, Gabès about 4 min 08 s, El Jem 4 min 25 s, Kairouan about 2 min 45 s. The values of this site differ by 0 to 4 s, the largest differences being near the limits.

Known limitations

  • Lunar limb profile: mountains and valleys on the edge of the Moon shift the limits by up to 1–2 km and change durations near the limits by several seconds. Within about 5 km of a limit, results are flagged.
  • Elevation: computations at sea level. At 500 m altitude, the limits move by a few hundred metres; the effect on times is below one second.
  • Towns are represented by a single point (town centre).
  • ΔT for 2027 is an estimate (±1 s).
  • The climate statistics come from a model reanalysis (ERA5) and do not replace observations or forecasts.

Source register

OrganisationDocumentUseLimitsLicenceConsulted
NASA GSFC — F. EspenakBesselian Elements — Total Solar Eclipse of 2027 August 02Polynomial Besselian elements (x, y, d, l1, l2, μ, tan f1, tan f2), basis of every computation on the site.VSOP87/ELP2000-82 ephemerides; ΔT = 76.0 s extrapolated; smooth lunar limb (limits accurate to about 1–2 km)."Eclipse Predictions by Fred Espenak, NASA's GSFC" (free reproduction with acknowledgement)25 October 2026
NASA GSFC — F. EspenakPath of the Total Solar Eclipse of 2027 Aug 02Reference table (limits, central line, durations every 2 minutes) used to validate the engine.Coordinates rounded to 0.1′; same ΔT and lunar model as the elements.NASA — acknowledgement required25 October 2026
Astronomy Engine — D. Crossastronomy-engine 2.1.19 (npm)Independent cross-check of contact times, obscuration and Sun position; positions of planets during totality.Uses a larger mean lunar radius: totality a few seconds longer, slightly wider path.MIT25 October 2026
geoBoundaries (William & Mary) — OpenStreetMapgeoBoundaries gbOpen TUN ADM1 (commit 9469f09)Boundaries of the 24 governorates (simplified with mapshaper, 6 % of vertices kept).Year represented: 2017; generalised geometry, not suitable for legal or cadastral use.ODbL 1.0 — © OpenStreetMap contributors25 October 2026
Natural EarthAdmin 0 – Countries 1:10mOutline of neighbouring countries on the static map of the home page.Strongly simplified for display only.Public domain25 October 2026
GeoNamesTN.zip and alternatenames/TN.zipCoordinates and population of 62 towns; Arabic and French names reviewed by hand.One point per town (town centre); a town can extend several kilometres around it.CC BY 4.025 October 2026
Copernicus C3S / ECMWF — Open-MeteoERA5 hourly reanalysis via the Open-Meteo Historical Weather APICloud cover and temperature at 09:00 UTC, 26 July–9 August, 2000–2024, for each destination.Model reanalysis on a ~25–30 km grid; climate statistics, not observations at the site.CC BY 4.025 October 2026
Eclipsophile — J. AndersonTotal Solar Eclipse 2027 August 2 (weather prospects)Qualitative comparison with satellite cloud climatology (MODIS) and aerosol information.Regional figures; no site-level numbers reproduced here.© Eclipsophile — cited, not reproduced25 October 2026
NASA Science / American Astronomical SocietyEclipse safety; How to view a solar eclipse safelyBasis of the safety recommendations (ISO 12312-2, filters in front of optics, totality only).—Cited25 October 2026
UNESCO World Heritage CentreWorld Heritage List — TunisiaHeritage sites mentioned in the destination sheets.—Cited25 October 2026
OpenFreeMapVector tiles and "dark" styleBackground map of the interactive map (no API key).Free community service without guaranteed availability; the eclipse layers keep working without it.© OpenMapTiles, © OpenStreetMap contributors (ODbL)25 October 2026

The source code, the data files and the validation scripts are delivered with the project (docs/ folder). Science