================================================================================
SVN $URL: https://svn-ccsm-release.cgd.ucar.edu/model_versions/cesm1_0_2 $
================================================================================

Tag name: cesm1_0_2
Originator(s): cseg
Date: Fri Dec 03 2010
One-line Summary: Second update to the cesm1.0 release code.

#  known answer changes

    * All FV runs at 1/2 deg and higher resolution change beyond roundoff due 
	to a change in the FV div4 filter.
    * All WACCM and trop_mozart runs change beyond roundoff due to changes in 
	the lower boundary files for GHGs.
    * All historical runs with cam5 physics change answers beyond roundoff due 
	to updating the prescribed GHG dataset to the AR5 version.
    * All Eulerian T31 runs change beyond roundoff due to tuning parameter 
	changes.
    * All runs with cam5 physics at resolutions different than 1.9x2.5 change 
	answers beyond roundoff due to changes in default tuning parameters.
    * All C- and G-compset cases will be different because of the correction 
	to the application of the evaporation-precipitaion factor to both 
	runoff and precipitation fields (cpl bugfix).
    * All 2000 compsets will be differenct, because CCSM_CO2_PPMV was changed 
	to 367.0 in these compsets.

# atmosphere/CAM

    * Tuning mods for Eulerian T31 resolution used in paleoclimate simulations.
    * Fix for the FV div4 filter. This filter is only turned on by default for 
	1/2 deg and higher resolution grids, so this change only affects 
	answers for those resolutions.
    * Set the lower boundary values of GHGs using the WACCM lower boundary file 
	for all prognostic GHG chemistry schemes. This changes answers beyond 
	roundoff for WACCM runs and for trop_mozart. It doesn't affect 
	trop_mam3 or the superfast_chem schemes.
    * Fix to column pairing algorithm in phys_grid. The bug would cause load 
	balance problems, but not affect answers.
    * Fix the prescribed GHG dataset for cam5 use case. Enables historical run 
	to go through the end of 2005. This changes answers beyond roundoff for 
	cam5 historical runs.
    * Include workaround for slow compilations with the intel compiler.
    * Corrected the default settings for cam5 simulations at resolutions other 
	than 1.9x2.5. This changes answers beyond roundoff for all cam5 
	simulations except those done at 1.9x2.5.

# land/CLM

    * Add a new initial condition file for T31 support.
    * Turn ice_runoff to off for T31.
    * Add ndepmapalgo to namelist:
          o ndepmapalgo = Mapping method from Nitrogen deposition input file 
	to the model resolution. The mapping method can be bilinear,nn,nnoni,
	nnonj,spval,copy; the default is bilinear.
    * Add U10 field to driver and history files (for dust, old U10 field 
	renamed to U10_DUST).
    * Add new single point options for mksurfdata (to override vegetation and 
	soil types).
    * Change some configure options, add -sitespf_pt option to setup urban 
	test sites correctly.

# ice/CICE

    * Parameters for the low-resolution (gx3v7) ice model have been modified, 
	and solutions produced with these settings have been scientifically 
	validated.

# ocn/POP2

    * Parameters for the low-resolution (gx3v7) ocean model are scientifically 
	valid.
    * Minor improvements have been made to POP2 netCDF tavg history fields.

# driver

    * In previous versions, the epbal factor (when activated) was applied to 
	precip, but not runoff. In the cesm1_0_2 release, this problem has 
	been corrected: the epbal factor is now applied to runoff, too.

# share code

    * A workaround for the shr_scam_mod.F90 build issue has been implemented.

# scripts

    * Added support for T31_g37.
    * Moved ${COMP}_NCPL to env_conf.xml.
    * Added START_TOD to env_run.xml.
    * Updated library module to allow CESM1 to build on kraken.
    * Set CCSM_CO2_PPMV for all 2000 compsets to 367.0, which changes answers.
    * Parallelized the archiving scripts for faster turnaround of archiving 
	tasks.

# data, dead, and stub models

    * The stub and dead models are unchanged.
    * The dlnd and docn models are unchanged.
    * The datm and dice models were updated for compatability with share code. 
	
================================================================================

Tag name: cesm1_0_1
Originator(s): cseg
Date: Fri Sep 17 2010
One-line Summary: First update to the cesm1.0 release code.

#  known answer changes
    * WACCM F compset bug fix changes answers.
    * CAM5 update changes answers.
    * New default processor layout on bluefire for 1 degree B compsets changes 
	answers.
    * FV filter change in CAM for high resolution grids (1/2 degree and finer) 
	changes answers.

# atmosphere/CAM
    * Add namelist specifier for which history file to write heat/moisture 
	budget terms to.
    * Separate aerosol activation code from microphysics code. (code cleanup; 
	introduces roundoff diffs in cam5 on some platforms)
    * Fix FV offline driver for 2D decomp and WACCM configs; fix configure to 
	allow chem customization w/ trop_bam and *_ghg.
    * Rename of types for import/export states (code cleanup).
    * Add ability to read FAA aircraft emissions w/ conservative interpolation.
    * Fix memory leak with workaround for xlf compiler bug.
    * FV memory optimization; repro_sum update; spmd_utils and mod_comm 
	communication protocol updates.
    * Change FV filter defaults for high resolution grids (1/2 degree and finer). 
	This changes answers in high res runs.

# land/CLM
    * Updates to CLM include various small fixes for CLM single-point mode and 
	documentation updates. Updates to documentation included how to handle 
	your data when using link_dirtree, and additional documentation and plots 
	for the perturbation error growth method to validate a port to CLM.

# ice/CICE
    * No changes.

# ocn/POP
    * The units reported in the pop2 tavg output files for DON_prod are now 
	correct.

# driver
    * Refactored the driver restart implementation to use only pio for reading 
	and writing of all variables.
    * Minor updates to the shr_esmf code to improve performance when esmf 
	interfaces are used.

# scripts
    * Added support for edinburgh_pgi infiniband.
    * Added support for lynx_pgi.
    * Added support for pleiades [svn-ccsm-models.cgd.ucar.edu].
    * Fixed co2_ppm value for FW and F1850W compsets, known problem.
    * Fixed F_AMIP_CAM5 and F_1850_CN_CHEM compsets, known problem.
    * Updates to intrepid compiler flags.
    * Archiver fixes and enhancements.

================================================================================
Tag name: cesm1_0
Originator(s): cseg
Date: Fri Jun 25 2010
One-line Summary: First released version of the cesm1.0 code.

This tag is the first officially released version of the cesm1.0 code.
Release tag cesm1_0 corresponds to internal release candidate cesm1_0_rel02.

================================================================================
