CHANGES for MCIP -------------------------------------------------------------------------------- MCIP Version 4.2 (23 August 2013) - Increased maximum number of input files for MCIP in order to handle one year of daily output files at a time. Changed files: mcip4/files_mod.f90 mcip4/run.mcip - Added option to process convective and non-convective precipitation if it is already incremental from WRF. Changed files: mcip4/metinfo_mod.f90 mcip4/rdwrfem.f90 mcip4/setup_mm5v3.f90 mcip4/setup_wrfem.f90 - Added handling for 40-category 2006 NLCD-MODIS land use classification as "NLCD40". Added alternate name for 50-category 2001 NLCD-MODIS land use classification as "NLCD50". Changed files: mcip4/getluse.f90 mcip4/luvars_mod.f90 mcip4/metvars2ctm.f90 mcip4/rdwrfem.f90 mcip4/resistcalc.f90 mcip4/setup_wrfem.f90 - Read land-water mask from WRF and use directly for WRF runs that used the Pleim-Xiu land-surface model (rather than reconstructing inside MCIP). For other LSMs in WRF, the land-water mask is dynamic and ice points toggle from water to land. Changed files: mcip4/alloc_met.f90 mcip4/dealloc_met.f90 mcip4/getluse.f90 mcip4/init_met.f90 mcip4/metvars_mod.f90 mcip4/rdwrfem.f90 - Updated metadata for new physics options in WRFv3.4.1 and WRFv3.5. Changed files: mcip4/wrfemopts.f90 - Updated version stamp. Changed files: mcip4/mcipparm_mod.f90 -------------------------------------------------------------------------------- MCIP Version 4.1 (11 May 2012) - Updated code and made minor corrections to handle spectral nudging runs from WRF. Changed files: mcip4/blddesc.f90 mcip4/metinfo_mod.f90 mcip4/setup_wrfem.f90 - Force 2-m water vapor mixing ratio from WRF with YSU PBL to be filled with layer 1 QVAPOR to avoid occasional Q2 < 0 in wintertime. Changed files: mcip4/setup_wrfem.f90 - Corrected error in tipping bucket precipitation calculation. Changed files: mcip4/rdwrfem.f90 - Added provision for calculating Monin-Obukhov length when the sensible heat flux is 0. Changed files: mcip4/pblsup.f90 - Updated metadata for new physics options in WRFv3.4. Changed files: mcip4/wrfemopts.f90 - Corrected alphabetization of files in Makefile. Changed files: mcip4/Makefile - Updated release stamp. Changed files: mcip4/mcipparm_mod.f90 -------------------------------------------------------------------------------- MCIP Version 4.0 (9 September 2011) - Removed option to compute dry deposition velocities in MCIP. Option is now exclusively available in CMAQ's CCTM. Changed files: mcip4/Makefile mcip4/dynflds.f90 mcip4/mcip.f90 mcip4/mcipparm_mod.f90 mcip4/metcro.f90 mcip4/readnml.f90 mcip4/run.mcip mcip4/setgriddefs.f90 Removed files: mcip4/alloc_depv.f90 mcip4/dealloc_depv.f90 mcip4/depvvars_mod.f90 mcip4/hlconst.f90 mcip4/init_depv.f90 mcip4/m3dry.f90 - Corrected error in calculating dot point map-scale factors for polar stereographic projections when true latitude is not at the pole. Changed files: mcip4/mapfac_ps.f90 - Changed calculation of dot-point and face-point latitude and longitude for polar stereographic projection to interpolation to eliminate the error in the calculation. The approximation from interpolation is adequate for CMAQ. Changed files: mcip4/rdmm5v3.f90 mcip4/rdwrfem.f90 Removed file: mcip4/xy2ll_ps.f90 - Improved support for long MCIP runs from long WRF runs. Changed files: mcip4/rdwrfem.f90 mcip4/setup_wrfem.f90 - Corrected error in propagating canopy wetness from WRF runs to MCIP output where scaling was over air density rather than water density. Changed files: mcip4/metvars2ctm.f90 - Added sea ice to METCRO2D. Corrected land/water mask so that ice cells are considered water. Changed files: mcip4/alloc_ctm.f90 mcip4/alloc_met.f90 mcip4/alloc_x.f90 mcip4/dealloc_ctm.f90 mcip4/dealloc_met.f90 mcip4/dealloc_x.f90 mcip4/getluse.f90 mcip4/init_met.f90 mcip4/init_x.f90 mcip4/mcipparm_mod.f90 mcip4/mcoutcom_mod.f90 mcip4/metcro.f90 mcip4/metvars_mod.f90 mcip4/metvars2ctm.f90 mcip4/rdmm5v3.f90 mcip4/rdwrfem.f90 mcip4/xvars_mod.f90 - Added option for precipitation tipping bucket to be used in WRF and processed correctly by MCIP. Changed files: mcip4/alloc_met.f90 mcip4/dealloc_met.f90 mcip4/init_met.f90 mcip4/metinfo_mod.f90 mcip4/metvars_mod.f90 mcip4/rdwrfem.f90 mcip4/setup_mm5v3.f90 mcip4/setup_wrfem.f90 - Changed values of output convective precipitation array to negative (i.e., non-physical) values if a cumulus parameterization scheme was not used in the meteorological model. Works with a change to the sub-grid cloud scheme in CMAQv5.0. Changed files: mcip4/metvars2ctm.f90 - Changed format of print statements to take Intel compiler's recommendations and eliminate warning messages. Changed files: mcip4/blddesc.f90 mcip4/statflds.f90 - Updated metadata with options from WRFv3.2 and WRFv3.3. Added shallow convection option to metadata. Changed files: mcip4/blddesc.f90 mcip4/metinfo_mod.f90 mcip4/mm5v3opts.f90 mcip4/setup_mm5v3.f90 mcip4/setup_wrfem.f90 mcip4/wrfemopts.f90 - Corrected variable type mismatch between double-precision and single-precision real. Changed files: mcip4/ll2xy_lam.f90 mcip4/ll2xy_lam_tan.f90 - Replaced Fortran 90 modules parms3_mod.f90, fdesc3_mod.f90, and iodecl3_mod.f90 and dependencies on PARMS3.EXT, FDESC3.EXT, and IODECL3.EXT with I/O API module M3UTILIO. Also removed I/O API internal parameter checking call to I/O API routine IOPARMS3 in init_io.f90. ** MCIP now has a dependency on I/O API v3.1 or higher. Removed files: mcip4/fdesc3_mod.f90 mcip4/iodecl3_mod.f90 mcip4/parms3_mod.f90 Changed files: mcip4/alloc_ctm.f90 mcip4/close_files.f90 mcip4/comheader.f90 mcip4/gridout.f90 mcip4/init_io.f90 mcip4/init_x.f90 mcip4/mcipparm_mod.f90 mcip4/metcro.f90 mcip4/metdot.f90 mcip4/metvars2ctm.f90 mcip4/pblsup.f90 mcip4/resistcalc.f90 mcip4/sat2mcip_mod.f90 mcip4/setgriddefs.f90 mcip4/setup_mm5v3.f90 mcip4/setup_wrfem.f90 mcip4/Makefile - Changed name of module FILE to FILES to avoid conflict with F90 protected intrinsic. Removed file: mcip4/file_mod.f90 New file: mcip4/files_mod.f90 Changed files: mcip4/chkwpshdr.f90 mcip4/chkwrfhdr.f90 mcip4/getgist.f90 mcip4/getversion.f90 mcip4/gridout.f90 mcip4/mcip.f90 mcip4/metcro.f90 mcip4/metdot.f90 mcip4/rdmm5v3.f90 mcip4/rdwrfem.f90 mcip4/readnml.f90 mcip4/readter.f90 mcip4/setup.f90 mcip4/setup_mm5v3.f90 mcip4/setup_wrfem.f90 mcip4/wrgdesc.f90 mcip4/Makefile - Updated netCDF commands from F77 to F90, and improved error handling. Changed files: mcip4/chkwpshdr.f90 mcip4/chkwrfhdr.f90 mcip4/rdwrfem.f90 mcip4/sat2mcip_mod.f90 mcip4/setgriddefs.f90 mcip4/setup.f90 mcip4/setup_wrfem.f90 mcip4/wrf_netcdf_mod.f90 - Improved error handling by removing GOTO statements. Changed files: mcip4/collapx.f90 mcip4/getgist.f90 mcip4/getluse.f90 mcip4/getmet.f90 mcip4/getversion.f90 mcip4/gridout.f90 mcip4/layht.f90 mcip4/ll2xy_lam.f90 mcip4/metcro.f90 mcip4/metdot.f90 mcip4/metvars2ctm.f90 mcip4/rdmm5v3.f90 mcip4/readnml.f90 mcip4/readter.f90 mcip4/resistcalc.f90 mcip4/setup_mm5v3.f90 mcip4/statflds.f90 - Consolidated land use definitions and removed unnecessary routines. Removed files: mcip4/alloc_lu.f90 mcip4/dealloc_lu.f90 mcip4/init_lu.f90 Changed files: mcip4/luvars_mod.f90 mcip4/mcip.f90 mcip4/Makefile - Changed arguments for subroutine GETH_IDTS in module DATE_PACK so that the character strings are explicitly 19-characters long. Changed files: mcip4/date_pack_mod.f90 mcip4/rdmm5v3.f90 mcip4/rdwrfem.f90 mcip4/sat2mcip_mod.f90 mcip4/setup_wrfem.f90 - Changed TOL on comparing data sets for MM5. Changed files: mcip4/setup_mm5v3.f90 - Updated F77 constructs to F90, and replaced DATA statement declarations with PARAMETER statements. - Changed directory names from MCIP3 to MCIP4 and mcip3 to mcip4 to minimize confusion. - Updated disclaimer at top of codes. - Updated release stamp. Changed files: mcip4/mcipparm_mod.f90 -------------------------------------------------------------------------------- MCIP Version 3.5 beta (29 Oct 2009) and Version 3.6 (19 Mar 2010) - Added user option to define reference latitude for WRF domains with Lambert conformal projection. This option uses a new namelist variable, and this option is particularly useful when trying to match a WRF domain to an existing MM5 domain (to compare WRF vs. MM5 or to "recycle" emissions surrogates). Changed files: mcip3/mcipparm_mod.f90 mcip3/readnml.f90 mcip3/setgriddefs.f90 mcip3/run.mcip - Corrected calculation of I/O API header variables for WRF polar stereographic projection. Changed files: mcip3/ll2xy_ps.f90 mcip3/setgriddefs.f90 - Corrected error in computing wind direction when U-component wind is effectively zero. Changed file: mcip3/wind.f90 - Corrected error checking of surface-layer scheme for 2nd and subsequent WRF files. Changed files: mcip3/chkwrfhdr.f90 - Corrected error in mapping TKE to DUMARAY1 and vice versa in the layer collapsing prior to outputting cross-point 3-D fields. Changed files: mcip3/metcro.f90 - Added Modified IGBP MODIS NOAH and NLCD/MODIS as land-use classification options for WRF. Changed GRIDCRO2D to print land use category description (e.g., urban, deciduous forest) and classification source when fractional land use categories are available rather than "land use category N". New files: mcip3/alloc_lu.f90 mcip3/dealloc_lu.f90 mcip3/init_lu.f90 mcip3/luvars_mod.f90 Changed files: mcip3/alloc_x.f90 mcip3/dealloc_x.f90 mcip3/getluse.f90 mcip3/gridout.f90 mcip3/mcip.f90 mcip3/mcippparm_mod.f90 mcip3/metvars2ctm.f90 mcip3/resistcalc.f90 mcip3/rdwrfem.f90 mcip3/setup_wrfem.f90 mcip3/xvars_mod.f90 mcip3/Makefile - Updated code to support changes in WRFv3.1+. Changed files: mcip3/alloc_met.f90 mcip3/blddesc.f90 mcip3/getluse.f90 mcip3/metinfo_mod.f90 mcip3/rdwrfem.f90 mcip3/setgriddefs.f90 mcip3/setup_mm5v3.f90 mcip3/setup_wrfem.f90 mcip3/wrfemopts.f90 - Added urban model option to output metadata. Changed files: mcip3/blddesc.f90 mcip3/mm5v3opts.f90 mcip3/wrfemopts.f90 - Added condition that vegetation fraction must be greater than zero to be considered a land point in M3Dry. This works around intermittent inconsistencies in surface fields in some WRF data sets. Changed files: mcip3/m3dry.f90 - Added option to output 3D field of potential vorticity. New files: mcip3/pvs.f90 Changed files: mcip3/alloc_ctm.f90 mcip3/alloc_met.f90 mcip3/alloc_x.f90 mcip3/dealloc_ctm.f90 mcip3/dealloc_met.f90 mcip3/dealloc_x.f90 mcip3/dynflds.f90 mcip3/init_met.f90 mcip3/init_x.f90 mcip3/mcipparm_mod.f90 mcip3/mcoutcom_mod.f90 mcip3/metcro.f90 mcip3/metvars_mod.f90 mcip3/metvars2ctm.f90 mcip3/rdmm5v3.f90 mcip3/readnml.f90 mcip3/xvars_mod.f90 mcip3/Makefile mcip3/run.mcip - Added map-scale factors squared on cross points so the field does not need to be recalculated each MCIP time step. Changed files: mcip3/alloc_x.f90 mcip3/dealloc_x.f90 mcip3/gridout.f90 mcip3/init_x.f90 mcip3/metcro.f90 mcip3/metgrid2ctm.f90 mcip3/xvars_mod.f90 - Improved and generalized gridding routines to include additional flexibility for WRF domains. Corrected errors in defining dot-point latitudes and longitudes for WRF nests. Deleted file: mcip3/gridgeometry.f90 New files: mcip3/cori.f90 mcip3/ll2xy_merc.f90 mcip3/mapfac_lam.f90 mcip3/mapfac_merc.f90 mcip3/mapfac_ps.f90 mcip3/xy2ll_lam.f90 mcip3/xy2ll_merc.f90 mcip3/xy2ll_ps.f90 Changed files: mcip3/Makefile mcip3/ll2xy_lam_sec.f90 mcip3/ll2xy_ps.f90 mcip3/rdmm5v3.f90 mcip3/rdwrfem.f90 mcip3/setgriddefs.f90 mcip3/setup_mm5v3.f90 mcip3/setup_wrfem.f90 - Allow output variable PURB to be generated without fractional land use but with the urban model in WRF. Changed files: mcip3/alloc_ctm.f90 mcip3/alloc_x.f90 mcip3/gridout.f90 mcip3/init_x.f90 - Remove vertical velocity (predicted by the meteorological model; WWIND) from output by default; retain user option to output 3D field. Add user option to output u- and v-component winds (UWINDC and VWINDC) on C-staggered grid used by WRF and CMAQ. (Note: UWIND and VWIND, which are on the B-staggered grid used by MM5, are still available in METDOT3D by default.) Changed files: mcip3/alloc_ctm.f90 mcip3/dealloc_ctm.f90 mcip3/mcipparm_mod.f90 mcip3/mcoutcom_mod.f90 mcip3/mdoutcom_mod.f90 mcip3/metcro.f90 mcip3/metdot.f90 mcip3/readnml.f90 mcip3/setgriddefs.f90 mcip3/run.mcip - Allow output from WRF Preprocessing System (WPS) routine, GEOGRID, to provide fractional land use output if it is unavailable in WRF output (i.e., use file geogrid_d01 in addition to wrfout). New file: mcip3/chkwpshdr.f90 Changed files: mcip3/mcipparm_mod.f90 mcip3/rdwrfem.f90 mcip3/setgriddefs.f90 mcip3/setup_mm5v3.f90 mcip3/setup_wrfem.f90 mcip3/Makefile mcip3/run.mcip - Changed method for determining whether or not roughness length and fractional land use exist to avoid error condition with netCDF4. Changed files: mcip3/mcipparm_mod.f90 mcip3/rdwrfem.f90 mcip3/setup_wrfem.f90 - Corrected error in checking WRF observation nudging coefficient for temperature. Changed files: mcip3/chkwrfhdr.f90 - Changed representation of Mercator projection from MM5 and WRF in I/O API from "general Mercator" to "equatorial Mercator". Changed files: mcip3/setgriddefs.f90 mcip3/setup_mm5v3.f90 mcip3/setup_wrfem.f90 - Changed code to allow leaf area index to be filled when a land-surface model is not used in WRF. Changed file: mcip3/rdwrfem.f90 - Changed netCDF Fortran 90 calls to netCDF Fortran 77 calls in satellite routines to improve compatibility with netCDF4 and reduce compiler dependencies on the netCDF Fortran 90 interface. Changed file: mcip3/sat2mcip_mod.f90 - Changed some real number comparisons from "equivalences" to "less than tolerances". Changed files: mcip3/m3dry.f90 mcip3/metvars2ctm.f90 mcip3/pblsup.f90 mcip3/rdmm5v3.f90 mcip3/rdwrfem.f90 - Corrected typo in netCDF description of roughness length, ZRUF. Changed files: mcip3/mcoutcom_mod.f90 - Improved WRF file handling and streamlined netCDF reads from WRF files. Reduced number of times files were opened and closed in netCDF. Changed all netCDF routines to use Fortran interfaces. Changed files: mcip3/chkwpshdr.f90 mcip3/chkwrfhdr.f90 mcip3/rdwrfem.f90 mcip3/setup.f90 mcip3/setup_wrfem.f90 mcip3/wrf_netcdf_mod.f90 - Added metadata summary to MCIP log file. Changed files: mcip3/mcip.f90 - Added compiler options for gfortran. Changed files: mcip3/Makefile - Removed unused variables. Changed files: mcip3/chkwpshdr.f90 mcip3/chkwrfhdr.f90 mcip3/dynflds.f90 mcip3/getluse.f90 mcip3/getsdt.f90 mcip3/ll2xy_merc.f90 mcip3/mcip.f90 mcip3/pblsup.f90 mcip3/rdmm5v3.f90 mcip3/rdwrfem.f90 mcip3/readter.f90 mcip3/setgriddefs.f90 mcip3/setup_wrfem.f90 mcip3/sfclayer.f90 mcip3/wrf_netcdf_mod.f90 - Changed all Fortran routines from *.F to *.f90 to better conform to standard naming conventions. Changed files: mcip3/Makefile mcip3/*.f90 - Added compiler options for gfortran. Changed file: mcip3/Makefile - Changed directory names from MCIP2 to MCIP3 and mcip2 to mcip3 to minimize confusion. - Updated version stamp. Changed files: mcip3/mcipparm_mod.f90 -------------------------------------------------------------------------------- MCIP Version 3.4.1 (4 December 2008) - Changed setting for YCENT_GD (and, thus, XORIG_GD and YORIG_GD) for WRF for Lambert conformal projection so that the headers will not fail in the Spatial Allocator. Reference latitude is now set to the average of the true latitudes for the secant Lambert conformal case. (Still need to test settings for polar stereographic and Mercator for WRF.) Changed files: mcip2/ll2xy_lam.F mcip2/ll2xy_lam_sec.F mcip2/setgriddefs.F - Prevent users from having tangent Lambert conformal case until it can be tested with the Spatial Allocator. (Known problem is that the Spatial Allocator does not work properly when the reference latitude is equal to the first true latitude. Work-around is to set reference latitude to average of true latitudes for Lambert conformal. But average of true latitudes for tangent Lambert conformal case is the first true latitude, which will result in the same problem as solution used in MCIPv3.4.) Changed files: mcip2/ll2xy_lam.F - Updated version stamp. Changed files: mcip2/mcipparm_mod.F -------------------------------------------------------------------------------- MCIP Version 3.4 (3 November 2008) - Corrected the scaling parameter used to estimate the friction velocity over water in surface waters (variable "D3"). Added an exception for elemental mercury deposition to wet soil surfaces as most measurements show evasion from recently wet soil surfaces. Also added trap for undefined dry deposition velocities (e.g., NaN). Changed files: mcip2/m3dry.F - Added dry deposition velocities for five air toxic species. Changed files: mcip2/hlconst.F mcip2/init_depv.F mcip2/m3dry.F mcip2/mcipparm_mod.F - Added sample print statements to log file for percentage of urban area and fractional land use when those fields are available. Changed files: mcip2/gridout.F - Changed code to use values for gravitational constant and dry gas constant that are consistent with MM5 system rather than CMAQ system for computing coordinate-based fields. Removed explicit recalculation of reference P-star and use field directly from MM5 output. Changed files: mcip2/metvars2ctm.F mcip2/refstate.F - Added preliminary support for urban canopy model in WRF. Changed file: mcip2/alloc_met.F mcip2/dealloc_met.F mcip2/getluse.F mcip2/init_met.F mcip2/metinfo_mod.F mcip2/metvars_mod.F mcip2/rdwrfem.F mcip2/setup_mm5v3.F mcip2/setup_wrfem.F - Corrected reading snow cover field for MM5 simulations with snow effects turned off (i.e., IFSNOW=0). Changed files: mcip2/rdmm5v3.F - Changed settings for WRF for XCENT_GD, YCENT_GD, XORIG_GD, and YORIG_GD in GRIDDESC and M3IO headers for Lambert conformal projection so that headers will be compatible with M3IO utility routines LL2LAM and LAM2LL. Still need to test with polar stereographic and Mercator projections. Changed files: mcip2/setgriddefs.F New files: mcip2/ll2xy_lam.F mcip2/ll2xy_lam_sec.F mcip2/ll2xy_lam_tan.F mcip2/ll2xy_ps.F - Changed read of vegetation fraction for WRF to preferentially use VEGF_PX rather than VEGFRA for Pleim-Xiu land-surface model. Changed files: mcip2/rdwrfem.F - Added processing option to include GOES-East satellite analyses to replace cloud top, cloud bottom, and cloud cover and to add cloud transmissivity for use in photolysis in CMAQ. Software components contributed by University of Alabama at Huntsville. Requires additional data sets and preprocessing package available from University of Alabama at Huntsville. Changed files: mcip2/Makefile mcip2/mcip.F mcip2/metcro.F mcip2/readnml.F mcip2/run.mcip mcip2/setgriddefs.F New file: mcip2/sat2mcip_mod.F - Added 2-m mixing ratio (Q2) to the METCRO2D output. Use Q2 directly from MM5 or WRF, if it is available; otherwise use layer-1 QV. Modified PBLSUP to use Q2 rather than layer-1 QV to diagnose near-surface variables. Added turbulent kinetic energy (TKE or TKEF) to the METCRO3D output, if it is available from MM5 or WRF. 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/metvars_mod.F mcip2/metvars2ctm.F mcip2/pblsup.F mcip2/rdmm5v3.F mcip2/rdwrfem.F mcip2/setgriddefs.F mcip2/setup_mm5v3.F mcip2/setup_wrfem.F mcip2/xvars_mod.F - Allow skin temperature from WRF-based input to be filled by top-layer soil temperature, if skin temperature is unavailable in WRF output. Changed files: mcip2/rdwrfem.F - Expanded tables of roughness length values to include 33 USGS land use categories. Added error-checking when ZNT is set from the lookup table for WRF. Corrected season assignment for WRF lookup table for the Southern Hemisphere. Changed files: mcip2/metvars2ctm.F mcip2/rdwrfem.F mcip2/resistcalc.F - Added error checking to ensure that WRF files used in an MCIP run are from the same simulation so that incremental precipitation totals are processed correctly. Changed files: mcip2/rdwrfem.F New file: mcip2/chkwrfhdr.F - Updated list of WRF model options used in metadata to reflect changes in WRFv3. Changed files: mcip2/wrfemopts.F - Changed setting for LAI to a fixed value (4.0) if NOAH LSM was used with WRF and if LAI is not found in the meteorology input files. Check LAI, RA, and RSTOM to ensure that there are non-zero values in the fields, if they exist. If the values of RA and/or RSTOM are all 0.0, reset IFRESIST flag so that they will be calculated later. If LAI is in output but is 0.0, set LAI to a fixed value (4.0) for NOAH LSM. Changed files: mcip2/metvars2ctm.F mcip2/rdwrfem.F - Changed criteria for setting number of land use categories from WRF when netCDF dimension "land_cat_stag" does not exist (i.e., when fractional land use is not part of the output). Changed files: mcip2/getluse.F mcip2/setup_wrfem.F mcip2/rdwrfem.F - Added nudging coefficients to metadata. Changed files: mcip2/blddesc.F mcip2/metinfo_mod.F mcip2/setup_mm5v3.F mcip2/setup_wrfem.F - Added earth radius assumed in MCIP to user input and to metadata. Changed files: mcip2/blddesc.F mcip2/const_mod.F mcip2/mcipparm_mod.F mcip2/readnml.F mcip2/run.mcip mcip2/gridgeometry.F - Updated Henry's Law constants for O3, NO3, hexane, octane, nonane, and methanol, and updated isoprene reference following changes made to analogous routine in CMAQ. Changed files: mcip2/hlconst.F - Replaced NTHIKD with NTHIK and replaced NBNDYD with NBNDY. Removed option for NTHIK=0. Changed files: mcip2/alloc_ctm.F mcip2/gridout.F mcip2/mcipparm_mod.F mcip2/metcro.F mcip2/setgriddefs.F - Increased maximum number of meteorology input files to 300 to accommodate 5-minute input for one day (i.e., 289 files). Changed files: mcip2/file_mod.F - Changed code to explicitly read free-form F90-compliant "include" files from I/O API rather than duplicate their contents. Changed files: mcip2/fdesc3_mod.F mcip2/iodecl3_mod.F mcip2/parms3_mod.F mcip2/Makefile - Updated version stamp. Changed files: mcip2/mcipparm_mod.F -------------------------------------------------------------------------------- MCIP Version 3.3 (1 Aug 2007) - Added a non-zero mesophyll resistance for NO, NO2, and CO in M3Dry following Pleim et al. (1984). Restored wet cuticle resistance for O3 based on field study measurements. Added wet ground resistance. Changed ground resistance to include partitioning of wet and dry ground. Updated pH of rain water for eastern United States and outside of North America. Changed reactivity for PAN. Corrected error in the calculation of surface resistance over water where (Sc/Pr)**(2/3) had inadvertently been omitted from the numerator. Surface resistance over water is now a function of species. Surface resistance over water now uses wet bulb temperature rather than ground (water) temperature in the calculation of the effective Henry's law constant, and algorithm has been updated. Changed (Sc/Pr)**(2/3) over water to a species-dependent, meteorologically dependent variable. Effective Henry's law constant over land now uses 2-m temperature rather than layer 1 temperature. Clarified usage of variables that store saturation vapor pressure and humidity. Changed files: mcip2/m3dry.F - Removed dry deposition velocity calculations for obsolete chlorine species ICL1 and ICL2. Changed files: mcip2/init_depv.F mcip2/m3dry.F - Corrected error in processing incremental precipitation (output fields RN and RC in METCRO2D) for first MCIP output time period when the first WRF output time is not used by MCIP. Changed files: mcip2/rdwrfem.F - Corrected error in calculation of contravariant vertical velocity (output field WHAT_JD in METCRO3D) for non-hydrostatic MM5 simulations where the total surface pressure from the first time period processed by MCIP was used 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.] Also eliminated calculation of reference surface pressure in METGRID2CTM because it was never referenced before being overwritten with total pressure and it is now captured in REFSTATE. Changed files: mcip2/alloc_x.F mcip2/dealloc_x.F mcip2/init_x.F mcip2/metgrid2ctm.F mcip2/refstate.F mcip2/vertnhy.F mcip2/xvars_mod.F - 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. Changed files: mcip2/alloc_ctm.F mcip2/dealloc_ctm.F mcip2/gridout.F mcip2/groutcom_mod.F mcip2/mcip.F mcip2/mcoutcom_mod.F mcip2/metcro.F - Removed obsolescent routines for processing RADM dry deposition velocities, MM5 version 2-formatted data, and recalculating PBL and radiation fields. Changed code so that M3Dry with chlorine and mercury is the only option to compute dry deposition velocities in MCIP. Removed user options associated with these (former) MCIP functions (i.e., LPBL, LCLD, LRAD, LHYDOUT). Changed USTAR and RADYN to be 2D arrays without a dimension for fractional land use that was required for RADMdry. Removed RADMdry variable ISESN. Changed files: mcip2/Makefile mcip2/run.mcip mcip2/alloc_depv.F mcip2/alloc_x.F mcip2/dealloc_depv.F mcip2/depvvars_mod.F mcip2/dynflds.F mcip2/getluse.F mcip2/getmet.F mcip2/getversion.F mcip2/init_depv.F mcip2/init_x.F mcip2/m3dry.F mcip2/mcipparm_mod.F mcip2/metcro.F mcip2/metgrid2ctm.F mcip2/metinfo_mod.F mcip2/metvars2ctm.F mcip2/pblsup.F mcip2/readnml.F mcip2/resistcalc.F mcip2/setgriddefs.F mcip2/setup.F mcip2/setup_mm5v3.F mcip2/setup_wrfem.F mcip2/statflds.F mcip2/xvars_mod.F Deleted files: mcip2/const_mete_mod.F mcip2/crs2dot.F mcip2/cvmgp.F mcip2/cvmgz.F mcip2/lradmdat_mod.F mcip2/mdate2hdate.F mcip2/pblpkg.F mcip2/pblpwr.F mcip2/radmdry.F mcip2/rdmm5.F mcip2/rdmm5v2.F mcip2/setup_mm5v2.F mcip2/sfcflux.F mcip2/slflux.F mcip2/solar.F mcip2/transm.F mcip2/verthyd.F - Modified calculations to eliminate dependencies on functions CVMGP and CVMGZ. Changed files: mcip2/getpblht.F mcip2/pblsup.F - Eliminated dependencies on module CONST_METE. Changed files: mcip2/bcldprc_ak.F mcip2/wind.F - Removed RBNDYI and JACOBS from output. Changed files: 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/xvars_mod.F - Removed calculations of low, middle, and high cloud amounts. Changed files: mcip2/alloc_x.F mcip2/bcldprc_ak.F mcip2/dealloc_x.F mcip2/init_x.F mcip2/xvars_mod.F - Removed calculations of 1.5-m and 10-m temperatures. Changed 2-m temperature to be output all of the time and to be calculated if it is unavailable in the input meteorology file(s). Changed 2-m temperature from "XT2" to "XTEMP2". Changed files: 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/pblsup.F mcip2/xvars_mod.F - Simplfied calculation of layer-1 specific humidity to optimize code. (Exact same answer.) Changed file: mcip2/pblsup.F - Updated MCIP to account for new method of storing "real" scalars in WRF I/O API with WRFv2.2. Changed files: mcip2/setup_wrfem.F mcip2/wrf_netcdf_mod.F - Added reads for fractional land use, leaf area index, aerodynamic and stomatal resistances, vegetation fraction, and canopy wetness, if they are available, in WRF. Allowed for roughness length to be filled from a lookup table if it is not available in WRF output file. Changed files: mcip2/metinfo_mod.F mcip2/rdwrfem.F mcip2/setup_wrfem.F mcip2/wrf_netcdf_mod.F - Removed reads and internal variables for emissivity and net radiation. Changed P-X variables for soil moisture, soil temperature, and soil type to general optional variables associated with IFSOIL. 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/rdmm5v3.F mcip2/rdwrfem.F mcip2/xvars_mod.F - Refined M3IO description of dominant land use categories to include land use source. Changed files: mcip2/getluse.F mcip2/gridout.F mcip2/groutcom_mod.F mcip2/resistcalc.F mcip2/setup_mm5v3.F mcip2/setup_wrfem.F mcip2/xvars_mod.F - Moved F2 and RSTMIN from metvars2ctm.F to resistcalc.F, and made them local variables. Changed files: mcip2/alloc_x.F mcip2/dealloc_x.F mcip2/init_x.F mcip2/metvars2ctm.F mcip2/resistcalc.F mcip2/xvars_mod.F - Eliminated logical variable "PX" to make code more general. Added several flags to indicate whether or not fields are available in input meteorology. Made changes to accommodate the NOAH LSM. Changed files: mcip2/alloc_ctm.F mcip2/alloc_met.F mcip2/dealloc_ctm.F mcip2/dealloc_met.F mcip2/init_met.F mcip2/m3dry.F mcip2/mcipparm_mod.F mcip2/mcoutcom_mod.F mcip2/metcro.F mcip2/metinfo_mod.F mcip2/pblsup.F mcip2/rdmm5v3.F mcip2/rdwrfem.F mcip2/setup_mm5v3.F mcip2/setup_wrfem.F - Changed setting of Schmidt number for water to be consistent in code. Changed files: mcip2/resistcalc.F - Corrected setting for number of microphysical species available when warm rain scheme is run in MM5. Changed files: mcip2/setup_mm5v3.F - Corrected sample prints in the log file for a one-cell domain. Changed file: mcip2/setgriddefs.F - Added "IMPLICIT NONE". Changed files: mcip2/alloc_x.F mcip2/const_mod.F mcip2/const_pbl_mod.F mcip2/coord_mod.F mcip2/date_time_mod.F mcip2/depvvars_mod.F mcip2/fdesc3_mod.F mcip2/file_mod.F mcip2/getpblht.F mcip2/groutcom_mod.F mcip2/iodecl3_mod.F mcip2/mcipparm_mod.F mcip2/mcoutcom_mod.F mcip2/mdoutcom_mod.F mcip2/metinfo_mod.F mcip2/metvars_mod.F mcip2/parms3_mod.F mcip2/setgriddefs.F mcip2/vertarys.F mcip2/vgrd_mod.F mcip2/xvars_mod.F - Reduced memory use in cloud postprocessing routine. Changed files: mcip2/bcldprc_ak.F - Added metadata to output files to describe MCIP version, input meteorology source, and options used in the meteorology model. Changed files: mcip2/Makefile mcip2/comheader.F mcip2/mcipparm_mod.F mcip2/metinfo_mod.F mcip2/setup_mm5v3.F mcip2/setup_wrfem.F mcip2/statflds.F mcip2/vstamp.F New files: mcip2/blddesc.F mcip2/mm5v3opts.F mcip2/wrfemopts.F - Updated version stamp. Changed files: mcip2/mcipparm_mod.F mcip2/vstamp.F -------------------------------------------------------------------------------- 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.