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 Visible and Near-infrared albedo's for glacier ice If TRUE, river runoff will be split up into liquid and ice streams, otherwise ice runoff will be zero and all runoff directed to liquid stream 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 If TRUE, turn on multiple elevation classes over glacier points. Normally this is ONLY used when running CESM with the active glacier model. Only works when GLC_NEC is greater than zero. If TRUE, calculate surface mass balance for glacier multi-elevation class points. If false use growing degree day information for glaciers multi-elevation class points. Only works when create_glacier_mec_landunit is true. (Only tested with glc_smb=.true. when create_glacier_mec_landunit is .true., setting it to .false. is NOT tested) If TRUE, dynamically change topographic height over glacier points. Only works when create_glacier_mec_landunit is true. (EXPERIMENTAL AND NOT FUNCTIONAL!) If TRUE, output NetCDF files in 64-bit large-file format Time step (seconds) Override the start type from the driver: it can only be set to 3 meaning branch. Full pathname of grid data file on the atm grid. Input archive device prefix to retrieve input files from (used by shr/shr_file_mod.F90) (This feature is deprecated and NOT recommended for use). Full pathname of land fraction data file (on atm grid). Full pathname of topography data file (on atm grid). Only required when fine-mesh activated. (fine-mesh is EXPERIMENTAL NOT SUPPORTED!) 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 topography data file (on lnd grid). Only required when fine-mesh is activated or when land-ice model is active. (fine-mesh is EXPERIMENTAL NOT SUPPORTED!) 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 input datafile for RTM. 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 Full pathname of master restart file for a branch run. (only used if RUN_TYPE=branch) (Set with RUN_REFCASE and RUN_REFDATE) number of segments per clump for decomposition Default: 20 Perturbation limit when doing error growth test If FALSE, don't write any restart files. If greater than one, average River Transport Model (RTM) over given number of time steps 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. Plant Function Type dataset for mksurfdata Dataset for percent glacier land-unit for mksurfdata 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 Land water 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, use the large file format for NetCDF 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) Number of glacier multiple elevation classes 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 nitrogen deposition data file (only used for ndepregrid.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) CASA Net Primary Production format: 1=gpp*gppfact 2=fn(lgrow)*gppfact (CASA is EXPERIMENTAL NOT SUPPORTED!) Default: 2 CASA allocation type: 0=fixed allocation 1=dynamic allocation (CASA is EXPERIMENTAL NOT SUPPORTED!) Default: 1 CASA Temperature dependence (CASA is EXPERIMENTAL NOT SUPPORTED!) Default: 2.0 CASA flag if input file spunup or not: 0=no 1=yes (CASA is EXPERIMENTAL NOT SUPPORTED!) Default: 0 CASA Carbon Pool initial state filename (CASA is EXPERIMENTAL NOT SUPPORTED!) Default: blank 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 If TRUE, run model in "aqua planet" mode with a prescribed ocean model over the entire earth surface. Only one of atm_adiabatic, atm_ideal_phys, or aqua_planet can be true (Note: Turning on this mode inherently turns CLM off, and requires using CAM). Aqua planet analytic Sea Surface Temperature (SST) type (only if aqua_planet is true). If TRUE, do not run atmosphere model physics, only run the dynamical core. Only one of atm_adiabatic, atm_ideal_phys, or aqua_planet can be true. If TRUE, run the idealized Held & Suarez physics package for the atmosphere. Only one of atm_adiabatic, atm_ideal_phys, or aqua_planet can be true. If TRUE, use the pre-existing case name for a branch run. Case description. (Set with CASESTR). Case identifier. (Set with the CASE name in env_case.xml) If TRUE, no diurnal cycle will be done for ocean albedos. Selects E,P,R adjustment technique. Level of debug output flag. Ending suffix "postfix" for output log files. If TRUE, couple ocean on atmosphere timestep. Mode for orbital calculations fixed_year = use a fixed year variable_year = let the orbital year advance with the simulation fixed_parameters = use a fixed set of parameters, not based on the year Earth's eccentricity of orbit. (unitless: typically 0. to 0.1). Setting is required if orb_mode = 'fixed_parameters' Year (AD) used to compute earth's orbital parameters, when orb_mode='fixed_year' Orbital parameters will be computed automatically (based on Berger, 1977). Align year (AD) used to compute earth's orbital parameters, when orb_mode='variable_year'. Orbital parameters will be computed automatically (based on Berger, 1977), and updated yearly as the model progresses. Earth's moving vernal equinox at perihelion (degrees: 0. to 360.0). Setting is required if orb_mode = 'fixed_parameters' Earth's orbital angle of obliquity (degrees: -90. to +90., typically 22. to 26.). Setting is required if orb_mode = 'fixed_parameters' Root directory for driver output files If TRUE, means the run will use a perpetual calendar, i.e., a diurnal cycle will be present for the fixed calendar day specified by perpetual_ymd. Perpetual date encoded in an integer as (year*1000 + month*100 + day). If aqua_planet = .true. then perpetual_ymd is ignored and the perpetual date is set to 321. Driver restart filename. (Set with RUN_REFCASE and RUN_REFDATE) Driver restart pointer filename. Vector mapping option Grid for atmosphere to ocean flux calculations If TRUE, atmosphere and ocean grids are the same lat/lon/size if TRUE, runoff and ocean grids are the same lat/lon/size If TRUE, do the pole corrections in shr_map_mod If TRUE, atmosphere and land grids same lat/lon/size Latitude value of single column. (Set by PTS_LAT) Longitude value of single column. (Set by PTS_LON) If TRUE, run in single column mode. (Set by PTS_MODE) Run type. 'startup' is an initial run. 'continue' is a restart run. 'branch' is a restart run in which properties of the output history files may be changed (Set by RUN_TYPE). Model version to write to history files. Name of the machine you are running the model on to write to history files. Name of user running the model to write to history files. If TRUE, output files in NetCDF large-file format If TRUE, output auxiliary history files for atmosphere to coupler fields every coupling time step. If TRUE, output auxiliary history files for atmosphere to coupler fields every three hours. Set this to true in order to create data that can be later used by datm to run CLM (normally this would only be done for a fully case only) If TRUE, output auxiliary history files for atmosphere to coupler precipitation fields every three hours. If TRUE, output auxiliary history files for atmosphere to coupler fields every 24 hours hours. If TRUE, output auxiliary history files for land to coupler fields every coupling time step. If TRUE, output auxiliary history files for runoff to coupler fields every coupling time step. If TRUE, change mapping in driver to give bit-for-bit results regardless of number of processors used. If TRUE, turn writing of budgets to log file on. Output level for instantaneous budgets. Output level for daily budgets. Output level for monthly budgets. Output level for annual budgets. Output level for long-term annual budgets. (Set with BUDGET_LONGTERM_EOY) Output level for long-term budgets written at the end of the run. (Set with BUDGET_LONGTERM_STOP) Directory name to store timing files Directory name to store timing checkpoint files If TRUE, write out the initial history file If TRUE, turn on barriers around the component run calls. If TRUE, turn threading control on in driver Tolerance to match fractional areas for each component: land, ice, and ocn. Tolerance to match land and atmospheric grid cell latitudes and longitudes. Tolerance to match land and atmospheric grid masks Tolerance to match land and atmospheric grid areas Tolerance to match ocean and ice grid cell latitudes and longitudes. Tolerance to match ocean and ice grid masks Tolerance to match ocean and ice grid areas Stride used in selecting the processes in the atm communicator group. Root process of the atm communicator group. Number of atm tasks. Number of threads in each atm task. Stride used in selecting the processes in the lnd communicator group. Root process of the lnd communicator group. Number of lnd tasks. Number of threads in each lnd task. Stride used in selecting the processes in the ice communicator group. Root process of the ice communicator group. Number of ice tasks. Number of threads in each ice task. Stride used in selecting the processes in the ocn communicator group. Root process of the ocn communicator group. Number of ocn tasks. Number of threads in each ocn task. Stride used in selecting the processes in the glc communicator group. Root process of the glc communicator group. Number of glc tasks. Number of threads in each glc task. Stride used in selecting the processes in the cpl communicator group. Root process of the cpl communicator group. Number of cpl tasks. Number of threads in each cpl task. Coupling interval between the atmosphere and other system components. This is how frequently information can be communicated between the atmosphere and the surface models. (Set by ATM_NCPL) Controls phasing of the coupling with the atmosphere model (seconds). Calendar type "NO_LEAP" for consistent 365-days per year "GREGORIAN" to include leap-years. Note that if "GREGORIAN" is selected leap-years will be used in the time manager, but the calculation of the earth's orbit still assumes 365 day years. Also use of GREGORIAN requires compiling with the full ESMF library. If TRUE, write restart at end of run. Coupling interval between the sea-ice and other system components (seconds). (Set by ICE_NCPL) Controls phasing of the coupling with the sea-ice model (seconds). Coupling interval between the land model and other system components. (Set by LND_NCPL) Controls phasing of the coupling with the land model (seconds). Coupling interval between the ocean model and other system components (seconds). (Set by OCN_NCPL) Controls phasing of the coupling with the ocean model (seconds). Coupling interval between the glacier model and other system components (seconds). (Set by GLC_NCPL) Controls phasing of the coupling with the glacier model (seconds). Reference time-of-day expressed as seconds past midnight. Used in conjunction with ref_ymd to set the reference time. Reference date encoded in an integer as (year*1000 + month*100 + day). Used in conjunction with ref_tod to set the reference time which is used to define a time coordinate for the output history files. The convention for the unit string of a time coordinate is of the form "time-unit since reference-time", for example, "days since 1990-01-01 00:00:00". The reference-time part of this string is specified by the ref_ymd and ref_tod variables. Set the restart interval as a number of elapsed time units which are specified by restart_option. Set the interval between writing restart files using one of the options 'nsteps', 'ndays', 'nmonths', or 'nyears', in conjunction with restart_n to set the number of time units. A convenience option allows specifying that restart files be written at the end of each month or at the end of each year by using the options 'monthly' or 'yearly' respectively. It is also possible to request that no restart files be written via the option 'never', or that restart files be written only at the end of the run via the option 'end'. "ifdays0" means to write restart files at the beginning of the next year and every year after. Restart date encoded in an integer as (year*1000 + month*100 + day). Used in conjunction with restart_option to set the date to write restart files for the simulation. Set the history file write interval as a number of elapsed time units which are specified by history_option. Set the interval between writing history files using one of the options 'nsteps', 'ndays', 'nmonths', or 'nyears', in conjunction with historyt_n to set the number of time units. A convenience option allows specifying that history files be written at the end of each month or at the end of each year by using the options 'monthly' or 'yearly' respectively. It is also possible to request that no history files be written via the option 'never', or that history files be written only at the end of the run via the option 'end'. "ifdays0" means to write history files at the beginning of the next year and each year after. History file write date encoded in an integer as (year*1000 + month*100 + day). Used in conjunction with history_option to set the date to write history files for the simulation. Set the interval to write averaged history files as a number of elapsed time units which are specified by histavg_option. Set the interval between writing averaged history files using one of the options 'nsteps', 'ndays', 'nmonths', or 'nyears', in conjunction with histavg_n to set the number of time units. A convenience option allows specifying that averaged history files be written at the end of each month or at the end of each year by using the options 'monthly' or 'yearly' respectively. It is also possible to request that no averaged history files be written via the option 'never', or that averaged history files be written only at the end of the run via the option 'end'. "ifdays0" means to write averaged history files at the beginning of the next year and each year after. Averaged history file write date encoded in an integer as (year*1000 + month*100 + day). Used in conjunction with histavg_option to set the date to write averaged history files for the simulation. Start time-of-day expressed as seconds past midnight. Used in conjunction with start_ymd to set the start time. Run start date encoded as YYYY-MM-DD Run stop date encoded as YYYY-MM-DD Start date encoded in an integer as (year*1000 + month*100 + day). Used in conjunction with start_tod to set the start date of the simulation. Current time-of-day expressed as seconds past midnight. Used in conjunction with curr_ymd to set the current time (normally set to start_tod). Current date encoded in an integer as (year*1000 + month*100 + day). Used in conjunction with curr_tod to set the current date of the simulation (normally set to start_tod). Set the length of run as a number of elapsed time units which are specified by stop_option. Set the length of run as an elapsed time using one of the options 'nsteps', 'ndays', 'nmonths', or 'nyears', in conjunction with stop_n to set the number of elapsed time units. Alternatively, set the final simulation time in absolute terms by using the option 'date' in conjunction with stop_ymd, and stop_tod to specify a date and time of day at which the simulation should stop. "ifdays0" means to stop at the beginning of the next year. Stop time-of-day expressed as seconds past midnight. Used in conjunction with stop_ymd to set the stop time. Stop date encoded in an integer as (year*1000 + month*100 + day). Used in conjunction with stop_option to set the stop date of the simulation. Set the interval for time-profiling as a number of elapsed time units which are specified by tprof_option. Set the time-profiling write time as an elapsed time using one of the options 'nsteps', 'ndays', 'nmonths', or 'nyears', in conjunction with tprof_n to set the number of elapsed time units. If TRUE, turn on barriers before running a performance section. If TRUE, disable all performance profilers If TRUE, send output to a single file (rather than separate files per MPI task). If TRUE, do global statistics If TRUE, enable the PAPI namelist integer indicating maximum number of levels of timer nesting. Number of output processors for profiling Stride of output processors for profiling integer indicating maximum detail level to profile. integer indicating which timer to use. As defined in gptl.inc. Performance Application Programming Interface (PAPI) counter option number 1 (Set to valid PAPI counter strings such as: PAPI_TOT_CYC, PAPI_TOT_INS, PAPI_FP_OPS, or PAPI_FP_INS). PAPI counter option number 2 (Set to valid PAPI counter strings such as: PAPI_TOT_CYC, PAPI_TOT_INS, PAPI_FP_OPS, or PAPI_FP_INS). PAPI counter option number 3 (Set to valid PAPI counter strings such as: PAPI_TOT_CYC, PAPI_TOT_INS, PAPI_FP_OPS, or PAPI_FP_INS). PAPI counter option number 4 (Set to valid PAPI counter strings such as: PAPI_TOT_CYC, PAPI_TOT_INS, PAPI_FP_OPS, or PAPI_FP_INS). If TRUE, use PIO asynchronously (Experimental and NOT supported) Debug printing level for PIO Stride to use for PIO tasks Root PE for PIO output processing Number of tasks to use for PIO Type of output files for PIO Stride to use for coupler PIO tasks Root PE for coupler PIO output processing Number of tasks to use for coupler PIO Type of output files for coupler PIO Stride to use for lnd PIO tasks Root PE for lnd PIO output processing Number of tasks to use for lnd PIO Type of output files for lnd PIO Stride to use for atm PIO tasks Root PE for atm PIO output processing Number of tasks to use for atm PIO Type of output files for atm PIO Flags for physics options with respect to how to handle input data. (Set with DATM_MODE) File containing domain info. Fill algorithm Fill mask Fill mapping file to read Fill mapping file to write Scalar mapping mask Scalar mapping algorithm Regrid mapping file to read Regrid mapping file to write Time interpolation algorithm method coszen = Scale according to the cosine of the solar zenith angle (for solar) nearest = Use the nearest time-value linear = Linearly interpolate between the two time-values lower = Use lower time-value upper = Use upper time-value Time axis mode extend = extrapolate before and after the period by using the first or last value. cycle = cycle between the range of data limit = restrict to the period for which the data is valid Limit of delta-time ratio allowed. Highest time difference over minimum time-difference. Character array of stream description file names Character array of vector description file names File containing tn460 correction factors (not valid for any CLM DATM7 modes) DATM Decomposition strategy 1d = Vector decomposition root = run only on the master task If TRUE, prescribed aerosols are coming from the data atmosphere model (datm) (Must be true for running with CLM). Namelist filename for data model share stream data namelist Frequency to update radiation in number of steps (or hours if negative) Master restart file name for datm model Stream restart file name for datm model, needed for branch simulations Description of data source for datm input data. (Normally set by DATM_MODE) [NOTE: we only list the valid CLM options here] CLM_QIAN = Run with the CLM Qian dataset valid from 1948 to 2004 CPLHIST3HrWx = Run with CESM 3-hourly coupler history output CLM1PT = Run with supplied single point data Prescribed aerosol file name, full path (Normally set according to DATM_PRESAERO) Prescribed aerosol initial year (Normally set according to DATM_PRESAERO) Prescribed aerosol last year (Normally set according to DATM_PRESAERO) Prescribed aerosol model year to align to first year (Normally set according to DATM_PRESAERO) Beginning of year to cycle datm data through (Normally set by DATM_CLMNCEP_YR_START or DATM_CPL_YR_START) End of year to cycle datm data through (Normally set by DATM_CLMNCEP_YR_END or DATM_CPL_YR_END) datm input directory datm output directory Datm logfile name 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. Glacier model grid gland20 = Greenland at 20km resolution gland10 = Greenland at 10km resolution gland5 = Greenland at 5km resolution none = no glacier model grid Horizontal resolutions Note: 0.5x0.5 and 0.33x0.33 are only used for CLM tools Representative concentration pathway for future scenarios [radiative forcing at peak or 2100 in W/m^2] -999.9 means do NOT use a future scenario, just use historical data. Land mask description If TRUE, irrigation will be active (find surface datasets with active irrigation). Resolution for River Transport Model (RTM) 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. A sim_year greater than 2005 corresponds to rcp scenario data 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. Prescribed aerosol mode for the atmosphere model prognostic = Pass aerosol from a prognostic atmosphere model -- such as CAM. (may still be read in from a dataset in that model) pt1_pt1 = For datm use a single point dataset clim_1850 = For datm use constant 1850 conditions clim_2000 = For datm use constant 2000 conditions trans_1850-2000 = For datm use transient 1850 to 2000 conditions rcp2.6 = For datm use rcp=2.6 future scenario rcp4.5 = For datm use rcp=4.5 future scenario rcp6 = For datm use rcp=6.0 future scenario rcp8.5 = For datm use rcp=8.5 future scenario Where dry deposition is calculated (from land, atmosphere, or from a table) List of chemical constituents that dry deposition will be calculated for