% @(#)createost.hlq	1.1 (ESO-IPG) 5/11/93 13:32:41
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1993 European Southern Observatory
%.IDENT      createost.hlq
%.AUTHOR     05-MAY-93, IPG/ESO
%.KEYWORDS   MIDAS, help files, 
%.PURPOSE    On-line help file for the command: CREATE/OST
%.VERSION    1.0  MP : Creation, 05-MAY-93
%----------------------------------------------------------------
\se
SECTION./OST
\es\co
CREATE/OST					   MP  05-MAY-93
\oc\su
CREATE/OST  file_specs [file_pref] intable outtable flag
   create an Observation Summary Table	 
\us\pu
Purpose:    
            create an Observation Summary Table 
\up\sy
Syntax:     
            CREATE/OST  file_specs [file_pref] intable outtable flag
\ys\pa
            file_specs = list of numbers of files to be processed (a) or
                         file specification as used in the VMS `$ DIRECTORY'
                         or UNIX `$ ls ' command (b) ( * matches  zero or more
                         characters, ? matches any single character, [] matches
                         one of the enclosed characters)
 \\
\ap\pa
            file_pref    = prefix of the files names. Used only with the option 
                         (a) of file_specs. The filenames will be built by
                         appending to the prefix the file number and the file
                         extension specified by "flag"
 \\
\ap\pa
            intable    = name of the input table containing the list of the
                         MIDAS descriptors to be mapped into the columns of the 
                         output table.
\ap\pa
            outtable   = name of the Observation Summary Table

\ap\pa
            flag       = 2-character flag: file format, append
                       file format flag : 
                       F(its), the file extension .mt is assumed when the 
                       option a) is used.
                       M(idas), the file extension is .bdf is assumed when the
                       option a) is used.
                       append flag: A(append to an existing OST) 
                                    C(reate a new OST)
                       Default flags are FC.
   
\ap\sa
See also: 
            CREATE/TABLE
\as\no
Note:       
            1) The Input Table must contain the followings columns:
\\{\tt
               DESCR_INAME (Character Column): contains the list of MIDAS  
\\
                                               descriptors to be mapped
\\
                                               into the columns of the OST.
\\
               IPOS        (Integer Column)  : contains for each descriptor 
\\
                                               the position of the element
\\
                                               to be read.
\\
               DESCR_ONAME (Character Column): contains for each descriptor
\\
                                               the label of the column of the 
\\
                                               OST in which will be stored its 
\\
                                               values
\\
               OTYPE       (Character Column): contains for each descriptor
\\
                                               the type of the column of the 
\\
                                               OST in which will be stored its
\\
                                               values 
\\
                                               I (integer), R(eal), D(double 
\\
                                               precision), C*n(character string)
\\}

            2) The command maps each of the MIDAS descriptors
               from the column DESCR_INAME of the Input Table into one column
               of the Output Table. The values of these descriptors are read  
               from each of the files of file_spec and are stored into one
               row of the Output Table. If a descriptor contains more than
               one element, the one at the position defined in the column :IPOS
               is taken.\\
               
\\
           3) The way FITS keywords are translated into MIDAS descriptors
              is decribed in the Chapter 7 of Volume A.
 \\
\on\exs
Examples:
\ex
            CREATE/OST ntt3*.mt ? ntt_descr ntt_ost 
            Process all the FITS files whose names match the pattern ntt3*.mt
            Read for each of them the values of the descriptors listed in 
            column :descr_iname of  table ntt_descr and store them in table
            ntt_ost
\\            
\xe\ex
            CREATE/OST 3-5 ntt ntt_descr ntt_ost MA
            Process the MIDAS images ntt0003.bdf, ntt0004.bdf, ntt0005.bdf,
            Read for each of them the values of the descriptors listed in
            column :descr_iname of the  table ntt_descr and append them
            in the existing table ntt_ost
\xe \sxe
