naco_spc_wavecal - Wavelength calibration using arc lamps
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).
- --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.
The full documentation for the naco 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
It is possible to call the pipelines from python using the python-cpl package.
The other recipes of the naco pipeline are naco_img_checkfocus
Lars Lundin <firstname.lastname@example.org>
Please report any problems to email@example.com. Alternatively, you may send a
report to the ESO User Support Department <firstname.lastname@example.org>.
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
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