********************************************************************************
Announcing the release of MCIP Version 3.2 (September 2006)
********************************************************************************

This is a minor update to the MCIP code.  Changes to MCIP were overseen by
Tanya Otte (NOAA/ARL/ASMD and EPA/ORD/NERL, RTP, NC).  User contributions are
also noted below.  The detailed list of changes to the MCIP code is in the
CHANGES file, which is part of the MCIP tar file in the MCIP2/doc directory.


Users are encouraged to update to this version of MCIP, particularly for
WRF-based applications.


Also updated with this release is the Frequently Asked Questions (FAQ) file,
which is located in the MCIP tar file in the MCIP2/doc directory.  Users are
encouraged to read the FAQ to obtain information specific to changes made in
this release, particularly on applications that use input data from WRF.
Users should read the FAQ before submitting inquiries to M3User, M3List,
Bugzilla, CMAS, or the code developers.


In addition to the changes noted below, several "legacy" user options in
MCIP are marked as obsolescent with this release, and these options are
targeted for removal from MCIP in the next release.  The obsolescent options
include:

	1.  RADMDry Dry Deposition (LDDEP = 1)
	2.  Recalculation of PBL fields (LPBL = 2 and LPBL = 3)
	3.  Recalculation of radiation fields (LRAD = 2)
	4.  Input in MM5v2 format.


Interactions with the following users (in alphabetical order) have resulted
in some of the code changes that were made for MCIPv3.2:

	Zac Adelman (Carolina Environmental Program, UNC, Chapel Hill, NC)
	Jeremy Avise (Washington State Univ., Pullman, WA)
	Dong-Sheng Chen (Beijing Univ. of Technology, China)
	Carlie Coats (Baron Advanced Meteorological Systems)
	Jerry Herwehe (NOAA/ARL/ASMD, RTP, NC)
	Sara Johansson (Univ. of British Columbia, Canada)
	Maudood Khan (Georgia Dept. of Natural Resources)
	Duanjun Lu (Jackson State Univ., Jackson, MS)
	LeHoang Nghiem (Asian Institute of Technology, Thailand)
	Jayaraman Potty (Nanyang Technological University, Singapore)
	Shandon Smith (TVA)
	Duong Hong Son (Institute of Meteorology and Hydrology, Vietnam)
	Igor Vaciili (affiliation unknown)
	David Wong (formerly Lockheed Martin; now NOAA/ARL/ASMD, RTP, NC)


The following are the notable changes in MCIPv3.2:

 1.  Modified I/O API header variable settings for WRF-ARW (WRF-EM) to
     reflect additional capability to have center of coarse domain located
     elsewhere than the center of the projection.  (Note that applications of
     CMAQ with WRF-ARW input will no longer adhere to the "grid family"
     paradigm for the Models-3 I/O API, and a separate GRIDDESC file will be
     required for each grid.)

 2.  For non-PX runs only:  Corrected error in bookkeeping "last wet time"
     in M3Dry dry deposition when Pleim-Xiu land-surface model is not run.
     Also now use ground temperature rather than 2-m air temperature to
     calculate ground-level relative humidity.  Allow canopy to dry out
     gradually between 2 and 3 hours after "last wet time".

 3.  Updated the checking and setting of I/O API header variables for
     Mercator and polar stereographic projection.

 4.  Added restriction that the Eta/Ferrier microphysics scheme in WRF-ARW
     is currently incompatible with CMAQ.

 5.  Added capability to fill land-use lookup table fields in MM5v3-formatted
     data that have been converted from MM5v2 format.

 6.  Corrected filling of vertical velocity array for MM5v2-formatted data.

 7.  Added land-water mask (LWMASK) to output in GRIDCRO2D.

 8.  Corrected logic for processing MM5's TERRAIN file to account for
     expanded grid in domain 1.

 9.  Updated condition for GRIDCRO3D output to reflect new WRF-ARW
     vertical coordinate descriptor for I/O API.

10.  Optimized calculations of species-specific constants in M3Dry.

11.  Use land-water mask rather than dominant land use array to determine
     water points.

12.  Added ASCII file "CODE_STRUCTURE" that includes calling tree for MCIP.

13.  Updated FAQ.

14.  Performed general code cleanup to remove unused variables, move some
     variables from global to local, resolve type mismatches, and correct
     or clarify some comments.