snid-sage 1.2.3

SNID SAGE - SuperNova IDentification – Spectral Analysis and Guided Exploration

SNID SAGE - Advanced Supernova Spectral Analysis

SNID SAGE (SuperNova IDentification – Spectral Analysis and Guided Exploration) is your go-to tool for analyzing supernova spectra. It combines an intuitive PySide6/Qt graphical interface with the original SNID (Blondin & Tonry 2007) cross-correlation techniques, enhanced with modern clustering for classification choice, high-performance plotting via pyqtgraph, and LLM-powered analysis summaries and interactive chat assistance.

Quick Installation

Install from PyPI (Recommended)

pip install snid-sage

Python support: 3.10–3.13 (3.14 not yet supported due to dependency wheels).

This installs both the CLI and the full GUI stack by default, as defined in pyproject.toml.

Using a virtual environment (recommended)

# Create virtual environment
python -m venv snid_env

# Activate environment
# Windows:
snid_env\Scripts\activate
# macOS/Linux:
source snid_env/bin/activate

# Install
pip install snid-sage

Development installation

git clone https://github.com/FiorenSt/SNID-SAGE.git
cd SNID-SAGE
pip install -e .

Note: For user installs, you can use pip install --user to avoid system-wide changes.

Getting Started

Launch the GUI

snid-sage

Use the CLI

# Single spectrum analysis (templates auto-discovered). Saves the summary (.output) by default
sage data/SN2018bif.csv -o results/

# Batch processing (default saves per-object summary plus standard batch outputs)
sage batch "data/*.dat" -o results/

# Batch from a CSV list with per-row redshift (if provided)
sage batch --list-csv "data/spectra_list.csv" -o results/

Documentation & Support

• Complete Documentation
• First Analysis Guide
• GUI Manual
• CLI Reference
• AI Integration
• Troubleshooting

Supported Data Formats

• FITS files (.fits, .fit)
• ASCII tables (.dat, .txt, .ascii, .asci, .csv, .flm)
• Space-separated values with flexible column detection
• Flexible text/FITS loading with automatic format detection

Research & Citation

If you use SNID SAGE in your research, please cite the SNID-SAGE paper:

• Stoppa, F. and Smartt, S. J., SNID-SAGE: A Modern Framework for Interactive Supernova Classification and Spectral Analysis (arXiv:2603.28741)

For the current arXiv version, the official BibTeX entry is:

@misc{stoppa2026,
  title={SNID-SAGE: A Modern Framework for Interactive Supernova Classification and Spectral Analysis},
  author={Fiorenzo Stoppa and Stephen J. Smartt},
  year={2026},
  eprint={2603.28741},
  archivePrefix={arXiv},
  primaryClass={astro-ph.IM},
  url={https://arxiv.org/abs/2603.28741}
}

Community & Support

• Report Bug
• Request Feature
• Discussions
• Email Support

License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Made with care for the astronomical community

Documentation • Report Bug • Request Feature • Discussions