weathernext-download

weathernext-download downloads paired tropical-cyclone forecast files from Google DeepMind Weather Lab. It supports ensemble and ensemble-mean products, CSV and ATCF formats, and the OPER and FNV3 model families.

Installation

pip install --upgrade weathernext-download

Or from source:

git clone https://github.com/CongGao-CG/weathernext-download.git
cd weathernext-download
pip install .

Available products

Weather Lab provides experimental cyclone predictions paired with observed tracks for verification. Every model below is available as an ensemble mean (--ensemble_mean), a full ensemble of member tracks (--ensemble), or both (--both), in CSV (--csv) or ATCF (--atcf) format.

Coverage was checked against the Weather Lab download endpoints on 2026-09-03 and may expand or contain isolated gaps. An unavailable upstream file is reported as a failed download. See Google's Weather Lab guide for its description and terms for experimental cyclone forecast data.

Usage

Download one forecast cycle:

weathernext-download --time 2026070100 --ensemble_mean

Download both products for all four cycles on one day:

weathernext-download --date 20260701 --both

Download a month or year:

weathernext-download --date 202607 --both
weathernext-download --date 2026 --both

Download ATCF files from the FNV3P2 model:

weathernext-download --date 20220101 --v3p2 --both --atcf

Time selection

• --time YYYYMMDDHH downloads one cycle. The hour must be 00, 06, 12, or 18.
• --date YYYYMMDD downloads all four cycles on one day.
• --date YYYYMM downloads all four cycles for every day in one month.
• --date YYYY downloads all four cycles for every day in one year.
• Date selections are capped at the date obtained from current UTC time minus 24 hours and restricted to the selected model's temporal coverage. A period with no overlap exits with an error instead of sending invalid requests.
• With neither option, all cycles within the selected model's temporal coverage are downloaded through the date obtained from current UTC time minus 24 hours.

Product selection

• --ensemble_mean or --ensemble-mean
• --ensemble
• --both (default)

File format

• --csv (default)
• --atcf

Model selection

• --oper for OPER (default)
• --v3p2 for FNV3P2
• --v3p1 for FNV3P1
• --v3p0 for FNV3P0
• --v3p2LE or --v3p2le for FNV3_LARGE_ENSEMBLE

Files are stored under ./ensemble_mean and ./ensemble in the directory where the command is run. Existing non-empty files are skipped. Each new file is first written to a temporary file and moved into place only after the download completes.

Run weathernext-download --help for all options, including timeout and retry settings.

License

MIT