NACO_SPC_WAVECAL(7)

💖 NACO_SPC_WAVECAL(7) 💖

okay so bestie, welcome to a page from the naco recipes manual — section 7, if you're keeping score — and the star of the show today is naco_spc_wavecal. grab a snack, we're doing wavelength calibration ✨

---

🌈 NAME 🌈

naco_spc_wavecal — wavelength calibration using arc lamps 🕯️✨

---

🦋 SYNOPSIS 🦋

esorex naco_spc_wavecal [OPTIONS] FILE.sof

---

👑 DESCRIPTION 👑

naco_spc_wavecal is literally the NACO spectroscopy wavelength calibration from lamp images. like, the lamps tell us what wavelength is what, and we vibe-check the whole thing 💅

The files listed in the Set Of Frames (sof-file) must be tagged, no exceptions bestie:

• NACO-raw-file.fits CAL_ARC_SPEC
• NACO-spectrum-model.fits SPC_MODEL
• NACO-arc-lines.fits SPC_ARGON

The input frames get split into groups with identical values of ESO DET DIT, ESO INS OPTI1 ID, ESO INS CWLEN and ESO SEQ SPECMODE. same values? same group. periodt 🫶

Also, each input frame must have a value of ESO INS LAMP1 ST that is false for off-frames and true for on-frames. lamp off, lamp on, we love a binary 💀

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

(yes, the original says "were" and not "where" — we keep the facts <em>exactly</em> as they are, even the typos, that's the rule bestie 😌)

---

✨ 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 bestie: 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. iykyk 💅

---

🎀 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) — the whole friend group, we love to see it 🌸

---

⭐ 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>. (two emails, one inbox, we keep it simple 💌)

---

💜 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

⚠️ okay serious moment: that WITHOUT ANY WARRANTY bit is NOT a joke, it's giving real legal weight. read it, respect it, don't skip it 🙏

---

and that's the whole page bestie!! 🦋✨ this was naco_spc_wavecal version 4.4.11, straight from the naco recipes manual — thanks for reading, you ate 💅👑💖