| 1 | WRF Model Version 2.2 (December 2006) |
|---|
| 2 | http://www.mmm.ucar.edu/wrf/users/ |
|---|
| 3 | |
|---|
| 4 | ------------------------ |
|---|
| 5 | WRF PUBLIC DOMAIN NOTICE |
|---|
| 6 | ------------------------ |
|---|
| 7 | |
|---|
| 8 | WRF was developed at the National Center for Atmospheric Research |
|---|
| 9 | (NCAR) which is operated by the University Corporation for |
|---|
| 10 | Atmospheric Research (UCAR). NCAR and UCAR make no proprietary |
|---|
| 11 | claims, either statutory or otherwise, to this version and |
|---|
| 12 | release of WRF and consider WRF to be in the public domain for |
|---|
| 13 | use by any person or entity for any purpose without any fee or |
|---|
| 14 | charge. UCAR requests that any WRF user include this notice on |
|---|
| 15 | any partial or full copies of WRF. WRF is provided on an "AS |
|---|
| 16 | IS" basis and any warranties, either express or implied, |
|---|
| 17 | including but not limited to implied warranties of |
|---|
| 18 | non-infringement, originality, merchantability and fitness for a |
|---|
| 19 | particular purpose, are disclaimed. In no event shall |
|---|
| 20 | UCAR be liable for any damages, whatsoever, whether direct, |
|---|
| 21 | indirect, consequential or special, that arise out of or in |
|---|
| 22 | connection with the access, use or performance of WRF, including |
|---|
| 23 | infringement actions. |
|---|
| 24 | |
|---|
| 25 | |
|---|
| 26 | ====================================== |
|---|
| 27 | This is the main directory for the WRF Version 2 source code release. |
|---|
| 28 | ====================================== |
|---|
| 29 | |
|---|
| 30 | V2.2 Release Notes: |
|---|
| 31 | ------------------ |
|---|
| 32 | |
|---|
| 33 | - For directions on compiling WRF, see below or Users Web page. |
|---|
| 34 | - For more information on WRF V2.2 release, visit WRF Users home page |
|---|
| 35 | http://www.mmm.ucar.edu/wrf/users/ |
|---|
| 36 | - WRF V2.2 works with both WPS (new WRF Preprocessing System) and SI. |
|---|
| 37 | Please see User' Guide for WPS. |
|---|
| 38 | - WRF V2.2 executable works with wrfinput/wrfbdy produced by previous version, |
|---|
| 39 | but pre-V2.2 WRF will NOT work with V2.2 wrfinput/wrfbdy files. |
|---|
| 40 | - WRF V2.2's namelist has new additions. Edit with caution. |
|---|
| 41 | |
|---|
| 42 | For questions, send mail to wrfhelp@ucar.edu |
|---|
| 43 | |
|---|
| 44 | ====================================== |
|---|
| 45 | |
|---|
| 46 | V2.1 Release Notes: |
|---|
| 47 | ------------------ |
|---|
| 48 | |
|---|
| 49 | - For directions on compiling WRF, see below or Users Web page. |
|---|
| 50 | - For more information on WRF V2.1 release, visit WRF Users home page |
|---|
| 51 | http://www.mmm.ucar.edu/wrf/users/ |
|---|
| 52 | - Use WRFSI 2.0.3 or 2.1 (http://wrfsi.noaa.gov) for real-data preparation. |
|---|
| 53 | - Must rerun real.exe to generate new wrfbdy_d01/wrfinput_d01 for wrf.exe. |
|---|
| 54 | - WRF V2.1's namelist has some changes from 2.0.3.1. Edit with caution. |
|---|
| 55 | - Need to have gribmap.txt in your run directory. |
|---|
| 56 | |
|---|
| 57 | ====================================== |
|---|
| 58 | |
|---|
| 59 | V2 update history: |
|---|
| 60 | |
|---|
| 61 | - V2.0.1: May 21, 2004 |
|---|
| 62 | - V2.0.2: June 3, 2004 |
|---|
| 63 | - V2.0.3: Nov 12, 2004 |
|---|
| 64 | V2.0.3.1: Dec 3, 2004 |
|---|
| 65 | - V2.1: August 4, 2005 |
|---|
| 66 | - V2.1.1: Nov 8, 2005 |
|---|
| 67 | - V2.1.2: Jan 27, 2006 |
|---|
| 68 | - V2.2: Dec 21, 2006 |
|---|
| 69 | |
|---|
| 70 | ====================================== |
|---|
| 71 | |
|---|
| 72 | How to compile and run? |
|---|
| 73 | ----------------------- |
|---|
| 74 | |
|---|
| 75 | - In WRFV2 directory, type 'configure' - this will create a configure.wrf |
|---|
| 76 | file that has appropriate compile options for the supported computers. |
|---|
| 77 | |
|---|
| 78 | Note: WRF requires netCDF library. If your netCDF library is installed in |
|---|
| 79 | some odd directory, set environment variable NETCDF before you type |
|---|
| 80 | 'configure'. For example, |
|---|
| 81 | |
|---|
| 82 | setenv NETCDF /usr/local/lib32/r4i4 |
|---|
| 83 | |
|---|
| 84 | - Type 'compile case_name' where you can find the case_names by simply typing |
|---|
| 85 | compile. The following are available: |
|---|
| 86 | |
|---|
| 87 | compile em_b_wave |
|---|
| 88 | compile em_hill2d_x |
|---|
| 89 | compile em_grav2d_x |
|---|
| 90 | compile em_quarter_ss |
|---|
| 91 | compile em_real |
|---|
| 92 | compile em_squall2d_x |
|---|
| 93 | compile em_squall2d_y |
|---|
| 94 | |
|---|
| 95 | - If sucessfully, this will create either real.exe or ideal.exe and wrf.exe |
|---|
| 96 | in directory main/, and the appropriate executables will be linked into |
|---|
| 97 | the test directoires under test/case_name, or run/. |
|---|
| 98 | |
|---|
| 99 | - cd to the appropriate test or run direcotry to run ideal/real/wrf. |
|---|
| 100 | |
|---|
| 101 | - If it is one of the idealized cases (b_wave, hill2d_x, grav2d_x, quarter_ss, |
|---|
| 102 | squall2d_x or squall2d_y), cd the the appropriate directory, type |
|---|
| 103 | |
|---|
| 104 | ideal.exe |
|---|
| 105 | |
|---|
| 106 | to produce wrfinput_d01 file for wrf model. Then type |
|---|
| 107 | |
|---|
| 108 | wrf.exe |
|---|
| 109 | |
|---|
| 110 | to run. |
|---|
| 111 | |
|---|
| 112 | - If it is real-data case (real), place files from SI (wrf_real_input_em.*) |
|---|
| 113 | in the appropriate directory, type |
|---|
| 114 | |
|---|
| 115 | real.exe |
|---|
| 116 | |
|---|
| 117 | to produce wrfbdy_d01 and wrfinput_d01. Then type |
|---|
| 118 | |
|---|
| 119 | wrf.exe |
|---|
| 120 | |
|---|
| 121 | to run. |
|---|
| 122 | |
|---|
| 123 | - If you use mpich, type |
|---|
| 124 | |
|---|
| 125 | mpirun -np number-of-processors wrf.exe |
|---|
| 126 | |
|---|
| 127 | - For information on how to make nested runs, visit |
|---|
| 128 | http://www.mmm.ucar.edu/wrf/users/ |
|---|
| 129 | |
|---|
| 130 | |
|---|
| 131 | ====================================== |
|---|
| 132 | |
|---|
| 133 | What is in WRF V2? |
|---|
| 134 | |
|---|
| 135 | - Advanced Research WRF (ARW) solver: Eulerian mass, hydrostatic and non-hydrostatic |
|---|
| 136 | * Arakawa C-grid staggering |
|---|
| 137 | * Runge-Kutta 2nd and 3rd order timestep options |
|---|
| 138 | * scalar-conserving flux form for prognostic variables |
|---|
| 139 | * 2nd to 6th order advection options (horizontal and vertical) |
|---|
| 140 | * time-split small step for acoustic modes |
|---|
| 141 | * small step horizontally explicit, vertically implicit |
|---|
| 142 | * divergence damping option and vertical time off-centering |
|---|
| 143 | * external-mode filtering option for mass model |
|---|
| 144 | * hydrostatic option via namelist option |
|---|
| 145 | * positive-definite advection for moisture, scalar, tke and chemical tracers (since 2.2) |
|---|
| 146 | |
|---|
| 147 | - Two-way nesting: |
|---|
| 148 | * multiple domains and multiple nest levels |
|---|
| 149 | * supports integer nest grid ratio |
|---|
| 150 | * feedback option for both odd and even nest grid ratios (since 2.0.3) |
|---|
| 151 | * smoothing options |
|---|
| 152 | |
|---|
| 153 | - One-way nesting (since 2.0.2) |
|---|
| 154 | |
|---|
| 155 | - Moving nest (since 2.1) |
|---|
| 156 | * Specified move. |
|---|
| 157 | * Automatic move using a mid-level vortex-following algorithm. |
|---|
| 158 | |
|---|
| 159 | - Physics options: |
|---|
| 160 | * microphysics (Kessler/ WRF Single Moment 3, 5 and 6 class / Lin et al./ |
|---|
| 161 | Eta Ferrier / Thompson [a new version in 2.2]) |
|---|
| 162 | * cumulus parameterization (Kain-Fritsch with shallow convection / |
|---|
| 163 | Betts-Miller-Janjic / Grell-Devenyi ensemble) |
|---|
| 164 | * planetary boundary layer (Yosei University (S. Korea) / Mellor-Yamada-Janjic) |
|---|
| 165 | * surface layer (similarity theory MM5 / Eta) |
|---|
| 166 | * slab soil model (5-layer thermal diffusion / Noah land-surface model (4-level) / |
|---|
| 167 | RUC LSM (6-level) ) |
|---|
| 168 | * Urban canopy model (works with Noah LSM) (since 2.2) |
|---|
| 169 | * longwave radiation (RRTM, CAM) |
|---|
| 170 | * shortwave radiation (simple MM5 scheme / Goddard / CAM) |
|---|
| 171 | * sub-grid turbulence (constant K diffusion/ 2-D Smagorinsky/ predicted TKE / |
|---|
| 172 | 2-D, 6th order diffusion) |
|---|
| 173 | * land-use categories determine surface properties |
|---|
| 174 | * three-dimensional analysis nudging (since 2.2) |
|---|
| 175 | * observation nudging (since 2.2) |
|---|
| 176 | |
|---|
| 177 | - Software |
|---|
| 178 | |
|---|
| 179 | * Hierarchical software architecture that insulates scientific code |
|---|
| 180 | (Model Layer) from computer architecture (Driver Layer) |
|---|
| 181 | * Multi-level parallelism supporting shared-memory (OpenMP), distributed-memory (MPI), |
|---|
| 182 | and hybrid share/distributed modes of execution |
|---|
| 183 | * Active data registry: defines and manages model state fields, I/O, |
|---|
| 184 | nesting, configuration, and numerous other aspects of WRF through a single file, |
|---|
| 185 | called the Registry |
|---|
| 186 | * Two-way nesting: |
|---|
| 187 | Easy to extend: forcing and feedback of new fields specified by |
|---|
| 188 | editing a single table in the Registry |
|---|
| 189 | Efficient: 5-8% overhead on 64 processes of IBM |
|---|
| 190 | Moving nests. |
|---|
| 191 | * Enhanced I/O options: |
|---|
| 192 | NetCDF and Parallel HDF5 formats |
|---|
| 193 | Five auxiliary history output streams separately controllable through the namelist |
|---|
| 194 | Output file names and time-stamps specifiable through namelist |
|---|
| 195 | Special output stream for 3DVAR |
|---|
| 196 | * Efficient execution on a range of computing platforms: |
|---|
| 197 | IBM SP systems, (e.g. NCAR "bluesky" Power4-based system) |
|---|
| 198 | HP/Compaq Alpha/OSF workstation, SMP, and MPP systems (e.g. Pittsburgh |
|---|
| 199 | Supercomputing Center TCS) |
|---|
| 200 | SGI Origin and Altix |
|---|
| 201 | Linux/Intel |
|---|
| 202 | IA64 MPP (HP Superdome, SGI Altix, NCSA Teragrid systems) |
|---|
| 203 | IA64 SMP |
|---|
| 204 | Pentium 3/4 SMP and SMP clusters (NOAA/FSL iJet system) |
|---|
| 205 | PGI and Intel compilers supported |
|---|
| 206 | Alpha Linux (NOAA/FSL Jet system) |
|---|
| 207 | Sun Solaris (single threaded and SMP) |
|---|
| 208 | Cray X1, X1e (vector), X1D (Opteron) |
|---|
| 209 | Mac G5, xlf compiler (no DM-parallel yet) |
|---|
| 210 | HP-UX |
|---|
| 211 | Other ports under development: |
|---|
| 212 | NEC SX/6 |
|---|
| 213 | Fujitsu VPP 5000 |
|---|
| 214 | * RSL_LITE: optional new communication layer, scalable to very |
|---|
| 215 | large domains, support nesting. |
|---|
| 216 | * ESMF Time Management, including exact arithmetic for fractional |
|---|
| 217 | time steps (no drift). |
|---|
| 218 | * ESMF integration - WRF can be run as an ESMF component. |
|---|
| 219 | * Improved documentation, both on-line (web based browsing tools) and in-line |
|---|
