RASM Simulation Naming Convention 
---------------------------------

THE FOLLOWING NAMING CONVENTION MUST BE FOLLOWED IN SETTING RASM CASE NAMES:

1.  Include the tag name in the case name so that the complete model
configuration can be tracked.  Hence collapse RASM1_0_15 to R1015, for example.

2.  Follow this with lower case alphabetic letter indicating the resolutions (vertical and horizontal) of models:

a - w5a_a94, 50km atmosphere-land, 9km ice-ocean, 45 levels ocean (RB,RBR,RIR,RFR)
b - w5a_a94a, 50km atmosphere-land, 9km ice-ocean, 60 levels ocean (RB,RBR,RIR,RFR)
c - w5a_w5a, 50km atmosphere-land (RI)
d - a93_a93_rx1, 9km ice-ocean, 45 levels ocean, 1deg. runoff  (G)
e - a93a_a93a_rx1, 9km ice-ocean, 60 levels ocean, 1deg. runoff (G) 
f - a93_a93, 9km ice-ocean, 45 levels ocean (H)
g - a93a_a93a, 9km ice-ocean, 60 levels ocean (H)
h - a93_a23_rx1, 2km ice-ocean, 45 levels ocean, 1deg. runoff (G)
i - a93a_a23a_rx1, 2km ice-ocean, 60 levels ocean, 1deg. runoff (G) (not supported yet)
j - a93_a23, 2km ice-ocean, 45 levels ocean (H) 
k - a93a_a23a, 2km ice-ocean, 60 levels ocean (H) (not supported yet)
l - w2b_a94, 25km atmosphere-land, 9km ice-ocean, 45 levels ocean (RB,RBR,RIR,RFR)
m - w2b_a94a, 25km atmosphere-land, 9km ice-ocean, 60 levels ocean (RB,RBR,RIR,RFR)
n - w2b_w2b, 25km atmosphere-land (RI)
o - w2b_a24, 25km atmosphere-land, 2km ice-ocean, 45 levels ocean (RB,RBR,RIR,RFR)
p - w2b_a24a, 25km atmosphere-land, 2km ice-ocean, 60 levels ocean (RB,RBR,RIR,RFR)
r - TL319_a93, 9km ice-ocean, 45 levels ocean, TL319 reanalysis (G)

3.  Next the precise configuration of RB, G or RBR case, for example.  
Hence the RASM1_0_15 fully coupled simulation with 45 levels ocean would now have the prefix R1015aRBR.

4.  Then include the precise details of the model simulation as four lower
case alphabetical letters.  The first letter will tell you which group ran
the simulation:

a - University of Colorado, Boulder
b - University of Washington
c - Naval Postgraduate School
d - Iowa State University
e - University of Arizona
f - Los Alamos National Laboratory
g - University of California, Santa Cruz
h - University of Alaska, Fairbanks
..
..
x - special letter reserved only Tony Craig

5. The next three lower case letters will be referenced to a lookup table,
which should be committed to the repository for safe keeping in a text
file, with a separate text file for each tag located in the trunk under a
directory rasm/trunk/scripts/rasm_utils/Docs/Run_Key. For example, runs with
the RASM tag rasm1_0_15 are added to the text log file RASM1015.txt in the 
following way:

Simulation:  R1015aRBRcaaa01a
Description: Baseline simulation of RASM1_0_15 out of the box
Machine:     Spirit
POC:         Andrew Roberts
Completed:   1979-09 to 1988-04

KEY ELEMENTS OF THE THREE LETTER CODE THAT MUST BE FOLLOWED:

First two letters of three letter code must be unique for the physics or chemistry
being tested or the experiment. Please check that your preferred two letter code 
has not been used already by another group in the relevant log file.

The third letter of three letter code is a run designator for the test or 
experiment in question.  For example, one might be testing sensitivity to a 
particular parameter, let's say labeled with the first two letters of the three
letter code as simulation "ca".  Then the last letter is reserved for changes 
to that parameter. Hence a series of simulations changing that parameter to 
different values will be caa, cab, cac, etc.
 
PLEASE CHECK THE RELEVANT RUN LOG FILE TO MAKE SURE THAT THE TWO LETTER EXPERIMENT
DESIGNATOR HAS NOT ALREADY BEEN USED, AND IF YOU ARE CONTINUING A SERIES OF 
EXPERIMENTS, THAT YOUR FINAL LETTER IS IN SEQUENCE AND HAS NOT ALREADY BEEN USED.

6. Finally, the case name will have two numbers and a letter suffix, indicating 
the ensemble member, followed by letters indicating the boundary conditions for WRF
or atmospheric data forcing for H or G:

a - ERA-Interim
b - CFSR
c - CESM
d - CORE2
e - Sheffield
f - JRA55
g - CRUNCEP

Hence a case name for RASM1_0_15, fully coupled model out of the box, run
by Andrew Roberts at NPS, with two ensemble members, one from ERA-Interim,
the other from CFSR, could have the following nomenclature:

R1015aRBRcaaa01a, R1015aRBRcaaa01b

and would be accompanied by documentation in the file 
trunk/scripts/rasm_utils/Docs/Run_Key/RASM1015.txt
as detailed in the example above.

Please be sure to commit this to the repository as soon as you start the case running, 
and be sure to check the log file before you set up a new case. Please be sure to 
archive all simulations to tape on HPCMP machines using the long_archive.pl script 
located in the RASM repository under:
trunk/scripts/rasm_utils/Post_processing/archiving


Andrew Roberts
December 8, 2014

Robert Osinski
January 5, 2016

Naval Postgraduate School