MUSE_SCIPOST_MAKE_CUBE(7)

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

✨ NAME ✨

muse_scipost_make_cube — bestie, this is the one that makes a MUSE cube out of a MUSE pixel table. it's giving glow-up, but for data 💅✨

this page lives in section 7 of the manual (MUSE_SCIPOST_MAKE_CUBE(7)), from the muse recipes collection, iykyk 🎀

🌈 SYNOPSIS 🌈

esorex muse_scipost_make_cube [OPTIONS] FILE.sof

like. that's it. that's the whole vibe. run it through esorex with your FILE.sof and some options and watch the pixels become a cube 🦋

💖 DESCRIPTION 💖

okay so listen 🫶 this recipe grabs a pixel table and resamples it into either a FITS cube or a Euro3D table — and if you want, it also throws in a stacked spectrum. no big deal. just casually restructuring your entire dataset.

and lowkey important: this is a part of the muse_scipost recipe. so it's not out here doing its own thing, it's the resampling leg of a bigger operation. team player energy fr fr 🌸

🎀 OPTIONS 🎀

okay here come the flags, stay with me, they're all iconic in their own way ✨

  • --lambdamin <float> — cuts off everything below this wavelength after loading the pixel table(s). it's a float, default 4000.0. the full name of this option for the EsoRex configuration file is muse.muse_scipost_make_cube.lambdamin [default = 4000.0]. bye bye blue end 👋
  • --lambdamax <float> — same idea but it cuts off everything above this wavelength, also after loading the pixel table(s). float, default 10000.0. full EsoRex config name: muse.muse_scipost_make_cube.lambdamax [default = 10000.0]. red end, you're dismissed 💀
  • --resample <str> — the resampling technique for the final output cube. it's a str, default drizzle. full EsoRex config name: muse.muse_scipost_make_cube.resample [default = drizzle]. drizzle is literally the moment, no cap 🧚
  • --dx <float> — horizontal step size for resampling, in arcsec or pixel. when you set it to 0.0 you get these defaults instead: 0.2´´ for WFM, 0.025´´ for NFM, and 1.0 if the data is in pixel units. float, default 0.0. full EsoRex config name: muse.muse_scipost_make_cube.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, or 1.0 when the data is in pixel units. float, default 0.0. full EsoRex config name: muse.muse_scipost_make_cube.dy [default = 0.0] 💜
  • --dlambda <float> — wavelength step size, in Angstrom. if it's 0.0, you get natural instrument sampling. float, default 0.0. full EsoRex config name: muse.muse_scipost_make_cube.dlambda [default = 0.0] 🌸
  • --crtype <str> — which statistics get used to detect cosmic rays during the final resampling. "iraf" uses the variance information, "mean" uses standard (mean/stdev) statistics, and "median" uses median and the median median of the absolute median deviation. str, default median. full EsoRex config name: muse.muse_scipost_make_cube.crtype [default = median] ⭐
  • --crsigma <float> — the sigma rejection factor for cosmic ray rejection during final resampling. heads up: a zero or negative value switches cosmic ray rejection off entirely. float, default 15.0. full EsoRex config name: muse.muse_scipost_make_cube.crsigma [default = 15.0] 🔥
  • --rc <float> — critical radius for the "renka" resampling method. float, default 1.25. full EsoRex config name: muse.muse_scipost_make_cube.rc [default = 1.25] 🎀
  • --pixfrac <str> — pixel down-scaling factor for the "drizzle" resampling method. you can hand it up to three comma-separated floating-point values: give it one and it applies to all dimensions, give it two and they're read as spatial and spectral direction respectively, give it three and they're taken as horizontal, vertical, and spectral. str, default 0.8,0.8. full EsoRex config name: muse.muse_scipost_make_cube.pixfrac [default = 0.8,0.8] 🦋
  • --ld <int> — number of adjacent pixels to take into account during resampling in all three directions (the loop distance). this affects all resampling methods except "nearest". int, default 1. full EsoRex config name: muse.muse_scipost_make_cube.ld [default = 1] 💅
  • --format <str> — the 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 also include the reconstructed image(s) in FITS image extensions inside the same file. str, default Cube. full EsoRex config name: muse.muse_scipost_make_cube.format [default = Cube] 👑
  • --stacked <bool> — if true, it writes an additional output file as a 2D stacked image, where the x direction is pseudo-spatial and the y direction is wavelength. bool, default False. full EsoRex config name: muse.muse_scipost_make_cube.stacked [default = False] 🌈
  • --filter <str> — the filter name(s) 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 you give an unsupported filter name, creation of the respective image is just... omitted. if you give multiple filter names they have to be comma separated. str, default white. full EsoRex config name: muse.muse_scipost_make_cube.filter [default = white] 🙈
💡 side note bestie: you can make a configuration file holding all these options with suitable default values. go check the details from the esorex --help command for that. you're welcome 🫶

👀 SEE ALSO 👀

the full documentation for the muse pipeline is downloadable as a PDF right here:

ftp://ftp.eso.org/pub/dfs/pipelines/muse/muse-pipeline-cookbook-2.8.7.pdf

an overview of all the existing ESO pipelines lives at https://www.eso.org/sci/software/pipelines/ 🌐

basic documentation about the EsoRex program itself is in the esorex (1) man page 📖

and yes, you can call the pipelines from python using the python-cpl package — see https://packages.python.org/python-cpl/index.html for more 🐍✨

the other recipes of the muse pipeline, all of them, no skipping:

muse_ampl(7), muse_astrometry(7), muse_bias(7), muse_create_sky(7), muse_dark(7), muse_exp_align(7), muse_exp_combine(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_raman(7), muse_scipost_subtract_sky(7), muse_scipost_subtract_sky_simple(7), muse_standard(7), muse_twilight(7), muse_wavecal(7)

whole squad. periodt 💜

⭐ VERSION ⭐

muse_scipost_make_cube 2.8.7

👑 AUTHOR 👑

Ole Streicher <https://support.eso.org>

🐛 BUG REPORTS 🐛

if something's broken, report it to https://support.eso.org 🫶 alternatively you can send a report to the ESO User Support Department <usd-help@eso.org>. they're nice, they'll help, don't be shy 💖

💜 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

okay that's the whole page bestie, mwah 💋 this was muse_scipost_make_cube version 2.8.7, out here repping the muse recipes — go make a cube, you got this 🎀✨🦋

📦 where this page comes from