sntools
sntools: An event generator for supernova burst neutrinos - Published in JOSS (2021)
Science Score: 54.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
○DOI references
-
✓Academic publication links
Links to: arxiv.org, zenodo.org -
✓Committers with academic emails
5 of 12 committers (41.7%) from academic institutions -
✓Institutional organization owner
Organization snews2 has institutional domain (snews.bnl.gov) -
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (17.5%) to scientific vocabulary
Scientific Fields
Repository
Event generator for supernova burst neutrinos
Basic Info
Statistics
- Stars: 11
- Watchers: 2
- Forks: 14
- Open Issues: 11
- Releases: 18
Metadata Files
README.md
sntools
sntools is a Monte Carlo event generator for supernova neutrino interactions.
It is a command line application that uses detailed time- and energy-dependent neutrino fluxes (provided by various supernova models) to generate interactions within the detector volume and write them to event files that can be used as an input for a full detector simulation. sntools was originally developed for Hyper-Kamiokande and later extended to support different detectors and detector materials.
Additionally, sntools can be used as a Python library that implements neutrino cross sections.
This README file should give a brief overview over sntools and help you get started. For more information, see the full documentation for each release on GitHub.
Getting Started
Installation Instructions
First, make sure you have Python 3.8 or higher installed on your computer.
Then, in a terminal, run
pip install sntools
to install the latest version of sntools and all dependencies.
Finally, run
python -c 'import sntools; sntools.setup()'
to check whether sntools is working and to download the sample input file for the usage examples below.
Example Usage
To generate your first supernova neutrino events with sntools, open a terminal window and type in the following command:
sntools fluxes/intp2001.data --format nakazato --endtime 50
This generates events for the first 50 ms of a supernova based on the neutrino flux given in the input file fluxes/intp2001.data (which is in the nakazato format) and writes them to a file named outfile.kin in the current directory.
(This sample input file is included in the sntools repository. See this web page for more information.)
A more realistic usage that demonstrates more of sntools’ capabilities looks like this:
sntools fluxes/intp2001.data --format nakazato --channel es --detector SuperK --distance 20 --verbose --output intp2001es.kin
This uses the neutrino flux given in the same input file to generate neutrino-electron elastic scattering events in Super-Kamiokande for a supernova at 20 kpc distance. It also produces more verbose output, which lets you see that sntools generates events separately for different neutrino flavours (which have different fluxes and cross sections), before merging them into an output file named intp2001es.kin.
You can also run
sntools -h
to get an overview over all of sntools’ options.
Input
Text file(s) containing information about neutrino fluxes produced by the supernova. sntools distinguishes between three flavours: nue, anti-nue and nux (where nux stands for numu or nutau or their respective antineutrinos). The following input formats are supported.
Nakazato format
Used by recent simulations by the Nakazato group. Fluxes for 13 and 20 solar mass progenitors are included as fluxes/intp1301.data and fluxes/intp2001.data. A description of the format and fluxes for more progenitors are available online.
If you use these included models in your work, please cite Nakazato et al., ApJ Supp. 205 (2013) 2.
Gamma format
Text file containing time, mean energy, mean squared energy and luminosity. These parameters describe a Gamma distribution, which is a good fit to the true spectrum. See fluxes/sample-gamma.txt for an unphysical sample file.
Warren2020 format
Similar to the Gamma format, but in an HDF5 file instead of plain text. Data available online.
Princeton format
Used in recent simulations by the Princeton group.
Totani format
Used in historical simulation by Totani et al., which is the baseline model in the Hyper-Kamiokande Design Report.
Interaction Channels
sntools supports the main interaction channels in water and liquid scintillator.
For water Cherenkov detectors, like Hyper-Kamiokande, these are inverse beta decay, elastic scattering on electrons and charged-current interactions of nue and anti-nue on oxygen-16 nuclei.
For liquid scintillator detectors, these are inverse beta decay, elastic scattering on electrons, charged-current interactions of nue and anti-nue on carbon-12 nuclei and neutral-current interactions on carbon-12 nuclei.
Water-based liquid scintillator, a mixture of the two materials, is also supported.
Output
A text file in the NUANCE format (used by the /mygen/vecfile options in WCSim) or the RATPAC format.
Support and Contributing
To report problems or ask for help, open an issue on GitHub or email the lead developer.
Contributions to sntools are welcome! See instructions in the full documentation for help on common ways to extend sntools (e. g. by adding a new detector, input format or interaction channel) and please submit a pull request with your contributions!
Please note that this project is released with a Contributor Code of Conduct (see CODE_OF_CONDUCT.md). By participating in this project you agree to abide by its terms.
Owner
- Name: SNEWS2.0
- Login: SNEWS2
- Kind: organization
- Location: Virtual
- Website: https://snews.bnl.gov/
- Repositories: 14
- Profile: https://github.com/SNEWS2
The SuperNova Early Warning System
GitHub Events
Total
- Issues event: 1
- Issue comment event: 7
- Fork event: 2
Last Year
- Issues event: 1
- Issue comment event: 7
- Fork event: 2
Committers
Last synced: 8 months ago
Top Committers
| Name | Commits | |
|---|---|---|
| Jost Migenda | j****a@k****k | 305 |
| Susanna Wakely | s****y@g****m | 30 |
| Liz Kneale | e****e@g****m | 21 |
| mcolomermolla | m****a@k****e | 7 |
| Sammy Valder | s****3@a****t | 7 |
| Tom Dealtry | t****y@l****k | 6 |
| Sammy Valder | s****3@a****r | 6 |
| Yan-Jie Schnellbach | 7****h | 4 |
| Sammy Valder | s****3@m****k | 2 |
| Chris Walter | c****r@d****u | 1 |
| Arfon Smith | a****n | 1 |
| Alex Himmel | a****l@p****u | 1 |
Committer Domains (Top 20 + Academic)
Issues and Pull Requests
Last synced: 7 months ago
All Time
- Total issues: 4
- Total pull requests: 3
- Average time to close issues: 12 days
- Average time to close pull requests: 23 days
- Total issue authors: 3
- Total pull request authors: 1
- Average comments per issue: 2.25
- Average comments per pull request: 0.33
- Merged pull requests: 3
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 3
- Pull requests: 0
- Average time to close issues: 1 day
- Average time to close pull requests: N/A
- Issue authors: 2
- Pull request authors: 0
- Average comments per issue: 2.33
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
- JostMigenda (2)
- slconti (1)
- Papetitje (1)
Pull Request Authors
- JostMigenda (6)
Top Labels
Issue Labels
Pull Request Labels
Packages
- Total packages: 1
-
Total downloads:
- pypi 68 last-month
- Total dependent packages: 0
- Total dependent repositories: 1
- Total versions: 19
- Total maintainers: 1
pypi.org: sntools
Event generator for supernova burst neutrinos
- Homepage: https://github.com/SNEWS2/sntools
- Documentation: https://sntools.readthedocs.io/
- License: BSD License
-
Latest release: 1.0.1
published over 4 years ago
Rankings
Maintainers (1)
Dependencies
- actions/checkout v3 composite
- actions/setup-python v4 composite
- actions/checkout v3 composite
- actions/create-release v1 composite
- actions/upload-release-asset v1 composite
- xu-cheng/latex-action v2 composite
- actions/checkout v3 composite
- actions/setup-python v4 composite
- h5py >= 2.10
- numpy *
- scipy *
- snewpy ~=1.4b1
- uproot *