********************************************************************************
Announcing the release of MCIP Version 3.3 (August 2007)
********************************************************************************

The MCIP code is updated to version 3.3.  Changes to MCIP were overseen by
Tanya Otte (NOAA/ARL/ASMD and EPA/ORD/NERL, RTP, NC).  Some updates to the M3Dry
dry deposition module were provided by Jonathan Pleim, Ellen Cooter, Jesse Bash
(NOAA/ARL/ASMD and EPA/ORD/NERL, RTP, NC), and Golam Sarwar (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
MCIP3/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 MCIP3/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.


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

        Michael Bane (Univ. of Manchester, Manchester, UK)
        Ashley Queen (North Carolina State Univ., Raleigh, NC)
        Shawn Roselle (NOAA/ARL/ASMD, RTP, NC)
        Brian Timin (U.S. EPA OAQPS, RTP, NC)
        Fuquan Yang (National Research Council of Canada, Ottawa, ON, Canada)


The following are the notable changes in MCIPv3.3:

 1.  Several scientific changes were made in the M3Dry dry deposition module.

     a.  A non-zero mesophyll resistance was added for NO, NO2, and CO.
     b.  A special case for wet cuticle resistance for O3 was restored.
     c.  Wet ground resistance was added.  The total ground resistance was
         modified to include a partitioning of contributions from wet and dry
         ground.
     d.  The pH of rain water was changed for the eastern United States and
         outside of North America.
     e.  The reactivity for PAN was changed.
     f.  The use of rediagnosed (in MCIP) 1.5-m temperature was eliminated
         and replaced with 2-m temperature (diagnosed in the meteorology
         model, if available; otherwise calculated in MCIP).
     g.  An error was corrected in the calculation of surface resistance over
         water where a term was missing from the numerator.  In addition, the
         surface resistance over water is now a function of species, and the
         its calculation uses wet bulb temperature rather than ground (water)
         temperature in the effective Henry's law constant.
     h.  Effective Henry's law constant over land now uses 2-m temperature
         instead of layer 1 temperature.
     i.  Obsolete chlorine species, ICL1 and ICL2, were removed.  (They are
         only used for CB-IV with chlorine mods; they are not in CB05.)
     j.  M3Dry can now only be run with all species; chlorine and mercury
         cannot be omitted to minimize disk space requirements.

 2.  Several "legacy" user options in MCIP that were marked as obsolescent in
     MCIPv3.2 are eliminated in this release.  The deleted options include:

     a.  RADMDry Dry Deposition (LDDEP = 1)
     b.  Recalculation of PBL fields (LPBL = 2 and LPBL = 3)
     c.  Recalculation of radiation fields (LRAD = 2)
     d.  Input in MM5v2 format. [Can convert to MM5v3 format with utility code.]

 3.  For WRF data sets only:  Corrected an error in processing incremental
     precipitation (output fields RN and RC in METCRO2D) for the first MCIP
     output period when the first WRF output time is not used by MCIP.

 4.  For MM5 data sets only:  Corrected an error in the calculation of
     contravariant vertical velocity (output field WHAT_JD in METCRO3D) for
     non-hydrostatic MM5 simulations where the total surface pressure was used
     from the first time period processed by MCIP rather than the reference
     surface pressure.  [Has no impact on CMAQ simulations that use the
     (default) Yamartino scheme because contravariant vertical velocity is
     recalculated there.]

 5.  Updated MCIP to account for new method of storing "real" scalars in
     WRF I/O API with WRFv2.2.  [Backward-compatible with older WRF files.]

 6.  Updated MCIP to have a more general treatment of land-surface fields
     so that land-surface models in addition to Pleim-Xiu (such as NOAH)
     can be better accommodated.  (Both MM5 and WRF data sets.)

 7.  Added metadata to MCIP output files to describe MCIP version, input
     meteorology source, and options used in the meteorology model.
     [Can be viewed with "ncdump -h <file>", and appears in (formerly blank)
     M3IO header field FILEDESC.]

 8.  Added output fields to support calculating dry deposition velocities
     inline in the CCTM.  Added option (LDDEP=0) to bypass calculating dry
     deposition velocities in MCIP.  Added fractional land use to output
     (LUFRAC_nn, where nn = 01 to number of land use categories, in GRIDCRO2D).
     [The inline dry deposition velocity calculation is NOT available in
     CMAQv4.6.  It will be released in 2008.]

 9.  Ensured that 2-m temperature (TEMP2 in METCRO2D) is always in output.
     Eliminated several fields from output in METCRO2D, including
     1.5-m temperature (TEMP1P5), 10-m temperature (TEMP10), inverse laminar
     boundary resistance (RBNDYI), and total Jacobian at the surface (JACOBS).

10.  Changed Schmidt number for water to be consistent throughout code.

11.  Corrected setting for number of microphysical species available when
     warm rain scheme is run in MM5.

12.  Corrected sample print statements in the log file for a one-cell domain.

13.  Updated FAQ and CODE_STRUCTURE.