Note: If you raise an issue and I ignore you please email: [email protected] (I probably just missed GitHub's email).
In order to facilitate the application of BPASS to a wide range of scientific investigations, we have developped the tools necessary for observers to take full advantage of our models in an intuitive manner.
Hoki is not only versatile, it also takes care of the nitty gritty pre-processing!
Spend less time on coding and more time on the science!
WHAT IS BPASS?
The Binary Populations And Spectral Synthesis (BPASS) code simulates stellar populations and follows their evolution until death. Including binary evolution is crucial to correctly interpreting astronomical observations. The detailed follow-up of the stellar evolution within the code allows the retreival of important information such as supernova and gravitational wave event rates, giving us the ability to understand the properties of the stellar populations that are the precursors of these events.
You can pip install the most recent stable release from pip:
pip3 install --user hoki
You can also download the github dev version with the following command:
pip3 install . git+https://github.com/HeloiseS/hoki
If you install the development version of hoki from github, we recommend you do so in a conda environment To check that hoki is up and running you can run the unit tests in the test folder. I like using pytest (which you'll have to download) and run
pytest --verbose
This way it'll show you each test as they pass or FAIL. In the pip and github version, they should all pass on your machine as data is provided within the package to test the functionalities.
Requirements: The following packages are required by hoki. If you pip install the stable version from pypi it will all be done automatically.
`astropy`, `numpy`, `scipy`, `pandas`, `matplotlib`, `pyyaml`, `wheel`, `emcee`, `corner`, `numba`, `specutils`, `ppxf`
Tested for python 3.7 and above. Python 2 not supported.
Click Here! Click Here! Click Here!
Check out these Jupyter notebooks I made - you can find them on this repo!
Our paper Hoki: Making BPASS Accessible Through Python has now been published in the Journal of Open Source Software (JOSS). (See DOI above)
The paper is available on ArXiv as published by JOSS
Please if you use `hoki` for your science, include us in your publications! As you can imagine developing a tool and maintaining it for the community is very time consuming, and unfortunatly citations remain the most important metric.
If you use the following tools, please acknowledge the follwing publications:
AgeWizard:
UnderlyingCountRatio:
BIBTEX
@ARTICLE{2020JOSS....5.1987S,
author = {{Stevance}, Heloise and {Eldridge}, J. and {Stanway}, Elizabeth},
title = "{Hoki: Making BPASS accessible through Python}",
journal = {The Journal of Open Source Software},
keywords = {Python, galaxies, Batchfile, SED, astronomy, binary stars, Astrophysics - Solar and Stellar Astrophysics, Astrophysics - Astrophysics of Galaxies, Astrophysics - Instrumentation and Methods for Astrophysics},
year = "2020",
month = "Jan",
volume = {5},
number = {45},
eid = {1987},
pages = {1987},
doi = {10.21105/joss.01987},
archivePrefix = {arXiv},
eprint = {2001.11069},
primaryClass = {astro-ph.SR},
adsurl = {https://ui.adsabs.harvard.edu/abs/2020JOSS....5.1987S},
adsnote = {Provided by the SAO/NASA Astrophysics Data System}
}
This project is Copyright (c) H. F. Stevance and licensed under the terms of the BSD 3-Clause license. This package is based upon the Astropy package template which is licensed under the BSD 3-clause licence.
If ANYTHING comes to mind, whether it be something in the tutorials, features you would like us to consider, BUGS, etc.. Please just drop it in an issue! Don't let your imposter syndrome talk you out of it ;)
