\documentclass[11pt]{article}
%\usepackage[utf8]{inputenc}
\usepackage{html}
\usepackage[titles]{tocloft}
\usepackage{natbib}
\usepackage{xcolor}
\usepackage{verbatim}
\input{imager-def.tex} %  IMAGER specific definitions
%
\pdfminorversion=7

% \newcommand{\lang}[1]{\texttt{\MakeUppercase{#1}$\backslash$}}
\newcommand{\IRAM}{\mbox{IRAM}}

\newcommand{\lmv}{\texttt{lmv}}
\newcommand{\clean}{\texttt{CLEAN}}
\newcommand{\uv}{\textit{uv}}
\newcommand{\emm}[1]{\ensuremath{#1}}   % Ensures math mode.
\newcommand{\emr}[1]{\emm{\mathrm{#1}}} % Uses math roman fonts.
\newcommand{\nds}[1]{\emm{\displaystyle#1}} % Normal display size for array and tabular environment.
\newcommand{\paren}[1]  {\nds{\left(  #1 \right) }} % Parenthesis. 
\newcommand{\cbrace}[1] {\nds{\left\{ #1 \right\}}} % Curly Braces.
\newcommand{\abs}[1]{\emm{\left| #1 \right|}} % Absolute value.
%\newcommand{\sicvar}[1] {\mbox {\tt #1}}
%\newcommand{\sicvar}[1] {\mbox {{\color{magenta}\tt #1}}} % Works with "magenta" only so far
\newcommand{\sicvar}[1] {\mbox {{\color{magenta}{\sc #1}}}} % Works with "magenta" only so far
\newcommand{\file}[1] {\mbox {{\color{magenta}\tt #1}}}
\newcommand{\script}[1] {\mbox {{\color{magenta}\tt #1}}}
\newcommand{\qom}[1] {\mbox {{\color{magenta}\tt #1}}}
\newcommand{\qomm}[2]{\mbox {{\color{magenta}\tt #1 #2}}}
\newcommand{\com}[1] {\index{#1} \qom{#1}}
\newcommand{\comm}[2]{\mbox {{\color{magenta}\tt #1 #2}}\index{#1!#2}}
\newcommand{\mymath}[1]{\mbox {\it #1}}
%
%\newcommand{\lang}[1]{\mbox {\texttt{\MakeUppercase{#1}\textbackslash}}}
%\newcommand{\imager} {\mbox{{{\sc imager}}}}
\newcommand{\imager} {\mbox{{\color[rgb]{1,0,0}{\sc imager}}}}
\newcommand{\lang}[1]{\mbox {\color{magenta}{\texttt{\MakeUppercase{#1}\textbackslash}}}}
\newcommand{\viewer}    {\mbox{{\color{red} \sc viewer}}}
\newcommand{\button}[1] {\mbox{\tt\bf #1}}
%
% Color require some strange tricks to be more or less correct in HTML version !...
\renewcommand{\sic}    {\mbox{{\color{red} \sc sic}}}
\renewcommand{\greg}   {\mbox{{\color{red} \sc greg}}}
\renewcommand{\clic}   {\mbox{{\color{red} \sc clic}}}
\renewcommand{\class}   {\mbox{{\color{red} \sc class}}}
\renewcommand{\mapping}{\mbox{{\color[rgb]{1,0,0}{\sc mapping}}}}
\renewcommand{\sicvar}[1] {\mbox {{\color{blue}\tt #1}}} % Works provided it has been define with "magenta" first in HTML !
\renewcommand{\lang}[1]{\mbox{{\color{blue}{\texttt{\MakeUppercase{#1}\textbackslash}}}}} % TRIAL
%\renewcommand{\file}[1] {\mbox {{\color{cyan}\tt #1}}}
\renewcommand{\file}[1] {\mbox {{\color{olive}\tt #1}}}
\renewcommand{\script}[1] {\mbox {{\color{violet}\tt #1}}}
%
% With the "tocloft" package, to control TOC horizontal spacings
%\renewcommand*\cftchapnumwidth{2em}
\renewcommand*\cftsecnumwidth{3em}
\renewcommand*\cftsubsecnumwidth{4em}
\renewcommand*\cftsubsubsecnumwidth{5em}
%
% Special indenting of subsections in HTML
\newcommand{\htpad}{\phantom{ABC}} %\rawhtml &nbsp;&nbsp;&nbsp;&nbsp; \endrawhtml}
\newcommand{\partie}[1]{} 
\newcommand{\htbreak}{} %\rawhtml &nbsp;&nbsp;&nbsp;&nbsp; \endrawhtml}
%
% Bugs
%
\newcommand{\added}{\mbox{{\bf Added }}}
\newcommand{\discovered}{\mbox{{\color{red} Discovered }}}
\newcommand{\corrected}{\mbox{{\color{red} Corrected }}}
% also a bug in Latex2Html  -- must re-issue the command to make it work
\renewcommand{\corrected}{\mbox{{\color[rgb]{0.1,0.8,0.1} Corrected }}}

\makeindex{}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\begin{document}

% \frontmatter{} % For BOOKS only
% Special indenting of subsections in HTML
\begin{htmlonly}
  \renewcommand{\htpad}{\rawhtml &nbsp;&nbsp;&nbsp;&nbsp; \endrawhtml}
  \renewcommand{\partie}[1]{#1} 
  \renewcommand{\htbreak}{\rawhtml<BR>\endrawhtml} 
\end{htmlonly}

\begin{center}
  \huge{
  \textbf{IMAGER} 
  } \\[2\bigskipamount]
\end{center}

\input{imager-version.tex}

\begin{description}
\item\textbf{Documentation:}\\ 
  In charge: E.~Di~Folco (1) \\
  Active contributor: S.~Guilloteau (1)
\item\textbf{Software:}\\
  In charge: S.~Guilloteau (1) \\
  Active contributor: S.~Guilloteau (1) 
\item\textbf{Contributors:}\\
  Web Site design: T.~Jacq (1) \\
  Distribution: J.~Penguen (2) \\
  Tests: E.~Chapillon (1,3) 
\end{description}
1. Laboratoire d'Astrophysique de Bordeaux, CNRS \& Universit\'e de Bordeaux\\
2. Observatoire Aquitain des Sciences de l'Univers, CNRS \& Universit\'e de Bordeaux\\
3. Institut de Radio Astronomie Millimétrique
\clearpage
\newpage 

\centerline{\Large\bf Notations}
\bigskip{} %

Throughout this document, colors are used to highlight the names of categories of entities:
\begin{itemize}
\item \mbox{{\color[rgb]{1,0,0}{\sc program}}} is a GILDAS program name.
\item \lang{Language} is a SIC Language name
\item \qom{NAME} is a command name, keyword or option
\item \sicvar{SICVAR} is a SIC variable
\item \script{ScriptName} is an \imager{} script (external text file) that can be executed by the \com{@} command
\item \file{FileName} is an external file, e.g. a data file.
\end{itemize}

\begin{rawhtml}
  Note: this is the on-line version of the IMAGER Manual.
  A <A HREF="https://imager.oasu.u-bordeaux.fr/wp-content/uploads/doc/imager.pdf"> PDF version</A>
  is also available.
\end{rawhtml}

\bigskip{} %

Related information on \imager{} is available in:
\begin{latexonly}
  \begin{itemize}
  \item{IRAM Plateau de Bure Interferometer: Introduction}
  \item{IRAM Plateau de Bure Interferometer: OBS Users Guide}
  \item{IRAM Plateau de Bure Interferometer: Atmospheric Calibration}
  \item{IRAM Plateau de Bure Interferometer: Calibration Cookbook}
  \item{CLIC: Continuum and Line Interferometric Calibration}
  \item{GREG: Graphical Possibilities}
  \item{SIC:  Command Line Interpretor}
  \item{IMAGER: Imager Bugs \& Release Notes}
  \end{itemize}
\end{latexonly}
%
\begin{rawhtml}
  <UL>
  <LI> IRAM Plateau de Bure Interferometer: <A HREF="https://www.iram.fr/IRAMFR/GILDAS/doc/html/noema-intro-html/noema-intro.html">
  Introduction</A>
  <LI> IRAM Plateau de Bure Interferometer: <A HREF="https://www.iram.fr/IRAMFR/GILDAS/doc/html/obs-html/obs.html"> 
  OBS Users Guide</A>
  <LI> IRAM Plateau de Bure Interferometer: <A HREF="https://www.iram.fr/IRAMFR/GILDAS/doc/html/pdbi-cookbook-html/pdbi-cookbook.html"> 
  Calibration CookBook</A>
  <LI> <A HREF="https://www.iram.fr/IRAMFR/GILDAS/doc/html/clic-html/clic.html"> CLIC:</A>  
  Continuum and Line Interferometric Calibration 
  <LI> <A HREF="https://www.iram.fr/IRAMFR/GILDAS/doc/html/greg-html/greg.html"> GREG: Graphical Possibilities</A>
  <LI> <A HREF="https://www.iram.fr/IRAMFR/GILDAS/doc/html/sic-html/sic.html">   SIC:  Command Line Interpretor</A>
  <LI> <A HREF="https://imager.osau.u-bordeaux.fr/wp-content/uploads/doc/imager-bugs-html"> IMAGER: Imager bugs and Release notes</A>
  </UL>
\end{rawhtml}

\begin{latexonly}
\newpage
\tableofcontents{} %
\end{latexonly}

% \mainmatter{} % for BOOKS only

\newpage
\input{preamble.tex}

%%\end{document}

\newpage
\section{\partie{Introduction:} IMAGER in short}
\input{concepts}


\newpage
\section{\partie{Introduction:} IMAGER principles}
\input{principles}

\newpage
\section{\partie{Data Format:} UV Tables \& Images}
\input{uv-table}

\newpage
\section{\partie{Application:} Single-field imaging and deconvolution}
\input{single-field}

\newpage

\section{\partie{Application:} Wide-field imaging and deconvolution}
\input{wide-field}

\newpage
\section{\partie{Application:} Self Calibration}
\input{self-calibration}

\newpage{}
\section{\partie{Application:} Short and Zero spacings} 
\input{short-spacings}

\newpage
\section{\partie{Application:} UV plane analysis}
\input{uv-plane}

\newpage
\section{\partie{Application:} Continuum emission}
\input{continuum}

\clearpage
\newpage
\section{\partie{Application:} Visual Checks and Image Displays}
\input{view-show}

\clearpage
\newpage
\section{\partie{Application:} The Imager PIPELINE and REPORT tools}
\input{all-in-one}

\clearpage
\newpage
\section{\partie{Advanced:} Polarization Handling}
\input{polarization}

\clearpage
\newpage
\section{\partie{Advanced:} Specific cases and dirty tricks}
\input{advanced}

\clearpage{}
\newpage{}
\section{\partie{Advanced:} Simulating Observations}
\input{simulate}

\clearpage
\newpage
\section{\partie{Advanced:} Further Data Analysis}
\input{bundles}


%% \section{OTF}


%% \chapter{Imaging simulation}

% {Internal Helps}
\clearpage
\newpage

\section{\partie{Language:} DISPLAY\textbackslash{} Internal Help} \label{CLEAND}
\input{imager-help-display}

\section{\partie{Language:} CLEAN\textbackslash{}  Internal Help} \label{CLEANH}
\input{imager-help-clean}

\newpage
\section{\partie{Language:} CALIBRATE\textbackslash{}  Internal Help} \label{CLEANC}
\input{imager-help-calib}

\newpage
\section{\partie{Language:} ADVANCED\textbackslash{}  Internal Help} \label{CLEANN}
\input{imager-help-news}

\newpage
\section{\partie{Language:} BUNDLES\textbackslash{}  Internal Help} \label{CLEANB}
\input{imager-help-bundles}

\newpage
\section{\partie{Language:} IMAGER\textbackslash{}   Internal Help} \label{CLEANI}
\input{imager-help-imager}

\newpage
\section{\partie{Language:} SIMULATE\textbackslash{}  Internal Help} \label{CLEANS}
\input{imager-help-simu}

%\section{Description of Associated Tasks}
%\input{mapping-task-summ}
%the file mapping-task-summ.tex was copied from gildas-src-dev/integ/doc/tasks
% see also mapping-tasks-list.tex

\clearpage
\newpage
\section{\partie{History:} Bugs and Release Notes}
This section lists known bugs (or strange features) that are known
at the date of release of the documentation, and the list of changes
since previous releases. 
A more complete list is available in the IMAGER Bugs \& Release note documentation
\begin{latexonly}
here for the \href{https://imager.oasu.u-bordeaux.fr/wp-content/uploads/doc/imager-bugs.pdf}{PDF version}
or there for the 
\href{https://imager.oasu.u-bordeaux.fr/wp-content/uploads/doc/imager-bugs-html}{Web version}
\end{latexonly}
%
\begin{rawhtml}
  here for the <A HREF="https://imager.oasu.u-bordeaux.fr/wp-content/uploads/doc/imager.pdf"> PDF version</A>
  or there for the 
  <A HREF="https://imager.oasu.u-bordeaux.fr/wp-content/uploads/doc/html"> Web version</A>
\end{rawhtml}


\input{bugs.tex}
%\input{in-out-imager}

\newpage

\appendix{}
\input{app-casa}

\section{Properties of the Fourier Transform}
\label{app:fourier}
Let us name $f(x)$ a function, and $F(X)$ its Fourier transform. We
use here the simple, non-unitary convention
\begin{itemize}
\item Definition: $F(X) = \int_{-\infty}^{+\infty} f(x) e^{-2i\pi x X} dx$
\item Linearity:  $h(x) = a f(x) + b g(x)$, then $H(X) = a F(X) + b G(X)$
\item Translation:  $h(x) = f(x-x_0)$, then $H(X) = e^{-2i\pi x_0 X} F(X)$
\item Shifting: $h(x) = e^{2i\pi x X_0} f(x)$, then $H(X) = F(X-X_0)$
\item Scaling: $h(x) = f(ax)$, then $H(X) = \frac{1}{|a|}F(\frac{X}{a})$
(the so-called \textit{time reversal} property is obtained with $a=1$
\item Conjugation: if $h(x) = \bar{f}(x)$, then $H(X) = \bar{F}(-X)$
\item Integration: With $X=0$ in the definition\\
$F(0) = \int_{-\infty}^{+\infty} f(x) dx$
\item Convolution: $h(x)= f(x) * g(x)$ then $H(X) = F(X) G((X)$. \\
The Fourier Transform of a product of two functions is the convolution of
the Fourier Transforms of the functions.
\item Uncertainty principle:  the more concentrated $f(x)$ is, the 
more spread out its Fourier transform $F(X)$ must be. In particular, 
the scaling property of the Fourier transform may be seen as saying: if 
we squeeze a function in $x$, its Fourier transform stretches out in $X$. 
It is not possible to arbitrarily concentrate both a function and its 
Fourier transform. 
\end{itemize}
The definition, illustrated here with scalars, also holds for $x,X$ 
being 2-D vectors in Euclidean space, the product in the definition 
being a standard dot product of these vectors. 


% \backmatter{} % for BOOKS only
%\input{changes.tex}

\clearpage
\bibliography{imager}
\bibliographystyle{apalike} %% aa

\begin{htmlonly}
\newpage
\tableofcontents{} 
\end{htmlonly}

\printindex{} %

\end{document}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
