Metadata-Version: 2.4
Name: supernnova
Version: 3.0.35
Summary: framework for Bayesian, Neural Network based supernova light-curve classification
License: MIT-expat
License-File: LICENSE.md
Author: Anais Moller
Author-email: amoller@swin.edu.au
Requires-Python: >=3.11,<3.13
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Provides-Extra: dev
Provides-Extra: docs
Requires-Dist: Sphinx (>=6.1.3,<7.0.0) ; extra == "docs"
Requires-Dist: astropy (>=5.3.4,<6.0.0)
Requires-Dist: black (>=22.10,<25.0) ; extra == "dev"
Requires-Dist: click (>=8.1.3,<9.0.0)
Requires-Dist: colorama (>=0.4.6,<0.5.0)
Requires-Dist: h5py (>=3.10.0,<4.0.0)
Requires-Dist: line-profiler (>=4.1.2,<5.0.0) ; extra == "dev"
Requires-Dist: memory-profiler (>=0.61.0,<0.62.0) ; extra == "dev"
Requires-Dist: mlflow (>=2.10.2,<4.0.0)
Requires-Dist: mypy (>=1.1.1,<2.0.0) ; extra == "dev"
Requires-Dist: myst-parser (>=1.0.0,<2.0.0) ; extra == "docs"
Requires-Dist: natsort (>=8.4.0,<9.0.0)
Requires-Dist: pandas (>=2.0.0,<3.0.0)
Requires-Dist: pre-commit (>=3.0.4,<4.0.0) ; extra == "dev"
Requires-Dist: pytest (>=7.0,<8.0) ; extra == "dev"
Requires-Dist: pytest-cov (>=4.1.0,<5.0.0) ; extra == "dev"
Requires-Dist: ruff (>=0.0.243,<0.0.244) ; extra == "dev"
Requires-Dist: scikit-learn (>=1.3.2,<2.0.0)
Requires-Dist: seaborn (>=0.13.0,<0.14.0)
Requires-Dist: sphinx-copybutton (>=0.5.1,<0.6.0) ; extra == "docs"
Requires-Dist: sphinx-rtd-theme (==1.2.0) ; extra == "docs"
Requires-Dist: tabulate (>=0.9.0,<0.10.0)
Requires-Dist: tqdm (>=4.66.1,<5.0.0)
Project-URL: Documentation, https://supernnova.readthedocs.io/en/latest/
Project-URL: Homepage, https://github.com/supernnova/SuperNNova
Description-Content-Type: text/markdown

[![Paper DOI](https://img.shields.io/badge/Paper%20DOI-10.1093%2Fmnras%2Fstz3312-green)](https://doi.org/10.1093/mnras/stz3312) 
[![arXiv](https://img.shields.io/badge/arxiv-astro--ph%2F1901.06384-red)](https://arxiv.org/abs/1901.06384) 
[![Data DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.3265189.svg)](https://doi.org/10.5281/zenodo.3265189)

![Logo](docs/assets/SuperNNova.png)

[![Pull Request](https://github.com/supernnova/SuperNNova/actions/workflows/pull_request.yml/badge.svg)](https://github.com/supernnova/SuperNNova/actions/workflows/pull_request.yml)

    A new release of SuperNNova is in the main branch.
    For DES-5yr analysis please use the branch SNANA_DES5yr
    (and any other analysis using the syntax: python run.py)

### What is SuperNNova (SNN)

SuperNNova is an open-source photometric time-series classification framework.

The framework includes different RNN architectures (LSTM, GRU, Bayesian RNNs) and can be trained with simulations in `.csv` and `SNANA FITS` format. SNN is part of the [PIPPIN](https://github.com/dessn/Pippin) end-to-end cosmology pipeline.

You can train your own model for time-series classification (binary or multi-class) using photometry and additional features.

Please include the full citation if you use this material in your research: [A Möller and T de Boissière,
MNRAS, Volume 491, Issue 3, January 2020, Pages 4277–4293.](https://academic.oup.com/mnras/article-abstract/491/3/4277/5651173)

### Read the documentation
[https://supernnova.readthedocs.io](https://supernnova.readthedocs.io/latest/)


### Installation
Install via pip
```bash
pip install supernnova
```

Or clone this repository for development
```bash
git clone https://github.com/supernnova/supernnova.git
```
and configure environment using this [documentation](https://supernnova.readthedocs.io/latest/installation/five_minute_guide.html)


### Read the papers

Please include the full citation if you use this material in your research: [A Möller and T de Boissière,
MNRAS, Volume 491, Issue 3, January 2020, Pages 4277–4293.](https://academic.oup.com/mnras/article-abstract/491/3/4277/5651173)

To reproduce [Möller & de Boissière, 2019 MNRAS](https://academic.oup.com/mnras/article-abstract/491/3/4277/5651173) switch to `paper` branch and build documentation.

To reproduce the Dark Energy Survey analyses use commit `fcf8584b64974ef7a238eac718e01be4ed637a1d`. For more recent analyses of DES branch `SNANA_DES5yr` (should be PIPPIN backward compatible).
- [Möller et al. 2022 MNRAS](https://ui.adsabs.harvard.edu/abs/2022MNRAS.514.5159M/abstract)
- [Möller et al. 2024 MNRAS](https://ui.adsabs.harvard.edu/abs/2024MNRAS.533.2073M/abstract)
- [Vincenzi et al. 2023 MNRAS](https://ui.adsabs.harvard.edu/abs/2023MNRAS.518.1106V/abstract)
- [DES Collaboration 2024 ApJ](https://ui.adsabs.harvard.edu/abs/2024ApJ...973L..14D/abstract)

To reproduce Fink analyses until 2024 use commit `fcf8584b64974ef7a238eac718e01be4ed637a1d` and check [Fink's github](https://github.com/astrolabsoftware/fink-science).

### Build docs <a name="docs"></a>

    cd docs && make clean && make html && cd ..
    firefox docs/_build/html/index.html


### ADACS
This package has been updated to a recent pytorch and updated CI/CD through the [ADACS Merit allocation program](https://adacs.org.au/merit-allocation-program) 2023-2024.

