% @(#)calibrfero.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:51:43
% @(#)calibrfero.hlq  1.0 (ESO-IPG) 13-11-1997
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1997 European Southern Observatory
%.IDENT      calibrfero.hlq
%.AUTHOR     AM, LSW Heidelberg, IPG/ESO
%.KEYWORDS   MIDAS, help files, CALIBRATE/FEROS
%.PURPOSE    On-line help file for the command: CALIBRATE/FEROS
%.VERSION    1.0  13-NOV-97 : Creation, AM
%----------------------------------------------------------------
\se
SECTION./FEROS
\es\co
CALIBRATE/FEROS                                       23-FEB-99 AM/OS
\oc\su
CALIBRATE/FEROS  [linetable] [referencetable] [instrumparams]
                   [coefftable] [centertable] [getcoeffs]
        Perform wavelength calibration on a spectrum
\us\pu
Purpose:    
        Perform wavelength calibration on a spectrum
\up\sy
Syntax:     
            CALIBRATE/FEROS  [linetable] [referencetable] [instrumparams]
              [coefftable] [centertable] [getcoeffs]

\ys\pa
            linetable = root name of input table

\ap\pa
            referencetable = name of table with laboratory wavelengths

\ap\pa
            instrumparams = alpha,tol,thres,rot,shift,g,f,thetaB
            instrument related parameters
                alpha, tol = parameters for wavelength identification
                thres = threshold for line intensity in initial
                        calibration step
                rot, shift = CCD rotation (degrees), CCD shift (mm)
                g, f, thetaB = grating constant, focal length of camera (mm),
                               blaze angle (degrees)

\ap\pa
            coefftable = table for wavelength calibration coefficients
\ap\pa
            centertable = table for order centers

\ap\pa
            get_coeffs = get coefficients from current spectrum
            valid values are

            C for using previously determined cofficients (default)
            G for using the grating relation
            W for using identified lines from table IDTAB
\ap\sa
See also: 
            SEARCH/FEROS, SEARCH/LINE
\as\no

Note:       
            1) linetable is the root name of the input table. For single
               fiber spectra this is also the complete name of the file.
               For double fiber spectra two input files are read. Their
               names are generated from the root name and the appendices
               1 and 2. linetable can be created by executing the command
               EXTRACT/FEROS.

            2) referencetable is the table with laboratory wavelengths.
               It must contain a column labeled :WAVE with the wavelengths
               in Angstrom. For best results the wavelength table should
               be adapted to the spectral resolution of the spectrograph.

            3) coefftable is the table, in which the wavelength coefficents
               are stored. If getcoeffs is set to N, then the coefficients
               are read from a prevoiusly saved coefftable.

            4) getcoeffs:If getcoeffs is set to N, then coefftable must
               exist on disk.

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

\on\exs
Examples:
\ex
            CALIBRATE/FEROS  found_lines ThAr50000
            Calibtrate spectrum named found_lines with reference table
            named ThAr50000. Use default values for the other parametres.

\xe\ex
            CALIBRATE/FEROS found_lines ThAr50000 ? dispc N
            Calibrate spectrum named found_lines with reference table
            named ThAr50000. Read initial values for dispersion
            coefficients from table named dispc. Use default values for
            the other parameters.
\xe \sxe