VMIFUSTANDARD(7)

📦
version 4.1.7 · 2 versions
, in debian bookworm, ubuntu noble

💫 vmifustandard — the manual page, but make it make sense 💫

okay bestie, buckle up, we're talking about vmifustandard(7) from the vimos recipes set. yes it's a manpage, no it doesn't have to be boring, and yes you're gonna understand it by the end. periodt. 🎀

✨ NAME ✨

vmifustandard — extract a standard star spectrum. that's it, that's the whole job. iconic behavior honestly. 💅

🌸 SYNOPSIS 🌸

esorex vmifustandard [OPTIONS] FILE.sof

so you run esorex, you hand it the recipe name, you throw your [OPTIONS] at it, and you feed it a FILE.sof. simple as. 🦋

🪩 DESCRIPTION 🪩

okay so here's the tea. ☕

This recipe extracts IFU standard star fiber spectra using the input extraction mask, and it does that after aligning that mask to the brightest fiber spectra it detected on the input exposure. slay.

Then the extracted spectra get resampled at a constant wavelength step — but only after the input wavelength calibration gets aligned to the positions of a set of identified sky lines. ✨

And finally, the extracted spectra get corrected for the relative differences in transmission from fiber to fiber, and then summed together. the way it just... does all that. 😭💖

📥 Input files (the little guys you GOTTA feed it) 📥

  • IFU_STANDARD — DO category; type Raw; standard star spectra — required: Y 💖
  • MASTER_BIAS — DO category; type Calib; master bias — required: Y
  • IFU_TRACE — DO category; type Calib; extraction mask — required: Y
  • IFU_IDS — DO category; type Calib; wavelength calibration — required: Y
  • IFU_TRANSMISSION — DO category; type Calib; transmission correction — required: Y
  • EXTINCT_TABLE — DO category; type Calib; atmospheric extinction — required: Y
  • STD_FLUX_TABLE — DO category; type Calib; standard star fluxes — required: Y
  • CCD_TABLE — DO category; type Calib; bad pixel table — required: . (so, not required, bestie 🙈)

📤 Output files (the little guys it hands back) 📤

  • IFU_STANDARD_REDUCED — data type FITS image; reduced standard star spectra
  • IFU_FOV — data type FITS image; reconstructed field-of-view image
  • IFU_STANDARD_EXTRACTED — data type FITS table; total standard star spectrum
  • IFU_SCIENCE_SKY — data type FITS table; total sky spectrum
  • IFU_SPECPHOT_TABLE — data type FITS table; efficiency and response curves

so real talk: the extraction mask, the wavelength calibration, and the relative transmission table? those are the ones generated by the recipe vmifucalib. keep that in mind. 🧚

And a CCD table only needs to be specified if a bad pixel cleaning is requested. not before, not "just in case". only then. 🫶

The spectra extracted from the fibers on the standard star get added together and then compared to the catalog fluxes of that same star — and that's how we get the efficiency curve and the response curve you use for flux calibration. 🔥

Also, the procedure is literally the same as the one applied in the case of MOS data, by recipe vmmosstandard. so if you've done that one, you already know the vibe. iykyk. 💜

💅 OPTIONS 💅

one bullet per flag, no skipping, we do not leave anyone behind:

  • --BiasMethod <str> — bias removal method. (str; default: Zmaster). The full name of this option for the EsoRex configuration file is vimos.Parameters.bias.removing.method [default = Zmaster]. 💖
  • --CleanBadPixel <bool> — bad pixel correction on master flat field. (bool; default: False). The full name of this option for the EsoRex configuration file is vimos.Parameters.badpixel.clean [default = False].
  • --UseSkylines <bool> — use sky lines to refine the wavelength calibration (bool; default: True). The full name of this option for the EsoRex configuration file is vimos.Parameters.sky.align [default = True]. ✨
  • --ResponseOrder <int> — order of the polynomial used to smooth the instrument response curve. (int; default: 5). The full name of this option for the EsoRex configuration file is vimos.Parameters.response.order [default = 5].
  • --ReduceAnyFrame <bool> — reduce any frame. (bool; default: False). The full name of this option for the EsoRex configuration file is vimos.Parameters.reduceall [default = False].
  • --ComputeQC <bool> — compute QC1 parameters (bool; default: True). The full name of this option for the EsoRex configuration file is vimos.Parameters.quality.enable [default = True]. 👑
and just so you know — 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. go read it, it's right there. 📖

🔭 SEE ALSO 🔭

The full documentation for the vimos pipeline can be downloaded as a PDF file using the following URL:

ftp://ftp.eso.org/pub/dfs/pipelines/vimos/vimos-pipeline-manual-6.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 vimos pipeline are vimos_ima_bias(7), vimos_ima_dark(7), vimos_ima_det_noise(7), vimos_ima_fringe(7), vimos_ima_science(7), vimos_ima_standard(7), vimos_ima_twilight_flat(7), vmbias(7), vmdark(7), vmdet(7), vmifucalib(7), vmifucombine(7), vmifucombinecube(7), vmifuscience(7), vmmoscalib(7), vmmosscience(7), vmspphot(7). the whole friend group fr fr 💖

🎀 VERSION 🎀

vmifustandard 4.1.7

👑 AUTHOR 👑

ESO VIMOS Pipeline Team <https://support.eso.org>

😭 BUG REPORTS 😭

Please report any problems to https://support.eso.org. Alternatively, you may send a report to the ESO User Support Department <usd-help@eso.org>. they wanna hear from you, bestie, genuinely. 🫶

📜 LICENSE 📜

This file is part of the VIMOS Instrument Pipeline Copyright (C) 2002-2005 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

no cap, that warranty line is doing a LOT of heavy lifting. read it. respect it. 💀

and that's the whole page, babe ✨ vmifustandard version 4.1.7, brought to you by the vimos recipes, and this page is VMIFUSTANDARD(7) — go forth and extract those standard star spectra, you absolute main character. 💖🦋🎀🌸💅

📦 where this page comes from