<?xml version="1.0"?>

<?xml-stylesheet type="text/xsl" href="config_definition.xsl" ?>

<config_definition>

<entry id="cam_bld" value=".">
CAM build directory; contains .o and .mod files.
</entry>
<entry id="cam_exedir" value=".">
Directory where CAM executable will be created.
</entry>
<entry id="cam_root" value="">
Root directory of CAM source distribution.
</entry>
<entry id="usr_src" value="" list="1">
User source directories to prepend to the filepath.  Multiple directories
are specified as a comma separated list with no embedded white space.
</entry>
<entry id="ccsm_seq" valid_values="0,1" value="0">
Switch specifies whether CAM is being built by the CCSM sequential scripts.  0 => no, 1 => yes.
</entry>
<entry id="comp_intf" valid_values="mct,esmf" value="mct">
Component interfaces: mct or esmf.  Default: mct.
</entry>
<entry id="dyn" valid_values="eul,sld,fv,homme" value="">
Dynamics package: eul, sld, fv, or homme.
</entry>
<entry id="waccm_phys" valid_values="0,1" value="0">
Switch to turn on waccm physics: 0 => no, 1 => yes.
</entry>
<entry id="offline_dyn" valid_values="0,1" value="0">
Switch to turn on FV offline driver: 0 => no, 1 => yes.
</entry>
<entry id="waccmx" valid_values="0,1" value="0">
Option to turn on waccmx thermosphere/ionosphere extension: 0 => no, 1 => yes
</entry>
<entry id="rad_driver" valid_values="0,1" value="0">
Radiation driver : 0 => no, 1 => yes.
</entry>
<entry id="phys" valid_values="cam3,cam3_5_1,cam4,cam5,ideal,adiabatic" value="">
Physics package: cam3, cam4, cam5, ideal (Held-Suarez forcings), adiabatic.
</entry>
<entry id="microphys" valid_values="rk,mg" value="">
Microphysics package: rk (Rasch and Kristjansson), mg (Morrison and Gettelman two moment scheme).
</entry>
<entry id="macrophys" valid_values="rk,park,clubb_sgs,none" value="">
Macrophysics package: RK, Park, CLUBB_SGS.
</entry>
<entry id="clubb_sgs" valid_values="0,1" value="0">
Switch to turn on/off CLUBB_SGS package: 0 => no, 1 => yes
</entry>
<entry id="pbl" valid_values="uw,hb,hbr,clubb_sgs" value="">
PBL package: uw (University of Washington), hb (Holtslag and Boville), hbr
 (Holtslag, Boville, and Rasch), clubb_sgs.
</entry>
<entry id="rad" valid_values="rrtmg,camrt" value="">
Radiative transfer calculation: 
camrt (CAM3 and CAM4 RT package), rrtmg (RRTMG package from AER).
</entry>
<entry id="carma" valid_values="none,bc_strat,cirrus,dust,meteor_smoke,pmc,sea_salt,sulfate,test_detrain,test_growth,test_passive,test_radiative,test_swelling,test_tracers" value="none">
CARMA sectional microphysics: 
none (disabled), bc_strat (Stratospheric Black Carbon), cirrus (Cirrus Clouds), dust (Dust), meteor_smoke (Meteor Smoke), pmc (Polar Mesospheric Clouds), sea_salt (Sea Salt),
sulfate (Sulfate Aerosols), test_detrain (Detrainment), test_growth (Particle Growth), test_passive (Passive Dust), 
test_radiative (Radiatively Active Dust), test_swelling (Sea Salt), test_tracers (age trajectories).
</entry>
<entry id="chem" valid_values="waccm_mozart,waccm_mozart_v1,waccm_mozart_mam3,waccm_mozart_sulfur,waccm_ghg,trop_mozart,trop_mozart_mam3,trop_mozart_soa,trop_strat_bam_v1,trop_strat_mam3,trop_strat_mam7,super_fast_llnl,super_fast_llnl_mam3,trop_ghg,trop_bam,trop_mam3,trop_mam7,none"
 value="">
Chemistry package: waccm_mozart, waccm_mozart_v1, waccm_mozart_mam3, waccm_mozart_sulfur, waccm_ghg, trop_mozart, trop_mozart_mam3, trop_mozart_soa, trop_strat_bam_v1, trop_strat_mam3, trop_strat_mam7, super_fast_llnl, trop_ghg, trop_bam, trop_mam3, trop_mam7, or none.
</entry>
<entry id="prog_species" valid_values="DST,SSLT,SO4,GHG,OC,BC,CARBON16" value="" list="1">
Prognostic mozart species packages: list of any subset of the following: DST,SSLT,SO4,GHG,OC,BC,CARBON16
</entry>
<entry id="edit_chem_mech" valid_values="0,1" value="0">
Switch to allow user to edit chem mechanism file: 0 => no, 1 => yes.
</entry>
<entry id="usr_mech_infile" value="">
Path and file name of the user supplied chemistry mechanism file.
</entry>
<entry id="chem_proc_bld" value="">
Chemistry preprocessor build directory; contains .o and .mod files.
</entry>
<entry id="chem_proc_src" value="">
Chemistry source directory generated by the chemistry preprocessor; contains F90 files.
</entry>
<entry id="chem_src_dir" value="">
Chemistry source directory; contains F90 files.
</entry>
<entry id="lnd" valid_values="clm,slnd,none" value="clm">
Use clm, stub land or no lnd model in cam build: clm, slnd, none
</entry>
<entry id="rof" valid_values="rtm,srof,none" value="rtm">
Use rtm, stub runoff or no runoff model in cam build: rtm, srof, none
</entry>
<entry id="ocn" valid_values="docn,dom,socn,aquaplanet,pop2" value="docn">
Use data ocean model (docn or dom), stub ocean (socn), or aqua planet ocean
(aquaplanet) in cam build.  When built from the CESM scripts the value of
ocn may be set to pop2, but this doesn't impact how CAM is built.
</entry>
<entry id="ice" valid_values="cice,sice,none" value="">
Use cice, stub ice model or no ice model in cam build: cice, sice, none
</entry>
<entry id="cice_mode" valid_values="thermo_only,prescribed" value="">
mode of cice to be used in stand-alone cam test suite
</entry>
<entry id="cice_prestype" valid_values="clim_2000" value="">
if cice_mode is prescribed, input type forcing for prescribed mode
</entry>
<entry id="cice_grid" value="">
cice grid is same as cam grid
</entry>
<entry id="cice_decomptype" valid_values="cartesian,spacecurve" value="">
Type of cice decomposition.
</entry>
<entry id="cice_config_cache_file" value="">
Filename for the CICE config_cache file.
</entry>
<entry id="cice_config_cache_dir" value="">
Directory name for the CICE config_cache file.
</entry>
<entry id="co2_cycle" valid_values="0,1" value="0">
Turn on CO2 cycle in biogeochemistry model: 0 => no, 1 => yes.
</entry>
<entry id="pergro" valid_values="0,1" value="0">
Modifications that allow perturbation growth testing: 0=off, 1=on.
</entry>
<entry id="scam" valid_values="0,1" value="0">
Configure CAM for single column mode: 0=off, 1=on.  This option only
supported for the Eulerian dycore.
</entry>
<entry id="camiop" valid_values="0,1" value="0">
Configure CAM to generate an IOP file that can be used to drive SCAM: 0=no, 1=yes.
This option only supported for the Eulerian dycore.
</entry>
<entry id="hgrid" value="">
Horizontal grid specifier.  The recognized values depend on
the dynamics type and are contained in the config_horiz_grid.xml file.
</entry>
<entry id="nlon" value="1">
Number of unique longitude points in rectangular lat/lon grid.
</entry>
<entry id="nlat" value="1">
Number of unique latitude points in rectangular lat/lon grid.
</entry>
<entry id="csne" value="1">
Number of elements along one edge of a cubed sphere grid.
</entry>
<entry id="csnp" value="1">
Number of points on each edge of the elements in a cubed sphere grid.
</entry>
<entry id="nlev" value="30">
Number of vertical levels.
</entry>
<entry id="nadv" value="">
Total number of advected constituents.  By default this is computed by
configure.  However, configure has a commandline argument to allow the user
to override the default.
</entry>
<entry id="nadv_tt" value="0">
Total number of advected test tracers.
</entry>
<entry id="age_of_air_trcs" valid_values="0,1" value="0">
Switch on (off) age of air tracers: 0=off, 1=on.
</entry>
<entry id="trm" value="1">
Maximum Fourier wavenumber.
</entry>
<entry id="trn" value="1">
Highest degree of the Legendre polynomials for m=0.
</entry>
<entry id="trk" value="1">
Highest degree of the associated Legendre polynomials.
</entry>
<entry id="pcols" value="16">
Maximum number of columns in a chunk (physics data structure).
</entry>
<entry id="cam_exe" value="cam">
Name of CAM executable.
</entry>
<entry id="cppdefs" value="">
User specified CPP defines to append to Makefile defaults.
</entry>
<entry id="cc" value="">
User specified C compiler overrides Makefile default (linux only).
</entry>
<entry id="cflags" value="" list="1">
User specified C compiler options to append to Makefile defaults.
</entry>
<entry id="fc" value="">
User specified Fortran compiler overrides Makefile default.
</entry>
<entry id="fc_type" valid_values="pgi,intel,pathscale,lahey,xlf" value="">
Type of Fortran compiler.  Used when -fc specifies a generic wrapper script
such as mpif90 or ftn.
</entry>
<entry id="debug" valid_values="0,1" value="0">
Switch to enable debugging options for Fortran compiler: 0=off, 1=on.
</entry>
<entry id="fflags" value="" list="1">
User specified Fortran compiler flags to append to Makefile defaults.
</entry>
<entry id="fopt" value="">
User specified Fortran optimization flags to override Makefile defaults.
</entry>
<entry id="linker" value="">
User specified linker.  Overrides the Makefile default $(FC).
</entry>
<entry id="ldflags" value="" list="1">
User specified load options to append to Makefile defaults.
</entry>
<entry id="spmd" valid_values="0,1" value="">
Switch to enable or disable building SPMD version of CAM: 0=off, 1=on.
</entry>
<entry id="ntasks" value="">
Number of MPI tasks.  This is used to determine default grid
decompositions.  Currently only used by CICE.
</entry>
<entry id="smp" valid_values="0,1" value="">
Switch to enable or disable building SMP version (OPENMP) of CAM: 0=off, 1=on.
</entry>
<entry id="nthreads" value="">
Number of OMP threads.  This is used to determine default grid
decompositions.  Currently only used by CICE.
</entry>
<entry id="nc_inc" value="">
Directory containing NetCDF include files.
</entry>
<entry id="nc_lib" value="">
Directory containing NetCDF library.
</entry>
<entry id="nc_mod" value="">
Directory containing NetCDF module files.
</entry>
<entry id="pnc_inc" value="">
Directory containing pNetCDF include files.
</entry>
<entry id="pnc_lib" value="">
Directory containing pNetCDF library.
</entry>
<entry id="lapack_libdir" value="">
Directory containing LAPACK library.
</entry>
<entry id="esmf_libdir" value="">
Directory containing ESMF library (for linking to external ESMF).
</entry>
<entry id="esmf_libvers" value="">
Version of ESMF library.
</entry>
<entry id="mct_libdir" value="">
Directory containing MCT library (for linking to external MCT).
</entry>
<entry id="mpi_inc" value="">
Directory containing MPI include files.
</entry>
<entry id="mpi_lib" value="">
Directory containing MPI library.
</entry>
<entry id="mpi_lib_name" value="">
Name of MPI library.
</entry>
<entry id="cosp" valid_values="0,1" value="0">
Switch to enable building COSP simulator package.  1 => build COSP.
</entry>
<entry id="cosp_libdir" value="">
Directory containing COSP library.
</entry>
<entry id="target_os" value="">
OS for which CAM is being built.  The default value is the name contained
in Perl's $OSNAME variable.  This parameter allows the user to override
that setting to allow for cross-compilation, and for instances where the
$OSNAME value is too generic.  For example, currently on both cray-xt and
bluegene systems $OSNAME has the value "linux".
</entry>

</config_definition>
