next up previous contents
Next: 4 Output Datasets Up: UsersGuide Previous: 2 Input Datasets   Contents

3 Namelist

The model reads an input namelist from stdin at runtime. 
Following is a list and description of available namelist input parameters.

case_name
     Type: character(len=16)
     Default: "null"
     Required: no, but highly recommended
     Description: This is the case name text string that appears in output files
     to help identify the model run.  

case_desc
     Type: character(len=64)
     Default: "null"
     Required: no, but highly recommended
     Description: This is a short text string (typically less than 80 chars) 
     which is included in output files to help identify the model run.

ncpl
     Type: integer
     Default: 24
     Required: no
     Description: This specifies how many times per day the model
     communicates (exchanges data) with the coupler.

data_dir
     Type: character(len=256)
     Default: "null:"
     Required: yes
     Description: This specifies where the land data input file sequence
     is found.  Examples:
     (1) data_dir = "cp:~jdoe/data " => look for input data in user djoe's
         home directory in the data subdirectory.
     (2) data_dir = "mss:/JDOE/data " => look for input data on NCAR's
          Mass Storage System archival device.
     (3) data_dir = "null:/whatever " => the "null:" prefix indicates that the
	 data has already been pre-positioned in the exectution directory.

data_fname
     Type: character(len=256)
     Default: "null"
     Required: yes
     Description: This specifies file names of the input data files.  The data 
     files are assumed to contain one year's worth of data -- 365 daily averages.
     The file name can be any valid unix file name.  This is a template file
     name, that is, somewhere in the file name must be the text substring "yyyy"
     which will be replaced by a specific year to create the actual file name.
     For example, if data_fname = "f20.005.cam2.h1.yyyy-01-01-00000.nc" and datm
     model needs data for year 2002, it will construct the file name
     "f20.005.cam2.h1.2002-01-01-00000.nc",  and look for this file in the 
     directory data_dir described above.

data_year0
     Type: integer
     Default: 1
     Required: yes
     Description: This specifies the first year in the input atmosphere data
     file sequence.

data_nyear
     Type: integer
     Default: 1
     Required: no
     Description: This specifies the number of years in the input atmosphere
     data file sequence.

data_oyear
     Type: integer
     Default: 1
     Required: no
     Description: This specifies the "offset year" for the input atmosphere
     data file sequence. The data file for data_year0 will coincide with the
     simulation year data_oyear.

mss_rmlf
     Type: integer boolean (0 <=> false)
     Default: 0
     Required: no
     Description: This specifies whether to remove the local copy of an
     input atmosphere data file after it has been read in by the model. 
     Iff mss_rmlf = 0, then the model will not remove the local file.

flux_albfb
     Type: integer boolean (0 <=> false)
     Default: 0 
     Required: no
     Description: If flux_albfb = true, then albedo feedback is activated.

flux_swfact
     Type: real
     Default: 1.0 
     Required: no
     Description: This factor is applied to all shortwave fields.  
     This can be used to arbitrarily increase or decrease shortwave values.

info_dbug
     Type: integer
     Default: 1
     Required: no
     Description: Debugging information level: 0, 1, 2, or 3.
     * 0 => write the least amount of debugging information to stdout
     * 1 => write a  small  amount of debugging information to stdout
     * 2 => write a  medium amount of debugging information to stdout
     * 3 => write a  large  amount of debugging information to stdout



csm@ucar.edu