Provided by: cpl-plugin-muse-doc_2.8.5+dfsg-1_all bug

NAME

       muse_exp_combine - Combine several exposures into one datacube.

SYNOPSIS

       esorex muse_exp_combine [OPTIONS] FILE.sof

DESCRIPTION

       Sort  reduced  pixel  tables,  one per exposure, by exposure and combine them with applied
       weights into one final datacube.

OPTIONS

       --save <str>
              Select output product(s) to save. Can contain one or more of  "cube"  (output  cube
              and  associated  images;  if  this  is  not given, no resampling is done at all) or
              "combined" (fully reduced and combined pixel table for the full set  of  exposures;
              this  is  useful,  if the final resampling step is to be done again separately). If
              several options are given, they have to be comma-separated. (str; default: ´cube´).
              The   full   name   of   this   option   for   the  EsoRex  configuration  file  is
              muse.muse_exp_combine.save [default = cube].

       --resample <str>
              The resampling  technique  to  use  for  the  final  output  cube.  (str;  default:
              ´drizzle´).  The  full  name  of  this  option for the EsoRex configuration file is
              muse.muse_exp_combine.resample [default = drizzle].

       --dx <float>
              Horizontal step size for resampling (in arcsec or pixel).  The  following  defaults
              are  taken  when  this  value is set to 0.0: 0.2´´ for WFM, 0.025´´ for NFM, 1.0 if
              data is in pixel units. (float; default: 0.0). The full name of this option for the
              EsoRex configuration file is muse.muse_exp_combine.dx [default = 0.0].

       --dy <float>
              Vertical  step size for resampling (in arcsec or pixel). The following defaults are
              taken when this value is set to 0.0: 0.2´´ for WFM, 0.025´´ for NFM, 1.0 if data is
              in  pixel units. (float; default: 0.0). The full name of this option for the EsoRex
              configuration file is muse.muse_exp_combine.dy [default = 0.0].

       --dlambda <float>
              Wavelength step size (in Angstrom). Natural instrument sampling is used, if this is
              0.0   (float;  default:  0.0).  The  full  name  of  this  option  for  the  EsoRex
              configuration file is muse.muse_exp_combine.dlambda [default = 0.0].

       --crtype <str>
              Type of statistics used for detection  of  cosmic  rays  during  final  resampling.
              "iraf" uses the variance information, "mean" uses standard (mean/stdev) statistics,
              "median" uses median and the median median of the absolute median deviation.  (str;
              default:  ´median´). The full name of this option for the EsoRex configuration file
              is muse.muse_exp_combine.crtype [default = median].

       --crsigma <float>
              Sigma rejection factor to use for cosmic ray rejection during final  resampling.  A
              zero  or  negative value switches cosmic ray rejection off. (float; default: 10.0).
              The  full  name  of  this   option   for   the   EsoRex   configuration   file   is
              muse.muse_exp_combine.crsigma [default = 10.0].

       --rc <float>
              Critical radius for the "renka" resampling method. (float; default: 1.25). The full
              name of this option for the EsoRex configuration file  is  muse.muse_exp_combine.rc
              [default = 1.25].

       --pixfrac <str>
              Pixel  down-scaling  factor  for  the  "drizzle"  resampling  method.  Up to three,
              comma-separated, floating-point values can be given. If only one value is given, it
              applies  to  all  dimensions,  two  values  are interpreted as spatial and spectral
              direction, respectively,  while  three  are  taken  as  horizontal,  vertical,  and
              spectral.  (str;  default:  ´0.6,0.6´). The full name of this option for the EsoRex
              configuration file is muse.muse_exp_combine.pixfrac [default = 0.6,0.6].

       --ld <int>
              Number of adjacent pixels to take into  account  during  resampling  in  all  three
              directions  (loop  distance); this affects all resampling methods except "nearest".
              (int; default: 1). The full name of this option for the EsoRex  configuration  file
              is muse.muse_exp_combine.ld [default = 1].

       --format <str>
              Type  of  output  file  format,  "Cube"  is  a  standard FITS cube with NAXIS=3 and
              multiple extensions (for data and variance). The extended "x" formats  include  the
              reconstructed  image(s)  in  FITS  image extensions within the same file. "sdpCube"
              does some extra calculations to create FITS  keywords  for  the  ESO  Science  Data
              Products.  (str;  default:  ´Cube´).  The  full  name of this option for the EsoRex
              configuration file is muse.muse_exp_combine.format [default = Cube].

       --weight <str>
              Type of weighting scheme to use when combining multiple exposures.  "exptime"  just
              uses  the  exposure  time  to  weight the exposures, "fwhm" uses the best available
              seeing information from the headers as well, "header"  queries  ESO.DRS.MUSE.WEIGHT
              of  each  input  file  instead of the FWHM, and "none" preserves an existing weight
              column in the input pixel tables without changes. (str;  default:  ´exptime´).  The
              full    name    of   this   option   for   the   EsoRex   configuration   file   is
              muse.muse_exp_combine.weight [default = exptime].

       --filter <str>
              The filter name(s) to be used for the output field-of-view image. Each name has  to
              correspond to an EXTNAME in an extension of the FILTER_LIST file. If an unsupported
              filter name is given, creation of the respective  image  is  omitted.  If  multiple
              filter  names  are given, they have to be comma separated. (str; default: ´white´).
              The  full  name  of  this   option   for   the   EsoRex   configuration   file   is
              muse.muse_exp_combine.filter [default = white].

       --lambdamin <float>
              Cut  off  the  data below this wavelength after loading the pixel table(s). (float;
              default: 4000.0). The full name of this option for the EsoRex configuration file is
              muse.muse_exp_combine.lambdamin [default = 4000.0].

       --lambdamax <float>
              Cut  off  the  data above this wavelength after loading the pixel table(s). (float;
              default: 10000.0). The full name of this option for the EsoRex  configuration  file
              is muse.muse_exp_combine.lambdamax [default = 10000.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 muse pipeline can be downloaded as a PDF file using the
       following URL:

              ftp://ftp.eso.org/pub/dfs/pipelines/muse/muse-pipeline-cookbook-2.8.5.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 muse pipeline are muse_ampl(7), muse_astrometry(7), muse_bias(7),
       muse_create_sky(7),   muse_dark(7),   muse_exp_align(7),  muse_flat(7),  muse_geometry(7),
       muse_illum(7),   muse_lingain(7),    muse_lsf(7),    muse_qi_mask(7),    muse_scibasic(7),
       muse_scipost(7),     muse_scipost_apply_astrometry(7),     muse_scipost_calibrate_flux(7),
       muse_scipost_combine_pixtables(7),                            muse_scipost_correct_dar(7),
       muse_scipost_correct_rv(7),        muse_scipost_make_cube(7),       muse_scipost_raman(7),
       muse_scipost_subtract_sky(7),    muse_scipost_subtract_sky_simple(7),    muse_standard(7),
       muse_twilight(7), muse_wavecal(7)

VERSION

       muse_exp_combine 2.8.5

AUTHOR

       Peter Weilbacher <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 MUSE  Instrument  Pipeline  Copyright  (C)  2005,  2019  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  02111-1307  USA