adaf

Initial public release of code, data, and model weights for ADAF.

https://github.com/xiangyanfei212/adaf

Science Score: 36.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
    Links to: zenodo.org
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (12.5%) to scientific vocabulary
Last synced: 11 months ago · JSON representation

Repository

Initial public release of code, data, and model weights for ADAF.

Basic Info
  • Host: GitHub
  • Owner: xiangyanfei212
  • Language: Python
  • Default Branch: main
  • Homepage:
  • Size: 5.21 MB
Statistics
  • Stars: 7
  • Watchers: 2
  • Forks: 0
  • Open Issues: 0
  • Releases: 1
Created almost 2 years ago · Last pushed over 1 year ago
Metadata Files
Readme Citation

README.md

Notice: The complete version can be found in https://github.com/microsoft/ADAF/tree/main

ADAF

This repository contains the code used for "ADAF: An Artificial Intelligence Data Assimilation Framework for Weather Forecasting"

Abstract

The forecasting skill of numerical weather prediction (NWP) models critically depends on the accurate initial conditions, also known as analysis, provided by data assimilation (DA). Traditional DA methods often face a trade-off between computational cost and accuracy due to complex linear algebra computations and the high dimensionality of the model, especially in non-linear systems. Moreover, processing massive data in real-time requires substantial computational resources. To address this, we introduce an artificial intelligence-based data assimilation framework (ADAF) to generate high-quality kilometer-scale analysis. This study is the pioneering work using real-world observations from varied locations and multiple sources to verify the AI method's efficacy in DA, including sparse surface weather observations and satellite imagery. We implemented ADAF for four near-surface variables in the Contiguous United States (CONUS). The results indicate that ADAF surpasses the High Resolution Rapid Refresh Data Assimilation System (HRRRDAS) in accuracy by 16% to 33% for near-surface atmospheric conditions, aligning more closely with actual observations, and can effectively reconstruct extreme events, such as tropical cyclone wind fields. Sensitivity experiments reveal that ADAF can generate high-quality analysis even with low-accuracy backgrounds and extremely sparse surface observations. ADAF can assimilate massive observations within a three-hour window at low computational cost, taking about two seconds on an AMD MI200 graphics processing unit (GPU). ADAF-generated analysis fields improved short-term (0–6 hour) forecasts of an AI-based weather prediction model, outperforming HRRRDAS-initialized forecasts. ADAF has been shown to be efficient and effective in real-world DA, underscoring its potential role in operational weather forecasting.

Figure: Overall framework

Data

  • Pre-processed data

Link for Pre-processed Data - Zenodo Download Link

The pre-proccesd data consists of input-target pairs. The inputs include surface weather observations within a 3-hour window, GOES-16 satellite imagery within a 3-hour window, HRRR forecast, and topography. The target is a combination of RTMA and surface weather observations. The table below summarizes the input and target datasets utilized in this study. All data were regularized to grids of size 512 $\times$ 1280 with a spatial resolution of 0.05 $\times$ 0.05 $^\circ$.






Dataset Source Time window Variables/Bands
Input Surface weather observations WeatherReal-Synoptic (Jin et al., 2024) 3 hours Q, T2M, U10, V10
Satellite imagery GOES-16 (Tan et al., 2019) 3 hours 0.64, 3.9, 7.3, 11.2 $\mu m$
Background HRRR forecast (Dowell et al., 2022) N/A Q, T2M, U10, V10
Topography ERA5 (Hersbach et al., 2019) N/A Geopotential
Target Analysis RTMA (Pondeca et al., 2011) N/A Q, T2M, U10, V10
Surface weather observations WeatherReal-Synoptic (Jin et al., 2024) N/A Q, T2M, U10, V10

  • Pre-computed normalization statistics

Link for pre-computed normalization statistics- Zenodo Download Link.

If you are utilizing the pre-trained model weights that we provided, it is crucial that you utilize of the given statistics as these were used during model training. The learned model weights complement the normalizing statistics exactly.

The data directory of pre-processed data and pre-computed normalization statistics is organized as follows: data │ README.md └───test │ │ 2022-10-01_00.nc │ │ 2022-10-02_06.nc │ │ 2022-10-03_12.nc │ │ ... │ │ 2023-10-31_00.nc └───stats.csv

  • Trained model weights

Link for trained model weights - Zenodo Download Link

model_weights/ │ model_trained.ckpt

Inference

In order to run ADAF in inference mode you will need to have the following files on hand.

  1. The path to the test sample file. (./data/test/)

  2. The inference script (inference.py)

  3. The model weights hosted at Trained Model Weights。 (./modelweights/modeltrained.ckpt)

  4. The pre-computed normalization statistics (./data/stats.csv)

  5. The configuration file (./config/experiment.yaml)

Once you have all the file listed above you should be ready to go.

An example launch script for inference is provided. ```shell export CUDAVISIBLEDEVICES='0'

nohup python -u inference.py \ --seed=0 \ --expdir='./exp/' \ # directory to save prediction --testdatapath='./data/test' \ # path to test data --netconfig='EncDec' \ # network configuration --holdoutobs_ratio=0.3 \ # the ratio of surface observations to be fed into the model > inference.log 2>&1 &

```

References

1. Jin, W. et al. WeatherReal: A Benchmark Based on In-Situ Observations for Evaluating Weather Models. (2024). 2. Dowell, D. et al. The High-Resolution Rapid Refresh (HRRR): An Hourly Updating Convection-Allowing Forecast Model. Part I: Motivation and System Description. Weather and Forecasting 37, (2022). 3. Tan, B., Dellomo, J., Wolfe, R. & Reth, A. GOES-16 and GOES-17 ABI INR assessment. in Earth Observing Systems XXIV vol. 11127 290–301 (SPIE, 2019). 4. Hersbach, H. et al. ERA5 monthly averaged data on single levels from 1979 to present. Copernicus Climate Change Service (C3S) Climate Data Store (CDS) 10, 252–266 (2019). 5. Pondeca, M. S. F. V. D. et al. The Real-Time Mesoscale Analysis at NOAA’s National Centers for Environmental Prediction: Current Status and Development. Weather and Forecasting 26, 593–612 (2011).

Owner

  • Name: Yanfei Xiang
  • Login: xiangyanfei212
  • Kind: user

Citation (CITATION.cff)


      

GitHub Events

Total
  • Release event: 3
  • Watch event: 8
  • Public event: 1
  • Push event: 18
  • Create event: 2
Last Year
  • Release event: 3
  • Watch event: 8
  • Public event: 1
  • Push event: 18
  • Create event: 2