jammy (7) muse_exp_combine.7.gz

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