Scroll to navigation

VIMOS_IMA_SCIENCE(7) vimos recipes VIMOS_IMA_SCIENCE(7)

NAME

vimos_ima_science - Science processing for imaging

SYNOPSIS

esorex vimos_ima_science [OPTIONS] FILE.sof

DESCRIPTION

vimos_ima_science -- VIMOS science recipe.

Take a list of science frames and correct them to remove bias, dark and flat field signatures. Optionally defringe the reddest filter images. Stack jitter sequences. Astrometrically and photometrically calibrate the stacks

The program accepts the following files in the SOF:

Tag Description

OBJECT A list of raw science 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 index for astrometry MASTER_APASS_CATALOGUE_PHOTOM A master APASS index for photometry or MASTER_LOCAL_CATALOGUE_PHOTOM A master local index for photometry or OBJECT_CATALOGUE_STD A master processed standard star image or table MATCHSTD_PHOTOM A master photometric matched standards table (optional) SCHLEGEL_MAP_NORTH Northern Schlegel Map SCHLEGEL_MAP_SOUTH Southern Schlegel Map PHOTCAL_TAB A photometric calibration table All of these are required unless specified otherwise.

OPTIONS

--savecat <bool>
Save catalogue? (bool; default: False). The full name of this option for the EsoRex configuration file is vimos.vimos_ima_science.savecat [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_science.savemstd [default = False].
--preview_only <bool>
Preview only? (bool; default: False). The full name of this option for the EsoRex configuration file is vimos.vimos_ima_science.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_science.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_science.prettynames [default = False].
--chop_crud <str>
Chop crud method (str; default: ´hardconf_pix´). The full name of this option for the EsoRex configuration file is vimos.vimos_ima_science.chop_crud [default = hardconf_pix].
--cdssearch_astrom <str>
CDS astrometric catalogue (str; default: ´none´). The full name of this option for the EsoRex configuration file is vimos.vimos_ima_science.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_science.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_science.ignore_fringe [default = False].
--stk_cat_ipix <int>
Minimum pixel area for each detected object (int; default: 10). The full name of this option for the EsoRex configuration file is vimos.vimos_ima_science.stk_cat_ipix [default = 10].
--stk_cat_thresh <float>
Detection threshold in sigma above sky (float; default: 1.5). The full name of this option for the EsoRex configuration file is vimos.vimos_ima_science.stk_cat_thresh [default = 1.5].
--stk_cat_icrowd <bool>
Use deblending? (bool; default: True). The full name of this option for the EsoRex configuration file is vimos.vimos_ima_science.stk_cat_icrowd [default = True].
--stk_cat_rcore <float>
Value of Rcore in pixels (float; default: 10.0). The full name of this option for the EsoRex configuration file is vimos.vimos_ima_science.stk_cat_rcore [default = 10.0].
--stk_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_science.stk_cat_nbsize [default = 128].
--stk_lthr <float>
Low rejection threshold (float; default: 3.0). The full name of this option for the EsoRex configuration file is vimos.vimos_ima_science.stk_lthr [default = 3.0].
--stk_hthr <float>
Upper rejection threshold (float; default: 3.0). The full name of this option for the EsoRex configuration file is vimos.vimos_ima_science.stk_hthr [default = 3.0].
--stk_method <str>
Stacking method (str; default: ´linear´). The full name of this option for the EsoRex configuration file is vimos.vimos_ima_science.stk_method [default = linear].
--stk_seeing <bool>
Weight by seeing? (bool; default: False). The full name of this option for the EsoRex configuration file is vimos.vimos_ima_science.stk_seeing [default = False].
--stk_fast <str>
Stack using fast algorithm? (str; default: ´auto´). The full name of this option for the EsoRex configuration file is vimos.vimos_ima_science.stk_fast [default = auto].
--stk_nfst <int>
Nframes to stack in fast mode (int; default: 16). The full name of this option for the EsoRex configuration file is vimos.vimos_ima_science.stk_nfst [default = 16].
--cacheloc <str>
Location for standard star cache (str; default: ´.´). The full name of this option for the EsoRex configuration file is vimos.vimos_ima_science.cacheloc [default = .].
--magerrcut <float>
Magnitude error cut (float; default: 100.0). The full name of this option for the EsoRex configuration file is vimos.vimos_ima_science.magerrcut [default = 100.0].

Note that 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 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_standard(7), vimos_ima_twilight_flat(7), vmbias(7), vmdark(7), vmdet(7), vmifucalib(7), vmifucombine(7), vmifucombinecube(7), vmifuscience(7), vmifustandard(7), vmmoscalib(7), vmmosscience(7), vmspphot(7)

VERSION

vimos_ima_science 4.1.0

AUTHOR

Jim Lewis <jrl@ast.cam.ac.uk>

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

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

4.1.0 vimos_ima_science