Light Pollution API Reference

Documentation

Project record

Credits / Attributions

A record of the people, sources, and software associated with DarkSkySites. Scientific works below are background references, not co-developer credits; third-party data, assets, and software retain their own rights.

Development & ownership

Original development

LUMIX and APEX were developed exclusively by Barrington Russell, who is the sole developer of both systems. Their pipelines and architecture are independently developed and proprietary.

How the calculations work/Light pollution simulator

Source credits

People, data & software

Attribution is distinct from access and usage terms. Consult each source’s terms for permissions and conditions.

Earth observation and atmospheric data

Source observations and atmospheric information are distinct from DarkSkySites' proprietary processing, modelling and rendering.

NASA FIRMS, NOAA-20 and NOAA-21 VIIRS

The optional Active Fires overlay shows recent VIIRS satellite-detected thermal anomalies from NASA FIRMS in rolling 24, 48 or 72 hour windows. Hotspots are not exact fire perimeters or smoke coverage. Not every anomaly is a wildfire; missing detections do not establish that an area is free of fire. Retrieved timestamps describe WMS image retrieval, not the acquisition time of every detection.

Source: NASA FIRMS, NOAA VIIRS. NASA and NOAA do not endorse DarkSkySites. This environmental overlay does not change the artificial light-pollution model.

SSEC RealEarth, University of Wisconsin-Madison

The current worldwide Satellite Clouds overlay uses the Space Science and Engineering Center's RealEarth global infrared composite (globalir). DarkSkySites displays actual hourly observations with screen blending and enhanced display contrast, retaining the original source imagery and watermark. Infrared imagery is not a cloud-cover probability, a verified cloud-free mask or a simultaneous exposure of the entire Earth. Observation times, delivery delays and missing scans are disclosed in the cloud controls.

Source: SSEC RealEarth, UW-Madison

EUMETSAT Meteosat satellite observations

The retained regional scientific-mask implementation, separate from the current worldwide cloud overlay, combines the MSG scientific Cloud Mask with same-time Meteosat Third Generation GeoColour imagery through EUMETView. DarkSkySites requests matching Web Mercator images, masks and desaturates these products. Clear classifications are transparent. Hatched or uncovered areas are unknown, not clear sky. This is observed imagery, not a cloud-cover forecast.

Contains modified EUMETSAT Meteosat products, 2026. CC BY 4.0. No EUMETSAT endorsement. Observation times and delivery delays are displayed in the controls.

NASA, VIIRS and the Black Marble science team

DarkSkySites uses NASA's VNP46A3 monthly composite: VIIRS/NPP Lunar BRDF-Adjusted Nighttime Lights Monthly L3 Global 15 arc second Linear Lat Lon Grid. These Black Marble nighttime-light observations underpin the satellite-derived radiance processed by DarkSkySites. We acknowledge NASA Earthdata, the Level-1 and Atmosphere Archive & Distribution System Distributed Active Archive Center (LAADS DAAC), the VIIRS instrument and mission teams, and the Black Marble science team led by Miguel O. Román. These acknowledgements credit observations and published research, not the development of LUMIX or APEX.

NASA data and scientific references do not imply NASA or NOAA endorsement of DarkSkySites. Source observations are independently processed by DarkSkySites; model outputs are not NASA products.

NOAA Space Weather Prediction Center

The optional Aurora map overlay uses NOAA SWPC's operational OVATION short-term auroral activity forecast for both hemispheres. NOAA SWPC also supplies the estimated planetary Kp feed shown with aurora information. DarkSkySites reprojects and colourises the model grid independently of its light-pollution models. Modelled activity is not the probability of seeing aurora from the ground; Kp is geomagnetic context, not a local observing forecast.

Aurora forecast data: NOAA Space Weather Prediction Center. Actual visibility also depends on darkness, clouds and local conditions. NOAA does not endorse DarkSkySites.

Copernicus Atmosphere Monitoring Service (CAMS) and ECMWF

Atmospheric inputs used in the DarkSkySites modelling approach draw on CAMS, implemented by the European Centre for Medium-Range Weather Forecasts (ECMWF) on behalf of the European Union. The derived sky-brightness models are DarkSkySites' own work.

Contains modified Copernicus Atmosphere Monitoring Service information. Neither the European Commission nor ECMWF is responsible for any use that may be made of the information it contains.

Maps, place names and geocoding

Map and geocoding data retain their original licences. These credits supplement, rather than replace, the attribution displayed with maps.

Natural Earth and World Atlas

Natural Earth provides the public-domain geographic data used for the independent Country Borders layer's coastlines and country outlines at 1:50 million scale, and the land mask at 1:110 million scale. The country outlines are distributed as TopoJSON through the World Atlas project. We acknowledge Natural Earth's contributors, including Tom Patterson and Nathaniel Vaughn Kelso, and the World Atlas project. These generalized boundaries are orientation aids, not authoritative current political boundaries.

Made with Natural Earth. Natural Earth map data is in the public domain; the World Atlas distribution and software retain their own applicable notices.

OpenStreetMap contributors

OpenStreetMap supplies the underlying geographic database used by our basemaps and OpenStreetMap-based geocoders. We thank the volunteer contributors who create and maintain it.

© OpenStreetMap contributors. OpenStreetMap data is available under the Open Data Commons Open Database License (ODbL). Applicable database attribution and share-alike obligations remain with that data.

CARTO

CARTO supplies the map backgrounds used by DarkSkySites, including Dark Matter, Positron and Voyager. CARTO basemaps incorporate OpenStreetMap data.

© CARTO. © OpenStreetMap contributors. CARTO basemap service access is governed by CARTO's basemap terms; acknowledgement is not a substitute for service authorisation.

Nominatim

Nominatim provides OpenStreetMap-based reverse geocoding and place-name lookups. The public service is operated by the OpenStreetMap Foundation. Its service usage policy is separate from the ODbL licence on the underlying data.

Geocoding data © OpenStreetMap contributors, available under the ODbL.

Photon and komoot

Location search uses the Photon geocoder and its public endpoint hosted by komoot. Photon is open-source geocoding software based on OpenStreetMap data.

Search data © OpenStreetMap contributors, available under the ODbL. Photon software is licensed under Apache License 2.0.

Weather, geolocation and supporting services

OpenWeather

OpenWeather supplies weather forecasts, cloud cover, temperature, wind, humidity, air-pollution forecasts and weather-condition icons where these features are available. Forecast data remains separate from DarkSkySites' permanent sky-brightness modelling.

Weather data provided by OpenWeather. Use and redistribution are subject to the applicable OpenWeather subscription and data licence.

MaxMind GeoLite2 and geoip-country

The local geoip-country dataset is used for coarse country-level IP lookup. It does not provide precise observer coordinates.

This product includes GeoLite2 data created by MaxMind, available from https://www.maxmind.com.

Community observations and contributors

We thank the observers who submit Sky Quality Meter (SQM) readings and other observational feedback. User-submitted measurements are distinct from satellite-derived estimates. Individual contributors' personal details are not published here without permission.

Software and technical infrastructure

Third-party components retain their own copyright and licence terms. Their inclusion does not make their authors co-developers of the proprietary LUMIX or APEX systems.

Third-party application and scientific tools

DSS uses React, TypeScript, Vite, Node.js, Express, OpenLayers, Leaflet, Proj4js, D3, Recharts, SunCalc, Astronomia, Lucide, React Feather, Radix UI, Tailwind CSS, Drizzle, PostgreSQL client libraries, Sharp and libvips, amongst other packages. Native WebGPU support uses the webgpu package and Dawn. The accompanying inventory records exact locked versions, declared licences and upstream links; the notices file preserves the licence, copyright, notice and end-user-licence texts shipped with installed packages.

Inter typeface

The locally bundled Inter typeface is credited to The Inter Project Authors and is distributed under the SIL Open Font License, Version 1.1. Its full licence is included in the downloadable notices.

Hosted infrastructure and optional integrations

The application uses Neon/PostgreSQL, OpenAI, Resend and SMTP services where configured. These services are acknowledged as infrastructure providers, not authors of LUMIX or APEX. Their own service terms apply.

Background reading

Scientific references

These publications inform the scientific context. They are references only and do not imply co-development of LUMIX or APEX.

  1. R. H. Garstang (1986). Model for artificial night-sky illumination

    Foundational research on modelling artificial sky brightness and atmospheric propagation.

  2. P. Cinzano, F. Falchi and C. D. Elvidge (2001). The first World Atlas of the artificial night sky brightness

    Historical scientific background for satellite-based, geographically resolved sky-brightness modelling.

  3. F. Falchi and colleagues (2016). The new world atlas of artificial night sky brightness

    Scientific reference and context, not a claim that the World Atlas pipeline is used as the LUMIX or APEX implementation.

  4. L. G. Henyey and J. L. Greenstein (1941). Diffuse radiation in the Galaxy

    The published scattering phase-function approximation referenced by APEX's atmospheric model.

  5. M. O. Román and colleagues (2018). NASA's Black Marble nighttime lights product suite

    Reference for the NASA nighttime-light product family and its retrieval and correction methods, separate from DSS processing.

  6. Z. Wang, R. M. Shrestha, M. O. Román and V. L. Kalb (2022). NASA's Black Marble Multiangle Nighttime Lights Temporal Composites

    The temporal-composite methods publication cited by NASA for the VNP46A3 monthly product.

  7. John E. Bortle (2001). Introducing the Bortle Dark-Sky Scale

    Origin of the qualitative observing scale used for context. A model-derived class is an approximation, not an on-site visual assessment.

Bundled dependencies

Package notices & inventory

The notices file contains the bundled package notices. The inventory lists exact package versions, licenses, and source links. These records provide attribution and license information; they do not grant service access or change usage terms.