# PISCOLA: Python for Intelligent Supernova-COsmology Light-curve Analysis
**Supernova light-curve fitting code in python**
Although the main purpose of PISCOLA is to fit type Ia supernovae, it can be used to fit other types of supernovae or even other transients.
[![repo](https://img.shields.io/badge/GitHub-temuller%2Fpiscola-blue.svg?style=flat)](https://github.com/temuller/piscola)
[![documentation status](https://readthedocs.org/projects/piscola/badge/?version=latest&style=flat)](https://piscola.readthedocs.io/en/latest/?badge=latest)
[![license](http://img.shields.io/badge/license-MIT-blue.svg?style=flat)](https://github.com/temuller/piscola/blob/master/LICENSE)
[![Build and Tests](https://github.com/temuller/piscola/actions/workflows/main.yml/badge.svg)](https://github.com/temuller/piscola/actions/workflows/main.yml)
[![Coverage](https://raw.githubusercontent.com/temuller/piscola/master/coverage.svg)](https://raw.githubusercontent.com/temuller/piscola/master/coverage.svg)
![Python Version](https://img.shields.io/badge/Python-3.8%2B-blue)
[![PyPI](https://img.shields.io/pypi/v/piscola?label=PyPI&logo=pypi&logoColor=white)](https://pypi.org/project/piscola/)
[![ADS - 2022MNRAS.512.3266M ](https://img.shields.io/badge/ADS-_2022MNRAS.512.3266M_-2ea44f)](https://ui.adsabs.harvard.edu/abs/2022MNRAS.512.3266M/abstract)
Read the full documentation at: [piscola.readthedocs.io](http://piscola.readthedocs.io/). See below for a summary.
___
## Installation
PISCOLA can be installed in the usual ways, via pip:
```
pip install piscola
```
or from source:
```
git clone https://github.com/temuller/piscola.git
cd piscola
pip install .
```
### Requirements
PISCOLA has the following requirements:
```
numpy
pandas
matplotlib
peakutils
requests
sfdmap
extinction
astropy
scipy
george
pickle5
pytest (optional: for testing the code)
```
### Tests
To run the tests, go to the parent directory and run the following command:
```
pytest -v
```
## Using PISCOLA
PISCOLA can fit the supernova light curves and correct them in a few lines of code:
```python
sn = piscola.call_sn(<sn_file>)
sn.fit()
```
The light-curve parameters are saved in a dictionary and can be accessed directly:
```python
sn.lc_parameters # dictionary
sn.dm15
```
You can find an example of input file in the [data](https://github.com/temuller/piscola/tree/master/data) directory.
## Citing PISCOLA
If you make use of PISCOLA in your projects, please cite [Müller-Bravo et al. (2022)](https://ui.adsabs.harvard.edu/abs/2022MNRAS.512.3266M/abstract). See below for the bibtex format:
```code
@ARTICLE{2022MNRAS.512.3266M,
author = {{M{\"u}ller-Bravo}, Tom{\'a}s E. and {Sullivan}, Mark and {Smith}, Mathew and {Frohmaier}, Chris and {Guti{\'e}rrez}, Claudia P. and {Wiseman}, Philip and {Zontou}, Zoe},
title = "{PISCOLA: a data-driven transient light-curve fitter}",
journal = {\mnras},
keywords = {supernovae: general, cosmology: observations, distance scale, Astrophysics - High Energy Astrophysical Phenomena, Astrophysics - Cosmology and Nongalactic Astrophysics, Astrophysics - Instrumentation and Methods for Astrophysics, Astrophysics - Solar and Stellar Astrophysics},
year = 2022,
month = may,
volume = {512},
number = {3},
pages = {3266-3283},
doi = {10.1093/mnras/stab3065},
archivePrefix = {arXiv},
eprint = {2110.11340},
primaryClass = {astro-ph.HE},
adsurl = {https://ui.adsabs.harvard.edu/abs/2022MNRAS.512.3266M},
adsnote = {Provided by the SAO/NASA Astrophysics Data System}
}
```
## Contributing and raising an issue
The recommended way is to use the [issues](https://github.com/temuller/piscola/issues) page or send a pull request. Otherwise, you can contact me directly.
Raw data
{
"_id": null,
"home_page": "https://github.com/temuller/piscola",
"name": "piscola",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "",
"keywords": "",
"author": "Tom\u00e1s Enrique M\u00fcller Bravo",
"author_email": "t.e.muller-bravo@soton.ac.uk",
"download_url": "https://files.pythonhosted.org/packages/b9/f6/161b697e3824c38ecd839cc46ad79994b3bf8060660cb7d3fe0bb8235897/piscola-1.2.0.tar.gz",
"platform": null,
"description": "# PISCOLA: Python for Intelligent Supernova-COsmology Light-curve Analysis\n\n**Supernova light-curve fitting code in python**\n\nAlthough the main purpose of PISCOLA is to fit type Ia supernovae, it can be used to fit other types of supernovae or even other transients.\n\n[![repo](https://img.shields.io/badge/GitHub-temuller%2Fpiscola-blue.svg?style=flat)](https://github.com/temuller/piscola)\n[![documentation status](https://readthedocs.org/projects/piscola/badge/?version=latest&style=flat)](https://piscola.readthedocs.io/en/latest/?badge=latest)\n[![license](http://img.shields.io/badge/license-MIT-blue.svg?style=flat)](https://github.com/temuller/piscola/blob/master/LICENSE)\n[![Build and Tests](https://github.com/temuller/piscola/actions/workflows/main.yml/badge.svg)](https://github.com/temuller/piscola/actions/workflows/main.yml)\n[![Coverage](https://raw.githubusercontent.com/temuller/piscola/master/coverage.svg)](https://raw.githubusercontent.com/temuller/piscola/master/coverage.svg)\n![Python Version](https://img.shields.io/badge/Python-3.8%2B-blue)\n[![PyPI](https://img.shields.io/pypi/v/piscola?label=PyPI&logo=pypi&logoColor=white)](https://pypi.org/project/piscola/)\n[![ADS - 2022MNRAS.512.3266M ](https://img.shields.io/badge/ADS-_2022MNRAS.512.3266M_-2ea44f)](https://ui.adsabs.harvard.edu/abs/2022MNRAS.512.3266M/abstract)\n\nRead the full documentation at: [piscola.readthedocs.io](http://piscola.readthedocs.io/). See below for a summary.\n\n___\n## Installation\n\nPISCOLA can be installed in the usual ways, via pip:\n\n```\npip install piscola\n```\n\nor from source:\n\n```\ngit clone https://github.com/temuller/piscola.git\ncd piscola\npip install .\n```\n\n### Requirements\n\nPISCOLA has the following requirements:\n\n```\nnumpy\npandas\nmatplotlib\npeakutils\nrequests\nsfdmap\nextinction\nastropy\nscipy\ngeorge\npickle5\npytest (optional: for testing the code)\n```\n\n### Tests\n\nTo run the tests, go to the parent directory and run the following command:\n\n```\npytest -v\n```\n\n## Using PISCOLA\n\nPISCOLA can fit the supernova light curves and correct them in a few lines of code:\n\n\n```python\nsn = piscola.call_sn(<sn_file>)\nsn.fit()\n```\n\nThe light-curve parameters are saved in a dictionary and can be accessed directly:\n\n```python\nsn.lc_parameters # dictionary\nsn.dm15\n```\n\nYou can find an example of input file in the [data](https://github.com/temuller/piscola/tree/master/data) directory.\n\n## Citing PISCOLA\n\nIf you make use of PISCOLA in your projects, please cite [M\u00fcller-Bravo et al. (2022)](https://ui.adsabs.harvard.edu/abs/2022MNRAS.512.3266M/abstract). See below for the bibtex format:\n\n```code\n@ARTICLE{2022MNRAS.512.3266M,\n author = {{M{\\\"u}ller-Bravo}, Tom{\\'a}s E. and {Sullivan}, Mark and {Smith}, Mathew and {Frohmaier}, Chris and {Guti{\\'e}rrez}, Claudia P. and {Wiseman}, Philip and {Zontou}, Zoe},\n title = \"{PISCOLA: a data-driven transient light-curve fitter}\",\n journal = {\\mnras},\n keywords = {supernovae: general, cosmology: observations, distance scale, Astrophysics - High Energy Astrophysical Phenomena, Astrophysics - Cosmology and Nongalactic Astrophysics, Astrophysics - Instrumentation and Methods for Astrophysics, Astrophysics - Solar and Stellar Astrophysics},\n year = 2022,\n month = may,\n volume = {512},\n number = {3},\n pages = {3266-3283},\n doi = {10.1093/mnras/stab3065},\narchivePrefix = {arXiv},\n eprint = {2110.11340},\n primaryClass = {astro-ph.HE},\n adsurl = {https://ui.adsabs.harvard.edu/abs/2022MNRAS.512.3266M},\n adsnote = {Provided by the SAO/NASA Astrophysics Data System}\n}\n```\n\n## Contributing and raising an issue\n\nThe recommended way is to use the [issues](https://github.com/temuller/piscola/issues) page or send a pull request. Otherwise, you can contact me directly.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Type Ia Supernova Light-curve fitting code",
"version": "1.2.0",
"project_urls": {
"Homepage": "https://github.com/temuller/piscola"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8cc9380b4a9986d883512cd03caaecc1f48831faa3094804f1b2d4afd46a192d",
"md5": "46933fddb3b2e8f94acee523b256e465",
"sha256": "94e48df25aefca87a3f0d8880aba582a904d0d8b56f4e8983c254362bd78745b"
},
"downloads": -1,
"filename": "piscola-1.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "46933fddb3b2e8f94acee523b256e465",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 18904703,
"upload_time": "2023-06-07T14:31:20",
"upload_time_iso_8601": "2023-06-07T14:31:20.020247Z",
"url": "https://files.pythonhosted.org/packages/8c/c9/380b4a9986d883512cd03caaecc1f48831faa3094804f1b2d4afd46a192d/piscola-1.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b9f6161b697e3824c38ecd839cc46ad79994b3bf8060660cb7d3fe0bb8235897",
"md5": "9923c37db8469f12c7f1e1a188284da0",
"sha256": "d12283d3d971430441f7da71a7ca89b98829da61a4b55ab3b12f5b8b0f377e33"
},
"downloads": -1,
"filename": "piscola-1.2.0.tar.gz",
"has_sig": false,
"md5_digest": "9923c37db8469f12c7f1e1a188284da0",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 18663816,
"upload_time": "2023-06-07T14:31:32",
"upload_time_iso_8601": "2023-06-07T14:31:32.628591Z",
"url": "https://files.pythonhosted.org/packages/b9/f6/161b697e3824c38ecd839cc46ad79994b3bf8060660cb7d3fe0bb8235897/piscola-1.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-06-07 14:31:32",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "temuller",
"github_project": "piscola",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "piscola"
}