FORS_PHOTOMETRY(7)

✨ FORS_PHOTOMETRY ✨

okay bestie, sit down, we're doing fors_photometry — it's a recipe from the fors pipeline family and it lives in section 7 of the manual. What does it do? It computes the corrected flatfield. That's it, that's the whole gig. 💅

---

🌸 SYNOPSIS 🌸

esorex fors_photometry [OPTIONS] FILE.sof

---

🦋 DESCRIPTION 🦋

💖 Input files (what you gotta feed it)

Each one has a DO category, a type, an explanation, and a number. No skipping, okay?

• PHOT_TABLE — FITS table — expected extinction params — number: 1
• ALIGNED_PHOT — FITS table — photometry — number: 1+
• MASTER_SKY_FLAT_IMG — FITS image — master flat field — number: 1

✨ Output files (what it hands back to you)

• PHOT_COEFF_TABLE — FITS image — observed extinction coefficients
• CORRECTION_MAP — FITS image — correction map (magnitude)
• CORRECTION_FACTOR — FITS image — correction map (flux)
• MASTER_FLAT_IMG — FITS image — corrected master flat field

like… the glow-up of flatfields. periodt. 🌈

---

🎀 OPTIONS 🎀

Every single one, in order, no crumbs left behind. Each one also has a full name for the EsoRex configuration file, because of course it does.

• --fitz <bool> — fit zeropoint (bool; default: True). The full name of this option for the EsoRex configuration file is fors.fors_photometry.fitz [default = True].
• --fit_all_mag <bool> — always fit star magnitudes (bool; default: False). The full name of this option for the EsoRex configuration file is fors.fors_photometry.fit_all_mag [default = False].
• --fite <str> — fit atmospheric extinctions (str; default: pernight). The full name of this option for the EsoRex configuration file is fors.fors_photometry.fite [default = pernight].
• --fitc <bool> — fit color correction term (bool; default: False). The full name of this option for the EsoRex configuration file is fors.fors_photometry.fitc [default = False].
• --use_all_stars <bool> — use also non-standard stars to fit polynomial f (bool; default: False). The full name of this option for the EsoRex configuration file is fors.fors_photometry.use_all_stars [default = False].
• --degreef1 <int> — flatfield correction map polynomial degree (x) (int; default: 0). The full name of this option for the EsoRex configuration file is fors.fors_photometry.degreef1 [default = 0].
• --degreef2 <int> — flatfield correction map polynomial degree (y), or negative for triangular coefficient matrix (int; default: -1). The full name of this option for the EsoRex configuration file is fors.fors_photometry.degreef2 [default = -1].
• --degreep <int> — extinction/color coupling degree (int; default: 0). The full name of this option for the EsoRex configuration file is fors.fors_photometry.degreep [default = 0].
• --mjd_obs_target <float> — MJD-OBS used to match the raw frame from which EXTINCTION_PER_NIGHT and PHOT_COEFF inherit MJD-OBS. If negative, the MJD-OBS of the first raw frame is used (float; default: -1.0). The full name of this option for the EsoRex configuration file is fors.fors_photometry.mjd_obs_target [default = -1.0].

💡 heads up bestie: you can make a configuration file holding 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.

You can also call the pipelines from python using the python-cpl package. See:

https://packages.python.org/python-cpl/index.html

for further information.

And now, the whole friend group — the other recipes of the fors pipeline, all linked up:

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_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_photometry 5.5.7

---

👑 AUTHOR 👑

Jonas M. Larsen <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>.

(not me telling you to actually email them, they're lovely, they want the bug reports fr fr 🫶)

---

📜 LICENSE 📜

This file is currently part of the FORS Instrument Pipeline Copyright (C) 2002-2011 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 — fors_photometry version 5.5.7, chillin' on the FORS_PHOTOMETRY(7) page. go correct those flats, you absolute icon 💖✨