CMAQ on AWS Tutorial#


This documentation is under continuous development Previous version is available here: CMAQv5.3.3 on AWS Tutorial

Community Multiscale Air Quality Model#

The Community Multiscale Air Quality (CMAQ) modeling system an active open-source development project of the U.S. EPA. The CMAQ system is a Linux-based suite of models that requires significant computational resources and specific system configurations to run. CMAQ combines current knowledge in atmospheric science and air quality modeling, multi-processor computing techniques, and an open-source framework to deliver fast, technically sound estimates of ozone, particulates, toxics and acid deposition.

Tutorial Overview#

This document provides tutorials on how to use Amazon Web Service (AWS) high performance computing services. AWS’s Elastic Compute Cloud (EC2) allows you to create and run a single Linux virtual machine, or Single VM, in the cloud. Another AWS resource, ParallelCluster, is a cluster management tool that helps you to deploy and manage many VMs in the cloud. ParallelCluster is well suited for large modeling applications as it automatically sets up the required compute resources, scheduler, and shared file system.

The following tutorials will walk you through running a CMAQ benchmark case on both a Single VM and on the more advanced ParallelCluster. A benchmark case is provided with pre-installed software allowing you to jump right into running CMAQ and post-processing model output for analysis and visualization. The Developers Guide provided in Chapter 4 describes how to do the software installation process yourself in order to set up simulations tailored to your own applications.

The tutorials are aimed at users with cloud computing experience that are already familiar with AWS. For those with no cloud computing experience we recommend signing up for a free AWS Educate account, as it is open to any individual, regardless of where they are in their education, technical experience, or career journey. If you are a new user to AWS, you can sign up for a free tier account. There are also low-cost tutorials available to learn Parallel Cluster from AWS: Parallel Cluster Tutorial and AWS Workshops on HPC Computing.

User Support#

Please share any issues or suggestions for running CMAQ on the Cloud to the CMAS User Forum, under the Cloud Computing Category. This forum is available for users and developers to discuss issues related to using the CMAQ system on the cloud.

To submit edits to this documentation see instructions available in Contribute to this Tutorial.

Table of Contents#