SNID SAGE Documentation¶
SNID SAGE (SuperNova IDentification – Spectral Analysis and Guided Exploration) is a Python tool for automated supernova spectral classification using cross-correlation with a library of 643+ template spectra.
Quick Start¶
New to SNID SAGE? Follow these three steps:
- Install –
pip install snid-sage - First Analysis – Load a spectrum and classify it
- Explore Results – Understand your classification
Features¶
| Feature | Description |
|---|---|
| GUI | Interactive PySide6/Qt interface with real-time plotting |
| CLI | Single-spectrum and batch processing from the command line |
| 643+ Templates | Ia, Ib, Ic, II, IIn, SLSN, TDE, KN, and more |
| AI Assistant | Optional LLM-powered analysis via OpenRouter |
| Multi-epoch | Templates with time evolution for age estimation |
Documentation¶
Getting Started¶
- Installation – Setup on Windows, macOS, Linux
- First Analysis – Step-by-step tutorial with screenshots
User Interfaces¶
- GUI Overview – Main window, controls, workflow
- CLI Reference – All commands and options
- Batch Processing – Process many spectra at once
Templates & Data¶
- Template Library – Built-in template bank
- Custom Templates – Add your own spectra
- Supported Formats – FITS, ASCII, CSV, etc.
Reference¶
- Parameters – All settings and defaults
- Configuration Guide – Profiles and paths
- API Reference – Python integration
- How to Cite – Paper details and BibTeX
- Troubleshooting – Common issues and fixes
AI Features¶
- AI Overview – LLM-powered analysis
- OpenRouter Setup – API configuration
Need Help?¶
- How to Cite SNID-SAGE – Paper and BibTeX entry
- Troubleshooting Guide – Solutions to common problems
- GitHub Issues – Report bugs
- GitHub Discussions – Ask questions
SNID SAGE v1.1.1 · January 2026