ADACS-Australia / beans

2023A project lead by Adelle Goodwin
MIT License
0 stars 1 forks source link

====== BEANSp

.. .. image:: https://img.shields.io/pypi/v/beans.svg .. :target: https://pypi.python.org/pypi/beans

.. .. image:: https://img.shields.io/travis/adellej/beans.svg .. :target: https://travis-ci.org/adellej/beans

.. .. image:: https://readthedocs.org/projects/beans/badge/?version=latest .. :target: https://beans.readthedocs.io/en/latest/?badge=latest .. :alt: Documentation Status

Bayesian Estimation of Accreting Neutron Star parameters

Features

This software uses a Markov Chain Monte Carlo approach to match observations of an accreting neutron star in outburst with a simple ignition model to predict unobservable parameters such as neutron star mass, radius, surface gravity, distance and inclination of the source, and accreted fuel composition. The code is all written in Python 3, except for settle which is a c++ code with a python wrapper. It makes use of Dan Foreman-Mackey's python implementation of MCMC, emcee, available here - https://github.com/dfm/emcee.

Credits

Software written by Adelle Goodwin. See Goodwin et al. (2019) - https://arxiv.org/pdf/1907.00996.

This softwate (BEANSp) was based on code written by Duncan Galloway, and uses Dan Foreman-Mackey's python implementation of MCMC, emcee. It depends on pySettle (https://github.com/adellej/pysettle), which was forked from the original settle written by Andrew Cumming.

Package installation and usage

BEANSp is on pyPI (https://pypi.org/project/beansp/) so installation is easy - either straight or in virtual environment:

.. code-block::

  pip install beansp

.. ::

.. code-block::

  from beansp.beans import Beans 

(Please refer to this simple test script <https://github.com/adellej/beans/blob/master/tests/test_sft_beans.py>_ as an example.)

Build and installation from this github repository

Please refer to build instructions <https://github.com/adellej/beans/blob/master/BUILD.rst>_.