User's and Developer's Guide for Fortuna 2.4
This page explains various aspects of running GEOS-5 Fortuna 2.4.
Saving Restarts During a Run
Normally the model saves a set of restart files at the end of each run segment to have a record of the state when it starts the next segment. The model can also save restarts during a segment. The parameters for this function are set in the following fields in AGCM.rc:
# Restart Record Parameters # ------------------------- #RECORD_FINAL: >>>RECFINL<<< #RECORD_FREQUENCY: 000000 000000 #RECORD_REF_DATE: >>>REFDATE<<< >>>FCSDATE<<< #RECORD_REF_TIME: >>>REFTIME<<< >>>FCSTIME<<<
The lines above need to be uncommented and appropriate parameters entered. The fields are set as follows:
RECORD_FINAL determines whether a set of restarts is saved at the end of the segment. The default is yes and the line needn't be changed to achieve this. Otherwise modify the line to match
RECORD_FINAL: NO
RECORD_FREQUENCY determines how often in hours restarts are saved after being first saved at the model time set by the parameters that follow. For example, if restarts are to be saved every six hours, the line should read
RECORD_FREQUENCY: 060000
If restarts are to be saved only once before the end of the segment, then it should be set to 0.
Getting the Names of Exports
You can have the model print a list of exports (for HISTORY.rc, for example) to stdout by changing the following line in CAP.rc:
PRINTSPEC: 0 # (0: OFF, 1: IMPORT & EXPORT, 2: IMPORT, 3: EXPORT)
to
PRINTSPEC: 3 # (0: OFF, 1: IMPORT & EXPORT, 2: IMPORT, 3: EXPORT)
Running the model executable will then produce a list of exports, their gridded components, units, and dimensions. Just change the CAP.rc and run the executable -- it will make the list and nothing else. A list of imports to gridded components may also be generated using the proper setting, as should be clear.
Displaying Model Experiment Results
GEOS-5 Steps for Extranet Model Experiments:
1. Have a GMAO employee *request an account* for you on the GMAO
extranet access system, "jungle". /Note:/ You must already have an
NCCS account first and your SATERN IT Security training must have
been completed within the last calendar year.
2. *Run the GEOS-5 model* on the NCCS system "discover". Use the
"gcm_setup" script which comes with the model tag to set up the
experiment.
(Andy Eichmann is the GMAO contact for model support.)
You should *choose an experiment ID (EXPID)* that is unique and
easily identifiable, for example:
1. The experiment ID begins with the first few letters of your
name,
2. The rest of the experiment ID should be numbered
sequentially (e.g., Tom_001)
After a successful model run, you will have all the model plot
images automatically created. You need to now copy these images to
the GMAO web server: jungle
3. *Login to jungle.gsfc.nasa.gov* and *run the following* commands:
|cd /www/html/extranet/collab/model/exps
./makexp|
This script will ask a few questions to identify your experiment.
It will then create appropriate directories which contain the
model web pages and a location for your experiment images.
Model directory:
|/www/html/extranet/collab/model/exp/EXPID|
Location for images:
|/www/html/extranet/collab/model/exp/EXPID/CLIM|
4. *Scp (secure copy) your GIF image files to jungle*. The location
will be:
|/www/html/extranet/collab/model/exp/EXPID/CLIM|
where EXPID is your particular experiment ID. 5. *Browse http://gmao.gsfc.nasa.gov/extranet/* to confirm that your experiment images can be accessed via GMAO's extranet.