CESM2.1.2 CLM Namelist Definitions

Enable C13 model

Enable C14 model

Clumps per processor.

number of segments per clump for decomposition

Visible and Near-infrared albedo's for glacier ice

Atmospheric CO2 molar ratio (by volume) only used when co2_type==constant (umol/mol)
(Set by CCSM_CO2_PPMV)

Type of CO2 feedback.
    constant   = use the input co2_ppmv value
    prognostic = use the prognostic value sent from the atmosphere
    diagnostic = use the diagnostic value sent from the atmosphere

If TRUE, separate the vegetated landunit into a crop landunit and a natural vegetation landunit

Time step (seconds)

If TRUE, dynamically change topographic height over glacier points.
Only works when glc_nec is greater than zero.
(EXPERIMENTAL AND NOT FUNCTIONAL!)

Number of  multiple elevation classes over glacier points.
Normally this is ONLY used when running CESM with the active glacier model.

Perturbation limit when doing error growth test

Supplemental Nitrogen mode and for what type of vegetation it's turned on for. 
In this mode Nitrogen is unlimited rather than prognosed and in general vegetation is 
over-productive. It does act as a proxy for fertilization for crops however.
    NONE           = No vegetation types get supplemental Nitrogen
    PROG_CROP_ONLY = Supplemental Nitrogen is only active for prognostic Crops
    ALL            = Supplemental Nitrogen is active for all vegetation types

Turn urban air conditioning/heating ON or OFF and add wasteheat:
    OFF          = Air conditioning/heating is OFF in buildings, internal temperature allowed to float freely
    ON           = Air conditioning/heating is ON in buildings, internal temperature constrained
    ON_WASTEHEAT = Air conditioning/heating is ON and waste-heat sent to urban canyon

If TRUE, urban traffic flux will be activated (Currently NOT implemented).

Full pathname of master restart file for a branch run. (only used if RUN_TYPE=branch)
(Set with RUN_REFCASE and RUN_REFDATE)

Override the start type from the driver: it can only be
set to 3 meaning branch.

If FALSE, don't write any restart files.

Full pathname of land fraction data file.

Full pathname of land-ice mask data file (on lnd grid).

Full pathname of initial conditions file. If blank CLM will startup from
arbitrary initial conditions.

Full pathname of time varying PFT data file. This causes the land-use types of
the initial surface dataset to vary over time.

Full pathname of topography data file. Only required when 
land-ice model is active.

Full pathname datafile with plant function type (PFT) constants

SNICAR (SNow, ICe, and Aerosol Radiative model) snow aging data file name

SNICAR (SNow, ICe, and Aerosol Radiative model) optical data file name

Full pathname of surface data file.

Simulation year that aligns with stream_year_first_ndep value

Mapping method from Nitrogen deposition input file to the model resolution
    bilinear = bilinear interpolation
    nn       = nearest neighbor
    nnoni    = nearest neighbor on the "i" (longitude) axis
    nnonj    = nearest neighbor on the "j" (latitude) axis
    spval    = set to special value
    copy     = copy using the same indices

Filename of input stream data for Nitrogen Deposition

First year to loop over for Nitrogen Deposition data

Last year to loop over for Nitrogen Deposition data

datm input directory

datm output directory

Datm logfile name

Check that the resolution and land-mask is valid before continuing.

Command line argument for setting up your simulation in a mode for faster
throughput. By default turns off some options, and sets up for a lower level
of output. When bgc_mode is some level of prognostic BGC (so NOT Satellite Phenology)
it also sets up for accelerated decomposition.
NOTE: THIS CORRESPONDS DIRECTLY TO THE env_run.xml VARIABLE OF THE SAME NAME.
      Set the env_run variable, rather than setting this directly.

Namelist entries to demand be provided on the namelist.

CLM run type.  
    'default' use the default type of clm_start type for this configuration
    'cold' is a run from arbitrary initial conditions
    'arb_ic' is a run using initial conditions if provided, OR arbitrary initial conditions if no files can be found
    'startup' is an initial run with initial conditions provided.  
    'continue' is a restart run.
    'branch' is a restart run in which properties of the output history files may be changed.

If TRUE, irrigation will be active (find surface datasets with active irrigation).

General configuration of model version and atmospheric forcing to tune the model to run under.
This sets the model to run with constants that were set to run well under the configuration
of model version and atmospheric forcing. To run well constants would need to be changed
to run with a different type of atmospheric forcing.

Land mask description

If 1, turn on the MEGAN model for BVOC's (Biogenic Volitile Organic Compounds)

Add a note to the output namelist about the options given to build-namelist

Horizontal resolutions
Note: 0.1x0.1, 0.5x0.5, 5x5min, 10x10min, 3x3min and 0.33x0.33 are only used for CLM tools

Year to simulate and to provide datasets for (such as surface datasets, initial conditions, aerosol-deposition, Nitrogen deposition rates etc.)
A sim_year of 1000 corresponds to data used for testing only, NOT corresponding to any real datasets.
Most years are only used for clm_tools and there aren't CLM datasets that correspond to them.
CLM datasets exist for years: 1000 (for testing), 1850, and 2000

Range of years to simulate transitory datasets for (such as dynamic: land-use datasets, aerosol-deposition, Nitrogen deposition rates etc.)
Constant means simulation will be held at a constant year given in sim_year.
A sim_year_range of 1000-1002 or 1000-1004 corresponds to data used for testing only, NOT corresponding to any real datasets.
A sim_year_range that goes beyond 2005 corresponds to historical data until 2005 and then scenario data beyond that point.

Shared Socioeconomic Pathway (SSP) and Representative Concentration Pathway (RCP) combination for future scenarios 
The form is SSPn-m.m Where n is the SSP number and m.m is RCP radiative forcing at peak or 2100 in W/m^2
n is just the whole number of the specific SSP scenario. The lower numbers have higher mitigation
- the higher numbers less mitigation, more than one SSP can result in the same RCP forcing
hist means do NOT use a future scenario, just use historical data.

Description of the use case selected.

List of possible MEGAN compounds to use
  (the list used by the simulation is on the megan_factors_file as the Comp_Name)

File containing MEGAN emissions factors. Includes the list of MEGAN compounds that can be
used in the Comp_Name variable on the file.

MEGAN mapped isoprene emissions factors switch
If TRUE then use mapped MEGAN emissions factors for isoprene.

MEGAN specifier. This is in the form of: Chem-compound = megan_compound(s)
where megan_compound(s) can be the sum of megan compounds with a "+" between them.
In each equation, the item to the left of the equal sign is a CAM chemistry compound, the
items to the right are compounds known to the MEGAN model (single or combinations). 
For example,
megan_specifier = 'ISOP = isoprene',
                  'C10H16 = pinene_a + carene_3 + thujene_a'

List of chemical constituents that dry deposition will be calculated for

Where dry deposition is calculated (from land, atmosphere, or from a table)

Per file averaging flag.
    'A' (average over history period)
    'I' (instantaneous)
    'X' (maximum over history period)
    'M' (minimum over history period)

If TRUE, implies output data on a 2D latitude/longitude grid. False means
output in 1D vector format.  One setting per history tape series.

If TRUE, indicates do NOT output any default history fields (requires you to use
hist_fincl* to set the exact output fields to use)..

Fields to exclude from history tape series 1.

Fields to exclude from history tape series  2.

Fields to exclude from history tape series  3.

Fields to exclude from history tape series  4.

Fields to exclude from history tape series  5.

Fields to exclude from history tape series  6.

Fields to add to history tape series  1.

Fields to add to history tape series  2.

Fields to add to history tape series  3.

Fields to add to history tape series  4.

Fields to add to history tape series  5.

Fields to add to history tape series  6.

Per tape series  maximum number of time samples.

Per tape series  history file density (i.e. output precision) 
    1=double precision
    2=single precision

Per tape series history write frequency. 
    positive means in time steps
    0=monthly
    negative means hours
(i.e. 5 means every 24 time-steps and -24 means every day

Averaging type of output for 1D vector output (when hist_dov2xy is false).
    GRID means average all land-units up to the grid-point level
    LAND means average all columns up to the land-unit level
    COLS means average all PFT's up to the column level
    PFTS means report everything on native PFT level

If TRUE, write diagnostic of global radiative temperature written to CLM log file.

Eastern edge of the regional grid

Northern edge of the regional grid

Southern edge of the regional grid

Western edge of the regional grid

CAM file

CAM topography file

CESM domain file

CLM grid file

Orography file with surface heights and land area fraction

Raw topography file

Number of latitudes to use for a regional grid (for single-point set to 1)

Number of longitudes to use for a regional grid (for single-point set to 1)

SCRIP format grid data file

Flag to pass to the ESMF mapping utility, telling it what kind of large
file support is needed for an output file generated with this grid as
either the source or destination ('none', '64bit_offset' or 'netcdf4'). 

For UGRID files, flag to pass to the ESMF mapping utility, telling it the
name of the dummy variable that has all of the topology information stored
in its attributes. (Only used if scripgriddata_src_type = UGRID.)

Flag to pass to the ESMF mapping utility, telling it what kind of grid
file this is (SCRIP or UGRID).

If TRUE, ignore other files, and set the output percentage to 100% urban and
zero for other land-use types.

Horizontal grid resolutions for mksurfdata input files

Land mask description for mksurfdata input files

Mapping file to go from one resolution/land-mask to another resolution/land-mask

Text file with filepaths (or list of XML elements) for vegetation fractions
and harvesting for each year to run over for mksurfdata to be able to model
transient land-use change

High resolution land mask/fraction dataset for mksurfdata
(used for glacier_mec land-units)

Dataset for percent glacier land-unit for mksurfdata

Grid file at the output resolution for mksurfdata

Filename for mksurfdata_map to remap raw data into the output surface dataset

Irrigation dataset for mksurfdata

Leaf Area Index dataset for mksurfdata

Lake water dataset for mksurfdata

Dataset for land topography

Soil max fraction dataset for mksurfdata

Organic soil dataset for mksurfdata

Soil color dataset for mksurfdata

Soil texture dataset for mksurfdata

High resolution topography dataset for mksurfdata
(used for glacier_mec land-units)

Urban dataset for mksurfdata

Dataset for topography used to define urban threshold

Plant Function Type dataset for mksurfdata

Biogenic Volatile Organic Compounds (VOC) emissions dataset for mksurfdata

Wetland dataset for mksurfdata

Type of grid to create for mksurfdata

Number of Plant Functional Types (excluding bare-soil)

If TRUE, output variables in double precision for mksurfdata

Plant Function Type fraction to override global file with for mksurfdata

Plant Function Type index to override global file with for mksurfdata

Soil percent clay to override global file with for mksurfdata

Soil color index to override global file with for mksurfdata

Soil maximum fraction to override global file with for mksurfdata

Soil percent sand to override global file with for mksurfdata

Type of domain file to create (ocean or atmosphere) (only used for mkdatadomain)

Full pathname of output domain dataset (only used for mkdatadomain).

Full pathname of CLM fraction dataset (only used for mkdatadomain).

Full pathname of CLM grid dataset (only used for mkdatadomain).

Aerosol deposition file name (only used for aerdepregrid.ncl)

Historical greenhouse gas concentrations from CAM, only used
by getco2_historical.ncl