AtChem, an open source box-model for the Master Chemical Mechanism

Abstract. AtChem is an open source zero-dimensional box-model for atmospheric chemistry. Any general set of chemical reactions can be used with AtChem, but the model was designed specifically for use with the Master Chemical Mechanism (MCM, http://mcm.york.ac.uk/ ). AtChem was initially developed within the EUROCHAMP project as a web application (AtChem-online, https://atchem.leeds.ac.uk/webapp/ ) for modelling environmental chamber experiments; it was recently upgraded and further developed into a standalone offline version (AtChem2) which allows the user to run complex and long simulations, such as those needed for modelling of intensive field campaigns, as well as to perform batch model runs for sensitivity studies. AtChem is installed, set up and configured using semi-automated scripts and simple text configuration files, making it easy to use even for non-experienced users. A key feature of AtChem is that it can easily be constrained to observational data which may have different timescales, thus retaining all the information contained in the observations. Implementation of a continuous integration workflow, coupled with a comprehensive suite of tests and version control software, makes the AtChem codebase robust, reliable and traceable. The AtChem2 code and documentation are available at https://github.com/AtChem/ , under the open source MIT license.

[1]  M. Jenkin,et al.  Evaluation of detailed aromatic mechanisms (MCMv3 and MCMv3.1) against environmental chamber data , 2004 .

[2]  What effect does VOC sampling time have on derived OH reactivity , 2016 .

[3]  R. Derwent,et al.  Atmospheric Chemistry and Physics Protocol for the Development of the Master Chemical Mechanism, Mcm V3 (part B): Tropospheric Degradation of Aromatic Volatile Organic Compounds , 2022 .

[4]  Michael J. Pilling,et al.  Modeling OH, HO2, and RO2 radicals in the marine boundary layer: 1. Model construction and comparison with field measurements , 1999 .

[5]  Chemical evolution of gaseous air pollutants down-wind of tropical megacities: Mexico City case study , 2006 .

[6]  Ian Barnes,et al.  The Essential Role for Laboratory Studies in Atmospheric Chemistry. , 2017, Environmental science & technology.

[7]  H. Dorn,et al.  OH radicals in the boundary layer of the Atlantic Ocean: 1. Measurements by long‐path laser absorption spectroscopy , 2001 .

[8]  K. Emmerson,et al.  Free radical modelling studies during the UK TORCH Campaign in summer 2003 , 2006 .

[9]  A. Ravishankara,et al.  Applicability of the steady state approximation to the interpretation of atmospheric observations of NO3 and N2O5 , 2003 .

[10]  M. Jenkin,et al.  The tropospheric degradation of volatile organic compounds: a protocol for mechanism development , 1997 .

[11]  R. Sommariva,et al.  Measurements of PANs during the New England Air Quality Study 2002 , 2007 .

[12]  A. Lewis,et al.  Atmospheric OH reactivity in central London: observations, model predictions and estimates of in situ ozone production , 2015 .

[13]  R. Long,et al.  HOx chemistry during INTEX-A 2004: Observation, model calculation, and comparison with previous studies , 2008 .

[14]  M. Pilling,et al.  European Geosciences Union 2002 Atmospheric Chemistry and Physics Discussions Protocol for the development of the Master Chemical Mechanism , MCM v 3 ( Part B ) : tropospheric degradation of aromatic volatile organic compounds , 2002 .

[15]  W. Carter.  Computer modeling of environmental chamber measurements of maximum incremental reactivities of volatile organic compounds , 1995 .

[16]  Blas M. Benito,et al.  Documenting, storing, and executing models in Ecology: A conceptual framework and real implementation in a global change monitoring program , 2014, Environ. Model. Softw..

[17]  J. Seinfeld,et al.  Overview of the Second Texas Air Quality Study (TexAQS II) and the Gulf of Mexico Atmospheric Composition and Climate Study (GoMACCS) , 2009 .

[18]  R. Derwent,et al.  Photochemical ozone creation potentials for organic compounds in northwest Europe calculated with a master chemical mechanism , 1998 .

[19]  W. Brune,et al.  A comparison of chemical mechanisms based on TRAMP-2006 field data , 2010 .

[20]  James J. Corbett,et al.  An investigation of the chemistry of ship emission plumes during ITCT 2002 , 2005 .

[21]  C. Sweeney,et al.  High winter ozone pollution from carbonyl photolysis in an oil and gas basin , 2014, Nature.

[22]  H. Dorn,et al.  Evaluation of OH and HO2 concentrations and their budgets during photooxidation of 2-methyl-3-butene-2-ol (MBO) in the atmospheric simulation chamber SAPHIR , 2018, Atmospheric Chemistry and Physics.

[23]  Chih-Chung Chang,et al.  Observation and modelling of OH and HO 2 concentrations in the Pearl River Delta 2006: a missing OH source in a VOC rich atmosphere , 2011 .

[24]  Y. F. Elshorbany,et al.  Evaluation of 1,3,5 trimethylbenzene degradation in the detailed tropospheric chemistry mechanism, MCMv3.1, using environmental chamber data , 2008 .

[25]  E. Atlas,et al.  A study of organic nitrates formation in an urban plume using a Master Chemical Mechanism , 2008 .

[26]  F. Keutsch,et al.  Ozone production chemistry in the presence of urban plumes. , 2016, Faraday discussions.

[27]  A. Ravishankara,et al.  Radicals in the marine boundary layer during NEAQS 2004: a model study of day-time and night-time sources and sinks , 2008 .

[28]  M. Pilling,et al.  Oxidation capacity of Santiago , 2008 .

[29]  R. Derwent,et al.  Photochemical ozone formation in north west Europe and its control , 2003 .

[30]  Darrel C. Ince,et al.  The case for open computer programs , 2012, Nature.

[31]  R. Derwent,et al.  Development of a reduced speciated VOC degradation mechanism for use in ozone models , 2002 .

[32]  Florian A. Potra,et al.  The kinetic preprocessor KPP*/a software environment for solving chemical kinetics , 2002 .