FORS_EXTRACT_SLITS(7)

📦 version 5.5.7, in ubuntu jammy, ubuntu noble

✨ fors_extract_slits(7) ✨

okay bestie, sit down, hydrate, because we're about to talk about fors_extract_slits — a recipe from the fors pipeline, and it's literally the glow-up station for your spectral images 💅

🌸 NAME 🌸

fors_extract_slits — spatial rectification of spectral image. no cap, that's the whole vibe.

🦋 SYNOPSIS 🦋

esorex fors_extract_slits [OPTIONS] FILE.sof

💖 DESCRIPTION 💖

so this recipe is the one that goes and extracts your MOS/MXU slit spectra — following their curvature the whole way — and then remaps them into a spatially rectified image. it's giving makeover montage, honestly.

if you want the full tea on the spectra remapping technique, go read the FORS Pipeline User´s Manual. but here's the important bit, bestie: the interpolation happens exclusively along the spatial direction, which means the output rectified image keeps the same x size as the input spectral image. it does not stretch horizontally. it said "I'm not doing that." 🫶

also, fun fact: everywhere you see the acronym MXU below, you can read it as MOS instead. same energy, different label.

🎀 Input files

  • DO category: LAMP_UNBIAS_MXU or SCIENCE_UNBIAS_MXU or SCIENCE_UNFLAT_MXU or STANDARD_UNBIAS_MXU or STANDARD_UNFLAT_MXU or UNMAPPED_SCI_MXU or UNMAPPED_STD_MXU or UNMAPPED_SKY_SCI_MXU or UNMAPPED_SKY_STD_MXU — Type: Calib — Explanation: Spectral frame — Required: Y
  • DO category: SLIT_LOCATION_DETECT_MXU or SLIT_LOCATION_MXU — Type: Calib — Explanation: Master flat frame — Required: Y
  • DO category: CURV_COEFF_MXU — Type: Calib — Explanation: Spectral curvature — Required: Y
  • DO category: GRISM_TABLE — Type: Calib — Explanation: Grism table — Required: .

🌈 Output files

  • DO category: RECTIFIED_LAMP_MXU or RECTIFIED_ALL_SCI_MXU or RECTIFIED_ALL_STD_MXU or RECTIFIED_SCI_MXU or RECTIFIED_STD_MXU or RECTIFIED_SKY_SCI_MXU or RECTIFIED_SKY_STD_MXU — Data type: FITS image — Explanation: Rectified slit spectra

✨ OPTIONS ✨

  • --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_extract_slits.dispersion [default = 0.0].
  • --startwavelength <float> — the start wavelength for spectral extraction (float; default: 0.0). the full name of this option for the EsoRex configuration file is fors.fors_extract_slits.startwavelength [default = 0.0].
  • --endwavelength <float> — the end wavelength for spectral extraction (float; default: 0.0). the full name of this option for the EsoRex configuration file is fors.fors_extract_slits.endwavelength [default = 0.0].
  • --flux <bool> — apply flux conservation (bool; default: True). the full name of this option for the EsoRex configuration file is fors.fors_extract_slits.flux [default = True].
💡 oh and btw bestie — you can absolutely make a configuration file holding all these options with whatever default values you want. just go check out what esorex --help tells you. it's right there, i promise 🫶

🔥 SEE ALSO 🔥

the full documentation for the fors pipeline can be downloaded as a PDF file right here:

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

and the other recipes of the fors pipeline, in all their glory: 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_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_wave_calib_lss(7), fors_zeropoint(7). that's the whole friend group 🫂

🌟 VERSION 🌟

fors_extract_slits 5.5.7 — she's evolved, she's thriving ✨

👑 AUTHOR 👑

Carlo Izzo <usd-help@eso.org> — iconic, 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>. same inbox, two ways to slide in, do not be shy 🫶

🌈 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. (yes bestie, that's the all-caps part, we don't joke about it 😭)

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.

okay that's the whole page!! 💜 this was fors_extract_slits, version 5.5.7, from the fors recipes collection — thanks for reading the whole thing, you're literally the main character. periodt. 🎀✨

📦 where this page comes from