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.10

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