Astronomical échelle spectroscopy data analysis with `muler`

Astronomical échelle spectroscopy data analysis with `muler` - Published in JOSS (2022)

Science Score: 98.0%

This score indicates how likely this project is to be science-related based on various indicators:

○
CITATION.cff file
✓
codemeta.json file
Found codemeta.json file
✓
.zenodo.json file
Found .zenodo.json file
✓
DOI references
Found 4 DOI reference(s) in README and JOSS metadata
✓
Academic publication links
Links to: joss.theoj.org, zenodo.org
✓
Committers with academic emails
6 of 11 committers (54.5%) from academic institutions
✓
Institutional organization owner
Organization ottostruve has institutional domain (astronomy.utexas.edu)
✓
JOSS paper metadata
Published in Journal of Open Source Software

Keywords

astronomical-algorithms astronomy data-analysis data-science echelle exoplanets infrared python spectroscopy stars stellar-atmospheres

Keywords from Contributors

astrophysics physics

Scientific Fields

Mathematics Computer Science - 84% confidence

Last synced: 4 months ago · JSON representation

Repository

A Python package for working with pipeline-produced spectra from IGRINS, HPF, and Keck NIRSPEC

Basic Info

Host: GitHub
Owner: OttoStruve
License: mit
Language: TeX
Default Branch: main
Homepage: https://muler.readthedocs.io
Size: 51.6 MB

Statistics

Stars: 16
Watchers: 17
Forks: 9
Open Issues: 33
Releases: 14

Topics

astronomical-algorithms astronomy data-analysis data-science echelle exoplanets infrared python spectroscopy stars stellar-atmospheres

Created about 5 years ago · Last pushed 4 months ago

Metadata Files

Readme Contributing License Code of conduct

`muler` (μler)

version 0.5.2

A Python package for analyzing pipeline-processed data from high resolution near-infrared echelle spectrographs.

The echelle spectrum problem

Imagine you have just received data from the an echelle spectrograph like IGRINS or HPF and you want to start science. Oftentimes you will get handed pipeline-reduced data from the observatory facility. When you examine the data you may notice some remaining instrumental signals: telluric contamination artifact and instrument-induced slopes stand out. Or maybe you want to apply a barycentric correction based on telescope pointing information, but you're not sure which FITS header columns to use when multiple are available. You may want to normalize, deblaze (a.k.a. flatten), and plot the spectrum, or populate the spectrum into a pandas dataframe, or estimate a coarse radial velocity based on a noise-free stellar model atmosphere or a standard star template. Or maybe you want to measure an equivalent width, with or without an error bar. All of these operations are relatively routine, but their application, order, and algorithm choice may depend on the science case, and therefore they cannot be built into a default pipeline: it is up to you---the scientist---to conduct these activities.

Muler is intended to reduce the friction of getting started with near-IR echelle spectroscopy. Typical spectral analyses become only 2 or 3 lines of compact muler code, rather than hundreds of cells of Jupyter notebooks just to load and post-process a spectrum.

Plotting a sky-subtracted, flattened spectrum:

Python spectrum = HPFSpectrum(file=file, order=15) spectrum.remove_nans().sky_subtract().deblaze().normalize().plot()

Measuring an equivalent width:

Python spectrum = HPFSpectrum(file=file, order=15) clean_spectrum = spectrum.remove_nans().sky_subtract().deblaze().normalize() ew = clean_spectrum.measure_ew()

Installation: `pip` and development version

We currently offer seamless installation with pip and conda! You can install muler in one line with:

bash pip install muler or bash conda install -c conda-forge muler

muler constantly changes and benefits from new community contributions like yours. We therefore recommend the slightly more tedious installation from the raw source code described on our Installation webpage. Installing from source code empowers you to modify the code for your purposes.

Our mission and your help

muler is aimed at collecting common spectral analysis methods into one place, simplifying the interactive process of astronomical discovery. We want to reduce the perceived complexity of working with echelle spectra, so that scientists have more time to focus on frontier science problems. We aspire to become a tool that new and experienced astronomers alike come to use and rely upon. In order to achieve these goals we need community contributions from practitioners like you.

That help can take many forms, even more creative outlets than most would guess. A great and easy first step is to :star: our repo or subscribe to notifications so that you can stay up to date as our project evolves. Glance around our tutorials, overall documentation, and Issues pages. Join our welcoming community and help us build some cool tools to make astronomy slightly easier, more reproducible, and more fun.

Spectrographs we currently support

We currently support the IGRINS, IGRINS-2, HPF, and NIRSPEC spectrographs. These three near-IR echelle spectrographs are attached to some of the greatest telescopes in the world: The Harlan J. Smith 2.7m Telescope, Gemini, HET, and Keck respectively. HPF differs from IGRINS, IGRINS-2, and NIRSPEC in its precision radial velocity (PRV) design. It uses fibers instead of slits. We do not purport to address the extreme precision demands of the PRV community, but we anticipate our package is still useful to a wide range of HPF science use cases. We are open to supporting new spectrographs in the future, but at the present time we are focused on building, testing, and maintaining the core features for these three spectrographs before we add new ones. One way to get a new instrument supported is to make a new GitHub Issue to describe the instrument and rationale for adding it to muler, so other community members can join the conversation.

Owner

Name: OttoStruve
Login: OttoStruve
Kind: organization
Email: datascience@astro.as.utexas.edu
Location: Austin, TX

Website: https://astronomy.utexas.edu/
Repositories: 24
Profile: https://github.com/OttoStruve

The University of Texas at Austin Department of Astronomy Organization

JOSS Publication

Astronomical échelle spectroscopy data analysis with `muler`

Published

May 12, 2022

DOI

10.21105/joss.04302

Volume 7, Issue 73, Page 4302