Displays

  There are three main areas of help information: CAR\_HELP for information
  about the CAR routines; CAT\_HELP for information about the catalogues and
  SCAR\_HELP for general information.

\begin{terminalv}

ICL> CAR_HELP
SCAR COMMANDS Subtopic? CAR_SEARCH

\end{terminalv}

You would find information about the CAR\_SEARCH procedure.

\begin{terminalv}

ICL> CAT_HELP
Topic? $Summary

\end{terminalv}

  The catalogues are summarised in this help library.
  The acronym for the IRAS point source catalogue is IRPS.

  ******************************************************************************

  The parameters\footnote{By the way, this is how to insert a footnote} before
  the ‘;’ are input parameters; those after are output parameters.
  Routines belonging to the HDS kernel are identified by the symbol ‘[K]’.

  \noindent
  \textbf{CMP\_GET0x}\emph{(loc,name;value,status)} --- Read scalar component\\
  \textbf{CMP\_GET1x}\emph{(loc,name,elx;value,el,status)} --- Read vector component\\
  \textbf{CMP\_GETNx}\emph{(loc,name,ndim,dimx;value,dim,status)} --- Read array
  component\\
  \textbf{CMP\_GETVx}\emph{(loc,name,elx;value,el,status)} --- Read vectorised
  component\\
  \textbf{CMP\_LEN}\emph{(loc,name;len,status)} --- Enquire component precision\\

  ******************************************************************************

  These are the catalogues online at RAL, (R = Access restricted):
  \begin{quote}
    \begin{description}
      \item [AIPS] -- Associations of IRAS point sources.
      \item [AS85] -- CHART Astrometry catalogue.
      \item [ASIR] -- Global Index for AIPS and IRPS.
      \item [ASSC] -- Associations of IRAS Small Scale Structure Catalogue.
      \item [CATX] -- Catalogue X: Merger of UGC, ESOB, CGCG.
      \item [CSIS] -- CHART CSI 1979 Version.
    \end{description}
  \end{quote}

There are three main areas of help information: CAR_HELP for information about the CAR routines; CAT_HELP for information about the catalogues and SCAR_HELP for general information.

ICL> CAR_HELP
SCAR COMMANDS Subtopic? CAR_SEARCH

ICL> CAT_HELP
Topic? $Summary

The catalogues are summarised in this help library. The acronym for the IRAS point source catalogue is IRPS.

The parameters¹ before the ‘;’ are input parameters; those after are output parameters. Routines belonging to the HDS kernel are identified by the symbol ‘[K]’.

CMP_GET0x(loc,name;value,status) — Read scalar component
CMP_GET1x(loc,name,elx;value,el,status) — Read vector component
CMP_GETNx(loc,name,ndim,dimx;value,dim,status) — Read array component
CMP_GETVx(loc,name,elx;value,el,status) — Read vectorised component
CMP_LEN(loc,name;len,status) — Enquire component precision

  The error status code symbol is constructed by concatenating the string
  ‘ERR\_’ with an error code.
  The error codes and their meanings are listed below:
  \begin{description}
    \item [DIMINV]:
    \emph{Dimensions invalid (out-of-range)}.
    It is likely that certain groups of users will be restricted in the size of the
    frames they can access.
    RDIMAG and WRIMAG return this status if the user has insufficient quota to map
    the frame.
    This status will also be set when attempting to create an output frame of a
    negative or zero size.
    \item [DSCNPR]:
    \emph{Descriptor item not present}.
    For DLDSCR and RDDSCR, the specified descriptor item name cannot be found within
    the frame’s descriptor.
    For RDDSCN, no item can be found with the specified name as the end of the
    descriptor list was encountered.
  \end{description}

  ******************************************************************************

  This program allows you to specify fields within any catalogue and then perform
  statistical analysis on the selected fields(s).
  \begin{description}
    \item [ANALYSE/HISTOGRAM] --
    This is option 1 on the first menu.
    You will be prompted for the name of the input catalogue and the name of the
    field to be analysed.
    The field values are read in from the catalogue and the mean, mode standard
    deviation, maximum and minimum values are presented to you.
    You can identify any statistic by looking up HIST in the help libraries.
    You should note X\_MAX, X\_MIN and MODE\_SZ for designing the axis scales of
    your plot.
    \begin{description}
      \item [Prompts] --
      \begin{description}
        \item [STYLE] -- The user selection from a menu.
        The expected input is an integer and ranges from the values shown on the menu.
        \item [INPUT] -- The name of the catalogue from which the field is to be taken.
        \item [PTYPE] - The type of plot you want; this is either a connected point graph or
        a standard histogram.
      \end{description}
    \end{description}
    \item [ANALYSE/SCATTERPLOT] --
    This is option 2 on the first menu.
    Linear regression is performed on the two specified fields and then a scatter
    diagram with the line of best fit is plotted.
    \begin{description}
      \item [Prompts] --
      \begin{description}
        \item [STYLE]-- Select from a menu; the expected input is an integer
        and ranges from the values shown on the menu.
        \item [INPUT] -- The name of the catalogue from which the field is to be taken.
      \end{description}
    \end{description}
  \end{description}

The error status code symbol is constructed by concatenating the string ‘ERR_’ with an error code. The error codes and their meanings are listed below:

This program allows you to specify fields within any catalogue and then perform statistical analysis on the seclected fields(s).

¹By the way, this is how to insert a footnote

5 Displays