%
% === General definitions and packages to use
%
\usepackage[]{fancyhdr}   
\usepackage[]{natbib}
\usepackage{alltt}
\usepackage{times}
\usepackage{verbatim}
\usepackage{lscape}      % landscape mode of a single page
\usepackage[]{longtable} % allow tables longer than one page
%


\sloppy

\graphicspath{{Figs/}}


%
% === Margins
%
\voffset-2.0cm
\headheight16pt
\headsep1.1cm
\textheight22cm
\hoffset-1.3cm
\oddsidemargin2.2cm
\textwidth14.0cm


%
% === Headings
%
\pagestyle{fancy}
\renewcommand{\chaptermark}[1]{\markboth{#1}{}}
\renewcommand{\sectionmark}[1]{\markright{\thesection\ #1}}
\fancyhf{}
\fancyhead[LE,RO]{\small{\sc\thepage}}
\fancyhead[LO]{\small{\scshape\rightmark}}
\fancyhead[RE]{\small{\scshape\leftmark}}
\renewcommand{\headrulewidth}{0.5pt}
\renewcommand{\footrulewidth}{0pt}
\fancypagestyle{plain}{%
  \fancyhead{}
  \renewcommand{\headrulewidth}{0pt}
}  


%
% === Page layout definitions
%
% Chapters and sections.
\newcommand{\levela}[1]    {\chapter{#1}}
\newcommand{\levelb}[1]    {\section{#1}}
\newcommand{\levelc}[1]    {\subsection{#1}}
\newcommand{\leveld}[1]    {\subsubsection{#1}}
\newcommand{\levele}[1]    {\paragraph{#1}}
%
% Document history
\newcommand{\starthistory} {\begin{table}[b]  \begin{tabular}{l p{11cm}} 
                             \hline {\bf History} & \\ }
\newcommand{\stophistory}  {\end{tabular} \end{table} }
%
% Symbol table
\newcommand{\startsymbols} {\begin{table}[t]  \begin{tabular}{l l l}
                            {\bf Here} & {\bf In ARTS} & {\bf Description} 
                            \\ \hline \\ } 
\newcommand{\stopsymbols}  {\\ \hline \end{tabular} 
                            \caption{Symbols used in this chapter and the
                            corresponding ARTS notation. }
                            \end{table} }      

%
% === Symbol definitions
%   Only the most general symbols are defined here. Other variables
%   are local for each part.
%
% == Scalars
% Monochromatic pencil beam intensity
\newcommand{\mpbi}       {\ensuremath{I}}  
% Frequency  
\newcommand{\f}          {\ensuremath{\nu}}  
% Viewing angle from zenith
\newcommand{\view}       {\ensuremath{\phi}}  
%
% == Forward, inverse and transfer models
% Total forward model
\newcommand{\fm}         {\ensuremath{\mathcal{F}}}  
% Atmospgeric forward model  
\newcommand{\fma}        {\ensuremath{\mathcal{F}_a}}  
% Sensor forward model  
\newcommand{\fms}        {\ensuremath{\mathcal{F}_s}}  
% Inverse model  
\newcommand{\im}         {\ensuremath{\mathcal{I}}}  
% Transfer model  
\newcommand{\tm}         {\ensuremath{\mathcal{T}}}  
%
% == Vectors and matrices of Rodgers formalism
% Measurement vector
\newcommand{\y}          {\ensuremath{\mathbf{y}}}  
% Vector of monochromatic pencil beam intensities
\newcommand{\iv}         {\ensuremath{\mathbf{i}}}  
% Vector of monochromatic pencil beam intensities
\newcommand{\merr}       {\ensuremath{\varepsilon}}  
% Total state vector
\newcommand{\xt}         {\ensuremath{\mathbf{x}}}  
% Retrieved state vector
\newcommand{\xret}       {\ensuremath{\hat{\mathbf{x}}}}
% Total forward model parameter vector
\newcommand{\bt}         {\ensuremath{\mathbf{b}}}  
% Inverse model parameters
\newcommand{\ct}         {\ensuremath{\mathbf{c}}}  
% Weighting function matrix
\newcommand{\K}          {\ensuremath{\mathbf{K}}}  
% State vector weighting function matrix
\newcommand{\Kx}         {\ensuremath{\mathbf{K_x}}}  
% Model parameter weighting function matrix
\newcommand{\Kb}         {\ensuremath{\mathbf{K_b}}}  
% Contribution function matrix
\newcommand{\Dy}         {\ensuremath{\mathbf{D_y}}}  
% Averaging kernel matrix
\newcommand{\A}          {\ensuremath{\mathbf{A}}}  
% Total sensor and data reduction matrix
\newcommand{\Hm}         {\ensuremath{\mathbf{H}}}  
% Sensor matrix
\newcommand{\Hs}         {\ensuremath{\mathbf{H}_s}}  
% Data reduction matrix
\newcommand{\Hd}         {\ensuremath{\mathbf{H}_d}}  
% Transformation between vector spaces
\newcommand{\B}          {\ensuremath{\mathbf{B}}}  
%
% == Gemeral math
% Make matrix
\newcommand{\mat}[1]     {\ensuremath{\mathbf{#1}}}
% Identity matrix
\newcommand{\Id}         {\ensuremath{\mathbf{I}}}  
% Matrix sizes
\newcommand{\msize}[2]   {{\bf R}^{#1 {\mathrm x} #2}}
% Differential d
\newcommand{\dd}         {\ensuremath{\mathrm{d}}}  
% 10^#1
\newcommand{\ee}[1]      {\ensuremath{\cdot10^{#1}}}
%
% == Plotting curves
\def \lsolid     {\mbox{------}}
\def \ldashed    {\mbox{--~--~--}}
\def \ldashdot   {\mbox{--~$\cdot$~--}}
\def \ldotted    {\mbox{$\cdot~\cdot~\cdot$}}

  


%===   Start of report   ===================================================
\begin{document}
%
\bibliographystyle{agu}


%
% === Title page
%
\thispagestyle{plain}
\begin{center}
  \vspace*{2cm}
  {\Huge \verb|ARTS User Guide|\\}
  \vspace*{1cm}
  {\large by \\}
  \vspace*{1cm}
  {\large \bf Stefan B\"uhler\\Institute of Remote Sensing\\University of Bremen, Germany\\}
  \vspace*{3mm}
  {\large and\\}
  \vspace*{3mm}
  {\large \bf Patrick Eriksson\\Department of Radio and Space Science\\Chalmers University of Technology, Sweden\\}
   \vspace*{2cm}
   {\large \today\\
    ARTS Version \input{auto_version}
   }
\end{center}
  \vspace*{4cm}
{\normalsize \bf
  \noindent
  This is a working document. The implementation approaches and the
  algorithms are preliminary and can be subject to changes. In addition,
  not all features described in this document are implemented in ARTS.
  
  We welcome gladly comments and reports on errors in the document.
  Send then an e-mail to: \verb|patrick@rss.chalmers.se| or 
  \verb|sbuehler@uni-bremen.de|.
}

\newpage                          
\thispagestyle{empty}
\vspace*{\fill}
\noindent
\begin{verbatim}
Copyright (C) 2000,2001 
Stefan Buehler <sbuehler@uni-bremen.de>
Patrick Eriksson <patrick@rss.chalmers.se>

The ARTS program is free software; you can redistribute it
and/or modify it under the terms of the GNU General Public
License as published by the Free Software Foundation; either
version 2, or (at your option) any later version.

This program is distributed in the hope that it will be
useful, but WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE.  See the GNU General Public License for more
details. 

You should have received a copy of the GNU General Public
License along with the program; if not, write to the Free
Software Foundation, Inc., 59 Temple Place - Suite 330,
Boston, MA 02111-1307, USA. 
\end{verbatim}
\cleardoublepage

\pagenumbering{roman}
\tableofcontents

\cleardoublepage
\pagenumbering{arabic}
     

%
% === The chapters
%
\include{concept}
\include{formalism}
\part{Algorithm Descriptions}
\include{absorption}
\include{rte}
\include{los1d}
\include{sensor}
\include{reduction}
\include{wfuns_atm}
\include{measerr}
%\include{wfuns_sensor} This chapter must be updated
\part{Implementation Issues}
\include{development}
\include{matrix_vector}
\include{formats}
\part{Utilities}
\include{utilities}
\part{Bibliograpgh and Appendices}


%
% ===   Bibliography
%
\bibliography{references}
%
% ===   Appendices
%
\begin{appendix}
  \include{app_wsv}
%  \include{app_units}
\end{appendix}

%===   End of report   =====================================================
\end{document}

%%% Local Variables: 
%%% mode: latex 
%%% TeX-master: "uguide" 
%%% End:
