Skip to content

tolenius/ACDC

Repository files navigation

Atmospheric Cluster Dynamics Code

Atmospheric Cluster Dynamics Code, also known as ACDC, is a tool for studying the very first steps of atmospheric new particle formation from gas-phase molecules. ACDC simulates the dynamics of molecular cluster and small nanoparticle populations by generating and solving the cluster birth-death equations for given ambient conditions, yielding the time evolution of cluster concentrations and formation rates.

ACDC can be applied to

  • Simulate cluster formation from different chemical compounds using quantum chemical input data
  • Study the details of cluster growth processes by, for example, tracking the growth pathways in simulations
  • Evaluate experimental methods to interpret measured molecular cluster data by generating synthetic test data
  • Generate nanoparticle formation rate data to be used in large-scale models

This repository contains the cluster equation generator, which is the core of ACDC, as well as ready-made templates for easy conducting of standard simulations. Detailed information on all available features can be found in the technical manual, and the quick guide provides the essentials to consider when applying the model on a given set of molecular clusters. The most recent version of the equation generator (and the manual) is available above, and can be applied to utilize newly-added features. Updated versions are always compatible with the standard Matlab and Fortran distributions.

Note 1 Please note that ACDC is a kinetic model, and does not contain assumptions on the thermodynamic properties of the simulated clusters. Instead, the thermodynamic data is given as input to ACDC. Recent data for clusters of different chemical compositions can be found, for example, in the Atmospheric Cluster Database (ACDB).

Note 2 Also note that the initial formation of ~1-2 nm aerosol particles is generally characterized by steady-state formation rates which involves specific assumptions. It is also possible to simulate the initial particle formation dynamics and their effects on aerosol size distributions explicitly by a direct coupling of cluster and aerosol models instead of using steady-state rates. For this, use the ClusterIn plugin.

Citation

If you use the codes provided in this repository in any study, please cite at least one of the following works:

License

This project is licensed under the terms of the GNU General Public License v3.0, as provided with this repository.

Note that the repository contains a few individual functions or routines by other authors. For each such function, the original license or acknowledgement is found in the same folder where the function source code is located and must not be separated from the source code.

References

The following freely available functions and routines are used in some of the standard ACDC set-ups:

Matlab functions

All functions are available in the Matlab File Exchange (https://se.mathworks.com/matlabcentral/fileexchange/).

arrow.m
Erik Johnson (2020). arrow (https://www.mathworks.com/matlabcentral/fileexchange/278-arrow), MATLAB Central File Exchange. Retrieved October 29, 2020.

axesLabelsAlign3D.m
Matthew Arthington (2020). Align axes labels in 3D plot (https://www.mathworks.com/matlabcentral/fileexchange/27450-align-axes-labels-in-3d-plot), MATLAB Central File Exchange. Retrieved October 29, 2020.

makeColorMap.m
Doug Hull (2020). MakeColorMap (https://www.mathworks.com/matlabcentral/fileexchange/17552-makecolormap), MATLAB Central File Exchange. Retrieved October 29, 2020.

Fortran routines

dvode.f
The VODE solver for ordinary differential equation systems, Lawrence Livermore National Laboratory (https://computing.llnl.gov/casc/odepack/).
Brown, P. N., Byrne, G. D., and Hindmarsh, A. C.: VODE, a variable-coefficient ODE solver, SIAM J. Sci. Stat. Comput. 10, 1038-1051 (1989), https://doi.org/10.1137/0910062.

Prerequisites

In order to use ACDC (on either Windows or Unix), the following software must be installed:

  • Perl
  • Either Matlab or Fortran

Note that some features, such as the growth pathway tracking, are available only in the Matlab version.

Authors

Code developer: Tinja Olenius (tinja.olenius@alumni.helsinki.fi)

About

Atmospheric Cluster Dynamics Code

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published