RCS file, release, date & time of last delta, author, state, [and locker] $Header: /project/work/rep/MCIP2/src/doc/CHANGES,v 1.11 2006/09/27 13:55:32 tlotte Exp $ CHANGES for MCIP MCIP Version 3.2 (20 September 2006) - 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.) Changed files: mcip2/metinfo_mod.F mcip2/setgriddefs.F mcip2/setup_mm5v2.F mcip2/setup_mm5v3.F mcip2/setup_wrfem.F Deleted file: mcip2/xxyy.F - 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". Changed files: mcip2/dynflds.F mcip2/m3dry.F - Corrected checking and setting of I/O API header variables for Mercator and polar stereographic projections. Changed files: mcip2/rdmm5v2.F mcip2/rdmm5v3.F mcip2/setgriddefs.F mcip2/setup_mm5v2.F mcip2/setup_mm5v3.F mcip2/setup_wrfem.F - Added restriction that Eta/Ferrier microphysics scheme in WRF-ARW (WRF-EM) is currently incompatible with CMAQ. Changed file: mcip2/setup_wrfem.F - Added capability to fill land-use lookup table fields in MM5v3-formatted data that have been converted from MM5v2 format. Changed file: mcip2/rdmm5v3.F - Corrected filling of vertical velocity array for MM5v2-formatted data. Changed file: mcip2/rdmm5v2.F - Added land-water mask to output in GRIDCRO2D. Changed files: mcip2/alloc_ctm.F mcip2/alloc_x.F mcip2/dealloc_ctm.F mcip2/dealloc_x.F mcip2/getluse.F mcip2/gridout.F mcip2/groutcom_mod.F mcip2/init_x.F mcip2/xvars_mod.F - Corrected logic for processing MM5's TERRAIN file to account for expanded grid in domain 1. Changed file: mcip2/readter.F - Updated condition for GRIDCRO3D output to reflect new WRF-ARW (WRF-EM) vertical coordinate descriptor for I/O API. Changed files: mcip2/alloc_ctm.F mcip2/gridout.F - Optimized calculations of species-specific constants. Changed files: mcip2/alloc_depv.F mcip2/dealloc_depv.F mcip2/depvvars_mod.F mcip2/m3dry.F - Use land-water mask rather than dominant land use array to determine water points. Changed files: mcip2/m3dry.F mcip2/resistcalc.F - General code clean-up (remove unused variables, moved variables from global modules to local within subroutines, type mismatches, correcting or clarifying comments, etc.). Changed files: mcip2/alloc_x.F mcip2/collapx.F mcip2/const_mete_mod.F mcip2/const_mod.F mcip2/dealloc_x.F mcip2/getluse.F mcip2/getmet.F mcip2/gridout.F mcip2/init_met.F mcip2/init_x.F mcip2/layht.F mcip2/m3dry.F mcip2/metcro.F mcip2/metdot.F mcip2/metgrid2ctm.F mcip2/metvars2ctm.F mcip2/pblpkg.F mcip2/pblpwr.F mcip2/resistcalc.F mcip2/setgriddefs.F mcip2/setup_mm5v3.F mcip2/setup_wrfem.F mcip2/sfcflux.F mcip2/sfclayer.F mcip2/slflux.F mcip2/solar.F mcip2/vertnhy.F mcip2/vertnhy_wrf.F mcip2/wrf_netcdf_mod.F mcip2/xvars_mod.F - Added ASCII file that includes calling tree for MCIP. New file: doc/CODE_STRUCTURE - Updated frequently asked questions list. Changed file: doc/FAQ - Updated version stamp. Changed file: mcip2/vstamp.F -------------------------------------------------------------------------------- MCIP Version 3.1 (27 February 2006) - Updated calculation of dry deposition velocities for elemental mercury (Hg0) in M3Dry. Changed files: mcip2/alloc_depv.F mcip2/dealloc_depv.F mcip2/depvvars_mod.F mcip2/m3dry.F - Changed tolerances on calculation of grid origin for WRF so that the grid center is not restricted to a cell corner. Changed file: mcip2/setgriddefs.F - Updated code for vertical coordinate definitions for WRF. Changed files: mcip2/parms3_mod.F mcip2/setgriddefs.F - Corrected setting of I/O API grid definition for Mercator projection. Changed file: mcip2/setgriddefs.F - Updated script to correctly set namelist end string for Mac running XLF compiler. Changed file: mcip2/run.mcip - Removed unused "USE" statement. Changed file: mcip2/dynflds.F - Updated frequently asked questions list. Changed file: doc/FAQ - Updated version stamp. Changed file: mcip2/vstamp.F -------------------------------------------------------------------------------- MCIP Version 3.0 (19 August 2005) - Added processing of meteorological fields from WRF-EM (i.e., WRF-ARW or NCAR core). Changed files: mcip2/alloc_met.F mcip2/alloc_x.F mcip2/dealloc_met.F mcip2/dealloc_x.F mcip2/getmet.F mcip2/init_met.F mcip2/init_x.F mcip2/m3dry.F mcip2/mcip.F mcip2/mcoutcom_mod.F mcip2/metgrid2ctm.F mcip2/metinfo_mod.F mcip2/metvars_mod.F mcip2/metvars2ctm.F mcip2/pblpkg.F mcip2/pblsup.F mcip2/radmdry.F mcip2/setgriddefs.F mcip2/statflds.F New files: mcip2/rdwrfem.F mcip2/setup.F mcip2/setup_wrfem.F mcip2/vertnhy_wrf.F mcip2/wrf_netcdf_mod.F mcip2/xxyy.F Deleted files: mcip2/setupmm5.F - Renamed subroutines to make code more general. New files: mcip2/setup_mm5v2.F mcip2/setup_mm5v3.F Deleted files: mcip2/setupv2.F mcip2/setupv3.F - Added options to M3Dry for processing dry deposition species for chlorine and mercury. Moved setup of dry deposition arrays to separate routines. Removed pointers to dry deposition species names. Changed files: mcip2/alloc_x.F mcip2/dealloc_x.F mcip2/dynflds.F mcip2/hlconst.F mcip2/init_x.F mcip2/m3dry.F mcip2/mcip.F mcip2/mcipparm_mod.F mcip2/mcoutcom_mod.F mcip2/metcro.F mcip2/radmdry.F mcip2/readnml.F mcip2/setgriddefs.F mcip2/xvars_mod.F mcip2/run.mcip New files: mcip2/alloc_depv.F mcip2/dealloc_depv.F mcip2/depvvars_mod.F mcip2/init_depv.F - Added capability to process and use fractional land use fields from MM5v3, if they are available in separate input file. Allow fractional land use to be used in RADMDry. Added optional output field, percent urban area (PURB), to GRIDCRO2D. Changed files: mcip2/alloc_ctm.F mcip2/alloc_met.F mcip2/alloc_x.F mcip2/dealloc_ctm.F mcip2/dealloc_met.F mcip2/dealloc_x.F mcip2/file_mod.F mcip2/getluse.F mcip2/gridout.F mcip2/groutcom_mod.F mcip2/init_met.F mcip2/init_x.F mcip2/mcipparm_mod.F mcip2/rdmm5v3.F mcip2/readnml.F mcip2/setup_mm5v3.F mcip2/xvars_mod.F mcip2/run.mcip New files: mcip2/readter.F - Corrected settings for Southern Hemisphere seasons and other calculations for Southern Hemisphere domains. Changed files: mcip2/gridgeometry.F mcip2/mcipparm_mod.F mcip2/pblpkg.F mcip2/pblsup.F mcip2/radmdry.F mcip2/setup_mm5v2.F mcip2/setup_mm5v3.F mcip2/sfcflux.F - Added option to use all layers from input meteorology as MCIP output without specifying list a priori. Changed files: mcip2/mcipparm_mod.F mcip2/readnml.F mcip2/setup_mm5v2.F mcip2/setup_mm5v3.F mcip2/run.mcip - Added check to ensure settings in I/O API library are consistent with settings in modules in MCIP. Requires I/O API v3.0. Changed files: mcip2/init_io.F - Changed calculations of 3D transport winds (UHAT_JD, VHAT_JD, and WHAT_JD) and PBL variables to use winds and map-scale factors with fewer interpolation steps to better reflect fields from input meteorology model. Changed files: mcip2/alloc_x.F mcip2/dealloc_x.F mcip2/init_x.F mcip2/metdot.F mcip2/metvars2ctm.F mcip2/pblpkg.F mcip2/pblsup.F mcip2/verthyd.F mcip2/vertnhy.F mcip2/xvars_mod.F - Updated calculation of layer heights for non-hydrostatic MM5 to use formulae defined by NCAR for MM5 base state rather than subroutine LAYHT. Changed file: mcip2/refstate.F - Removed GRIDCRO3D for hydrostatic runs. Changed files: mcip2/alloc_ctm.F mcip2/dealloc_ctm.F mcip2/gridout.F - Added optimization to extracting fields from input meteorology onto internal MCIP "X" arrays. Changed files: mcip2/getluse.F mcip2/metgrid2ctm.F mcip2/metvars2ctm.F - Several minor adjustments to RADM dry deposition and variable filling, including a provision to prevent negative dry deposition velocities from occurring in output. Changed files: mcip2/radmdry.F - Changed index order on arrays read from meteorology files to be Cartesian (X,Y,Z) with origin at surface and southwest corner rather than use MM5 convention (Y,X,Z) to make code more general. Changed namelist variables I0 and J0 to Y0 and X0, respectively. Changed files: mcip2/alloc_met.F mcip2/getluse.F mcip2/gridgeometry.F mcip2/metgrid2ctm.F mcip2/metinfo_mod.F mcip2/metvars2ctm.F mcip2/rdmm5v2.F mcip2/rdmm5v3.F mcip2/readnml.F mcip2/setgriddefs.F mcip2/setup_mm5v2.F mcip2/setup_mm5v3.F mcip2/run.mcip.F - Changed maximum number of meteorology input files from 5 to 100. Changed files: mcip2/file_mod.F mcip2/readnmlF mcip2/run.mcip - Updated double-precision declarations to F90 standard. Changed files: mcip2/const_mod.F mcip2/coord_mod.F - Consolidated extracting state variables from input meteorology onto internal MCIP "X" grid. Changed file: mcip2/metvars2ctm.F Deleted file: mcip2/met3dsup.F - Removed option to use interpolation with rational functions for layer collapsing. Changed files: mcip2/collapx.F mcip2/gridout.F mcip2/metcro.F mcip2/metdot.F Deleted file: mcip2/ratint.F - Made minor correction to calculation of theta-v-star. Changed files: mcip2/pblsup.F - Added option to use 10-m wind components if they are available from input meteorology file to fill output fields for 10-m wind speed and 10-m wind direction. Changed files: mcip2/alloc_met.F mcip2/alloc_x.F mcip2/dealloc_met.F mcip2/dealloc_x.F mcip2/init_met.F mcip2/init_x.F mcip2/metinfo_mod.F mcip2/metvar2ctm.F mcip2/pblsup.F mcip2/rdmm5v3.F mcip2/setup_mm5v2.F mcip2/setup_mm5v3.F - Changed variable names to avoid confusion with F90 intrinsic functions. Changed files: mcip2/date_pack_mod.F mcip2/gridout.F mcip2/metcro.F mcip2/metdot.F mcip2/metvars2ctm.F mcip2/rdmm5v2.F mcip2/rdmm5v3.F mcip2/setup_mm5v2.F mcip2/setup_mm5v3.F mcip2/statflds.F - Removed option to interpolate input meteorology fields to finer horizontal grid spacing (in favor of adding code efficiencies). Modified output file names in environment variables by removing "_G1" to reflect this change. Changed files: mcip2/file_mod.F mcip2/getluse.F mcip2/gridout.F mcip2/mcipparm_mod.F mcip2/metcro.F mcip2/metdot.F mcip2/metgrid2ctm.F mcip2/metvars2ctm.F mcip2/readnml.F mcip2/setgriddefs.F mcip2/run.mcip Deleted files: mcip2/bilin2d.F mcip2/bilin3d.F - Removed several unused variables. Changed files: mcip2/alloc_met.F mcip2/alloc_x.F mcip2/dealloc_met.F mcip2/dealloc_x.F mcip2/file_mod.F mcip2/init_met.F mcip2/init_x.F mcip2/mcipparm_mod.F mcip2/metinfo_mod.F mcip2/metvars2ctm.F mcip2/metvars_mod.F mcip2/rdmm5v2.F mcip2/rdmm5v3.F mcip2/readnml.F mcip2/refstate.F mcip2/resistcalc.F mcip2/setgriddefs.F mcip2/sfcflux.F mcip2/slflux.F mcip2/xvars_mod.F - Updated compiler options for IBM and PGF90. Added compiler options for Intel. Removed compiler options for SGI and Sun. Changed file: mcip2/Makefile - Created list of frequently asked questions for user self-help. New file: doc/FAQ - Updated version stamp. Changed files: mcip2/vstamp.F -------------------------------------------------------------------------------- MCIP Version 2.3 (18 August 2004) - Added processing of hydrometeor field, graupel. Changed files: mcip2/alloc_ctm.F mcip2/alloc_met.F mcip2/alloc_x.F mcip2/dealloc_ctm.F mcip2/dealloc_met.F mcip2/dealloc_x.F mcip2/init_met.F mcip2/init_x.F mcip2/mcoutcom_mod.F mcip2/metcro.F mcip2/metvars_mod.F mcip2/metvars2ctm.F mcip2/null_x.F mcip2/rdmm5v2.F mcip2/rdmm5v3.F mcip2/xvars_mod.F - Added work-around to account for NCAR bug in processing vegetation fraction for the Pleim-Xiu land-surface model. The bug was introduced in MM5 in MM5v3.5 and was corrected in MM5v3.6.2. Changed files: mcip2/alloc_met.F mcip2/dealloc_met.F mcip2/init_met.F mcip2/m3dry.F mcip2/metvars_mod.F mcip2/rdmm5v3.F - Corrected minor formatting bugs in GRIDDESC output file. Changed files: mcip2/wrgdesc.F - Added provision to set minimum PBL heights when Mellor-Yamada (Eta) PBL scheme is used in MM5. Changed files: mcip2/pblsup.F - Restored GRIDBDY2D file to output. Changed files: mcip2/alloc_ctm.F mcip2/dealloc_ctm.F mcip2/file_mod.F mcip2/gridout.F mcip2/groutcom_mod.F mcip2/run.mcip - Added initialization of I/O API. Changed files: mcip2/mcip.F mcip2/Makefile New files: mcip2/init_io.F - Restored full Jacobian (JACOBF and JACOBS) to output. Changed files: mcip2/alloc_ctm.F mcip2/dealloc_ctm.F mcip2/mcoutcom_mod.F mcip2/metcro.F - Added flag to create static output (GRID) files. Changed files: mcip2/file_mod.F mcip2/mcip.F mcip2/readnml.F mcip2/run.mcip - Modified error-checking for restart files to ensure that there is no physical discontinuity. Changed files: mcip2/rdmm5v3.F - Added Henry's Law constants for new species to be consistent with latest version in CMAQ. Changed files: mcip2/hlconst.F - Refined error-checking that prevents users from defining thinner top and/or bottom layers than available in MM5 output. Changed files: mcip2/statflds.F - Removed bookkeeping XFLAGS and associated variables XNAMES and XINDEX including pointers to XINDEX. Changed files: mcip2/alloc_x.F mcip2/bcldprc_ak.F mcip2/dealloc_x.F mcip2/getluse.F mcip2/init_x.F mcip2/m3dry.F mcip2/mcipparm_mod.F mcip2/met3dsup.F mcip2/metgrid2ctm.F mcip2/metvars2ctm.F mcip2/pblpkg.F mcip2/pblsup.F mcip2/radmdry.F mcip2/refstate.F mcip2/resistcalc.F mcip2/solar.F mcip2/xvars_mod.F Deleted files: mcip2/null_x.F - Eliminated type mismatches flagged by compiler in debug mode by adding interface block for obscure, unused routine. Changed files: mcip2/collapx.F - Eliminated support for NT version of MCIP. Deleted files: mcip2/Makefile.nt mcip2/run_mcip.bat - Updated modules that support I/O API. Changed files: mcip2/iodecl3_mod.F mcip2/parms3_mod.F - Changed local array allocation to occur only on initial call to subroutine to avoid memory fragmentation. Changed files: mcip2/bcldprc_ak.F mcip2/getpblht.F mcip2/gridout.F mcip2/met3dsup.F mcip2/metcro.F mcip2/metdot.F mcip2/pblpkg.F mcip2/pblsup.F mcip2/radmdry.F mcip2/rdmm5v2.F mcip2/rdmm5v3.F mcip2/verthyd.F - Corrected header settings for polar stereographic and Mercator projections. Changed files: mcip2/rdmm5v2.F mcip2/rdmm5v3.F mcip2/setgriddefs.F mcip2/setupv2.F mcip2/setupv3.F - Modified code so that arrays are made available in output only if user options in MM5 generate those data, e.g., hydrometeor species and variables from the Pleim-Xiu land-surface model. Changed files: mcip2/alloc_ctm.F mcip2/dealloc_ctm.F mcip2/mcipparm_mod.F mcip2/mcoutcom_mod.F mcip2/metcro.F mcip2/setgriddefs.F mcip2/setupv2.F mcip2/setupv3.F - Limited calculation of wind speed for initial time (in MM5 file) to the cross-point domain. Changed files: mcip2/pblsup.F - Added provision to define PBL height if bulk Richardson number suggests it should be the lowest model layer. Changed files: mcip2/getpblht.F - Modified code to handle MM5's IFSNOW=2 option which creates WEASD instead of SNOWCOVR. Changed files: mcip2/metinfo_mod.F mcip2/rdmm5v3.F mcip2/setupv2.F mcip2/setupv3.F - Clean up unused variables. Changed files: mcip2/metinfo_mod.F mcip2/pblsup.F mcip2/setupv2.F mcip2/setupv3.F mcip2/sfclayer.F - Added 10-m wind speed and direction to output. Changed XWIND10 to XWSPD10. Changed files: mcip2/Makefile mcip2/alloc_ctm.F mcip2/alloc_x.F mcip2/dealloc_ctm.F mcip2/dealloc_x.F mcip2/init_x.F mcip2/m3dry.F mcip2/mcoutcom_mod.F mcip2/metcro.F mcip2/metinfo_mod.F mcip2/pblpkg.F mcip2/pblsup.F mcip2/setupv2.F mcip2/setupv3.F mcip2/xvars_mod.F New files: mcip2/wind.F - Added explicit calculation of dot-point latitude, longitude, and map-scale factors based on grid geometry. Changed files: mcip2/metinfo_mod.F mcip2/rdmm5v2.F mcip2/rdmm5v3.F mcip2/setupv2.F mcip2/setupv3.F New files: mcip2/gridgeometry.F - Added 2-m temperature (TEMP2) to be passed through from MM5, if it is available there. Changed files: mcip2/alloc_ctm.F mcip2/alloc_met.F mcip2/alloc_x.F mcip2/dealloc_ctm.F mcip2/dealloc_met.F mcip2/dealloc_x.F mcip2/init_met.F mcip2/init_x.F mcip2/mcipparm_mod.F mcip2/mcoutcom_mod.F mcip2/metcro.F mcip2/metinfo_mod.F mcip2/metvars_mod.F mcip2/metvars2ctm.F mcip2/rdmm5v3.F mcip2/setgriddefs.F mcip2/setupv2.F mcip2/setupv3.F mcip2/xvars_mod.F - Added leaf-area index from the Pleim-Xiu LSM to output. Changed files: mcip2/alloc_ctm.F mcip2/dealloc_ctm.F mcip2/mcoutcom_mod.F mcip2/metcro.F - Removed obsolete land-use input options. Changed files: mcip2/alloc_x.F mcip2/dealloc_x.F mcip2/getluse.F mcip2/lradmdat_mod.F mcip2/mcipparm_mod.F mcip2/readnml.F mcip2/setgriddefs.F mcip2/xvars_mod.F Deleted files: mcip2/lutrans1.F mcip2/lutrans2.F mcip2/lutrans3.F mcip2/lutrans4.F mcip2/lutrans5.F mcip2/lutrans6.F - Updated version stamp. Changed files: mcip2/vstamp.F -------------------------------------------------------------------------------- MCIP Version 2.2 (11 June 2003) - Improved dry deposition algorithms, particularly for winter cases. In M3DRY, added explicit resistance to snow and ice with dependence on temperature; modified cuticle resistance for NH3 as function of relative humidity; and added wet ground similarly to wet canopy. Changed files: mcip2/m3dry.F mcip2/radmdry.F mcip2/Makefile mcip2/Makefile.nt New file: mcip2/hlconst.F - Added three new dry deposition species: N2O5, NO3, and generic aldehyde. Changed files: mcip2/alloc_x.F mcip2/init_x.F mcip2/m3dry.F mcip2/mcipparm_mod.F mcip2/null_x.F mcip2/radmdry.F mcip2/xvars_mod.F - Added snow cover field to input and output to support winter dry deposition algorithms. Changed files: mcip2/alloc_ctm.F mcip2/alloc_met.F mcip2/alloc_x.F mcip2/dealloc_ctm.F mcip2/dealloc_met.F mcip2/dealloc_x.F mcip2/init_met.F mcip2/init_x.F mcip2/mcoutcom_mod.F mcip2/metcro.F mcip2/metvars_mod.F mcip2/metvars2ctm.F mcip2/null_x.F mcip2/rdmm5v2.F mcip2/rdmm5v3.F mcip2/xvars_mod.F - Changed definition of F2 (for resistance calculations) to be based on land use category to improve resistance calculations for M3DRY when Pleim-Xiu land-surface model is not run. Changed files: mcip2/alloc_x.F mcip2/dealloc_x.F mcip2/init_x.F mcip2/metinfo_mod.F mcip2/metvars2ctm.F mcip2/null_x.F mcip2/rdmm5v2.F mcip2/rdmm5v3.F mcip2/resistcalc.F mcip2/xvars_mod.F - Corrected algorithm to calculate W in the PSRATE calculation for hydrostatic vertical velocity. Changed files: mcip2/verthyd.F - Commented out the need for PBL variables on input if they are set to be rediagnosed (for compatibility with MM5v2.6 and prior releases. Changed files: mcip2/rdmm5v2.F - Restricted output vertical structure so that layer collapsing is not used to create a thinner lowest or top layer than input meteorology. Changed files: mcip2/statflds.F - Removed GRIDBDY2D, GRIDBDY3D, and METBDY2D from output. Removed dry deposition species, ATRA and ATRAP, from output. Removed several other extraneous variables from output. Changed files: mcip2/alloc_ctm.F mcip2/alloc_x.F mcip2/dealloc_ctm.F mcip2/file_mod.F mcip2/gridout.F mcip2/groutcom_mod.F mcip2/init_x.F mcip2/m3dry.F mcip2/mcipparm_mod.F mcip2/mcoutcom_mod.F mcip2/metcro.F mcip2/null_x.F mcip2/radmdry.F mcip2/run.mcip mcip2/run_mcip.bat mcip2/xvars_mod.F - Clarified instructions on setting BTRIM, I0, and J0 in script. Removed links to GRIDBDY2D, GRIDBDY3D, and METBDY2D. Changed files: mcip2/run.mcip mcip2/run_mcip.bat - Updated version stamp. Changed files: mcip2/vstamp.F -------------------------------------------------------------------------------- MCIP Version 2.1 (27 March 2003) - Added calculation of mid-layer density using virtual temperature. Changed files: mcip2/met3dsup.F - Corrected bugs in calculations of UHAT_S and VHAT_T: added calls to COLLAPX for XUHAT and XVHAT, and fixed algorithm to translate from dot points to square and triangle points (Arakawa B grid to Arakawa C grid). Also changed COLLAPX calls for UHAT_S and VHAT_T to be on winds coupled with density and Jacobian for better mass conservation. Changed files: mcip2/metdot.F - Corrected calculation of WGHT_TOP and WGHT_BOT that is used to get WHAT_JD_C and WHAT_JD_B on full levels. Removed extraneous calculation of X3MIDL. Changed calls to COLLAPX to be on Jacobian coupled with density instead of just Jacobian for better mass conservation. Changed subsequent calculations of output variables based on Jacobian. Changed files: mcip2/metcro.F - Corrected calculation of weights used for vertical interpolation to full levels. Corrected algorithm to calculate XWHAT from XUHAT and XVHAT. Changed files: mcip2/vertnhy.F - Modified definitions of XORIG_GD and YORIG_GD to minimize real number round-off issues which can cause header mismatches in CMAQ. Added double precision attributes to variables assigned to I/O API header. Changed files: mcip2/setgriddefs.F - Removed unused variable JDRATE from code and from METCRO3D. Changed files: mcip2/alloc_ctm.F mcip2/alloc_x.F mcip2/dealloc_ctm.F mcip2/dealloc_x.F mcip2/init_x.F mcip2/mcoutcom_mod.F mcip2/metcro.F mcip2/null_x.F mcip2/verthyd.F mcip2/xvars_mod.F - Simplified algorithm to map input meteorology to MCIP_X domain. Changed files: mcip2/lutrans3.F mcip2/metgrid2ctm.F mcip2/metvars2ctm.F - Expanded MCIP_X domain dot-point arrays to (NCOLS_X+1, NROWS_X+1). Changed supporting code to reflect new dimensions. Changed files: mcip2/alloc_x.F mcip2/met3dsup.F mcip2/metdot.F mcip2/metgrid2ctm.F mcip2/metvars2ctm.F mcip2/pblpkg.F mcip2/pblsup.F mcip2/vertnhy.F - Constrained calculation of non-PBL parameters with user option LRAD in the PBL rediagnosis routine. Changed files: mcip2/pblpkg.F - Updated version stamp. Changed files: mcip2/vstamp.F -------------------------------------------------------------------------------- MCIP Version 2.0 (19 March 2002) - Added temperature dependence to Henry's Law constants in Models-3 dry deposition scheme. Added temperature and pressure dependence to diffusivity in Models-3 dry deposition scheme. Changed the reference wet cuticle resistance. Changed files: BLD/m3dry.F - Added dry deposition velocity for new species, methanol. Changed files: BLD/alloc_x.F BLD/init_x.F BLD/m3dry.F BLD/mcipparm_mod.F BLD/null_x.F BLD/radmdry.F BLD/xvars_mod.F - Corrected error in translation between input domain and MCIP "X" domain. (Error from MCIP Version 1.) This routine was over-looked in correction of this bug in second beta release. Changed files: BLD/lutrans3.F - Made minor changes to improve portability of code including re-ordering variable declarations and changing file access from Fortran unit numbers to explicit file names. Changed files: run.mcip BLD/bilin2d.F BLD/bilin3d.F BLD/file_mod.F BLD/getgist.F BLD/metgrid2ctm.F BLD/metvars2ctm.F BLD/rdmm5v2.F BLD/rdmm5v3.F BLD/readnml.F BLD/setupmm5.F BLD/wrgdesc.F - Added missing explicit variable declarations. Changed files: BLD/resistcalc.F - Allow MM5v2 output from 2000 and beyond to show up correctly in date/time stamps. Changed files: BLD/mdate2hdate.F - Replaced error-exit calls to "abort" and "stop" statments with calls to "m3exit" for graceful shut-down of I/O API files. Moved SDATE and STIME to new module DATE_TIME. Changed files: BLD/Makefile BLD/close_files.F BLD/collapx.F BLD/crs2dot.F BLD/dynflds.F BLD/getgist.F BLD/getversion.F BLD/getluse.F BLD/gridout.F BLD/layht.F BLD/lutrans1.F BLD/lutrans3.F BLD/lutrans5.F BLD/lutrans6.F BLD/mcip.F BLD/met3dsup.F BLD/metcro.F BLD/metdot.F BLD/metvars2ctm.F BLD/pblpkg.F BLD/rdmm5.F BLD/rdmm5v2.F BLD/rdmm5v3.F BLD/readnml.F BLD/setgriddefs.F BLD/setupmm5.F BLD/setupv2.F BLD/setupv3.F BLD/sfcflux.F New files: BLD/date_time_mod.F BLD/graceful_stop.F Deleted file: BLD/errmsg.F - Changed logic to define water points using dominant land use category. Changed files: BLD/m3dry.F BLD/resistcalc.F - Created script and Makefile for Windows NT. New files: run_mcip.bat BLD/Makefile.nt - Corrected calculation of PSIM variable. Changed files: BLD/sfclayer.F - Added basic compiler options for Sun, IBM, Linux, and SGI to Makefile. Changed files: BLD/Makefile - Generalized the end-of-namelist delimiter in the script. Changed files: run.mcip - Changed the creation of the GRIDDESC file from a list-directed write to a formatted write to improve portability. Changed files: BLD/wrgdesc.F - Adjusted minimum PBL height to be height of lowest mid-layer rather than height of lowest full layer for PBL pass-through option. Changed files: BLD/getpblht.F - Changed initialization of X-variables from 0.0 to BADVAL3 (a large negative number) and changed missing output variables to BADVAL3 to avoid confusion. Changed files: BLD/gridout.F BLD/init_x.F BLD/m3dry.F BLD/metcro.F BLD/metdot.F BLD/metvars2ctm.F BLD/pblsup.F BLD/radmdry.F BLD/resistcalc.F BLD/setupv2.F BLD/setupv3.F - Removed RIB from output. Changed files: BLD/alloc_ctm.F BLD/dealloc_ctm.F BLD/mcoutcom_mod.F BLD/metcro.F - Corrected text definition of RSTOMI and SURF2 in MC2VDESC. Corrected units of SURF2 in MC2UNITS. Changed QICE and QSNOW to QI and QS to be consistent with CCTM. Changed files: BLD/mcoutcom_mod.F - Renamed SURF2 as WIND10, and SURF1 as TEMP1P5. Changed files: BLD/alloc_ctm.F BLD/alloc_x.F BLD/dealloc_ctm.F BLD/dealloc_x.F BLD/init_x.F BLD/mcoutcom_mod.F BLD/metcro.F BLD/null_x.F BLD/pblpkg.F BLD/pblsup.F BLD/xvars_mod.F - Changed PBL-rediagnosis routine to use constants that are common to the rest of the code. In some cases, definitions of constants were either made more precise or changed outright to be consistent with other PBL rediagnosis routines. This affects TEMP10, TEMP1P5, and WIND10 in the PBL rediagnosis options only. Changed files: BLD/pblpwr.F - Corrected bug that persisted cloud base arrays when clouds had dissipated. Changed files: BLD/bcldprc_ak.F - Replace GOTO/CONTINUE section of code with DO loop. Changed files: BLD/sfcflux.F - Removed minimum size for windows. Changed files: run.mcip BLD/readnml.F BLD/setgriddefs.F - Added updates to XFLAGS for variables filled in METVARS2CTM. Changed files: BLD/metvars2ctm.F - Corrected upper bound for DO loop. Changed files: BLD/locate.F - Changed file names for Fortran 90 modules from "module_routine_name.F" to "routine_name_mod.F". Changed files: BLD/Makefile (and physical names of all f90 modules) - Updated disclaimer. Changed files: BLD/*.F - Updated version stamp. Changed files: BLD/vstamp.F -------------------------------------------------------------------------------- MCIP Version 2, Beta Release 3 (20 November 2001) - Corrected setting of XORIG_GD and YORIG_GD which was inadvertently changed in beta release 2. Changed files: BLD/setgriddefs.F - Allow use of MCIP in the absence of input cloud and rain mixing ratios, e.g., from MM5 "warm rain" scheme. Changed files: BLD/rdmm5v2.F BLD/rdmm5v3.F - Added time stamp for all input time periods read in MM5v2 file. Changed files: BLD/rdmm5v2.F - Removed "sanity" checks. Changed files: Makefile BLD/gridout.F BLD/metcro.F BLD/metdot.F Deleted files: BLD/sanity.F - Updated version stamp. Changed files: BLD/vstamp.F -------------------------------------------------------------------------------- MCIP Version 2, Beta Release 2 (18 October 2001) - Corrected calculation of RNET in non-P-X applications to include emissivity. (Note that GLW represents a different quantity for "pass-through" and P-X versions than for recalculation. Variables RNET and GLW are not used in any downstream processor.) Changed files: BLD/metvars2ctm.F - Added ASCII output file GRIDDESC to contain grid description information. Added new variable COORDNAM to describe coordinate system used in GRIDDESC. GRIDDESC will be used by SMOKE and other programs within CMAQ system. Changed files: run.mcip BLD/Makefile BLD/mcip.F BLD/module_coord.F BLD/module_file.F BLD/module_mcipparm.F BLD/readnml.F BLD/setgriddefs.F New files: BLD/wrgdesc.F - Corrected setting of P_GAM_GD for Lambert conformal maps. Also set P_ALP_GD, P_BET_GD, and P_GAM_GD based on map projection. Changed files: BLD/setgriddefs.F BLD/setupv2.F BLD/setupv3.F - Added capability to process 24-category land use in MM5v2 files. Changed files: BLD/rdmm5v2.F - Corrected precipitation calculation in first hour of second, third, etc., MM5 input files. Added logic to use multiple output files when MM5 option for splitting output is used in MM5v3. Added error-checking on header variables for multiple input MM5 files. Changed files: BLD/rdmm5v2.F BLD/rdmm5v3.F - Added windowing capability for the MCIP output sub-domain. Corrected definition of grid dimensions based on BTRIM, I0, and J0. Corrected print statement regarding end location of window. Changed files: run.mcip BLD/readnml.F BLD/setgriddefs.F - Corrected restriction on variables in MET_CRO_3D related to epsilon. Added the same restriction to MET_BDY_3D. Changed files: BLD/metcro.F - Corrected error in translation between input domain and MCIP "X" domain. (Error from MCIP Version 1.) Changed files: BLD/metgrid2ctm.F BLD/metvars2ctm.F - Updated version stamp. Changed files: BLD/vstamp.F -------------------------------------------------------------------------------- MCIP Version 2, Beta Release (21 September 2001) MCIP Version 2 contains the following new features: - Entirely re-engineered to be dynamically allocatable. That is, grid specifications and user options are run-time input rather than compile-time input. A single MCIP executable can be used for any input MM5 files without re-compiling. Run-time options are communicated via a Fortran namelist that is set from the run script. - Supports both MM5 Version 2 and MM5 Version 3 formatted files. The user does not need to specify the format type. - Includes "pass-through" options for PBL and radiation variables. - Processes output fields from the Pleim-Xiu land-surface model in MM5. - New option for Models-3 (Pleim) dry deposition routine. - New 3-D output fields for ice and snow mixing ratios. - New dry deposition velocity fields for atrazine (ATRA) and atrazine product (ATRAP). - New 2-D output fields for soil moisture, soil temperature, and soil texture when Pleim-Xiu land-surface model is run. - Ability to use multiple (e.g., restart) MM5 input files on the same execution of MCIP. - Ability to process MCIP at coarser granularity than input MM5. For example, MCIP can generate hourly output if MM5 input is every 30 minutes or 15 minutes. - MCIP calculations only occur for time period selected. (Input files must be read to find correct start time, but processing through MCIP only occurs on times of interest.) - Ability to print input and output variables in a user-defined cell. - Significant clean-up and re-organization of the code has also occurred. Because of the extent of the revisions to MCIP, some of the features in the current release of MCIP were omitted from MCIP Version 2. Some of these features will be added at a later time if demand warrants it. Some of the features in the current release of MCIP that are NOT supported in MCIP Version 2 at this time include: - Windowing of sub-domains. (Code is still in place, but has not been formally tested.) This capability will be available in the next release of the CCTM. {NOTE: Windowing was added back into MCIP in Beta Release 2.} - Input meteorology from existing MCIP files. - Creating MCIP output at finer horizontal grid spacing than input. - Use of common ".EXT" include files consistent with other CMAQ programs. - Use of "cfg" file, "m3bld", and "bldit" script to compile MCIP. - Extensive use of environment variables to set user definitions.