snid-sage 0.5.0

SNID SAGE - SuperNova IDentification with Spectrum Analysis and Guided Enhancement

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.

---

SNID SAGE main GUI: intuitive workflow, interactive plotting, and advanced analysis tools.

---

Quick Installation

Install from PyPI (Recommended)

pip install snid-sage

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 summary (.output) and plots by default
snid data/sn2003jo.dat -o results/

# Single spectrum with explicit templates
your_templates_dir=snid_sage/templates
snid identify data/sn2003jo.dat %your_templates_dir% -o results/

# Batch processing (default saves per-object summary and plots)
snid batch "data/*.dat" %your_templates_dir% -o results/

# Minimal outputs (summary only, no plots)
snid identify data/sn2003jo.dat -o results/ --minimal

# Complete outputs (summary, plots, and all additional data files)
snid identify data/sn2003jo.dat -o results/ --complete

# Disable plots explicitly (default is to generate plots)
snid identify data/sn2003jo.dat -o results/ --no-plots

Documentation & Support

• Complete Documentation
• Quick Start Guide
• GUI Manual
• CLI Reference
• AI Integration
• Troubleshooting

Supported Data Formats

• FITS files (.fits, .fit)
• ASCII tables (.dat, .txt, .ascii, .asci, .flm)
• Space-separated values with flexible column detection
• Custom formats with configurable parsers

Research & Citation

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

@software{snid_sage_2025,
  title={SNID SAGE: A Modern Framework for Interactive Supernova
         Classification and Spectral Analysis},
  author={F. Stoppa},
  year={In Prep, 2025},
  url={https://github.com/FiorenSt/SNID-SAGE}
}

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