FORS_WAVE_CALIB_LSS(7)

💖 FORS_WAVE_CALIB_LSS 💖

okay bestie, welcome to FORS_WAVE_CALIB_LSS(7) — yes that's the whole manual-page name, section 7, part of the fors recipes collection. Sit down, grab a strawberry 🍓, we're about to wavelength-calibrate a long slit spectrum and it's gonna be gorgeous.

---

✨ NAME ✨

fors_wave_calib_lss — derive the dispersion relation from a long-slit arc lamp frame. literally what it says on the tin, no cap 🎀

---

🌈 SYNOPSIS 🌈

esorex fors_wave_calib_lss [OPTIONS] FILE.sof

---

🦋 DESCRIPTION 🦋

So this recipe wavelength-calibrates one long slit spectrum — meaning a FORS spectrum you got either in LSS mode or in MOS/MXU mode with all the slits sitting at the same offset. Same vibe either way 💅

The way it works is a pattern-matching algorithm, applied exactly like in the recipe fors_detect_spectra. Want the full tea on this data reduction strategy? Go read the FORS Pipeline User´s Manual, it's all in there 📖

Heads up bestie: if you specify an input GRISM_TABLE, that will set some of the recipe configuration parameters to default values that are valid for a particular grism. so like, it's doing stuff behind your back, but in a helpful way ✨

Also, little note: in the table below you can read the LSS acronym as MOS or MXU instead. same energy, different letters 💫

📥 Input files 📥

• LAMP_UNBIAS_LSS — DO category. Type: Calib. Explanation: Arc lamp exposure. Required: Y ✅
• MASTER_LINECAT — DO category. Type: Calib. Explanation: Line catalog. Required: Y ✅
• GRISM_TABLE — DO category. Type: Calib. Explanation: Grism table. Required: . (so, optional, she's not mandatory 👀)

📤 Output files 📤

• REDUCED_LAMP_LSS — Data type: FITS image. Explanation: Calibrated arc lamp exposure.
• DISP_COEFF_LSS — Data type: FITS table. Explanation: Inverse dispersion coefficients.
• DISP_RESIDUALS_LSS — Data type: FITS image. Explanation: Image of modeling residuals.
• WAVELENGTH_MAP_LSS — Data type: FITS image. Explanation: Wavelengths mapped on CCD.
• SLIT_LOCATION_LSS — Data type: FITS image. Explanation: Background subtracted arc frame.
• SPECTRAL_RESOLUTION_LSS — Data type: FITS table. Explanation: Spectral resolution table.

---

💅 OPTIONS 💅

Nine of them, all iconic, all listed, let's go 🫶

• --dispersion <float> — the expected spectral dispersion, in Angstrom/pixel (float; default: 0.0). The full name of this option for the EsoRex configuration file is fors.fors_wave_calib_lss.dispersion [default = 0.0].
• --peakdetection <float> — the initial peak detection threshold, in ADU (float; default: 0.0). The full name of this option for the EsoRex configuration file is fors.fors_wave_calib_lss.peakdetection [default = 0.0].
• --wdegree <int> — the degree of the wavelength calibration polynomial (int; default: 0). The full name of this option for the EsoRex configuration file is fors.fors_wave_calib_lss.wdegree [default = 0].
• --wradius <int> — the search radius used when iterating pattern-matching with the first-guess method (int; default: 4). The full name of this option for the EsoRex configuration file is fors.fors_wave_calib_lss.wradius [default = 4].
• --wreject <float> — the rejection threshold in the dispersion relation fit, in pixels (float; default: 0.7). The full name of this option for the EsoRex configuration file is fors.fors_wave_calib_lss.wreject [default = 0.7].
• --wcolumn <str> — the name of the line catalog table column that holds the wavelengths (str; default: ´WLEN´). The full name of this option for the EsoRex configuration file is fors.fors_wave_calib_lss.wcolumn [default = WLEN].
• --startwavelength <float> — the start wavelength in spectral extraction (float; default: 0.0). The full name of this option for the EsoRex configuration file is fors.fors_wave_calib_lss.startwavelength [default = 0.0].
• --endwavelength <float> — the end wavelength in spectral extraction (float; default: 0.0). The full name of this option for the EsoRex configuration file is fors.fors_wave_calib_lss.endwavelength [default = 0.0].
• --wmode <int> — the interpolation mode of the wavelength solution (0 = no interpolation, 1 = fill gaps, 2 = global model) (int; default: 2). The full name of this option for the EsoRex configuration file is fors.fors_wave_calib_lss.wmode [default = 2].

FYI bestie: you can create a configuration file holding all these options plus suitable default values. Check the details the 'esorex --help' command gives you 💖

---

🔭 SEE ALSO 🔭

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

ftp://ftp.eso.org/pub/dfs/pipelines/fors/fors-pipeline-manual-4.9.pdf

An overview of all the existing ESO pipelines lives on this web page:

https://www.eso.org/sci/software/pipelines/

Basic documentation about the EsoRex program? That's the esorex(1) man page, babe.

And you can 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 fors pipeline are — roll call, everyone say present 📣

fors_align_sky(7), fors_align_sky_lss(7), fors_bias(7), fors_calib(7), fors_config(7), fors_dark(7), fors_detect_objects(7), fors_detect_spectra(7), fors_extract(7), fors_extract_objects(7), fors_extract_slits(7), fors_flatfield(7), fors_img_science(7), fors_img_screen_flat(7), fors_img_sky_flat(7), fors_normalise_flat(7), fors_photometry(7), fors_pmos_calib(7), fors_pmos_extract(7), fors_pmos_science(7), fors_remove_bias(7), fors_resample(7), fors_science(7), fors_spec_mflat(7), fors_subtract_sky(7), fors_subtract_sky_lss(7), fors_sumflux(7), fors_trace_flat(7), fors_wave_calib(7), fors_zeropoint(7)

---

⭐ VERSION ⭐

fors_wave_calib_lss 5.5.7

---

👑 AUTHOR 👑

Carlo Izzo <usd-help@eso.org> — king behaviour, honestly 🫶

---

🐛 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>. (Yes, same address twice, they really want to hear from you 😭)

---

📜 LICENSE 📜

This file is currently part of the FORS Instrument Pipeline Copyright (C) 2002-2010 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 02110-1301 USA

---

and that's the whole page bestie!! 💖✨🎀🦋🌸 this was fors_wave_calib_lss, version 5.5.7, page 7 of the fors recipes manual — slay, calibrate, and hydrate, ily, bye 👑💅