Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Next »

Creating a new ACME compset is a relatively straightforward process in most cases.  This page will walk you through the process so that you can create compsets for your model configurations as needed.

Why create a compset for your model configuration?

  • Creates an unambiguously defined version of your configuration.
  • Reduces the potential for user error, because fewer options (namelist settings, configuration options) are specified via runscript or command-line options.
  • Allows automated testing (optionally including nightly regression testing) to be performed for your configuration.

Prerequisites and needed information

Before you begin, please check that you have the following prerequisites:

  • Everything necessary to specify your configuration can be specified via a compile-time option or a namelist option.

Locations of important files

cime/scripts/Tools/config_compsets.xml : most of the specification of the compset is done in this file.

... <others> ...

How to add a compset, step-by-step

  1. Identify a compset similar to your desired new compset, which will be your starting point for making changes.
  2. Collect a list of all non-default namelist options, input files, and compile options that are needed to fully specify your configuration.  These will include any changes relative to your baseline compset identified in the previous step.
    1. Note: if your configuration requires a user-provided atmospheric chemistry mechanism, please run the stand-alone chemistry pre-processor and add the auto-generated code to the model first before adding a compset.  The reason for doing this is that the chemistry pre-processor does not build smoothly on all systems, which will prevent your compset from running smoothly on many systems.
  3. Edit the file cime/scripts/Tools/config_compsets.xml
    1. If your configuration requires providing compile-time options to cam (specified via CAM_CONFIG_OPTS), create a new CAM_CONFIG_OPTS specification, e.g.:

      1. <CAM_CONFIG_OPTS compset="_CAM5%ATMMOD"   >-clubb_sgs -microphys mg2 -chem linoz_mam4_resus_mom -rain_evap_to_coarse_aero</CAM_CONFIG_OPTS>

    2. Copy and edit the definition of the compset's full name, short name and alias:
      1. Example compset name, short name, and alias : <COMPSET sname="F_2000_CAM5"                alias="FC5"             >2000_CAM5_CLM40%SP_CICE%PRES_DOCN%DOM_RTM_SGLC_SWAV</COMPSET>
    3.  

       

       

 

Links to more information

 

  • No labels