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

VERSION

       vmimpreimaging 3.1.9

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

vmimpreimaging                                        3.1.9                                    VMIMPREIMAGING(7)