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

NAME

       vmmoscombine - Combine reduced MOS observations from different OBs.

SYNOPSIS

       esorex vmmoscombine [OPTIONS] FILE.sof

DESCRIPTION

       This recipe is used to sum the contributes from a sequence of 2D-extracted spectral frames
       generated by the recipes vmmosobsstare, vmmosobsjitter, and vmmoscombine itself. The  only
       restriction  is  that  all  frames  must  be obtained with the same mask. Sky subtraction,
       fringing correction, flat fielding, etc., are not applied, since they had been applied  in
       the previous reduction of each input dataset.

       Each  input image is corrected to airmass zero before the stacking, and for this reason an
       atmospheric extinction table must always be specified. Optionally  a  correction  for  the
       instrument response can also be applied.

       Input files:

         DO category:             Type:       Explanation:          Required:
         MOS_SCIENCE_EXTRACTED    Product     Combined slit spectra     Y
         GRISM_TABLE              Calib       Grism table               Y
         EXTINCT_TABLE            Calib       Atmospheric extinction    Y
         MOS_SPECPHOT_TABLE       Calib       Response curve            .

       Output files:

         DO category:             Data type:  Explanation:
         MOS_SCIENCE_REDUCED      FITS image  Extracted objects spectra
         MOS_SCIENCE_FLUX_REDUCED FITS image  Flux calibrated objects spectra
         MOS_SCIENCE_EXTRACTED    FITS image  Combined slit spectra
         OBJECT_TABLE             FITS table  Objects spectra identification
         WINDOW_TABLE             FITS table  Objects positions in slit

       The  positions  of  the  extracted  slit spectra and of the detected objects that they may
       contain are listed in the window table.

       If a spectro-photometric table (produced by the recipe vmmosstandard) is specified  and  a
       flux calibration is requested, then a MOS_SCIENCE_FLUX_REDUCED image is also created. This
       image is identical to the MOS_SCIENCE_REDUCED,  but  the  spectra  it  contains  are  flux
       calibrated, and expressed in units of erg/cm/cm/s/Angstrom.

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

OPTIONS

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

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

       --DetectionLevel <float>
              Object  detection  level in units of sigma. (float; default: 2.0). The full name of
              this option for the EsoRex configuration file  is  vimos.Parameters.detection.sigma
              [default = 2.0].

       --WatershedLevels <long>
              Number  of levels in the watershed method in object detection. (long; default: 32).
              The  full  name  of  this   option   for   the   EsoRex   configuration   file   is
              vimos.Parameters.detection.levels [default = 32].

       --WatershedFraction <float>
              Flux  fraction  to  use in watershed. (float; default: 0.01). The full name of this
              option for the EsoRex  configuration  file  is  vimos.Parameters.detection.fraction
              [default = 0.01].

       --MinObjectSize <long>
              Minimal  size  for an object candidate to be considered an object.  (long; default:
              2).  The  full  name  of  this  option  for  the  EsoRex  configuration   file   is
              vimos.Parameters.detection.minsize [default = 2].

       --MaxObjectSize <long>
              Maximal  size  for  an  object  candidate for not trying deblend into sub- objects.
              (long; default: 7). The full name of this option for the EsoRex configuration  file
              is vimos.Parameters.detection.maxsize [default = 7].

       --CalibrateFlux <bool>
              Extracted  spectra  are  flux  calibrated. (bool; default: False). The full name of
              this option for the EsoRex configuration file is  vimos.Parameters.flux.calibration
              [default = False].

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

VERSION

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