===============================================================
Tag name: waccmx01_waccm08_cam3_5_48
Originator(s): Hanli Liu, Joe McInerney
Date: February 19, 2008
One-line Summary: Extension of WACCM to ~500km referred to as WACCM-X
Purpose of changes:
Add capability to model the atmosphere up to ~500km through changes in physics
and chemistry modules
Describe any changes made to build system:
-Added WACCM-X 'configure' defaults file config_defaults_waccmx.xml
-'configure' changed to include WACCM-X flag '-waccmx', use above WACCM-X defaults
file, and point to appropriate source subdirectories in WACCM-X mode
-Added the following to build_namelist use_cases for WACCM-X: waccmx_1953_smin.xml
Describe any changes made to the namelist:
-Added the WACCM-X defaults for the following variables to namelist_defaults_cam.xml:
dtime
ncdata
sad_file
List all subroutines eliminated:
List all subroutines added and what they do:
A models/atm/cam/src/physics/waccmx
-Directory added to contain WACCM-X specific physics modules
A models/atm/cam/src/physics/waccmx/majorsp_diffusion.F90
-Handles major species diffusion which plays a large role above the turbopause
A models/atm/cam/src/dynamics/fv/waccmx
-Directory added to contain WACCM-X specific dynamics modules
A models/atm/cam/src/dynamics/fv/waccmx/dp_coupling.F90
-Modified WACCM-X version of module models/atm/cam/src/dynamics/fv/dp_coupling.F90
-Check for high H and H2 values and print if found
-Added calculation of constituent dependent mean mass, gas constant, specific heat,
gas constant/specific heat ratio, molecular viscosity, molecular conductivity, and
dry static energy
A models/atm/cam/src/physics/waccmx/diffusion_solver.F90
-Modified WACCM-X version of module models/atm/cam/src/physics/cam/diffusion_solver.F90
-Added constituent dependent mean mass, gas constant, specific heat, gas constant/
specific heat ratio, molecular viscosity, molecular conductivity, thermal
conductivity, and dry static energy.
-Zero flux for diffusive equilibrium at upper boundary for LU-Decompostion
-Added subroutine, vd_lu_qdecomp, which solves for molecular thermal conductivity to be
applied to temperature
-More complete formulation of minor species diffusion
-Skip O and O2 in solving minor species diffusion equation
-Upper boundary flux of H is updated
A models/atm/cam/src/physics/waccmx/geopotential.F90
-Modified WACCM-X version of module models/atm/cam/src/physics/cam/geopotential.F90
-Added constituent dependent gas constant and specific heat
-Use these in calculation of geopotential height
A models/atm/cam/src/physics/waccmx/gw_drag.F90
-Modified WACCM-X version of module models/atm/cam/src/physics/cam/gw_drag.F90
-Total(eddy+molecular) diffusion calculated
-Use total diffusion in calculation of gravity wave drag profiles instead of just
molecular diffusion
-Modified calculation of loop indices Umini and Umaxi
A models/atm/cam/src/physics/waccmx/molec_diff.F90
-Modified WACCM-X version of module models/atm/cam/src/physics/cam/molec_diff.F90
-Added constituent dependent mean mass, gas constant, specific heat, and molecular
weight factor
-Changed value of exponentiation factor
-Modified calculation of interface temperature, density, dry static energy, and
diffusivity for heat
-Added calculation of eddy diffusivity for constituents
A models/atm/cam/src/physics/waccmx/physics_types.F90
-Modified WACCM-X version of module models/atm/cam/src/physics/cam/physics_types.F90
-Added constituent dependent mean mass, gas constant, and specific heat
-Check of large H and H2 values and replaced with a more reasonable value
-Added update of dry static energy
-Added constituent dependent gas constant and specific heat to geopotential_dse
interface
-Filled in constituent dependent variables and molecular viscosity and conductivity
in state_out structure
List all existing files that have been modified, and describe the changes:
The following modules have been modified for WACCM-X run mode only:
M models/atm/cam/src/chemistry/waccm_mozart/chemistry.F90
-Changed fixed upper boundary from true to false
M models/atm/cam/src/chemistry/waccm_mozart/iondrag.F90
-Added constituent dependent specific heat
M models/atm/cam/src/chemistry/waccm_mozart/mo_mean_mass.F90
-Flag changed so mean mass is calculated from species mixing ratios
M models/atm/cam/src/chemistry/waccm_mozart/mo_tgcm_ubc.F90
-Added constituent dependent mean mass at top level
M models/atm/cam/src/chemistry/waccm_mozart/mo_waccm_hrates.F90
-Added constituent dependent specific heat and mean mass
M models/atm/cam/src/chemistry/waccm_mozart/upper_bc.F90
-Added constituent dependent gas constant and mean mass
-Changed upper boundary NO mixing ratio to zero for model top greater than 150km
M models/atm/cam/src/dynamics/fv/dyn_comp.F90
-Added constituent dependent gas constant and specific heat
M models/atm/cam/src/dynamics/fv/stepon.F90
-Update constituent dependent gas constant and specific heat
M models/atm/cam/src/dynamics/fv/te_map.F90
-Vertical velocity set to zero at top level
M models/atm/cam/src/physics/waccm/nlte_lw.F90
-Added constituent dependent specific heat
M models/atm/cam/src/physics/cam/physpkg.F90
-Added call to mspd_inti for major species diffusion initialization
-Added constituent dependent gas constant to geopotential_t call
M models/atm/cam/src/physics/waccm/radheat.F90
-Added constituent dependent specific heat
-Use in calculation of merged heating rates
M models/atm/cam/src/physics/cam/tphysac.F90
-Added call to mspd_intr for major species diffusion
M models/atm/cam/src/physics/cam/vertical_diffusion.F90
-Added constituent dependent mean mass, gas constant, and specific heat and
molecular viscosity and conductivity
-Changed upper vertical extent where eddy diffusion applied from top level to
level closest to 1E-05 Pa
CAM tag used for the baseline comparison tests if different than previous
tag:
CAM/WACCM 3.5.48 Tag 08
===============================================================