Changeset 1266

Timestamp:

09/12/06 14:37:29 (18 years ago)

Author:

phi196

Message:

Minor formatting tweaks

File:

• branches/Release2.1/doc/userguide.tex (modified) (17 diffs)

branches/Release2.1/doc/userguide.tex

@@ -48 +48 @@
 package.
 
-This userguide is being updated for the ASAP 2.1. Please report any
+This userguide has been updated for the ASAP 2.1. Please report any
 mistakes you find.
 
@@ -65 +65 @@
 
 {\em Note. ASAP2.1 only runs on ATNF Linux machines which have been
-updated to Debian Sarge and are using the ``DEBIANsarge''
+updated to Debian Sarge and are using the ``DEBIANSarge''
 /usr/local. If your favourite machine has not been upgraded, send a
-request your your friendly IT support. At the time of writing asap 2.1
+request to your friendly IT support. At the time of writing asap 2.1
 does not run on hydra, bourbon or kaputar.}
 
@@ -77 +77 @@
 \end{verbatim}
 
-This starts the ASAP. To quit, you need to type \verb+^+-d
-(control-d) or type \cmd{\%Exit}.
+This starts ASAP. To quit, you need to type \verb+^+-d (control-d) or
+type \cmd{\%Exit}.
 
 \section{Interface}
@@ -99 +99 @@
 main objects are used :
 
-\begin{itemize}
-  \item[\cmd{scantable}] The data container (actual spectra and header
-    information)
-  \item[\cmd{selector}] Allows the user to select a subsection of the
-    data, such as a specified or range of beam numbers, IFs, etc.
-  \item[\cmd{plotter}] A tool used to plot the spectral line data
-  \item[\cmd{fitter}] A tool used to fit functions to the spectral data
-  \item[\cmd{reader}] A tool which can be used to read data from disks
-    into a scantable object (advanced use).
-\end{itemize}
+\begin{tabular}{ll}
+
+\cmd{scantable} & \parbox[t]{0.7\textwidth}{The data container (actual
+  spectra and header information)} \\
+\cmd{selector} & \parbox[t]{0.80\textwidth}{Allows the user to select
+  a subsection of the data, such as a specified or range of beam
+  numbers, IFs, etc.} \\
+\cmd{plotter} & A tool used to plot the spectral line data \\
+\cmd{fitter} & A tool used to fit functions to the spectral data \\
+\cmd{reader} & \parbox[t]{0.8\textwidth}{A tool which can be used to
+    read data from disks into a scantable object (advanced use).}\\
+\end{tabular}
 
 There can be many objects of the same type. Each object is referred to
@@ -383 +385 @@
 The common selection functions are:
 
-\begin{itemize}
-
-\item[\cmd{set\_beams}] Select beams by index number
-\item[\cmd{set\_ifs}] Select ifs by index number
-\item[\cmd{set\_name}] Select by source name. Can contain ``*'' as a
-wildcard, e.g. ``Orion*\_R''.
-\item[\cmd{set\_ifs}] Select IFs by index number
-\item[\cmd{set\_polarisation}] Select by polarisation index or
-name. If polarisation names are given, the data will be on-the-fly
-converted (for example from linears to Stokes).
-\item[\cmd{set\_query}] Set query directly. For power users only!
-\item[\cmd{set\_tsys}] Select data based on Tsys. Also example of user
-definable query.
-\item[\cmd{reset}] Reset the selection to include all spectra.
-
+\begin{tabular}{ll}
+
+\cmd{set\_beams} & Select beams by index number \\
+\cmd{set\_ifs} & Select ifs by index number \\
+\cmd{set\_name} & Select by source name. Can contain ``*'' as a
+wildcard, e.g. ``Orion*\_R''. \\
+\cmd{set\_ifs} & Select IFs by index number \\
+
+\cmd{set\_polarisation} & \parbox[t]{0.73\textwidth}{Select by
+polarisation index or name. If polarisation names are given, the data
+will be on-the-fly onverted (for example from linears to Stokes). }\\
+
+\cmd{set\_query} & Set query directly. For power users only! \\
+\cmd{set\_tsys} & Select data based on Tsys. Also example of user
+definable query. \\
+\cmd{reset} & Reset the selection to include all spectra. \\
+
+\end{tabular}
 
 Note that all indices are zero based.
@@ -419 +424 @@
 
 \end{verbatim}
-
-\end{itemize}
 
 \subsection{State}
@@ -494 +497 @@
 \end{verbatim}
 
-{\em Currently the following is not implemented
-
-In both of the above modes, you can also specify the rest frequencies via
-names in a known list rather than by their values.
-
-Examples:
-
-\begin{verbatim}
-  ASAP>scans.set_restfreqs(freqs=['OH1665','OH1667'])
-\end{verbatim}
-}
+A predetermined ``line catalog'' can be used to set the rest
+frequency. See section \S \ref{sec:linecat}.
+
 
 \subsubsection{Masks}
@@ -1114 +1109 @@
 zooming the individual plots). From left to right:
 
-\begin{itemize}
-
-\item[Home] This will unzoom the plots to the original zoom factor
-
-\item[Plot history] (left and right arrow). The plotter keeps a
-history of zoom settings. The left arrow sets the plot zoom to the
-previous value. The right arrow returns back again. This allows you,
-for example, to zoom in on one feature then return the plot to how it
-was previously.
-
-\item[Pan] (The Cross) This sets the cursor to pan, or scroll mode
-  allowing you to shift the plot within the window. Useful when
-  zoomed in on a feature.
-
-\item[Zoom] (the letter with the magnifying glass) lets you draw a
-  rectangle around a region of interest then zooms in on that
-  region. Use the plot history to unzoom again.
-
-\item[Adjust] (rectangle with 4 arrows) adjust subplot parameters
-  (space at edge of plots)
-
-\item[Save] (floppy disk). Save the plot as a postscript or .png file
+\begin{tabular}{ll}
+
+Home & This will unzoom the plots to the original zoom factor \\
+
+Plot history & \parbox[t]{0.8\textwidth}{(left and right arrow) The
+plotter keeps a history of zoom settings. The left arrow sets the plot
+zoom to the previous value. The right arrow returns back again. This
+allows you, for example, to zoom in on one feature then return the
+plot to how it was previously. }\\
+
+Pan & \parbox[t]{0.8\textwidth}{(The Cross) This sets the cursor to
+  pan, or scroll mode allowing you to shift the plot within the
+  window. Useful when zoomed in on a feature. }\\
+
+Zoom & \parbox[t]{0.8\textwidth}{(the letter with the magnifying
+  glass) lets you draw a rectangle around a region of interest then
+  zooms in on that region. Use the plot history to unzoom again.}\\
+
+Adjust & \parbox[t]{0.8\textwidth}{(rectangle with 4 arrows) adjust
+  subplot parameters (space at edge of plots)}\\
+
+Save & \parbox[t]{0.8\textwidth}{(floppy disk). Save the plot as a
+postscript or .png file}\\
+
+\end{tabular}
 
 You can also type ``g'' in the plot window to toggle on and off grid
 lines. Typing 'l' turns on and off logarithmic Y-axis.
-
-\end{itemize}
 
 \subsection{Other control}
@@ -1229 +1225 @@
 \bigcommanddef{arrow(x,y,x+dx,y+dy)}{Draw an arrow from a specified
 \cmd{(x,y)} position to \cmd{(x+dx, y+dy)}. The values are in world
-coordinates. \em {HOW TO SET ARROW HEAD??}}{
-  ASAP>plotter.arrow(-40,7,35,0)
+coordinates. Addition arguments which must be passed are {\cmd head\_width} and \cmd{head\_length}}{
+  ASAP>plotter.arrow(-40,7,35,0,head\_width=0.2, head\_length=10)
 }
 
@@ -1236 +1232 @@
 specified \cmd{y} position (in world coordinates) between xmin and xmax
 (in relative coordinates, i.e. 0.0 is the left hand edge of the plot
-while 1.0 is the right side of the plot.}{
+while 1.0 is the right side of the plot).}{
  ASAP>plotter.axhline(6.0,0.2,0.8)
 }
@@ -1271 +1267 @@
 
 \begin{tabular}{ll}
- \tt color  \\
- \tt linewidth \\
+ \tt color, facecolor, edgecolor \\
+ \tt width, linewidth \\
  \tt fontsize \\
  \tt fontname & Sans, Helvetica, Courier, Times etc\\
@@ -1286 +1282 @@
 
 \section{Line Catalog}
-
+\label{sec:linecat}
 \index{Linecatalog}ASAP can load and manipulate line catlogs to
 retrieve rest frequencies for \cmd{set\_restfreqs} and for line
@@ -1295 +1291 @@
 the users own creation or a standard line catalog such as the JPL line
 catalog or Lovas. The ATNF asap ftp area as copies of the JPL and
-Lovas catalog in the appropriate format
-(\cmd{ftp://ftp.atnf.csiro.au/pub/software/asap/data})
+Lovas catalog in the appropriate format:
+
+\hspace{1cm}\cmd{ftp://ftp.atnf.csiro.au/pub/software/asap/data}
+  
 
 \subsection{Loading a Line Catalog}
@@ -1342 +1340 @@
 example). \cmd{set\_frequency\_limits} selects on frequency range,
 \cmd{set\_strength\_limits} selects on intensity while \cmd{set\_name}
-selects on molecule name (wild cards allowed).
+selects on molecule name (wild cards allowed). The \cmd{summary}
+function lists the currently selected lines.
 
 \begin{verbatim}
@@ -1385 +1384 @@
 
   ASAP>plotter.plot()                  # Reset plotter
-  ASAP>plotter.plot_lines(jpl,doppler=-10,location='Top') # On top with -10 km/s velocity
+  ASAP>plotter.plot_lines(jpl,doppler=-10,location='Top') 
+                             # On top with -10 km/s velocity
 \end{verbatim}
 
@@ -1412 +1412 @@
 \end{verbatim}
 
-
-
+For data with many IFs, such as from MOPS, the user it is recommended
+that the user creates their own line cstalog for the data and use this
+to set the rest frequency for each IF.
 
 \section{Fitting}
@@ -2250 +2251 @@
 \subsection{Installation}
 
-\index{Installation}ASAP depends on a number of third-party libraries which you must
-have installed before attempting to build ASAP. These are:
-
-\begin{itemize}
-\item AIPS++
-\item Boost
-\item Matplotlib
-\item python/ipython
-\end{itemize}
-
-Debian Linux is currently supported and we intend also
-to support other popular Linux flavours, Solaris and Mac.
-
-Of the dependencies, AIPS++ is the most complex to install.
+\index{Installation}
+
+Please refer to the asap wiki for instructions on downloading and/or
+building asap from source.
+
+\hspace{1cm}\cmd{http://www.atnf.csiro.au/computing/software/asap/}
 
 \printindex