# SNID SAGE - Advanced Supernova Spectral Analysis
[](https://python.org)
[](LICENSE)
[]()
<img src="docs/images/5.MatchTemplateFlux.png" alt="Match Template Flux" style="border: 2px solid #333; border-radius: 4px;">
**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)
```bash
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)
```bash
# 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
```bash
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
```bash
snid-sage
```
### Use the CLI
```bash
# Single spectrum analysis (templates auto-discovered). Saves summary (.output) and plots by default
sage data/sn2003jo.dat -o results/
# Batch processing (default saves per-object summary and plots)
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](https://fiorenst.github.io/SNID-SAGE/)**
- **[First Analysis Guide](https://fiorenst.github.io/SNID-SAGE/quickstart/first-analysis/)**
- **[GUI Manual](https://fiorenst.github.io/SNID-SAGE/gui/interface-overview/)**
- **[CLI Reference](https://fiorenst.github.io/SNID-SAGE/cli/command-reference/)**
- **[AI Integration](https://fiorenst.github.io/SNID-SAGE/ai/overview/)**
- **[Troubleshooting](https://fiorenst.github.io/SNID-SAGE/reference/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:
```bibtex
@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](https://github.com/FiorenSt/SNID-SAGE/issues)**
- **[Request Feature](https://github.com/FiorenSt/SNID-SAGE/issues)**
- **[Discussions](https://github.com/FiorenSt/SNID-SAGE/discussions)**
- **[Email Support](mailto:fiorenzo.stoppa@physics.ox.ac.uk)**
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
---
<div align="center">
**Made with care for the astronomical community**
[Documentation](https://fiorenst.github.io/SNID-SAGE/) • [Report Bug](https://github.com/FiorenSt/SNID-SAGE/issues) • [Request Feature](https://github.com/FiorenSt/SNID-SAGE/issues) • [Discussions](https://github.com/FiorenSt/SNID-SAGE/discussions)
</div>
Raw data
{
"_id": null,
"home_page": null,
"name": "snid-sage",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "Fiorenzo Stoppa <fiorenzo.stoppa@physics.ox.ac.uk>",
"keywords": "astronomy, supernova, spectrum, analysis, snid, machine-learning",
"author": null,
"author_email": "Fiorenzo Stoppa <fiorenzo.stoppa@physics.ox.ac.uk>",
"download_url": "https://files.pythonhosted.org/packages/fd/3c/e566bf06b1daf17c2878a061992eed48c6f464fb38daee11f2c00730e039/snid_sage-0.9.0.tar.gz",
"platform": null,
"description": "# SNID SAGE - Advanced Supernova Spectral Analysis\n\n[](https://python.org)\n[](LICENSE)\n[]()\n\n<img src=\"docs/images/5.MatchTemplateFlux.png\" alt=\"Match Template Flux\" style=\"border: 2px solid #333; border-radius: 4px;\">\n\n**SNID SAGE** (SuperNova IDentification \u2013 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.\n\n\n\n## Quick Installation\n\n### Install from PyPI (Recommended)\n\n```bash\npip install snid-sage\n```\n\nThis installs both the CLI and the full GUI stack by default, as defined in `pyproject.toml`.\n\n### Using a virtual environment (recommended)\n\n```bash\n# Create virtual environment\npython -m venv snid_env\n\n# Activate environment\n# Windows:\nsnid_env\\Scripts\\activate\n# macOS/Linux:\nsource snid_env/bin/activate\n\n# Install\npip install snid-sage\n```\n\n### Development installation\n\n```bash\ngit clone https://github.com/FiorenSt/SNID-SAGE.git\ncd SNID-SAGE\npip install -e .\n```\n\nNote: For user installs, you can use `pip install --user` to avoid system-wide changes.\n\n## Getting Started\n\n### Launch the GUI\n```bash\nsnid-sage\n```\n\n### Use the CLI\n```bash\n# Single spectrum analysis (templates auto-discovered). Saves summary (.output) and plots by default\nsage data/sn2003jo.dat -o results/\n\n# Batch processing (default saves per-object summary and plots)\nsage batch \"data/*.dat\" -o results/\n\n# Batch from a CSV list with per-row redshift (if provided)\nsage batch --list-csv \"data/spectra_list.csv\" -o results/\n```\n\n## Documentation & Support\n\n- **[Complete Documentation](https://fiorenst.github.io/SNID-SAGE/)**\n- **[First Analysis Guide](https://fiorenst.github.io/SNID-SAGE/quickstart/first-analysis/)**\n- **[GUI Manual](https://fiorenst.github.io/SNID-SAGE/gui/interface-overview/)**\n- **[CLI Reference](https://fiorenst.github.io/SNID-SAGE/cli/command-reference/)**\n- **[AI Integration](https://fiorenst.github.io/SNID-SAGE/ai/overview/)**\n- **[Troubleshooting](https://fiorenst.github.io/SNID-SAGE/reference/troubleshooting/)**\n\n## Supported Data Formats\n\n- FITS files (.fits, .fit)\n- ASCII tables (.dat, .txt, .ascii, .asci, .flm)\n- Space-separated values with flexible column detection\n- Custom formats with configurable parsers\n\n## Research & Citation\n\nIf you use SNID SAGE in your research, please cite:\n\n```bibtex\n@software{snid_sage_2025,\n title={SNID SAGE: A Modern Framework for Interactive Supernova\n Classification and Spectral Analysis},\n author={F. Stoppa},\n year={In Prep, 2025},\n url={https://github.com/FiorenSt/SNID-SAGE}\n}\n```\n\n## Community & Support\n\n- **[Report Bug](https://github.com/FiorenSt/SNID-SAGE/issues)**\n- **[Request Feature](https://github.com/FiorenSt/SNID-SAGE/issues)**\n- **[Discussions](https://github.com/FiorenSt/SNID-SAGE/discussions)**\n- **[Email Support](mailto:fiorenzo.stoppa@physics.ox.ac.uk)**\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n<div align=\"center\">\n\n**Made with care for the astronomical community**\n\n[Documentation](https://fiorenst.github.io/SNID-SAGE/) \u2022 [Report Bug](https://github.com/FiorenSt/SNID-SAGE/issues) \u2022 [Request Feature](https://github.com/FiorenSt/SNID-SAGE/issues) \u2022 [Discussions](https://github.com/FiorenSt/SNID-SAGE/discussions)\n\n</div>\n",
"bugtrack_url": null,
"license": null,
"summary": "SNID SAGE - SuperNova IDentification with Spectrum Analysis and Guided Enhancement",
"version": "0.9.0",
"project_urls": {
"Bug Reports": "https://github.com/FiorenSt/SNID-SAGE/issues",
"Documentation": "https://fiorenst.github.io/SNID-SAGE",
"Download": "https://github.com/FiorenSt/SNID-SAGE/archive/refs/heads/main.zip",
"Homepage": "https://github.com/FiorenSt/SNID-SAGE",
"Repository": "https://github.com/FiorenSt/SNID-SAGE.git"
},
"split_keywords": [
"astronomy",
" supernova",
" spectrum",
" analysis",
" snid",
" machine-learning"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "9c1fd1219f2810aac24eb78d1ea1ea023eddd0c9d4f1dda2f7d1ce11fde83d6a",
"md5": "eeec9dbcf13eea22416e33abe15331ed",
"sha256": "ec332440d2986e38648698b93d9154f7ffb7fcf673f21d7003b2fecdfdc2fb88"
},
"downloads": -1,
"filename": "snid_sage-0.9.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "eeec9dbcf13eea22416e33abe15331ed",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 77610066,
"upload_time": "2025-10-07T00:02:19",
"upload_time_iso_8601": "2025-10-07T00:02:19.537836Z",
"url": "https://files.pythonhosted.org/packages/9c/1f/d1219f2810aac24eb78d1ea1ea023eddd0c9d4f1dda2f7d1ce11fde83d6a/snid_sage-0.9.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "fd3ce566bf06b1daf17c2878a061992eed48c6f464fb38daee11f2c00730e039",
"md5": "1cc68798536ac994aaf77874cb919da3",
"sha256": "48788151eee810f78956ba0fefad76a79be508532036662026d06ac7556065ee"
},
"downloads": -1,
"filename": "snid_sage-0.9.0.tar.gz",
"has_sig": false,
"md5_digest": "1cc68798536ac994aaf77874cb919da3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 77611545,
"upload_time": "2025-10-07T00:02:23",
"upload_time_iso_8601": "2025-10-07T00:02:23.450722Z",
"url": "https://files.pythonhosted.org/packages/fd/3c/e566bf06b1daf17c2878a061992eed48c6f464fb38daee11f2c00730e039/snid_sage-0.9.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-07 00:02:23",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "FiorenSt",
"github_project": "SNID-SAGE",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "snid-sage"
}
JSON
