To run the model, go to the workspace directory work. This
directory contains copies of scripts used to execute the model,
as well run parameter files used as input to the model. These run
parameter files include:
mrestart execution shell script variable is
set to ``1'' (see below).
src.
See Section 2.4.1 for more information
on this file. See Chapter 4 for a
discussion of the physics behind the variables in
this file.
scripts, while
``working'' copies are located in work. These scripts include:
test.sh to
confirm that the model will compile and run correctly on your
machine. Next, run the model a year or so with climatological
SST to create a qtcm.restart initial conditions file that will
serve to shorten the spin-up time of the model. The
Firsttime.sh script is set-up to do this. Finally,
conduct an actual model run by executing qtcm_realtime.sh
or qtcm_seasonal.sh, as appropriate.
The model execution scripts govern the execution of the model by
first defining the major user-controlled
parameters under the script comment title ``Generate the user
control parameters 
'' These parameters are then input as a
FORTRAN namelist so any parameter undefined in the script will
take-on the default value given in the subroutine DriveInit
in driver.f. Finally, the script compiles
and links the version of the code found
in sub-directory src using the file ``Makefile'' in src
(see Section 2.4.3
for more information about the makefiles included
with this QTCM package),
moves the resulting executable from src to
work, and executes the program in work.
As it runs, the program writes out diagnostic messages (such as
the number of simulation days completed) to the screen and to a file
in directory work called log.
Below is an explanation of the user-controlled variables in the execution scripts:
landon=1 (the default)
means land is interactive.
Other values of landon mean the
land is treated like ocean with a fake SST provided
from the SST files. Since an interactive land has more freedom,
it's more prone to be unstable in the spin-up process, and it
has spin-up time longer than the atmosphere by several months.
Our recommendation is to run the model with land ``off'' for
the first time (Firsttime.sh is set with such a setting).
perpetual: Perpetual SST from a
given month is used (but
watch out for summer continents that
may be too warm if the land is ``on'').
Month used is specified in month0.seasonal: Climatological monthly SST;
land seasonal.real_time: Real time interannual SST;
land seasonal.
year0 includes the
millenium and century). For perpetual and
seasonal cases, year0 can be any value
between 1001 and 9998. However, note that
year0 should be chosen such that during the
entire length of the model run, the model
year never exceeds 9998. Type INTEGER.
lastday. Type INTEGER.
ntout days. See
section 2.4.2 for more details.
Minimum value is 1. Type INTEGER.
ntouti
days. See Section 2.4.2 for more details.
Minimum value is 1. Type INTEGER.
mrestart=1 (the default), model
uses file qtcm.restart as
initial condition (it is recommended to always use this
option, except for the first time when you need to generate
your own qtcm.restart file, together with the land off).
Otherwise, the model will start from an initially unbalanced
state; the spin-up time for the atmosphere is several days,
and several months for land. Type INTEGER.
8.
].
May change with resolution and other factors. Type REAL 8.
.
Default value is 5. Type INTEGER.
test.sh script:
&driverdata title='QTCM seasonal test run' !title bnddir='$QTCMROOT/bnddata' !bnd. data other than SST SSTdir='$QTCMROOT/bnddata/SST_Reynolds' !where SST files are outdir='$QTCMROOT/proc' !where output go landon=0 !=0: land is like ocean with faked SST SSTmode='seasonal' !decides what kind of SST is used year0 = 1001 !starting year; must be between 1001 and 9998 month0 = 1 !starting month; 1 to 12 day0 = 1 !1 t0 30; each month has fixed length of 30 days lastday = 60 !model runs from day 1 to lastday (1yr=360day) interval = 1 !ocean-atmo. coupling interval; integer days ntout=30 !mean output every ntout days ntouti=30 !instantaneous output every ntouti days mrestart=0 !=1: restart using qtcm.restart dt=1200. !atmospheric model time step, real seconds &end
This sample defines a run using monthly climatological SST as forcing, beginning on January 1, and ending 60 days later at the end of February (ostensibly February ``30''). Land acts like an ocean with interpolated SST, the atmosphere-ocean coupling interval is one day, each atmospheric time step is 20 minutes, no ``spin-up'' file is used for initial conditions, and both mean and instantaneous output is written every 30 days (i.e. one month).