doc/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 users 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 4 source code release.
  23 ======================================
  24
  25 V4.4 Release Notes :
  26 -------------------
  27
  28 Version 4.4 was released on April 26, 2022.
  29
  30   For more information about WRFDA, visit the WRFDA Users home page
  31   http://www2.mmm.ucar.edu/wrf/users/wrfda/index.html
  32
  33   - New features:
  34   ----------------
  35     - New capability for assimilating GPM GMI radiance data, contributed by Dr. Dongmei Xu at
  36       the Nanjing University of Information Science & Technology.
  37       Shen, F., D. Xu, H. Li, J. Min, and R. Liu，2021: Assimilation of GPM Microwave Imager Radiance data with
  38        the WRF Hybrid 3DEnVar System for the Prediction of Typhoon Chan-hom (2015), Atmospheric Research. 251, 105422.
  39
  40     - New option for surface aerosol data assimilation with the MADE-VBS aerosol scheme. The ~doc/README.DA_chem
  41       file provides a description for all chemical/aerosol DA options currently available.
  42       Ha, Soyoung, 2022: Implementation of aerosol data assimilation in WRFDA (V4.0.3) for WRF-Chem (V3.9.1)
  43         using the MADE/VBS scheme. Geosci. Model Dev., 15, 1769–1788.
  44
  45     - Ingest NCEP's satwnd.bufr to assimilate more AMVs that are not included in NCEP's prepbufr file.
  46       The "use_satwnd_bufr" namelist parameter default is true.
  47
  48   - Updated features:
  49   -------------------
  50     - Allow to set thinning mesh differently for different conventional observations through a new namelist
  51       parameter "thin_conv_opt(num_ob_indexes)". Also reduced memory use for thinning conventional observations.
  52
  53     - WRFDA gpsref code has been restructured to move QC steps in da_get_innov_vector_gpsref.inc to a separate
  54       subroutine in a new file da_qc_gpsref.inc. New namelist variables are added to have more flexibility for
  55       testing gpsref QC impact. Several issues with gpsref diagnostic output have been fixed and qcstat info
  56       for gpsref is now in new qcstat_gpsref_xx.
  57
  58     - Bug fixes and enhancements for applications related to offline VarBC (use_background_errors=false),
  59       3DEns-FGAT (num_fgat_time>0 and ensdim_alpha>0 and je_factor=1.0), precondition_cg=true and
  60       orthonorm_gradient=true when ensdim_alpha>0, full-ensemble mode (ensdim_alpha>0 and je_factor=1.0).
  61
  62     - Enable the assimilation of metop-c AMSU-A and MHS radiances with updated VARBC.in and "radiance info" files.
  63
  64   - Bug fixes:
  65   ------------
  66     - For direct assimilation of radar reflectivity, remove the use of "qthres" in the forward operator, which can
  67       cause an unrealistic low bound of computed reflectivity. Also simplify the quality control to keep data with
  68       both observed and background reflectivity >=rfmin (a namelist parameter).
  69
  70     - Fixed a bug in calculating TAMDAR aircraft temperature bias correction.
  71
  72     - Fixed memory leaks and runtime crashes due to the missing specification for time info inside chemical DA..
  73
  74 V4.3 Release Notes :
  75 -------------------
  76
  77 Version 4.3 was released on May 10, 2021.
  78
  79   For more information about WRFDA, visit the WRFDA Users home page
  80   http://www2.mmm.ucar.edu/wrf/users/wrfda/index.html
  81
  82   New features:
  83   --------------
  84     - New capability for Multi-Resolution Incremental 4DVar (MRI-4DVar).
  85       Liu, Z., J. Ban, J.-S, Hong, and Y.-H. Kuo, 2020: Multi-resolution incremental
  86         4D-Var for WRF: Implementation and application at convective scale,
  87         Q. J. R. Meteorol. Soc., 146, 3661-3674.
  88
  89     - New capability for assimilating surface pm2.5, pm10, O3, CO, NO2, SO2 using 3DVar.
  90       Sun, W., Liu, Z., Chen, D., Zhao, P., and Chen, M., 2020: Development and application
  91       of the WRFDA-Chem three-dimensional variational (3DVAR) system: aiming to improve air
  92       quality forecasting and diagnose model deficiencies, Atmos. Chem. Phys., 20, 9311-9329.
  93
  94   Updated features:
  95   -----------------
  96     - WRFDA gen_be_v3 is updated for cv_options=5 and ensemble applications.
  97        Please see var/gen_be_v3/README.gen_be_v3.
  98
  99 See http://www2.mmm.ucar.edu/wrf/users/wrfda/updates-4.3.html for a full list of updates
 100
 101 V4.2 Release Notes :
 102 -------------------
 103
 104 Version 4.2 was released on April 23, 2020.
 105
 106   For more information about WRFDA, visit the WRFDA Users home page
 107   http://www2.mmm.ucar.edu/wrf/users/wrfda/index.html
 108
 109   New features:
 110   ---------------
 111     - New capability for directly assimilating radar reflectivity using a new observation
 112         operator and its TL/AD considering snow and graupel.
 113       Wang, S. and Z. Liu, 2019: A radar reflectivity operator with ice-phase hydrometeors
 114         for variational data assimilation (version 1.0) and its evaluation with real radar data,
 115         Geosci. Model Dev., 12, 4031–4051.
 116
 117     - New capability for variational bias correction of TAMDAR T observations.
 118       The bias correction is applied based upon aircraft's IDs and phases (descent/ascent/cruise).
 119         To turn on this function, set "use_varbc_tamdar = true" in namelist (\wrfvar4).
 120       Gao, F., Z. Liu, J. Ma, A. N. Jacobs, P. P. Childs, and H. Wang, 2019: Variational Bias
 121         Correction of TAMDAR Temperature Observations in the WRF Data Assimilation System.
 122         Monthly Weather Review. 147. 10.1175/MWR-D-18-0025.1.
 123
 124     - New channel-based cloud detection scheme for Infrared sensors based on the Particle Filter.
 125       This is now the default option for IR cloud detection (use_clddet=2).
 126       Xu D., T. Auligné, G. Descombes, and C. Snyder, 2016: A method for retrieving clouds with
 127         satellite infrared radiances using the particle filter. Geosci. Model Dev., 9, 3919–3932.
 128
 129     - New capability for an IR-only cloud detection scheme for AHI radiance data assimilation.
 130       To turn this option on, set use_clddet_zz=true.
 131       Wu, Y., Z. Liu, and D. Li, 2020, Improving forecasts of a record-breaking rainstorm in Guangzhou
 132         by assimilating every 10-min AHI radiances with WRF 4DVAR. Atmospheric Research, 239, 104912.
 133
 134       Zhuge, X., Zou, X., 2016. Test of a modified infrared-only ABI cloud mask algorithm for AHI
 135         radiance observations. J. Appl. Meteorol. Climatol. 55 (11), 2529–2546.
 136
 137     - New stand-alone gen_be_v3. See var/gen_be_v3/README.gen_be_v3 for more info.
 138
 139   Updated features:
 140   ------------------
 141     - Improved analysis_type="RANDOMCV". Now multiple perturbed output can be obtained with one WRFDA run,      set new namelist "n_randomcv" to the desired number of ensemble.
 142
 143     - For EnVar DA applications, logical "alpha_vertloc" namelist switch is replaced by new integer
 144       option "alpha_vertloc_opt". See var/README.namelist.
 145
 146     - New DA ep_format option to read in ensemble perturbation (ep) generated by existing gen_be_ep2
 147       and new gen_be_v3 utilities.
 148
 149 See http://www2.mmm.ucar.edu/wrf/users/wrfda/updates-4.2.html for a full list of updates
 150
 151 V4.1 Release Notes :
 152 -------------------
 153
 154 Version 4.1 was released on April 12, 2019.
 155
 156   For more information about WRFDA, visit the WRFDA Users home page
 157   http://www2.mmm.ucar.edu/wrf/users/wrfda/index.html
 158
 159   New features:
 160   ------------------
 161     - Himawari AHI radiance data assimilation
 162       Wang, Y., Z. Liu, S. Yang, J. Min, L. Chen, Y. Chen, and T. Zhang, 2018:
 163         Added value of assimilating Himawari-8 AHI water vapor radiances on analyses
 164         and forecasts for "7.19" severe storm over north China. J. Geophys. Res. Atmos.,
 165         123, https://doi.org/10.1002/2017JD027697.
 166     - 3DVAR and hybrid-3D/4DEnVar now work with moist potential temperature.
 167
 168   Updated features:
 169   ------------------
 170    - Update WRFDA to handle RTTOV v12.1. New emissivity formulations are enabled
 171      as well as HDF-only emissivity atlas files. Compiling WRFDA for RTTOV now
 172      requires an HDF5 library.
 173    - The code-base of CRTM carried with WRFDA is updated from v2.2.3 to v2.3.0.
 174      Starting with V4.0, CRTM coefficient files are NOT included
 175      in any of the WRF or WRFDA tar files. There are two ways to get this data.
 176       1. A subset of coefficient files can be download from
 177          http://www2.mmm.ucar.edu/wrf/users/wrfda/download/crtm_coeffs.html
 178       2. The full set of CRTM coefficients may be downloaded from:
 179          ftp://ftp.emc.ncep.noaa.gov/jcsda/CRTM/REL-2.3.0/crtm_v2.3.0.tar.gz
 180      For external users, replace the link ‘var/run/crtm_coeffs’ with the directory
 181      contained in the appropriate tar file. A copy is also available under ~wrfhelp
 182      on the NCAR cheyenne supercomputer (for internal use).
 183    - Enhance the gts_omb_oma diagnostics by appending time slot information after the level information.
 184    - Allow pseudo ob at not-first time slot for 4DVAR.
 185    - New WRFDA namelist options for specifying errors for radar rhv(rrn/rsn/rgr)
 186    - New WRFDA namelist options for turning on/off some diagnostic output.
 187    - Fix to allow assimilation of SSMI TPW contained (prior to Nov 2009) in prepbufr
 188      obs files when ob_format=1 and use_ssmiretrievalobs=.true.
 189
 190 See http://www2.mmm.ucar.edu/wrf/users/wrfda/updates-4.1.html for a full list of updates
 191
 192 V4.0 Release Notes :
 193 -------------------
 194
 195 Version 4.0 was released on June 8, 2018.
 196
 197   For more information about WRFDA, visit the WRFDA Users home page
 198   http://www2.mmm.ucar.edu/wrf/users/wrfda/index.html
 199
 200   New features:
 201   ------------------
 202     - GOES-Imager radiance data assimilation
 203     - GPSRO Excess PHase (GPSEPH) observation operator
 204     - Large-scale analysis constraint (LSAC)
 205     - Divergence constraint (DIVC)
 206
 207   Updated features:
 208   ------------------
 209    - WRFPlus code is now fully integrated into WRF and TLM/ADJ code, located under the 'wrftladj' directory.
 210    - Starting with V4.0, CRTM coefficient files are NOT included in any of the WRF or WRFDA tar files.
 211      There are two ways to get this data.
 212       1. A subset of coefficient files can be download from
 213          http://www2.mmm.ucar.edu/wrf/users/wrfda/download/crtm_coeffs.html
 214       2. The full set of CRTM coefficients may be downloaded from:
 215          ftp://ftp.emc.ncep.noaa.gov/jcsda/CRTM/REL-2.2.3/crtm_v2.2.3.tar.gz
 216
 217   WRFDA with hybrid vertical coordinate (HVC) and moist potential temperature (THM):
 218   -----------------------------------------------------------------------------------
 219     - 3DVAR works with HVC since V3.9, but does not work with THM
 220     - Neither WRFPlus nor 4DVAR work with HVC or THM
 221     - It is recommended to turn off HVC (set hybrid_opt=0, etac=0.0) and THM (set use_theta_m=0)
 222       when using WRF V4.0 along with WRFDA V4.0
 223
 224 See http://www2.mmm.ucar.edu/wrf/users/wrfda/updates-4.0.html for a full list of updates
 225
 226 ======================================
 227 This is the main directory for the WRFDA Version 3 source code release.
 228 ======================================
 229
 230 V3.9.1 Release Notes :
 231 -------------------
 232
 233 Version 3.9.1 was released on August 17, 2017.
 234
 235   For more information about WRFDA, visit the WRFDA Users home page
 236   http://www2.mmm.ucar.edu/wrf/users/wrfda/index.html
 237
 238   Updated features:
 239
 240     - Reduced memory usage for non-4DVAR runs
 241     - Some bugs have been fixed
 242
 243 See http://www2.mmm.ucar.edu/wrf/users/wrfda/updates-3.9.1.html for a full list of updates
 244
 245 ======================================
 246
 247 V3.9 Release Notes :
 248 -------------------
 249
 250 Version 3.9 was released on April 17, 2017.
 251
 252   For more information about WRFDA, visit the WRFDA Users home page
 253   http://www2.mmm.ucar.edu/wrf/users/wrfda/index.html
 254
 255   New features:
 256
 257     - AMSR2 cloudy radiance assimilation
 258     - 4DEnVar assimilation capability
 259     - Radar "null-echo" assimilation
 260
 261   Updates:
 262     - Many bug fixes and performance improvements, including:
 263       - For use_radar_rhv=true, total reflectivity and retrieved hydrometeors were calculated incorrectly
 264       - Several compile-time and run-time bugs for PGI compilers
 265     - Updated CRTM to version 2.2.3 (from 2.1.3)
 266     - New run-time options for improving surface data assimilation (FM-12 SYNOP)
 267     - Improved implementation of cloud control variables (no longer requires conditional compilation)
 268     - New run-time options for calculating cloud base height for use_radar_rqv=true
 269     - WRFPLUS has been upgraded to V3.9 and is consistent with the released WRF version 3.9.
 270
 271 See http://www2.mmm.ucar.edu/wrf/users/wrfda/updates-3.9.html for a full list of updates
 272
 273 ======================================
 274
 275 V3.8.1 Release Notes :
 276 -------------------
 277
 278 Version 3.8.1 was released on August 12, 2016.
 279
 280   For more information about WRFDA, visit the WRFDA Users home page
 281   http://www2.mmm.ucar.edu/wrf/users/wrfda/index.html
 282
 283   Updated features:
 284
 285     - Additional information is now printed to log files, including:
 286         - Domain mapping info
 287         - Extra minimization info
 288     - CRTM-specific code is now compiled automatically
 289     - A number of issues have been fixed for this release, including:
 290         - Fixed compilation problems for Fujitsu compilers
 291         - A fix for some BUFR compilation problems if user has certain environment variables set
 292         - A fix for crashes with 4DVAR assimilation when using RRTMG radiation physics
 293         - Avoiding alarming (but harmless) error messages from GEN_BE stage 0
 294         - Fixing CRTM compilation problems for some Cray platforms
 295         - Cleaning up various log file outputs and clarifying some error messages
 296         - Fixed some incorrect default variables for certain physics options
 297     - WRFPLUS has been upgraded to V3.8.1 and is consistent with the released WRF version 3.8.1.
 298
 299 See http://www2.mmm.ucar.edu/wrf/users/wrfda/updates-3.8.1.html for a full list of updates
 300
 301 ======================================
 302
 303 V3.8 Release Notes :
 304 -------------------
 305
 306 Version 3.8 was released on April 8, 2016.
 307
 308   For more information about WRFDA, visit the WRFDA Users home page
 309   http://www2.mmm.ucar.edu/wrf/users/wrfda/index.html
 310
 311   New features:
 312
 313     - A new observation type: AMSR2 radiance
 314     - A new dynamic constraint for 3DVAR and Hybrid assimilation
 315
 316   Updates:
 317
 318     - The CV7 Background Error feature has been updated with major bug fixes
 319     - Fixed problems with excessive noise in moisture field for some radar options (use_radar_rhv, use_radar_rqv)
 320     - Improved assimilation of surface pressure obs for sfc_assi_options=1
 321     - Improved consistency of surface diagnostics (T2, Q2, U10, and V10) between WRFDA and WRF
 322     - Updated libraries:
 323         - RTTOV interface now supports RTTOV Version 11.1, 11.2, or 11.3
 324     - Many bug fixes and performance improvements
 325     - WRFPLUS has been upgraded to V3.8 and is consistent with the released WRF version 3.8.
 326
 327 See http://www2.mmm.ucar.edu/wrf/users/wrfda/updates-3.8.html for a full list of updates
 328
 329 ======================================
 330
 331 V3.7.1 Release Notes :
 332 -------------------
 333
 334 Version 3.7.1 was released on August 14, 2015.
 335
 336   For more information about WRFDA, visit the WRFDA Users home page
 337   http://www2.mmm.ucar.edu/wrf/users/wrfda/index.html
 338
 339   Updated features:
 340
 341     - A number of issues have been fixed for this release, including:
 342         - A fix for the new radar option "use_radar_rqv"
 343         - A fix for crashes and/or incorrect results for 4DVAR when assimilating radiance data with
 344           RTTOV with the option "rttov_emis_atlas_ir=1"
 345         - Fixing display problems in OBSPROC for large numbers of observations
 346         - Avoiding problems in OBSPROC with default observation error values
 347         - An incorrect interpolation of U and V in new CV7 option in GEN_BE has been fixed
 348     - WRFPLUS has been upgraded to V3.7.1
 349
 350 See http://www2.mmm.ucar.edu/wrf/users/wrfda/updates-3.7.1.html for a full list of updates
 351
 352 ======================================
 353
 354 V3.7 Release Notes :
 355 -------------------
 356
 357 Version 3.7 was released on April 20, 2015.
 358
 359   For more information on WRFDA, visit the WRFDA Users home page
 360   http://www2.mmm.ucar.edu/wrf/users/wrfda/index.html
 361
 362   New features:
 363
 364     -New background error option: CV7 (cv_options = 7)
 365     -Radar assimilation has been updated: new options have been added for reflectivity assimilation
 366     -A new mp_physics option is available for WRFPLUS in 4DVAR runs
 367
 368   Updated features:
 369
 370     -WRFDA can now use WRF files with the "lat-lon" (cylindrical equidistant) map projection. This
 371      does not include global WRF files.
 372     -Updated libraries:
 373         -RTTOV interface is now for RTTOV Version 11.1 or 11.2
 374     -Bug fixes and performance improvements
 375     -WRFPLUS has been upgraded to V3.7.
 376 ======================================
 377
 378 V3.6.1 Release Notes :
 379 -------------------
 380
 381 Version 3.6.1 was released on August 14, 2014.
 382
 383   For more information about WRFDA, visit the WRFDA Users home page
 384   http://www2.mmm.ucar.edu/wrf/users/wrfda/index.html
 385
 386   Updated features:
 387
 388     - A number of issues have been fixed for this release, including:
 389         - The FGAT capability has been updated to produce better results
 390         - Several bugs which may cause compilation failure
 391         - Bugs in SEVIRI radiance assimilation
 392         - Errors when using RTTOV to assimilate radiances in 4DVAR
 393         - The FGAT capability has been updated to produce better results
 394         - Many other minor problems
 395     - WRFPLUS has been upgraded to V3.6.1
 396
 397 See http://www2.mmm.ucar.edu/wrf/users/wrfda/updates-3.6.1.html for a full list of updates
 398
 399 ======================================
 400 V3.6 Release Notes :
 401 -------------------
 402
 403 Version 3.6 was released on April 18, 2014.
 404
 405   For more information on WRFDA, visit the WRFDA Users home page
 406   http://www2.mmm.ucar.edu/wrf/users/wrfda/index.html
 407
 408   New features:
 409
 410     -Dual-resolution hybrid assimilation has been implemented
 411     -New instruments can be assimilated:
 412         -Meteosat SEVIRI
 413         -Metop-B instruments
 414         -AIREP humidity observations
 415     -Observation thinning for conventional observations in ASCII format
 416
 417   Updated features:
 418
 419     -GPS Radio Occultation data can now be read separately from other conventional data types
 420     -Wind speed/direction assimilation has been updated, and namelist options have changed. See the
 421      relevant section of the User's Guide for more information.
 422     -Updated libraries:
 423         -CRTM Version 2.1.3
 424         -BUFR Version 10.2.3
 425         -RTTOV interface is now for RTTOV Version 11.1
 426     -Bug fixes and performance improvements
 427     -WRFPLUS has been upgraded to V3.6.
 428
 429 ======================================
 430 V3.5.1 Release Notes :
 431 -------------------
 432
 433 Version 3.5.1 is released on September 23, 2013.
 434
 435   For more information on WRFDA, visit the WRFDA Users home page
 436   http://www2.mmm.ucar.edu/wrf/users/wrfda/index.html
 437
 438
 439   The following bugs have been fixed:
 440     -BUFR libraries have been updated to allow WRFDA to read and assimilate NCEP PREPBUFR files of
 441      any endianness.
 442     -Compilation failure with some older Fortran95 compilers
 443     -A problem with Variational Bias Correction (VARBC) on some platforms
 444     -A problem with OBSPROC's built-in observation error file (obserr.txt) on some platforms
 445     -A bug causing failures when "print_detail_outerloop=true"
 446     -A few more miscellaneous fixes
 447
 448 ======================================
 449 V3.5 Release Notes :
 450 -------------------
 451
 452 Version 3.5 is released on April 18. 2013.
 453
 454   For more information on WRFDA, visit the WRFDA Users home page
 455   http://www2.mmm.ucar.edu/wrf/users/wrfda/index.html
 456
 457   New features:
 458
 459     -Wind Speed/Direction Assimilation: Wind speed/direction observations can now be directly
 460      assimilated.
 461     -New satellite instruments can be assimilated:
 462         -METOP Infrared Atmospheric Sounding Interferometer (IASI)
 463         -NPP Advanced Technology Microwave Sounder (ATMS)
 464         -FY3 Microwave Temperature Sounder (MWTS) and Microwave Humidity Sounder (MWHS)
 465
 466   Updated features:
 467
 468     -Yellowstone compilation options: Specific compilation options for the new NCAR supercomputer
 469         Yellowstone have been added.
 470     -Updated I/O for improved back-compatability with previous versions of WRF and WRFDA
 471     -WRFDA-3DVAR can now read two different PREPBUFR observation files at once
 472     -The "ntmax" namelist variable is now a vector, and can be set to a different value for each
 473      outer loop
 474     -WRFPLUS has been upgraded to V3.5 and it is consistent with the released WRF version 3.5.
 475
 476 ======================================
 477 V3.4.1 Release Notes :
 478 -------------------
 479
 480 Version 3.4.1 is released on August 16, 2012.
 481
 482 - For more information on WRFDA, visit the WRFDA Users home page
 483   http://www2.mmm.ucar.edu/wrf/users/wrfda/index.html
 484
 485 - WRFDA registry files have been reconstructed.
 486   Default namelist settings are now in registry.var file.
 487
 488 - WRFPLUS registry bug fixes related to mp_physics=9,10,13,14,16,17,18
 489
 490 ======================================
 491 V3.4 Release Notes :
 492 -------------------
 493
 494 Version 3.4 is released on April 6, 2012.
 495
 496 - The WRFPLUS (WRF adjoint and tangent linear model) has been upgraded to V3.4 and it is consistent
 497   with the released WRF version 3.4. Added parallel WRF TL/AD based on WRF 3.4.
 498
 499 - WRFDA 4D-Var now supports compilation to run in parallel.
 500
 501 - WRFDA 4D-Var now supports precipitation data (such as stage IV) assimilation.
 502
 503 - The ability to generate forecast sensitivity to observations has been updated.
 504
 505 - WRFDA Hybrid 3D-Var has been updated.
 506
 507 ======================================
 508
 509 V3.3.1 Release Notes :
 510 -------------------
 511
 512 Version 3.3.1 is released on September 27, 2011.
 513
 514 - WRF 4D-Var has been improved on lateral boundary condition control, analysis scheme for surface
 515   observation etc.
 516
 517 - Lots of bug fixes.
 518
 519 ======================================
 520
 521 V3.3 Release Notes:
 522 -----------------------
 523
 524 Version 3.3 is released on April 6, 2011.
 525
 526 - RTTOV interfaces has been upgraded to version 10.0
 527   Please download RTTOV v10.0 and install it in appropriate location
 528   if you want to use RTTOV to assimilate radiance observation with bufr format
 529
 530 - crtm_atmosphere is removed from the namelist.
 531   Now the CRTM reference climatology is determined inside WRFDA based on
 532   latitude and month.
 533
 534 - New WRF 4D-Var
 535   The WRFPLUS (WRF adjoint and tangent linear model) has been upgraded to V3.3
 536   and it is consistent with the released WRFV version 3.3. However, only dry dynamic
 537   processes are included in WRFPLUS version 3.3 and only serial run is supported
 538   at this release.
 539   WRFDA is also upgraded to consistent with WRFPLUS version 3.3 and the new 4D-Var
 540   system is a single executable application. Please refer to Users' guide for the
 541   details.
 542
 543 - Lots of bug fixes.
 544
 545 V3.2.1 Release Notes:
 546 -----------------------
 547
 548 Version 3.2.1 is released on August 18, 2010.
 549
 550 - CRTM interface for radiance assimilation has been upgraded to version 2.0.2.
 551
 552 - CRTM V2.0.2 has been included as an internal library in WRFDA codes.
 553   Setting environmental variable CRTM to ANYTHING to activate the CRTM installation
 554   during WRFDA compilation.
 555
 556 - Multivariate gen_be method which considers the correlations between moisture and
 557   other variables is included, but the support for the new capability will be very
 558   limited.
 559
 560 - Lots of bug fixes.
 561
 562 V3.2 Release Notes:
 563 -----------------------
 564
 565 Version 3.2 is released on March 31, 2010.
 566
 567 - Improvements on  multiple outer loop which handling nonlinearity issue
 568
 569 - Adjoint sensitivity tool
 570
 571 - Improved software performance
 572
 573 - Improved WRF adjoint codes.
 574
 575 V3.1.1 Release Notes:
 576 -----------------------
 577
 578 Version 3.1.1 is released on July 31, 2009.
 579
 580 - Radiance data assimilation using K Matrix capability is completed in V3.1.1 release,
 581   which dramatically speedup the analysis. To use K Matrix , please
 582   set USE_CRTM_KMATRIX=true in wrfvar14@namelist.input.
 583   Note: it only applied on CRTM in V3.1.1.
 584
 585 - Improved software portability; only NETCDF library is mandatory
 586   if only LITTLE_R formated conventional observational data to be used.
 587   To use Prepbufr observational files, just set environmental variable
 588   BUFR equal to 1 before the code is compiled. To use radiance BUFR
 589   format data, CRTM or RTTOV is needed.
 590
 591
 592 V3.1 Release Notes:
 593 -----------------------
 594
 595 Version 3.1 is released on April 9, 2009.
 596
 597 - For more information on WRFDA, visit the new WRFDA Users home page
 598   http://www2.mmm.ucar.edu/wrf/users/wrfda/index.html
 599   and read the online User's Gudie.
 600
 601 - 4DVAR and radiance data assimilation capabilities are included in V3.1.
 602
 603 - New README files under WRFDA/var (README.namelist, README.basics,
 604   README.radiance)
 605
 606 - WRFDA V3.1 executable will work with V3.0 wrfinput/wrfbdy (but requires
 607   inserting a new namelist variable use_baseparam_fr_nml in &dynamics).
 608   However, rerunning V3.1 WPS/real.exe is recommended.
 609
 610 - Changes to namelist variables.
 611     * Some obsolete or unused namelist variables are removed, some new namelist
 612       variables are added, purposes of some namelist variables are changed.
 613       See WRFDA/var/README.namelist for descriptions of supported namelist
 614       variables.
 615
 616 - Changes to obsproc:
 617     * the executable is renamed to be obsproc.exe from 3dvar_obs.exe and
 618       namelist.3dvar_obs is renamed to be namelist.obsproc to reflect
 619       its capabilitiy of producing WRFDA-ready observations for 3DVAR, FGAT,
 620       or 4DVAR applications.
 621       See WRFDA/var/obsproc/README.
 622     * compilation of obsproc.exe is included in "compile all_wrfvar"
 623
 624 - Changes to diagnostic output files
 625     * gts_omb_oma becomes gts_omb_oma_01 (01 indicates outer loop index)
 626     * observations that fail check_max_iv are listed in rej_obs_conv_01.000
 627       ( 01 is outer loop index, 000 is processor id)
 628     * qcstat_conv_01 (01 indicates outer loop index) contains observation
 629       number counts
 630
 631 - Most of the scripts under WRFDA/var/scripts are removed from the main source
 632   code tar file. They can still be downloaded separately.
 633   See http://www2.mmm.ucar.edu/wrf/users/wrfda/download/tools.html
 634
 635 For questions, send mail to wrfhelp@ucar.edu
 636
 637 ======================================
 638
 639 WRFDA update history:
 640
 641 - V3.0:     Apr  4, 2008
 642 - V3.0.1:   Aug  6, 2008
 643 - V3.0.1.1: Aug 29, 2008
 644 - V3.1:     Apr  9, 2009
 645 - V3.1.1:   Jul 31, 2009
 646 - V3.2:     Mar 31, 2010
 647 - V3.2.1:   Aug 18, 2010
 648 - V3.3:     Apr  6, 2011
 649 - V3.3.1:   Sep 27, 2011
 650 - V3.4:     Apr  6, 2012
 651 - V3.4.1:   Aug 16, 2012
 652 - V3.5:     Apr 18, 2013
 653 - V3.5.1:   Sep 23, 2013
 654 - V3.6:     Apr 18, 2014
 655 - V3.6.1:   Aug 14, 2014
 656 - V3.7:     Apr 20, 2015
 657 - V3.7.1:   Aug 14, 2015
 658 - V3.8:     Apr  8, 2016
 659 - V3.8.1:   Aug 12, 2016
 660 - V3.9:     Apr 17, 2017
 661 - V3.9.1:   Aug 17, 2017
 662 - V4.0:     Jun  8, 2018
 663 ======================================
 664
 665 How to compile and run?
 666 -----------------------
 667
 668 - In WRFDA directory, type `configure wrfda` - this will create a configure.wrf
 669   file that has appropriate compile options for the supported computers.
 670
 671   Note: WRFDA only requires netCDF library for compilation
 672         Install netCDF library with the same compiler that will be used to compile WRFDA.
 673         NCEP BUFR and CRTM libs are included in the WRFDA tar file.
 674         Set environment variables properly according to your applications
 675         before you type 'configure wrfda'. For example,
 676
 677         setenv NETCDF /usr/local/netcdf
 678         setenv RTTOV /usr/local/rttov11 (optional, set to compile WRFDA with RTTOV capability)
 679
 680 - Type 'compile all_wrfvar' when you are ready:
 681
 682 - If sucessful, this will create da_wrfvar.exe and a set of utilities
 683   in directory WRFDA/var/build/.
 684
 685 - cd to the appropriate test or run directory to run WRFDA.
 686
 687      Some basic instruction/namelist.input are available in sub-directories
 688      of WRFDA/var/test.
 689
 690 - See the Users Guide (http://www2.mmm.ucar.edu/wrf/users/wrfda/usersguide.html) for more detailed instructions.
 691