Geoskill: VIIRS Nightlights Download

Download VIIRS nighttime light composite data (annual or monthly) with optional regional bounding box from EOG/NOAA VNL and NASA LAADS sources.

ruiduobao

@ruiduobao

What This Skill Does

Downloads VIIRS nighttime light composite data (annual and monthly) from public sources like EOG/NOAA VNL and NASA LAADS, with support for bounding-box regional subsetting.

Replaces manual downloading and subsetting of large satellite imagery datasets from multiple government portals by providing a single CLI tool with search and bbox filtering.

When to Use It

  • Download annual VIIRS nightlight composites for a specific year
  • Fetch monthly nightlight data for a given month and year
  • Subset a regional area of nightlight data using bounding box coordinates
  • Search available VIIRS products by year and product type before downloading
  • Batch download multiple years of nightlight data for time-series analysis

Install

$ openclaw skills install @ruiduobao/viirs-nightlights-download

VIIRS Nightlights Downloader

Download VIIRS nighttime light composite data from public sources (EOG/NOAA VNL, NASA LAADS).

Credentials

EOG (Earth Observation Group, Colorado School of Mines) requires a free account for VNL v2.2 direct download since 2025. The skill does not authenticate on your behalf; use --list-urls to get the JSON of URLs, then download manually with wget --user EOG_USER --password '…'.

Optional EOG credentials (for future auto-download):

  1. EOG_USERNAME / EOG_PASSWORD env vars
  2. ~/.netrc entry for machine eogdata.mines.edu
  3. Default (geoskill-core credentials.py): empty — register first

Register at https://eogdata.mines.edu/register/ (free, 1-2 days approval).

Usage

# Search available data
python viirs-nightlights-download.py search --year 2023 --product annual

# Download global annual composite
python viirs-nightlights-download.py download --year 2023 --product annual -o output/

# Download monthly composite
python viirs-nightlights-download.py download --year 2023 --product monthly --month 6 -o output/

# Download regional subset by bbox
python viirs-nightlights-download.py download --year 2023 --product annual --bbox 100,20,120,40 -o output/

Products

  • annual: Annual cloud-free composite (VNL v2)
  • monthly: Monthly composite

Year Range

2012 - 2024

Requirements

  • Python 3.8+
  • requests
  • tqdm

中文说明

下载 VIIRS 夜间灯光合成数据,支持 EOG/NOAA VNL 和 NASA LAADS 数据源。

产品类型

  • annual:年度云量过滤合成产品(VNL v2)
  • monthly:月度合成产品

年份范围

2012 - 2024

使用方法

# 搜索可用数据
python viirs-nightlights-download.py search --year 2023 --product annual

# 下载全球年度合成
python viirs-nightlights-download.py download --year 2023 --product annual -o output/

# 下载月度合成
python viirs-nightlights-download.py download --year 2023 --product monthly --month 6 -o output/

# 按边界框下载区域子集
python viirs-nightlights-download.py download --year 2023 --product annual --bbox 100,20,120,40 -o output/

Top skills in this category