CESM Experiment Case Name Convention

Updated: 20 May 2011

CSEG requests your cooperation in helping standardize CESM experiment case names. We ask that you use the following standardized convention for your experiment case names as we move forward.

These case names should be used for any experiments that meet one of the following requirements

  • Are added to the the CESM runs data base
  • Have runs scripts in a shared CESM runs dir (at NCAR: /glade/proj3/cseg/runs)
  • Archive output in a shared CESM archive location (at NCAR: hpss:/CCSM)

In the future, CSEG will add the functionality to create_newcase script to auto-generate case names conforming to this convention. Until then, we ask that you create conforming case names manually when using the create_newcase script.


The convention is:

<compset char>.<code base>.<compset shortname>.<res shortname>[.opt_desc_string].<nnn>[opt_char]

The period character "." is reserved for delineating and parsing components of the case name.

  • <compset char> is a single character, the first letter of the compset, lower case
  • <code base> is "e10" for cesm1.0, "c40" for ccsm4.0, "c35" for ccsm3.5
  • <compset shortname> is the compset shortname recognized by create_newcase
  • <res shortname> is the resolution shortname recognized by create_newcase
  • [.opt_desc_string] is an OPTIONAL descriptive string; the only constraint is that it must not contain a "." While this string is largely unconstrained, CSEG strongly encourages users to either create a very short string (eg. eight characters or less) or avoid using it altogether
  • <nnn> is a 3 digit number, the smallest number that results in a unique case name
  • [opt_char] is an OPTIONAL single lower-case letter {a,b,...,z}, normally not used, but is allowed to denote a group of cases that are very closely related. Those cases would then have identical case names except for this single character suffix



CSEG also requests your cooperation in reserving the use of the following archive locations

  • For experiments that are likely to be of interest to the broader CESM community use
    • hpss:/CCSM/csm
  • For experiments that are likely to be of interest to only one specific working group use that specific hpss directory
    • hpss:/CCSM/bgcwg
    • hpss:/CCSM/paleo
    • hpss:/CCSM/wawg
    • hpss:/CCSM/<working group>
  • For experiments that are only of interest to yourself use your home directory
    • hpss:/home/<user>