4.2 Specification of model input datasets

The following list specifies namelist variables associated with model input datasets.

name

FSURDAT

description

Full pathname of surface dataset (see ex. 1,2,3).

type

char*256

mode

all

default

blank

notes

raw datasets to generate surface dataset provided are in $CSMDATA/rawdata surface datasets provided with the distribution are in $CSMDATA/srfdata

name

FINIDAT

description

Full pathname of initial conditions dataset (see ex. 1,2,3).

type

char*256

mode

all

default

blank

notes

datasets provided are in $CSMDATA/inidata

name

FPFTCON

description

Full pathname of plant functional type (PFT) physiological constants dataset (see ex. 1,2,3).

type

char*256

mode

all

default

required

notes

dataset provided is $CSMDATA/pftdata/pft-physiology

name

FRIVINP_RTM

description

full pathname of RTM input dataset (see ex. 4).

type

char*256

mode

offline, ccsm

default

required if cpp token RTM is defined in preproc.h

notes

dataset provided is $CSMDATA/rtmdata/rdirc.05

name

NREVSN

description

Full pathname of restart file name (only for branch runs) (see ex. 3).

type

char*256

mode

all

default

required (only if branch run, NSREST=3)

name

MKSRF_FVEGTYP

description

Full pathname of raw vegetation type dataset (see ex. 5).

type

char*256

mode

all

default

required (if FSURDAT is blank)

notes

dataset provided is $CSMDATA/rawdata/mksrf_pft.nc

name

MKSRF_FSOITEX

description

full pathname of raw soil texture dataset (see ex. 5).

type

char*256

mode

all

default

required (if FSURDAT is blank)

notes

dataset provided is $CSMDATA/rawdata/mksrf_soitex.10level.nc

name

MKSRF_FSOICOL

description

Full pathname of raw soil color dataset (see ex. 5).

type

char*256

mode

all

default

required (if FSURDAT is blank)

notes

$CSMDATA/rawdata/mksrf_soicol_clm2.nc

name

MKSRF_FLANWAT

description

Full pathname of raw inland water dataset (see ex. 5).

type

char*256

mode

all

default

required (if FSURDAT is blank)

notes

dataset provided is $CSMDATA/rawdata/mksrf_lanwat.nc

name

MKSRF_FURBAN

description

full pathname of urban dataset (see ex. 5).

type

char*256

mode

all

default

required (if FSURDAT is blank)

notes

dataset provided is $CSMDATA/rawdata/mksrf_urban.nc

name

MKSRF_FGLACIER

description

Full pathname of glacier dataset (see ex. 5).

type

char*256

mode

all

default

required (if FSURDAT is blank)

notes

dataset provided is $CSMDATA/rawdata/mksrf_glacier.nc

name

MKSRF_FLAI

description

full pathname of leaf and stem area index, canopy top and bottom height dataset (see ex. 5).

type

char*256

mode

all

default

required (if FSURDAT is blank)

notes

dataset provided is $CSMDATA/rawdata/mksrf_lai.nc

name

MKSRF_OFFLINE_FNAVYORO

description

20 min navy orography dataset used to generate land mask (see ex. 5).

type

char*256

mode

offline

default

required (if MKSRF_OFFLINE_FGRID not set and FSURDAT is blank)

notes

dataset provided is $CSMDATA/rawdata/mksrf_navyoro_20min.nc

name

MKSRF_OFFLINE_FGRID

description

Dataset specifying land grid and mask at desired resolution (see ex. 6).

type

char*256

mode

offline

default

blank, required (if MKSRF_OFFLINE_FNAVYORO not set and fsurdat is blank)

name

MKSRF_OFFLINE_EDGEN

description

Northern edge of land grid (degrees north) (see ex. 5).

type

real

mode

offline

default

90.

name

MKSRF_OFFLINE_EDGEE

description

Eastern edge of land grid (degrees east) (see ex. 5).

type

real

mode

offline

default

180.

name

MKSRF_OFFLINE_EDGES

description

Southern edge of land grid (degrees north) (see ex. 5).

type

real

mode

offline

default

-90.

name

MKSRF_OFFLINE_EDGEW

description

Western edge of grid land (degrees east) (see ex. 5).

type

real

mode

offline

default

-180.

name

OFFLINE_ATMDIR

description

Directory containing atmospheric forcing datasets (see ex. 1,2,3).

type

char*256

mode

offline

default

required

notes

datasets provided are in directory $CSMDATA/NCEPDATA

FSURDAT specifies a surface dataset containing time-invariant land properties such as plant functional types and soil textures and time-variant properties such as leaf area index. Surface datasets provided with the distribution are contained in the following directories:

$CSMDATA/srfdata/offine:

offline mode surface datasets

$CSMDATA/srfdata/cam:

cam mode surface datasets

$CSMDATA/srfdata/ccsm:

ccsm mode surface datasets

If FSURDAT is set to the empty string, a new surface dataset is generated at run time for the specified model resolution and land/ocean mask. The creation of a new surface dataset also requires the specification of the full pathname of the following raw datasets: MKSRF_FVEGTYP, MKSRF_FSOITEX, MKSRF_FSOICOL, MKSRF_FLANWAT, MKSRF_FURBAN, MKSRF_FGLACIER, MKSRF_FLAI. These datasets are only used for the generation of a model surface dataset. They are provided with the distribution and are contained in the input data directory rawdata.

In addition to raw datasets, a land/ocean mask is also required for the creation of a new surface dataset. If the model is run in ccsm or cam mode, this mask is obtained from either the ccsm flux coupler or from the cam atmosphere model at startup. In offline mode, however, the land/ocean mask can either be calculated from a high resolution orography dataset by setting the namelist variable MKSRF_OFFLINE_FNAVYORO or can be read in from an input dataset via the setting of the namelist variable MKSRF_OFFLINE_FGRID.

Subroutines involved in creating a runtime surface dataset reside in the source code directory mksrfdata. In most cases the creation of a surface dataset involves a straightforward interpolation from the raw dataset resolution to the desired model resolution. For soil texture, however, averaging would create new soil types. Consequently, the model determines the dominant soil texture profile per gridcell from the raw resolution to the desired resolution. Once the surface dataset is created, the model reads the necessary surface dataset back in so that the same results will be obtained regardless of whether a run starts from an existing surface dataset or from one created at start up.

The input file, FINIDAT, contains values for the time-dependent variables needed to initialize the model from a spun-up state. It is important to note that due to the differences in data structures, CLM2.1 initial datasets are not in the same form as CLM2.0 initial datasets. The directory tools/convert_inic contains routines needed to perform the conversion of CLM2.0 initial datasets to CLM2.1 form. The README file in that directory contains necessary information to build and utilize the conversion tool.

If FINIDAT is set to the empty string, the model is initialized to non spun-up values. The setting of the namelist variable, HIST_CRTINIC (described in the next section), can be used to generate initial files during a model run. Initial datasets provided with the distribution are contained in the directory $CSMDATA/inidata_2.1.

FPFTCON specifies the dataset containing plant functional type physiological constants. The dataset provided with the distribution is $CSMDATA/pftdata/pft-physiology.

When the cpp token RTM is defined, the RTM river routing scheme will be invoked in running the model. In this case, FRIVINP_RTM must be set to a river routing dataset. The dataset provided with the distribution is $CSMDATA/rtmdata/rdirc.05

NREVSN is ignored unless a branch run is specified (i.e., NSREST is set to 3).

In offline mode, time dependent atmospheric forcing data must be read in periodically. The directory containing these files is given by OFFLINE_ATMDIR. Forcing datasets provided with the distribution can be found in $CSMDATA/NCEPDATA. This variable is ignored in cam and ccsm mode.