vmmoscombine(7)


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





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.