SYNOPSIS

esorex vmimstandard [OPTIONS] FILE.sof

DESCRIPTION

This recipe is used to determine the instrumental magnitude of the stars matching the entries of a photometric catalog. The same procedure applied by the recipe vmimobsstare is used to reduce the standard field image. SExtractor v2.1.6 is used for the source detection task.

Input files:

  DO category:              Type:       Explanation:         Required:
  IMG_STANDARD              Raw         Standard stars image    Y
  MASTER_BIAS               Calib       Master bias             Y
  MASTER_DARK               Calib       Master dark             .
  IMG_MASTER_SKY_FLAT       Calib       Master sky flat         Y
  PHOTOMETRIC_CATALOG       Calib       Photometric catalog     Y
  PHOTOMETRIC_TABLE         Calib       Photometric table       Y
  CCD_TABLE                 Calib       Bad pixel table         .

Output files:

  DO category:              Data type:  Explanation:
  IMG_STAR_MATCH_TABLE      FITS table  List of found standard stars
  IMG_STANDARD_REDUCED      FITS image  Reduced scientific exposure
  IMG_GALAXY_TABLE          FITS table  List of detected objects

The galaxy table is the output of SExtractor converted into FITS format. The star match table is the list of identified standard stars, with their positions on sky and CCD and their instrumental and catalog magnitudes.

For more details, please refer to the VIMOS Pipeline User\'s Guide.

OPTIONS

--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 reduced science image. (bool; default: False). The full name of this option for the EsoRex configuration file is vimos.Parameters.badpixel.clean [default = False].

--CleanCosmic <bool>

Cosmic ray removal from input science image. (bool; default: True). The full name of this option for the EsoRex configuration file is vimos.Parameters.cosmics.clean [default = True].

--CosmicsThreshold <float>

Threshold for cosmic ray candidate selection. (float; default: 4.0). The full name of this option for the EsoRex configuration file is vimos.Parameters.cosmics.threshold [default = 4.0].

--CosmicsRatio <float>

Ratio for discrimination of objects and cosmics. (float; default: 2.0). The full name of this option for the EsoRex configuration file is vimos.Parameters.cosmics.ratio [default = 2.0].

--MagLimit <float>

Magnitude upper limit for selection of detected objects. (float; default: 100.0). The full name of this option for the EsoRex configuration file is vimos.Parameters.matching.magnitude.limit [default = 100.0].

--StarIndex <float>

Stellarity index used to select stars in the image. (float; default: 0.01). The full name of this option for the EsoRex configuration file is vimos.Parameters.matching.stellarity [default = 0.01].

--MinStars <long>

Minimum number of stars required. (long; default: 3). The full name of this option for the EsoRex configuration file is vimos.Parameters.matching.stars [default = 3].

--SearchRadius <float>

Aperture used for object identification. (float; default: 5.0). The full name of this option for the EsoRex configuration file is vimos.Parameters.matching.radius [default = 5.0].

--MagInitial <float>

Magnitude tolerance for initial selection of matching stars. (float; default: 2.5). The full name of this option for the EsoRex configuration file is vimos.Parameters.matching.magnitude.initial [default = 2.5].

--MagFinal <float>

Magnitude tolerance for final selection of matching stars. (float; default: 1.5). The full name of this option for the EsoRex configuration file is vimos.Parameters.matching.magnitude.final [default = 1.5].

--KSigmaClip <float>

Sigma clipping factor used when matching stars. (float; default: 2.0). The full name of this option for the EsoRex configuration file is vimos.Parameters.matching.ksigma [default = 2.0].

--TemperatureCheck <bool>

Check beam temperature when updating the world coordinate system. (bool; default: True). The full name of this option for the EsoRex configuration file is vimos.Parameters.temperature.check [default = True].

--TemperatureTolerance <float>

Maximum allowed difference between beam and ambient temperature. (float; default: 3.0). The full name of this option for the EsoRex configuration file is vimos.Parameters.temperature.tolerance [default = 3.0].

--RemoteCatalog <bool>

Enable online access to a catalog server. (Not yet implemented!) (bool; default: False). The full name of this option for the EsoRex configuration file is vimos.Parameters.matching.catalog.remote [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].

--ReduceAnyFrame <bool>

Reduce any frame. (bool; default: True). The full name of this option for the EsoRex configuration file is vimos.Parameters.reduceall [default = True].

--SExtractor.AnalysisThresh <float>

Surface brightness threshold for FWHM computation. (float; default: 2.5). The full name of this option for the EsoRex configuration file is vimos.SExtractor.AnalysisThresh [default = 2.5].

--SExtractor.AssocData <str>

Column indices for columns to copy to the catalog output. (str; default: \'2,3,4\'). The full name of this option for the EsoRex configuration file is vimos.SExtractor.AssocData [default = 2,3,4].

--SExtractor.AssocName <str>

Name of the ASSOC file. (str; default: \'sky.list\'). The full name of this option for the EsoRex configuration file is vimos.SExtractor.AssocName [default = sky.list].

--SExtractor.AssocParams <str>

Column indices in the ASSOC file to use as coordinates and weight for cross-matching. (str; default: \'2,3,4\'). The full name of this option for the EsoRex configuration file is vimos.SExtractor.AssocParams [default = 2,3,4].

--SExtractor.AssocRadius <float>

Search radius for ASSOC. (float; default: 2.0). The full name of this option for the EsoRex configuration file is vimos.SExtractor.AssocRadius [default = 2.0].

--SExtractor.AssocSelecType <str>

Output selector for detected sources. (str; default: \'MATCHED\'). The full name of this option for the EsoRex configuration file is vimos.SExtractor.AssocSelecType [default = MATCHED].

--SExtractor.AssocType <str>

Method for cross-matching. (str; default: \'MAG_SUM\'). The full name of this option for the EsoRex configuration file is vimos.SExtractor.AssocType [default = MAG_SUM].

--SExtractor.BackFilterSize <long>

Size (in background meshes) of the background filtering mask. (long; default: 3). The full name of this option for the EsoRex configuration file is vimos.SExtractor.BackFilterSize [default = 3].

--SExtractor.BackPhotoThick <long>

Thickness of the background LOCAL annulus. (long; default: 24). The full name of this option for the EsoRex configuration file is vimos.SExtractor.BackPhotoThick [default = 24].

--SExtractor.BackPhotoType <str>

Select background for magnitude computation. (str; default: \'GLOBAL\'). The full name of this option for the EsoRex configuration file is vimos.SExtractor.BackPhotoType [default = GLOBAL].

--SExtractor.BackSize <long>

Size of a background mesh. (long; default: 64). The full name of this option for the EsoRex configuration file is vimos.SExtractor.BackSize [default = 64].

--SExtractor.BackValue <float>

Constant to subtract from the images for MANUAL background subtraction. (float; default: 0.0). The full name of this option for the EsoRex configuration file is vimos.SExtractor.BackValue [default = 0.0].

--SExtractor.CatalogType <str>

Select output catalog format (only ASCII_HEAD is supported). (str; default: \'ASCII_HEAD\'). The full name of this option for the EsoRex configuration file is vimos.SExtractor.CatalogType [default = ASCII_HEAD].

--SExtractor.CheckImageName <str>

Check image file name. (str; default: \'check.fits\'). The full name of this option for the EsoRex configuration file is vimos.SExtractor.CheckImageName [default = check.fits].

--SExtractor.CheckImageType <str>

Select information to put in the `check image\'. (str; default: \'NONE\'). The full name of this option for the EsoRex configuration file is vimos.SExtractor.CheckImageType [default = NONE].

--SExtractor.Clean <str>

If `Y\', clean catalog before writing. (str; default: \'Y\'). The full name of this option for the EsoRex configuration file is vimos.SExtractor.Clean [default = Y].

--SExtractor.CleanParam <float>

Cleaning efficiency. (float; default: 1.0). The full name of this option for the EsoRex configuration file is vimos.SExtractor.CleanParam [default = 1.0].

--SExtractor.DeblendMinCont <float>

Minimum contrast for deblending. (float; default: 0.005). The full name of this option for the EsoRex configuration file is vimos.SExtractor.DeblendMinCont [default = 0.005].

--SExtractor.DeblendNthresh <long>

Number of deblending sub-thresholds. (long; default: 32). The full name of this option for the EsoRex configuration file is vimos.SExtractor.DeblendNthresh [default = 32].

--SExtractor.DetectMinArea <long>

Minimum number of pixels above threshold triggering detection. (long; default: 5). The full name of this option for the EsoRex configuration file is vimos.SExtractor.DetectMinArea [default = 5].

--SExtractor.DetectThresh <float>

Detection threshold (relative to background RMS). (float; default: 2.0). The full name of this option for the EsoRex configuration file is vimos.SExtractor.DetectThresh [default = 2.0].

--SExtractor.DetectType <str>

Device type the image originates from. (str; default: \'CCD\'). The full name of this option for the EsoRex configuration file is vimos.SExtractor.DetectType [default = CCD].

--SExtractor.Filter <str>

If `Y\', filter data before extraction. (str; default: \'N\'). The full name of this option for the EsoRex configuration file is vimos.SExtractor.Filter [default = N].

--SExtractor.FilterName <str>

Name of the file containing the filter definition. (str; default: \'/usr/share/esopipes/vimos-2.9.15/config/vimos.conv\'). The full name of this option for the EsoRex configuration file is vimos.SExtractor.FilterName [default = /usr/share/esopipes/vimos-2.9.15/config/vimos.conv].

--SExtractor.FilterThresh <str>

Lower, upper threshold (in background sigmas) for filtering (retina- filtering only). (str; default: \'\'). The full name of this option for the EsoRex configuration file is vimos.SExtractor.FilterThresh [default = ].

--SExtractor.FlagImage <str>

Flag image file name. (str; default: \'flag.fits\'). The full name of this option for the EsoRex configuration file is vimos.SExtractor.FlagImage [default = flag.fits].

--SExtractor.FlagType <str>

Flag combination method. (str; default: \'OR\'). The full name of this option for the EsoRex configuration file is vimos.SExtractor.FlagType [default = OR].

--SExtractor.InterpMaxXlag <long>

Maximum X gap allowed in interpolation. (long; default: 16). The full name of this option for the EsoRex configuration file is vimos.SExtractor.InterpMaxXlag [default = 16].

--SExtractor.InterpMaxYlag <long>

Maximum Y gap allowed in interpolation. (long; default: 16). The full name of this option for the EsoRex configuration file is vimos.SExtractor.InterpMaxYlag [default = 16].

--SExtractor.InterpType <str>

Interpolation method. (str; default: \'ALL\'). The full name of this option for the EsoRex configuration file is vimos.SExtractor.InterpType [default = ALL].

--SExtractor.MagGamma <float>

Gamma of emulsion (only used in PHOTO mode). (float; default: 4.0). The full name of this option for the EsoRex configuration file is vimos.SExtractor.MagGamma [default = 4.0].

--SExtractor.MagZeropoint <float>

Zero-point offset to apply to magnitudes. (float; default: 0.0). The full name of this option for the EsoRex configuration file is vimos.SExtractor.MagZeropoint [default = 0.0].

--SExtractor.MaskType <str>

Masking of neighbours for photometry. (str; default: \'CORRECT\'). The full name of this option for the EsoRex configuration file is vimos.SExtractor.MaskType [default = CORRECT].

--SExtractor.MemoryBufSize <long>

Number of scan-lines in the image buffer. (long; default: 1024). The full name of this option for the EsoRex configuration file is vimos.SExtractor.MemoryBufSize [default = 1024].

--SExtractor.MemoryObjStack <long>

Maximum number of objects the object stack can contain. (long; default: 2000). The full name of this option for the EsoRex configuration file is vimos.SExtractor.MemoryObjStack [default = 2000].

--SExtractor.MemoryPixStack <long>

Maximum number of pixels the pixel stack can contain. (long; default: 100000). The full name of this option for the EsoRex configuration file is vimos.SExtractor.MemoryPixStack [default = 100000].

--SExtractor.PhotApertures <float>

Aperture diameters used for MAG_APER. (float; default: 5.0). The full name of this option for the EsoRex configuration file is vimos.SExtractor.PhotApertures [default = 5.0].

--SExtractor.PhotAutoParams <str>

MAG_AUTO controls: 1st order moment scaling parameter, minimum Rmin. (str; default: \'2.5,3.5\'). The full name of this option for the EsoRex configuration file is vimos.SExtractor.PhotAutoParams [default = 2.5,3.5].

--SExtractor.SExtractor <str>

Path to the sextractor executable. (str; default: \'/usr/bin/sex\'). The full name of this option for the EsoRex configuration file is vimos.SExtractor.SExtractor [default = /usr/bin/sex].

--SExtractor.SaturLevel <float>

Pixel values above are considered saturated. (float; default: 60000.0). The full name of this option for the EsoRex configuration file is vimos.SExtractor.SaturLevel [default = 60000.0].

--SExtractor.StarNnwName <str>

Name of the neuronal network weights file. (str; default: \'/usr/share/esopipes/vimos-2.9.15/config/vimos.nnw\'). The full name of this option for the EsoRex configuration file is vimos.SExtractor.StarNnwName [default = /usr/share/esopipes/vimos-2.9.15/config/vimos.nnw].

--SExtractor.Timeout <float>

Time after which sextractor will be aborted. (float; default: 300.0). The full name of this option for the EsoRex configuration file is vimos.SExtractor.Timeout [default = 300.0].

--SExtractor.VerboseType <str>

Selects verbosity level. (str; default: \'QUIET\'). The full name of this option for the EsoRex configuration file is vimos.SExtractor.VerboseType [default = QUIET].

--SExtractor.WeightType <str>

Selects the weighting scheme. (str; default: \'NONE\'). The full name of this option for the EsoRex configuration file is vimos.SExtractor.WeightType [default = NONE].

--SExtractor.Window <str>

Frame window used in SExtractor detection. (str; default: \'100,100,1948,2340\'). The full name of this option for the EsoRex configuration file is vimos.SExtractor.Window [default = 100,100,1948,2340].

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.

RELATED TO vmimstandard…

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 http://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 http://packages.python.org/python-cpl/index.html for further information.

The other recipes of the vimos pipeline are vmifucombinecube(7), vmifucalib(7), vmimflatsky(7), vmspflat(7), vmmosobsstare(7), vmimflatscreen(7), vmimpreimaging(7), vmimcalphot(7), vmmoscombine(7), vmmosobsjitter(7), vmifucombine(7), vmimobsjitter(7), vmspphot(7), vmdet(7), vmmosscience(7), vmmosstandard(7), vmspcaldisp(7), vmifustandard(7), vmbias(7), vmmoscalib(7), vmimobsstare(7), vmdark(7), vmifuscience(7)

VERSION

vmimstandard 2.9.15

AUTHOR

ESO VIMOS Pipeline Team and VIMOS Consortium <[email protected]>

BUG REPORTS

Please report any problems to [email protected] Alternatively, you may send a report to the ESO User Support Department <[email protected]>.

LICENSE

This file is currently part of the VIMOS 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