Scheduled Downtime
On Friday 21 April 2023 @ 5pm MT, this website will be down for maintenance and expected to return online the morning of 24 April 2023 at the latest

WRF Multi-Operating System Install Toolkit (WRF-MOSIT) ***Updated 11/20/2025***

William.Hatheway

Active member
Hello and Good Day to the Weather Research Forecasting Modeling Community, Atmospheric Science Community, Meteorologists, Researchers & Meteorological Organization Leaders:

My name is Will Hatheway and I am a meteorologist in Texas, USA.

WRF-MOSIT has been published in the Springer academic journal Earth Science Informatics (Impact Factor: 3.0) and is available on
Researchgate
(https://www.researchgate.net/public..._for_configuring_and_installing_the_WRF_model )
and the journal website (https://doi.org/10.1007/s12145-023-01136-y).
Please note that the WRF-MOSIT must be cited and is required by Springer.

The citation is:

Hatheway, W., Snoun, H., ur Rehman, H. et al. WRF-MOSIT: a modular and cross-platform tool for configuring and installing the WRF model. Earth Sci Inform (2023). https://doi.org/10.1007/s12145-023-01136-y

Third, WRF-MOSIT now includes support for ALL Fedora Kernel-based Linux Distributions on 64-bit systems. With this addition to the WRF-MOSIT, the WRF model can now be installed on High-Performance Computers, Cloud Servers, Desktops, and Laptops. The supported kernels include, but are not limited to:
  • Red Hat Linux Enterprise
  • CentOS
  • AlmaLinux
  • Rocky Linux
  • Fedora Linux

With the addition of the Fedora Kernel, the WRF-MOSIT can now be installed on:
  • Debian Linux Kernels (Ubuntu, Linux Mint, Q4OS, etc.)
  • Fedora Linux Kernels (Red Hat Linux Enterprise, CentOS, Fedora, Rocky Linux, etc.)
  • MacOS
  • Windows Sub-System Linux (Debian Linux Kernels and Fedora Linux Kernels)

The WRF-MOSIT is now a complete installation package that can be utilized on ANY system anywhere in the world.


WRF Multi-Operating System Install Toolkit:

This is a BASH script that provides options to install the following Weather Research & Forecasting Model (WRF) packages in 64-bit systems:
  • Weather Research & Forecasting Model (WRF)
  • Weather Research & Forecasting Model Chemistry (WRF-CHEM)
  • Weather Research & Forecasting Model Hydro Standalone (WRF-Hydro)
  • Weather Research & Forecasting Model Hydro Coupled w/ WRF (WRF-Hydro Coupled)
  • Hurricane Weather Research & Forecasting Model (HWRF)
  • Weather Research and Forecasting Model CMAQ (WRF-CMAQ)
  • Weather Research and Forecasting Model Wildland Fire (WRF-SFIRE)

System Requirements

  • 64-bit system
    • Linux Fedora Distros (Red Hat Linux Enterprise, Fedora Linux, CentOS, etc.)
    • Linux Debian Distro (Ubuntu, Linux Mint, etc.)
    • Windows Subsystem for Linux (Debian Distributions, Fedora Distributions)
    • MacOS
  • 350 Gigabyte (GB) of storage space

Libraries Installed (Latest libraries as of 03/01/2023)

  • Libraries are manually installed in sub-folders utilizing either Intel (CURRENTLY BROKEN DUE TO Compiler update. Will only work on classic intel compilers) or GNU Compilers.

GNU Fortran CompilersIntel Classic Fortran Compilers
zlib (1.2.13)zlib (1.2.13)
MPICH (4.1.2)libpng (1.6.39)
libpng (1.6.39)JasPer (1.900.1)
JasPer (1.900.1)HDF5 (1.14.2)
HDF5 (1.14.2)PHDF5 (1.14.2)
PHDF5 (1.14.2)Parallel-NetCDF (1.12.3)
Parallel-NetCDF (1.12.3)NetCDF-C (4.9.2)
NetCDF-C (4.9.2)NetCDF-Fortran (4.6.1)
NetCDF-Fortran (4.6.1)Miniconda
MinicondaIntel oneAPI Basekit
Intel oneAPI HPCKIT
Intel oneAPI AIKIT

Software Packages
WRFWRF-CHEMWRF-Hydro StandaloneWRF-Hydro CoupledHurricane WRFWRF-CMAQWRF-SFIRE
WRF v4.5WRF Chem w/KPP 4.5WRF-Hydro v5.2WRF v4.5HWRF Utilities v4.0aWRF v4.5WRF-SFIRE v2
WPS v4.5WPS v4.5WPS v4.5POMTC v4.0aCMAQ v5.4WPS v4.2
WRF PLUS v4.5WRFDA Chem 3DVARWRF-Hydro v5.2NCEP Coupler v4.0aWPS v4.5
WRFDA 4DVAR v4.5GFDL Vortex Tracker v4.0a
GSI v4.0a
UPP v4.0a
WRF v4.3.3
WPS v4.3.1

Pre/Post Processing Packages Installed

  • Development Testbed Center (DTC) Model Evaluation Tools (MET) v11.1.0
  • Development Testbed Center (DTC) Enhanced Model Evaluation Tools (METplus) v5.1.0
  • Development Testbed Center (DTC) Unified Post Processor (UPP) v4.1
  • ARWPost v3
  • WRF-Python (Conda installed)
  • OpenGrADS
  • GrADS
  • NCAR Command Language (Conda installed)
  • Prep-Chem-SRC v1.5
  • WRF CHEM Tools
    • Mozbc
    • Megan Bio Emiss
    • Megan Bio Data
    • Wes Coldens
    • ANTHRO EMIS
    • EDGAR HTAP
    • EPA ANTHO EMIS
    • UBC
    • Aircraft
    • FINN
  • WRF-GIS-Preprocessor (Conda installed)
  • Climate Data Operators (Conda installed)
  • Quantum Geographic Information System – QGIS (Conda installed)

*** Tested on Ubuntu 20.04.5 LTS, Ubuntu 22.04.1 LTS, MacOS Ventura, Windows Subsystem Linux Ubuntu, Rocky Linux 9, CentOS 7, Red Hat Linux Enterprise 7***

Special thanks to:
  • University of Manchester's Doug L
  • The University of Tunis El Manar's Hosni S.
  • GSL's Jordan S.
  • University of Luxembourg’s Haseeb R.
  • University of Nairobi’s Anthony M.+-
  • NCAR's Mary B., Christine W., & Carl D.
  • DTC's Julie P., Tara J., George M., & John H.
  • UCAR's Katelyn F., Jim B., Jordan P., Kevin M.
  • Youtube's meteoadriatic
  • GitHub user jamal919


Below you will find links to the install scripts for WRF-MOSIT:

WRF MOSIT:

DTC Model Evaluation Tools
WRF CHEM Tools & Prep-Chem-SRC

As always, I write these scripts to help the greater atmospheric community. If I can help the advancement of the global atmospheric community through this small effort then I will be pleased.
Hatheway, W., Snoun, H., ur Rehman, H. et al. WRF-MOSIT: a modular and cross-platform tool for configuring and installing the WRF model. Earth Sci Inform (2023). https://doi.org/10.1007/s12145-023-01136-y
 
Good afternoon everyone,



I'm excited to share the latest updates for WRF-MOSIT!



I've upgraded all codes, libraries, and tools to their latest versions as of July 1, 2024. Additionally, I've added several new features and removed outdated functionalities to ensure optimal performance.



New Additions:



- Updated all libraries, software, and tools to their latest versions.

- Added GrADS and OpenGrADS installations for MacOS.

- Implemented checks for an active conda environment before installing WRF-MOSIT.

- Transitioned from Intel Classic Compilers to the new LLVM Compilers (ifx/icx/icpx).

- Included new geography files for specialized cases.

- Enhanced Readme files with updated instructions for executing .exe files.



Removals:



- Removed Hurricane-WRF due to dependency on non-free Intel Classic Compilers. I recommend using WRF with the vortex following option—contact me for assistance.

- Temporarily removed the DTC MET Toolkit for Intel LLVM compilers. A compatible version is in development.

- Discontinued QGIS support due to stability issues and lack of support for GIS-WRF.

- Ended sponsorships following changes in GitHub's policies.



Future Projects:



- Ongoing maintenance of libraries and codes.

- Plan to update the MET toolkit upon the release of the new version.

- Development of the COAWST model for Intel, with the GNU version already completed.



Known Issues:



- Compilation error in WRFCHEM w/KPP with Intel LLVM due to excessive core usage. Contact me directly for a tailored installation.

- GNU 14 compatibility issues with some WRF-MOSIT systems; I'm currently exploring necessary compilation flags.

- An interactive terminal prompt bug in UBUNTU 24.01 disrupts proper installation; a fix is underway with Canonical.



I'm pleased with these updates and eager to see your innovative applications of WRF-MOSIT.

As a reminder, please ensure to cite WRF-MOSIT in any publication, as REQUIRED by its academic journal publication:



Hatheway, W., Snoun, H., ur Rehman, H. et al. WRF-MOSIT: a modular and cross-platform tool for configuring and installing the WRF model. Earth Sci Inform (2023). (https://doi.org/10.1007/s12145-023-01136-y)



The updated code is available on GitHub:






Thank you for your continued support and encouragement.



Best regards,

WH



#WRFMOSIT #WeatherResearch #ClimateScience #OpenSource #Meteorology #EarthSciences #SoftwareUpdate #ClimateTech #WRF
 
Good afternoon everyone,



I'm excited to share the latest updates for WRF-MOSIT!



I've upgraded all codes, libraries, and tools to their latest versions as of July 1, 2024. Additionally, I've added several new features and removed outdated functionalities to ensure optimal performance.



New Additions:



- Updated all libraries, software, and tools to their latest versions.

- Added GrADS and OpenGrADS installations for MacOS.

- Implemented checks for an active conda environment before installing WRF-MOSIT.

- Transitioned from Intel Classic Compilers to the new LLVM Compilers (ifx/icx/icpx).

- Included new geography files for specialized cases.

- Enhanced Readme files with updated instructions for executing .exe files.



Removals:



- Removed Hurricane-WRF due to dependency on non-free Intel Classic Compilers. I recommend using WRF with the vortex following option—contact me for assistance.

- Temporarily removed the DTC MET Toolkit for Intel LLVM compilers. A compatible version is in development.

- Discontinued QGIS support due to stability issues and lack of support for GIS-WRF.

- Ended sponsorships following changes in GitHub's policies.



Future Projects:



- Ongoing maintenance of libraries and codes.

- Plan to update the MET toolkit upon the release of the new version.

- Development of the COAWST model for Intel, with the GNU version already completed.



Known Issues:



- Compilation error in WRFCHEM w/KPP with Intel LLVM due to excessive core usage. Contact me directly for a tailored installation.

- GNU 14 compatibility issues with some WRF-MOSIT systems; I'm currently exploring necessary compilation flags.

- An interactive terminal prompt bug in UBUNTU 24.01 disrupts proper installation; a fix is underway with Canonical.



I'm pleased with these updates and eager to see your innovative applications of WRF-MOSIT.

As a reminder, please ensure to cite WRF-MOSIT in any publication, as REQUIRED by its academic journal publication:



Hatheway, W., Snoun, H., ur Rehman, H. et al. WRF-MOSIT: a modular and cross-platform tool for configuring and installing the WRF model. Earth Sci Inform (2023). (https://doi.org/10.1007/s12145-023-01136-y)



The updated code is available on GitHub:






Thank you for your continued support and encouragement.



Best regards,

WH



#WRFMOSIT #WeatherResearch #ClimateScience #OpenSource #Meteorology #EarthSciences #SoftwareUpdate #ClimateTech #WRF
is Rocky Linux9.4 suitable for WRF numerical model operation?
 
Have you successfully compiled WRF-CHEM with KPP in MACOS?
I always failed due to creating registry with Trace/BTP trap:5 error.

/bin/sh: line 1: 54988 Trace/BPT trap: 5 tools/registry -DEM_CORE=1 -DNMM_CORE=0 -DNMM_MAX_DIM=2600 -DDA_CORE=0 -DWRFPLUS=0 -DIWORDSIZE=4 -DDWORDSIZE=8 -DRWORDSIZE=4 -DLWORDSIZE=4 -DNONSTANDARD_SYS
TEM_SUBR -DMACOS -DWRF_USE_CLM -DUSE_NETCDF4_FEATURES -DWRFIO_NCD_LARGE_FILE_SUPPORT -DDM_PARALLEL -DNETCDF -DHDF5 -DLANDREAD_STUB=1 -DUSE_ALLOCATABLES -Dwrfmodel -DGRIB1 -DINTIO -DKEEP_INT_AROUND -DLIMI
T_ARGS -DBUILD_RRTMG_FAST=0 -DBUILD_RRTMK=0 -DBUILD_SBM_FAST=1 -DSHOW_ALL_VARS_USED=0 -DCONFIG_BUF_LEN=65536 -DMAX_DOMAINS_F=21 -DMAX_HISTORY=25 -DNMM_NEST=0 -DWRF_CHEM -DBUILD_CHEM=1 -DWRF_KPP -DNEW_BDY
S Registry/Registry
 
Have you successfully compiled WRF-CHEM with KPP in MACOS?
I always failed due to creating registry with Trace/BTP trap:5 error.

/bin/sh: line 1: 54988 Trace/BPT trap: 5 tools/registry -DEM_CORE=1 -DNMM_CORE=0 -DNMM_MAX_DIM=2600 -DDA_CORE=0 -DWRFPLUS=0 -DIWORDSIZE=4 -DDWORDSIZE=8 -DRWORDSIZE=4 -DLWORDSIZE=4 -DNONSTANDARD_SYS
TEM_SUBR -DMACOS -DWRF_USE_CLM -DUSE_NETCDF4_FEATURES -DWRFIO_NCD_LARGE_FILE_SUPPORT -DDM_PARALLEL -DNETCDF -DHDF5 -DLANDREAD_STUB=1 -DUSE_ALLOCATABLES -Dwrfmodel -DGRIB1 -DINTIO -DKEEP_INT_AROUND -DLIMI
T_ARGS -DBUILD_RRTMG_FAST=0 -DBUILD_RRTMK=0 -DBUILD_SBM_FAST=1 -DSHOW_ALL_VARS_USED=0 -DCONFIG_BUF_LEN=65536 -DMAX_DOMAINS_F=21 -DMAX_HISTORY=25 -DNMM_NEST=0 -DWRF_CHEM -DBUILD_CHEM=1 -DWRF_KPP -DNEW_BDY
S Registry/Registry
I have gotten it to compile, granted i am updating the code recently that will fix a lot of these issues
 
Good afternoon Meteorologists, Atmospheric Scientists, Emergency Managers, and modelers around the globe,
After a year of debugging, refactoring, and testing in every spare hour outside my part-time job, I’m very happy to finally say:

WRF-MOSIT is updated and ready for the community again.
This update completely refreshes the WRF Multi Operational System Install Toolkit (WRF-MOSIT): a modular, cross-platform BASH toolkit that automates installation and configuration of a whole suite of WRF-based systems on modern 64-bit macOS and Linux platforms.
Before diving into details, I want to start with gratitude:
  • Staff scientists and developers at NSF NCAR (The National Center for Atmospheric Research) and NOAA (National Oceanic & Atmospheric Administration) who helped track down subtle bugs, test installs, and suggest improvements.
  • Collaborators and testers from universities and centers around the world (Zadar, Manchester, Tunis El Manar, UCAR, GSL, DTC, and more) who provided feedback, shared logs, and validated installs on their systems.
Thank you all for the patience, encouragement, and real-world testing that made this release possible.

What Is WRF-MOSIT?​

WRF-MOSIT (WRF Multi Operational System Install Toolkit) is a BASH-based installer whose goal is simple:
Take a fresh 64-bit system and get you from “bare OS” to a working WRF ecosystem, with compilers, libraries, pre/post-processing tools, and multiple WRF-based systems—all configured and ready to run.
From a single script, you can install (on supported platforms):
  • WRF-ARW – Core Weather Research & Forecasting Model
  • WRF-CHEM – WRF with atmospheric chemistry (KPP-enabled)
  • WRF-Hydro (Standalone) – Hydrologic modeling system
  • WRF-Hydro Coupled w/ WRF
  • WRF-CMAQ – Coupled WRF/CMAQ air quality system
  • WRF-SFIRE – Wildland fire modeling within WRF
  • COAWST – Coupled Ocean–Atmosphere–Wave–Sediment Transport system
The script doesn’t just compile models. It also:A
  • Installs compilers, MPI, NetCDF, and related libraries.
  • Sets up pre/post-processing tools (MET, METplus, WRF-Python, NCL, CDO, GrADS/OpenGrADS, etc.).
  • Creates Conda environments tuned for WRF workflows.
  • Automatically organizes everything in a consistent directory structure under your home directory.

Citation (Required for Use in Publications)​

WRF-MOSIT is not just a script; it’s a peer-reviewed tool described in the literature.
If you use WRF-MOSIT in research, operations, or educational work that leads to publications, citing the paper is a requirement, and the script itself reminds you of this at startup.
Citation:
Hatheway, W., Snoun, H., ur Rehman, H. et al.
WRF-MOSIT: a modular and cross-platform tool for configuring and installing the WRF model.
Earth Science Informatics
(2023).
https://doi.org/10.1007/s12145-023-01136-y
The installer prints this citation up front and pauses so you see it clearly before proceeding.

System Requirements & Supported Platforms​

Core Requirements​

From the updated README:
  • 64-bit system only
    • macOS (Darwin)
    • Linux Debian family (Ubuntu, Mint, etc.)
    • Windows Subsystem for Linux (WSL) – Debian/Ubuntu-based
    • Linux Fedora/RHEL family (CentOS, Rocky Linux, RHEL, etc.)
  • Disk space: at least 350 GB of free storage in your home directory
The script checks available disk space and will stop with a clear message if you don’t meet the requirement.

Minimum Recommended Hardware​

  • 16 GB RAM or more
  • 8 CPU cores or more
These aren’t hard requirements coded into the script, but they are strong recommendations if you want WRF and companions to run comfortably.

Tested Configurations​

WRF-MOSIT has been tested on a range of current systems, including:
  • Ubuntu 22.04.4 LTS
  • Ubuntu 24.04.3 LTS
  • macOS (including macOS Sonoma)
  • CentOS 8
  • Rocky Linux 9
  • Windows Subsystem for Linux (Ubuntu)
All tests were done on 64-bit builds using library versions current as of 2025-11-01, with any exceptions noted in the documentation.
Estimated installation time (depending on model choice, compiler, and network):
~60–120 minutes at ~10 Mbps download speed
(Intel compilers typically add some extra time.)

What Gets Installed: Versions & Library Stack​

Core Version Environment​

The script exports version variables so you (and other scripts) know what’s installed:

export METPLUS_Version=6.2.0
export met_Version_number=12.2.0
export met_VERSION_number=12.2
export METPLUS_DATA=6.2
export WRF_VERSION=4.7.1
export WPS_VERSION=4.6.0
export CMAQ_VERSION=5.5

Supported Models & Versions​

WRF (ARW)
  • WRF v4.7.1
  • WPS v4.6.0
  • WRF PLUS v4.7.1
  • WRFDA 4DVAR v4.7.1
  • OBSGRID (via NCAR Command Language/Conda)
WRF-CHEM
  • WRF-CHEM w/ KPP (v4.7.1)
  • WPS v4.6.0
  • WRFDA-CHEM 3DVAR
  • OBSGRID (NCL/Conda)
WRF-Hydro (Standalone)
  • WRF-Hydro v5.4
WRF-Hydro Coupled w/ WRF
  • WRF-Hydro v5.4
  • WRF v4.7.1
  • WPS v4.6.0
  • OBSGRID (NCL/Conda)
WRF-CMAQ
  • WRF v4.5.0
  • CMAQ v5.5
  • WPS v4.6.0
WRF-SFIRE
  • WRF-SFIRE v2
  • WPS v4.2
COAWST
  • COAWST system using a compatible WRF/WPS stack on supported Linux platforms

Compiler Availability by OS​

From the README’s compatibility table:
  • Ubuntu/Debian (x86_64)
    • WRF-ARW, WRF-CHEM, WRF-Hydro (standalone & coupled), WRF-SFIRE, COAWST:
      GNU or Intel compilers
    • WRF-CMAQ:
      GNU only
  • RHEL/Rocky/CentOS (x86_64)
    • Same pattern as Ubuntu/Debian:
      → WRF-ARW, WRF-CHEM, WRF-Hydro, WRF-Hydro Coupled, WRF-SFIRE, COAWST: GNU or Intel
      → WRF-CMAQ: GNU only
  • macOS (Intel & ARM)
    • WRF-ARW, WRF-CHEM, WRF-Hydro, WRF-SFIRE: GNU only
    • WRF-CMAQ & COAWST: not available on macOS in this release

Libraries Installed (as of 2025-11-01)​

Libraries are built and installed under each WRF folder using either GNU or Intel compilers.
With GNU Compilers:
  • zlib 1.3.1
  • MPICH 4.3.2
  • libpng 1.6.39
  • JasPer 1.900.1
  • HDF5 1.14.6
  • PHDF5 1.14.6
  • Parallel-NetCDF 1.14.1
  • NetCDF-C 4.9.3
  • NetCDF-Fortran 4.6.2
  • NetCDF-CXX 4.3.1
  • Miniconda
With Intel Compilers:
  • zlib 1.3.1
  • libpng 1.6.39
  • JasPer 1.900.1
  • HDF5 1.14.6
  • PHDF5 1.14.6
  • Parallel-NetCDF 1.14.1
  • NetCDF-C 4.9.3
  • NetCDF-Fortran 4.6.2
  • Miniconda
  • Intel Basekit
  • Intel HPC Kit
  • Intel oneAPI Python

Pre/Post-Processing Tools Installed​

For each WRF flavor (where supported), WRF-MOSIT sets up a consistent toolchain. Across WRF, WRF-CHEM, WRF-Hydro (where relevant), WRF-CMAQ, WRF-SFIRE, and COAWST, the toolkit installs:
  • MET (DTC Model Evaluation Tools) v12.1.1
  • METplus (Enhanced Model Evaluation Tools) v6.1.0
  • WRF-Python (Conda)
  • OpenGrADS
  • GrADS
  • NCAR Command Language (NCL) (Conda)
  • Climate Data Operators (CDO) (Conda)
This gives you a ready-to-use environment for:
  • Generating and verifying forecasts (MET/METplus)
  • Visualizing output (NCL, GrADS, OpenGrADS)
  • Scripting diagnostics and plots (WRF-Python, CDO)
On supported systems, the script can also automate the full MET & METplus installation, including:
  • Installing dependencies via apt or yum/dnf
  • Downloading and building MET with an official compile_MET_all.sh
  • Configuring METplus defaults.conf to point to the MET install and data
  • Downloading and unpacking METplus test data
  • Running a GridStat test to confirm everything works
If that test fails, the script exits and tells you to inspect the logs instead of leaving you guessing.

Conda Environments and Analysis Tools​

WRF-MOSIT sets up several named Conda environments under each WRF installation to keep tools organized and stable:
Env namePathPurpose
cdo_stable$HOME/<WRF software name>/miniconda3/envs/cdo_stableFor CDO: manipulating & analyzing climate and model data.
ncl_stable$HOME/<WRF software name>/miniconda3/envs/ncl_stableFor NCL: advanced scientific visualization & analysis.
wrf-python$HOME/<WRF software name>/miniconda3/envs/wrf-pythonFor WRF-Python: post-processing WRF output in Python (NumPy/Matplotlib ecosystems).
wrfh_gis_env$HOME/<WRF software name>/miniconda3/envs/wrfh_gis_envFor WRF-Hydro GIS Pre-Processor: preparing geospatial input datasets for WRF-Hydro runs.
Activate them with:

conda activate cdo_stable
conda activate ncl_stable
conda activate wrf-python
conda activate wrfh_gis_env
These dedicated environments reduce dependency conflicts and make your workflow reproducible.

 

Attachments

  • README.txt
    16.8 KB · Views: 0
Top