<p><b>kavulich@ucar.edu</b> 2013-05-07 14:44:43 -0600 (Tue, 07 May 2013)</p><p>-Continuing work on Quick-Start Guide<br>
-Formatting tables<br>
</p><hr noshade><pre><font color="gray">Modified: trunk/wrfvar/3DVAR_technote/description.tex
===================================================================
--- trunk/wrfvar/3DVAR_technote/description.tex 2013-05-02 22:36:15 UTC (rev 428)
+++ trunk/wrfvar/3DVAR_technote/description.tex 2013-05-07 20:44:43 UTC (rev 429)
@@ -23,9 +23,6 @@
\usepackage{fancyheadings}
\lhead[\wrf~Scientific Description]{\wrf~Scientific Description}
\rhead[April, 2013]{April 22, 2013}
-% Use hyperref to insert links in pdf documents
-%\usepackage[colorlinks,citecolor=black,linkcolor=black,urlcolor=black]{hyperref}
-\usepackage[colorlinks,citecolor=blue,linkcolor=red,urlcolor=cyan]{hyperref}
% Use appendix package
\usepackage[page]{appendix}
@@ -38,6 +35,15 @@
\definecolor{light-gray}{gray}{0.95}
\definecolor{gray}{gray}{0.5}
%
+% Use package "comment" for large comments
+\usepackage{comment}
+%
+% Use "chngcntr" for table numbering
+\usepackage{chngcntr}
+\counterwithin{table}{chapter}
+% Use hyperref to insert links in pdf documents SHOULD ALWAYS BE LAST
+%\usepackage[colorlinks,citecolor=black,linkcolor=black,urlcolor=black]{hyperref}
+\usepackage[colorlinks,citecolor=blue,linkcolor=red,urlcolor=cyan]{hyperref}
% Set up page layout
\setlength{\textwidth}{6.75in}
\setlength{\oddsidemargin}{-0.0in}
Modified: trunk/wrfvar/3DVAR_technote/intro.tex
===================================================================
--- trunk/wrfvar/3DVAR_technote/intro.tex 2013-05-02 22:36:15 UTC (rev 428)
+++ trunk/wrfvar/3DVAR_technote/intro.tex 2013-05-07 20:44:43 UTC (rev 429)
@@ -31,7 +31,7 @@
Figure \ref{var-sketch} illustrates the relationship between WRF-Var, the various datasets, and the other components of a typical NWP system (here ARW). The WRF-Var assimilation proceeds as described in \citet{barker04}. A number of recent upgrades to the WRF-Var algorithm will be described in Section \ref{var-upgrade}.
%
-% Figure 9.1 WRFDA flowchart
+% Figure ?.? WRFDA flowchart
%
\begin{figure}
\centering
@@ -66,6 +66,14 @@
\label{compilers}
WRFDA requires both a Fortran-95 compiler and a C-compiler. WRFDA has been successfully tested on the following operating system/compiler combinations:
+\begin{table}[h]
+\begin{center}
+\vspace*{2mm}
+\caption{
+Successfully tested WRFDA platforms
+}
+\label{tab:tested-configs}
+\vspace*{3mm}
\begin{tabular}{ |l|l|l| }
\hline \textbf{Operating System} & \textbf{Fortran compiler} & \textbf{C compiler} \\
\hline IBM AIX & xlf & xlc \\
@@ -79,6 +87,9 @@
\hline SGI Altix & ifort & icc \\
\hline
\end{tabular}
+\end{center}
+\vspace*{-5mm}
+\end{table}
Compiling WRFDA with other OS/compiler combinations may be possible (WRFDA complies with the Fortran-95 standard), but users should be cautious as some compilers do not fully comply to the standard.
@@ -95,3 +106,8 @@
\subsubsection{Radiative Transfer Models}
\label{RTM}
+\subsection{Configuration}
+\label{configure}
+
+\subsection{Compilation}
+\label{compile}
Modified: trunk/wrfvar/3DVAR_technote/obs.tex
===================================================================
--- trunk/wrfvar/3DVAR_technote/obs.tex 2013-05-02 22:36:15 UTC (rev 428)
+++ trunk/wrfvar/3DVAR_technote/obs.tex 2013-05-07 20:44:43 UTC (rev 429)
@@ -4,6 +4,8 @@
Guo, Rizvi
\section{Observation Preprocessing}
+\label{obsproc}
+
In general, the observation processing system can be separated into 3 modules: 1) the decoder module to convert the observations in a variety of format from the external sources to a decoder format file, i.e. LITTLE\_R format here; 2) the 3DVAR\_OBSPROC module to perform the functions for which the first guess field information is not required; and 3) the WRFVar observation processing module to perform the functions for which the first guess field information is required. In this section, only the second one, 3DVAR\_OBSPROC, is discussed. The first one, the decoder module development, is the user's responsibility, and the third one, WRFVar observation processing such as innovation calculation, background check, etc., is included in the WRFVar code (\ref{xx}). The observation preprocessor program, 3DVAR\_OBSPROC, is coded with the Fortran-90.
The observation preprocessing, 3DVAR\_OBSPROC, provides the "conventional" observations ${\it{Y^o}}$ for ingest into WRF-Var. Here the "conventional" observations include not only the synoptic data, such as TEMP, SYNOP, etc., but also some of the retrievals from satellite measurements, such as SATEM, QuikSCAT, AIRS, Ground-based GPSPW(ZTD), and Space-born GPS refractivity, and SSMI, etc. Currently, the 3DVAR\_OBSPROC supports 21 types of observations, each type is assigned with the WMO code as listed in the table 5.1. The 2-digit codes are standard WMO code, and the 3-digit codes are the expansion in 3DVAR\_OBSPROC.
@@ -127,6 +129,18 @@
\end{itemize}
+
+As an example, to prepare the observation file at the analysis time, all the observations in the range ±1h will be processed, which means that (in the example case) the observations between 23h and 1h are treated as the observations at 0h. This is illustrated in the following figure:
+
+%
+% Figure ?.? OBSPROC time window diagram
+%
+%\begin{figure}
+% \centering
+% \includegraphics[width=6.5in]{figures/obsproc.pdf}
+% \caption{\label{obsproc-diagram}Diagram showing the relationship between the analysis time and the OBSPROC time window.}
+%\end{figure}
+
\section{Observation Quality Control}
The original WRF 3D-Var system described in \citet{barker04} used height interpolation for all observation operators. If an observation is reported as a function of pressure, then height is approximated using the hydrostatic relation. This step introduces an unnecessary source of error. The new WRF-Var system performs vertical interpolation in terms of the original observed coordinate, i.e., pressure or height.
Modified: trunk/wrfvar/3DVAR_technote/quickstart.tex
===================================================================
--- trunk/wrfvar/3DVAR_technote/quickstart.tex 2013-05-02 22:36:15 UTC (rev 428)
+++ trunk/wrfvar/3DVAR_technote/quickstart.tex 2013-05-07 20:44:43 UTC (rev 429)
@@ -4,16 +4,31 @@
This opening section will serve as a guide for users who do not care about the specific details of the WRFDA\textendash3DVAR system or data assimilation in general, but just wish to get the system up and running. WRFDA must be compiled on a Unix- or Linux-based system which has a Fortran and C compiler, as well as at least 2GB of disk space and 2GB of RAM. For a full list of system prerequisites, see the ``System Requirements'' section (\ref{system_requirements}).
+\textit{\textbf{Important note:} the example commands in this quick-start guide assume a csh or tcsh shell, using \texttt{vi} as a text editor. If you use different settings you will have to change these commands appropriately.}
+
\section*{Installing WRFDA}
\label{quick-install}
\subsubsection*{Obtaining the WRFDA source code and test data}
\label{quick-source}
-Users can download the WRFDA source code from \url{http://www.mmm.ucar.edu/wrf/users/wrfda/download/get_source.html}. You will be required to register (for free) with an email address (which will be kept confidential) before downloading the code. After the source code has been downloaded, it must be unzipped (gunzip WRFDAV3.5.TAR.gz) and untarred (tar -xf WRFDAV3.5.TAR), which should result in the \texttt{WRFDA} directory being created.
+Users can download the WRFDA source code from \url{http://www.mmm.ucar.edu/wrf/users/wrfda/download/get_source.html}. You will be required to register (for free) with an email address (which will be kept confidential) before downloading the code. It is also strongly recommended that users download the WRFDA test data set, available at \url{http://www.mmm.ucar.edu/wrf/users/wrfda/download/testdata.html}. This test data set will be referenced as an example throughout this quick-start guide, and contains three directories: \texttt{ob} (observation files), \texttt{be} (background error files), and \texttt{rc} (first guess and boundary condition files). For more information about this tutorial case, see the ``Tutorial Case'' section (\ref{tutorial-case}).
-It is also strongly recommended that users download the WRFDA test data set.
+You should unpack the WRFDA and test data packages in the same directory, then set this directory as the environment variable \texttt{\$WRFDA\_DIR} (this is not required, but will make the instructions in this quick-start guide easy to follow):
+\begin{verbatim}
+ > ls -al
+
+-rw-r--r-- 1 user USER 66361775 May 6 13:52 WRFDA_V3.5.tar.gz
+-rw-r--r-- 1 user USER 198491921 May 6 13:51 WRFDAV3.5-testdata.tar.gz
+
+ > gunzip WRFDAV3.5.tar.gz
+ > tar -xf WRFDAV3.5.tar
+ > gunzip WRFDAV3.5-testdata.tar.gz
+ > tar -xf WRFDAV3.5-testdata.tar
+ > setenv WRFDA_DIR `pwd`
+\end{verbatim}
+
\subsubsection*{Setting your system environment}
\label{quick-env}
@@ -37,7 +52,7 @@
> setenv CRTM 1
\end{verbatim}
-It is also possible to use RTTOV, which is a different RTM maintained by EUMETSAT. For this and other details about RTMs see the section ``Radiative Transfer Models'' (\ref{RTM})
+It is also possible to use RTTOV, which is a different RTM maintained by EUMETSAT. For this and other details about RTMs see the section ``Radiative Transfer Models'' (\ref{RTM}).
\subsubsection*{Configure your installation for your machine}
\label{quick-config}
@@ -45,7 +60,7 @@
Enter the \texttt{WRFDA} directory and run the configure script:
\begin{verbatim}
- > cd WRFDA
+ > cd $WRFDA_DIR/WRFDA
> ./configure wrfda
\end{verbatim}
@@ -68,3 +83,88 @@
If the compilation was successful, this command should list 44 executables. The main WRFDA executable is \texttt{da\_wrfvar.exe}; ensure this has been created before continuing.
+%%OBSPROC COMMENTED OUT FOR NOW; NOT SURE IF IT SHOULD BE COVERED IN QUICKSTART GUIDE
+\begin{comment}
+\section*{Running OBSPROC to format conventional observations}
+\label{quick-obsproc}
+
+The OBSPROC program reads observations in LITTLE\_R format\textemdash a text-based format in use since the MM5 era\textemdash which can be read by WRFDA. Conventional observations must be processed by OBSPROC before being used in WRFDA, though PREPBUFR, radiance, and radar data \textit{are not} processed by OBSPROC. For further details about OBSPROC and LITTLE\_R format, see the section ``Observation Preprocessing'' (\ref{obsproc}).
+
+OBSPROC requires at least 3 files to run successfully:
+\begin{itemize}
+\item A namelist file (\texttt{namelist.obsproc})
+\item An observation error file (\texttt{obserr.txt})
+\item One or more observation files
+\end{itemize}
+
+An example file (\texttt{namelist\_obsproc.3dvar.wrfvar-tut}) is located in the \texttt{WRFDA/var/obsproc} directory. Thus, proceed as follows:
+
+\begin{verbatim}
+> cd $WRFDA_DIR/var/obsproc
+> cp namelist.obsproc.3dvar.wrfvar-tut namelist.obsproc
+> vi namelist.obsproc
+\end{verbatim}
+
+This namelist file should be already set up to run the tutorial case with the exception of the \texttt{obs\_gts\_filename} entry: this lists the full path of the observation file. This can be found in the test data package, located at ``\texttt{ob/2008020512/obs.2008020512}''.
+
+To run OBSPROC, type
+ > ./obsproc.exe >&! obsproc.out
+Once obsproc.exe has completed successfully, you will see an observation data file, with the name formatted obs_gts_YYYY-MM-DD_HH:NN:SS.3DVAR, in the obsproc direc-tory. For the tutorial case, this will be obs_gts_2008-02-05_12:00:00.3DVAR. This is the input observation file to WRFDA. It is an ASCII file that contains a header section (listed below) followed by observations. The meanings and format of observations in the file are described in the last six lines of the header section.
+
+
+\end{comment}
+
+\section*{Running WRFDA}
+\label{quick-run}
+
+The standard input format for WRFDA is a record-based ASCII format produced by OBSPROC, the WRFDA Observation Preprocessor. Information on using OBSPROC can be found in the ``Observation Preprocessing'' section (\ref{obsproc}). Other data formats are allowed however, including observations in PREPBUFR format (see \ref{prepbufr}), radiance observations in BUFR format (see \ref{bufr}), and radar data in a different text-based format (see \ref{radar}). Some of these sets of observations can be assimilated concurrently (ASCII and PREPBUFR are mutually exclusive).
+
+\section*{ASCII formatted observations}
+\label{quick-littler}
+
+WRFDA requires several files to run with conventional data in OBSPROC format:
+\begin{table}[h]
+\begin{center}
+\vspace*{2mm}
+\caption{
+Required files for assimilation in conventional OBSPROC format
+}
+\label{tab:req-files-conv}
+\vspace*{3mm}
+\begin{tabular}{|l|l|l|l|}
+\hline \textbf{Input file} & \textbf{File name} & \textbf{Format} & \textbf{Source} \\
+\hline & & & WRF Preprocessing System (WPS) and \texttt{real.exe} \\
+ First Guess & \texttt{fg} & netCDF & \textit{or} \\
+ & & & WRF Forecast \\
+\hline Observations & \texttt{ob.ascii} & ASCII & OBSPROC \\
+\hline & & & WRFDA\textendash GEN\_BE utility (CV5) \\
+ Background Error & \texttt{be.dat} & Binary & \textit{or} \\
+ & & & Included in WRFDA package (CV3) \\
+\hline Land Use Table & \texttt{LANDUSE.TBL} & ASCII & Included in WRFDA package \\
+\hline WRFDA namelist & \texttt{namelist.input} & ASCII & Included in WRFDA package \\
+\hline
+\end{tabular}
+\end{center}
+\vspace*{-5mm}
+\end{table}
+
+To organize these files properly, create a new directory which will serve as your WRFDA working directory:
+
+\begin{verbatim}
+ > mkdir $WRFDA_DIR/workdir
+ > cd $WRFDA_DIR/workdir
+\end{verbatim}
+
+Next, run the following commands to copy/link all the necessary files:
+
+\begin{verbatim}
+ > cp $WRFDA_DIR/WRFDA/var/test/tutorial/namelist.input .
+ > ln -sf $WRFDA_DIR/var/run/LANDUSE.TBL .
+ > ln -sf $WRFDA_DIR/rc/2008020512/wrfinput_d01 ./fg
+ > ln -sf $WRFDA_DIR/WRFDA/var/obsproc/obs_gts_2008-02-05_12:00:00.3DVAR ./ob.ascii
+ > ln -sf $WRFDA_DIR/be/be.dat .
+ > ln -sf $WRFDA_DIR/WRFDA/var/da/da_wrfvar.exe .
+\end{verbatim}
+
+You should examine the \texttt{namelist.input} file and get acquainted with the available options. It should already be set up to run the tutorial case, but to run any other case you will likely have to change several values, especially those listed under \texttt{\&wrfvar18}, \texttt{\&wrfvar21}, \texttt{\&wrfvar22}, \texttt{\&time\_control}, and \texttt{\&domains}. The options included in the sample namelist are only a fraction of those available: further information can be found in the ``Running WRFDA\textendash 3DVAR'' section (Section \ref{running}) as well as the namelist appendix (Appendix \ref{namelist}).
+
</font>
</pre>