CAMP: Chemistry Across Multiple Phases

https://open-atmos.org/camp/

The full CAMP documentation, including the BootCAMP tutorial is available here.

References:

• M. Dawson, C. Guzman, J. H. Curtis, M. Acosta, S. Zhu, D. Dabdub, A. Conley, M. West, N. Riemer, and O. Jorba (2021), Chemistry Across Multiple Phases (CAMP) version 1.0: An Integrated multi-phase chemistry model, in preparation

Copyright (C) 2017–2021 Barcelona Supercomputing Center and the University of Illinois at Urbana–Champaign

This is the fastest way to get running.

• Step 1: Install Docker Community Edition.

  • On Linux and MacOS this is straightforward. Download from here.
  • On Windows the best version is Docker Community Edition for Windows, which requires Windows 10 Pro/Edu.

• Step 2: Run the CAMP test suite with:

docker run -it --rm ghcr.io/open-atmos/camp:main bash -c 'cd /build; make test'

Required dependencies:

• Fortran 2008 compiler - https://gcc.gnu.org/fortran/ or similar
• CMake version 2.6.4 or higher - https://www.cmake.org/
• json-fortran for JSON input file support - https://github.com/jacobwilliams/json-fortran
• SuiteSparse - https://faculty.cse.tamu.edu/davis/SuiteSparse/SuiteSparse-5.1.0.tar.gz
• A modified version of CVODE 3.1.2 - provided here in cvode-3.4-alpha.tar.gz

Optional dependencies:

• GSL for Jacobian evaluation and random number generators - https://www.gnu.org/software/gsl/

1. Install cmake, json-fortran, SuiteSparse, and CVODE (see above).

2. Unpack CAMP:

    tar xzvf camp-1.0.0.tar.gz
   

3. Change into the main CAMP directory (where this README file is located):

    cd camp-1.0.0
   

4. Make a directory called build and change into it:

    mkdir build
    cd build
   

5. If desired, set environment variables to indicate the install locations of supporting libraries. If running echo $SHELL indicates that you are running bash, then you can do something like:

    export JSON_FORTRAN_HOME=${HOME}/opt
    export SUITE_SPARSE_HOME=${HOME}/opt
    export SUNDIALS_HOME=${HOME}/opt
    export GSL_HOME=${HOME}/opt
   

   Of course the exact directories will depend on where the libraries are installed. You only need to set variables for libraries installed in non-default locations, and only for those libraries you want to use.

   If echo $SHELL instead is tcsh or similar, then the environment variables can be set like setenv NETCDF_HOME / and similarly.

6. Run cmake with the main CAMP directory as an argument (note the double-c):

    ccmake ..
   

7. Inside ccmake press c to configure, edit the values as needed, press c again, then g to generate. Optional libraries can be activated by setting the ENABLE variable to ON. For a parallel build, toggle advanced mode with t and set the CMAKE_Fortran_COMPILER to mpif90, then reconfigure.

8. Optionally, enable compiler warnings by pressing t inside ccmake to enable advanced options and then setting CMAKE_Fortran_FLAGS to:

    -O2 -g -fimplicit-none -W -Wall -Wconversion -Wunderflow -Wimplicit-interface -Wno-compare-reals -Wno-unused -Wno-unused-parameter -Wno-unused-dummy-argument -fbounds-check
   

9. Compile CAMP and test it as follows. Some tests may fail due to bad random initial conditions, so re-run the tests a few times to see if failures persist.

    make
    make test