FORS_IMG_SCIENCE(7)

💖 NAME 💖

okay bestie, so fors_img_science — it's the recipe that reduces your imaging scientific exposure. that's the whole vibe. ✨

---

🌸 SYNOPSIS 🌸

esorex fors_img_science [OPTIONS] FILE.sof

that's it, that's the summoning ritual 🫶

---

🦋 DESCRIPTION 🦋

💫 input files (what you gotta feed it)

ok so your SOF file needs to know about these, and the "Number" column is literally how many it wants — 0+ means "zero or more, bring however many you've got, no pressure bestie":

• SCIENCE_IMG — DO category, Type: Raw — it's your Science image — Number: 1
• MASTER_BIAS — Type: FITS image — the Master bias — Number: 1
• MASTER_SKY_FLAT_IMG — Type: FITS image — the Master sky flat field — Number: 1
• PHOT_COEFF_TABLE — Type: FITS table — Observed extinction coefficients — Number: 0+
• EXTINCTION_PER_NIGHT — Type: FITS table — Extinction per night — Number: 0+
• STATIC_PHOT_COEFF_TABLE — Type: FITS table — Static filters photometry coefficients — Number: 0+
• DETECTOR_ILLUMINATED_REGION — Type: FITS table — Table with detector illuminated regions — Number: 0+

✨ output files (the glow-up it gives you back)

• SCIENCE_REDUCED_IMG — Data type: FITS image — Reduced science image
• PHOT_BACKGROUND_SCI_IMG — Data type: FITS image — Reduced science image background
• SOURCES_SCI_IMG — Data type: FITS image — Unfiltered SExtractor output
• OBJECT_TABLE_SCI_IMG — Data type: FITS table — Extracted sources properties
• SCIENCE_REDUCED_IMG_IDP — Data type: FITS image — Reduced science image in IDP-compliant format
• SCIENCE_REDUCED_WEIGHT_IDP — Data type: FITS image — Ancillary file with the weights for IDP the image
• SCIENCE_REDUCED_ERR_IDP — Data type: FITS image — Ancillary file with the errors for IDP the image

---

💅 OPTIONS 💅

every single one, no gatekeeping, we don't do that here 🎀

• --magsyserr <float> — Systematic error in magnitude (float; default: 0.01). The full name of this option for the EsoRex configuration file is fors.fors_img_science.magsyserr [default = 0.01].
• --sex_exe <str> — SExtractor executable (str; default: /usr/bin/source-extractor). The full name of this option for the EsoRex configuration file is fors.fors_img_science.sex_exe [default = /usr/bin/source-extractor].
• --sex_config <str> — SExtractor configuration file (str; default: /usr/share/cpl-plugins/fors-5.5.7/config/fors.sex). The full name of this option for the EsoRex configuration file is fors.fors_img_science.sex_config [default = /usr/share/cpl-plugins/fors-5.5.7/config/fors.sex].
• --sex_mag <str> — SExtractor magnitude (str; default: MAG_APER). The full name of this option for the EsoRex configuration file is fors.fors_img_science.sex_mag [default = MAG_APER].
• --sex_magerr <str> — SExtractor magnitude error (str; default: MAGERR_APER). The full name of this option for the EsoRex configuration file is fors.fors_img_science.sex_magerr [default = MAGERR_APER].
• --sex_radius <int> — Background error map median filter radius (unbinned pixels) (int; default: 64). The full name of this option for the EsoRex configuration file is fors.fors_img_science.sex_radius [default = 64].
• --idp_generate <bool> — If TRUE compliant IDP science products are generated (bool; default: False). The full name of this option for the EsoRex configuration file is fors.fors_img_science.idp_generate [default = False].
• --idp_weights_threshold <float> — Every pixel in the MASTER_SKY_FLAT_IMG below the threshold will be put to 0 in the weight-map, 1 otherwise. Ignored if IDP generation is not requested (float; default: 0.5). The full name of this option for the EsoRex configuration file is fors.fors_img_science.idp_weights_threshold [default = 0.5].

ok so real talk 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. 👑

---

🌈 SEE ALSO 🌈

the full documentation for the fors pipeline can be downloaded as a PDF file using the following 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. 🐍✨

the other recipes of the fors pipeline are 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_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)

like, the whole friend group fr fr 💜

---

⭐ VERSION ⭐

fors_img_science 5.5.7

---

👑 AUTHOR 👑

ESO PPS Group <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 asking you to actually file the bug report instead of just complaining in the group chat 😭 they're nice, they wanna help, just email them

---

🎀 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, no cap, you're basically a FORS pipeline girlie now 💅✨

signing off: this was fors_img_science, version 5.5.7, from the FORS_IMG_SCIENCE(7) manual — mwah, go reduce something gorgeous 🦋🌸💖