What's Included In the Model

 

The tar package for this release of the QTCM1 model contains the following sub-directories:

bnddata

Directory of boundary data files, such as sea surface temperature (SST), albedo, etc. See Section  for more information.

doc

The LaTeX files for this manual, as well as an HTML version and a Postscript version. See the README file in this directory, as well as the comments in qtcm_man.tex, for more information.

misc

CPU time profiles, etc.

proc

Contains pre-written scripts, programs, and control files that can be used to display the output from the model. We recommend specifying this directory as the recipient of QTCM1 model output (see Section ).

script

Originals of C shell scripts used to run the model. Also in directory work.

src

Contains all the source code for the model.

work

This directory provides a workspace in which to execute the model. Section  has a more detailed description of this directory.

Because the model is meant to be reasonably straightforward to diagnose, the complete model consists of comparatively few files. Below is a listing and short description of the source code/parameter files that make up the model; they are found in directory src:

driver.f

Source code for subroutine driver which couples the atmospheric model and the SST boundary condition which drives it.

qtcm.f

Source code for routines in the QTCM1 atmospheric model. These subroutines are called and controlled by subroutine qtcm.

qtcm.f.mconvct2

Same as qtcm.f except two additional convective closure assumptions are provided.

ocean.f

A pseudo-modular ocean: returns SST to the atmospheric model. It is symbolically linked to either rdsst.f or mxlayer.f.

rdsst.f

Reads in observed SST data.

mxlayer.f

Computes SST using the simple slab mixed-layer ocean model.

land.f

The land-surface model Simple-Land (SLand1); and a simple implementation of the bucket model (not used).

bndry.f

A generic routine for reading in monthly climatological fields.

clrad.f

Cloud-radiation package. It is linked to either clrad1.f or clrad0.f.

clrad0.f

Source code for the ``standard'' radiation parameterization package. In this package, the solar component is diurnally averaged.

clrad1.f

Source code for radiation parameterization package by Chia Chou [5]. In this package, the solar component is diurnally averaged.

clrad1d.f

Source code for radiation parameterization package by Chia Chou [5], with the diurnal cycle resolved.

output.f

Source code for routines that control output for QTCM1.

getbnd.f

A routine that passes boundary data arrays such as SST and albedo.

utilities.f

A generic routine that computes thermodynamic quantities and bundles up general external functions.

fatdpkg.f

Direct Poisson solver, courtesy of Alistair Adcroft.

cplmean.f

Source code for routine that accumulates coupling variables (fluxes) from the qtcm model over time for ocean coupling.

driver.h

Header file for control parameters used in the namelist /driverdata/.

qtcm.h

Header file for subroutine qtcm and dependent subroutines.

hgrid.h

Header file related to the horizontal (i.e. x-y) grid resolution.

rdsst.h

Declarations for rdsst.f.

mxlayer.h

Declarations for mxlayer.f.

calendar.h

Header file for variables related to keeping time in the model.

cld.h

Header file for the variables found in clrad1.f and clrad1d.f.

pmean.h

Declarations for output.f; mainly for subroutine varmean.

qtcmpar.in

This file contains the values of various parameters and coefficients used by QTCM1 (e.g. , ). The working copy of this file is found in work; this copy exists as a backup in case the working copy is accidentally deleted. Sections  and  and chapter  have more information.

All source code is written in FORTRAN 77. Most of the header files function to declare variables and common blocks. The directory src also contains various makefiles that are used to control how the code is compiled and linked. See Section  for more information about the makefiles.