Data Sources & Methodology

How the verdict works

MilkyWayCheck computes everything from your location and date: cloud cover from a numerical weather forecast, the Moon's illumination and altitude from an astronomical ephemeris, astronomical darkness from the Sun's position, the galactic core's altitude (RA 17h45m, Dec −29°), and your Bortle class from a scientific light-pollution atlas. A deterministic scoring engine — no AI, no opinions — turns those into a GO / POSSIBLY / SKIP verdict with the limiting factor explained.

Weather data

Hourly cloud cover, precipitation probability, visibility and temperature come from Open-Meteo (open-meteo.com), with NOAA NWS (api.weather.gov) as the US fallback. Forecasts are cached and refreshed every 15 minutes. If weather data is unavailable, the page says so explicitly and never substitutes a guess.

Moon and twilight calculations

Sun and Moon positions use standard low-precision astronomical algorithms (Meeus-style series, accuracy well under a degree). Astronomical darkness is defined as the Sun below −18° altitude. All times are calculated for your exact coordinates and shown in your local timezone, including daylight-saving transitions.

Light pollution and Bortle classes

Bortle classes are estimated from the New World Atlas of Artificial Night Sky Brightness (Falchi et al., 2016, Science Advances), the standard global light-pollution dataset, distributed via GFZ Data Services (doi:10.5880/gfz.1.4.2016.001). They describe typical conditions, not a live measurement. The atlas is pre-processed into a compact grid so the site only ever reads single cells.

Dark-sky locations

Certified dark-sky places come from the International Dark-Sky Association's public listings, linked to their official sources and periodically re-verified. Unnamed 'darker sky' results are grid cells from the light-pollution atlas — leads to scout, not guaranteed sites.

Uncertainty, stated plainly

Weather forecasts are probabilistic; Bortle classes are estimates; a GO verdict means conditions suggest a good night, not a guarantee. MilkyWayCheck's job is to save you the wasted drive on obviously bad nights and make good nights obvious.

Licenses and attribution

  • Weather: Open-Meteo (CC BY 4.0, open-meteo.com) · NOAA NWS (public domain, api.weather.gov)
  • Light pollution: Falchi et al. (2016), “The new world atlas of artificial night sky brightness”, Science Advances — data via GFZ Data Services (doi:10.5880/gfz.1.4.2016.001)
  • Geocoding: OpenStreetMap Nominatim (ODbL, usage policy) · US Census Bureau geocoder (public domain)
  • Dark-sky places: International Dark-Sky Association public listings, darksky.org
  • Astronomy: computed locally (Sun/Moon low-precision series; galactic center RA 17h45m, Dec −29°), no external astronomy API.

Check tonight's Milky Way visibility →