FORS_FLATFIELD(7)

✨ FORS_FLATFIELD(7) ✨

okay so bestie, welcome to the fors_flatfield manual page — it's a section 7 joint from the fors recipes collection, and honestly? it's giving "small recipe, big responsibility" 🫶

---

💖 NAME 💖

fors_flatfield — flat field correction of input frame. that's the whole vibe. it divides stuff. iconically. 💅

---

🌸 SYNOPSIS 🌸

esorex fors_flatfield [OPTIONS] FILE.sof

---

🦋 DESCRIPTION 🦋

so what does this recipe actually DO, you ask? literally the glow-up step for your science frames: it takes your input frame and divides it by the normalised flat field frame — the one that recipe fors_normalise_flat cooked up for you. ✨

heads up bestie: your input frame must already be bias subtracted (like, do it with recipe fors_remove_bias first). no skipping steps, this is not a shortcut era. 😭

and for the record, in the table below the acronym MXU can alternatively be read as MOS and LSS. same energy, different letters. 🎀

📥 Input files 📥

• DO category: SCIENCE_UNBIAS_MXU or STANDARD_UNBIAS_MXU — Type: Raw — Explanation: Bias subtracted frame — Required: Y
• DO category: MASTER_NORM_FLAT_MXU — Type: Calib — Explanation: Normalised flat frame — Required: Y

📤 Output files 📤

• DO category: SCIENCE_UNFLAT_MXU or STANDARD_UNFLAT_MXU — Data type: FITS image — Explanation: Flat field corrected frame

---

🎀 OPTIONS 🎀

ngl, this page lists no options of its own — but here's the note that matters:

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 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 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. 🐍✨

and the other recipes of the fors pipeline are — buckle up, it's a whole friend group 💜:

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

---

⭐ VERSION ⭐

fors_flatfield 5.5.7 — periodt. 💅

---

👑 AUTHOR 👑

Carlo Izzo <usd-help@eso.org> — the mastermind, the moment, the main character. 🫶

---

💀 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>. they want to hear from you, fr fr. 🙈

---

📜 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_flatfield version 5.5.7, living inside the FORS_FLATFIELD(7) manual page — go forth and divide your frames, you absolute legend. 🧚✨🍓