CMAQv5.4 Release Notes: Utilities - fisidi/CMAQ GitHub Wiki
Remove Conflicting Filenames on Window and Macintosh Operating Systems
William T. Hutzell, U.S. Environmental Protection Agency
Type of update: Bug Fix
Release Version/Date: CMAQ Version 5.4
Description: Both the create_ebi and inline_phot_prerproc have files in their source code directories that only differ in letter case in filenames such as UTIL/create_ebi/junit.F and UTIL/create_ebi/junit.f. The property does not cause problems on Linux systems but can cause problems on Window and Macintosh systems. The problem is easily removed because either, only one file is needed or neither file is needed to build these chemistry utilities. The pull request removes the unneeded files causing the problems as well as removing two unneeded files under UTIL/inline_phot_preproc/src.
Significance and Impact: None, but allows to more efficiently use the CMAQ repository on Windows and Macintosh operating systems.
References: N/A
Internal PRs: PR#899
Autochem
Ben Murphy, U.S. Environmental Protection Agency
Type of update: New Feature
Release Version/Date: CMAQ Version 5.4
Description:
Introduction of the Autochem utility script that processes new chemical mechanism files, including EBI files if necessary, for user-defined mechanisms when mech.def and chemcial namelist files are provided. The script executes utilities that are already present in the CMAQ repo including chemmech and create_ebi. It also copies and transfers files among directories that are used for driving the utilities.
The purpose of Autochem is to reduce the burden of introducing new chemical mechanisms to CMAQ. The script can be executed as part of the bldit_cctm.csh script. Just uncomment the line containing:
set build_mech
By default, the script will copy any new mechanism files produced back into the CMAQ repo so they can be used in the future. If there are existing mechanism files there that you would like to overwrite, uncomment
set clobber_mech
Significance and Impact: None, but allows to more efficiently use the CMAQ repository.
References: N/A
New Output files and Runtime Options for CHEMMECH
William T. Hutzell, U.S. Environmental Protection Agency
Type of update: Code and Documentation Enhancements
Release Version/Date: CMAQ Version 5.4
Description: The CHEMMECH utility was updated to accomplish the below items.
-
Add an option that revises the mechanism definition based on how reactions change the total number of elements between reactants and products. The elements consider is a subset of all chemical elements. If a reaction does not balance the initial and final number of elements, the revised file appends the reaction with the variables and coefficients measuring the unbalance. For each unbalance element, the added variable is called DELTA_element. DELTA_element's are not active chemistry species so CHEMMECH does not output information to solve how the DELTA_element's evolve over time. Both these output files are written to the output directory.
-
Produce four matlab scripts to support the F0AM modeling that are produced by the chemmech utility.
-
Revise the chemmech README page to include the new option as well the output files supporting F0AM box-model. A previous pull request added the F0AM outputs. After this numbered list, an relevant excerpt is given.
-
Fix a bug in chemmech that add stoichiometric coefficients for product when the products are atmospheric constants such as the reaction. The coefficient for M should not be added because M is not counted as product.
<R2> O + O2 + M = O3 + M # 6.00E-34^-2.6; -
Revise the chemmech source code to reduce the number of complex INTERFACE blocks. The change uses FORTRAN modules to accomplish the task. The module files combine several code files into a one file.
Consult UTIL/chemmech/README.md for more Items 1 and 2.
Significance and Impact: (1) Allows users to run the F0AM box-model when creating a CMAQ mechanism via the chemmech utility. (2) Adds to chemmech a run-time option revising the input mechanism definitions file for how each reaction changes the balance of elements such as carbon, nitrogen, and sulfur.