% @(#)indiskfits.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:40
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      indiskfits.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, INDISK/FITS
%.PURPOSE    On-line help file for the command: INDISK/FITS
%.VERSION    1.0  05-NOV-1993 : Creation, KB
%----------------------------------------------------------------
\se
SECTION./FITS
\es\co
INDISK/FITS						28-MAR-2001  KB
\oc\su
INDISK/FITS in_files [out_spec] [option] [check_flag] [INTAPE_flag]
	read FITS files from disk
\us\pu
Purpose:
	  Read FITS files from disk and convert to Midas format.
\up\sy
Syntax: 
          INDISK/FITS in_files [out_spec] [option] [check_flag] [INTAPE_flag]
\ys\pa
          in_files = filename(s) of FITS files separated by a comma;
              or name of ASCII file (indicated by filetype `.cat')
              which contains a FITS filename on each line;
              also wildcard characters are supported.
\ap\pa
          out_spec = corresponding MIDAS filenames separated by a comma;
              or name of ASCII file (indicated by filetype `.cat') with a
              corresponding Midas filename on each line or name of Midas 
              catalog (also indicated by filetype `.cat') with names;
              or string "ROOT=abcd" to build output file names as
              abcd0001.TYPE, abcd0002.TYPE, ... with TYPE is "bdf", "tbl" 
              or "fit" depending on type of FITS file;
              if the param `out_spec' is omitted, output names are built as
              toto0001.TYPE, toto0002.TYPE, ...
\ap\pa
          option = OC or ON to keep the original name of the files,
              i.e if the result files will be named according to the
              FITS keyword FILENAME, so we also execute RESTORE/NAME
              OC - with overwrite confirmation, ON - without confirmation
                = NO for using a name as specified in param `out_spec';
              defaulted to NO
\ap\pa
          check_flag = to check the root_string in the option ROOT=... above
               2 char.flag, (display_flag + action_flag)
               display_flag = Y(es) or N(o) (only if bad chars. found)
               action_flag = S(top), R(eplace) or C(ontinue)
               with respect to dangerous characters in the root string, 
               defaulted to: YR  (bad chars are replaced by `_')
\ap\pa
          INTAPE_flag = 3-character flag: list, create, keyword
                list flag: F(ull), S(hort), N(one) \\
                create flag: N(o create), O(original format),
                             F(loating point format) \\
                keyword flag: Y(es history stored), N(o history stored),
                              C(ode hierarchical keywords) or
                              A(ll keywords stored also with empty
                                data matrix) \\
                defaulted to NOY (so not exactly as in the INTAPE command,
				  where the default is: SOY)
\ap\sa
See also:
          INTAPE/FITS, INDISK/ASCII, INDISK/MFITS,
	  OUTDISK/FITS, OUTTAPE/FITS, RESTORE/NAME [Filename]
\as\no
Note:  
          If not as many output file names as input names are given, the names
          `toto0001.TYPE', `toto0002.TYPE', ... are used.
          The command works for images, tables and fitfiles.
   
          The INTAPE_flag is passed on unchanged to the underlying 
          INTAPE/FITS command.
 
          The parameters may also be cross referenced via
          IN=, OUT=, OPTION=, CHECK= and FLAG=
\on\exs
Examples:
\ex
          INDISK/FITS xyz
            Convert FITS file `xyz' to `toto0001.bdf' or `toto0001.tbl'
            or `toto0001.fit' depending upon if `xyz' was an image, table
            or fit file.
\xe\ex
          INDISK/FITS tst0003.mt prado.midas
            Convert FITS file `tst0003.mt' to `prado.midas'
\xe\ex
          INDISK/FITS tst0004.mt ? OC
            Assuming that the FITS file `tst0004.mt' has a char. FITS keyword 
            named FILENAME containing `vieux_port.bdf' convert FITS file
            `tst0004.mt' to MIDAS file `vieux_port.bdf'. If a file named
            `vieux_port.bdf' already exist, ask for confirmation before
            overwriting it.
\xe\ex
          INDISK/FITS paradis.cat paradis.out
            Read ASCII file `paradis.cat' and convert the FITS files with
            names in that file to MIDAS files with the corresponding names in
            file `paradis.out' 
\xe\ex
          INDISK/FITS paradis.cat ? ON p5=SFY
            Read ASCII file `paradis.cat' and convert the FITS files with
            names in that file to MIDAS files with names as descr. FILENAME
            of the FITS input files (will usually be the same as the physical
            filename...). All image data will be stored as real values.
\xe\ex
          INDISK/FITS luminy*,canebiere.fits panier.dat
            Convert all FITS files matching the pattern `luminy*' as well as
            file `canebiere.fits' to MIDAS files with names according to the
            entries in ASCII file `panier.dat'
\xe\ex
          INDISK/FITS luminy*,canebiere.fits ROOT=cassis
            As above but names of MIDAS files will be built as
            `cassis0001.bdf', `cassis0002.bdf', ...
\xe\ex
          INDISK/FITS luminy*,canebiere.fits ROOT=cas@sis
            As above but `cas@sis0001.bdf' is a bad MIDAS filename, therefore
            a warning message will be displayed and names will be built as
            `cas_sis0001.bdf', `cas_sis0002.bdf', ...
\xe \sxe