Full pathname of initial conditions file. If blank CLM will startup from
arbitrary initial conditions.
Full pathname of master restart file for a branch run. (only used if RUN_TYPE=branch)
(Set with RUN_REFCASE and RUN_REFDATE)
Full pathname of land fraction data file.
Clumps per processor.
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
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
If TRUE, separate the vegetated landunit into a crop landunit and a natural vegetation landunit
Number of multiple elevation classes over glacier points.
Normally this is ONLY used when running CESM with the active glacier model.
If TRUE, dynamically change topographic height over glacier points.
Only works when glc_nec is greater than zero.
(EXPERIMENTAL AND NOT FUNCTIONAL!)
Visible and Near-infrared albedo's for glacier ice
Time step (seconds)
Override the start type from the driver: it can only be
set to 3 meaning branch.
Full pathname of land-ice mask data file (on lnd grid).
Full pathname of topography data file. Only required when
land-ice model is active.
Full pathname datafile with plant function type (PFT) constants
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 surface data file.
SNICAR (SNow, ICe, and Aerosol Radiative model) optical data file name
SNICAR (SNow, ICe, and Aerosol Radiative model) snow aging data file name
Per file averaging flag.
'A' (average over history period)
'I' (instantaneous)
'X' (maximum over history period)
'M' (minimum over history period)
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, 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
Default: 2,2,2,2,2,2
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
Default: 0,-24,-24,-24,-24,-24
number of segments per clump for decomposition
Default: 20
Perturbation limit when doing error growth test
If FALSE, don't write any restart files.
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).
If TRUE, write diagnostic of global radiative temperature written to CLM log file.
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').
Flag to pass to the ESMF mapping utility, telling it what kind of grid
file this is (SCRIP or UGRID).
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.)
Filename for mksurfdata_map to remap raw data into the output surface dataset
Plant Function Type dataset for mksurfdata
Dataset for percent glacier land-unit for mksurfdata
Dataset for topography used to define urban threshold
Dataset for land topography
Leaf Area Index dataset for mksurfdata
Soil texture dataset for mksurfdata
Soil color dataset for mksurfdata
Soil max fraction dataset for mksurfdata
High resolution land mask/fraction dataset for mksurfdata
(used for glacier_mec land-units)
Type of grid to create for mksurfdata
Grid file at the output resolution for mksurfdata
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 topography dataset for mksurfdata
(used for glacier_mec land-units)
Irrigation dataset for mksurfdata
Organic soil dataset for mksurfdata
Lake water dataset for mksurfdata
Wetland dataset for mksurfdata
Urban dataset for mksurfdata
Biogenic Volatile Organic Compounds (VOC) emissions dataset for mksurfdata
If TRUE, output variables in double precision for mksurfdata
If TRUE, ignore other files, and set the output percentage to 100% urban and
zero for other land-use types.
Number of Plant Functional Types (excluding bare-soil)
Plant Function Type index to override global file with for mksurfdata
Plant Function Type fraction 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
Soil percent clay to override global file with for mksurfdata
Orography file with surface heights and land area fraction
CLM grid file
CESM domain file
CAM file
Raw topography file
CAM topography file
Number of longitudes to use for a regional grid (for single-point set to 1)
Number of latitudes to use for a regional grid (for single-point set to 1)
Northern edge of the regional grid
Southern edge of the regional grid
Eastern edge of the regional grid
Western edge of the regional grid
Historical greenhouse gas concentrations from CAM, only used
by getco2_historical.ncl
Aerosol deposition file name (only used for aerdepregrid.ncl)
Full pathname of CLM fraction dataset (only used for mkdatadomain).
Full pathname of CLM grid dataset (only used for mkdatadomain).
Full pathname of output domain dataset (only used for mkdatadomain).
Type of domain file to create (ocean or atmosphere) (only used for mkdatadomain)
First year to loop over for Nitrogen Deposition data
Last year to loop over for Nitrogen Deposition data
Simulation year that aligns with stream_year_first_ndep value
Filename of input stream data for Nitrogen Deposition
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
datm input directory
datm output directory
Datm logfile name
Mapping file to go from one resolution/land-mask to another resolution/land-mask
Land mask description for mksurfdata input files
Horizontal grid resolutions for mksurfdata input files
Check that the resolution and land-mask is valid before continuing.
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.
Add a note to the output namelist about the options given to build-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.
Horizontal resolutions
Note: 0.1x0.1, 0.5x0.5, 5x5min, 10x10min, 3x3min and 0.33x0.33 are only used for CLM tools
Land mask description
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.
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.
If TRUE, irrigation will be active (find surface datasets with active irrigation).
If 1, turn on the MEGAN model for BVOC's (Biogenic Volitile Organic Compounds)
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.
Namelist entries to demand be provided on the namelist.
Description of the use case selected.
Where dry deposition is calculated (from land, atmosphere, or from a table)
List of chemical constituents that dry deposition will be calculated for
File containing MEGAN emissions factors. Includes the list of MEGAN compounds that can be
used in the Comp_Name variable on the file.
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'
MEGAN mapped isoprene emissions factors switch
If TRUE then use mapped MEGAN emissions factors for isoprene.
List of possible MEGAN compounds to use
(the list used by the simulation is on the megan_factors_file as the Comp_Name)
Enable C13 model
Enable C14 model