README.md

CMAQv5.3.3 Release Notes

CMAQv5.3.3 User's Guide
Tutorials on installing and running CMAQ - Tutorials on running CMAQ, WRF-CMAQ, and CMAQ-ISAM test case.
Frequently asked questions for upgrading to the latest CMAQ version - Updated for v5.3.3 release.
Frequently asked questions for upgrading to the latest MCIP version - Updated for v5.3.3 release.
CMAQv5.3.3 Known Issues - Updated after the v5.3.3 release to alert users of issues that will be addressed with the next release.

Summary of CMAQv5.3.3 Updates

The Community Multiscale Air Quality (CMAQ) Model version 5.3.3 is a minor update to CMAQv5.3 that includes multiple bug fixes. These updates include restoration of windowing capability, allowing users to provide gridded input files which were larger in horizontal extent than the simulated domain. This release also includes a new version of the WRF-CMAQ coupled system with a streamlined build process. Users of WRF-CMAQ are strongly encouraged to try the latest version. Additionally, MCIP users should note that starting with this release we are aligning the version numbering between CMAQ and MCIP, i.e., the MCIP updates included in this release are labeled MCIPv5.3.3.

• CMAQv5.3.3 Bugfixes
• New WRFv4.3-CMAQv5.3.3 Coupled Model
• Updates to MCIP meteorology pre-processor
• Updates to ICON and BCON pre-processing utilities
• Updates to the Detailed Emission Scaling Isolation and Diagnostics (DESID) Module
• Updates to post-processing utilities

Summary of CMAQv5.3.2 Updates

CMAQv5.3.2 includes significant updates to the CMAQ Integrated Source Apportionment Method (ISAM) and multiple minor fixes to address issues identified in CMAQv5.3.1. The new CMAQ-ISAM version includes substantial updates to the gas-phase chemistry apportionment algorithms that improves both physical and numerical aspects of the method. Users of ISAM are strongly encouraged to update to CMAQv5.3.2.

• CMAQv5.3.2 Bugfixes
• Added ISAM support for bidirectional NH3 flux
• Revised ISAM method on how gas chemistry affects apportionment
• Running with Temporally Finer Meteorology
• Update to the DMS chemistry with CB6r3
• Update the Lightning NO Vertical Profile
• Fine aerosol acidity output
• Add make options to bldmake configuration file
• Add 2019 data to CMAQ OMI input file
• Column Modeling
• Add ERF and SIGN functions to COMBINE

Summary of CMAQv5.3.1 Updates

The Community Multiscale Air Quality (CMAQ) Model version 5.3.1 is a minor update to CMAQv5.3 that includes multiple bug fixes and a few feature additions.

• CMAQv5.3.1 Bugfixes
• MCIPv5.1 Bugfixes
• Add support for defining chemical, region and stream families in DESID
• New grid mask files to support regional analysis with DESID and ISAM

Summary of CMAQv5.3 Updates

The Community Multiscale Air Quality (CMAQ) Modeling System, version 5.3, is a major update. CMAQv5.3 includes several changes to the science algorithms in the base model (CCTM), as well as updates to instrumented models, pre-processors, post-processors and utilities. CMAQv5.3 was primarily developed by the U.S. EPA, and it includes contributions from research partners. The enhancements to the CMAQ modeling system since the previous release (CMAQv5.2.1) are summarized below.

Instrumented Models

• ISAM for CMAQv5.3
• Sulfur Tracking Model (STM) for CMAQv5.3
• Documentation for CMAQv5.2-DDM-3D

Chemistry

Photochemistry

• Removal of obsolete mechanisms in CMAQv5.3
• Revision of halogen-mediated first-order ozone loss (all mechanisms)
• Adding detailed halogen and DMS chemistry to CB6r3
• Updates to the chlorine chemistry in CB6r3 in CMAQv5.3
• Updates to the utilities that create an EBI solver
• Allow EBI solvers to conduct integrated reaction rate analysis

Photolysis Rates

• Updates to inline photolysis diagnostics and OMI data files
• Removing sporadic floating point crashes with the PGI Fortran compiler
• Updates to the inline_phot_preproc utility

New Aerosol Modules AERO7 and AERO7i

• Overview of AERO7 and AERO7i
• Monoterpene SOA
• Reorganization of anthropogenic SOA species
• Added uptake of water onto hydrophilic organic aerosol
• Corrected the conversion of inorganic to organic sulfate
• Nonvolatile POA Option in CMAQv5.3
• Streamlined SOA Module

Other Aerosol Processes

• Aerosol Dry Deposition Algorithm Updated
• Fix to Gravitational Settling Sub-Time-Step Calculation
• Simplify Propagation of Aerosol Surface Area to Heterogeneous Chemistry Algorithm

Aqueous and Heterogeneous Chemistry

• AQCHEM-KMT2: Extended inorganic and organic cloud chemistry using the Kinetic PreProcessor

Transport Processes

• Changed ACM2 PBL model vdiff to use Z-coordinates
• Changed ACM cloud model to use Z-coordinates
• Changed hadv to ppm in both x and y

Air-Surface Exchange

• New NH₃ bi-directional flux in M3Dry linked to daily EPIC input
• STAGE: Surface Tiled Aerosol and Gaseous Exchange dry deposition option
• Minor updates to air-surface exchange options

Emission Updates

• DESID: Detailed Emissions Scaling, Isolation and Diagnostic Module
• BEIS Default Chemical Mapping
• Biogenic speciation update for AERO7

Process Analysis

• Process analysis for aerosol sub-processes
• IRR analysis available in EBI solvers

Structural Improvements

• Log File Output: Streamlining and Centralization
• Move Photolysis Rate Calculation to SCIPROC
• Standardized Units for Output Variables
• New Centralized Input/Output Module (CIO)
• Implementation of New Chemical Namelist Format

Diagnostic Options

• Vertical Profile Extraction: extend CCTM to output vertical profiles at specified locations

Pre-processors, Post-processors, and Utilities

• Updates in MCIPv5.0
• Updates to the ICON and BCON pre-processors.
• create_omi: Creating the OMI data file for inline photolysis
• Updates to the create_ebi utility
• Updates to the inline_phot_preproc utility
• Updates to species definition files for organic aerosols
• Updates to post-processing utilities