bionic (7) naco_spc_wavecal.7.gz

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 .

       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 <long>
              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. (long; 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
       http://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
       http://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.3

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