persephone: stellar modelling and asteroseismology

What is persephone ?

persephone implements a parallelisable Python interface to compute MESA stellar model grids and run GYRE on them. It also provides a set of functions to analyse the computed model, among which seismic rotational kernels computations. In the future, grid fitting and inversion methods are planned to be implemented in the module.

Getting started

Prerequisites

persephone is written in Python3. The following Python package are necessary to use it :

• numpy
• scipy
• matplotlib
• h5py
• pathos
• py_mesa_reader
• pygyre

Note that for py_mesa_reader, you will have to clone the repository and install it manually from sources with pip.

A MESA and a GYRE installations are necessary to use the persephone.grids submodule.

Installation

You can install the packaged versions from PyPI by running

pip install star-persephone

You can also directly install the code from source. Clone the repository and run

pip install .

persephone does not have a conda-forge packaged version yet but it is planned to provide one in the future.

Documentation

An online documentation with tutorials and API is available on ReadTheDocs.

Author

• Sylvain N. Breton - Maintainer - (INAF-OACT, Catania, Italy)

Acknowledging persephone

If you use persephone in your work, please provide a link to the GitLab repository and the documentation.

You should also provide the proper citations and acknowledgements for MESA and GYRE.