<p><b>xinzhang</b> 2008-09-05 10:32:19 -0600 (Fri, 05 Sep 2008)</p><p>Update the Users' guide chap2&6 based on the latest release (v3.0.1.1) and users' feedback!<br>
</p><hr noshade><pre><font color="gray">Modified: trunk/wrf/UsersGuide/users_guide_chap2.doc
===================================================================
(Binary files differ)
Modified: trunk/wrf/UsersGuide/users_guide_chap6.doc
===================================================================
--- trunk/wrf/UsersGuide/users_guide_chap6.doc 2008-08-04 15:46:30 UTC (rev 119)
+++ trunk/wrf/UsersGuide/users_guide_chap6.doc 2008-09-05 16:32:19 UTC (rev 120)
@@ -1,6 +1,10 @@
-ࡱ
-
-
+ࡱ
+
+
+
+
+
+
@@ -18,14 +22,8 @@
-
-
-
-
-
-
-
-
+
Installing WRF-Var
Because WRF-Var codes utilize some features of MPI-2, so if you would like to run WRF-Var with multiple processors, please make sure your MPI compilers are MPI-2 compatible. Otherwise, you can download MPICH2 from HYPERLINK "http://www.mcs.anl.gov/research/projects/mpich2/" http://www.mcs.anl.gov/research/projects/mpich2/, install the MPICH2 in appropriate location and use the installed MPI compiler.
-Before compiling the WRF-Var code, it is necessary to have installed the NetCDF, BLAS, LAPACK, and BUFR libraries. If any of the BLAS, LAPACK and BUFR libraries are not available on the computer, they needs to be installed first. The source code for these libraries can be freely downloaded from HYPERLINK "http://netlib.org/blas/" http://netlib.org/blas/, HYPERLINK "http://netlib.org/lapack/" http://netlib.org/lapack/, and HYPERLINK "http://www.nco.ncep.noaa.gov/sib/decoders/BUFRLIB/" http://www.n!
co.ncep.noaa.gov/sib/decoders/BUFRLIB/. Assuming, for example, that these libraries have been installed in subdirectories of /usr/local, the necessary environment variables might be set with
+Before compiling the WRF-Var code, it is necessary to have installed the NetCDF, BLAS, LAPACK, and BUFR libraries. If any of the BLAS, LAPACK and BUFR libraries are not available on the computer, they needs to be installed first. The source code for these libraries can be freely downloaded from HYPERLINK "http://netlib.org/blas/" http://netlib.org/blas/, HYPERLINK "http://netlib.org/lapack/" http://netlib.org/lapack/, and HYPERLINK "http://www.nco.ncep.noaa.gov/sib/decoders/BUFRLIB/" http://www.nco.ncep.noaa.gov/sib/decoders/BUFRLIB/. Note: These external libraries can be compiled by using the scripts under WRFDA/var/scripts/compile_external. Assuming, for example, that these libraries have been installed in subdirectories of /usr/local, th!
e necessary environment variables might be set with
setenv BL!
AS /us
r/local/blas setenv LAPACK /usr/local/lapack setenv BUFR /usr/local/bufr
Hint: Make sure the required libraries were all compiled using the same compiler that will be used to build WRF-Var, since the libraries produced by one compiler may not be compatible with code compiled with another.
Assuming all required libraries are available, the WRF-Var Version 3 source code can be downloaded from HYPERLINK "http://www.mmm.ucar.edu/wrf/users/download/get_source.html" http://www.mmm.ucar.edu/wrf/users/download/get_source.html. After the tar file is unzipped (gunzip WRFDAV3.TAR.gz) and untarred (untar WRFDAV3.TAR), the directory WRFDA should be created; this directory contains the WRF-Var source code.
To configure WRF-Var, change to the WRFDA directory and type
> ./configure wrfda
-A list of configuration options for your computer should appear. Each option combines a compiler type and a parallelism option; since the configuration script doesnt check which co!
mpilers are actually available, be sure to only select among the options for compilers that are available on your system. The parallelism option allows for a single-processor (serial) compilation, shared-memory parallel (smpar) compilation, distributed-memory parallel (dmpar) compilation, or a combination of shared-memory and distributed-memory parallel (dm+sm) compilation; for WRF-Var, parallel execution requires a dm option (see note below). After a selection from the list of options is made, a second choice for compiling nesting will appear. For example, on a Linux computer, the above steps look like:
+A list of configuration options for your computer should appear. Each option combines a compiler type and a parallelism option; since the configuration script doesnt check which compilers are actually available, be sure to only select among the options for compilers that are available on your system. The parallelism option allows for a single-processor (serial) compila!
tion, distributed-memory parallel (dmpar) compilation. For exa!
mple, on
a Linux computer, the above steps look like:
> ./configure wrfda
checking for perl5... no
checking for perl... found /usr/bin/perl (perl)
@@ -80,36 +78,28 @@
Please select from among the following supported platforms.
1. Linux x86_64, PGI compiler with gcc (serial)
- 2. Linux x86_64, PGI compiler with gcc (smpar)
- 3. Linux x86_64, PGI compiler with gcc (dmpar)
- 4. Linux x86_64, PGI compiler with gcc (dm+sm)
- 5. Linux x86_64 i486 i586 i686, ifort compiler with icc (serial)
- 6. Linux x86_64 i486 i586 i686, ifort compiler with icc (smpar)
- 7. Linux x86_64 i486 i586 i686, ifort compiler with icc (dmpar)
- 8. Linux x86_64 i486 i586 i686, ifort compiler with icc (dm+sm)
- 9. Linux i486 i586 i686 x86_64, PathScale compiler with pathcc (serial)
- 10. Linux i486 i586 i686 x86_64, PathScale compiler with pathcc (dmpar)
- 11. x86_64 Linux, gfortran compiler with gcc (serial)
- 12. x86_64 Linux, gfortran compiler with gcc (smpar)
- 13. x86_64 Linux, gfortran compiler with gcc (dmpar)
- 14. x86_64 Linux, gfortran compiler with gcc (dm+sm)
- 15. Cray XT Catamount/Linux x86_64, !
PGI compiler with gcc (serial)
- 16. Cray XT Catamount/Linux x86_64, PGI compiler with gcc (dmpar)
- 17. Cray XT CNL/Linux x86_64, PGI compiler with gcc (serial)
- 18. Cray XT CNL/Linux x86_64, PGI compiler with gcc (smpar)
- 19. Cray XT CNL/Linux x86_64, PGI compiler with gcc (dmpar)
- 20. Cray XT CNL/Linux x86_64, PGI compiler with gcc (dm+sm)
- 21. Cray XT CNL/Linux x86_64, Pathscale compiler with gcc (serial)
- 22. Cray XT CNL/Linux x86_64, Pathscale compiler with gcc (smpar)
- 23. Cray XT CNL/Linux x86_64, Pathscale compiler with gcc (dmpar)
- 24. Cray XT CNL/Linux x86_64, Pathscale compiler with gcc (dm+sm)
+ 2. Linux x86_64, PGI compiler with gcc (dmpar)
+ 3. Linux x86_64 i486 i586 i686, ifort compiler with icc (serial)
+ 4. Linux x86_64 i486 i586 i686, ifort compiler with icc (dmpar)
+ 5. Linux i486 i586 i686 x86_64, PathScale compiler with pathcc (serial)
+ 6. Linux i486 i586 i686 x86_64, PathScale compiler with pathcc!
(dmpar)
+ 7. x86_64 Linux, gfortran compiler with gcc (!
serial)
+ 8. x86_64 Linux, gfortran compiler with gcc (dmpar)
+ 9. Cray XT Catamount/Linux x86_64, PGI compiler with gcc (serial)
+ 10. Cray XT Catamount/Linux x86_64, PGI compiler with gcc (dmpar)
+ 11. Cray XT CNL/Linux x86_64, PGI compiler with gcc (serial)
+ 12. Cray XT CNL/Linux x86_64, PGI compiler with gcc (dmpar)
+ 13. Cray XT CNL/Linux x86_64, Pathscale compiler with gcc (serial)
+ 14. Cray XT CNL/Linux x86_64, Pathscale compiler with gcc (dmpar)
+
-Enter selection [1-24] : 3
+Enter selection [1-14] : 2
------------------------------------------------------------------------
-Compile for nesting? (1=basic, 2=preset moves, 3=vortex following) [default 1]: 1
+Compile for nesting? (1=basic, 2=preset moves, 3=vortex following) [default 1]:
+Configuration Successful. To build the model type compile.
+
-Note: The WRF-Var system does not make usre of OpenMP, so shared memory (smpar) options do not apply to WRF-Var; parallel execution is only suppo!
rted through distributed memory (dmpar) options.
-Note: Nesting does not apply to WRF-Var, please select 1=basic.
+Note: At this moment, gfortran can not be used to compile WRFDA!
After running the configure script and choosing a compilation and nesting option, a configure.wrf file will be created. Because of the variety of ways that a computer can be configured, if the WRF-Var build ultimately fails, there is a chance that minor modifications to the configure.wrf file may be needed.
If you have compiled WRF code, you may notice the build mechanism of WRF and WRFDA looks very similar. This is because WRF and WRFDA share the same build mechanism. But caution needs to be paid when compiling WRFDA.
Note: WRF compiles with r4 option while WRFDA compiles with r8. For this reason, WRF and WRFDA cannot reside and be compiled under the same directory.
@@ -734,10 +724,10 @@
-WRF-ARW V3: Users Guide 6- PAGE 46
+WRF-ARW V3: Users Guide 6- PAGE 4
-WRF-ARW V3: Users Guide 6- PAGE 1
+WRF-ARW V3: Users Guide 6- PAGE 5
@@ -758,1304 +748,1297 @@
-
-hm
-
+h]\
+
-&
+&
+
&
-&
-Px 4 #\'*.25@9
-&
->
-&
-v
-v
-
-hm
+Px 4 #\'*.25@9
]\
+&
+v
+v
+
+h]\
l
-l
+l
l
-l
+l
l
-l
+l
l
-l
-\
-b
-hm
-h
<font color="gray">
+s
+h]\
+s
+
+
+
+
-hm
+`tgd]\
+
\
+h]\
#
l
-&
-hm
+
+&
+h]\
l
-
+
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
l
+
#
-l
+l
#
l
-hm
+
+h]\
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
l
+
#
-l
+l
#
l
+
#
-l
+l
l
+
#
-l
+l
#
l
+
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
-hm
+l
+h]\
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
-hm
+l
+h]\
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
l
+
#
-l
+l
#
-l
+l
#
-l
-hm
+l
+
+h]\
#
-l
+l
+
#
-l
+l
+
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
-hm
+l
+h]\
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
l
+
#
-l
+l
#
l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
l
+
#
-l
+l
#
l
+
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
-hm
+l
+h]\
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
l
+
#
-l
+l
#
l
+
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
-hm
+l
+h]\
#
-l
+l
#
-l
+l
l
+
#
-l
+l
#
l
+
#
-l
+l
#
-l
+l
l
+
#
-l
+l
+
#
l
+
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
l
+
#
-l
+l
#
l
+
l
-
-hm
+
+h]\
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
l
+
#
-l
+l
d#
l
+
d#
-l
+l
d#
-l
+l
d#
-l
+l
d#
-l
+l
d#
-l
-hm
+l
+h]\
d#
-l
+l
d#
-l
+l
d#
-l
+l
d#
-l
+l
d#
-l
+l
d#
-l
+l
d#
-l
+l
d#
-l
+l
d#
-l
+l
d#
-l
+l
d#
-l
+l
d#
-l
+l
d#
-l
+l
d#
-l
+l
d#
-l
+l
+
d#
-l
+l
d#
-l
+l
d#
-l
+l
d#
-l
+l
d#
-l
+l
d#
-l
+l
d#
-l
+l
d#
-l
+l
d#
-l
+l
d#
-l
+l
d#
-l
+l
d#
-l
-hm
+l
+
+h]\
d#
-l
+l
d#
-l
+l
d#
-l
+l
d#
-l
+l
d#
-l
+l
d#
-l
+l
d#
-l
+l
d#
-l
+l
+
d#
-l
+l
d#
-l
+l
d#
-l
+l
d#
-l
+l
d#
-l
+l
d#
-l
+l
l
+
d#
-l
+l
#
l
+
#
-l
+l
#
-l
-
-hm
+l
+
+h]\
#
-l
-
+l
#
-l
+l
l
+
#
-l
+l
#
l
+
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
+
l
+
#
-l
+l
l
#
l
+
l
#
l
+
#
l
-9
+
+
#
l
+
l
-
-
+
l
-hm
-hm
+
+h]\
+h]\
l
+
#
-l
+l
l
#
l
+
#
l
+
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
+l
#
-l
-&
+l
+&
#
-l
+l
l
+
#
-l
+l
#
l
+
#
-l
+l
#
l
+
l
+
#
-l
-
-
-
-
-
-
-
-hm
+l
+
+h]\
#
l
+
#
-l
+l
+
l
#
l
#
l
+
#
-l
+l
#
l
l
+
#
l
+
#
-l
+l
#
l
#
l
+
#
l
+
#
l
+
#
-l
+l
#
l
l
-
#
l
+
#
-l
-
-
-
-
-
-
+l
#
l
#
l
-
-
+
#
l
+
#
l
+
#
-l
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-hm
+
+h]\
#
l
#
l
+
l
#
l
+
#
l
+
#
-l
+
+
+
+
#
@@ -2144,38 +2130,53 @@
#
l
+
+
+
+
+
+
+
#
l
+
+
+
+
+
+
+
#
l
+
#
-l
+l
+
+
+
+
#
l
#
l
+
#
l
+
#
l
+
#
-l
-
+l
+
#
l
@@ -2183,185 +2184,206 @@
#
l
-
+
l
#
l
+
#
l
+
#
-l
+l
#
l
#
l
+
#
l
+
#
l
+
#
-l
+l
#
l
#
l
-hm
+
+h]\
#
l
+
#
l
+
#
-l
+l
#
l
#
l
+
#
l
+
#
l
+
#
-l
+l
#
l
#
l
+
#
l
+
#
l
+
#
-l
+l
#
l
#
l
+
#
l
+
#
l
+
#
-l
+l
#
l
#
l
+
#
l
+
#
l
+
#
-l
+l
#
l
#
l
+
#
l
+
#
l
+
#
-l
-hm
+l
+h]\
#
l
#
l
+
#
l
+
#
l
+
#
-l
+l
#
l
#
l
+
#
l
+
)].w
@@ -9349,7 +9371,7 @@
YU
+
-
-
-
+
+
+
+
+
+
+
ư
-
-b
-
-
-
-
-
-
+
+m
+
+
+
+
+
+
+
+
+
+
+
-
-
-
-
-
-
-
ʀ
0
+
+
+
0
ʠ
0
-b
-
-
-
-
-
-
+
+m
+
+
+
+
+
+
+
+
+
+
+
-
-
-
-
-
-
-
0
0
-
-
-
+
+
+
+
̀
0
+
+
+
+
+
+
-
+
-
+
-
-!
-s
-
-
u
-
-
-
-
-
-
-
-
-!
-F
-
-
-
-
-
-
-
-
-
-
+$
+G
+m
+w
+y
+~
+
o
+
+
+
+
+
+
+a
+c
+m
+
+
+
+
+
+
+
l,6
-
+
^Z
-^Z
+^Z
@@ -10101,67 +10163,67 @@
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
-
-
-
-
-
-
-
-
+
+
+
+
+
-
-wwo~wo~o~ww
ZkZVZkZ^ZcF1^ZcZZg9kZZkZZ^VNsg9kZRVc^ZVco{o{kZRkZJRc^ZR^g9VZ^Vg9R^VkZNsR
+
+
+{{w{ww{{
RVZkZVZkZ^ZcF1^ZcZZg9kZZkZZ^VNsg9kZRVc^ZVco{o{kZRkZJRc^ZR^g9VZ^Vg9R^VkZNsR
RZg9kZ^ZRNswZNsVZRcwkZRNskZJR^ckZZg9s^VkZVZRs
swo{wo{o{ww
wwwww
+
-
+
+
+
+
@@ -10300,32 +10362,28 @@
-
-
+
-
+
+
-
-
+
-
+
+
-
-
-
-
-
-
+
+
-
-
-
\ No newline at end of file
+
+
+
\ No newline at end of file
</font>
</pre>