Regridding Restarts for Heracles 5.1: Difference between revisions

Line 12:

<pre>

~~Linux/bin> regrid.pl -h~~

NAME

Line 44:

Line 41:

REQUIRED OPTION FOR MERRA INPUTS

-merra get input restarts from OPS MERRA data archives

-merra (same as -merra1)

-merra1 get input restarts from OPS MERRA-1 data archives

-merra2 get input restarts from OPS MERRA-2 data archives

REQUIRED OPTIONS FOR NON-MERRA INPUTS

Line 57:

Line 56:

-oceanin oceanIN ocean horizontal grid of inputs

=c : 1-deg (360x180); e.g. Reynolds

=e : 1/4-deg (1440x720); e.g. MERRA-2

=f : 1/8-deg (2880x1440); e.g. OSTIA

~~defaults to 'f' if tagIN ends with '_m2' or '_D';~~

defaults to 'c'

~~otherwise,~~ defaults to 'c'

-oceanout oceanOUT ocean horizontal grid of outputs (see -oceanIN)

-esmabin ESMABIN location of build's scripts and programs; defaults to location

of regrid.pl script

-iceDT dtime datetime for alternate landice rst input if regridding to

'Ganymed-2_0' from earlier tag; dtime should have the

following format: -iceDT yyyymmdd_hh

if dtime is not provided or if no restarts can be found to

match dtime, then script will prompt user from list of

available datetimes.

if dtime eq '0', then alternate landice rst will not be used

-newid newid label to replace expid in output restart names;

defaults to 'n-expid' where n is OUTPUT atmosphere grid ID

-tagin tagIN GCM ~~boundary condition~~ tag ~~for~~ inputs (see ~~BCS~~ TAGS below);

-tagin tagIN GCM or DAS tag associated with inputs (see TAGS below);

defaults to ~~Fortuna~~-~~2_1~~

defaults to Ganymed-4_0

-tagout tagOUT GCM ~~boundary condition~~ tag ~~for~~ outputs (see ~~BCS~~ TAGS below);

-tagout tagOUT GCM or DAS tag associated with outputs (see TAGS below);

defaults to Ganymed-~~1_0_M if oceanIN eq 'c';~~

defaults to Ganymed-4_0

~~defaults to Ganymed-1_0_D if oceanIN eq 'f'~~

-rs flag flag indicating which restarts to regrid

=1 for upper-air restarts only

Line 82:

Line 87:

-np no prompt; take defaults for all prompts

-db (debug mode) Do not clean work directory after running programs;

-dbh (debug hash) Show contents of hashes: %IN~~, %MID1, %MID2,~~ and %OUT

-dbh (debug hash) Show contents of hashes: %IN and %OUT

-v verbose mode

-h[elp] print usage message

Line 102:

Line 107:

cubed-sphere grids

------------------

Cn, where n = {48, 90, 180, 360, 500, 720, 1000, 1440, 2000, 2880}

Cn, where n = {24, 48, 90, 180, 360, 500, 720, 1000, 1440, 2000, 2880}

Ocean Horizontal Grids

======================

c = 1-deg (360x180); e.g. Reynolds

e = 1/4-deg (1440x720) ; e.g. MERRA-2

f = 1/8-deg (2880x1440); e.g. OSTIA

~~BCS~~ TAGS

@@ Line 12: / Line 12: @@
 <pre>
-Linux/bin> regrid.pl -h
 NAME
@@ Line 44: / Line 41: @@
 REQUIRED OPTION FOR MERRA INPUTS
-    -merra             get input restarts from OPS MERRA data archives
+    -merra             (same as -merra1)
+   -merra1            get input restarts from OPS MERRA-1 data archives
+   -merra2            get input restarts from OPS MERRA-2 data archives
 REQUIRED OPTIONS FOR NON-MERRA INPUTS
@@ Line 57: / Line 56: @@
     -oceanin  oceanIN  ocean horizontal grid of inputs
                        =c : 1-deg (360x180); e.g. Reynolds
+                      =e : 1/4-deg (1440x720); e.g. MERRA-2
                        =f : 1/8-deg (2880x1440); e.g. OSTIA
-                       defaults to 'f' if tagIN ends with '_m2' or '_D';
+                       defaults to 'c'
-                      otherwise, defaults to 'c'
     -oceanout oceanOUT ocean horizontal grid of outputs (see -oceanIN)
     -esmabin  ESMABIN  location of build's scripts and programs; defaults to location
                        of regrid.pl script
+   -iceDT     dtime   datetime for alternate landice rst input if regridding to
+                      'Ganymed-2_0' from earlier tag; dtime should have the
+                      following format: -iceDT yyyymmdd_hh
+                      if dtime is not provided or if no restarts can be found to
+                      match dtime, then script will prompt user from list of
+                      available datetimes.
+                      if dtime eq '0', then alternate landice rst will not be used
     -newid    newid    label to replace expid in output restart names;
                        defaults to 'n-expid' where n is OUTPUT atmosphere grid ID
-    -tagin    tagIN    GCM boundary condition tag for inputs (see BCS TAGS below);
+    -tagin    tagIN    GCM or DAS tag associated with inputs (see TAGS below);
-                       defaults to Fortuna-2_1
+                       defaults to Ganymed-4_0
-    -tagout   tagOUT   GCM boundary condition tag for outputs (see BCS TAGS below);
+    -tagout   tagOUT   GCM or DAS tag associated with outputs (see TAGS below);
-                       defaults to Ganymed-1_0_M if oceanIN eq 'c';
+                       defaults to Ganymed-4_0
-                      defaults to Ganymed-1_0_D if oceanIN eq 'f'
     -rs       flag     flag indicating which restarts to regrid
                        =1 for upper-air restarts only
@@ Line 82: / Line 87: @@
     -np                no prompt; take defaults for all prompts
     -db                (debug mode) Do not clean work directory after running programs;
-    -dbh               (debug hash) Show contents of hashes: %IN, %MID1, %MID2, and %OUT
+    -dbh               (debug hash) Show contents of hashes: %IN and %OUT
     -v                 verbose mode
     -h[elp]            print usage message
@@ Line 102: / Line 107: @@
     cubed-sphere grids
     ------------------
-    Cn, where n = {48, 90, 180, 360, 500, 720, 1000, 1440, 2000, 2880}
+    Cn, where n = {24, 48, 90, 180, 360, 500, 720, 1000, 1440, 2000, 2880}
     Ocean Horizontal Grids
     ======================
     c = 1-deg   (360x180);   e.g. Reynolds
+   e = 1/4-deg (1440x720) ; e.g. MERRA-2
     f = 1/8-deg (2880x1440); e.g. OSTIA
-BCS TAGS
+TAGS
-    Use GCM tag names with -tagin and -tagout flags
+    Use GCM or DAS tag names with -tagin and -tagout flags
+      Sample GCM tags
+      ---------------
+      F14  : Fortuna-1_4  ............  Fortuna-1_4_p1
+      F21  : Fortuna-2_1  ............  Fortuna-2_5_pp2
+      G10  : Ganymed-1_0  ............  Ganymed-1_0_BETA4
+      G10p : Ganymed-1_0_p1  .........  Ganymed-1_0_p6
+      G20  : Ganymed-2_0  ............  Ganymed-2_1_p6
+      G30  : Ganymed-3_0  ............  Ganymed-3_0_p1
+      G40  : Ganymed-4_0  ............  Heracles-4_0
-       GCM Tag                DAS Tag (GCM tag version first appears)
+       Sample DAS tags
-       -------                ---------------------------------------
+       ---------------
-       Ganymed-1_0_D          GEOSadas with Date-Driven Great_Lakes
+  : GEOSdas-2_1_4  ..........  GEOSdas-2_1_4-m4
-       Ganymed-1_0_M          GEOSadas with with Model-Based Great_Lakes
+  : GEOSadas-5_4_0  .........  GEOSadas-5_5_3
-       Ganymed-1_0_m2         GEOSadas-5_9_0 with Date-Driven Great_Lakes
+  : GEOSadas-5_6_1  .........  GEOSadas-5_7_3_p2
-       Ganymed-1_0_m1         GEOSadas-5_9_0 with Model-Based Great_Lakes
+  : GEOSadas-5_8_0  .........  GEOSadas-5_9_1
-       Ganymed-1_0            GEOSadas-5_8_0
+p : GEOSadas-5_9_1_p1  ......  GEOSadas-5_9_1_p9
-       Fortuna-2_1            GEOSadas-5_6_1
+A0  : GEOSadas-5_10_0  ........  GEOSadas-5_10_0_p1
-       Fortuna-2_0            n/a
+B0  : GEOSadas-5_10_0_p2  .....  GEOSadas-5_11_0
-      Fortuna-1_5            n/a
+  : GEOSadas-5_12_2  ........  GEOSadas-5_13_1
-      Fortuna-1_4 (MERRA)    GEOSadas-5_4_0
 AUTHOR
-    Joe Stassi, SAIC
+    Joe Stassi, SAIC (joe.stassi@nasa.gov)
-Linux/bin>
 </pre>