MUSE_GEOMETRY(7)

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

🌸 MUSE_GEOMETRY(7) — the muse recipes glow-up 💅

okay bestie, so this is the manual page for muse_geometry from the muse recipes collection (yes, the MUSE pipeline one, 2.8.7 energy, we'll get to that at the end 🫶). Let's get into it.

✨ NAME ✨

muse_geometry — figure out where all the slices actually sit relative to each other inside the field of view, and measure the instrumental PSF right there on the detectors. it's giving "geometry queen", fr fr.

🦋 SYNOPSIS 🦋

esorex muse_geometry [OPTIONS] FILE.sof

that's it. that's the whole vibe. 💖

🔥 DESCRIPTION 🔥

so first things first: the processing works separately on each IFU of the raw input data (and yes, it does them in parallel, because she's efficient like that). what goes down on each one:

  • it trims the raw data and records the overscan statistics
  • subtracts the bias
  • converts from adu to count
  • optionally, the dark can be subtracted, and the data can be divided by the flat-field

then the data of all the input mask exposures gets averaged together. ✨

that averaged image — plus the trace table, the wavelength calibration and the line catalog — is what gets used to detect spots. those detection windows are then used to measure the spots on all images of the sequence, and the result gets saved into the spots tables, along with the info on the measured PSF. no cap.

next up, properties of all the slices get computed. first separately on each IFU, to nail down the peak position of the mask for each slice and its angle, and then the width and horizontal position. after that, the results of all IFUs are analyzed together to produce a refined horizontal position, applying global shifts to each IFU as needed. then the vertical position gets determined using the known slice ordering on the sky — the relative peak positions get put into sequence, taking into account the vertical offsets of the pinholes in the mask. 👑

then the table gets cleaned up from intermediate debug data. if the --smooth parameter is set to a positive value, it's used to do a sigma-clipped smoothing within each slicer stack, which makes the output table look more regular. then the table is saved. 💾

and as a last optional step: additional raw input data gets reduced using the newly (computed) geometry to produce an image of the field of view. if those exposures contain smooth features, you can use them as a visual check of how good the geometrical calibration actually is. vibe check passed or not, you'll see it. 🎀

💅 OPTIONS 💅

  • --ifu1 <int> — first IFU to analyze. (int; default: 1). the full name of this option for the EsoRex configuration file is muse.muse_geometry.ifu1 [default = 1].
  • --ifu2 <int> — last IFU to analyze. (int; default: 24). the full name of this option for the EsoRex configuration file is muse.muse_geometry.ifu2 [default = 24].
  • --sigma <float> — sigma detection level for spot detection, expressed as median deviation above the median. (float; default: 2.2). the full name of this option for the EsoRex configuration file is muse.muse_geometry.sigma [default = 2.2].
  • --centroid <str> — type of centroiding and FWHM determination to use for all spot measurements: either the simple barycenter method or a Gaussian fit. (str; default: gaussian). the full name of this option for the EsoRex configuration file is muse.muse_geometry.centroid [default = gaussian].
  • --smooth <float> — use this sigma-level cut for smoothing of the output table within each slicer stack. set it to a non-positive value to deactivate smoothing. (float; default: 1.5). the full name of this option for the EsoRex configuration file is muse.muse_geometry.smooth [default = 1.5].
  • --lambdamin <float> — when you pass any MASK_CHECK frames in the input, use this lower wavelength cut before reconstructing the image. (float; default: 6800.0). the full name of this option for the EsoRex configuration file is muse.muse_geometry.lambdamin [default = 6800.0].
  • --lambdamax <float> — when you pass any MASK_CHECK frames in the input, use this upper wavelength cut before reconstructing the image. (float; default: 7200.0). the full name of this option for the EsoRex configuration file is muse.muse_geometry.lambdamax [default = 7200.0].
heads up bestie: you can totally create a configuration file containing these options, along with suitable default values. go check 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 this URL:

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

an overview over the existing ESO pipelines lives at:

https://www.eso.org/sci/software/pipelines/

basic documentation about the EsoRex program can be found at the esorex(1) man page.

and yes — 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, aka the whole friend group, are: 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_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_geometry 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>. they're nice, i promise. 🫶

📜 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, periodt. 💖 this was muse_geometry version 2.8.7, from the muse recipes crew, and yeah it's page MUSE_GEOMETRY(7) — go slay your geometry calibration bestie, ily, bye! 🎀✨🦋🌸

📦 where this page comes from