Code Supplement for "Localized injections of interactive volcanic aerosols and their climate impacts in a simple general circulation model"

Code Supplement for "Localized injections of interactive volcanic aerosols and their climate impacts in a simple general circulation model"

=========================================================================

This repository contains scripts used to create the plots from our publication, as well as a run script for building model cases in our configuration using a modified version of E3SMv2, called CLDERA-E3SM. The model code is provided in this respository as the file cldera_e3sm_code.tar. Alternatively, users can access the model code on GitHub at  https://github.com/sandialabs/CLDERA-E3SM (reccommneded).

The data used in conjunction with the plotting scripts in the published manuscript is not included here. However, this data could be generated by using the provided case creation scripts, and following the model configuration specifications as laid out in the publication. For assistance in running the model, contact the corresponding author Joseph Hollowed (hollowed@umich.edu). Both the case creation scripts, and the provided plotting notebooks will require modification by the user to run, especially in replacing hard-coded data and code paths. These codes also depend on various Python packages which will need to be present in the user's environment; see comments and code in the headers of these files for specific details, or contanct the corresponding author.

Included in the case creation script are several namelist settings and instructions for getting started. The employed "compset" is titled FIDEAL, which enables E3SM's idealized physics packages, including the Held-Suarez-Williamson forcing set. Many more relevant namelist settings are available for our idealized volcanic forcing parameterization, which are not explicitly set in this script. To find these, search for the substring "cldera_sai" in the following files within the CLDERA_E3SM code base (found in cldera_e3sm_code.tar, or at the GitHub repository linked above):

components/eam/bld/namelist_files/namelist_definition.xml

components/eam/bld/namelist_files/namelist_defaults_eam.xml

The majority of the volcanic forcing implementation is contained in a single Fortran file, where more information can be found in the form of inline comments:

components/eam/src/physics/cam/cldera_sai_tracers.F90

The subroutines written here interact with the framework of the atmospheric model in several other locations, though the details quickly become technical. For information or assistance, contact the corresponding author (hollowed@umich.edu).