<p><b>kavulich@ucar.edu</b> 2014-08-05 18:29:47 -0600 (Tue, 05 Aug 2014)</p><p>Updating Chapter 6 with correct info about BUFR, CRTM, and RTTOV libraries. BUFR is automatically compiled, CRTM is not anymore. RTTOV must be compiled with the "emis_atlas" option.<br>
</p><hr noshade><pre><font color="gray">Modified: trunk/wrf/UsersGuide/Chapter_6.tex
===================================================================
--- trunk/wrf/UsersGuide/Chapter_6.tex        2014-07-19 07:59:40 UTC (rev 505)
+++ trunk/wrf/UsersGuide/Chapter_6.tex        2014-08-06 00:29:47 UTC (rev 506)
@@ -127,7 +127,7 @@
\subsection{WRFDA--3DVAR}
\label{install-wrfda-3dvar}
-Some external libraries (\eg LAPACK, BLAS, and NCEP BUFR) are included in the WRFDA tar file. To compile the WRFDA code, the only mandatory library is the netCDF library. You should set an environment variable NETCDF to point to the directory where your netCDF library is installed
+Some external libraries (\eg LAPACK, BLAS, NCEP BUFR, and CRTM) are included in the WRFDA tar file. To compile the WRFDA code, the only mandatory library is the netCDF library. You should set an environment variable NETCDF to point to the directory where your netCDF library is installed
\small\begin{verbatim}
> setenv NETCDF your_netcdf_path
@@ -140,7 +140,7 @@
\begin{itemize}
\item Make sure the required libraries were all compiled using the same compiler that will be used to build WRFDA, since the libraries produced by one compiler may not be compatible with code compiled with another.
-\item If you will eventually want to assimilate radiance data using RTTOV, you will need to set the \texttt{RTTOV} environment variable. See the section on \hyperref[wrfda-rtm]{radiative transfer models} for instructions.
+\item If you will eventually want to assimilate radiance data, you will need to set the appropriate environment variable for your preferred radiative transfer model (RTM). See the section on \hyperref[wrfda-rtm-compile]{radiative transfer models} for instructions.
\end{itemize}
Assuming all required libraries are available and the WRFDA source code is ready, you can start to build WRFDA using the following steps:
@@ -293,7 +293,7 @@
\texttt{obsproc.exe} is the executable for preparing conventional observations for assimilation by WRFDA.
-If you specified that BUFR or CRTM libraries were needed, check \texttt{\$WRFDA\_DIR/var/external/bufr} and \texttt{\$WRFDA\_DIR/var/external/crtm/libsrc} to ensure \texttt{libbufr.a} and \texttt{libCRTM.a} were generated.
+If you specified that the CRTM library was needed, check \texttt{\$WRFDA\_DIR/var/external/crtm\_2.1.3/libsrc} to ensure that \texttt{libCRTM.a} was generated.
\subsection{WRFDA--4DVAR}
\label{install-wrfda-4dvar}
@@ -344,7 +344,7 @@
In other words, if you compiled WRFPLUS in the /home/user/WRFPLUSV3 directory, enter the command \texttt{setenv WRFPLUS\_DIR /home/user/WRFPLUSV3}.
-If you intend to assimilate satellite radiance data using RTTOV, you should set the RTTOV environment variable as appropriate. See the section on \hyperref[wrfda-rtm]{radiative transfer models} for instructions.
+If you intend to assimilate radiance data, you will need to set the appropriate environment variable for your preferred radiative transfer model (RTM). See the section on \hyperref[wrfda-rtm-compile]{radiative transfer models} for instructions.
Now run the WRFDA configure script for 4DVAR, select the appropriate option (``dmpar'' is \textbf{highly} recommended due to the large memory requirements for 4DVAR):
@@ -1066,10 +1066,13 @@
\subsection{Radiative Transfer Model (RTM)}
\label{wrfda-rtm}
-The core component for direct radiance assimilation is to incorporate a radiative transfer model (RTM) into the WRFDA system as one part of observation operators. Two widely used RTMs in the NWP community, RTTOV (developed by ECMWF and UKMET in Europe), and CRTM (developed by the Joint Center for Satellite Data Assimilation (JCSDA) in the United States), are implemented in the WRFDA system with a flexible and consistent user interface. The CRTM source code is included with the WRFDA package, and it is automatically compiled when the main WRFDA code is compiled. The RTTOV package is not distributed with WRFDA due to licensing issues. Users need to follow the instructions at \url{http://research.metoffice.gov.uk/research/interproj/nwpsaf/rtm} to download the RTTOV source code, supplemental coefficient files, and the emissivity atlas dataset. In WRFDA Version 3.6, only RTTOV Version 11 can be used.
+\textbf{SIDENOTE:} To compile with CRTM, \texttt{setenv CRTM 1}. To compile with RTTOV, \texttt{setenv RTTOV \textit{your-rttov-path}}.
-WRFDA is designed to be able to run with either of these RTMs at runtime, provided the appropriate settings were chosen at compile time. the user must select one of the two or neither, via the namelist parameter \texttt{rtm\_option} under \texttt{\&wrfvar14} (1 for RTTOV, the default, and 2 for CRTM).
+The core component for direct radiance assimilation is to incorporate a radiative transfer model (RTM) into the WRFDA system as one part of observation operators. Two widely used RTMs in the NWP community, RTTOV (developed by ECMWF and UKMET in Europe), and CRTM (developed by the Joint Center for Satellite Data Assimilation (JCSDA) in the United States), are implemented in the WRFDA system with a flexible and consistent user interface. The CRTM source code is included with the WRFDA package. The RTTOV package is not distributed with WRFDA due to licensing issues. Users need to follow the instructions at \url{http://research.metoffice.gov.uk/research/interproj/nwpsaf/rtm} to download the RTTOV source code, supplemental coefficient files, and the emissivity atlas dataset. In WRFDA Version 3.6, only RTTOV Version 11 can be used.
+
+WRFDA is designed to be able to run with either of these RTMs at runtime, provided the appropriate settings were chosen at compile time. The user must select one of the two or neither, via the namelist parameter \texttt{rtm\_option} under \texttt{\&wrfvar14} (1 for RTTOV, the default, and 2 for CRTM).
+
Both RTMs can calculate radiances for almost all available instruments aboard the various satellite platforms in orbit. An important feature of the WRFDA design is that all data structures related to radiance assimilation are dynamically allocated during running time, according to a simple namelist setup. The instruments to be assimilated are controlled at run-time by four integer namelist parameters, also under \texttt{\&wrfvar14}: \texttt{rtminit\_nsensor} (the total number of sensors to be assimilated), \texttt{rtminit\_platform} (an array of dimension \texttt{rtminit\_nsensor} containing the platform IDs for each sensor to be assimilated, \eg 1 for NOAA, 9 for EOS, 10 for METOP and 2 for DMSP), \texttt{rtminit\_satid} (satellite IDs array) and \texttt{rtminit\_sensor} (sensor IDs array, \eg 0 for HIRS, 3 for AMSU-A, 4 for AMSU-B, 15 for MHS, 10 for SSMIS, 11 for AIRS, 16 for IASI). The full list of instrument triplets can be found in the list below:
\begin{longtable}[h]{|l|l|l|l|}
@@ -1115,13 +1118,24 @@
\subsubsection{Compiling for radiance assimilation}
\label{wrfda-rtm-compile}
-If satellite radiance data are to be used, a Radiative Transfer Model (RTM) is required. The current RTM versions that WRFDA supports are CRTM V2.1.3 and RTTOV V11.1. CRTM V2.1.3 is included in the WRFDA tar file, and is automatically compiled. If the user wishes to use RTTOV, download and install the RTTOV v11 library before compiling WRFDA. This library can be downloaded from \url{http://research.metoffice.gov.uk/research/interproj/nwpsaf/rtm}. \textbf{The RTTOV libraries must be compiled with the ``emis\_atlas'' option in order to work with WRFDA}. After compiling RTTOV (see the RTTOV documentation for detailed instructions), set the ``RTTOV'' environment variable to the path where the lib directory resides. For example, if the library files can be found in \texttt{/usr/local/rttov11/pgi/lib/librttov11.1.0\_*.a}, you should set RTTOV as
+If satellite radiance data are to be used, a Radiative Transfer Model (RTM) is required. The current RTM versions that WRFDA supports are CRTM V2.1.3 and RTTOV V11.1.
+CRTM V2.1.3 is included in the WRFDA tar file. To use it, set the following environment variable prior to compiling WRFDA:
+
\small\begin{verbatim}
+ > setenv CRTM 1
+\end{verbatim}
+</font>
<font color="blue">ormalsize
+
+If the user wishes to use RTTOV, download and install the RTTOV v11 library before compiling WRFDA. This library can be downloaded from \url{http://research.metoffice.gov.uk/research/interproj/nwpsaf/rtm}. \textbf{The RTTOV libraries must be compiled with the ``emis\_atlas'' option in order to work with WRFDA}. After compiling RTTOV (see the RTTOV documentation for detailed instructions), set the ``RTTOV'' environment variable to the path where the lib directory resides. For example, if the library files can be found in \texttt{/usr/local/rttov11/pgi/lib/librttov11.1.0\_*.a}, you should set RTTOV as
+
+\small\begin{verbatim}
> setenv RTTOV /usr/local/rttov11/pgi
\end{verbatim}
</font>
<font color="gray">ormalsize
+\textbf{SIDENOTE:} RTTOV must be compiled with the ``\texttt{emis\_atlas}'' option to be used with WRFDA; see the RTTOV \texttt{readme.txt} for instructions.
+
\subsection{Channel selection}
\label{wrfda-radiance-channels}
Modified: trunk/wrf/UsersGuide/users_guide_chap6.doc
===================================================================
--- trunk/wrf/UsersGuide/users_guide_chap6.doc        2014-07-19 07:59:40 UTC (rev 505)
+++ trunk/wrf/UsersGuide/users_guide_chap6.doc        2014-08-06 00:29:47 UTC (rev 506)
@@ -1,4 +1,9 @@
-ࡱ >