CMAQ Bugfix Branch - fisidi/CMAQ GitHub Wiki

CMAQ Version X+ Overview

New CMAQ versions are released on the 'main' branch. After a CMAQ release an additional bugfix or 'X+' branch is created. The X+ branch is a continually evolving branch and is intended for users who wish to adopt the most recent bugfixes or minor updates that improve model stability, efficiency, etc. The X+ code has not been thoroughly evaluated or characterized so users must assume the risk of any unforeseen and undocumented impacts of code changes that have been incorporated since the most recent documented public release. The thoroughly vetted version of these bugfixes and updates are then included in the next public release of CMAQ. For example, after CMAQv5.3.3 was released, a 5.3.3+ branch was added. All of the tagged updates in the 5.3.3+ branch were then released with CMAQv5.4.

Below is the record of tagged bugfix versions for each CMAQ release.

Record of changes to CMAQv5.3.3+

Note, each tagged version of CMAQv5.3.3+ contains all updates from previous versions.

Tag	PR Number	PR Name	Merge Date	Brief Description
CMAQv5.3.3.3_10May2022	#168	WRF-CMAQv533+	2022-05-10	Script and documentation update to ensure streamlined building of the WRF-CMAQ model intended for users who would like to run CMAQv5.3.3+ with WRFv4.4+.
CMAQv5.3.3.2_7May2022	#171	Remove files from chemistry utilities causing problems on MAC and WINDOWS systems	2022-05-07	Both the create_ebi and inline_phot_prerproc utilities have files in their source code directories that only differ in letter case in filenames. The property does not cause problems on Linux systems but can cause problems on Window and Macintosh systems. The pull request removes the unneeded files causing the problems.
CMAQv5.3.3.1_11Feb2022
	#163	Resolve Bug for reading Emission Stream Families	2022-02-09	Bug fix to avoid errors when processing matches for emission stream families related to capitalization.
	#164	Resolve bug in Low-NOx formation of SOA	2022-02-09	A typo in the SOA_DEFN data table resulted in high NOx reactions contributing to low-NOx species, which are quite low in volatility. This bug fix has a considerable impact on SOA if using AE6. No impact for AE7.
	#165	Bugfix Speed up emissions processing in PTMET subroutine	2022-02-09	The PTMET subroutine is streamlined so that it is not run for every point source and every stream every time each stream is called. This update drastically reduces runtimes in areas where there happen to be lots of point sources on a particular processor. No impact on results.