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=64)
     Default: 'null'
     Required: yes
     Description: This specifies where the land data input file sequence
     is found.  The data files are assumed to be named "lsmh_yyyy.nc", where 
     yyyy is the four digit year of the data file.  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.

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

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

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

data_aroff
     Type: character(len=80)
     Default: "zero"
     Required: no
     Description:  
     It is assumed that the dlnd5 data files contain the 19 basins of runoff
     data that were used in the lsm land model found in CCSM 1.x, and that no 
     new data files exist that were created using newer land models or using the
     newer 1x1 degree runoff grid scheme found in CCSM 2.0.
     *  data_aroff = "zero", then the runoff sent to the coupler is zero 
        everywhere.
     *  data_aroff = "null", then the runoff data sent to the coupler is the 
        19 basin runoff data found in the data files
     *  data_aroff = "UserCreatedFile", then the runoff data sent to the 
        coupler is in a user created data file (an "auxiliary" data file).  
        This option is for power-users only.  See the source code file called 
        "runoff_aux.F90".

data_fix
     Type: character(len=64)
     Default: 1
     Required: no
     Description: To conform to the coupled system data field sign convention,
     it may be necessary to change the sign (+/-) of certain fields found in
     the input data file sequence.  If data_fix = "sign", then the sign is
     changed for these fields: evaporation, longwave up, sensible heat flux,
     and latent heat flux.  

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