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 .

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.
With neither option, all cycles from 2022-01-01 through the UTC date 24 hours before execution are downloaded.

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

Metadata

Release files for weathernext-download 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for weathernext-download 0.1.0
File	Size	Uploaded
weathernext_download-0.1.0.tar.gz	6.0 kB	Sep 3, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for weathernext-download 0.1.0
File	Interpreter	ABI	Platform	Reset
weathernext_download-0.1.0-py3-none-any.whl 7.3 kB Sep 3, 2026	Python 3	none	any	Details

Total release size: 13.3 kB

Release files / weathernext_download-0.1.0.tar.gz

Download URL	weathernext_download-0.1.0.tar.gz
Size	6.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`aa442456215932ed87663486bca7dbec43329270ac4b509d6ee3e92d1dc6f14b`
BLAKE2b-256 checksum How to use checksums	`9d55a8b7b5524204fab06558120f34c237bf081e01091de629de4fbf1c3e1432`
Upload date	Sep 3, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.10.16`

Release files / weathernext_download-0.1.0-py3-none-any.whl

Download URL	weathernext_download-0.1.0-py3-none-any.whl
Size	7.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`91d03d148b767106d5a5bd0bfed5bdd4fabe75ea551f2642ea3bf87eaf9b73ce`
BLAKE2b-256 checksum How to use checksums	`43ffdd0eab43546c604f68ab6ff8b4ca982ab50b908b374833a36e03985aa6dc`
Upload date	Sep 3, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.10.16`