This file contains a list of changes since the last official release
of the WRF Standard Initialization package.

Changes since Beta 1.0 (Dec 20 2000)
====================================

Machine type "pc" now supported for Intel platforms running Linux and
using Portland Group compiler.

Changed formatted read statements in src/grib_prep/util/parse_table.F
that were causing errors on later AIX compilers in use at the
USAF Weather Agency (thanks to Dr. Mike McAtee of The Aerospace Corp.)

Changes for Summer 2001 Release
===============================
Numerous changes were made as part of implementing all required static
fields for Land Surface Modeling support.  

gridgen_model.exe:
  - Added the processing of the following  additional fields:
    -- Monthly greenness fraction
    -- 2-layer, 16 category WMO/FAO soil type 
    -- 24 category USGS land use fractions
    -- Annual mean temperature
    -- Mean sub-subgridscale slope of topography in latitudinal and 
       longitudinal directions
    Expanded static.wrfsi (netCDF output from gridgen_model) to
    include dominant category and percent distributions for landuse
    and soiltype data.
  - All of the new datasets are in "tile" formats for ingest by
    gridgen_model. Software tools exists to make tiles for all
    surface geography data (not part of the release) but presently
    all geography data are 10x10 deg tiles.
  - Requires additional data paths in wrfsi.nl - section &sfcfiles

hinterp.exe:
  - Major code restructuring and cleanup
  - Now does all interpolation of atmospheric variables to the 
    non-staggered grid
  - Improved masked interpolation routine to handle masked fields
    like soil moisture, snow cover, etc.  LSM variables like these 
    are interpolated to the mass stagger of the Arakawa-C grid.
  - Use of new and improved coordinate conversion routines.
  - Choice of interpolation method for atmospheric variables, controlled
    via "interp_method" namelist setting, which replaces the 
    former "linear_interpolation" true/false flag.  Now, you can
    set interp_method to 0 for nearest neighber, 1 for bilinear 4-point
    interpolation, or 2 for 16-point method.

vinterp.exe:
  - Code restructuring and improvements for readability and efficiency
  - vinterp now does the final horizontal stagger after vertically
    interpolating
  - vinterp acquires all required fields from static file as final step

library routines in src/mod:
  - New horizontal interpolation and mapping routines

Initial localization capability:
  - Perl routines in etc: window_domain_rt.pl.in, localize_domain.pl.in
    and modules in laps_tools.pm are used to automatically localize
    domains.  These routines are converted to .pl upon installing.

Changes for Mar 2002 Release
=============================
hinterp.exe:
  - Changed some of the expected 8-character names for the land surface
    variables per NCAR recommendation.  
  - Now passes PSFC through to vinterp...required for mass-coordinate 
    transformation
  - Miscellaneous code improvements

vinterp.exe:
  - Added support for mass coordinate version (etap) of WRF.
  - Added support for output of variables on A-grid.
  - Moved additional "shared" modules to src/mod
  - Cleaned up vinterp_control namelist section of wrfsi.nl
  - Input/output prefix names are no-longer user selectable, and the
    output files are now called "real_input.*" instead of wrf_input.

Shared Modules:
  - Added module_vinterp_utils.F
  - Moved module_diagnostic_vars.F and module_physical_constants.F from
    vinterp to here
  - Cleaned up variable names in module_wrf_metadata.F

data/wrfsi.nl:
  - Combined the hinterp_control and vinterp_control namelist 
     sections into one, easier to use section (interp_control).
  - Removed some flexibility to reduce confusion

data/Vtable.*:
  - Added Vtable for RUCLSM variables.
  - Made all entries for water equivalent snow depth "WEASD".
  - Changed convention for layer soil temp/moisture to:
     STbbbTTT  -> temperature, bounded by bbb cm on the bottom and TTT
                  centimeters on the top
     SMbbbTTT  -> Same as for temperature, but for soil moisture.

  - SOILTxxx and SOILMxxx still recognized for data that comes in on
    levels (like RUC).

26 MAR 02 (Mass coordinate pre-release version)
===============================================
  - Bug fix in src/mod/module_vinterp_utils.F
    (iqvp array was not being deallocated)
  - Bug fix in src/vinterp/module_vinterp_etap.F
  - New output file name convention
  - Mod to install_wrfsi.pl for DEC OSF installations
  - Added makefile_sgi.inc.in for SGI compilation
  - Global metadata now contains center lat/lon instead
    of southwest corner.

9 SEP 02
==========================================================
  - Made use of INSTALLROOT/SRCROOT/MOAD_DATAROOT all optional.  If not
    specified via command line or environment variables, the following
    assumptions are made:

    INSTALLROOT=SRCROOT=directory where code untarred and built.
    MOAD_DATAROOT=INSTALLROOT/data
    EXTDATAROOT = INSTALLROOT/extdata

  - Added support for GRIB files from models not on isobaric levels.  So
    far, this has only been tested with RUC, and you cannot input an
    isobaric data set for the exact same time slice as a non-isobaric
    data set.

  - Changed some namelist settings and how things work to improve
    real-time usage of multiple data sources (e.g., one source to 
    initialize the model and a different source to provide LBCs).
 
  - Separated grib_prep namelist into its own file found in 
    EXT_DATA_ROOT/static.
 
  - Added new scripts rt_wrf.pl, wrfprep.pl, and run_wrf.pl to
    allow users to easily run SI and WRF together in a real-time
    environment.

  - Added wrfprd subdirectory to MOAD_DATAROOT to support WRF
    model scripts.  

  - Code is best installed as a subdirectory of the WRF model
    now.  

25 Oct 2002
==========================================================================
  - Improved handling of land surface fields:
     SKINTEMP
     CANWAT
     SMxxxxxx
     STxxxxxx
     WEASD
  - Added AGRMET support
  - Improved ease of installation and running
  - Updated documentation
  - Removed extraneous wrfsi.nl entries

31 Jan 2003
==========================================================================
 - Added Graphical User Interface for domain localizations:
	gui/src
	gui/perlTk
	gui/guiTk
	gui/data/maps
	gui/bin; 

	install_gui.pl: installs the binaries and builds the perlTk
                   software if not already installed on your system.

	    > script is activated by top level install_wrfsi.pl script.
            > perlTk version ported with WRFSI (Tk800.023.tar.gz)
	    > platforms:
              ---------
		linux pc (and all intel-based systems)
		alpha linux
		ibm (note: works best with gnu make)

 - Updated/Improved many perl scripts to accomodate domain-setup
   GUI and overall functionality of WRFSI system.

 - Fixed "dateline" and "Greenwich Mean" (0 lon) boundary issues
   in gridgen_model. Added user friendly termination to allocate
   statements for large geog data (particularly green fraction and
   albedo)

-  Land fraction now computed from USGS land use data set. This
   means pctland_10m (or land_10m) is no longer needed as a static
   geog data set for WRFSI.
   Reference to "LAND_10M" or "PCTLAND_10M" has not been removed yet.

-  Static Geog (land states) data now processed by gridgen_model
	> topo_30s (also known as world_topo_30s)
	> landuse_30s
	> soiltype_top_30s
	> soiltype_bot_30s
	> greenfrac (also known as greenfrac_ncep)
	> albedo_ncep
	> soiltemp_1deg 

11 Mar 2003
=======================================================================
 - Added min/max greenness fraction to output for LSM
 - Added maximum snow albedo to support LSM
 - Added slope category to support LSM
 - Incorporated Jacques Middlecoff's netCDF-based I/O API
   -- wrfsi.nl now has OUTPUT_FILE_TYPE, which can be "BIN" for the
      original (binary) format, "WRF" to use the API, or "BOTH" to 
      output both formats
 - Bug fix in hinterp to prevent 1000mb fields from populating 
   surface fields.

22 Apr 2003
=======================================================================
 - Corrected minimum valid value for soil moisture fields
 - Added capability to pass the landuse and soiltype categories from
   the background model as replacements for the WRFSI-created 
   landuse and soiltype data.  For this to happen, one must:
     
      a.  Obtain dominant land use category from GRIB file via the
          Vtable.{SOURCE} entry.  This should be a 24-category
          USGS representation, with one value for each grid point,
          and the Vtable should assign the name "VEGCAT".

      b.  Obtain dominant soil type category from GRIB file via the
          Vtable.{SOURCE} entry.  This should be a 16-category
          FAO representation, with one value for each grid point,
          and the Vtable should assign the name "SOILCAT".

      c.  Set LSM_HINTERP_METHOD = 0 in wrfsi.nl.  This forces
          all LSM fields to be interpolated from the background
          to the WRF model using nearest-neighbor method. 

      If (a), (b), and (c) are all met, then the final real_input
      binary files will contain a 2D VGTYP data set in place 
      of the 3D LANDUSEF data.  A 2D SLTYP data set will be output
      in place of the SOILCTOP and SOILCBOT arrays.  

 - Added entries for VEGCAT and SOILCAT to Vtable.ETA and Vtable.AVN
   based on proposed NCEP GRIB Table 130 parameter numbers.

 - Added a flag to keep hinterp from processing the same file twice
   in the case of a user specifying an LSM_ROOT in wrfsi.nl that
   is the same as their INIT/LBC roots.  

 - Incorporated modifications made by NCAR for option of using
   WRF API I/O.  
 
 - Removed extraneous Vtables from extdata/static and cleaned up
   remaining tables and grib_prep.nl to better support user base
   and LSM community.

 - Added recognition of SOILWxxx and SWxxxXXX variables which 
   are intended to contain the liquid volumetric soil moisture.

1 May 2003
=====================================================================
- Corrected src/grid/proc_geodat.f for processing all global
domains such that the correct tiles are used and the
"super-tile" properly filled.  Insured that lat-lon-2-llij
projection values are accurate for all global domains. Mods
satisfy dateline, Greenwich Mean and polar domains.

- Incorporated default values for albedo, greenfraction and
islope when the raw tile data does not contain values. This
problem exists for some area of small isolated islands.
Commit Date: 2003/07/09

====== Changes since 1.3.1 to hinterp, vinterp, and misc.====================
Files Changed:
extdata/static/Vtable.AWIP (Added)

Purpose:
Provide a default Vtable for using NCAR Eta (AWIP212) archive
data that has SPECHUM but not RH.  (From Wei Wang)
-----------------------------------------------------------------------------
Commit Date: 2003/07/22 1515Z

Files Changed:
etc/wrfsi_utils.pm

Purpose:				
Allow either @NETCDF@ or /NETCDF/ as a subsititution in the pl.in scripts
-----------------------------------------------------------------------------
Commit Date:  2003/07/23 2200Z

Files Changed:
mod/module_wrfsi_io.F
vinterp/module_vinterp_etap.F
vinterp/vinterp.F
io_netcdf/wrf_io.F90
	
Purpose:
Improve vinterp performance using changes proposed by Jim Edwards, with
some modifications.  Vinterp only runs through routines once now when output
format is binary.  When output format is API, it runs through the initial
time twice to produce a cdl file that is used for subsequent time periods
to improve performance.  This should be viewed as an interim fix.
------------------------------------------------------------------------------
Commit Date:  2003/07/23 2210Z

Files Changed:
extdata/static/Vtable.ETAR
extdata/static/Vtable.ETALSM

Purpose:
Provide separate atmospheric and LSM tables for Eta for convenience.
-------------------------------------------------------------------------------
Commit Date:  2003/07/23 2215Z

Files Changed:
src/vinterp/proc_static.F

Purpose:
Now allows both the WRF and BG model landuse/soiltype info to be passed through
when both present, per request of LSM WG.  Also corrected stagger index
assigned to metadata of MAPFAC_U and MAPFAC_V.  
-------------------------------------------------------------------------------
Commit Date:  2003/08/01 1950Z

Files Changed:
src/vinterp/proc_static.F

Purpose:
Renamed GREENMAX, GREENMIN, ALBEDO, and ALBEDOMX to SHDMAX, SHDMIN,
ALBBCK, and SNOALB, respectively, per request of Dave Gill.
-------------------------------------------------------------------------------
Commit Date:  2003/08/04 1850Z

Files Changed:
extdata/static/Vtable.AGRMET

Purpose:
Update provided by NCAR.
------------------------------------------------------------------------------
Commit Date: 2003/08/18 1220Z

Files Changed:
src/hinterp/module_hinterp_gribprep.F
src/hinterp/proc_make_variable_metadata.F

Purpose:
Correct inconsistencies when using background VEGCAT and SOILCAT data
------------------------------------------------------------------------------
Commit Date: 2003/08/18 1220Z

Files Changed:
src/hinterp/module_hinterp_gribprep.F

Purpose:
Corrected bug that caused non-isobaric 3D input data to have the first
level replicated, thereby pushing top level off.  Also added a check
when using higher order interpolation to prevent RH from exceeding
original input min/max.  
------------------------------------------------------------------------------
Commit Date:  2003/08/18 1220Z

Files Changed:
src/vinterp/module_vinterp_etap.F
src/mod/module_vinterp_utils.F

Purpose:
Upward extrapolation of THETA now done using gradient of top two
available levels of input data.   Changed the interp_eta2eta_lin routine
to input a variable name instead of a logical flag to control how
extrapolation at top and bottom are handled. 

------------------------------------------------------------------------------
Commit Date: 2003/08/18 1220Z

Files Changed:
etc/wrfprep.pl.in

Purpose:
Added two command line options:
  -T 
  -e YYYYMMDDHH

The -T forces wrfprep to use pre-existing start/stop/interval values
in the wrfsi.nl (all other options for time control are ignored!)

The -e YYYYMMDDHH allows a user to specify and end time (use instead of
 the -f option).  

----------------------------------------------------------------------------
Commit Date:  2003/12/10 
Files Changed:
src/vinterp/{many}
src/hinterp/{many}
src/mod/module_wrfsi_io.F
src/staticpost (added)
src/lib/w3lib (added)
src/grib_prep/lib (removed)

Numerous changes to provide:

1.  Capability to use SI for WRF-NMM core.
2.  Corrected bugs in implementation of IO/API (netCDF)
3.  Created staticpost.exe to put static fields into API-compliant format. 
   These files are created as part of the localization script.
4.  Removed extraneous unused metadata from API-format output.
5.  Numerous bug fixes.
6.  Added nesting.

=====================================================================
SI version 2.0: 
21 May 2004
=====================================================================

Tiles for deep soil temperature data (used in gridgen_model) are now 180
degrees; previously these were 10 degrees.  Data resolution is still 1 deg
so now we only have 2 tiles: 90S180W and 90S000E. The updated THEADER file
follows:

  180  180  -90    0       0.5       0.5

Problems in subroutine "proc_geodat" processing deep soil temperature have
been corrected.  It is suspected that this upgrade has made this code more
efficient.

Added static file attributes as follows:
	date: 2003/12/05 21:38:39;  author: smart;  state: Exp;  lines: +42 -2
	Added nest info: center lat/lon, SW i/j and NE i/j, ratio to parent, parent_id
	to wrfsi.cdl

Added new file "wrfsi.rotlat.cdl" for NMM grid.


