VIMOS_IMA_STANDARD(7)

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

💖 vimos_ima_standard — Standard field processing for imaging 💖

okay bestie, so this is vimos_ima_standard(7) from the vimos recipes collection and it is genuinely one of the most useful little pages in the whole pipeline, no cap. let's get into it 🫶

✨ NAME ✨

vimos_ima_standard — Standard field processing for imaging 🦋

✨ SYNOPSIS ✨

esorex vimos_ima_standard [OPTIONS] FILE.sof

that's it. that's the whole vibe. 💅

✨ DESCRIPTION ✨

vimos_ima_standard is the VIMOS standard star recipe. periodt.

So what it does: you hand it a list of standard frames and it corrects them to strip out the bias, dark and flat field signatures. Optionally it defringes the reddest filter images (yes girl, fringes, we hate them 😭). Then it astrometrically and photometrically calibrates the individual images — but it does no stacking. None. Zero. Not its job. 🙅‍♀️

🌸 Files it accepts in the SOF

These are the tags, and what each one is, and the vibes are immaculate:

  • STD — A list of raw standard images
  • MASTER_BIAS — A master bias frame
  • MASTER_DARK — A master dark frame
  • MASTER_TWILIGHT_FLAT — A master flat frame
  • MASTER_CONF — A master confidence map
  • MASTER_FRINGE — A master fringe map (optional)
  • MASTER_FRINGE_VAR — A master fringe variance map (optional)
  • MASTER_READGAIN — A master readgain table
  • MASTER_2MASS_CATALOGUE_ASTROM — A master 2MASS index for astrometry, or
  • MASTER_PPMXL_CATALOGUE_ASTROM — A master PPMXL index for astrometry, or
  • MASTER_APASS_CATALOGUE_ASTROM — A master APASS index for astrometry, or
  • MASTER_LOCAL_CATALOGUE_ASTROM — A master local catalogue index for astrometry
  • MASTER_APASS_CATALOGUE_PHOTOM — A master APASS index for photometry, or
  • MASTER_LOCAL_CATALOGUE_PHOTOM — A master local catalogue index for photometry
  • PHOTCAL_TAB — A photometric calibration table
  • SCHLEGEL_MAP_NORTH — Northern Schlegel Map
  • SCHLEGEL_MAP_SOUTH — Southern Schlegel Map
🌟 Heads up bestie: All of these are required unless specified otherwise. So if it doesn't say (optional) next to it, you gotta bring it. sorry, I don't make the rules 💀

✨ OPTIONS ✨

Every single one, in order, with its full EsoRex configuration name, because I would never gatekeep 💖

  • --preview_only <bool> — Preview only? (bool; default: False). The full name of this option for the EsoRex configuration file is vimos.vimos_ima_standard.preview_only [default = False].
  • --minphotom <int> — Minimum stars for photometry solution (int; default: 1). The full name of this option for the EsoRex configuration file is vimos.vimos_ima_standard.minphotom [default = 1].
  • --prettynames <bool> — Use pretty product names? (bool; default: False). The full name of this option for the EsoRex configuration file is vimos.vimos_ima_standard.prettynames [default = False].
  • --savemstd <bool> — Save matched standard catalogues? (bool; default: False). The full name of this option for the EsoRex configuration file is vimos.vimos_ima_standard.savemstd [default = False].
  • --cdssearch_astrom <str> — CDS astrometric catalogue (str; default: ´none´). The full name of this option for the EsoRex configuration file is vimos.vimos_ima_standard.cdssearch_astrom [default = none].
  • --cdssearch_photom <str> — CDS photometric catalogue (str; default: ´none´). The full name of this option for the EsoRex configuration file is vimos.vimos_ima_standard.cdssearch_photom [default = none].
  • --ignore_fringe <bool> — Ignore provided fringe frame? (bool; default: False). The full name of this option for the EsoRex configuration file is vimos.vimos_ima_standard.ignore_fringe [default = False].
  • --src_cat_ipix <int> — Minimum pixel area for each detected object (int; default: 5). The full name of this option for the EsoRex configuration file is vimos.vimos_ima_standard.src_cat_ipix [default = 5].
  • --src_cat_thresh <float> — Detection threshold in sigma above sky (float; default: 2.5). The full name of this option for the EsoRex configuration file is vimos.vimos_ima_standard.src_cat_thresh [default = 2.5].
  • --src_cat_icrowd <bool> — Use deblending? (bool; default: True). The full name of this option for the EsoRex configuration file is vimos.vimos_ima_standard.src_cat_icrowd [default = True].
  • --src_cat_rcore <float> — Value of Rcore in pixels (float; default: 5.0). The full name of this option for the EsoRex configuration file is vimos.vimos_ima_standard.src_cat_rcore [default = 5.0].
  • --src_cat_nbsize <int> — Background smoothing box size (int; default: 128). The full name of this option for the EsoRex configuration file is vimos.vimos_ima_standard.src_cat_nbsize [default = 128].
  • --cacheloc <str> — Location for standard star cache (str; default: ´.´). The full name of this option for the EsoRex configuration file is vimos.vimos_ima_standard.cacheloc [default = .].
  • --magerrcut <float> — A cut in the magnitude error (float; default: 100.0). The full name of this option for the EsoRex configuration file is vimos.vimos_ima_standard.magerrcut [default = 100.0].
  • --lthr_mag <float> — STD stars with magnitudes BRIGHTER than this are removed. (float; default: 15.0). The full name of this option for the EsoRex configuration file is vimos.vimos_ima_standard.lthr_mag [default = 15.0].
  • --hthr_mag <float> — STD stars with magnitudes FAINTER than this are removed. (float; default: 32.0). The full name of this option for the EsoRex configuration file is vimos.vimos_ima_standard.hthr_mag [default = 32.0].
👑 Little note 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. iykyk ✨

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

And the other recipes of the vimos pipeline, aka the whole friend group 🌈:

✨ VERSION ✨

vimos_ima_standard 4.1.7 — she's 4.1.7 and she's thriving 💅

✨ AUTHOR ✨

Jim Lewis <jrl@ast.cam.ac.uk> — thank you for your service king 🫡💖

✨ BUG REPORTS ✨

Please report any problems to jrl@ast.cam.ac.uk. Alternatively, you may send a report to the ESO User Support Department <usd-help@eso.org>.

(not me manifesting a bug-free run for you 🙈 but if it breaks, tell them, not me 💀)

✨ LICENSE ✨

This file is part of the VIMOS Instrument Pipeline Copyright (C) 2019 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

and that's the whole page bestie ✨ this cutie is vimos_ima_standard version 4.1.7, straight outta the vimos recipes, and she ate, no crumbs. go process some standard stars, you've got this 💜🎀🦋

📦 where this page comes from