CAM Component Model Namelist Variables

Full pathname of initial atmospheric state dataset (NetCDF format).

Default: set by build-namelist.

Perturb the initial conditions for temperature randomly by up to the given
amount. Only applied for initial simulations.

Default: 0.0

If TRUE, try to initialize data for all consituents by reading from the
initial conditions dataset. If variable not found then data will be
initialized using internally-specified default values.  If FALSE then don't
try reading constituent data from the IC file; just use the
internally-specified defaults.

Default: TRUE

Full pathname of master restart file from which to branch. Setting is
Required for branch run.

Default: none

Full pathname of master restart file from which to branch. Setting is
Required for branch run.

Default: none

Full pathname of master restart file from which to branch. Setting is
Required for branch run.

Default: none

Sets the averaging flag for all variables on a particular history file
series. Valid values are:

 A ==> Average
 B ==> GMT 00:00:00 average
 I ==> Instantaneous
 M ==> Minimum
 X ==> Maximum

The default is to use the averaging flags for each variable that are set in
the code via calls to subroutine addfld.


Defaults: set in code via the addfld and add_default subroutine calls.

if .true. then output CLUBBs history statistics

Name of the IOP case so case specific adjustments can be made in CLUBB.  

Default: none.

if .true. then output CLUBBs radiative history statistics

Same as fincl1, but for CLUBB statistics on radiation zm grid.

Default: none.

Same as fincl1, but for CLUBB statistics on radiation zt grid.

Default: none.

Same as fincl1, but for CLUBB statistics on surface.

Default: none.

Same as fincl1, but for CLUBB statistics on zm grid.

Default: none.

Same as fincl1, but for CLUBB statistics on zt grid.

Default: none.

Collect all column data into a single field and output in ncol format,
much faster than default when you have a lot of columns.

If true don't put any of the variables on the history tapes by
default. Only output the variables that the user explicitly lists in
the fincl# namelist items.  
Default: FALSE

List of fields to exclude from the 1st history file (by default the name
of this file contains the string "h0").

Default: none

List of fields to exclude from the 2nd history file (by default the name
of this file contains the string "h1").

Default: none

List of fields to exclude from the 3rd history file (by default the name
of this file contains the string "h2").

Default: none

List of fields to exclude from the 4th history file (by default the name
of this file contains the string "h3").

Default: none

List of fields to exclude from the 5th history file (by default the name
of this file contains the string "h4").

Default: none

List of fields to exclude from the 6th history file (by default the name
of this file contains the string "h5").

Default: none

List of fields to include on the first history file (by default the name of
this file contains the string "h0").  The added fields must be in Master
Field List.  The averaging flag for the output field can be specified by
appending a ":" and a valid averaging flag to the field name.  Valid flags
are:

 A ==> Average
 B ==> GMT 00:00:00 average
 I ==> Instantaneous
 M ==> Minimum
 X ==> Maximum


Default:  set in code via the addfld and add_default subroutine calls.

List of columns or contiguous columns at which the fincl1 fields will be
output. Individual columns are specified as a string using a longitude
degree (greater or equal to 0.) followed by a single character
(e)ast/(w)est identifer, an underscore '_' , and a latitude degree followed
by a single character (n)orth/(s)outh identifier.  For example, '10e_20n'
would pick the model column closest to 10 degrees east longitude by 20
degrees north latitude.  A group of contiguous columns can be specified
using bounding latitudes and longitudes separated by a colon.  For example,
'10e:20e_15n:20n' would select the model columns which fall with in the
longitude range from 10 east to 20 east and the latitude range from 15
north to 20 north.

Default: none

Same as fincl1, but for the 2nd history file (by default
the name of this file contains the string "h1").

Default: none.

Same as fincl1lonlat, but for 2nd history file.

Same as fincl1, but for the 3rd history file (by default
the name of this file contains the string "h2").

Default: none.

Same as fincl1lonlat, but for 3rd history file.

Same as fincl1, but for the 4th history file (by default
the name of this file contains the string "h3").

Default: none.

Same as fincl1lonlat, but for 4th history file.

Same as fincl1, but for the 5th history file (by default
the name of this file contains the string "h4").

Default: none.

Same as fincl1lonlat, but for 5th history file.

Same as fincl1, but for the 6th history file (by default
the name of this file contains the string "h5").

Default: none.

Same as fincl1lonlat, but for 6th history file.

Specific fields which will be written using the non-default precision on
the 1st history file.

Default: none

Specific fields which will be written using the non-default precision on
the 2nd history file.

Default: none

Specific fields which will be written using the non-default precision on
the 3rd history file.

Default: none

Specific fields which will be written using the non-default precision on
the 4th history file.

Default: none

Specific fields which will be written using the non-default precision on
the 5th history file.

Default: none

Specific fields which will be written using the non-default precision on
the 6th history file.

Default: none

Array of history filename specifiers.  The filenames of up to six history
output files can be controlled via this variable.  Filename specifiers give
generic formats for the filenames with specific date and time components,
file series number (0-5), and caseid, filled in when the files are
created. The following strings are expanded when the filename is created:
%c=caseid; %t=file series number (0-5); %y=year (normally 4 digits, more
digits if needed); %m=month; %d=day; %s=seconds into current day; %%=%
symbol.  Note that the caseid may be set using the namelist
variable case_name.

For example, for a simulation with caseid="test" and current date and time
of 0000-12-31 0:00UT, a filename specifier of "%c.cam2.h%t.%y-%m.nc" would
expand into "test.cam2.h0.0000-12.nc" for the first history file.  The
filename specifier "%c.cam2.h%t.%y-%m-%d-%s.nc" would expand to
"test.cam2.h1.0000-12-31-00000.nc" for the second history file. Spaces are
not allowed in filename specifiers. Although the character "/" is allowed
in the specifier, it will be interpreted as a directory name and the
corresponding directories will have to be created in the model execution
directory (directory given to configure with -cam_exedir option) before
model execution.  The first element is for the primary history file which
is output by default as a monthly history file.  Entries 2 through 6 are
user specified auxilliary output files.


Defaults: "%c.cam2.h0.%y-%m.nc", "%c.cam2.h1.%y-%m-%d-%s.nc", ...,
          "%c.cam2.h5.%y-%m-%d-%s.nc"

Frequency that initial files will be output: 6-hourly, daily, monthly,
yearly, or never.  Valid values: 'NONE', '6-HOURLY', 'DAILY', 'MONTHLY',
'YEARLY', 'CAMIOP', 'ENDOFRUN'.

Default: 'YEARLY'

If false then include only REQUIRED fields on IC file.  If true then
include required AND optional fields on IC file.  

Default: FALSE

Array containing the starting time of day for local time history averaging. 
Used in conjuction with lcltod_stop. If lcltod_stop is less than lcltod_start, 
then the time range wraps around 24 hours. The start time is included in the 
interval. Time is in seconds and defaults to 39600 (11:00 AM).  The first value 
applies to the primary hist. file, the second to the first aux. hist. file, etc.

Default: none

Array containing the stopping time of day for local time history averaging. 
Used in conjuction with lcltod_start. If lcltod_stop is less than lcltod_start, 
then the time range wraps around 24 hours. The stop time is not included in the 
interval. Time is in seconds and defaults to 0 (midnight).  The first value 
applies to the primary hist. file, the second to the first aux. hist. file, etc.

Default: none

Array containing the maximum number of time samples written to a history
file.  The first value applies to the primary history file, the second
through sixth to the auxillary history files.

Default: 1,30,30,30,30,30

 

Array specifying the precision of real data written to each history file
series. Valid values are 1 or 2. '1' implies output real values are 8-byte
and '2' implies output real values are 4-byte.


Default: 2,2,2,2,2,2

 

Array of write frequencies for each history file series.
If nhtfrq(1) = 0, the file will be a monthly average.
Only the first file series may be a monthly average.  If
nhtfrq(i) > 0, frequency is specified as number of
timesteps.  If nhtfrq(i) < 0, frequency is specified
as number of hours.


Default: 0,-24,-24,-24,-24,-24

List of history fields to output along the satellite track specified by  sathist_track_infile

Default: none

Satellite track history filename specifier.  See hfilename_spec

Default:  "%c.cam2.sat.%y-%m-%d-%s.nc"

Sets the number of observation columns written the satellite track history file
series. 

Default: 100000

Sets the number of columns closest to the observation that should be output. Setting
this to a number greater than 1 allows for spatial interpolation in the post processing.

Default: 1

Sets the number of timesteps closest to the observation that should be output. Setting
this to a number greater than 1 allows for temporal interpolation in the post processing.

Default: 1

Full pathname of the satellite track data used by the satellite track history 
output feature.

Default: none 

Use 64-bit netCDF format for cam history files.

Default: TRUE

Output constituent tendencies due to convection.  Set to
'none', 'q_only' or 'all'.

Default: 'q_only', but 'none' for WACCM configurations.

Turns on TEM circulation diagnostics history output.  Only valid for FV dycore.

do_circulation_diags MUST be .true. in all FV cases with WACCM's QBO forcing
enabled. Cases with qbo_use_forcing = .true. and do_circulation_diags =
.false. will produce invalid output.


Default: FALSE

Switch for diagnostic output of the aerosol tendencies

Default: .false.

Switch for cam4 T/Q budget diagnostic output

Default: .false.

History tape number T/Q budget output is written to.

Default: 1

Switch for diagnostic output of microphysics variables 

Default: .false.

Turn on verbose output identifying columns that fail energy/water 
conservation checks.

Default: FALSE

If true, the active COSP cloud simulators are run to produce 
select output for the AMWG diagnostics package.
sets cosp_ncolumns=10 and cosp_nradsteps=3 
(appropriate for COSP statistics derived from seasonal averages),
and runs CloudSat radar and CALIPSO lidar simulators 
(cosp_lradar_sim=.true.,cosp_llidar_sim=.true.).
This default logical is set in cospsimulator_intr.F90.

Default: FALSE

If true, COSP cloud simulators are run to produce 
all output required for the COSP plots in the AMWG diagnostics package.
sets cosp_ncolumns=10 and cosp_nradsteps=3 
(appropriate for COSP statistics derived from seasonal averages),
and runs MISR, ISCCP, MODIS, CloudSat radar and CALIPSO lidar simulators 
(cosp_lmisr_sim=.true.,cosp_lisccp_sim=.true.,
cosp_lmodis_sim=.true.,cosp_lradar_sim=.true.,cosp_llidar_sim=.true.).
This default logical is set in cospsimulator_intr.F90.

Default: TRUE

Path for the Atrain orbit data file provided by CFMIP.
There is no default for this, but sample_atrain = .true. will not work 
if this namelist variable is undefined.
currently /project/cms/jenkay/SCAM/repository/cloudsat_orbit_08921_14250.nc

Default: no default set now, need to specify in namelist

If true, the COSP cloud simulator is run for CFMIP 3-hourly 
experiments.
This default logical is set in cospsimulator_intr.F90

Default: FALSE

If true, the COSP cloud simulator is run for CFMIP daily 
experiments.
This default logical is set in cospsimulator_intr.F90

Default: FALSE

If true, the COSP cloud simulator is run for CFMIP monthly
experiments.
This default logical is set in cospsimulator_intr.F90

Default: FALSE

If true, the COSP cloud simulator is run for CFMIP off-line  
monthly experiments.
This default logical is set in cospsimulator_intr.F90

Default: FALSE

If true, additional output is added to make it possible to
run COSP off-line.

This default is set in cospsimulator_intr.F90

Default: FALSE

This specifies the CAM history tape where extra COSP diagnostics will be written.

This default is set in cospsimulator_intr.F90

Default: 2

This specifies the CAM history tape where COSP diagnostics will be written.
Ignored/not used if any of the cosp_cfmip_* namelist variables are invoked.

This default is set in cospsimulator_intr.F90

Default: 1

If true, the ISCCP cloud simulator is run to produce 
select output for the AMWG diagnostics package.
sets cosp_ncolumns=10 and cosp_nradsteps=3 
(appropriate for COSP statistics derived from seasonal averages),
and runs ISCCP simulator
(cosp_lmisr_sim=.false.,cosp_lisccp_sim=.true.,
cosp_lmodis_sim=.false.,cosp_lradar_sim=.false.,cosp_llidar_sim=.false.).
This default logical is set in cospsimulator_intr.F90.
1236: 
Default: FALSE

Turns on sub-column output from COSP.
If both the isccp/misr simulators and the lidar/radar simulators
are run, lfrac_out is from the isccp/misr simulators columns.
This default logical is set in cospsimulator_intr.F90

Default: FALSE

If true, COSP ISCCP simulator will be run and all non-subcolumn output
will be saved.  ISCCP simulator is run on only daylight
columns.

Default: FALSE

If true, the COSP cloud simulators are run to produce 
select output for the AMWG diagnostics package.
sets cosp_ncolumns=10 and cosp_nradsteps=3 
(appropriate for COSP statistics derived from seasonal averages),
and runs MISR, ISCCP, MODIS, and CALIPSO lidar simulators 
(cosp_lmisr_sim=.true.,cosp_lisccp_sim=.true.,
cosp_lmodis_sim=.true.,cosp_llidar_sim=.true.).
This default logical is set in cospsimulator_intr.F90.

Default: FALSE

If true, COSP lidar simulator will be run and all non-subcolumn output
will be saved

Default: FALSE

If true, MISR simulator will be run and all non-subcolumn output
will be saved.  MISR simulator is run on only daylight
columns.

Default: FALSE

If true, MODIS simulator will be run and all non-subcolumn output
will be saved.


Default: FALSE

If true, COSP radar simulator will be run and all non-subcolumn output 
will be saved.

Default: FALSE

Number of subcolumns in SCOPS
This default logical is set in cospsimulator_intr.F90

Default: 50

This specifies the frequency at which is COSP is called, 
every cosp_nradsteps radiation timestep.

This default is set in cospsimulator_intr.F90

Default: 1

If true, the passive COSP cloud simulators are run to produce 
select output for the AMWG diagnostics package.
sets cosp_ncolumns=10 and cosp_nradsteps=3 
(appropriate for COSP statistics derived from seasonal averages),
and runs MISR, ISCCP, and MODIS simulators 
(cosp_lmisr_sim=.true.,cosp_lisccp_sim=.true.,cosp_lmodis_sim=.true.).
This default logical is set in cospsimulator_intr.F90.

Default: FALSE

If true, run all simulators using the default values cosp_ncolumns=50 and
cosp_nradsteps=1.  This option is mainly intended for testing, but it also
must be used in order to output the input fields needed to run the
simulator in an offline mode (via setting cosp_histfile_aux=.true.).

Default: FALSE

Turns on sampling along a-train orbit for radar and lidar simulators.
This default logical is set in cospsimulator_intr.F90

Default: FALSE

If true, the COSP cloud simulator is run.
Setting this namelist variable happens automatically if you compile with COSP.
COSP will not run unless this is set to .true. in the namelist!
Turn on the desired simulators using lXXX_sim namelist vars
If no specific simulators are specified, all of the simulators
are run on all columns and all output is saved. (useful for testing). 
COSP is available with CAM4 and CAM5 physics.
This default logical is set in cospsimulator_intr.F90.

Default: FALSE

If true age of air tracers are read from the initial conditions file.
If this is not specified then they are not read from IC file.

Default: TRUE

If true age of air tracers are included.  This variable should not be set
by the user.  It will be set by build-namelist to be consistent with the
'-age_of_air_trcs' argument specified to configure.

Default: set by configure

This variable should not be set by the user.  If configure has been invoked
with the '-nadv_tt N' option then build-namelist will set this flag to true
which turns on the test tracer code.  Also, if the user invokes configure
with the option '-nadv N', and N is larger than the number of advected
constituents requested by all other physics and chemistry
parameterizations, then the number of test tracers is chosen
dynamically to fill the available slots in the constituents array up to the
total number requested by the -nadv option.

Default: set by configure

Full pathname of time-invariant boundary dataset for topography fields.

Default: set by build-namelist.

Full pathname of boundary dataset for tropopause climatology.

Default: set by build-namelist.

Overlapping of trac2d and cd_core subcycles.

Default: 0

Chooses level of velocity diffusion.

Default: 3.0e5

Chooses type of divergence damping and velocity diffusion.
div24del2flag = 2 for ldiv2 (default),
              = 4 for ldiv4,
              = 42 for ldiv4 + ldel2
where
ldiv2: 2nd-order divergence damping everywhere and increasing in top layers
ldiv4: 4th-order divergence damping
ldel2: 2nd-order velocity-component damping targetted to top layers,
       with coefficient del2coef


Default: set by build-namelist

1 for FFT filter always, 0 for combined algebraic/FFT filter.  The value 0
is used for CAM3, otherwise it is using the value 1.  In the CAM3
version of the model it was necessary to build with the CPP
variable ALT_PFT defined to get the behavior now obtained by setting fft_flt=1.

Default: set by build-namelist

Enables optional filter for intermediate c-grid winds, (courtesy of Bill Putman).

Default: 0

Set to 1 to force the 2D transpose computation when a 1D decomposition is
used.  This is intended for debugging purposes only.

Default: 0

Geopotential method 2 pipeline parameter (routine geopk_d).
geopk_d implements a pipeline algorithm by dividing the 
information that must be moved between processes into blocks. geopkblocks
specifies the number of blocks to use. The larger the number of blocks,
the greater the opportunity for overlapping communication with computation
and for decreasing instantaneous bandwidth requirements. The smaller the
number of blocks, the fewer MPI messages sent, decreasing MPI total latency.
See geopk_d within geopk.F90.

Default: 1

Geopotential method (routines geopk, geopk16, or geopk_d).
0 for transpose method, 1 for method using semi-global z communication 
with optional 16-byte arithmetic, 2 for method using local
z communication; method 0, method 1 with 16-byte arithmetic and method 2 
are all bit-for-bit across decompositions; method 0 scales better than 
method 1 with npr_z, and method 1 is superior to method 0 for small npr_z.
The optimum speed is attained using either method 1 with 8-byte 
arithmetic (standard for geopk16) or method 2 when utilizing the 
optimal value for the associated parameter geopkblocks; for the last 
two subcycles of a timestep, method 0 is automatically used; see 
geopk.F90 and cd_core.F90.


Default: 0

Order (mode) of X interpolation (1,..,6).
East-West transport scheme (used with Finite Volume dynamical core only).

Default: 4

Order (mode) of Y interpolation (1,..,6).
North-South transport scheme (used with Finite Volume dynamical core only).

Default: 4

Scheme to be used for vertical mapping.

Default: 4

True for mod_comm irregular communication handshaking for cd_core/geopk

Default: .true.

True for mod_comm irregular communication handshaking for dyn_run/misc

Default: .true.

True for mod_comm irregular communication handshaking for gather

Default: .true.

True for mod_comm irregular communication handshaking for scatter

Default: .true.

True for mod_comm irregular communication handshaking for multiple tracers

Default: .true.

Maximum number of outstanding nonblocking MPI requests to allow when
using mp_swapirr and point-to-point communications for cd_core/geopk.
Setting this less than the maximum can improve robustness for large process 
count runs. If set to less than zero, then do not limit the number of
outstanding send/receive requests.

Default: -1 (so no limit)

Maximum number of outstanding nonblocking MPI requests to allow when
using mp_swapirr and point-to-point communications for dyn_run/misc. 
Setting this less than the maximum can improve robustness for large process 
count runs. If set to less than zero, then do not limit the number of
outstanding send/receive requests.

Default: -1 (so no limit)

Maximum number of outstanding nonblocking MPI requests to allow when
using mp_swapirr and point-to-point communications for gather.
Setting this less than the maximum can improve robustness for large process 
count runs. If set to less than zero, then do not limit the number of
outstanding send/receive requests.

Default: -1 (so no limit)

Maximum number of outstanding nonblocking MPI requests to allow when
using mp_swapirr and point-to-point communications for scatter.
Setting this less than the maximum can improve robustness for large process 
count runs. If set to less than zero, then do not limit the number of
outstanding send/receive requests.

Default: -1 (so no limit)

Maximum number of outstanding nonblocking MPI requests to allow when
using mp_swaptrirr and point-to-point communications for multiple tracers.
Setting this less than the maximum can improve robustness for large process 
count runs. If set to less than zero, then do not limit the number of
outstanding send/receive requests.

Default: -1 (so no limit)

One or two simultaneous mod_comm irregular communications (excl. tracers)

Default: 1

True for geopk_d and mod_comm irregular communication blocking send for 
cd_core/geopk; false for nonblocking send.

Default: .true.

True for mod_comm irregular communication blocking send for dyn_run/misc,
false for nonblocking send

Default: .true.

True for mod_comm irregular communication blocking send for gather,
false for nonblocking send

Default: .true.

True for mod_comm irregular communication blocking send for scatter,
false for nonblocking send

Default: .true.

True for mod_comm irregular communication blocking send for multiple
tracers, false for nonblocking send

Default: .true.

Mod_comm irregular underlying communication method for cd_core/geopk
0 for original mp_sendirr/mp_recvirr
1 for mp_swapirr and a point-to-point implementation of communication pattern
2 for mp_swapirr and a collective (MPI_Alltoallv) implementation of communication pattern

Default: 0

Mod_comm irregular underlying communication method for dyn_run/misc.
0 for original mp_sendirr/mp_recvirr
1 for mp_swapirr and a point-to-point implementation of communication pattern
2 for mp_swapirr and a collective (MPI_Alltoallv) implementation of communication pattern

Default: 0

Mod_comm irregular underlying communication method for gather
0 for original mp_sendirr/mp_recvirr
1 for mp_swapirr and a point-to-point implementation of communication pattern
2 for mp_swapirr and a collective (MPI_Alltoallv) implementation of communication pattern

Default: 0

Mod_comm irregular underlying communication method for scatter
0 for original mp_sendirr/mp_recvirr
1 for mp_swapirr and a point-to-point implementation of communication pattern
2 for mp_swapirr and a collective (MPI_Alltoallv) implementation of communication pattern

Default: 0

Mod_comm irregular underlying communication method for multiple tracers
0 for original mp_sendtrirr/mp_recvtrirr
1 for mp_swaptrirr and point-to-point communications
2 for mp_swaptrirr and all-to-all communications

Default: 0

Max number of tracers for simultaneous mod_comm irregular communications

Default: 1

For mod_comm gather/scatters, 0 for temporary contiguous buffers; 1 for mpi derived
types.

Default: 0

For geopk (geopktrans=1) messages, 0 for temporary contiguous buffers; 1 for mpi derived
types.

Default: 0

For mod_comm transposes, 0 for temporary contiguous buffers; 1 for mpi derived
types.

Default: 0

A four element integer array which specifies the YZ and XY decompositions.
The first two elements are the number of Y subdomains and number of Z
subdomains in the YZ decomposition.  The second two elements are the number
of X subdomains and the number of Y subdomains in the XY decomposition.
Note that both the X and Y subdomains must contain at least 3 grid points.
For example, a grid with 96 latitudes can contain no more than 32 Y
subdomains.  There is no restriction on the number of grid points (levels)
in a Z subdomain, but note that the threading parallelism in the FV dycore
is over levels, so for parallel efficiency it is best to have at least the
number of levels in each Z subdomain as there are threads available.

There are a couple of rough rules of thumb to follow when setting the 2D
decompositions.  The first is that the number of Y subdomains in the YZ
decomposition should be the same as the number of Y subdomains in the XY
decomposition (npr_yz(1) == npr_yz(4)).  The second is that the total
number of YZ subdomains (npr_yz(1)*npr_yz(2)) should equal the total number
of XY subdomains (npr_yz(3)*npr_yz(4)).


Default: ntask,1,1,ntask where ntask is the number of MPI tasks.  This is a
1D decomposition in latitude.

Number of dynamics timesteps per physics timestep. If zero, a best-estimate
will be automatically calculated.

Default: 0

Number of tracer advection timesteps per physics timestep.
Nsplit is partitioned into nspltrac and nsplit/nspltrac,
with the latter being the number of dynamics timesteps per
tracer timestep, possibly rounded upward; after initialization,
the code quantity nsplit is redefined to be the number of
dynamics timesteps per tracer timestep.

Default: 0

Number of vertical re-mapping timesteps per physics timestep.
Nspltrac is partitioned into nspltvrm and nspltrac/nspltvrm,
with the latter being the number of tracer timesteps per
re-mapping timestep, possibly rounded upward; after initialization,
the code quantity nspltrac is redefined to be the number of
tracer timesteps per re-mapping timestep.

Default: 0

Size of tracer domain decomposition for trac2d.

Default: 1

TRUE => the offline meteorology winds are defined on the model grid cell walls.

Default: FALSE

Name of file that contains the offline meteorology data.

Default: none

Name of directory that contains the offline meteorology data.

Default: none

Name of file that contains names of the offline meteorology data files.

Default: none

switch to turn on/off mass fixer for offline driver 

Default: true

maximum of vertical relaxation function in bottom portion

Default: 1.0

multiplication factor for water vapor flux

Default: 1.0

water vapor flux field name in met data file

Default:

TRUE => the offline meteorology file will be removed from local disk when no longer needed.

Default: FALSE

(km) bottom of relaxation region of winds for offline waccm

Default:

(km) top of relaxation region of winds for offline waccm

Default: 

multiplication factor for srf heat flux

Default: 1.0

srf heat flux field name in met data file

Default:

multiplication factor for snow hieght

Default: 1.0

if false then do not allow surface models feedbacks influence climate

Default: true

if true nudge meteorology surface fields TAUX, TAUY, SHFLX, QFLX rather than force

Default: true

Default: 3

Default: 2

Time integration (explicit or semi_implicit).

Default: "explicit"

Hyperviscosity [m^4/s].

Default: 7.0e5

Hyperviscosity [m^4/s].

Default: 7.0e5

Viscosity [m^2/s].

Default: 2.5e5

Default: none

CAM physics forcing option: 0 = tendencies, 1 = adjustments, 2 = hybrid.

Default: 0

Homme limiter option

Default: 4

Default: none

Number of dynamics steps per physics timestep.

Default: none

Default: 1

Default: 0

Physics timescale (in seconds) used to compute physics tendencies

Default: 0 = feature disabled, use dtime.  

Timestep filter.

Default: 0.05

Default: "cube"

Default: 1

del^2 horizontal diffusion coefficient. 
Default: resolution dependent,
e.g. 2.5e5 for T42 EUL.

del^4 horizontal diffusion coefficient. 
Default: resolution dependent,
e.g. 1.0e16 for T42 EUL.

Number of days (from timestep 0) to run divergence damper. Use only if spectral
model becomes dynamicallly unstable during initialization. Suggested value:
2. (Value must be >= 0.)  
Default: 0.

Spectral dynamics gather option.

Default: 0

Spectral dynamics transpose option.

Default: 0

Flag indicating whether to assign latitudes to equidistribute columns or
latitudes. This only matters when using a reduced grid.

Default: TRUE

Number of processes assigned to dynamics (HOMME, EUL and SLD dycores).

Default: Total number of processes assigned to job.

Stride for dynamics processes (EUL and SLD dycores).
E.g., if stride=2, assign every second process to the dynamics.

Default: 1

Time filter coefficient.  
Default: 0.06

Number of dynamics timesteps per physics timestep. If zero, a best-estimate
will be automatically calculated.

Default: 1

Number of levels over which to apply Courant limiter, starting at top of
model.

Default: 5

Number of layers from the top of the model over which to do dry convective
adjustment. Must be less than plev (the number of vertical levels).

Default: 3

Critical RH for ice clouds (Wilson & Ballard scheme).

Default: 0.93

Scheme for ice cloud fraction: 1=wang & sassen, 2=schiller (iciwc),  
3=wood & field, 4=Wilson (based on smith), 5=modified slingo (ssat & empyt cloud)

Default: 5

Bottom height (Pa) for mid-level liquid stratus fraction.

Default: 700.e2

Adjustment to rhminl for land without snow cover.

Default: 0.10

Tunable constant for evaporation of precip in RK microphysics scheme.

Default: set by build-namelist

Threshold for autoconversion of cold ice in RK microphysics scheme.

Default: set by build-namelist

Threshold for autoconversion of warm ice in RK microphysics scheme.

Default: set by build-namelist

Critical radius at which autoconversion become efficient in RK microphysics
scheme.

Default: set by build-namelist

Type of deep convection scheme employed.  'ZM' for Zhang-McFarlane;
'off' for none.

Default: 'ZM'

Perform mass conservation check on eddy diffusion operation.

Default: FALSE

Switch for CLUBB_SGS

Default: FALSE

Maximum master length scale designed to address issues in diag_TKE outside the
boundary layer.
In order not to disturb turbulence characteristics in the lower troposphere,
this should be set at least larger than a few km. However, this does not
significantly improve the values outside of the boundary layer. Smaller values
make some improvement, but it is also noisy. Better results are seen using
eddy_leng_max or kv_freetrop_scale.

Default: 40.e3 (m)

Maximum dissipation length scale designed to address issues with diag_TKE outside
the boundary layer, where the default value generates large diffusivities. A value
of 30 m is consistent with the length scales used in the HB scheme; however, this
will also reduce value in the boundary layer.

Default: 40.e3 (m)

Bottom pressure level at which namelist values for eddy_leng_max and 
eddy_lbulk_max are applied. Default values are used at lower levels (i.e. the 
boundary layer).

Default: 100.e3 (hPa)

Rain water autoconversion coefficient for Hack shallow scheme.

Default: set by build-namelist

Characteristic adjustment time scale for Hack shallow scheme.

Default: set by build-namelist

Scaling factor that is applied (multiplied) to the eddy diffusivities
in the free troposphere (boundary layer to kv_top_pressure)

Default: 1.0

Pressure (Pa) that defined the upper atmosphere for adjustment of
eddy diffusivities from diag_TKE using kv_top_scale.

Default: 0.

Scaling factor that is applied (multiplied) to the eddy diffusivities
in the upper atmosphere (see kv_top_pressure).

Default: 1.0

Switch to control whether Park macrophysics should prognose
cloud ice (cldice).

Default: .true.

Switch to control whether Park macrophysics should prognose
cloud liquid (cldliq).

Default: .true.

Switch to control whether Park macrophysics should perform
detrainment into the stratiform cloud scheme.

Default: .true.

Type of macrophysics scheme employed.  'park' for Park
(1998); 'RK' for Rasch and Kristjansson (1998); 'CLUBB_SGS' clubb.

Default: 'park'

Switch to control whether MG microphysics should prognose
cloud ice (cldice).

Default: .true.

Switch to control whether MG microphysics should prognose
cloud liquid (cldliq).

Default: .true.

prescribed aerosol bulk sulfur scale factor

Default: 2 

Type of microphysics scheme employed.  'RK' for Rasch and Kristjansson
(1998); 'MG' for Morrison and Gettelman two moment scheme.

Default: set by build-namelist (depends on value set in configure).

Type of shallow convection scheme employed.  'Hack' for Hack shallow convection;
'UW' for original McCaa UW pbl scheme, modified by Sungsu Park; 'CLUBB_SGS'
for CLUBB_SGS.

Default: set by build-namelist (depends on eddy_scheme).

Troposphere cloud physics will be done only below the top defined
by this pressure (Pa).

Default: 100._r8

Penetrative entrainment efficiency in UW shallow scheme.

Default: set by build-namelist

Type of water vapor saturation vapor pressure scheme employed.  'GoffGratch' for
Goff and Gratch (1946); 'MurphyKoop' for Murphy & Koop (2005)

Default: GoffGratch

Autoconversion coefficient over land in ZM deep convection scheme.

Default: set by build-namelist

Autoconversion coefficient over ocean in ZM deep convection scheme.

Default: set by build-namelist

Tunable evaporation efficiency in ZM deep convection scheme.

Default: set by build-namelist

parameter for deep convection cloud fraction.

Default: set by build-namelist

parameter for deep convection cloud fraction.

Default: set by build-namelist

Switch for Vavrus "freeze dry" adjustment in cloud fraction.  Set to FALSE to
turn the adjustment off.

Default: set by build-namelist

Switch for ice cloud fraction calculation.

Default: set by build-namelist

top pressure bound for mid level cloud.

Default: set by build-namelist

Minimum rh for high stable clouds.

Default: set by build-namelist

Minimum rh for low stable clouds.

Default: set by build-namelist

parameter for shallow convection cloud fraction.

Default: set by build-namelist

parameter for shallow convection cloud fraction.

Default: set by build-namelist

Factor applied to the ice fall velocity computed from 
Stokes terminal velocity.

Default: set by build-namelist

Logical switch to turn on implicit turbulent surface stress calculation in
diffusion solver routine.

Default: set by build-namelist

Logical switch to turn on turbulent mountain stress calculation in 
vertical diffusion routine.

Default: set by build-namelist

Type of eddy scheme employed by the vertical diffusion package.  'HB' for
Holtslag and Boville; 'diag_TKE' for diagnostic tke version of Grenier and
Bretherton; 'HBR' for Rasch modified version of 'HB'.

Default: 'HB'

Switch to turn on adjustment of the surface fluxes to reduce instabilities
in the surface layer.  Set to 1 to turn on the adjustments.

Default: 0 if eddy_scheme is 'HB', 1 otherwise.

Full pathname of absorption/emission dataset.
It consists of terms used for determining the absorptivity and
emissivity of water vapor in the longwave parameterization of radiation.

Default: set by build-namelist.

Convective water used in radiation?
0 ==> No
1 ==> Yes - Arithmetic average.
2 ==> Yes - Average in emissivity.

Default: set by build-namelist

filepath and name for ice optics data for rrtmg

Default: none

filepath and name for ice optics data for rrtmg

Default: none

Specifies length of time in timesteps (positive) or hours (negative) SW/LW
radiation will be run for every timestep from the start of an initial run.

Default: 0

Interval between absorptivity/emissivity calculations in time steps (if
positive) or model hours (if negative).  To avoid having the abs/ems values
saved on the restart output, make sure that the interval of the abs/ems
calculation evenly divides the restart interval.

Default: -12

Interval of long-wave radiation calculation in timesteps (if positive) or
model hours (if negative).

Default: -1

Interval of short-wave radiation calculation in timesteps (if positive) or
model hours (if negative).

Default: -1

filepath and name for ice optics data for rrtmg

Default: none

filepath and name for liquid cloud (gamma distributed) optics data for rrtmg

Default: none

Definitions for the aerosol modes that may be used in the rad_climate and
rad_diag_* variables.

Default: set by build-namelist

filepath and name for ice optics data for rrtmg

Default: none

A list of the radiatively active species, i.e., species that affect the
climate simulation via the radiative heating rate calculation.

Default: set by build-namelist

Averaging flag for adiation driver output data.

Default: 'A'

History tape number radiation driver output data is written to.

Default: 0

output data needed for off-line radiation calculations

Default: FALSE

A list of species to be used in the first diagnostic radiative heating rate
calculation.  These species are not the ones affecting the climate
simulation.  This is a hook for performing radiative forcing calculations.

Default: none

Analogous to rad_diag_1, but for the 10th diagnostic calculation.

Default: none

Analogous to rad_diag_1, but for the 2nd diagnostic calculation.

Default: none

Analogous to rad_diag_1, but for the 3rd diagnostic calculation.

Default: none

Analogous to rad_diag_1, but for the 4th diagnostic calculation.

Default: none

Analogous to rad_diag_1, but for the 5th diagnostic calculation.

Default: none

Analogous to rad_diag_1, but for the 6th diagnostic calculation.

Default: none

Analogous to rad_diag_1, but for the 7th diagnostic calculation.

Default: none

Analogous to rad_diag_1, but for the 8th diagnostic calculation.

Default: none

Analogous to rad_diag_1, but for the 9th diagnostic calculation.

Default: none

Type of radiation scheme employed. 

Default: set by build-namelist

Return fluxes per band in addition to the total fluxes.

Default: FALSE

Full pathname of dataset for water refractive indices used in modal aerosol optics

Default: none

Critical Froude number squared.

Default: set by build-namelist.

Variable to specify the vertical index at which the
Rayleigh friction term is centered (the peak value).

Default: 2

Rayleigh friction parameter to determine the width of the profile.  If set
to 0 then a width is chosen by the algorithm (see rayleigh_friction.F90).

Default: 0.

Rayleigh friction parameter to determine the approximate value of the decay
time (days) at model top.  If 0.0 then no Rayleigh friction is applied.

Default: 0.

Total solar irradiance (W/m2).

Default: set by build-namelist

Full pathname of dataset for file that contains the solar photon enerspectra or TSI data 
as a time series

Default: none

Seconds of the day corresponding to solar_data_ymd

Default: current model time of day

Type of time interpolation for data in solar_data_file.
Can be set to "FIXED" or "SERIAL".

Default: SERIAL

If solar_data_type is "FIXED" then solar_data_ymd
is the date the solar data is fixed to.  If solar_data_type 
is "SERIAL" the solar_data_ymd is the start date of the time series
of solar data.
Format: YYYYMMDD

Default: none

Use spectral scaling in the radiation heating 

Default: false

Full pathname of IOP dataset.

Default: set by build-namelist.

IOP name for CLUBB running in single column mode

Default: ""

Column radiation mode.

Default: FALSE

If using diurnal averaging or not.

Default: FALSE

Use the specified surface properties.

Default: FALSE

Use relaxation.

Default: FALSE

Latitude value of single column.

Default: none.

Longitude value of single column.

Default: none.

Set to TRUE to turn on single column mode.

Default: FALSE

List of aerosol species that undergo dry deposition.

Default: set by build-namelist.

List of aerosol species that undergo wet deposition.

Default: set by build-namelist.

The  cycle year of the prescribed aerosol flux data
if aerodep_flx_type  is 'CYCLICAL'.
Format: YYYY

Default: 0

Full pathname of the directory that contains the files specified in
aerodep_flx_filelist.

Default: set by build-namelist.

Filename of dataset for prescribed aerosols.

Default: set by build-namelist.

Filename of file that contains a sequence of filenames for prescribed
aerosols.  The filenames in this file are relative to the directory specied
by aerodep_flx_datapath.

Default: set by build-namelist.

The time of day (seconds) corresponding to ssaerodep_flx_fixed_ymd
at which the prescribed aerosol flux data is fixed
if saerodep_flx_type is 'FIXED'.

Default: 0 seconds

The date at which the prescribed aerosol flux data is fixed
if aerodep_flx_type is 'FIXED'.
Format: YYYYMMDD

Default: 0

Remove the file containing prescribed aerosol deposition fluxes from local disk when no longer needed.

Default: FALSE

Names of variables containing aerosol data in the prescribed aerosol datasets.

Default: none

Type of time interpolation for data in aerodep_flx files.
Can be set to 'CYCLICAL', 'SERIAL', 'INTERP_MISSING_MONTHS', or 'FIXED'.

Default: 'SERIAL'

Full pathname of the aircraft input file list

Default: none

Type of time interpolation for data in aircraft aerosol files.

Default: 'CYCLICAL_LIST'

Full pathname of boundary dataset for airplane emissions.

Default: set by build-namelist.

Frequency in time steps at which the chemical equations are solved.

Default: 1

Flag to set rad_climate variable so that the chemical tracers are
radiatively passive.

Default: FALSE

Filename of dataset for linoz cholirine loading.

Default: none.

The time of day (seconds) corresponding to chlorine_loading_fixed_ymd
at which the chlorine loading data is fixed
if chlorine_loading_type is 'FIXED'.

Default: 0 seconds

The date at which the chlorine loading data is fixed
if chlorine_loading_type is 'FIXED'.
Format: YYYYMMDD

Default: 0

Type of time interpolation type for data in  chlorine_loading_file

Default: 'SERIAL'

Full pathname of dataset containing soil moisture fraction information used in 'xactive_atm' 
method of calculating dry deposition of chemical tracers.

Default: set by build-namelist.

Full pathname of dataset which contains the prescribed deposition velocities used 
in the 'table' method of calculating dry deposition  of chemical tracers.

Default: set by build-namelist.

Full pathname of dataset which contains land vegitation information used in 'xactive_atm' 
method of calculating dry deposition of chemical tracers.

Default: set by build-namelist.

Dry deposition surface values interpolated to model grid, required for unstructured atmospheric grids
with modal chemistry.

Default: none

Tuning parameter for dust emissions.

Default: set by build-namelist.

Full pathname of dataset of O2 and 03 column densities above the model for look-up-table photolysis 

Default: set by build-namelist.

The  cycle year of the external forcings (3D emissions) data
if ext_frc_type  is 'CYCLICAL'.
Format: YYYY

Default: 0

The time of day (seconds) corresponding to ext_frc_fixed_ymd
at which the external forcings are fixed
if ext_frc_type is 'FIXED'.

Default: 0 seconds

Default: current model date
The date at which the external forcings are fixed
if ext_frc_type is 'FIXED'.
Format: YYYYMMDD
Default: 0

List of full pathnames of elevated emission (or external chemical forcings) datasets.

The chemistry package reads in elevated emission data from a set of netcdf files in
units of "molecules/cm3/s".  Each tracer species emissions is read from its
own file as directed by the namelist variable ext_frc_specifier.  The
ext_frc_specifier variable tells the model which species have elevated
emissions and the file path for the corresponding species.  That is, the
ext_frc_specifier variable is set something like:

 ext_frc_specifier = 'SO2 -> /path/vrt.emis.so2.nc',
                     'SO4 -> /path/vrt.emis.so4.nc', etc...

Each emission file can have more than one source.  When the emission are
read in the sources are summed to give a total emission field for the
corresponding species.  The emission can be read in as time series of data,
cycle over a given year, or be fixed to a given date.

The vertical coordinate in these emissions files should be 'altitude' (km) so that the 
vertical redistribution to the model layers is done using a mass conserving method.  
If the vertical coordinate is altitude then data needs to be ordered from the
surface to the top (increasing altitude).


Default: set by build-namelist.

Type of time interpolation for fixed lower boundary data.
Can be set to 'CYCLICAL', 'SERIAL', 'INTERP_MISSING_MONTHS', or 'FIXED'.

Default: 'CYCLICAL'

The cycle year of the fixed lower boundary data
if flbc_type  is 'CYCLICAL'.
Format: YYYY

Default: 0

Full pathname of dataset for fixed lower boundary conditions.

Default: set by build-namelist.

The time of day (seconds) corresponding to flbc_fixed_ymd
at which the fixed lower boundary data is fixed
if flbc_type is 'FIXED'.

Default: 0 seconds

The date at which the fixed lower boundary data is fixed
if flbc_type is 'FIXED'..
Format: YYYYMMDD

Default: 0

List of species that are fixed at the lower boundary.

Default: set by build-namelist.

Type of time interpolation for fixed lower boundary data.

Default: 'CYCLICAL'

Full pathname of dataset for chemical tracers constrained  in the stratosphere

Default: set by build-namelist.

List of species that are constrained in the stratosphere.

Default: set by build-namelist.

List of gas-phase species that undergo wet deposition via the wet deposition scheme.

Default: NONE

Wet depostion method used
  MOZ --> mozart scheme is used
  NEU --> J Neu's scheme is used

Default: MOZ

Flag to tell build-namelist to use time-dependent external forcing
files for the aircraft emissions.

Default: FALSE

Full pathname of dataset for land mask applied to the lighting NOx production  

Default: set by build-namelist.

Multiplication factor  applied to the lighting NOx production  

Default: 1.0.

The  cycle year of the LINOZ data
if linoz_data_type is 'CYCLICAL'.
Format: YYYY

Default: 0

Filename of dataset for LINOZ data.

Default: none.

Filename of file that contains a sequence of filenames of the linoz data.  
The filenames in this file are relative to the directory specied
by linoz_data_datapath.

Default: set by build-namelist.

The time of day (seconds) corresponding to linoz_data_fixed_ymd
at which the LINOZ data is fixed
if linoz_data_type is 'FIXED'.

Default: 0 seconds

The date at which the LINOZ data  is fixed
if linoz_data_type is 'FIXED'.
Format: YYYYMMDD

Default: 0

Full pathname of the directory that contains the files specified in
linoz_data_filelist.

Default: none.

Remove the file containing LINOZ data from local disk when no longer needed.

Default: FALSE

Type of time interpolation for data in linoz_data files.
Can be set to 'CYCLICAL', 'SERIAL', 'INTERP_MISSING_MONTHS', or 'FIXED'.

Default: 'SERIAL'

Full pathname of dataset of O2 cross sections for fast-tuv photolysis 

Default: set by build-namelist.

The  cycle year of the prescribed aerosol data
if prescribed_aero_type  is 'CYCLICAL'.
Format: YYYY

Default: 0

Full pathname of the directory that contains the files specified in
prescribed_aero_filelist.

Default: set by build-namelist.

Filename of dataset for prescribed aerosols.

Default: set by build-namelist.

Filename of file that contains a sequence of filenames for prescribed
aerosols.  The filenames in this file are relative to the directory specied
by prescribed_aero_datapath.

Default: set by build-namelist.

The time of day (seconds) corresponding to prescribed_aero_fixed_ymd
at which the prescribed aerosol data is fixed
if prescribed_aero_type is 'FIXED'.

Default: 0 seconds

The date at which the prescribed aerosol data is fixed
if prescribed_aero_type is 'FIXED'.
Format: YYYYMMDD

Default: 0

Switch used to indicate which type of aerosols are prescribed -- bulk or modal.
This is used to set the default prescribed_aero_specifier and 
aerodep_flx_specifier namelist variables.

Default: bulk

Remove the file containing prescribed aerosol concentrations from local disk when no longer needed.

Default: FALSE

A list of variable names of the concentration fields in the prescribed aerosol datasets
and corresponding names used in the physics buffer seperated by colons.  For example:

 prescribed_aero_specifier = 'pbuf_name1:ncdf_fld_name1','pbuf_name2:ncdf_fld_name2', ...

If there is no colon seperater then the specified name is used as both the pbuf_name and ncdf_fld_name,


Default: none

Type of time interpolation for data in prescribed_aero files.
Can be set to 'CYCLICAL', 'SERIAL', 'INTERP_MISSING_MONTHS', or 'FIXED'.

Default: 'SERIAL'

The  cycle year of the prescribed green house gas data
if prescribed_ghg_type  is 'CYCLICAL'.
Format: YYYY

Default: 0

Full pathname of the directory that contains the files specified in
prescribed_ghg_filelist.

Default: set by build-namelist.

Filename of dataset for prescribed GHGs.

Default: set by build-namelist.

Filename of file that contains a sequence of filenames for prescribed
GHGs.  The filenames in this file are relative to the directory specied
by prescribed_ghg_datapath.

Default: set by build-namelist.

The time of day (seconds) corresponding to prescribed_ghg_fixed_ymd
at which the prescribed green house gas data is fixed
if prescribed_ghg_type is 'FIXED'.

Default: 0 seconds

The date at which the prescribed green house gas data  is fixed
if prescribed_ghg_type is 'FIXED'.
Format: YYYYMMDD

Default: 0

Remove the file containing prescribed green house gas concentrations from local disk when no longer needed.

Default: FALSE

Names of variables containing GHG data in the prescribed GHG datasets.

Default: none

Type of time interpolation for data in prescribed_ghg files.
Can be set to 'CYCLICAL', 'SERIAL', 'INTERP_MISSING_MONTHS', or 'FIXED'.

Default: 'SERIAL'

The  cycle year of the prescribed ozone data
if prescribed_ozone_type  is 'CYCLICAL'.
Format: YYYY

Default: 0

Full pathname of the directory that contains the files specified in
prescribed_ozone_filelist.

Default: set by build-namelist.

Filename of dataset for prescribed ozone.

Default: set by build-namelist.

Filename of file that contains a sequence of filenames for prescribed
ozone.  The filenames in this file are relative to the directory specied
by prescribed_ozone_datapath.

Default: set by build-namelist.

The time of day (seconds) corresponding to prescribed_ozone_fixed_ymd
at which the prescribed ozone data is fixed
if prescribed_ozone_type is 'FIXED'.

Default: 0 seconds

The date at which the prescribed ozone data is fixed
if prescribed_ozone_type is 'FIXED'.
Format: YYYYMMDD

Default: 0

Name of variable containing ozone data in the prescribed ozone datasets.

Default: 'ozone'

Remove the file containing prescribed ozone concentrations from local disk when no longer needed.

Default: FALSE

Type of time interpolation for data in prescribed_ozone files.
Can be set to 'CYCLICAL', 'SERIAL', 'INTERP_MISSING_MONTHS', or 'FIXED'.

Default: 'SERIAL'

The  cycle year of the prescribed volcanic aerosol data
if prescribed_volcaero_type  is 'CYCLICAL'.
Format: YYYY

Default: 0

Full pathname of the directory that contains the files specified in
prescribed_volcaero_filelist.

Default: set by build-namelist.

Filename of dataset for prescribed volcaero.

Default: set by build-namelist.

Filename of file that contains a sequence of filenames for prescribed
volcaero.  The filenames in this file are relative to the directory specied
by prescribed_volcaero_datapath.

Default: set by build-namelist.

The time of day (seconds) corresponding to prescribed_volcaero_fixed_ymd
at which the prescribed volcanic aerosol data is fixed
if prescribed_volcaero_type is 'FIXED'.

Default: 0 seconds

The date at which the prescribed volcanic aerosol data  is fixed
if prescribed_volcaero_type is 'FIXED'.
Format: YYYYMMDD

Default: 0

Name of variable containing volcaero data in the prescribed volcaero datasets.

Default: 'MMRVOLC'

Remove the file containing prescribed volcanic aerosol concentrations from local disk when no longer needed.

Default: FALSE

Type of time interpolation for data in prescribed_volcaero files.
Can be set to 'CYCLICAL', 'SERIAL', 'INTERP_MISSING_MONTHS', or 'FIXED'.

Default: 'SERIAL'

Full pathname of dataset for radiative source function used in look up table photloysis

Default: set by build-namelist.

Full pathname of dataset which contains season information used in 'xactive_atm' 
method of calculating dry deposition of chemical tracers.

Default: set by build-namelist.

Full pathname of boundary dataset for soil erodibility factors.

Default: set by build-namelist.

The  cycle year of the surface emissions data
if srf_emis_type  is 'CYCLICAL'.
Format: YYYY

Default: 0

The time of day (seconds) corresponding to srf_emis_fixed_ymd
at which the surface emissions are fixed
if srf_emis_type is 'FIXED'.

Default: 0 seconds

The date at which the surface emissions are fixed
if srf_emis_type is 'FIXED'.
Format: YYYYMMDD

Default: 0

List of full pathnames of surface emission datasets.

The chemistry package reads in emission data from a set of netcdf files in
units of "molecules/cm2/s".  Each tracer species emissions is read from its
own file as directed by the namelist variable srf_emis_specifier.  The
srf_emis_specifier variable tells the model which species have emissions
and the file path for the corresponding species.  That is, the
srf_emis_specifier variable is set something like:

 srf_emis_specifier = 'CH4 -> /path/emis.ch4.nc',
                      'CO  -> /path/emis.co.nc', etc...

Each emission file can have more than one source.  When the emission are
read in the sources are summed to give a total emission field for the
corresponding species.  The emission can be read in as time series of data,
cycle over a given year, or be fixed to a given date.


Default: set by build-namelist.

Type of time interpolation of emission datasets specified.
Can be set to 'CYCLICAL', 'SERIAL', 'INTERP_MISSING_MONTHS', or 'FIXED'.
by srf_emis_specifier. 

Default: 'CYCLICAL'

Full pathname of dataset containing tropopheric sulfate aerosols

Default: set by build-namelist.

The  cycle year of the prescribed chemical constituents data
if tracer_cnst_type  is 'CYCLICAL'.
Format: YYYY

Default: 0

Full pathname of the directory that contains the files specified in
tracer_cnst_filelist.

Default: set by build-namelist.

Filename of dataset for the prescribed chemical constituents.

Default: set by build-namelist.

Filename of file that contains a sequence of filenames for the prescribed chemical constituents.  
The filenames in this file are relative to the directory specied
by tracer_cnst_datapath.

Default: set by build-namelist.

The time of day (seconds) corresponding to tracer_cnst_fixed_ymd
at which the chemical constituents data is fixed
if tracer_cnst_type is 'FIXED'.

Default: 0 seconds

The date at which the chemical constituents data is fixed
if tracer_cnst_type is 'FIXED'.
Format: YYYYMMDD

Default: 0

Remove the file containing prescribed chemical constituents from local disk when no longer needed.

Default: FALSE

List of prescribed chemical constituents.

Default: set by build-namelist.

Type of time interpolation for data in tracer_cnst files.

Default: 'SERIAL'

The  cycle year of the prescribed chemical sources data
if tracer_srcs_type  is 'CYCLICAL'.
Format: YYYY

Default: 0

Full pathname of the directory that contains the files specified in
tracer_srcs_filelist.

Default: set by build-namelist.

Filename of dataset for the prescribed chemical sources.

Default: set by build-namelist.

Filename of file that contains a sequence of datasets for the prescribed chemical sources.
The filenames in this file are relative to the directory specied
by tracer_srcs_datapath.

Default: set by build-namelist.

The time of day (seconds) corresponding to tracer_srcs_fixed_ymd
at which the chemical sources data is fixed
if tracer_srcs_type is 'FIXED'.

Default: 0 seconds

The date at which the chemical sources data is fixed
if tracer_srcs_type is 'FIXED'.
Format: YYYYMMDD

Default: 0

Remove the file containing prescribed chemical sources from local disk when no longer needed.

Default: FALSE

List of prescribed chemical sources

Default: set by build-namelist.

Type of time interpolation for data in tracer_srcs files.

Default: 'SERIAL'

Full pathname of dataset for fast-tuv photolysis cross sections

Default: set by build-namelist.

If TRUE use CAM sulfur chemistry driver rather than mo_setsox.

Default: FALSE

If TRUE then use the FTUV method to calculate the photolysis reactions rates,
otherwise use the look up table method.

Default: FALSE

Full pathname of dataset for  Chebyshev polynomial Coeff data used for photolysis
cross sections.

Default: set by build-namelist.

Full pathname of cross section dataset for long wavelengh photolysis

Default: set by build-namelist.

Full pathname of cross section dataset for short wavelengh photolysis

Default: set by build-namelist.

List of species that undergo dry deposition.

Default: set by build-namelist.

Dry deposition method used.  This specifies the method used to calculate dry
deposition velocities of gas-phase chemical species.  The available methods 
are:
 'table'       - prescribed method in CAM
 'xactive_atm' - interactive method in CAM
 'xactive_lnd' - interactive method in CLM

Default: set by build-namelist

Full pathname of time-variant boundary dataset for greenhouse gas production/loss
rates.  Only used by the simple prognostic GHG chemistry scheme that is
enabled via the argument "-prog_species GHG" to configure.

Default: set by build-namelist.

This variable should not be set by the user.  It is set by build-namelist
when the user specifies the argument "-prog_species GHG" to configure which
turns on a simple prognostic chemistry scheme for CH4, N2O, CFC11 and
CFC12.

Default: set by build-namelist

Full pathname of time-variant boundary dataset for H2O production/loss rates.

Default: set by build-namelist.

The  cycle year of the prescribed waccm forcing data
if waccm_forcing_type  is 'CYCLICAL'.
Format: YYYY

Default: 0

Full pathname of the directory that contains the files specified in
waccm_forcing_filelist.

Default: set by build-namelist.

Filename of the prescribed waccm forcing data used with waccm_ghg chemistry.
This contains prescribed constituents for non-LTE calculations and heating rates 
for wavelengths less than 200 nm.

Default: set by build-namelist.

A file that contains a sequence of filenames for prescribed waccm forcing data.  
The filenames in this file are relative to the directory specied 
by waccm_forcing_datapath.

Default: set by build-namelist.

The time of day (seconds) corresponding to waccm_forcing_fixed_ymd
at which the prescribed waccm forcing data is fixed
if waccm_forcing_type is 'FIXED'.

Default: 0 seconds

The date at which the prescribed waccm forcing data is fixed
if waccm_forcing_type is 'FIXED'.
Format: YYYYMMDD

Default: 0

Remove the file containing prescribed waccm forcing data from local disk when no longer needed.

Default: FALSE

Names of variables containing concentrations and heating rate in the prescribed waccm forcing datasets.

Default: none

Type of time interpolation for data in waccm_forcing files.
Can be set to 'CYCLICAL', 'SERIAL', 'INTERP_MISSING_MONTHS', or 'FIXED'.

Default: 'SERIAL'

Full pathname of dataset for the neutral species absorption cross sections for EUV 
photo reactions producing electrons.

Default: set by build-namelist.

Full pathname of dataset for EUVAC solar EUV model (0.05-121nm).

Default: set by build-namelist.

Full pathname of dataset for variables used to compute the solar flux in the EUV 
wavelength regime.  Used to compute EUV photorates and heating from EUV photolysis.

Default: set by build-namelist.

Multiplication factor applied to the upper boundary NO mass mixing ratio. 

Default: 1.0

Full pathname of dataset for the neutral species absorption cross sections.

Default: set by build-namelist.

The cycle year of the stratospheric aerosol data
if sad_cycle_type  is 'CYCLICAL'.
Format: YYYY

Default: 0

Full pathname of dataset for stratospheric aerosol densities

Default: set by build-namelist.

The time of day (seconds) corresponding to sad_fixed_ymd
at which the stratospheric aerosol data is fixed
if sad_type is 'FIXED'.

Default: 0 seconds

The date at which the stratospheric aerosol data is fixed
if sad_type is 'FIXED'..
Format: YYYYMMDD

Default: 0

Type of time interpolation for stratospheric aerosol density data.
Can be set to 'CYCLICAL', 'SERIAL', or 'FIXED'.

Default: 'CYCLICAL'

Full pathname of dataset for the coefficients of the NOEM nitric oxide model used 
to calculate its upper boundary concentration.

Default: set by build-namelist.

Full pathname of time-variant boundary dataset for the time-dependent proxies for 
solar and geomagnetic activity( F10.7, F10.7a, Kp, Ap ).

Default: set by build-namelist.

Filepath for time-variant solar proton ionization dataset.

Default: Set by build-namelist.

Filepath for file that lists a series of solar proton ionization dataset files.

Default: Set by build-namelist.

TRUE implies the offline solar proton ionization data file will be deleted when 
finished with it.

Default: FALSE

TRUE implies restart (branch) from a previous run with solar proton events.

Default: TRUE

 true => radiation feed backs from strat sulfur aerosol

Default: false

Perturbation applied to the upper boundary temperature.

Default: 0.0

The cycle year of the TGCM upper boundary data
if tgcm_ubc_type  is 'CYCLICAL'.
Format: YYYY

Default: 0

Type of time interpolation for data in TGCM upper boundary file.
Can be set to 'CYCLICAL', 'SERIAL', 'INTERP_MISSING_MONTHS', or 'FIXED'.

Default: 'SERIAL'

Full pathname of dataset for TGCM upper boundary

Default: set by build-namelist.

The time of day (seconds) corresponding to tgcm_ubc_fixed_ymd
at which the TGCM upper boundary data is fixed
if tgcm_ubc_type is 'FIXED'.

Default: 0 seconds

The date at which the TGCM upper boundary data is fixed
if tgcm_ubc_type is 'FIXED'.
Format: YYYY

Default: 0

Runtime options of upper thermosphere WACCM-X.  'ionosphere' for 
full ionopshere and neutral thermosphere, 'neutral' for just 
neutral thermosphere, and off for no WACCM-X.

Default: 'off'

Full pathname of dataset for coefficient data used in WACCM to calculate ion drag 
for high solar fluxes from the Scherliess low latitude electric potential model.

Default: set by build-namelist.

Full pathname of dataset for coefficient data used in WACCM to calculate ion drag 
for low solar fluxes from the Scherliess low latitude electric potential model.

Default: set by build-namelist.

Full pathname of dataset for coefficient data used in WACCM to calculate ion drag 
from the Weimer96 high latitude electric potential model.

Default: set by build-namelist.

Full pathname of Bers lookup table data file for gravity waves.

Default: set by build-namelist.

Determines which constituents are used from NLTE calculations.
TRUE implies use prognostic constituents.
FALSE implies use constituents from dataset specified by waccm_forcing_file.

Default: TRUE for full WACCM code; FALSE for WACCM_GHG.

TRUE implies assume cyclic qbo data.

Default: FALSE

Filepath for qbo forcing dataset.

Default: Set by build-namelist.

TRUE implies qbo package is active.

Default: FALSE

Full pathname of time-variant ozone mixing ratio boundary dataset.

Default: set by build-namelist.

Add CAM3 prescribed ozone to the physics buffer.

Default: FALSE

Flag for yearly cycling of ozone data. If set to FALSE, a multi-year
dataset is assumed, otherwise a single-year dataset is assumed, and ozone
will be cycled over the 12 monthly averages in the file.

Default: TRUE

Full pathname of time-variant boundary dataset for greenhouse gas surface
values.

Default: set by build-namelist.

CH4 volume mixing ratio.  This is used as the time invariant surface value
of CH4 if no time varying values are specified.

Default: set by build-namelist.

CO2 volume mixing ratio.  This is used as the time invariant surface value
of CO2 if no time varying values are specified.

Default: set by build-namelist.

User override for the prescribed CO2 volume mixing ratio used by the radiation
calculation.  Note however that the prescribed value of CO2 which is sent
to the surface models is still the one that is set using either the 
co2vmr or the scenario_ghg variables.

Default: not used

CFC11 volume mixing ratio adjusted to reflect contributions from many GHG
species.  This is used as the time invariant surface value of F11 if no
time varying values are specified.

Default: set by build-namelist.

CFC12 volume mixing ratio.  This is used as the time invariant surface value
of CFC12 if no time varying values are specified.

Default: set by build-namelist.

Data start year.  Use in conjunction
with ghg_yearstart_model.

Default: 0

Model start year.  Use in conjunction
with ghg_yearstart_data.

Default: 0

N2O volume mixing ratio.  This is used as the time invariant surface value
of N2O if no time varying values are specified.

Default: 0.311e-6

Amount of co2 ramping per year (percent).  Only used
if scenario_ghg = 'RAMP_CO2_ONLY'

Default: 1.0

CO2 cap if > 0, floor otherwise.  Specified as multiple or fraction of
inital value; e.g., setting to 4.0 will cap at 4x initial CO2 setting.
Only used if scenario_ghg = 'RAMP_CO2_ONLY'

Default: boundless if ramp_co2_annual_rate > 0, zero otherwise.

Date on which ramping of co2 begins.  The date is encoded as an integer in
the form YYYYMMDD.  Only used if scenario_ghg = 'RAMP_CO2_ONLY'

Default: 0

If scenario_ghg is set to "RAMPED" then the greenhouse
gas surface values are interpolated between the annual average values 
read from the file specified by bndtvghg.
In that case, the value of this variable (> 0) fixes the year of the
lower bounding value (i.e., the value for calendar day 1.0) used in the
interpolation.  For example, if rampyear_ghg = 1950, then the GHG surface
values will be the result of interpolating between the values for 1950 and
1951 from the dataset.

Default: 0

Controls treatment of prescribed co2, ch4, n2o, cfc11, cfc12 volume mixing
ratios.  May be set to 'FIXED' or 'RAMPED' or 'RAMP_CO2_ONLY'.
FIXED => volume mixing ratios are fixed and have either default or namelist
         input values.
RAMPED => volume mixing ratios are time interpolated from the dataset
          specified by bndtvghg.
RAMP_CO2_ONLY => only co2 mixing ratios are ramped at a rate determined by
                 the variables ramp_co2_annual_rate, ramp_co2_cap,
                 and ramp_co2_start_ymd.

Default: FIXED

Flag to set rad_climate variable so that the prognostic CO2 controlled by
the co2_cycle module is radiatively passive.

Default: FALSE

If TRUE turn on CO2 code.

Default: FALSE

If TRUE read co2 flux from fuel.

Default: FALSE

If TRUE read co2 flux from ocn.

Default: FALSE

Filepath for dataset containing CO2 flux from fossil fuel.

Default: none

Filepath for dataset containing CO2 flux from ocn.

Default: none

Full pathname of time-variant boundary dataset for aerosol masses.

Default: set by build-namelist.

Add CAM3 prescribed aerosols to the physics buffer.

Default: FALSE

Use this variable to specify the latitude (in degrees) of a column to
debug.  The closest column in the physics grid will be used.

Default: none

Use this variable to specify the longitude (in degrees) of a column to
debug.  The closest column in the physics grid will be used.

Default: none

fc_gather flow control option:
 < 0 : use MPI_Gather
 >= 0: use point-to-point with handshaking messages and preposting 
       receive requests up to 
         max(min(1,fc_gather_flow_cntl),max_gather_block_size) 
       ahead. Default value is defined by private parameter 
       max_gather_block_size, which is currently set to 64.

Default: 64

String identifying a hardware counter to the papi library.

Default: PAPI_TOT_CYC

String identifying a hardware counter to the papi library.

Default: PAPI_FP_OPS

String identifying a hardware counter to the papi library.

Default: PAPI_FP_INS

String identifying a hardware counter to the papi library.

Default: PAPI_NO_CTR

If TRUE, print CPU timing per model timestep. 

Default: FALSE

Flag indicating whether the mpi_barrier in t_barrierf should be called.

Default: FALSE

Maximum number of levels of timer nesting .

Default: 99999

Maximum detail level to profile.

Default: 1

Flag indicating whether timers are disabled.

Default: FALSE

Collect and print out global performance statistics (for this component communicator).

Default: FALSE

Maximum number of processes writing out timing data (for this component communicator).

Default: -1

Separation between process ids for processes that are writing out timing data 
(for this component communicator).

Default: 1

Flag indicating whether the PAPI namelist should be read and HW performance counters
used in profiling.

Default: FALSE

Flag indicating whether the performance timer output should be written to a
single file (per component communicator) or to a separate file for each
process.

Default: TRUE

Initialization of GPTL timing library.

Default: GPTLmpiwtime

Swap communication maximum request count:
 <=0: do not limit number of outstanding send/receive requests
  >0: do not allow more than swap_comm_maxreq outstanding
      nonblocking send requests or nonblocking receive requests

Default: 128

Swap communication protocol option (reduced set):
 3, 5:                  nonblocking send
 2, 3, 4, 5:            nonblocking receive
 4, 5:                  ready send

Default: 4

Dynamics/physics transpose method for nonlocal load-balance.  0: use
mpi_alltoallv. 1: use point-to-point MPI-1 two-sided implementation. 2: use
point-to-point MPI-2 one-sided implementation if supported, otherwise use
MPI-1 implementation. 3: use Co-Array Fortran implementation if supported,
otherwise use MPI-1 implementation. 11-13: use mod_comm, choosing any of
several methods internal to mod_comm.  The method within mod_comm (denoted
mod_method) has possible values 0,1,2 and is set according to mod_method =
phys_alltoall - modmin_alltoall, where modmin_alltoall is 11. -1: use 
option 1 when each process communicates with less than half of the other 
processes, otherwise use option 0 (approx.).

Default: -1

Select target number of chunks per thread.  Must be positive.

Default: 1

Physics grid decomposition options.
-1: each chunk is a dynamics block.
 0: chunk definitions and assignments do not require interprocess comm.
 1: chunk definitions and assignments do not require internode comm.
 2: optimal diurnal, seasonal, and latitude load-balanced chunk definition and assignments.
 3: chunk definitions and assignments only require communication with one other process.
 4: concatenated blocks, no load balancing, no interprocess communication.

Default: 0

Physics grid decomposition options.
 0: assign columns to chunks as single columns, wrap mapped across chunks
 1: use (day/night; north/south) twin algorithm to determine load-balanced pairs of
      columns and assign columns to chunks in pairs, wrap mapped

Default: 0 for unstructured grid dycores, 1 for lat/lon grid dycores

Heat capacity of water vapor at constant pressure [J/kg/K].

Default: set to shr_const value

Acceleration of gravity [m/s**2].

Default: set to shr_const value

Molecular weight of dry air [g/mol]

Default: set to shr_const value

Molecular weight of water [g/mol].

Default: set to shr_const value

Radius of Earth [m].

Default: set to shr_const value

Length of siderial day [seconds].

Default: set to shr_const value

Freezing point of water [K].

Default: set to shr_const value

Turbulent mountain stress parameter used when turbulent mountain stress calculation 
is turned on. See do_tms.

Default: 1.0 for CAM, set by build-namelist for WACCM, T31

Factor determining z_0 from orographic standard deviation [ no unit ] 
Used when turbulent mountain stress calc is turned on. See do_tms.
set by build-namelist for WACCM, T31

Radiation driver use case name.

Default: none.

Radiation driver input data file.

Default: none.

Flag to indicate whether a distributed sum that violates the difference 
tolerance specified by repro_sum_rel_diff_max should be recomputed using 
a floating point-based (but nonscalable) reproducible algorithm.

Default: FALSE

Relative difference between repro and nonrepro algorithms that will 
generate a warning. This will also force a recompute using a nonscalable 
algorihm if repro_sum_recompute is true. If less than zero, then
the difference will not be evaluated (and the nonrepro algorithm will not 
be computed).

Default: -1.0

Flag to indicate whether to use the double-double distributed sum algorithm
rather than the (almost) infinite precision reproducible distributed sum algorithm.

Default: FALSE

Allocate all buffers as global.  This is a performance optimization on
machines for which allocation/deallocation of physpkg scope buffers on
every timestep was slow (Cray-X1).

Default: TRUE

Name of the CAM chemistry package.  N.B. this variable may not be set by
the user.  It is set by build-namelist via information in the configure
cache file to be consistent with how CAM was built.

Default: set by build-namelist

Name of the CAM physics package.  N.B. this variable may not be set by
the user.  It is set by build-namelist via information in the configure
cache file to be consistent with how CAM was built.

Default: set by build-namelist