Provided by: cpl-plugin-kmos-doc_2.1.0+dfsg-1_all bug


       kmos_wave_cal - Create a wavelength calibration frame


       esorex kmos_wave_cal [OPTIONS] FILE.sof


       This  recipe  creates  the wavelength calibration frame needed for all three detectors. It
       must be called after the kmo_flat recipe, which  generates  the  two  spatial  calibration
       frames  needed  in  this  recipe.  As input a lamp-on frame, a lamp-off frame, the spatial
       calibration frames and the list with the reference arclines are required.

       An additional output frame is the resampled image of  the  reconstructed  arc  frame.  All
       slitlets  of  all  IFUs  are  aligned one next to the other. This frame serves for quality
       control. One can immediately see if the calibration was successful.

       The lists of reference arclines are supposed to  contain  the  lines  for  both  available
       calibration  arc-lamps,  i.e.  Argon  and Neon. The list is supposed to be a F2L KMOS FITS
       file with three columns:      1. Reference wavelength      2.  Relative  strength       3.
       String  either  containing “Ar” or “Ne” The recipe extracts, based on the header keywords,
       either the applying argon and/or neon emission lines. Below are the plots of the  emission
       lines  for  both  argon  and  neon.  The  marked  lines  are  the ones used for wavelength

       Furthermore frames can be provided for several rotator angles. In this case the  resulting
       calibration frames for each detector are repeatedly saved as extension for every angle.

       --order The polynomial order to use for the fit of the wavelength solution.

       0:  (default)  The  appropriate order is chosen automatically depending on the waveband (4
       for IZ band, 5 for HK, 6 for the others)

       --b_samples The number of samples in spectral direction for the reconstructed cube.

       Ideally this number should be greater than 2048, the detector size.

       --suppress_extension If set to TRUE, the arbitrary filename extensions are  supressed.  If
       multiple  products with the same category are produced, they will be numered consecutively
       starting from 0.

       --lines_estimation If set to TRUE, the lines estimation method is used

       Input files:

          DO category       Type   Explanation                    Required #Frames
          -----------       -----  -----------                    -------- -------
          ARC_ON            RAW    Arclamp-on exposure                Y        >=1
          ARC_OFF           RAW    Arclamp-off exposure               Y          1
          XCAL              F2D    x calibration frame                Y          1
          YCAL              F2D    y calibration frame                Y          1
          ARC_LIST          F2L    List of arclines                   Y          1
          FLAT_EDGE         F2L    Fitted edge parameters             Y          1
          REF_LINES         F2L    Reference line table               Y          1
          WAVE_BAND         F2L    Table with start-/end-wavelengths  Y          1

       Output files:

          DO category       Type   Explanation
          -----------       -----  -----------
          LCAL              F2D    Wavelength calibration frame
                                   (3 Extensions)
          DET_IMG_WAVE      F2D    reconstructed arclamp-on exposure
                                   (4 extensions: 3 detector images +
                                   the arclines list table)


       --order <int>
              The fitting polynomial order used for the wavelength solution. By default, 4 for IZ
              band,  5  for  HK, 6 for the others (int; default: 0). The full name of this option
              for the EsoRex configuration file is kmos.kmos_wave_cal.order [default = 0].

       --suppress_extension <bool>
              Suppress arbitrary filename extension (bool; default: False). The full name of this
              option  for  the EsoRex configuration file is kmos.kmos_wave_cal.suppress_extension
              [default = False].

       --lines_estimation <bool>
              Trigger lines estimation method (bool; default:  False).  The  full  name  of  this
              option  for  the  EsoRex  configuration file is kmos.kmos_wave_cal.lines_estimation
              [default = False].

       --b_samples <int>
              The number of samples in wavelength  for  the  reconstructed  cube  (int;  default:
              2048).  The  full  name  of  this  option  for  the  EsoRex  configuration  file is
              kmos.kmos_wave_cal.b_samples [default = 2048].

       --det <int>
              Only reduce the specified detector (int; default: 0). The full name of this  option
              for the EsoRex configuration file is kmos.kmos_wave_cal.detector [default = 0].

       --angle <float>
              Only  reduce  the  specified  angle  (float; default: 370.0). The full name of this
              option for the EsoRex configuration file  is  kmos.kmos_wave_cal.angle  [default  =

       Note  that  it  is possible to create a configuration file containing these options, along
       with suitable default values. Please refer to the details provided by the 'esorex  --help'


       The  full  documentation  for  the kmos pipeline can be downloaded as a PDF file using the
       following URL:


       An  overview  over  the  existing  ESO  pipelines  can  be   found   on   the   web   page

       Basic documentation about the EsoRex program can be found at the esorex (1) man page.

       It  is  possible  to  call  the  pipelines  from python using the python-cpl package.  See for further information.

       The  other  recipes   of   the   kmos   pipeline   are   kmo_arithmetic(7),   kmo_copy(7),
       kmo_fit_profile(7), kmo_fits_strip(7), kmo_make_image(7), kmo_noise_map(7), kmo_rotate(7),
       kmo_shift(7),    kmo_sky_mask(7),     kmo_stats(7),     kmos_combine(7),     kmos_dark(7),
       kmos_extract_spec(7),     kmos_flat(7),     kmos_gen_reflines(7),    kmos_gen_telluric(7),
       kmos_illumination(7),     kmos_reconstruct(7),     kmos_sci_red(7),     kmos_sky_tweak(7),
       kmos_std_star(7), kmos_test(7)


       kmos_wave_cal 2.1.0


       Alex Agudo Berbel, Yves Jung <>


       Please  report  any  problems to Alternatively, you may send a report to
       the ESO User Support Department <>.


       This file is part of the CRIRES  Instrument  Pipeline  Copyright  (C)  2002,2003  European
       Southern Observatory

       This program is free software; you can redistribute it and/or modify it under the terms of
       the GNU General Public License as  published  by  the  Free  Software  Foundation;  either
       version 2 of the License, or (at your option) any later version.

       This  program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
       without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR  PURPOSE.
       See the GNU General Public License for more details.

       You should have received a copy of the GNU General Public License along with this program;
       if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite  330,  Boston,
       MA  02111-1307  USA