Regridding Restarts for Icarus 3.0: Difference between revisions

Line 1:

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.'''

Here are basic instructions on how to create restart files for Icarus 3.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 2.0]]'''

'''Back to [[GEOS-5 Documentation for Icarus 3.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 2.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 3.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 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 2.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 3.0. Restarts for earlier model tags have to be created "manually".

== Renaming Restart Files ==

Line 407:

-->

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

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

@@ Line 1: / Line 1: @@
-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.'''
+Here are basic instructions on how to create restart files for Icarus 3.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 2.0]]'''
+'''Back to [[GEOS-5 Documentation for Icarus 3.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 2.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 3.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 155: / 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 2.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 3.0.  Restarts for earlier model tags have to be created "manually".
 == Renaming Restart Files ==
@@ Line 407: / Line 407: @@
 -->
-'''Back to [[GEOS-5 Documentation for Icarus 2.0]]'''
+'''Back to [[GEOS-5 Documentation for Icarus 3.0]]'''