DSMACC chemical box model
This page describes the DSMACC chemical box model (U. Leeds).
Overview
Brief description
The Dynamically Simple Model of Atmospheric Chemical Complexity (DSMACC) is designed to be a simple box model which can easily change its chemical scheme and can be used both for free running and constrained simulations. It is written in FORTRAN and uses the KPP chemical pre-processor, the TUV photolysis scheme and can use the Master Chemical Mechanism or other chemical mechanisms.
DSMACC is a useful and flexible tool. We are using it to test new GEOS-Chem chemical mechanisms.
New information on DSMACC can be found here. The code is freely available although support is limited!
Instructions for Use
Instructions for DSMACC are in the README, but are summarized below.
- Download the model (wget https://github.com/barronh/DSMACC/archive/master.zip)
- Unzip the archive (e.g., unzip master.zip)
- Navigate a terminal into DSMACC-master
- Run the test case (make check)
The test case includes a version 8 GEOS-Chem simulation that you can modify for your purposes. This test case is just a toy and is not meant for analysis.
--barronh 10:04, 25 October 2013 (EDT)
Authors and collaborators
- Mat Evans (U. York)
- Barron Henderson (University of Florida)
- Jingqiu Mao (Princeton/NOAA GFDL)
DSMACC for GEOS-Chem
The current version of DSMACC has been largely updated by Barron Henderson. Barron has developed all python-based parsers for GEOS-Chem and other mechanisms. Perl parser is not supported in current box model simulations.
I recently tested v9-02 with tremendous help from Barron. The current package can run both GC v8-02-03 and GC v9-02. If you have any questions, please contact Barron Henderson (University of Florida).
setup
First, download the code and configure
curl -kLO https://github.com/barronh/DSMACC/archive/master.zip unzip master.zip cd DSMACC-master/ configure (to generate Makefile.defs)
The next step is to modify Makefile.defs change this line
FLEX_LIB=-lfl
to
FLEX_LIB=/usr/lib64/libfl.a
Third step is to generate the executable for kpp
make kpp/bin/kpp
This will generate the executable file kpp.
Prepare the input file
Using python parser (assuming you have python loaded up in your machine)
curl -kLO https://github.com/barronh/pykpp/raw/master/src/pykpp/models/prep/geoschem2kpp.py python geoschem2kpp.py globchem.dat > globchem.eqn
This will produce globchem.eqn.
Mapping photolysis rates to TUV index
DSMACC uses TUV model to drive the photolysis reactions. You will need to modify the generated eqn for this. TUV reactions are described in usrinp.
Special treatment for special rates
You can define some special rates that not in the standard form of reaction rates. This can be done by modifying GEOSFunctions.inc.
Generate kpp files based on your mechanism
go to src folder
../kpp/bin/kpp ../test/geoschem-09-02.kpp dsmacc
Here geoschem-09-02.kpp includes all the information for the mechanism. This will generate a series of .f90 files. To run v8-02-03 chemistry, you can just change geoschem-09-02.kpp to geos.kpp, which includes all v8-02-03 information.
Run the model
compile the files that are generated by kpp. Type make in the DSMACC-master/src folder. This will generate the executable file dsmacc in DSMACC-master/bin folder.
To run the model, you should have a initialization file "Init_cons.dat", which describes the initial concentrations of all species.
References
- Emmerson, K.M., M. J. Evans, Comparison of tropospheric gas-phase chemistry schemes for use within global models, Atmos. Chem. Phys., 9, 1831-1845, 2009. PDF
Known issues
None at this time.