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
- Collect a list of all non-default namelist options, input files, and compile options that are needed to fully specify your configuration.
- 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.
- Edit the file cime/scripts/Tools/config_compsets.xml