wrfv2_fire/README.DA

   1 ------------------------
   2 WRFDA PUBLIC DOMAIN NOTICE
   3 ------------------------
   4
   5 WRF Data Assimilation System (WRFDA) was developed at the National
   6 Center for Atmospheric Research (NCAR) which is operated by the
   7 University Corporation for Atmospheric Research (UCAR). NCAR and
   8 UCAR make no proprietary claims, either statutory or otherwise,
   9 to this version and release of WRFDA and consider WRFDA to be in
  10 the public domain for use by any person or entity for any purpose
  11 without any fee or charge. UCAR requests that any WRFDA user include
  12 this notice on any partial or full copies of WRFDA. WRFDA is provided
  13 on an "AS IS" basis and any warranties, either express or implied,
  14 including but not limited to implied warranties of non-infringement,
  15 originality, merchantability and fitness for a particular purpose,
  16 are disclaimed. In no event shall UCAR be liable for any damages,
  17 whatsoever, whether direct, indirect, consequential or special, that
  18 arise out of or in connection with the access, use or performance of
  19 WRFDA, including infringement actions.
  20
  21 ======================================
  22 This is the main directory for the WRFDA Version 3 source code release.
  23 ======================================
  24
  25 V3.3.1 Release Notes :
  26 -------------------
  27
  28 Version 3.3.1 is released on September. 27, 2011.
  29
  30 - WRF 4D-Var has been improved on lateral boundary condition control, analysis scheme for surface observation etc.
  31
  32 - Lots of bug fixes.
  33
  34 ======================================
  35
  36 V3.3 Release Notes:
  37 -----------------------
  38
  39 Version 3.3 is released on April 6, 2011.
  40
  41 - RTTOV interfaces has been upgraded to version 10.0
  42   Please download RTTOV v10.0 and install it in appropriate location
  43   if you want to use RTTOV to assimilate radiance observation with bufr format
  44
  45 - crtm_atmosphere is removed from the namelist.
  46   Now the CRTM reference climatology is determined inside WRFDA based on
  47   latitude and month.
  48
  49 - New WRF 4D-Var
  50   The WRFPLUS (WRF adjoint and tangent linear model) has been upgraded to V3.3
  51   and it is consistent with the released WRFV version 3.3. However, only dry dynamic
  52   processes are included in WRFPLUS version 3.3 and only serial run is supported
  53   at this release.
  54   WRFDA is also upgraded to consistent with WRFPLUS version 3.3 and the new 4D-Var
  55   system is a single executable application. Please refer to Users' guide for the
  56   details.
  57
  58 - Lots of bug fixes.
  59
  60 V3.2.1 Release Notes:
  61 -----------------------
  62
  63 Version 3.2.1 is released on August 18, 2010.
  64
  65 - CRTM interface for radiance assimilation has been upgraded to version 2.0.2.
  66
  67 - CRTM V2.0.2 has been included as an internal library in WRFDA codes.
  68   Setting environmental variable CRTM to ANYTHING to activate the CRTM installation
  69   during WRFDA compilation.
  70
  71 - Multivariate gen_be method which considers the correlations between moisture and
  72   other variables is included, but the support for the new capability will be very
  73   limited.
  74
  75 - Lots of bug fixes.
  76
  77 V3.2 Release Notes:
  78 -----------------------
  79
  80 Version 3.2 is released on March 31, 2010.
  81
  82 - Improvements on  multiple outer loop which handling nonlinearity issue
  83
  84 - Adjoint sensitivity tool
  85
  86 - Improved software performance
  87
  88 - Improved WRF adjoint codes.
  89
  90 V3.1.1 Release Notes:
  91 -----------------------
  92
  93 Version 3.1.1 is released on July 31, 2009.
  94
  95 - Radiance data assimilation using K Matrix capability is completed in V3.1.1 release,
  96   which dramatically speedup the analysis. To use K Matrix , please
  97   set USE_CRTM_KMATRIX=true in wrfvar14@namelist.input.
  98   Note: it only applied on CRTM in V3.1.1.
  99
 100 - Improved software portability; only NETCDF library is mandatory
 101   if only LITTLE_R formated conventional observational data to be used.
 102   To use Prepbufr observational files, just set environmental variable
 103   BUFR equal to 1 before the code is compiled. To use radiance BUFR
 104   format data, CRTM or RTTOV is needed.
 105
 106
 107 V3.1 Release Notes:
 108 -----------------------
 109
 110 Version 3.1 is released on April 9, 2009.
 111
 112 - For more information on WRFDA, visit the new WRFDA Users home page
 113   http://www.mmm.ucar.edu/wrf/users/wrfda/index.html
 114   and read the online User's Gudie.
 115
 116 - 4DVAR and radiance data assimilation capabilities are included in V3.1.
 117
 118 - New README files under WRFDA/var (README.namelist, README.basics,
 119   README.radiance)
 120
 121 - WRFDA V3.1 executable will work with V3.0 wrfinput/wrfbdy (but requires
 122   inserting a new namelist variable use_baseparam_fr_nml in &dynamics).
 123   However, rerunning V3.1 WPS/real.exe is recommended.
 124
 125 - Changes to namelist variables.
 126     * Some obsolete or unused namelist variables are removed, some new namelist
 127       variables are added, purposes of some namelist variables are changed.
 128       See WRFDA/var/README.namelist for descriptions of supported namelist
 129       variables.
 130
 131 - Changes to obsproc:
 132     * the executable is renamed to be obsproc.exe from 3dvar_obs.exe and
 133       namelist.3dvar_obs is renamed to be namelist.obsproc to reflect
 134       its capabilitiy of producing WRFDA-ready observations for 3DVAR, FGAT,
 135       or 4DVAR applications.
 136       See WRFDA/var/obsproc/README.
 137     * compilation of obsproc.exe is included in "compile all_wrfvar"
 138
 139 - Changes to diagnostic output files
 140     * gts_omb_oma becomes gts_omb_oma_01 (01 indicates outer loop index)
 141     * observations that fail check_max_iv are listed in rej_obs_conv_01.000
 142       ( 01 is outer loop index, 000 is processor id)
 143     * qcstat_conv_01 (01 indicates outer loop index) contains observation
 144       number counts
 145
 146 - Most of the scripts under WRFDA/var/scripts are removed from the main source
 147   code tar file. They can still be downloaded separately.
 148   See http://www.mmm.ucar.edu/wrf/users/wrfda/download/tools.html
 149
 150 For questions, send mail to wrfhelp@ucar.edu
 151
 152 ======================================
 153
 154 WRFDA update history:
 155
 156 - V3.0:     Apr  4, 2008
 157 - V3.0.1:   Aug  6, 2008
 158 - V3.0.1.1: Aug 29, 2008
 159 - V3.1:     Apr  9, 2009
 160 - V3.1.1:   Jul 31, 2009
 161 - V3.2:     Mar 31, 2010
 162 - V3.2.1:   Aug 18, 2010
 163
 164 ======================================
 165
 166 How to compile and run?
 167 -----------------------
 168
 169 - In WRFDA directory, type 'configure wrfda - this will create a configure.wrf
 170   file that has appropriate compile options for the supported computers.
 171
 172   Note: WRFDA only requires netCDF library starting with V3.1.1.
 173         Install netCDF library with the same compiler that will be used to compile WRFDA.
 174         NCEP BUFR and CRTM 2.0.2 libs are included in the WRFDA tar file.
 175         Set environment variables properly according to your applications
 176         before you type 'configure wrfda'. For example,
 177
 178         setenv NETCDF /usr/local/netcdf-pgi
 179         setenv BUFR 1 (optional, set to compile WRFDA with NCEP BUFR capability)
 180         setenv CRTM 1 (optional, set to compile WRFDA with CRTM capability)
 181         setenv RTTOV /usr/local/rttov10 (optional, set to compile WRFDA with RTTOV capability)
 182
 183 - Type 'compile all_wrfvar' when your are ready:
 184
 185 - If sucessful, this will create da_wrfvar.exe and a set of utilities
 186   in directory WRFDA/var/build/.
 187
 188 - cd to the appropriate test or run directory to run WRFDA.
 189
 190      Some basic instruction/namelist.input are available in sub-directories
 191      of WRFDA/var/test.
 192