Skip to content

VVMex

VVMex is a C++17 cloud-resolving model based on the Vector Vorticity Model (VVM). It uses Kokkos for CPU and NVIDIA GPU parallelism, MPI for domain decomposition, and ADIOS2 for model output.

Start here

I want to… Go to
Build and run a small example Quick start
Build the dependency stack Environment installation
Choose a ready-made case Default cases
Edit a case JSON Model configuration
Run locally or submit through SLURM Job submission
Choose HDF5, SST, or BP5 output Output
Understand or modify the code Developer guides

For routine runs, use submit.py. It reads the selected CMake preset, prepares the runtime environment, assigns compute and I/O ranks, and keeps CPU/GPU resources consistent with the binary that was built.

What VVMex includes

  • Three-dimensional vector-vorticity dynamics with configurable tendencies, forcings, and idealized benchmarks.
  • Modified P3 microphysics based on E3SM EAMxx and the original Fortran P3 process coupling.
  • Kokkos-enabled RRTMGP radiation.
  • Turbulence, surface fluxes, and the Noah land-surface model.
  • HDF5, SST, and BP5 output, including restart support.
  • Taiwan-oriented workflows using NetCDF topography and land fields.

For bugs and feature requests, open an issue in the source repository.