<p><b>xinzhang</b> 2009-03-12 11:34:59 -0600 (Thu, 12 Mar 2009)</p><p>Update Chapter 6.<br>
</p><hr noshade><pre><font color="gray">Modified: trunk/wrf/UsersGuide/users_guide_chap6.doc
===================================================================
--- trunk/wrf/UsersGuide/users_guide_chap6.doc 2009-03-12 16:49:33 UTC (rev 139)
+++ trunk/wrf/UsersGuide/users_guide_chap6.doc 2009-03-12 17:34:59 UTC (rev 140)
@@ -1,9 +1,6 @@
-ࡱ
-
-
-
-
-
+ࡱ
+
+
@@ -22,8 +19,11 @@
-
-
+
+
+
+
Running WRF-Var requires a Fortran 90 compiler. We currently support the following platforms: IBM, SGI, PC/Linux, Cray-X1, and Apple. Please let us know if this does not meet your requirements, and we will attempt to add other machines to our list of supported architectures as resources allow. Although we are interested to hear of your experiences on modifying compile options, we do not yet recommend making changes to the configure file used to compile WRF-Var.
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.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, the necessary environment variables might be set with
-setenv BLAS /usr/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 wit!
h code c
ompiled 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.
+Before compiling the WRF-Var code, it is necessary to have installed the NetCDF, BLAS and LAPACK libraries. If any of the BLAS and LAPACK libraries are not available on the computer, they need to be installed first. The source code for these libraries can be freely downloaded from HYPERLINK "http://netlib.org/blas/" http://netlib.org/blas/ and HYPERLINK "http://netlib.org/lapack/" http://netlib.org/lapack/, Note: These external libraries can be compiled by using the scripts under WRFDA/var/scripts/compil
e_external. Assuming, for example, that these libraries have been installed in subdirectories of /usr/local, the necessary environment variables might be set with
+setenv BLAS /usr/local/blas setenv LAPACK /usr/local/lapack
+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. For BLAS, LAPACK and BUFR libraries compilation, please make sure they are all compiled with realsize = 8, which required by WRF-Var.
+If only conventional observational data from LITTLE_R format file was used, then NETCDF, BLAS and LAPACK libraries are mandatory. If you intend to use observational data with PREBUFR format, the BUFR library has to be installed too and can be downloaded from HYPERLINK "http://www.nco.ncep.noaa.gov/sib/decoders/BUFRLIB/" http://www.nco.ncep.noaa.gov/sib/decoders/BUFRLIB/. If you intend to assi
milate satellite radiance data, in addition to BUFR library,!
either
CRTM (V1.2) or RTTOV (8.7) have to be installed and can be downloaded from HYPERLINK "ftp://ftp.emc.ncep.noaa.gov/jcsda/CRTM/"ftp://ftp.emc.ncep.noaa.gov/jcsda/CRTM/ and HYPERLINK "http://www.metoffice.gov.uk/science/creating/working_together/nwpsaf_public.html" http://www.metoffice.gov.uk/science/creating/working_together/nwpsaf_public.html, the necessary environment variables might be set with
+setenv BUFR /usr/local/bufr
+setenv RTTOV /usr/local/rttov87 setenv CRTM /usr/local/crtm
+Assuming all required libraries are available, the WRF-Var Version 3.1 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 WRF
DA 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 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) compilation, distributed-memory parallel (dmpar) compilation. For example, on a Linux computer, the above steps look like:
@@ -98,15 +100,13 @@
Compile for nesting? (1=basic, 2=preset moves, 3=vortex following) [default 1]:
Configuration Successful. To build the model type compile.
-
-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.
Hint: It is helpful to start with something simple, such as the serial build. If it is succe
ssful, move on to build dmpar code. Remember to type clean a between each build.
To compile the code, type
> ./compile all_wrfvar
-Successful compilation of all_wrfvar will produce several executables in the var/da directory, including da_wrfvar.exe. You can list these executables by issuing the command (from WRFDA directory)
+Successful compilation of all_wrfvar will produce several executables in the var/da directory, including da_wrfvar.exe. 3dvar_obs.exe is also found in var/obsproc/src directory. You can list these executables by issuing the command (from WRFDA directory)
> ls -l var/da/*exe
-rwxr-xr-x 1 2450389 Jun 16 11:45 var/da/da_advance_time.exe
@@ -141,7 +141,7 @@
da_advance_time.exe is a very handy and useful tool for date manipulation. Type da_advance_time to see its usage instruction.
Executables for running WRF-Var and gen_be are created at this step. Proceed to the next section to learn how to build OBSPROC.
Running Observation Preprocessor (OBSPROC)
-The OBSPROC program reads observations in LITTLE_R format (a legendary ASCII format, in use since MM5 era). Please refer to the documentation at HYPERLINK "http://www.mmm.ucar.edu/mm5/mm5v3/data/how_to_get_rawdata.html" http://www.mmm.ucar.edu/mm5/mm5v3/data/how_to_get_rawdata.html for LITTLE_R format description. For this tutorial, an observation file in LITTLE_R format is provided. For your applications, you will have to prepare your own observation files. Please see HYPERLINK "http://www.mmm.ucar.edu/mm5/mm5v3/data/free_data.html" http://www.mmm.ucar.edu/mm5/mm5v3/data/free_data.html for the sources of some freely available observations and the
program for converting the observations to LITTLE_R format. If you have observations in other various format, a sample program (LITTLE_R/util/upa.f) for writing out data in LITTLE_R format can be obtained from HYPERLINK "ftp://ftp.ucar.edu/mesouser/MM5V3/V3-7-0/LITTLE_R.TAR.gz" ftp://ftp.ucar.edu/mesouser/MM5V3/V3-7-0/LITTLE_R.TAR.gz
+The OBSPROC program reads observations in LITTLE_R format (a legendary ASCII format, in use since MM5 era). Please refer to the documentation at HYPERLINK "http://www.mmm.ucar.edu/mm5/mm5v3/data/how_to_get_rawdata.html" http://www.mmm.ucar.edu/mm5/mm5v3/data/how_to_get_rawdata.html for LITTLE_R format description. For your applications, you will have to prepare your own observation files. Please see HYPERLINK "http://www.mmm.ucar.edu/mm5/mm5v3/data/free_data.html" http://www.mmm.ucar.edu/mm5/mm5v3/data/free_data.html for the sources of some freely available observations and the program for convert
ing the observations to LITTLE_R format. If you have observ!
ations i
n other various format, a sample program (LITTLE_R/util/upa.f) for writing out data in LITTLE_R format can be obtained from HYPERLINK "ftp://ftp.ucar.edu/mesouser/MM5V3/V3-7-0/LITTLE_R.TAR.gz" ftp://ftp.ucar.edu/mesouser/MM5V3/V3-7-0/LITTLE_R.TAR.gz
The basic operations performed by OBSPROC are:
Remove observations outside the time range and domain (horizontal and top).
Re-order and merge duplicate (in time and location) data reports.
@@ -150,9 +150,7 @@
Assign observational errors based on a pre-specified error file.
Write out the observation file to be used by WRF-Var in ASCII or BUFR format.
Plot the distribution of each observation type.
-The OBSPROC program is found under the directory WRFDA/var/obsproc. To compile the program, issue the following commands.
-> cd WRFDA/var/obsproc > make
-Once this is completed (a minute or less on most machines), you can check for the presence of the OBSPROC executable, src/3dvar_obs.exe
+The OBSPROC program3dvar_obs.exe is found under the directory WRFDA/var/obsproc/src if compile all_wrfvar was completed successfully.
Before running 3dvar_obs.exe, create the required namelist file namelist.3dvar_obs (see WRFDA/var/obsproc/README.namelist, or the section HYPERLINK \l "_Description_of_Namelist_1" Description of Namelist Variables for details).
For your reference, an example file named namelist_3dvar_obs.wrfvar-tut has already been created in the
var/obsproc directory. Thus, proceed as follows.
> cp namelist.3dvar_obs.wrfvar-tut namelist.3dvar_obs
@@ -724,10 +722,10 @@
-WRF-ARW V3: Users Guide 6- PAGE 8
+WRF-ARW V3: Users Guide 6- PAGE 10
-WRF-ARW V3: Users Guide 6- PAGE 1
+WRF-ARW V3: Users Guide 6- PAGE 9
@@ -748,1644 +746,1609 @@
-
-hxA;
-
+hCUe
+
-&
+&
+
&
-&
-Px 4 #\'*.25@9
xA;
-&
-A
-v
-v
-
-hxA;
+Px 4 #\'*.25@9
+
+)
+9
+7
+&
+A
+v
+v
+P
+
+P
+hCUe
l
-l
+l
l
-l
+l
l
-l
+l
l
-l
-hxA;
+hCUe
+_
+`
+
x
-
-hxA;
+`tgdCUe
+
~
+
+hCUe
#
l
-&
-
-hxA;
+
+&
+hCUe
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
-hxA;
+
+hCUe
#
-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
-hxA;
+l
+hCUe
#
-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
-
-hxA;
+l
+hCUe
#
-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
-
-hxA;
+l
+hCUe
#
-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
-
-hxA;
+l
+hCUe
#
-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
-hxA;
+l
+hCUe
#
-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
-hxA;
+l
+
+hCUe
#
-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
-
-hxA;
+
+hCUe
#
-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
-hxA;
+l
+
+hCUe
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
-hxA;
+l
+hCUe
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
-
-hxA;
+l
+hCUe
#
-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
-hxA;
-hxA;
+
+hCUe
+hCUe
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
-
-
-hxA;
+l
+
+
+hCUe
#
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
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
-hxA;
+
+hCUe
+
+
#
-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
-
-hxA;
+
+hCUe
#
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
-hxA;
+l
+hCUe
#
-l
+l
#
l
+
#
l
+
#
l
+
#
-l
+l
#
-l
+l
#
l
+
#
l
+
)].w
@@ -2596,9 +2559,9 @@
eԳw@3]#;b69ώ
=Lw(
-cl t0*V*z2 uq*L2U垧JL
+cl t0*V*z2 uq*L2U垧JL
w
-
+
@@ -2992,7 +2955,7 @@
l
-
+
Ts+--moo}3gvVuرCwU+WJ0 <x+jy hMt|dOYfu(1&܅eee/Ic|fJJJ筍?AJ:3f#+_[uջwﮩ"EIG싋WU=4
-
+
4H wPs,y'Ђo]:!FN"0آbn;B1vZG܂ h O_~C{QNS (:-:?yN#
-
+
-
+
@@ -5081,7 +5044,7 @@
/
-?b
+?b
/
?bPNG
@@ -6647,7 +6610,7 @@
䣀" R@
H)Q@QL@u@u@u@u@u@u:HnMu@u@u@u@u`U ]B
-
+
@@ -9333,7 +9296,7 @@
-
+
& F^
l
@@ -9373,7 +9336,7 @@
YU
+
-
-
-
-
+
+
+
+
+
ư
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+#
+1
+J
+Y
+Z
+y
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
ʀ
0
0
`
к
h[
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+#
+1
+J
+Y
+Z
+y
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
0
0
-
-
-
-
-
-
-
-
-
+
0
@
0
+
+
+
+
-
-;
+
-
-
+
-$
-
-
-
-
-
-
+
+1
+M
+r
+x
+
+
+
+
+
-
-
-a
-
-
-
-
-
+1
+@
+
+
+
+
+
+
+
+
+
+
+
+
l,6
(VP
)
+-tta
^Zp;sZ+8
@@ -9897,7 +9842,7 @@
-
+
@@ -10149,9 +10094,9 @@
-
+
^Z
-^Z
+^Z
@@ -10159,64 +10104,57 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+`GT^5bBJ>*N
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
+
+
-
-wwo~wo~o~ww
=Ns^Vo{Ns^Vg9RVZkZVZkZ^ZcF1^ZcZZg9kZZkZZ^VNsg9kZRVc^ZVco{o{kZRkZJRc^ZR^g9VZ^Vg9R^VkZNsR
+
+
+wwo~wo~o~ww
ZkZVZkZ^ZcF1^ZcZZg9kZZkZZ^VNsg9kZRVc^ZVco{o{kZRkZJRc^ZR^g9VZ^Vg9R^VkZNsR
RZg9kZ^ZRNswZNsVZRcwkZRNskZJR^ckZZg9s^VkZVZRs
swo{wo{o{ww
wwwww
-
+
+
-
+
+P
+
+
@@ -10359,9 +10297,9 @@
-
-
-
+
+
+
@@ -10370,17 +10308,20 @@
-
-
-
+
+
+
-
-
+
+
+
+
+
-
-
-
\ No newline at end of file
+
+
+
\ No newline at end of file
</font>
</pre>