Changeset 1264 for branches

Timestamp:

09/11/06 21:44:12 (18 years ago)

Author:

phi196

Message:

Updates from 2.1b tag

File:

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

branches/Release2.1/doc/userguide.tex

@@ -1288 +1288 @@
 \section{Line Catalog}
 
-\index{Linecatalog}ASAP can load and manipulate line catlogs to retrieve rest frequencies
-for \cmd{set\_restfreqs} and for line identification in the
-plotter. No line catalogs are built into ASAP, the user must load a
-ASCII based table (which can optionally be saved in an internal
-format) either of 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. All
-line catalogs are loaded into a ``linecatalog'' object.
+\index{Linecatalog}ASAP can load and manipulate line catlogs to
+retrieve rest frequencies for \cmd{set\_restfreqs} and for line
+identification in the plotter. No line catalogs are built into ASAP,
+the user must load a ASCII based table (which can optionally be saved
+in an internal format) either of 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. All line catalogs are loaded into a ``linecatalog'' object.
 
 \subsection{Loading a Line Catalog}
@@ -1650 +1650 @@
 session. This has the adtantage of speed, but causes limits on the
 size of the dataset which can be loaded. ASAP can use ``disk based''
-scan tables which
+scan tables which cache the bulk of the scantable on disk and require
+significantely less memory usage.
+
+To use disk based tables you either need to change the default in your
+\cmd{.asapr} file, e.g.
+\begin{verbatim}
+   scantable.storage          : disk
+\end{verbatim}
+
+or use set the ``\cmd{rc}'' value while running asap to change this
+on-the-fly. E.g.
+\begin{verbatim}
+  ASAP>rc('scantable',storage='disk')
+  ASAP>data = scantable('data.rpf')     # Loaded using disk based table
+  ASAP>rc('scantable',storage='memory') # Memory tables will be used now
+\end{verbatim}
+
+Changing the ``\cmd{rc}'' value affects the next time the
+\cmd{scantable} constructor is called.
 
 {\bf NOTE: } Currently a bug in ipython means temporary files are not
 cleaned up properly when you exit ASAP. If you use disk based scan
-tables your directory will be left with 'tmp*' directories. These can
+tables your directory will be left with 'tabXXXXX_X' directories. These can
 be safely removed if ASAP is not running.