Below is an explanation of the user-controlled variables in the models input
file driver.in. Default values for these user-controlled variables
are defined in the subroutine DriverInit in driver.f90:
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 is more prone to numerical instability in the spin-up process,
and it has spin-up time longer than the atmosphere by several months.
You may never encounter this problem. Our recommendation is to
run the model with land ``off'' for the first time
(spinup.sh is set with such a setting),
or use the default file qtcm.restart.
solartop evolves.
Variable is an alphanumeric string. There
are three mode options:
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.
When the mixed-layer ocean model is active,
this mode means annually averaged Q-flux
(see Section 4.4) is used.seasonal: Climatological monthly SST;
solar top seasonal. When the mixed-layer ocean
model is active, this mode means
seasonal Q-flux is used.real_time: Real time interannual SST;
solar top seasonal.
year0 includes the
millennium and century). For perpetual and
seasonal cases,
year0 can be any value
between 1 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.
Note: 1 year 
365 days (no leap years)
in QTCM1 for standard setting. A calendar of
360 days a year can be switched on by defining
the macro YEAR360 in the makefile.
lastday. Type INTEGER.
noout days;
useful for spin-up. Type INTEGER.
ntout days. See
Section 2.4.2 for more details.
Type INTEGER. For the standard 365 day calendar
ntout=-30 specifies monthly output.
ntout=0 suppresses the output of averages
and disables the averaging routine, which make the
model about 10% faster.
ntouti
days. See Section 2.4.2 for more
details. Type INTEGER.
ntout=-30 specifies monthly output.
ntout=0 suppresses the any output of instantaneous fields.
ntoutr days.
ntoutr=-30 monthly restart file.
ntoutr=0 no restart file except at end of
model run.
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 unbalanced
initial state; the spin-up time for the atmosphere is
several days, and several months for land.
Type INTEGER.
NB: Currently, restart using qtcm.restart is not ``perfect.'' This is because in the standard version, qtcm.restart.out does not save the atmospheric mixed layer surface winds which are use as the initial for the new winds.
.
Default value is 1. Type INTEGER.
].
].
].
, arr8name
arr1, ,arr8. These arrays are include in the output if the cor
responding arrXname is set. The structure of the arrXname string has to be ``variable name'', one or more spaces,
test.sh):
&driverdata title='A QTCM test run' bnddir='$BNDDIR' SSTdir='$BNDDIR/SST_Reynolds' outdir='$OUTDIR' runname='$RUNNAME' landon=0 lastday = 61 ntouti=-30 ! monthly instantaneous data output mrestart=0 ! ! default values set in driverInit: ! --------------------------------- ! title='QTCM default title' ! A descriptive title ! bnddir='../bnddata' ! bnd. data other than SST ! SSTdir='../bnddata/SST_Reynolds' ! where SST files are ! outdir='../proc/qtcm_output' ! where output go ! runname='runname' ! string used to create an output filename ! landon=1 ! if not 1: land is like ocean with fake 'SST' ! SSTmode='seasonal' ! decide what kind of SST to use ! year0 = -1 ! starting year if <0 use year in restart file ! month0 = -1 ! starting month if <0 use month in restart file ! day0 = -1 ! -1 and mrestart=1: Use date saved in the restart file ! lastday = 365 !(for YEAR360: 360) ! last day of integration ! interval = 1 ! coupling interval ! noout=0 ! no output for the first noout days ! ntout=-30 ! monthly mean output ! ntouti=0 ! monthly instantaneous data output ! ntoutr=0 ! restart file only at end of model simulation ! nooutr=0 ! Days to skip before writing restart files. ! mrestart=1 ! =1: restart using qtcm.restart ! dt=1200. ! time step [seconds] ! mt0=1 ! barotropic timestep every mt0 timesteps ! viscT=12.0e5 ! temperature diffusion parameter [m^s/s] ! viscQ=12.0e5 ! moisture diffusion parameter [m^s/s] ! viscU=7.0e5 ! viscocity parameter [m^s/s] ! ziml=400 ! Atmos. Mixed layer depth [m] ! weml=0.02 ! Mixed layer entrainment velocity [m] ! Wsmin=4.5 ! Minumum wind speed for flux calculation [m/s] ! V1b=-0.2204077 ! V1 projection coeffcicient at top of mixed layer ! arr1name='?' ! Auxiliary output array names 1...8 ! arr2name='?' !='?' Array not included in output. ! arr3name='?' ! arr4name='?' ! arr5name='?' ! arr6name='?' ! arr7name='?' ! arr8name='?' ! Example: ! arr1name='dps1dx Mode 1 contribution to dpsdx [m/s^2]' !---------------------------------------------------------------- &end
This sample defines a run using monthly climatological SST as forcing ending after 59 days. Land acts like an ocean with interpolated SST, no ``spin-up'' file is used for initial conditions.