% @(#)indiskmfit.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:40
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      indiskmfit.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, INDISK/MFITS
%.PURPOSE    On-line help file for the command: INDISK/MFITS
%.VERSION    1.0  31-AUG-2000 : Creation, KB
%----------------------------------------------------------------
\se
SECTION./MFIT
\es\co
INDISK/MFITS						24-JAN-2002  KB
\oc\su
INDISK/MFITS in_file [prefix] [options] [backw_flag] [out_catal]
	create multiple images/tables from a FITS file 
\us\pu
Purpose:
	Create Midas images/tables from all the extensions of a FITS file.
\up\sy
Syntax: 
	INDISK/MFITS in_file [resframe_spec] [options] [backw_flag] [out_catal]
\ys\pa
	in_file = name of FITS file (a), 
            or
            name of single FITS extension (b), 
            specified as: `file.type[ext]' 
\ap\pa
	resframe_spec = root string for name generation (max. 4 chars)
            if in_file = (a), else
            name of result frame (image/table) for (b);
            defaulted to `toto', i.e for (a)
\ap\pa
	options = 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),
		defaulted to: SOY
\ap\pa
	backw_flag = Yes/No (backwards compatibility flag with intape/fits)
	    only applicable for (a) containing no FITS extension,
            i.e. single image or table; defaulted to: Yes
\ap\pa
	out_catal = name of optional catalog which will contain the
	    names of all the Midas frames created from this FITS file
\ap\sa
See also:
	INTAPE/FITS, INDISK/FITS
\as\on
Notes:
	The no. of extensions (including an empty header if present) is
	stored in keyword MID$INFO(4), the return status of the FITS reader
	is saved in OUTPUTI(15).
	   Extensions in a FITS file may be accessed directly in Midas 
	via their number (primary header is #0), or via a string matching the 
	keyword EXTNAME of a given FITS extension.
	E.g. STATISTICS/IMAGE myfile.fits[7] would calculate the statistics
	of the 7th extension of the FITS file myfile.fits.
	   The output catalog option is useful, if you want to rebuild the
	FITS file from all its extensions later on.
 
	   This command also works if the Midas work environment has been
	set to use FITS format for data files, whereas INDISK/FITS or
        INTAPE/FITS do not work in thes circumstances. 
	INDISK/MFITS can then be used to split up a FITS file with 
	extensions into single FITS files (one per extension):
	  SET/MIDAS workenv=FITS
	  INDISK/MFITS fits_file split
          SET/MIDAS workenv=Midas		!if you want it...
	Then you have all extensions of `fits_file' as single FITS
	files split*.fits and split*.tfits.
\no\exs
Examples:
\ex
	INDISK/MFITS lola.fits 
	  Assuming, that `lola.fits' has no extensions, we convert this FITS
          file to `toto0001.bdf' or `toto0001.tbl',
	  depending upon if `lola.fits' was an image or a table.
\xe\ex
	INDISK/MFITS lola.fits ? ? no
	  Convert FITS `lola.fits' to `toto0000.bdf' or `toto0001.tbl',
	  depending upon if `lola.fits' was an image or a table.
\xe\ex
	INDISK/MFITS tst0012.mt[4] chango.tbl
	  Convert extension #4 of FITS file `tst0012.mt' (assuming that
          it is a table extension) to Midas table `chango.tbl'.
\xe\ex
	INDISK/MFITS tst0012.mt[Asciitable] chango.tbl
	  Same as above, if extension #4 has keyword EXTNAME = 'Asciitable'.
\xe\ex
	INDISK/MFITS tst0003.mt 
	  Convert FITS file `tst0003.mt' to `toto0000.xyz', 
          `toto0001.xyz', ..., `totodddd.xyz' (dddd = no. of extensions in
          FITSfile `tst0003.mt'. The file type `xyz' = `bdf' or `tbl'
          depending on type of extension.
\xe\ex
	INDISK/MFITS tst0003.mt p5=names.cat
	  As above but also store all the created file names in image catalog
          `names.cat'.
\xe \sxe