Provided by: cpl-plugin-muse-doc_2.8.5+dfsg-1_all 
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