% @(#)iue_in.hlq	6.1.1.2 (ESO-IPG) 11/11/93 16:39:38
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.IDENT      iue_in.hlq
%.AUTHOR     JDP - ESA, VILSPA
%.KEYWORDS   MIDAS, help files
%.PURPOSE    On-line help file for the command: IUE/IN
%.VERSION    1.0  25-APR-1991 : Creation, JDP
%.VERSION    1.1  12-MAY-1992 : Update, KB
%----------------------------------------------------------------
\se
SECTION./IN  
\es\co
IUE/IN                                                         28-NOV-1991 JDP
\oc\su
IUE/IN file_specs name device [selection] [flags]
	read IUE data in GO format
\us\pu
Purpose: 
          Read IUE data in GO format from tape and convert the file into
          MIDAS format on disk. 
\up\sub
Subject:
          IUE, Spectroscopy
\bus\sy
Syntax: 
          IUE/IN file_specs name device [selection] [flags]
\ys\pa
          files_specs = List of files indicating the files to be read.
               Files are specified by sequential order on tape. The files are
               read if the file types agree with the selection parameter
               described below.
\\
               The sequential order is indicated by integer numbers separated
               by commas or hyphens, without blanks, e.g. 2,17,22-33,44
               specifies frames 2, 17, 22 till 33, 44
\ap\pa
          name = character string to define the file name or the keyword IUE;
\\
               the filename is generated appending the relative file no. on
               tape to the file identification;
\\
               E.g.: test0010.bdf is the 10th file on tape if you specify
               `test' as name.
\\
               The keyword IUE used as name indicates that the filename is
               generated from the camera and image number. 
\\
               E.g.: swp01446.raw is a raw image, swp01446.tbl is the table
               with the large aperture spectral data.
\ap\pa
          device = name of magtape unit
\ap\pa
          selection = indicates a set of file types to be selected as 
\\
               A - All data types, R - Raw image 
\\
               P - Photometrically corrected image 
\\
               E - (Extended) line by line data 
\\
               L - Low dispersion spectrum, H - High dispersion spectrum 
\\
               File types can be mixed as indicated in the examples below.
\ap\pa
          flags = Two letter code;
\\
               The first letter defines the internal format on disk as follows:
\\
               I - integer data for RAW (I*1) and PHOT (I*2) 
\\
               R - floating point for RAW and PHOT (R*4) 
\\
               X - data is not written on disk, this option is used to display
               the headers.
\\
               The second letter controls the header display as follows: 
\\
               N - no header display 
\\
               S - Short header display (first 5 lines) 
\\
               F - Full display of the header (except for the binary part) ;
\\
               defaulted to IS
\ap\see
See also:
          INTAPE/FITS
\ees\no
Note:   
          Output files are images for RAW, PHOT, (E)LBL, and FES data types, 
          and tables for MELO and MEHI extracted spectra.
\\ 
          The tables store spectra in the following columns:
\\
          :WAVELENGTH  Wavelength in Angstrom (F8.3) 
\\
          :EPSILON     Quality flag (I5) 
\\
          :GROSS       Gross spectrum (E12.4)
\\
          :BACKGROUND  Interorder background (E12.4)
\\
          :NET         Net (i.e.,Gross - smoothed background) (E12.4)
\\
          :RNET        Ripple corrected net (high disp only) (E12.4)
\\
          :FLUX        Absolute flux in Erg/cm2/A (E12.4) 
\\
          :ORDER       Order number (high disp only) (I4)
\on\exs
Examples:
\ex
          IUE/IN 1-15 hgc TAPE1 A F
          Read files 1 through 15 on the magtape mounted on unit TAPE1 and
          store them into frames hgc0001.typ to hgc0015.typ, where `typ' is
          `bdf' (`tbl') for images (spectra). The headers are fully displayed.
\xe\ex
          IUE/IN 1,5-10 IUE TAPE1 RP
          Read RAW and PHOTOM files 1 and from 5 to 10 on TAPE1. Output files
          are named by camera and image number.
\xe\ex
          IUE/IN 1-7 A TAPE0 A XF 
          Lists the full header of the files 1 to 7 on tape, without writing
          the files to disk. Used to list the tape contents.
\xe\sxe