Skip to content

SHiELD in a Box

Unified System for Weather-to-Seasonal Prediction
Easy Use
Collaborative Research

Learn more

When SHiELD meets Container Technology

SHiELD (System for High-resolution prediction on Earth-to-Local Domains) is a unified atmospheric model supporting various configurations, including severe weather nowcasting, hurricane forecasting, and subseasonal-to-seasonal prediction.

SHiELD has become easy to use, thanks to container technology. Better yet, SHiELD can runs on all major operating systems (Windows, macOS, and Linux), as well as on the cloud.

Container technology leverages the flexibility of SHiELD and opens many possibilities for research and education.


  • \u201cOne code, one executable, one workflow\u201d for weather-to-seasonal prediction. SHiELD can be a global, a global-nest, or a regional model.
  • FV3 Dynamical Core provides a powerful foundation for unified prediction modeling.

Learn more


  • A container is a stand-alone, software artifact that packages applications (e.g., an atmospheric model) for portability.
  • Model installation made easy. No need to worry about environmental variables and library dependencies.
  • Model becomes portable, from laptop to cloud.
  • Ensure bitwise identical results, regardless of different computing systems.

Learn more about container on Wikipedia.

Containerization of SHiELD

  • SHiELD and its dependencies are packaged using Docker.
  • Designed for collaboration. No proprietary software is used.
  • Parallelism in mind. Support Message Passing Interface (MPI) and OpenMP.
  • High performance computer (HPC) ready. Seamless deployment on HPCs through Singularity.

Learn more in Cheng et al. (in review).

Your path to unified modeling systems starts here

Try out running SHiELD on your computer.

Conduct Hurricane Laura simulation in just three steps.

Choose your preferred container platform:

Most popular container platform

1. Install

docker pull gfdlfv3/shield

2. Download

Hurricane Laura case
GFS fix files

3. Run

docker run --cap-add=SYS_PTRACE -v PATH_of_CASE:/rundir -v PATH_of_GFS_fix:/GFS_fix -it gfdlfv3/shield mpirun -np 1 --allow-run-as-root

Designed for supercomputer

1. Install

singularity pull docker://gfdlfv3/shield

2. Download

Hurricane Laura case
GFS fix files

3. Run

singularity exec --bind PATH_of_CASE:$HOME --bind PATH_of_GFS_fix:/GFS_fix PATH_of_image mpirun -np 1
  • This one-hour simulation should finish in a few minutes on x86 systems. It may take much longer on ARM systems (e.g., Apple M1).
  • Guide for FV3 and configuration (namelist) can be found here.
  • This workflow can be applied to any simulations. Simply modify the content in above case folder with your desired case. We recommend using UFS UTILS to generate initial/boundary conditions.
  • An example of a global-nest simulation can be downloaded here.