Difference between revisions of "DSMACC chemical box model"

From Geos-chem
Jump to: navigation, search
(setup)
(setup)
Line 38: Line 38:
 
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 [mailto:barronh@ufl.edu Barron Henderson] ''(University of Florida)''.
 
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 [mailto:barronh@ufl.edu Barron Henderson] ''(University of Florida)''.
  
===setup===
+
===Model setup===
 
First, download the code and configure
 
First, download the code and configure
 
<pre>
 
<pre>

Revision as of 17:02, 24 July 2014

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.

  1. Download the model (wget https://github.com/barronh/DSMACC/archive/master.zip)
  2. Unzip the archive (e.g., unzip master.zip)
  3. Navigate a terminal into DSMACC-master
  4. 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

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).

Model 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 second step is to add these two lines to your .cshrc

setenv KPP_HOME /your-home-directory/DSMACC-master/kpp
setenv PATH /your-home-directory/j1m/DSMACC-master/kpp/bin:${PATH}

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.

This step is not required in current package, as it is already done.

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.

This step is not required in current package, as it is already done.

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.

This step is not required in current package, as it is already done.

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

  1. 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.