Regridding Restarts for Heracles 5.1: Difference between revisions

Line 5:

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

Restarts can be easily created from ~~MERRA~~ 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 Heracles 5.1 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 Heracles 5.1 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:

<pre>

Line 146:

Line 144:

So the following will create restarts in 2 degree resolution from ~~MERRA~~ on the first day of ~~1990~~ and put them in <code>/discover/nobackup/~~aeichman~~/~~regrid~~</code>:

So the following will create restarts in C180 (roughly equivalent to ½-degree lat-lon) resolution, on the ¼-degree ocean from MERRA2 on the first day of 2012 and put them in <code>/discover/nobackup/mathomp4/Regrid</code>:

./regrid.pl -ymd ~~19900101~~ -hr 21 -grout b -outdir /discover/nobackup/~~aeichman~~/~~regrid~~ -merra -tagout ~~Ganymed~~-~~1_0_M~~ -oceanout c

./regrid.pl -ymd 20120101 -hr 21 -grout C180 -outdir /discover/nobackup/mathomp4/Regrid -merra -tagout Heracles-4_0 -oceanout e

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 files to be retrieved from the <code>/archive</code> filesystem.

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, 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 Heracles 5.1. 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 Heracles 5.1. Restarts for earlier model tags have to be created "manually".

== Renaming Restart Files ==

@@ Line 5: / Line 5: @@
 ==Using the <code>regrid.pl</code> Script ==
-Restarts can be easily created from MERRA 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 Heracles 5.1 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 Heracles 5.1 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:
 <pre>
@@ Line 146: / Line 144: @@
-So the following will create restarts in 2 degree resolution from MERRA on the first day of 1990 and put them in <code>/discover/nobackup/aeichman/regrid</code>:
+So the following will create restarts in C180 (roughly equivalent to ½-degree lat-lon) resolution, on the ¼-degree ocean from MERRA2 on the first day of 2012 and put them in <code>/discover/nobackup/mathomp4/Regrid</code>:
-  ./regrid.pl -ymd 19900101 -hr 21 -grout b -outdir /discover/nobackup/aeichman/regrid -merra -tagout Ganymed-1_0_M -oceanout c
+  ./regrid.pl -ymd 20120101 -hr 21 -grout C180 -outdir /discover/nobackup/mathomp4/Regrid -merra -tagout Heracles-4_0 -oceanout e
-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 files to be retrieved from the <code>/archive</code> filesystem.
+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, 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 Heracles 5.1.  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 Heracles 5.1.  Restarts for earlier model tags have to be created "manually".
 == Renaming Restart Files ==