FORS_SUMFLUX(7)

📦 version 5.5.7, in ubuntu jammy, ubuntu noble

💖 FORS_SUMFLUX 💖

okay bestie, welcome to fors_sumflux(7) — a lil page from the fors recipes manual, and yes we're gonna read the whole thing together. grab a snack 🍓

✨ NAME ✨

fors_sumflux — Integrate flux from all or part of the input frame 🌈

🎀 SYNOPSIS 🎀

esorex fors_sumflux [OPTIONS] FILE.sof

🦋 DESCRIPTION 🦋

So like, this recipe is the one you call when you wanna monitor any lamp flux on the CCD. The input raw image has to be either a FLUX_ARC_LSS or a FLUX_FLAT_LSS frame — no substitutes, bestie. 🙅

Here's the tea: after the background subtraction, the total signal gets integrated, then divided by the exposure time and by the total number of CCD original pixels — and yes, it keeps into account a possible rebinned readout, because we are thorough like that. 💅

Now the background situation is different depending on which FORS you're on, so listen up:

  • For FORS2 frames, the background is the median level evaluated from the available overscan regions. iconic.
  • For FORS1 data, the overscan regions are missing, so:
    • for flat field data, the background is evaluated as the median level of the first 200 CCD columns
    • for arc lamp data, a background map evaluated from the regions without spectral lines is computed and subtracted ✨

The background subtracted frame is written to output in all cases, and the QC parameters QC LAMP FLUX and QC LAMP FLUXERR are computed. 🫶

📥 Input files

  • FLUX_FLAT_LSS — Raw — Flat field exposure — Required: Y
  • or FLUX_ARC_LSS — Raw — Arc lamp exposure — Required: Y

📤 Output files

  • FLUX_LAMP_LSS — FITS image — Background subtracted integration region

💅 OPTIONS 💅

  • --xlow <int> — X coordinate of lower left corner of integration region (pixel) (int; default: 0). The full name of this option for the EsoRex configuration file is fors.fors_sumflux.xlow [default = 0].
  • --ylow <int> — Y coordinate of lower left corner of integration region (pixel) (int; default: 0). The full name of this option for the EsoRex configuration file is fors.fors_sumflux.ylow [default = 0].
  • --xhigh <int> — X coordinate of upper right corner of integration region (pixel) (0 = CCD size) (int; default: 0). The full name of this option for the EsoRex configuration file is fors.fors_sumflux.xhigh [default = 0].
  • --yhigh <int> — Y coordinate of upper right corner of integration region (pixel) (0 = CCD size) (int; default: 0). The full name of this option for the EsoRex configuration file is fors.fors_sumflux.yhigh [default = 0].
ngl, it's 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. iykyk.

👑 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 — okay this is the whole squad, no cap, we're listing every single one 💖:

⭐ VERSION ⭐

fors_sumflux 5.5.7 — yeah that's the version, write it down bestie.

🌸 AUTHOR 🌸

Carlo Izzo <usd-help@eso.org> — ty for your service king 🫡

🐛 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, that's literally what it says, they really want your bug reports 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_sumflux version 5.5.7, dated 5.5.7, from the FORS_SUMFLUX(7) manual — slay, mwah, go integrate some flux 💖💅

📦 where this page comes from