NAME

       naco_spc_wavecal - Wavelength calibration using arc lamps

SYNOPSIS

       esorex naco_spc_wavecal [OPTIONS] FILE.sof

DESCRIPTION

       naco_spc_wavecal -- NACO spectrocopy wavelength calibration from lamp images.

       The  files  listed  in  the  Set  Of  Frames  (sof-file)  must be tagged: NACO-raw-file.fits CAL_ARC_SPEC
       NACO-spectrum-model.fits SPC_MODEL NACO-arc-lines.fits SPC_ARGON

       The input frames are split into groups with identical values of ´ESO DET DIT´, ´ESO INS OPTI1  ID´,  ´ESO
       INS CWLEN´ and ´ESO SEQ SPECMODE´.

       Furthermore, each input frame must have a value of ESO INS LAMP1 ST that is false for off-frames and true
       for on-frames.

       Products:  ARC_MAP: Primary HDU with the wavelength map, i.e. the pixel values are wavelengths. The first
       extension is a single-row table with the polynomial coefficients of the 2D dispersion relation, lambda  =
       P(x, y).

       ARC_IMAGE:  Primary  HDU  with the difference image of the lamp-on and -off image. The first extension is
       the distortion corrected image, were all the arc-lines are straight. The  dispersion  in  the  distortion
       corrected image is given by the central dispersion, lambda = P(512.5, y).

OPTIONS

       --plot <int>
              The  recipe  can  produce  a  number  of  predefined  plots. Zero means that none of the plots are
              produced, while increasing values (e.g. 1 or 2) increases the number of  plots  produced.  If  the
              plotting  fails  a  warning  is  produced,  and the recipe continues. The default behaviour of the
              plotting is to use gnuplot (with option -persist). The recipe currently  produces  1D-plots  using
              gnuplot  commands.  The  recipe user can control the actual plotting-command used by the recipe to
              create the plot by setting the environment variable CPL_PLOTTER. Currently, if CPL_PLOTTER is  set
              it  must  contain the string ´gnuplot´. Setting it to ´cat > my_gnuplot_$$.txt´ causes a number of
              ASCII-files to be created, which each produce a plot when given as standard input to gnuplot (e.g.
              later or on a different computer). A finer control of the plotting  options  can  be  obtained  by
              writing  an executable script, e.g. my_gnuplot.pl, that executes gnuplot after setting the desired
              gnuplot options (e.g. set terminal pslatex color) and then setting CPL_PLOTTER  to  my_gnuplot.pl.
              The  predefined plots include plotting of images. Images can be plotted not only with gnuplot, but
              also using the pnm format. This  is  controlled  with  the  environment  variable  CPL_IMAGER.  If
              CPL_IMAGER is set to a string that does not contain the word gnuplot, the recipe will generate the
              plot  in  pnm  format.  E.g.   setting CPL_IMAGER to ´display - &´ will produce a gray-scale image
              using the image viewer display. (int; default: 0). The full name of this  option  for  the  EsoRex
              configuration file is naco.naco_spc_wavecal.plot [default = 0].

       --force <bool>
              Force  the  computation  (bool;  default:  False).  The  full  name  of this option for the EsoRex
              configuration file is naco.naco_spc_wavecal.force [default = False].

       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' command.

SEE ALSO

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

              ftp://ftp.eso.org/pub/dfs/pipelines/naco/naco-pipeline-manual-1.1.pdf

       An    overview    over    the    existing    ESO    pipelines    can   be   found   on   the   web   page
       https://www.eso.org/sci/software/pipelines/.

       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
       https://packages.python.org/python-cpl/index.html for further information.

       The  other recipes of the naco pipeline are naco_img_checkfocus(7), naco_img_dark(7), naco_img_detlin(7),
       naco_img_jitter(7), naco_img_lampflat(7),  naco_img_slitpos(7),  naco_img_strehl(7),  naco_img_twflat(7),
       naco_img_zpoint(7),       naco_spc_combine(7),       naco_spc_lampflat(7),      naco_util_img_std_cat(7),
       naco_util_spc_argon(7), naco_util_spc_model(7)

VERSION

       naco_spc_wavecal 4.4.11

AUTHOR

       Lars Lundin <usd-help@eso.org>

BUG REPORTS

       Please report any problems to usd-help@eso.org. Alternatively, you may send a  report  to  the  ESO  User
       Support Department <usd-help@eso.org>.

LICENSE

       This  file is part of the NACO Instrument Pipeline Copyright (C) 2002, 2003, 2005, 2008 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., 51 Franklin St, Fifth Floor, Boston, MA  02111-1307  USA

naco_spc_wavecal                                     4.4.11                                  NACO_SPC_WAVECAL(7)