Skip to content

Running the E3SM Single Column Model

Jump to bottom
Peter Bogenschutz edited this page Feb 7, 2024 · 16 revisions

Scripts

To obtain scripts to run the E3SM SCM please:

  1. clone The E3SM-Project/scmlib repo.
  2. Find the SCM scripts in the top level directory named E3SM_SCM_scripts.

Simply select your desired case and modify the required input in the header in the "USER DEFINED SETTINGS" (relating to the machine you are using and output paths etc.).

Hint: If you know you will be running several cases you may simply edit the run_e3sm_scm_TEMPLATE.csh script then execute the generate_scmscripts.csh script. All your directory path and user specific information will then propagate to all the scripts.

Code

You should be running with one of the following three options:

  1. Most current master of E3SM
  2. E3SM v1 official release code
  3. E3SM v2 official release code

The scripts are only supported for these three options. If running an older master code version (say a development code in between v1 and v2), then the scripts may not work as designed and there will be some work on your end to get them running.

IMPORTANT UPDATE 02/07/2024 We have identified that the SCM scripts are currently NOT compatible with E3SM master. We are currently working on updates that will get the SCM functional with master (and hence E3SMv3). This page (and scripts) will be updated once the pull request has been pushed to E3SM master. Until this issue is resolved we suggest running SCM with E3SMv2 (with maint-2.1 branch).

Input Data

All required input data is pre-installed on supported (or commonly run) E3SM machines in addition to the E3SM input data server. Therefore, you should be able to run the E3SM SCM out-of-the-box on any machine E3SM is commonly run on.

Add a Case

This site contains a case library with many cases for the user to choose from. Should you have a case you would like to run that is not included in this library, we recommend starting with one of the run scripts for a verified case as a template. The case specific information of the script that will need to be changed are: 1) the IOP file, 2) Aerosol specification type (either constant droplet, observed aerosols, or prescribed aerosols), and 3) directly below "END USER DEFINED SETTINGS" the block of the script entitled "Case specific information kept here" will need to be modified for the specific case.

When you have a case working that you are willing to share with the community, let us know!

Clone this wiki locally