Regridding Restarts for Icarus 2.0: Difference between revisions

(2 intermediate revisions by the same user not shown)

Line 1:

Here are basic instructions on how to create restart files for Icarus 1.0. '''Due to changes in the tiling it is not possible to use restarts from older versions of GEOS-5 without converting them with the <code>regrid.pl</code> script.'''

Here are basic instructions on how to create restart files for Icarus 2.0. '''Due to changes in the tiling it is not possible to use restarts from older versions of GEOS-5 without converting them with the <code>regrid.pl</code> script.'''

'''Back to [[GEOS-5 Documentation for Icarus 1.0]]'''

'''Back to [[GEOS-5 Documentation for Icarus 2.0]]'''

==Using the <code>regrid.pl</code> Script ==

Restarts can be easily created from MERRA2 data or other model-generated sources using the <code>regrid.pl</code> script in <code>Linux/bin/</code> (above <code>src/</code>) -- this script is different from, and is specifically a wrapper for, the <code>regrid</code> script used in earlier versions. The <code>regrid.pl</code> script is created when <code>make install</code> is run. You might have to update the <code>regrid.pl</code> script by going to <code>src/GMAO_Shared/GEOS_Util/post</code>, running <code>cvs upd -r HEAD regrid.pl</code>, and running <code>make install</code>. The same script can regrid restarts between different versions of Fortuna 1.4 to Icarus 1.0 at any resolution.

Restarts can be easily created from MERRA2 data or other model-generated sources using the <code>regrid.pl</code> script in <code>Linux/bin/</code> (above <code>src/</code>) -- this script is different from, and is specifically a wrapper for, the <code>regrid</code> script used in earlier versions. The <code>regrid.pl</code> script is created when <code>make install</code> is run. You might have to update the <code>regrid.pl</code> script by going to <code>src/GMAO_Shared/GEOS_Util/post</code>, running <code>cvs upd -r HEAD regrid.pl</code>, and running <code>make install</code>. The same script can regrid restarts between different versions of Fortuna 1.4 to Icarus 2.0 at any resolution.

Running <code>regrid.pl -h</code> (after running <code>source g5_modules</code>) -- with the <code>-h</code> for help -- tells the story:

Line 53:

OTHER OPTIONS

-levsout levsout number of atmosphere levels in output

-oceanin oceanIN ocean horizontal grid of inputs

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

Line 81:

Line 82:

Not valid for tags prior to Heracles; Note: This option will add

10-20 minutes to the regrid process.

-route write the route_internal_rst

-[no]bkg copy and rename input bkg + satbang/bias files

Line 88:

Line 90:

-grpid group id; sponsor code to use for batch job charge

-qos debug use SBATCH --qos=debug directive for batch jobs,

if job meets --qos=debug requirements

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

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

Line 128:

Line 132:

G20 : Ganymed-2_0 ............ Ganymed-2_1_p6

G30 : Ganymed-3_0 ............ Ganymed-3_0_p1

G40 : Ganymed-4_0 ............ Heracles-~~4_0~~

G40 : Ganymed-4_0 ............ Heracles-5_4_p3

HNL : Heracles-NL ............ Heracles-NL

Line 140:

Line 144:

5A0 : GEOSadas-5_10_0 ........ GEOSadas-5_10_0_p1

5B0 : GEOSadas-5_10_0_p2 ..... GEOSadas-5_11_0

512 : GEOSadas-5_12_2 ........ GEOSadas-~~5_13_1~~

512 : GEOSadas-5_12_2 ........ GEOSadas-5_16_5

~~AUTHOR~~

~~Joe Stassi, SSAI (joe.stassi@nasa.gov)~~

</pre>

Line 154:

Line 155:

The above presents the minimum options to get a working set of restarts -- anything lacking will be requested interactively. Your selections will be presented for your review before the script does any heavy lifting. The script may appear to stall while it waits for the relevant MERRA or MERRA-2 files to be retrieved from the <code>/archive</code> filesystem.

For sources other than MERRA/MERRA-2, you will have to specify the location of a regrid resource file that contains the model version, resolution and location of the source restarts, and the resolution of the output restarts. A sample regrid resource file is <code>regrid.rc</code> in the same directory as the <code>regrid</code> script. Note that <code>regrid</code> only works for creating restarts for its model tag, and does not work at all for making restarts for tags before Icarus 1.0. Restarts for earlier model tags have to be created "manually".

For sources other than MERRA/MERRA-2, you will have to specify the location of a regrid resource file that contains the model version, resolution and location of the source restarts, and the resolution of the output restarts. A sample regrid resource file is <code>regrid.rc</code> in the same directory as the <code>regrid</code> script. Note that <code>regrid</code> only works for creating restarts for its model tag, and does not work at all for making restarts for tags before Icarus 2.0. Restarts for earlier model tags have to be created "manually".

== Renaming Restart Files ==

Line 220:

Line 221:

* <code>catch_internal_rst</code>, <code>lake_internal_rst</code>, <code>landice_internal_rst</code>, and <code>saltwater_internal_rst</code> must be re-gridded due to new land surface tile data

* All other restarts from earlier versions should be boot-strapped.

<!--

== Where to Find MERRA Restarts ==

Line 402:

Line 405:

This will have the effect that when the model starts, it will look for that restart file and use it if it finds it, and will otherwise bootstrap the restart file. Running the model for a model day using this modified <code>AGCM.rc</code> will produce a full set of restart files, which can be used with the default model configuration.

'''Back to [[GEOS-5 Documentation for Icarus 1.0]]'''

-->

'''Back to [[GEOS-5 Documentation for Icarus 2.0]]'''

@@ Line 1: / Line 1: @@
-Here are basic instructions on how to create restart files for Icarus 1.0.  '''Due to changes in the tiling it is not possible to use restarts from older versions of GEOS-5 without converting them with the <code>regrid.pl</code> script.'''
+Here are basic instructions on how to create restart files for Icarus 2.0.  '''Due to changes in the tiling it is not possible to use restarts from older versions of GEOS-5 without converting them with the <code>regrid.pl</code> script.'''
-'''Back to [[GEOS-5 Documentation for Icarus 1.0]]'''
+'''Back to [[GEOS-5 Documentation for Icarus 2.0]]'''
 ==Using the <code>regrid.pl</code> Script ==
-Restarts can be easily created from MERRA2 data or other model-generated sources using the <code>regrid.pl</code> script in <code>Linux/bin/</code> (above <code>src/</code>) -- this script is different from, and is specifically a wrapper for, the <code>regrid</code> script used in earlier versions.  The <code>regrid.pl</code> script is created when <code>make install</code> is run.  You might have to update the <code>regrid.pl</code> script by going to <code>src/GMAO_Shared/GEOS_Util/post</code>, running <code>cvs upd -r HEAD regrid.pl</code>, and running <code>make install</code>. The same script can regrid restarts between different versions of Fortuna 1.4 to Icarus 1.0 at any resolution.
+Restarts can be easily created from MERRA2 data or other model-generated sources using the <code>regrid.pl</code> script in <code>Linux/bin/</code> (above <code>src/</code>) -- this script is different from, and is specifically a wrapper for, the <code>regrid</code> script used in earlier versions.  The <code>regrid.pl</code> script is created when <code>make install</code> is run.  You might have to update the <code>regrid.pl</code> script by going to <code>src/GMAO_Shared/GEOS_Util/post</code>, running <code>cvs upd -r HEAD regrid.pl</code>, and running <code>make install</code>. The same script can regrid restarts between different versions of Fortuna 1.4 to Icarus 2.0 at any resolution.
 Running <code>regrid.pl -h</code> (after running <code>source g5_modules</code>) -- with the  <code>-h</code> for help -- tells the story:
@@ Line 53: / Line 53: @@
 OTHER OPTIONS
+   -levsout  levsout  number of atmosphere levels in output
     -oceanin  oceanIN  ocean horizontal grid of inputs
                        =c : 1-deg (360x180); e.g. Reynolds
@@ Line 81: / Line 82: @@
                        Not valid for tags prior to Heracles; Note: This option will add
 -20 minutes to the regrid process.
+   -route             write the route_internal_rst
     -[no]bkg           copy and rename input bkg + satbang/bias files
@@ Line 88: / Line 90: @@
     -grpid             group id; sponsor code to use for batch job charge
+   -qos debug         use SBATCH --qos=debug directive for batch jobs,
+                      if job meets --qos=debug requirements
     -db                (debug mode) Do not clean work directory after running programs;
     -dbh               (debug hash) Show contents of hashes: %IN and %OUT
@@ Line 128: / Line 132: @@
        G20  : Ganymed-2_0  ............  Ganymed-2_1_p6
        G30  : Ganymed-3_0  ............  Ganymed-3_0_p1
-       G40  : Ganymed-4_0  ............  Heracles-4_0
+       G40  : Ganymed-4_0  ............  Heracles-5_4_p3
        HNL  : Heracles-NL  ............  Heracles-NL
@@ Line 140: / Line 144: @@
 A0  : GEOSadas-5_10_0  ........  GEOSadas-5_10_0_p1
 B0  : GEOSadas-5_10_0_p2  .....  GEOSadas-5_11_0
-  : GEOSadas-5_12_2  ........  GEOSadas-5_13_1
+  : GEOSadas-5_12_2  ........  GEOSadas-5_16_5
-AUTHOR
-   Joe Stassi, SSAI (joe.stassi@nasa.gov)
 </pre>
@@ Line 154: / Line 155: @@
 The above presents the minimum options to get a working set of restarts -- anything lacking will be requested interactively.  Your selections will be presented for your review before the script does any heavy lifting.  The script may appear to stall while it waits for the relevant MERRA or MERRA-2 files to be retrieved from the <code>/archive</code> filesystem.
-For sources other than MERRA/MERRA-2, you will have to specify the location of a regrid resource file that contains the model version, resolution and location of the source restarts, and the resolution of the output restarts.  A sample regrid resource file is <code>regrid.rc</code> in the same directory as the <code>regrid</code> script.  Note that  <code>regrid</code> only works for creating restarts for its model tag, and does not work at all for making restarts for tags before Icarus 1.0.  Restarts for earlier model tags have to be created "manually".
+For sources other than MERRA/MERRA-2, you will have to specify the location of a regrid resource file that contains the model version, resolution and location of the source restarts, and the resolution of the output restarts.  A sample regrid resource file is <code>regrid.rc</code> in the same directory as the <code>regrid</code> script.  Note that  <code>regrid</code> only works for creating restarts for its model tag, and does not work at all for making restarts for tags before Icarus 2.0.  Restarts for earlier model tags have to be created "manually".
 == Renaming Restart Files ==
@@ Line 220: / Line 221: @@
 * <code>catch_internal_rst</code>, <code>lake_internal_rst</code>, <code>landice_internal_rst</code>, and <code>saltwater_internal_rst</code> must be re-gridded due to new land surface tile data
 * All other restarts from earlier versions should be boot-strapped.
+<!--
 == Where to Find MERRA Restarts ==
@@ Line 402: / Line 405: @@
 This will have the effect that when the model starts, it will look for that restart file and use it if it finds it, and will otherwise bootstrap the restart file.  Running the model for a model day using this modified <code>AGCM.rc</code> will produce a full set of restart files, which can be used with the default model configuration.
-'''Back to [[GEOS-5 Documentation for Icarus 1.0]]'''
+-->
+'''Back to [[GEOS-5 Documentation for Icarus 2.0]]'''