willjroper/hoki

Bridging the gap between observation and theory

Bridging the Gap Between Observation and Theory

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.

---

Installing hoki

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.

---

Read the docs

Click Here! Click Here! Click Here!

---

Download Tutorials

Check out these Jupyter notebooks I made - you can find them on this repo!

---

Paper and how to cite us!

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}
 }

---

License

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.

---

Contributing

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 ;)