% @(#)merge_fero.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:51:44
% @(#)merge_fero.hlq  1.0 (ESO-IPG) 14-11-1997
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1997 European Southern Observatory
%.IDENT      merge_fero.hlq
%.AUTHOR     AM, LSW Heidelberg, IPG/ESO
%.KEYWORDS   MIDAS, help files, MERGE/FEROS
%.PURPOSE    On-line help file for the command: MERGE/FEROS
%.VERSION    1.0  14-NOV-97 : Creation, AM
%----------------------------------------------------------------
\se
SECTION./FEROS
\es\co
MERGE/FEROS                                           23-FEB-99 AM/OS
\oc\su
MERGE/FEROS  [inimage] [outimage]
        Merge several orders into one spectrum
\us\pu
Purpose:    
        Produce a 1-D spectrum from a rebinned order by order file

\up\sy
Syntax:     
            MERGE/FEROS [inimage] [outimage]  [params] [method]

\ys\pa
            inimage = root name of input file with rebinned
                      order by order spectra

\ap\pa
            outimage  = root name of output file with merged
                        one-dimensional spectrum

\ap\pa
            params   = method NOAPPEND : order numbers (ord1,ord2).
                       method AVERAGE  : wavelength interval to be skipped
                       and method SINC   at both edges of the overlapping
                                         region. 

\ap\pa
            method =   NOAPPEND : get individual orders as 1D files.
                       AVERAGE  : merge all the orders into a 1D file
                       SINC     : similar to AVERAGE, but cut reject
                                  overlapping outside 1.5 times free
                                  spectral range (needs table BLAZE)

\ap\sa
See also: 
            REBIN/FEROS, MERGE/ECHELLE

\as\no
Note:       
            1) inimage is the root name of the input image
               (rebinned spectrum). For single fiber spectrographs
               this is also the complete name of the input image.
               For double fiber spectra two input images are read.
               Their names are generated from the root name and the
               appendices 1 and 2. inimage can be created by executing
               the command REBIN/FEROS.

            2) outimage is the root name of the output image
               (merged spectrum). For single fiber spectrographs
               this is also the complete name of the output image.
               For double fiber spectra two output images are created.
               Their names are generated from the root name and the
               appendices 1 and 2.

            3) The command MERGE/ECHELLE is invoked by this command.
               The echelle context keyword MGOPT is filled with the
               feros context keyword MERGE_OPT.

            4) The distinction between single fiber and double fiber is
               made via the keyword FIBER_MODE.

\on\exs
Examples:
\ex
            MERGE/FEROS  rebinned_spec merged_spec
            Merge the orders in the rebinned spectrum named
            rebinned_spec to a one-dimensional spectrum named
            merged_spec.

\xe\ex
            MERGE/FEROS rebinned_spec merged_spec 3.0 AVERAGE
            Merge the orders in the rebinned spectrum named
            rebinned_spec to a one-dimensional spectrum named
            merged_spec using averaging in overlapping regions
            and skipping 3.0 Angstroms at the edges of the
            overlapping orders.
\xe \sxe