vmimstandard(7)


NAME

   vmimstandard - Reduce an imaging standard star exposure.

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 Users 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-3.1.7/config/vimos.conv).
          The full name of this option for the EsoRex  configuration  file
          is         vimos.SExtractor.FilterName         [default        =
          /usr/share/esopipes/vimos-3.1.7/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-3.1.7/config/vimos.nnw).   The  full
          name of  this  option  for  the  EsoRex  configuration  file  is
          vimos.SExtractor.StarNnwName              [default             =
          /usr/share/esopipes/vimos-3.1.7/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.

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 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  vmbias(7),  vmdark(7),
   vmdet(7),    vmifucalib(7),    vmifucombine(7),    vmifucombinecube(7),
   vmifuscience(7), vmifustandard(7),  vmimcalphot(7),  vmimflatscreen(7),
   vmimflatsky(7),  vmimobsjitter(7),  vmimobsstare(7), vmimpreimaging(7),
   vmmoscalib(7),  vmmoscombine(7),  vmmosobsjitter(7),  vmmosobsstare(7),
   vmmosscience(7),    vmmosstandard(7),    vmspcaldisp(7),   vmspflat(7),
   vmspphot(7)

VERSION

   vmimstandard 3.1.7

AUTHOR

   ESO VIMOS Pipeline Team and VIMOS Consortium <usd-help@eso.org>

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

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





Opportunity


Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.

Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.





Free Software


Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.


Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.





Free Books


The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.


Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.





Education


Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.


Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.