What's Included In the Model

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

bnddata

Directory of boundary data files, such as sea surface temperature (SST), albedo, etc. See Section 2.4.1 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 QTCM model output (see section 2.3.1).

script

Originals of C shell scripts used to run the model.

src

Contains all the source code for the model.

work

This directory provides a workspace in which to execute the model. Section 2.3.1 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:

calendar.h

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

cld.h

Header file for the variables found in clrad1.f.

clrad0.f

Source code for the ``standard'' radiation parameterization package.

clrad1.f

Source code for radiation parameterization package by Chia Chou [5].

cplmean.f

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

driver.f

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

fatdpkg.f

Direct Poisson solver; courtesy of Alistair Adcroft.

hgrid.h

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

ocean.f

A pseudo-modular ocean: returns interpolated SST.

ocean.h

Declarations for ocean.f.

output.f

Source code for routines that control output for QTCM.

pmean.h

Declarations for output.f; mainly for subroutine varmean.

qtcm.f

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

qtcm.h

Header file for subroutine qtcm and dependent subroutines.

qtcmpar.in

This file contains the values of various parameters and coefficients used by QTCM (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. Section 2.4.1 and chapter 4 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 2.4.3 for more information about the makefiles.