Provided by: cpl-plugin-vimos-doc_3.0.6+dfsg-4_all bug

NAME

       vmimobsjitter - Reduce and combine a set of jittered imaging exposures.

SYNOPSIS

       esorex vmimobsjitter [OPTIONS] FILE.sof

DESCRIPTION

       This  recipe  is  used  to  apply basic reduction steps to a sequence of exposures made in
       direct imaging mode, and to combine them in a single image. Each input image is  processed
       in  the same way as by recipe vmimobsstare, therefore what characterises the vmimobsjitter
       is just the final combination of the input frames.

       Input files:

         DO category:              Type:       Explanation:         Required:
         IMG_SCIENCE               Raw         Science exposure        Y
         MASTER_BIAS               Calib       Master bias             Y
         MASTER_DARK               Calib       Master dark             .

         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 scientific exposure
         IMG_GALAXY_TABLE          FITS table  List of detected objects
         IMG_FRINGES               FITS image  Fringes map

       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. The galaxy table is  the  output  of  SExtractor  converted  into  FITS
       format.

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

       --Resampling <str>
              Pixel value interpolation method. (str; default: ´BiLinear´). The full name of this
              option for the EsoRex configuration file is vimos.Parameters.interpolation [default
              = BiLinear].

       --FringingCorr <bool>
              Apply fringing corrections. (bool; default: False). The full name  of  this  option
              for the EsoRex configuration file is vimos.Parameters.fringing [default = False].

       --StackMethod <str>
              Frame combination method (str; default: ´Median´). The full name of this option for
              the  EsoRex  configuration  file  is  vimos.Parameters.stacking.method  [default  =
              Median].

       --KSigmaLow <float>
              Low  threshold for K-sigma clipping method. (float; default: 5.0). The full name of
              this      option      for      the      EsoRex      configuration      file      is
              vimos.Parameters.stacking.ksigma.low [default = 5.0].

       --KSigmaHigh <float>
              High threshold for K-sigma clipping method. (float; default: 5.0). The full name of
              this      option      for      the      EsoRex      configuration      file      is
              vimos.Parameters.stacking.ksigma.high [default = 5.0].

       --MinRejection <long>
              Number of lowest rejected values for rejection method. (long; default: 1). The full
              name    of    this    option    for    the    EsoRex    configuration    file    is
              vimos.Parameters.stacking.minmax.minimum [default = 1].

       --MaxRejection <long>
              Number  of  highest  rejected  values for rejection method. (long; default: 1). The
              full   name   of   this   option   for   the   EsoRex   configuration    file    is
              vimos.Parameters.stacking.minmax.maximum [default = 1].

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

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

       --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.0.6/config/vimos.conv´).  The full name of this option
              for  the  EsoRex  configuration  file  is  vimos.SExtractor.FilterName  [default  =
              /usr/share/esopipes/vimos-3.0.6/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.0.6/config/vimos.nnw´).  The  full name of this option
              for the  EsoRex  configuration  file  is  vimos.SExtractor.StarNnwName  [default  =
              /usr/share/esopipes/vimos-3.0.6/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),  vmimobsstare(7),  vmimpreimaging(7),  vmimstandard(7),
       vmmoscalib(7),   vmmoscombine(7),  vmmosobsjitter(7),  vmmosobsstare(7),  vmmosscience(7),
       vmmosstandard(7), vmspcaldisp(7), vmspflat(7), vmspphot(7)

VERSION

       vmimobsjitter 3.0.6

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