Thanks to visit codestin.com
Credit goes to github.com

Skip to content

trieloff/eclipse

Repository files navigation

Eclipse Maps

Interactive maps of total solar eclipse paths with cloud climatology.

Live: https://trieloff.github.io/eclipse/2026/spain.html

Demo with home location: View from El Poal – shows driving distances from your location

Data Files

  • data/eclipse-{year}.json - Eclipse path and Besselian elements from NASA GSFC
  • data/cloud-{year}.json - Cloud cover climatology grid from CM SAF/EUMETSAT

Currently available: 2026, 2027, 2028, 2030

Code Structure

  • index.html - Landing page with links to regional maps
  • 2026/, 2027/ - Regional eclipse viewer pages
  • scripts/eclipse-calculator.js - Besselian-element based totality calculator
  • scripts/fetch-eclipse-path.js - Fetches NASA GSFC eclipse path data
  • scripts/build-cloud-climatology.js - Builds cloud cover climatology from EUMETSAT

UI Behavior

  • Clicking a location locks it and shows links for driving directions (from a POI with category: home), Shadowmap, and Airbnb.

Development

npm install
npm run dev    # starts on port 3000

Data Scripts

Eclipse Path

# Fetch 2026 eclipse data
npm run fetch-2026

# Fetch 2027 eclipse data
npm run fetch-2027

# Fetch any eclipse (outputs to stdout)
node scripts/fetch-eclipse-path.js <nasa-url>

Eclipse path URLs follow the pattern:

https://eclipse.gsfc.nasa.gov/SEpath/SEpath2001/SE{YYYY}{Mon}{DD}{T|A|H}path.html

Where T=Total, A=Annular, H=Hybrid. Find eclipse URLs at: https://eclipse.gsfc.nasa.gov/solar.html

Cloud Climatology

Requires EUMETSAT API credentials. See README.local.md for setup.

# Build cloud climatology for any eclipse year
node scripts/build-cloud-climatology.js <year>

# Examples:
npm run cloud-2026
npm run cloud-2027

Downloads ~400 daily NetCDF files (~2.8GB) and computes climatology around the eclipse date from 2002-2020.

Shadowmap Integration

Visualize sun position at eclipse time:

https://app.shadowmap.org/?lat=43.33560&lng=-5.84591&zoom=13.62&time=1786554530978

Parameters: lat, lng, zoom, time (unix ms), basemap, elevation, hud

Attribution

  • Eclipse Predictions by Fred Espenak, NASA's GSFC
  • Cloud data: CM SAF/EUMETSAT (CLARA-A3, CC BY 4.0)

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •