MUSE_EXP_COMBINE(7)

📦
version 2.8.7 · 2 versions
, in debian bookworm, ubuntu noble

💖 MUSE_EXP_COMBINE 💖

okay bestie, gather round, because this is the muse_exp_combine page from the MUSE_EXP_COMBINE(7) manual and it's literally about smooshing a whole pile of exposures into one single gorgeous datacube. no cap.

✨ NAME ✨

muse_exp_combine — Combine several exposures into one datacube.

like, that's it. that's the whole job. several exposures in, one datacube out. iconic.

🌈 SYNOPSIS 🌈

esorex muse_exp_combine [OPTIONS] FILE.sof

🦋 DESCRIPTION 🦋

So here's the vibe: you've got reduced pixel tables, one per exposure, right? This recipe sorts them by exposure and then combines them — with weights applied — into one final datacube. that's the whole glow-up. 💅

🎀 OPTIONS 🎀

  • --save <str> — Pick which output product(s) you wanna save, bestie. Can contain one or more of "cube" (the output cube and associated images — and lowkey important: if this isn't given, no resampling is done at all) or "combined" (the fully reduced and combined pixel table for the full set of exposures, which is super useful if you wanna do the final resampling step again separately later). If you give several options, 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). When you set this to 0.0, these defaults kick in automatically: 0.2´´ for WFM, 0.025´´ for NFM, and 1.0 if the 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). Same deal: set it to 0.0 and you get 0.2´´ for WFM, 0.025´´ for NFM, and 1.0 if the 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> — The type of statistics used for detection of cosmic rays during the final resampling. "iraf" uses the variance information, "mean" uses standard (mean/stdev) statistics, and "median" uses median and the 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. Heads up: 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. You can give up to three comma-separated floating-point values. If you give only one value, it applies to all dimensions; two values are interpreted as spatial and spectral direction respectively; and 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 (that's the loop distance, bestie). 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].
✨ also!! 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.7.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.7

💜 AUTHOR 💜

Peter Weilbacher <https://support.eso.org>

😭 BUG REPORTS 😭

Please report any problems to https://support.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

and that's the whole page, bestie!! 💖 this was muse_exp_combine version 2.8.7 — she ate, no crumbs. go forth and combine those exposures, you absolute icon. 👑✨

📦 where this page comes from