Provided by: cpl-plugin-vimos-doc_3.2.3+dfsg-2build3_all bug

NAME

       vmimpreimaging - Reduce a preimaging science exposure.

SYNOPSIS

       esorex vmimpreimaging [OPTIONS] FILE.sof

DESCRIPTION

       This  recipe  is  used  to  apply basic reduction steps to the imaging observation that is
       preliminary to a MOS observation of the same field. No source detection  is  attempted  on
       the  image.  The  image WCS, together with the component describing the instrument optical
       distortions,  is  converted  into  the  convention  followed  by  VMMPS  (the  VIMOS  mask
       preparation  software).  This set of coefficients, the so-called CO-matrix used by the SAO
       WCSTools package, is written to the header of the reduced image.

       Input files:

         DO category:              Type:       Explanation:         Required:
         IMG_PREIMAGING            Raw         Preimaging exposure     Y
         MASTER_BIAS               Calib       Master bias             Y
         IMG_MASTER_SKY_FLAT       Calib       Master sky flat         Y
         PHOT_COEFF_TABLE          Calib       Photometric table       .

         CCD_TABLE                 Calib       Bad pixel table         .

       Output files:

         DO category:              Data type:  Explanation:
         IMG_SCIENCE_REDUCED       FITS image  Reduced preimaging exposure

       If a photometric table is specified, the magnitude zeropoint, the  atmospheric  extinction
       coefficient,  and  the  colour term are copied from the photometric table to the header of
       the reduced image. A CCD table must be specified in input only if a bad pixel cleaning  is
       requested.

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

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

       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 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),  vmimstandard(7),
       vmmoscalib(7),   vmmoscombine(7),  vmmosobsjitter(7),  vmmosobsstare(7),  vmmosscience(7),
       vmmosstandard(7), vmspcaldisp(7), vmspflat(7), vmspphot(7)

VERSION

       vmimpreimaging 3.2.3

AUTHOR

       ESO VIMOS Pipeline Team <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  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