% @(#)calibreche.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:50:35 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      calibreche.hlq
%.AUTHOR     PB, IPG/ESO
%.KEYWORDS   MIDAS, help files, CALIBRATE/ECHELLE
%.PURPOSE    On-line help file for the command: CALIBRATE/ECHELLE
%.VERSION    1.0  08-FEB-1991 : Creation, PB
%----------------------------------------------------------------
\se
SECTION./ECHE
\es\co
CALIBRATE/ECHELLE		                 25-SEP-1991   PB
\oc\su
CALIBRATE/ECHELLE  [defmtd]  [wlcmtd]
	performs order definition and wavelength calibration
\us\pu
Purpose:    
            Perform the initial steps of an echelle reduction, i.e.
            a)  trace orders and create tables order.tbl and back.tbl
            b)  extract wavelength comparison spectrum and create
                table line.tbl
            c)  perform the wavelength calibration. 
\\
            This command combines several lower-level commands. It is 
            strongly recommended that echelle beginners familiarize 
            themselves with them:
\\
            DEFINE/ECHELLE, DEFINE/HOUGH
\\
            EXTRACT/ECHELLE
\\
            SEARCH/ECHELLE
\\
            IDENT/ECHELLE
\\
            PLOT/RESIDUAL
\\
            INI/ECH, SET/ECH, SHO/ECH, HELP/ECH  (see note below)
\up\sy
Syntax:     
            CALIBR/ECH [defmtd]  [wlcmtd]
\ys\pa
            defmtd = order definition method as
\\
                     STANDARD     : if order width is smaller than the
                                    interorder space
\\
                     COMPLETEMENT : if order width is greater than the
                                    interorder space
\\
                     HOUGH        : to perform the order detection by
                                    Hough transform.
\ap\pa
            wlcmtd = wavelength calibration method as:
\\
                     PAIR    : interactive identification of two lines
                               in overlapped regions of the spectrum.
\\
                     ANGLE   : interactive identification of four lines.
\\
                     GUESS   : to use a previous session as a guess.
                               (specified by SET/ECH GUESS=...)
\\
                     RESTART : to reuse last pointed lines
\\
                     ORDER   : to recompute single-order solutions
                               with a new TOL parameter.
\ap\no
Note:       
            Most of the parameters required to control this command 
            are set and checked using the SET/ECHE, SHOW/ECHE, HELP/ECHE
            commands. The sections of the SHOW/ECHELLE that must be
            checked are:\\
               1. Order definition\\
               4. Extraction\\
               5. Lines searching\\
               6. Wavelength calibration
\on\exs
Examples:
\ex
            CALIBRATE/ECHELLE
\xe\ex
            SET/ECHELLE   WLCMTD=ANGLE WLCLOOP=0.5,1.5,10
\xe\ex
            CALIBRATE/ECHELLE
\xe\ex
            SET/ECHELLE WLCMTD=GUESS  GUESS=casp
\xe\ex
            CALIBRATE/ECHELLE
\xe\sxe