WRF_guide

This beginner-oriented repository collects notes and helper files for building WRF/WPS, preparing WPS input data, running WRF from the command line, and using WRF_tools.

Clone

Clone this repository with submodules:

git clone --recurse-submodules https://github.com/Atmospheric-Informatics/WRF_guide.git
cd WRF_guide

If this repository was cloned without submodules, initialize them afterward:

git submodule update --init --recursive

Recommended Workflow

1. Build WRF and WPS

Use one of the following approaches.

• (Recommended) Container build with Podman or Apptainer: WRF Container Guide / Japanese

• Local GNU build script: install_wrf_gnu.sh

• Intel classic compiler example: WRF/WPS installation example with Intel

• AMD AOCC reference: AMD AOCC WRF information

The container guide also includes basic Podman and Apptainer installation notes.

2. Download WPS_GEOG and Run WPS/WRF from the Command Line

Follow the command-line workflow document:

• WRF/WPS Workflow Document
• WRF/WPS Workflow Document (Japanese)

Basic test files are available here:

• Basic test namelist.wps
• Basic test namelist.input
• ERA5 download script for the basic test case

Study cases are separated from the basic workflow guide:

• Kanto 2012 cumulonimbus study case
• Kanto 2012 cumulonimbus study case (Japanese)
• ERA5 download script for the Kanto study case

This document covers the main manual workflow:

• library and environment path settings
• WPS_GEOG download
• optional LCZ geographic data
• ERA5 GRIB data preparation
• geogrid.exe, ungrib.exe, and metgrid.exe
• real.exe and wrf.exe

3. Use WRF_tools

WRF_tools is included as a Git submodule.

• WRF_tools README
• WRF_tools user guide
• Visualization notebook guide
• Visualization notebooks
• Example namelist.wps
• Example namelist.input