ChangeLog draft

Author: fvitt

cime_config/testdefs/testmods_dirs/cam/carma_meteor_smoke/user_nl_cam

@@ -7,3 +7,4 @@ history_carma=.true.
 carma_do_fixedinit=.false.
 solar_data_type='FIXED'
 solar_data_ymd=20000101
+

doc/ChangeLog

@@ -1,14 +1,20 @@
 ===============================================================
 
-Tag name:
+Tag name: cam6_4_073
 Originator(s): fvitt, tilmes
 Date:
-One-line Summary:
-Github PR URL:
+One-line Summary: New CARMA trop_strat aerosol models
+Github PR URL: https://github.com/ESCOMP/CAM/pull/1210
 
 Purpose of changes (include the issue number and title text for each relevant GitHub issue):
 
-Describe any changes made to build system:
+ Introduce CARMA trop_strat_soa1 and trop_strat_soa5 sectional aerosol models which can be used
+ as alternatives to the modal aerosol aerosol representation in CAM physics.
+
+ Issue #495 -- Merging CARMA aerosol model for troposphere and stratosphere (trop_strat)
+ into the CESM development version
+
+Describe any changes made to build system: N/A
 
 Describe any changes made to the namelist:
 
@@ -46,13 +52,13 @@ Describe any changes made to the namelist:
  Removed
   . carma_reftfile
 
-List any changes to the defaults for the boundary datasets:
+List any changes to the defaults for the boundary datasets: N/A
 
-Describe any substantial timing or memory changes:
+Describe any substantial timing or memory changes: none
 
-Code reviewed by:
+Code reviewed by: jimmielin, cacraigucar
 
-List all files eliminated:
+List all files eliminated: N/A
 
 List all files added and what they do:
 A	bld/namelist_files/use_cases/carma_trop_strat_cam6.xml
@@ -61,25 +67,36 @@ A	bld/namelist_files/use_cases/carma_trop_strat_nudged_cam6.xml
 A	bld/namelist_files/use_cases/carma_trop_strat_sd_cam6.xml
 A	bld/namelist_files/use_cases/carma_waccm_ma_hist_cam6.xml
 A	bld/namelist_files/use_cases/carma_waccm_ma_nudged_cam6.xml
+ - new build-namelist use cases for carma trop_strat models
+
 A	cime_config/testdefs/testmods_dirs/cam/carma_elvemis_outfrq9s/shell_commands
 A	cime_config/testdefs/testmods_dirs/cam/carma_elvemis_outfrq9s/user_nl_cam
 A	cime_config/testdefs/testmods_dirs/cam/carma_elvemis_outfrq9s/user_nl_clm
+ - for new CARMA trop_strat tests
+
 A	src/chemistry/aerosol/carma_aerosol_properties_mod.F90
 A	src/chemistry/aerosol/carma_aerosol_state_mod.F90
+ - for new CARMA trop_strat models
+
 A	src/chemistry/aerosol/hygrocoreshell_aerosol_optics_mod.F90
 A	src/chemistry/aerosol/hygrowghtpct_aerosol_optics_mod.F90
+ - for new CARMA trop_strat models
+
 A	src/chemistry/carma_aero/aero_model.F90
 A	src/chemistry/carma_aero/carma_aero_gasaerexch.F90
 A	src/chemistry/carma_aero/dust_model.F90
 A	src/chemistry/carma_aero/seasalt_model.F90
 A	src/chemistry/carma_aero/sox_cldaero_mod.F90
+ - for new CARMA trop_strat models
 
 A	src/physics/carma/models/trop_strat_soa1/carma_model_flags_mod.F90
 A	src/physics/carma/models/trop_strat_soa1/carma_model_mod.F90
 A	src/physics/carma/models/trop_strat_soa5/carma_model_flags_mod.F90
 A	src/physics/carma/models/trop_strat_soa5/carma_model_mod.F90
+ - for new CARMA trop_strat models
 
 A	src/physics/cam/carma_diags_mod.F90
+ - data object for carma aerosols budgets
 
 A	src/chemistry/pp_trop_strat_noaero/chem_mech.doc
 A	src/chemistry/pp_trop_strat_noaero/chem_mech.in
@@ -99,6 +116,8 @@ A	src/chemistry/pp_trop_strat_noaero/mo_prod_loss.F90
 A	src/chemistry/pp_trop_strat_noaero/mo_rxt_rates_conv.F90
 A	src/chemistry/pp_trop_strat_noaero/mo_setrxt.F90
 A	src/chemistry/pp_trop_strat_noaero/mo_sim_dat.F90
+ - added for carma trop_strat_soa5 model
+
 A	src/chemistry/pp_waccm_ma_noaero/chem_mech.doc
 A	src/chemistry/pp_waccm_ma_noaero/chem_mech.in
 A	src/chemistry/pp_waccm_ma_noaero/chem_mods.F90
@@ -117,8 +136,11 @@ A	src/chemistry/pp_waccm_ma_noaero/mo_prod_loss.F90
 A	src/chemistry/pp_waccm_ma_noaero/mo_rxt_rates_conv.F90
 A	src/chemistry/pp_waccm_ma_noaero/mo_setrxt.F90
 A	src/chemistry/pp_waccm_ma_noaero/mo_sim_dat.F90
+ - added for carma trop_strat_soa1 model
+
 A	src/chemistry/utils/elevated_emissions_mod.F90
 A	src/chemistry/utils/surface_emissions_mod.F90
+ - add emissions to pbuf to be used by carma trop_strat models
 
 List all existing files that have been modified, and describe the changes:
 
@@ -136,44 +158,124 @@ M	bld/namelist_files/namelist_definition.xml
 
 M	cime_config/config_component.xml
 M	cime_config/config_compsets.xml
+ - new compsets for caram trop_strat models
+  . QPCARMATS
+  . QPCARMAWM
+  . FCARMA2000climo
+  . FCARMAHIST
+  . FCARMAnudged
+  . FCARMASD
+  . FWmaCARMAHIST
+  . FWmaCARMAnudged
+
+
 M	cime_config/config_pes.xml
-M	cime_config/testdefs/testmods_dirs/cam/carma_meteor_smoke/user_nl_cam
+ - default derecho PE layouts for CARMA compsets
+
 M	src/chemistry/aerosol/aero_deposition_cam.F90
+ - loop end at props%nspecies
+
 M	src/chemistry/aerosol/aero_wetdep_cam.F90
+ - add caram_aero_props and carma_aero_state objects
+ - loop end at props%nspecies
+
 M	src/chemistry/aerosol/aerosol_state_mod.F90
+ - add wgtpct interface H2SO4/H2O
+
 M	src/chemistry/aerosol/mo_setsox.F90
+ - state needed for carma trop_strat models
+
 M	src/chemistry/aerosol/modal_aerosol_state_mod.F90
+ - wgtpct interface added
+
 M	src/chemistry/bulk_aero/aero_model.F90
+ - invoke dust_readnl
+ - pass state to setsox interface
+
 M	src/chemistry/bulk_aero/sox_cldaero_mod.F90
+ - add state to interface
+
 M	src/chemistry/geoschem/chemistry.F90
+ - pass state to setsox interface
+
 M	src/chemistry/modal_aero/aero_model.F90
+ - invoke dust_readnl
+ - pass state to setsox interface
+
 M	src/chemistry/modal_aero/sox_cldaero_mod.F90
+ - add state to interface
+
 M	src/chemistry/mozart/chemistry.F90
+ - add ndropmixed flag to registered constituents
+ - dust_readnl moved to aero_model
+
 M	src/chemistry/mozart/mo_gas_phase_chemdr.F90
+ - JNO2 added to pbuf
+ - state passed to userrxt
+
 M	src/chemistry/mozart/mo_photo.F90
+ - restrict debug write to masterproc
+
 M	src/chemistry/mozart/mo_usrrxt.F90
+ - state passed to aero_model_surfarea
+
 M	src/control/cam_history.F90
+ - increase hash size for carma history fields
+
 M	src/control/runtime_opts.F90
+ - invoke surface_emissions_readnl and elevated_emissions_readnl
+
 M	src/physics/cam/aer_rad_props.F90
+ - changes for carma bins
+
 M	src/physics/cam/aerosol_optics_cam.F90
+ - changes for carma aerosol optics
+
 M	src/physics/cam/carma_intr.F90
 M	src/physics/cam/carma_model_flags_mod.F90
+ - changes for carma trop_strat models
+
 M	src/physics/cam/clubb_intr.F90
+ - use ndropmixed constituent attribute to turn off transport of aerosols
+
 M	src/physics/cam/constituents.F90
+ - add ndropmixed constituent attribute
+
 M	src/physics/cam/micro_pumas_cam.F90
+ - use ndropmixed constituent attribute to turn off transport of droplet number
+
 M	src/physics/cam/microp_aero.F90
 M	src/physics/cam/nucleate_ice.F90
 M	src/physics/cam/nucleate_ice_cam.F90
+ - add caram_aero_props and carma_aero_state objects
+
 M	src/physics/cam/phys_control.F90
+ - add history_carma_srf_flx flag
+
 M	src/physics/cam/phys_prop.F90
+ - changes for carma aerosol optics
+
 M	src/physics/cam/physpkg.F90
+ - invoke surface_emissions and elevated_emissions routines
+ - invoke carma aerosol budget routines
+
 M	src/physics/cam/rad_constituents.F90
+ - parse carma bin_defs namelist settings
+
 M	src/physics/cam/restart_physics.F90
+ - invoke carma restart
+
 M	src/physics/cam/vertical_diffusion.F90
+ - use ndropmixed constituent attribute to turn off transport of aerosols
+
 M	src/physics/cam7/micro_pumas_cam.F90
+ - use ndropmixed constituent attribute to turn off transport of droplet number
+
 M	src/physics/cam7/physpkg.F90
-M	src/physics/carma/cam/carma_intr.F90
+ - invoke surface_emissions and elevated_emissions routines
 
+M	src/physics/carma/cam/carma_intr.F90
+ - changes for carma trop_strat models
 
 
 If there were any failures reported from running test_driver.sh on any test