FITSLIST


FITSLIST lists the headers of one or more FITS-format files, e.g., map
files  produced  by  programs  INVERT,  CLEAN,  and  MODMAP,  or files
imported from AIPS or elsewhere via  standard  FITS  tapes.   FITSLIST
will list either the headers of all the files on a standard FITS tape,
or the headers of one or more disk files.  The disk files should be in
the  standard  FITS  format.   The  FITS  formats  are  defined in the
following two articles:  "FITS:  a flexible image transport system" by
D.C. Wells,  E.W. Greisen  and  R.H. Harten, Astr.  Astrophys.  Suppl.
v44, pp363-370 (1981), and "An extension of FITS for groups  of  small
arrays  of  data"  by  E.W. Greisen and R.H. Harten, Astr.  Astrophys.
Suppl.  v44, pp371-374 (1981).


Example:  tape

$ FITSLIST
TAPE = "MTA0:"
LIST = "FITSLIST.LIS"
INDEX = "FITSINDEX.LIS"
/
$ 

Example:  disk

$ FITSLIST
INPUT = "CITSCR:[TJP...]*.MAP"
LIST = "FITSLIST.LIS"
/
$ 


Parameters

One of the two parameters INPUT and TAPE must be specified; the others
are  optional.   Parameter  names  can be abbreviated to uniqueness (1
letter).  End the list of parameters with a slash (/).

TAPE = "device-name" :  one of the parameters TAPE and INPUT  must  be
          specified,  but  not both.  To read a FITS tape, specify the
          tape drive to be used with parameter TAPE.  If a tape is not
          currently  mounted  on  the  specified  drive, FITSLIST will
          attempt  to  mount  one,  issuing  an  operator  request  if
          necessary.   FITSLIST  will then attempt to read the headers
          of all the files on the tape, starting at the  beginning  of
          the tape (unless SKIP is specified:  see below) and stopping
          at the first double tape mark or at the first non-FITS file.
          The  tape  is left mounted.  The "device-name" string should
          correspond to the conventions used by the operating  system,
          e.g., TAPE="/dev/rst0" in UNIX, TAPE="SCALAR$MKB400:" in VMS
          (note that the colon is part of the device name).  The  tape
          block  size  should  be  a  multiple  of 2880 bytes, up to a
          maximum of 28800 bytes, according to FITS conventions.

FITSLIST                                                          Page 2


INPUT = "filename" :  if INPUT is specified instead of TAPE,  FITSLIST
          will  read  one  or  more  disk  files.  INPUT specifies the
          filename of the input FITS-format file.  Standard wild cards
          can  be  used, as in the example above (use VMS wild cards *
          and % in VMS, or "sh" wild cards in UNIX).  (Parameter  name
          FILE  can  be  used instead of INPUT; if both are specified,
          FILE is ignored.)

LISTFILE = "filename" :  the filename for the long output listing; the
          default  is file FITSLIST.LIS.  This file receives a copy of
          all the FITS header records of all the files, which  can  be
          rather verbose.

INDEX = "filename" :  the filename for the brief output  listing;  the
          default is the standard output (usually the terminal).  This
          file contains one line for  each  file,  giving  the  object
          name,  date,  and  other vital information, and one line for
          each standard FITS "extension" file.

SKIP = n :  the number of files on the magnetic tape  to  skip  before
          starting  the  scan.   Specify  SKIP  if  you  want to start
          reading part way through a tape.  SKIP is ignored if TAPE is
          not specified.  The default is 0.


History

Version 1.0:  1984 Jan 19 - new program (T.J. Pearson).
Version 1.1:  1984 Feb 23 - add parameter TAPE (TJP).
Version 1.2:  1984 Jun 11 - display FITS XTENSION file headers (TJP).
Version 1.3:  1984 Sep  9 - add SKIP parameter (TJP).
Version 1.3:  1984 Oct 24 - add automatic mount of TAPE (no change to
                            main program) (TJP).
Version 1.4:  1986 Apr 22 - cosmetic changes to source code (TJP).
Version 1.5:  1987 Jan  7 - change 'FILE' to 'INPUT'; 'FILE' retained
                            as an alias (TJP).
Version 1.6:  1987 Dec 10 - add INDEX parameter (TJP).
Version 2.0:  1988 Apr 23 - Convex version, uses MTPCKG (TJP).
Version 2.1:  1990 May 14 - use RDFITS routine (TJP).
Version 2.2:  1990 Aug 24 - display CRVAL4 for uvdata (TJP).
Version 3.0:  1992 May  5 - accept blocked FITS tapes (TJP).
Version 3.1:  1992 Oct  8 - improved error message (TJP).