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.

misc

ChangeLog , 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 ).

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.

driver_util.F

Subroutines in driver including initializations, model clock, Julian calendar, and Timemanager, etc.

qtcm.F

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

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 in GrADS format for QTCM1.

output_nc.F

Source code for routines that control output in NetCDF format 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.

outpmean.h

Declarations for output.F; mainly for subroutines varmean and oacc.

outpmean_nc.h

Declarations for output_nc.F; mainly for subroutines varmean and oacc.

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.

pavr.f

A generic routine that calculates the time average of multiple variables. It is not used in standard model, but can be useful for certain applications.

pavr.h

Declarations for pavr.f.

All source code is written in FORTRAN 77, except a couple of places using FORTRAN 90 array operations for simplicity. 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.