This repository introduces the contents of our research work, which consists of two main parts:
- A benchmark dataset for global tropical cyclone (TC) research β TropiCycloneNet Dataset
- A deep learning-based method for predicting TC track and intensity β TropiCycloneNet Method
Both parts are released to foster open research and encourage reproducible results in the field of tropical cyclone forecasting.
πͺοΈ TropiCycloneNet-Dataset
The TropiCycloneNet Dataset (TCN_D) is a comprehensive dataset designed for studying tropical cyclones worldwide. It spans from 1950 to 2023 and includes:
Data_1d: Tabular records of cyclone center location, pressure, wind speed, etc.Data_3d: Gridded meteorological fields (e.g., geopotential height, wind components, SST) around the cyclone center.Env-Data: Structured environmental features that support deep learning applications.
It enables the analysis and modeling of both spatial and temporal cyclone behavior and provides a foundation for building data-driven forecasting systems.
We offer two download options:
We provide easy-to-use scripts for loading and visualizing each part of the dataset (read_TCND.py). You can generate visualizations of Data_1d, Data_3d, and Env-Data with a single command.
Example:
python read_TCND.py dataset_path Haiyan 2001101418 WP trainThis will produce three images showing the meteorological and environmental context of Typhoon Haiyan at a specific timestamp. π Features
Resolution: 0.25Β°, every 6 hours
Ocean Regions: WP, EP, ATL, NI, SI, SP
Pressure levels: 200, 500, 850, 925 hPa
Additional features: SST, movement velocity, intensity change, subtropical high data
π Documentation
See full documentation and usage guide in the GitHub repository:
π§ Introduction
TropiCycloneNet (TCN_M) is our proposed deep learning model for predicting TC track and intensity using multi-modal data (e.g., environmental features, 1D/3D meteorological data).
This repository contains:
Preprocessed subset of the TCN_D dataset
Test code for inference and visualization
Forecast results rendered on Himawari-8 satellite imagery
π Red circles: Ground truth tracks
π Green stars: Our modelβs best prediction
π© Green area: Multiple trajectory predictions by our model
π₯ Red area: MMSTNβs prediction range
Python 3.8.5
PyTorch 1.11.0+
OpenCV, NumPy, Matplotlib
Training code and model weights will be released soon. See full documentation and usage guide in the GitHub repository:
@article{Huang2025,
author = {Huang, Cheng and Mu, Pan and Zhang, Jinglin and Chan, Sixian and Zhang, Shiqi and Yan, Hanting and Chen, Shengyong and Bai, Cong},
title = {Benchmark dataset and deep learning method for global tropical cyclone forecasting},
journal = {Nature Communications},
volume = {16},
number = {1},
pages = {5923},
year = {2025},
publisher = {Nature Publishing Group},
doi = {10.1038/s41467-025-61087-4},
url = {https://doi.org/10.1038/s41467-025-61087-4},
issn = {2041-1723}
}
