Commit 6726b3df authored by William Gustafson's avatar William Gustafson
Browse files

Initial WRF code from NCAR v3.7.0 released 17-Apr-2015.

parent 640a392f

Too many changes to show.

To preserve performance only 1000 of 1000+ files are displayed.
commit_notes
*.[ao]
*~
This diff is collapsed.
WRF Model Version 3.7 (April 17, 2015)
http://wrf-model.org/users/users.php
------------------------
WRF PUBLIC DOMAIN NOTICE
------------------------
WRF was developed at the National Center for Atmospheric Research
(NCAR) which is operated by the University Corporation for
Atmospheric Research (UCAR). NCAR and UCAR make no proprietary
claims, either statutory or otherwise, to this version and
release of WRF and consider WRF to be in the public domain for
use by any person or entity for any purpose without any fee or
charge. UCAR requests that any WRF user include this notice on
any partial or full copies of WRF. WRF is provided on an "AS
IS" basis and any warranties, either express or implied,
including but not limited to implied warranties of
non-infringement, originality, merchantability and fitness for a
particular purpose, are disclaimed. In no event shall
UCAR be liable for any damages, whatsoever, whether direct,
indirect, consequential or special, that arise out of or in
connection with the access, use or performance of WRF, including
infringement actions.
======================================
This is the main directory for the WRF Version 3 source code release.
======================================
V3.7 Release Notes (4/17/15) (rev 8350):
-------------------
- For more information on WRF V3.7 release, visit WRF User's home pages
http://www2.mmm.ucar.edu/wrf/users/, and
http://www.dtcenter.org/wrf-nmm/users/, and read the online User's Guide.
V3.6.1 Release Notes (8/14/14) (rev 7630):
-------------------
- For more information on WRF V3.6.1 release, visit WRF User's home pages
http://www2.mmm.ucar.edu/wrf/users/, and
http://www.dtcenter.org/wrf-nmm/users/, and read the online User's Guide.
V3.6 Release Notes (4/18/14) (rev 7412):
-------------------
- For more information on WRF V3.6 release, visit WRF User's home pages
http://www2.mmm.ucar.edu/wrf/users/, and
http://www.dtcenter.org/wrf-nmm/users/, and read the online User's Guide.
======================================
V3.5.1 Release Notes (9/23/13) (rev 6868):
-------------------
- For more information on WRF V3.5.1 release, visit WRF User's home pages
http://www2.mmm.ucar.edu/wrf/users/, and
http://www.dtcenter.org/wrf-nmm/users/, and read the online User's Guide.
======================================
V3.5 Release Notes (4/18/13) (rev 6660):
-------------------
- For more information on WRF V3.5 release, visit WRF User's home pages
http://www2.mmm.ucar.edu/wrf/users/, and
http://www.dtcenter.org/wrf-nmm/users/, and read the online User's Guide.
======================================
V3.4.1 Release Notes (8/16/12) (rev 5930):
-------------------
This is a bug fix release. The detailed updates for WRF-ARW can be found at
http://www2.mmm.ucar.edu/wrf/users/wrfv3.4/updates-3.4.1.html,
and for WRF-NMM at
http://www.dtcenter.org/wrf-nmm/users/model/wrfv3/updates.php
======================================
V3.4 Release Notes:
-------------------
Version 3.4 is released on April 6, 2012 (rev 5745).
- For more information on WRF V3.4 release, visit WRF User's home pages
http://www2.mmm.ucar.edu/wrf/users/, and
http://www.dtcenter.org/wrf-nmm/users/, and read the online User's Guide.
======================================
V3.3.1 Release Notes (9/16/11) (rev 5130):
-------------------
This is a bug fix release. The detailed updates for WRF-ARW can be found at
http://www2.mmm.ucar.edu/wrf/users/wrfv3.3/updates-3.3.1.html,
and for WRF-NMM at
http://www.dtcenter.org/wrf-nmm/users/model/wrfv3/updates.php
======================================
V3.3 Release Notes:
-------------------
Version 3.3 is released on April 6, 2011 (rev 4896).
- For more information on WRF V3.3 release, visit WRF User's home pages
http://www2.mmm.ucar.edu/wrf/users/, and
http://www.dtcenter.org/wrf-nmm/users/, and read the online User's Guide.
======================================
V3.2.1 Release Notes (8/18/10):
------------------
This is a bug fix release. The detailed updates for WRF-ARW can be found at
http://www2.mmm.ucar.edu/wrf/users/wrfv3.2/updates-3.2.1.html, and
for WRF-NMM at
http://www.dtcenter.org/wrf-nmm/users/model/wrfv3/updates.php
See online User's Guides for latest information.
======================================
V3.2 Release Notes:
-------------------
Version 3.2 is released on March 31, 2010.
- For more information on WRF V3.2 release, visit WRF User's home pages
http://www2.mmm.ucar.edu/wrf/users/, and
http://www.dtcenter.org/wrf-nmm/users/, and read the online User's Guide.
======================================
V3.1.1 Release Notes (7/31/09):
------------------
This is a bug fix release. The detailed updates for WRF-ARW can be found at
http://www2.mmm.ucar.edu/wrf/users/wrfv3.1/updates-3.1.1.html, and
for WRF-NMM at
http://www.dtcenter.org/wrf-nmm/users/model/wrfv3/updates.php
See online User's Guides for latest information.
======================================
V3.1 Release Notes:
-------------------
Version 3.1 is released on April 9, 2009.
- For more information on WRF V3.1 release, visit WRF Users home page
http://www2.mmm.ucar.edu/wrf/users/, and read the online User's Guide.
- WRF V3 executable will work with V3.0 wrfinput/wrfbdy (but requires
inserting a new namelist variable use_baseparam_fr_nml in &dynamics). As
always, rerunning the new programs is recommended.
- WRF V3.1 has changed a number of namelists. For example, ucmcall has
become sf_urban_physics, pd_moist(scalar/tke/chem) has become
moist_adv_opt (scalar/tke/chem_adv_opt). Helpful messages will be printed
to aid you.
V3.0.1.1 Release Notes:
-----------------------
Version 3.0.1.1 has only limited bug fixes compared to version 3.0.1.
The detailed updates for WRF-ARW can be found at
http://www2.mmm.ucar.edu/wrf/users/wrfv3/updates-3.0.1.1.html.
V3.0.1 Release Notes:
---------------------
This is a bug fix release. The detailed updates for WRF-ARW can be found at
http://www2.mmm.ucar.edu/wrf/users/wrfv3/updates-3.0.1.html.
Online User's Guides have also been updated.
======================================
V3.0 Release Notes:
------------------
- For directions on compiling WRF, see below or Users Web page.
- For more information on WRF V3 release, visit WRF Users home page
http://www2.mmm.ucar.edu/wrf/users/
- WRF V3 works with WPS, and SI is no longer supported.
Please see User' Guide for WPS.
- WRF V3 executable does not work with wrfinput/wrfbdy produced by previous versions.
- WRF V3 has removed one obsolete namelist variable, dyn_opt. Edit with caution.
======================================
WRF update history:
- V2.0.1: May 21, 2004
- V2.0.2: June 3, 2004
- V2.0.3: Nov 12, 2004
V2.0.3.1: Dec 3, 2004
- V2.1: August 4, 2005
- V2.1.1: Nov 8, 2005
- V2.1.2: Jan 27, 2006
- V2.2: Dec 21, 2006
- V2.2.1: Nov 1, 2007
- V3.0: April 4, 2008
- V3.0.1: August 5, 2008
- V3.0.1.1: August 22, 2008
- V3.1: April 9, 2009
- V3.1.1: July 31, 2009
- V3.2: March 31, 2010
- V3.2.1: August 18, 2010
- V3.3: April 6, 2011
- V3.3.1: Sept 16, 2011
- V3.4: April 6, 2012
- V3.4.1: Aug 16, 2012
- V3.5: April 18, 2013
- V3.5.1: Sept 23, 2013
- V3.6: April 18, 2014
- V3.6.1: Aug 14, 2014
======================================
How to compile and run?
-----------------------
- In WRFV3 directory, type 'configure' - this will create a configure.wrf
file that has appropriate compile options for the supported computers.
Note: WRF requires netCDF library. If your netCDF library is installed in
some odd directory, set environment variable NETCDF before you type
'configure'. For example,
setenv NETCDF /usr/local/netcdf-pgi
- Type 'compile case_name' where you can find the case_names by simply typing
compile. The following are available:
compile em_b_wave
compile em_grav2d_x
compile em_heldsuarez
compile em_hill2d_x
compile em_les
compile em_quarter_ss
compile em_real
compile em_seabreeze2d_x
compile em_convrad
compile em_squall2d_x
compile em_squall2d_y
compile em_scm_xy
compile em_tropical_cyclone
Notes: 1. If you are going to create model output file that is more than 2Gb,
you should consider using netCDF large file support function. To activate
this, one must set the environment variable WRFIO_NCD_LARGE_FILE_SUPPORT.
In c-shell environment, do
setenv WRFIO_NCD_LARGE_FILE_SUPPORT 1
2. Since V3.2, we support using multiple processors for compilation. The
default number of processors used is 2. But if you have any problem with
compilation, please try using one processor to compile. To do this, set
the following environment variable before compile:
setenv J "-j 1"
- If sucessful, this will create either real.exe or ideal.exe and wrf.exe
in directory main/, and the appropriate executables will be linked into
the test directoires under test/case_name, or run/.
- cd to the appropriate test or run directory to run ideal/real/wrf.
- If it is one of the idealized cases (b_wave, hill2d_x, grav2d_x, quarter_ss,
squall2d_x, squall2d_y, em_les or em_heldsuarez), cd the the appropriate directory, type
./ideal.exe
to produce wrfinput_d01 file for wrf model. Then type
./wrf.exe
to run.
- If it is real-data case (real), place files from WPS (met_em.*)
in the appropriate directory, type
./real.exe
to produce wrfbdy_d01 and wrfinput_d01. Then type
./wrf.exe
to run.
- If you use mpich, type
mpirun -np number-of-processors wrf.exe
- For information on how to make nested runs, visit
http://www2.mmm.ucar.edu/wrf/users/
======================================
What is in WRF V3?
- Advanced Research WRF (ARW) solver: Eulerian mass, hydrostatic and non-hydrostatic
* Arakawa C-grid staggering
* Runge-Kutta 2nd and 3rd order timestep options
* scalar-conserving flux form for prognostic variables
* 2nd to 6th order advection options (horizontal and vertical)
* time-split small step for acoustic modes
* small step horizontally explicit, vertically implicit
* divergence damping option and vertical time off-centering
* external-mode filtering option for mass model
* hydrostatic option via namelist option
* positive-definite and monotonic advection for moisture, scalar, tke and chemical tracers
* global modeling capability on latitude-longitude grid
* digital filter initialization
* WENO advection options
- Two-way nesting:
* multiple domains and multiple nest levels
* supports integer nest grid ratio
* feedback option for both odd and even nest grid ratios
* smoothing options
- One-way nesting
- Moving nest
* Specified move
* Automatic move using a mid-level vortex-following algorithm
- Physics options:
* microphysics (Kessler/ WRF Single Moment 3, 5 and 6 classes / Lin et al./ Mibrandt 2-moment /
Eta Ferrier / Thompson / Goddard / 2-moment Morrison / WRF Double Moment 5 and 6 classes /
SBU-Lin 5-classes / NSSL 2-moment and 1-moment / CAM 5.1 ) / Thompson aerosol-aware /
HUJI full and fast SBM
* cumulus parameterization (Kain-Fritsch with shallow convection /
Betts-Miller-Janjic / Grell-Devenyi ensemble / Grell 3D (with shallow convection option) /
Grell-Freitas ensemble /
Tiedtke (with shallow conv and momentum transport) / NSAS (with shallow conv and momentum transport) /
SAS (with shallow conv for ARW) / Zhang-McFarlane (with momentum transport) ) /
New Tiedtke (with shallow conv and momentum transport) / Multi-scale KF (with shallow convection)
* UW shallow convection / GRIMS shallow convection
* planetary boundary layer (Yosei University / Mellor-Yamada-Janjic / ACM2 / QNSE-EDMF / MYNN /
BouLac / UW / TEMF / Grenier-Bretherton-McCaa ) / Shin-Hong
* slab soil model (5-layer thermal diffusion / Noah land-surface model (4 levels) /
RUC LSM (6 levels) / Pleim-Xu (2 levels / Noah-MP (4 levels) / SSiB (3 levels) / CLM4 (10 levels) )
* Urban canopy model, BEP multi-layer and BEM (works with Noah LSM, BEP and
BEM also requires MYJ or BouLac)
* longwave radiation (RRTM / CAM / RRTMG / new Goddard / FLG )
* shortwave radiation (Dudhia / old Goddard / CAM / RRTMG / new Goddard / FLG ),
terrain slope and shading effect
* sub-grid turbulence (constant K diffusion/ 2-D Smagorinsky/ predicted TKE /
2-D, 6th order diffusion / Nonlinear Backscatter Anisotropic (NBA) sub-grid turbulence stress for LES )
* Rayleigh damping for w at the upper boundary layer
* gravity wave drag (including flow blocking)
* land-use categories determine surface properties; support for 24 category USGS and
20 category MODIS
* Options for modifying SST, sea ice, vegetation fraction, albedo, and deep soil temp
for long simulations
* fractional sea ice option for polar regions; modified snow/ice physics
* single-column ocean mixed layer model / 3D Price-Weller-Pinkel (PWP) ocean model
* drag and enthalpy flux formulation for hurricane applications
* CLM lake model
* windfarm drag
- Nudging:
* three-dimensional and surface analysis nudging
* observation nudging
* spectral nudging
- Software
* Hierarchical software architecture that insulates scientific code
(Model Layer) from computer architecture (Driver Layer)
* Multi-level parallelism supporting shared-memory (OpenMP), distributed-memory (MPI),
and hybrid share/distributed modes of execution
* Active data registry: defines and manages model state fields, I/O,
nesting, configuration, and numerous other aspects of WRF through a single file,
called the Registry
* Two-way nesting:
Easy to extend: forcing and feedback of new fields specified by
editing a single table in the Registry
Efficient: 5-8% overhead on 64 processes of IBM
Moving nests.
* Enhanced I/O options:
NetCDF and Parallel HDF5 formats
Nine auxiliary input and history output streams separately controllable through the namelist
Special input streams for analysis and observation nudging
Output file names and time-stamps specifiable through namelist
Special output stream for 3DVAR
* Efficient execution on a range of computing platforms:
IBM SP systems, (e.g. NCAR "bluevista","blueice","bluefire" Power5-based system)
IBM Blue Gene
SGI Origin and Altix
Linux/Intel
IA64 MPP (HP Superdome, SGI Altix, NCSA Teragrid systems)
IA64 SMP
x86_64 (e.g. TACC's "Ranger", NOAA/GSD "wJet" )
PGI, Intel, Pathscale, gfortran, g95 compilers supported
Sun Solaris (single threaded and SMP)
Cray X1, X1e (vector), XT3/4 (Opteron)
Mac Intel/ppc, PGI/ifort/g95
NEC SX/8
HP-UX
Fujitsu VPP 5000, FX10
Intel MIC
* RSL_LITE: communication layer, scalable to very large domains, supports nesting.
* I/O: NetCDF, parallel NetCDF (Argonne), HDF5, GRIB, raw binary, Quilting (asynchronous I/O), MCEL (coupling)
* ESMF Time Management, including exact arithmetic for fractional
time steps (no drift).
* ESMF integration - WRF can be run as an ESMF component.
* Improved documentation, both on-line (web based browsing tools) and in-line
------------------------
WRFDA PUBLIC DOMAIN NOTICE
------------------------
WRF Data Assimilation System (WRFDA) was developed at the National
Center for Atmospheric Research (NCAR) which is operated by the
University Corporation for Atmospheric Research (UCAR). NCAR and
UCAR make no proprietary claims, either statutory or otherwise,
to this version and release of WRFDA and consider WRFDA to be in
the public domain for use by any person or entity for any purpose
without any fee or charge. UCAR requests that any WRFDA user include
this notice on any partial or full copies of WRFDA. WRFDA is provided
on an "AS IS" basis and any warranties, either express or implied,
including but not limited to implied warranties of non-infringement,
originality, merchantability and fitness for a particular purpose,
are disclaimed. In no event shall UCAR be liable for any damages,
whatsoever, whether direct, indirect, consequential or special, that
arise out of or in connection with the access, use or performance of
WRFDA, including infringement actions.
======================================
This is the main directory for the WRFDA Version 3 source code release.
======================================
V3.7 Release Notes :
-------------------
Version 3.7 was released on April 20, 2015.
For more information on WRFDA, visit the WRFDA Users home page
http://www2.mmm.ucar.edu/wrf/users/wrfda/index.html
New features:
-New background error option: CV7 (cv_options = 7)
-Radar assimilation has been updated: new options have been added for reflectivity assimilation
-A new mp_physics option is available for WRFPLUS in 4DVAR runs
Updated features:
-WRFDA can now use WRF files with the "lat-lon" (cylindrical equidistant) map projection. This
does not include global WRF files.
-Updated libraries:
-RTTOV interface is now for RTTOV Version 11.1 or 11.2
-Bug fixes and performance improvements
-WRFPLUS has been upgraded to V3.7.
======================================
V3.6.1 Release Notes :
-------------------
Version 3.6.1 was released on August 14, 2014.
For more information about WRFDA, visit the WRFDA Users home page
http://www2.mmm.ucar.edu/wrf/users/wrfda/index.html
Updated features:
- A number of issues have been fixed for this release, including:
- The FGAT capability has been updated to produce better results
- Several bugs which may cause compilation failure
- Bugs in SEVIRI radiance assimilation
- Errors when using RTTOV to assimilate radiances in 4DVAR
- The FGAT capability has been updated to produce better results
- Many other minor problems
- WRFPLUS has been upgraded to V3.6.1
See http://www2.mmm.ucar.edu/wrf/users/wrfda/updates-3.6.1.html for a full list of updates
======================================
V3.6 Release Notes :
-------------------
Version 3.6 was released on April 18, 2014.
For more information on WRFDA, visit the WRFDA Users home page
http://www2.mmm.ucar.edu/wrf/users/wrfda/index.html
New features:
-Dual-resolution hybrid assimilation has been implemented
-New instruments can be assimilated:
-Meteosat SEVIRI
-Metop-B instruments
-AIREP humidity observations
-Observation thinning for conventional observations in ASCII format
Updated features:
-GPS Radio Occultation data can now be read separately from other conventional data types
-Wind speed/direction assimilation has been updated, and namelist options have changed. See the
relevant section of the User's Guide for more information.
-Updated libraries:
-CRTM Version 2.1.3
-BUFR Version 10.2.3
-RTTOV interface is now for RTTOV Version 11.1
-Bug fixes and performance improvements
-WRFPLUS has been upgraded to V3.6.
======================================
V3.5.1 Release Notes :
-------------------
Version 3.5.1 is released on September 23, 2013.
For more information on WRFDA, visit the WRFDA Users home page
http://www2.mmm.ucar.edu/wrf/users/wrfda/index.html
The following bugs have been fixed:
-BUFR libraries have been updated to allow WRFDA to read and assimilate NCEP PREPBUFR files of
any endianness.
-Compilation failure with some older Fortran95 compilers
-A problem with Variational Bias Correction (VARBC) on some platforms
-A problem with OBSPROC's built-in observation error file (obserr.txt) on some platforms
-A bug causing failures when "print_detail_outerloop=true"
-A few more miscellaneous fixes
======================================
V3.5 Release Notes :
-------------------
Version 3.5 is released on April 18. 2013.
For more information on WRFDA, visit the WRFDA Users home page
http://www2.mmm.ucar.edu/wrf/users/wrfda/index.html
New features:
-Wind Speed/Direction Assimilation: Wind speed/direction observations can now be directly
assimilated.
-New satellite instruments can be assimilated:
-METOP Infrared Atmospheric Sounding Interferometer (IASI)
-NPP Advanced Technology Microwave Sounder (ATMS)
-FY3 Microwave Temperature Sounder (MWTS) and Microwave Humidity Sounder (MWHS)
Updated features:
-Yellowstone compilation options: Specific compilation options for the new NCAR supercomputer
Yellowstone have been added.
-Updated I/O for improved back-compatability with previous versions of WRF and WRFDA
-WRFDA-3DVAR can now read two different PREPBUFR observation files at once
-The "ntmax" namelist variable is now a vector, and can be set to a different value for each
outer loop
-WRFPLUS has been upgraded to V3.5 and it is consistent with the released WRF version 3.5.
======================================
V3.4.1 Release Notes :
-------------------
Version 3.4.1 is released on August 16, 2012.
- For more information on WRFDA, visit the WRFDA Users home page
http://www2.mmm.ucar.edu/wrf/users/wrfda/index.html
- WRFDA registry files have been reconstructed.
Default namelist settings are now in registry.var file.
- WRFPLUS registry bug fixes related to mp_physics=9,10,13,14,16,17,18
======================================
V3.4 Release Notes :
-------------------
Version 3.4 is released on April 6, 2012.
- The WRFPLUS (WRF adjoint and tangent linear model) has been upgraded to V3.4 and it is consistent
with the released WRF version 3.4. Added parallel WRF TL/AD based on WRF 3.4.
- WRFDA 4D-Var now supports compilation to run in parallel.
- WRFDA 4D-Var now supports precipitation data (such as stage IV) assimilation.
- The ability to generate forecast sensitivity to observations has been updated.
- WRFDA Hybrid 3D-Var has been updated.
======================================
V3.3.1 Release Notes :
-------------------
Version 3.3.1 is released on September 27, 2011.
- WRF 4D-Var has been improved on lateral boundary condition control, analysis scheme for surface
observation etc.
- Lots of bug fixes.
======================================
V3.3 Release Notes:
-----------------------
Version 3.3 is released on April 6, 2011.
- RTTOV interfaces has been upgraded to version 10.0
Please download RTTOV v10.0 and install it in appropriate location
if you want to use RTTOV to assimilate radiance observation with bufr format
- crtm_atmosphere is removed from the namelist.
Now the CRTM reference climatology is determined inside WRFDA based on
latitude and month.
- New WRF 4D-Var
The WRFPLUS (WRF adjoint and tangent linear model) has been upgraded to V3.3
and it is consistent with the released WRFV version 3.3. However, only dry dynamic
processes are included in WRFPLUS version 3.3 and only serial run is supported
at this release.
WRFDA is also upgraded to consistent with WRFPLUS version 3.3 and the new 4D-Var
system is a single executable application. Please refer to Users' guide for the