Difference between revisions of "DSMACC chemical box model"

From Geos-chem
Jump to: navigation, search
(Source code and data)
Line 6: Line 6:
  
 
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 solvers FAQ|KPP chemical pre-processor]], the TUV photolysis scheme and can use the [http://mcm.leeds.ac.uk/MCM/ Master Chemical Mechanism] or other chemical mechanisms.
 
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 solvers FAQ|KPP chemical pre-processor]], the TUV photolysis scheme and can use the [http://mcm.leeds.ac.uk/MCM/ Master Chemical Mechanism] or other chemical mechanisms.
 
DSMACC is based out of the [http://www.see.leeds.ac.uk/research/icas/index.htm Institute for Climate and Atmospheric Science] at the [http://www.see.leeds.ac.uk/research/icas/index.htm School of Earth and Environment] of the [http://www.leeds.ac.uk/ University of Leeds.]
 
  
 
DSMACC is a useful and flexible tool.  We are using it to test new GEOS-Chem 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 [https://sites.google.com/site/dsmaccmanual here].
+
New information on DSMACC can be found [https://github.com/barronh/DSMACC here]. The code is freely available although support is limited!
 +
 
  
 
=== Instructions for Use ===
 
=== Instructions for Use ===
  
To use the DSMACC model with GEOS-Chem with the GEOS-Chem chemical mechanisms follow the instructions below after downloading the DSMACC code and KPP utilities from the DSMACC website:
+
Instructions for DSMACC are in the [https://github.com/barronh/DSMACC README], but are summarized below.
  
#In the boxmodel directory type "make clean" to clear the directory.
+
#Download the model (wget https://github.com/barronh/DSMACC/archive/master.zip)
#In the same directory type "Geos2kppbox_parser.pl globchem.dat" to generate the three kpp-compatible globchem.eqn, globchem.spc and globchem.def files. Ensure that the number of reaction lines in globchem.dat matches the number of lines read in with the perl script (under the section entitled "Evaluate Product Lines" in Geos2kppbox_parser.pl).
+
#Unzip the archive (e.g., unzip master.zip)
#Generate the kpp *.f90 files by typing "kpp model.kpp".  
+
#Navigate a terminal into DSMACC-master
#In the tuv_old/ directory type "make clean" followed by "make". A warning message will appear ("no action performed for specified file(s)). This is anticipated.
+
#Run the test case (make check)
#Go back to the boxmodel directory and compile the model by entering "make". You may get error messages about the incompatibility of the variable type REAL with reaction rates of the order 1.0E-39. This should not affect the code from compiling.
+
#Run the code by entering "model". Or you can send the output straight to an output file by entering "model > model_output"
+
  
--[[User:Emarais|Emarais]] 07:04, 6 November 2011 (EDT)
+
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.
 +
 
 +
 
 +
--[[User:barronh|barronh]] 10:04, 25 October 2013 (EDT)
  
 
=== Authors and collaborators ===
 
=== Authors and collaborators ===
  
 +
*[mailto:barronh@ufl.edu Barron Henderson] ''(University of Florida)''
 
*[mailto:mat.evans@york.ac.uk Mat Evans] ''(U. York)''
 
*[mailto:mat.evans@york.ac.uk Mat Evans] ''(U. York)''
 
*[mailto:jingqium@princeton.edu Jingqiu Mao] ''(Princeton/NOAA GFDL)''
 
*[mailto:jingqium@princeton.edu Jingqiu Mao] ''(Princeton/NOAA GFDL)''
  
 
== Source code and data ==
 
== Source code and data ==
 
The code is freely available although support is limited!
 
 
*[ DSMACC Code Repository (to be updated)]
 
*[https://sites.google.com/site/dsmaccmanual DSMACC Manual]
 
  
 
DSMACC code developed for GEOS-Chem can be found here:
 
DSMACC code developed for GEOS-Chem can be found here:

Revision as of 15:48, 25 October 2013

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

Source code and data

DSMACC code developed for GEOS-Chem can be found here:

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.