Metadata-Version: 2.1
Name: emlineclipper
Version: 1.2.4
Summary: A tool for the removal of emission lines from supernova spectra. Follows Finneran et al. (2024). See: https://arxiv.org/abs/2411.11503.
Author-email: Gabriel Finneran <gabfin15@gmail.com>
Project-URL: Homepage, https://github.com/GabrielF98/emlineclipper
Project-URL: Issues, https://github.com/GabrielF98/emlineclipper/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.20
Requires-Dist: scipy>=1.14
Requires-Dist: matplotlib>=3.9
Requires-Dist: pandas>=2.2

# emlineclipper
![GitHub Release](https://img.shields.io/github/v/release/GabrielF98/emlineclipper?color=teal)
[![Publish with PyPI](https://github.com/GabrielF98/emlineclipper/actions/workflows/python-publish.yml/badge.svg)](https://github.com/GabrielF98/emlineclipper/actions/workflows/python-publish.yml)

Python library to clip emission lines in supernova spectra. Developed by Gabriel Finneran at University College Dublin, Ireland.

Full documentation is available at [readthedocs](https://emlineclipper.readthedocs.io/en/latest/). Further information may be found in [Finneran et al. (2024)](https://arxiv.org/abs/2411.11503) (see below for details on how to cite this work!).

This package can be installed from [PyPI](https://pypi.org/project/emlineclipper/) using pip:

```
pip install emlineclipper
```

You can also contact me at gabfin15@gmail.com.

# How it works
The code takes a spectrum from the user and plots it. It then asks the user to double click the plot at the edges of emission lines to remove.

On each click, a line is drawn. Every pair of clicks is assumed to bracket a line that needs to be removed, these are called bounding lines. Groups of emission lines can be bounded using just two bounding lines, provided they are sufficiently close (a couple of samples apart).

The code then iterates over each pair of bounding lines. The code selects a chunk of the input flux array +/-100Å away from the lower/upper bounding lines by default.

Values within the bounding lines in this chunk are removed before performing a spline fit to the flux (with 5 knots by default). If other user-defined emission lines are present in the fitting window, they are removed as well. 

Within the chunk, residuals between the spline and the original spectrum outside the bounding lines are computed. The mean and standard deviation of the difference array is calculated. This is used to resample the spectrum by adding noise to the spline between the bounding lines.

This is performed iteratively from the blue end of the spectrum for each pair of bounding lines.

The code returns the array of flux with the emission lines removed and resampled using hte uncertainty arrays generated during fitting.

**Note:** Even when a line has been fit, the code performs the next for the next line on the original spectrum, i.e. without removing the previously fit line.

<img width="794" alt="Screenshot 2024-06-04 at 16 20 23" src="https://github.com/GabrielF98/emlineclipper/assets/72733933/6f2493ba-fcb4-46dc-844a-20ee08509644">

Spectra of SN1997ef from the Weizmann Interactive Supernova Data Repository [WISeREP](https://www.wiserep.org/object/4567)

# How to cite this code in your work
If you use emlineclipper in your work, please consider citing  (see below for bibtex). I would also appreciated if you could add an acknowledgement such as:

```
This work has made use of \texttt{emlineclipper}, developed by Gabriel Finneran and available at: \url{https://github.com/GabrielF98/emlineclipper}
```

```
@ARTICLE{2024arXiv241111503F,
       author = {{Finneran}, Gabriel and {Cotter}, Laura and {Martin-Carrillo}, Antonio},
        title = "{Velocity evolution of broad-line Ic supernovae with and without gamma-ray bursts}",
      journal = {arXiv e-prints},
     keywords = {Astrophysics - High Energy Astrophysical Phenomena},
         year = 2024,
        month = nov,
          eid = {arXiv:2411.11503},
        pages = {arXiv:2411.11503},
archivePrefix = {arXiv},
       eprint = {2411.11503},
 primaryClass = {astro-ph.HE},
       adsurl = {https://ui.adsabs.harvard.edu/abs/2024arXiv241111503F},
      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
}
```
