<p><b>kavulich@ucar.edu</b> 2014-05-29 10:32:54 -0600 (Thu, 29 May 2014)</p><p>More commits. Chapter 6 done partway through UPDATE_BC<br>
</p><hr noshade><pre><font color="gray">Modified: trunk/wrf/UsersGuide/Chapter_6.tex
===================================================================
--- trunk/wrf/UsersGuide/Chapter_6.tex 2014-05-28 23:35:42 UTC (rev 491)
+++ trunk/wrf/UsersGuide/Chapter_6.tex 2014-05-29 16:32:54 UTC (rev 492)
@@ -1,8 +1,6 @@
\chapter{WRF Data Assimilation}
\label{WRFDA}
-\setcounter{minitocdepth}{3} % List as deep as subsubsections in chapter table of contents
-</font>
<font color="gray">omtcpagenumbers % No page numbers in chapter TOC
\minitoc % Chapter TOC
@@ -126,11 +124,6 @@
\vspace*{-5mm}
\end{table}
-\subsection{Obtaining WRFPLUS source code}
-\label{wrfplus-source}
-
-If compiling for 4DVAR, it is also necessary to download WRFPLUS (the WRF tangent-linear and adjoint model), which can be found at \url{http://www.mmm.ucar.edu/wrf/users/wrfda/download/wrfplus.html}. After the tar file is unzipped (\texttt{gunzip WRFPLUS\_V3.5.tar.gz}) and untarred (\texttt{tar -xf WRFPLUS\_V3.5.tar}), the directory \texttt{WRFPLUSV3} should be created. This directory contains the WRFPLUS source code.
-
\subsection{WRFDA--3DVAR}
\label{install-wrfda-3dvar}
@@ -294,7 +287,7 @@
The basic \texttt{gen\_be} utility for the regional model consists of \texttt{gen\_be\_stage0\_wrf.exe}, \texttt{gen\_be\_stage1.exe}, \texttt{gen\_be\_stage2.exe}, \texttt{gen\_be\_stage2a.exe}, \texttt{gen\_be\_stage3.exe}, \texttt{gen\_be\_stage4\_regional.exe}, and \texttt{gen\_be\_diags.exe}.
-\texttt{da\_update\_bc.exe} is used for updating the WRF lower and lateral boundary conditions before and after a new WRFDA analysis is generated.
+\texttt{da\_update\_bc.exe} is used for updating the WRF lower and lateral boundary conditions before and after a new WRFDA analysis is generated. See the section on \hyperref[wrfda-updatebc]{updating boundary conditions} for details.
\texttt{da\_advance\_time.exe} is a very handy and useful tool for date/time manipulation. Type \texttt{var/build/da\_advance\_time.exe} to see its usage instructions.
@@ -302,14 +295,19 @@
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.
-\subsection{Installing WRFPLUS and WRFDA for 4D-Var Run}
+\subsection{WRFDA--4DVAR}
\label{install-wrfda-4dvar}
-If you intend to run WRFDA 4DVAR, it is necessary to install WRFPLUS first. WRFPLUS contains the adjoint and tangent linear models based on a version of the WRF model with simplified physics parameterizations such as surface drag, large scale condensation and precipitation, and cumulus parameterization.
+\subsubsection{Installing WRFPLUS}
+\label{wrfplus-source}
-To begin the installation process, \hyperref[wrfda-source]{download the source code} if you have not yet done so. Then enter the \texttt{WRFPLUSV3} directory, then run the configure script:
+If you intend to run WRFDA 4DVAR, it is necessary to install WRFPLUS (the WRF tangent-linear and adjoint model) first. WRFPLUS contains the adjoint and tangent linear models based on a version of the WRF model with simplified physics parameterizations such as surface drag, large scale condensation and precipitation, and cumulus parameterization.
+WRFPLUS can be downloaded at \url{http://www.mmm.ucar.edu/wrf/users/wrfda/download/wrfplus.html}. After the tar file is unzipped (\texttt{gunzip WRFPLUS\_V3.6.tar.gz}) and untarred (\texttt{tar -xf WRFPLUS\_V3.6.tar}), the directory \texttt{WRFPLUSV3} should be created. This directory contains the WRFPLUS source code.
+To begin the installation process, enter the \texttt{WRFPLUSV3} directory, then run the configure script:
+
+
\scriptsize\begin{verbatim}
> cd WRFPLUSV3
> ./configure wrfplus
@@ -335,6 +333,8 @@
\end{verbatim}
</font>
<font color="gray">ormalsize
+\subsubsection{Compiling for 4DVAR}
+\label{wrfda-4dvar-configure-compile}
If WRFPLUS was compiled successfully, you can now install WRFDA. Prior to running the WRFDA configure script, set the environment variable WRFPLUS\_DIR to the appropriate directory:
\scriptsize\begin{verbatim}
@@ -946,6 +946,9 @@
interval_seconds=21600,
debug_level=0,
/
+&time_control
+specified=.true.
+/
\end{verbatim}
</font>
<font color="gray">ormalsize
@@ -1429,8 +1432,78 @@
\section{Updating WRF Boundary Conditions}
\label{wrfda-updatebc}
+\subsection{Lateral boundary conditions}
+\label{wrfda-lateral-bc}
+When using WRFDA output to run a WRF forecast, it is essential that you update the WRF lateral boundary conditions (contained in the file \texttt{wrfbdy\_01}, created by \texttt{real.exe}) to match your new analysis. Domain 1 (\texttt{wrfbdy\_d01}) must be updated to be consistent with the new WRFDA initial condition (analysis). This is absolutely essential. For nested domains (domain 2, domain 3, etc.) the lateral boundary conditions are provided by their parent domain, so no lateral boundary update is needed for these domains. The update procedure is performed by the UPDATE\_BC executable (\texttt{da\_update\_bc.exe}), which can be found in \texttt{\$WRFDA\_DIR/var/build} after compilation.
+UPDATE\_BC requires three input files: the WRFDA analysis (\texttt{wrfvar\_output}), the WRF boundary file from \texttt{real.exe} (\texttt{wrfbdy\_01}), and a namelist file: \texttt{parame.in}. To run UPDATE\_BC to update lateral boundary conditions, follow the steps below:
+
+\scriptsize\begin{verbatim}
+\texttt{\$WORK\_DIR}
+ > mkdir $WORK_DIR/update_bc
+ > cd $WORK_DIR/update_bc
+ > cp –p $DAT_DIR/rc/2008020512/wrfbdy_d01 .
+\end{verbatim}
+</font>
<font color="blue">ormalsize
+(IMPORTANT: you must \textit{copy} \texttt{wrfbdy\_d01} rather than linking it, since it will be over-written by \texttt{da\_update\_bc.exe})
+\scriptsize\begin{verbatim}
+ > cp $WRFDA_DIR/var/test/update_bc/parame.in .
+ > vi parame.in
+&control_param
+ da_file = '../wrfvar_output'
+ wrf_bdy_file = './wrfbdy_d01'
+ domain_id = 1
+ debug = .true.
+ update_lateral_bdy = .true.
+ update_low_bdy = .false.
+ update_lsm = .false.
+ iswater = 16
+ var4d_lbc = .false.
+/
+
+ > ln –sf $WRFDA_DIR/var/da/da_update_bc.exe .
+ > ./da_update_bc.exe
+\end{verbatim}
+</font>
<font color="blue">ormalsize
+
+At this stage, the file \texttt{wrfbdy\_d01} has been updated for any subsequent WRF model runs. To use, copy the updated \texttt{wrfbdy\_d01} file into your WRF working directory.
+
+You should also see two additional output files: \texttt{fort.11} and \texttt{fort.12}. These contain information about the changes made to \texttt{wrfbdy\_01}.
+
+\subsection{Cycling with WRF and WRFDA (warm-start)}
+\label{wrfda-update-bc-cycling}
+
+In cycling mode (warm-start), the lower boundary in the first guess file also needs to be updated based on the information from the wrfinput file, generated by WPS/real.exe at analysis time. If in cycling mode (especially if you are doing radiance data assimilation and there is sea ice or snow cover in your domain), it is recommended that \textit{before} you run WRFDA, you run UPDATE\_BC with the following namelist options:
+
+\scriptsize\begin{verbatim}
+ da_file = './fg'
+ wrf_input = './wrfinput_d01'
+ update_lateral_bdy = .false.
+ update_low_bdy = .true.
+ iswater = 16
+\end{verbatim}
+</font>
<font color="blue">ormalsize
+
+Note: ``iswater'' (water point index) is 16 for USGS LANDUSE and 17 for MODIS LANDUSE.
+
+This creates a lower-boundary updated first guess (\texttt{da\_file} will be overwritten by \texttt{da\_update\_bc.exe} with updated lower boundary conditions from \texttt{wrf\_input}). Use this updated first guess for running WRFDA.
+
+Then, after WRFDA has finished, run UPDATE\_BC again with the following namelist options:
+
+\scriptsize\begin{verbatim}
+ da_file = './wrfvar_output'
+ wrf_bdy_file = './wrfbdy_d01'
+ update_lateral_bdy = .true.
+ update_low_bdy = .false.
+\end{verbatim}
+</font>
<font color="gray">ormalsize
+
+These settings will direct UPDATE\_BC to update the lateral boundary conditions (\texttt{wrf\_bdy\_file} will be overwritten with lateral boundary conditions from \texttt{da\_file}).
+As mentioned in \hyperref[wrfda-lateral-bc]{the previous section}, lateral boundary conditions for child domains (\texttt{wrfinput\_02}, \texttt{wrfinput\_03}, etc.) come from their respective parent domains, so running UPDATE\_BC is not necessary after running WRFDA in these cases. However, in a cycling procedure, the lower boundaries in each of the nested domains' WRFDA analysis files still need to be updated. In these cases, you must set the namelist variable \texttt{domain\_id} > 1 (default is 1 for domain 1), and provide the appropriate wrfinput file (\texttt{wrf\_input = './wrfinput\_d02'} for domain 2, for example).
+
+
+
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\section{WRFDA Diagnostics}
Modified: trunk/wrf/UsersGuide/Users_Guide.tex
===================================================================
--- trunk/wrf/UsersGuide/Users_Guide.tex 2014-05-28 23:35:42 UTC (rev 491)
+++ trunk/wrf/UsersGuide/Users_Guide.tex 2014-05-29 16:32:54 UTC (rev 492)
@@ -60,8 +60,13 @@
</font>
<font color="black">ewcommand{\xbmf}[1]{\hbox{\sffamily\slshape #1}}
</font>
<font color="blue">ewcommand{\xmathbf}{\boldsymbol}
+%Use "minitoc" package to put a table of contents at the start of each chapter
\usepackage{minitoc}
+\setlength{\mtcindent}{12pt} % Only indent chapter TOC 12 points
+\setcounter{minitocdepth}{3} % List as deep as subsubsections in chapter TOC
+</font>
<font color="blue">omtcpagenumbers % No page numbers in chapter TOC
+
% Use hyperref to insert links in pdf documents SHOULD ALWAYS BE LAST
%\usepackage[colorlinks,citecolor=black,linkcolor=black,urlcolor=black]{hyperref}
\usepackage[colorlinks,citecolor=red,linkcolor=blue,urlcolor=cyan]{hyperref}
</font>
</pre>