CMAQv5.4 Release Notes: WRF CMAQ Coupled Model - fisidi/CMAQ Wiki

New WRF-CMAQ model using WRFv4.4 and CMAQv5.4

David Wong, U.S. Environmental Protection Agency
Type of update: New Feature
Release Version/Date: CMAQv5.4
Description: The new WRF-CMAQ model is based on WRFv4.4 and CMAQv5.4. It supports only RRTMG radiation scheme for short wave aerosol direct effect. It uses core-shell model to perform aerosol optics calculations rather than volume mixing technique as in the previous version of the WRF-CMAQ model.

The code used to couple the WRFv4.4-CMAQv5.4 models is now released as part of the CMAQ Github Repository.

Starting from WRF V4.4 and CMAQ v5.4, users can construct the coupled model with any version of WRF (v4.4 or later) and any version of CMAQ (v5.4 or later) with the following steps:

  • download the desirable version of WRF
  • download the desirable version of CMAQ
  • build CMAQ by executing bldit_cctm.csh with build_twoway turns on
  • move the built CMAQ code, BLD* into WRF direction with the name cmaq
  • setenv WRF_CMAQ 1
  • setenv IOAPI the_path_IOAPI (for example: /home/wdx/lib/x86_64/gcc-9.1/ioapi_3.2)
  • setenv WRFIO_NCD_LARGE_FILE_SUPPORT 1
  • configure
  • compile em_real

The "setenv WRF_CMAQ 1" must be there when you compile or recompile code and the "setenv IOAPI the_path_IOAPI" must be there before typing configure.

A complete step by step build process and run instructions are provided in the WRF-CMAQ Tutorial.

Significance and Impact This simplifies the WRF-CMAQ coupled model construction process and lets users have choices to build the coupled model with a desirable version of WRF and CMAQ.

References: N/A
Internal PRs: N/A

WRF-CMAQ model Aerosol Feedback Bugfix

David Wong, U.S. Environmental Protection Agency
Type of update: Bug Fix
Release Version/Date: CMAQv5.4
Description: A bug was identified within the CMAQ to WRF coupling routine (twoway_feedback.F90) where aerosol feedback information is transferred from CMAQ to WRF. In doing so, it was found that WRF was not receiving the correct aerosol feedback information due to a looping error relating to the number of layers set to 1 in some cases.

Specifically, The 3-way nested loop in the subroutine feedback_read (twoway_feedback.F90) assigns aerosol feedback information to the WRF grid structure. The outer loop runs from 1 to NLAYS3D which it is an IOAPI internal variable, and the value of NLAYS3D is establish at the end of calling IOAPI subroutine DESC3. Hence its value might differ from the value obtained in the FIRTIME block and subsequent time step.

Similarly the last block of code in the feedback_read subroutine suffers a similar problem, i.e. the top layer + 1 does not get updated properly.

Significance and Impact: For those running the coupled WRF-CMAQ model with short wave radiative feedback, the bugfix now correctly captures the variations in the aerosol optical properties and consequently the direct feedback effects through all layers.

References: N/A
Internal PRs: PR 951