star-privateer

The present module provides a complete API to implement tools for stellar surface rotation and activity analysis in photometric light curves collected by space missions such as NASA/Kepler, NASA/TESS or, in a near future, ESA/PLATO. Several tutorials are included in order to help new users that would like to discover the code.

Getting Started

Prerequisites

The module is written in Python 3. The following Python packages are necessary to use it:

• numpy
• scipy
• pandas
• matplotlib
• astropy
• tqdm
• scikit-learn
• scikit-image
• ssqueezepy
• pycwt
• pywavelets

Installing

The simplest way to install the module is through PyPi

pip install star-privateer

You can also install the most recent version of the module by cloning the GitLab repository

git clone https://gitlab.com/sybreton/star_privateer.git

and installing it directly by going to the root of the cloned repository

pip install .

Some of the tutoriels notebook require additional datasets to be properly run, you can access them through an auxiliary repository

git clone https://gitlab.com/sybreton/plato_msap4_demonstrator_datasets.git

that you will also have to install through

pip install .

In the future, we plan to provide packaged versions of the pipeline through conda-forge.

Documentation

API Documentation and tutorials are available here.

Authors

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

Active contributors:

• Antonino F. Lanza - Responsible PLATO WP122 - (INAF-OACT, Catania, Italy)
• Sergio Messina - Responsible PLATO WP122300 - (INAF-OACT, Catania, Italy)
• Rafael A. García (CEA Saclay, France)
• S. Mathur (IAC Tenerife, Spain)
• Angela R.G. Santos (Universidade do Porto, Portugal)
• L. Bugnet (ISTA Vienna, Austria)
• E. Corsaro (INAF-OACT, Catania, Italy)
• D.B. Palakkatharappil (CEA Saclay, France)
• E. Panetier (CEA Saclay, France)
• O. Roth (LESIA, Observatoire de Paris, France)
• M.B. Nielsen (University of Birmingham, United Kingdom)

Former contributors:

• Emile Carinos (CEA Saclay, France)
• Yassine Dhifaoui (CEA Saclay/Université Clermont-Auvergne, France)

Acknowledgements

If you use this module in your work, please provide a link to the GitLab repository.

You will find references for most of the methods implemented in this module in Breton et al. 2021 and in Santos et al. 2019, if you make use of the code in view of a scientific publication, please take a look at these two papers in order to provide the relevant citations.

The Kepler light curves included in the datasets were calibrated with the KEPSEISMIC method, if you use them, please cite García et al. 2011, García et al. 2014 and Pires et al. 2015.

The PLATO simulated light curves included in the datasets were produced and detrended by Suzanne Aigrain and Oscar Barragán. If you make any use of these light curves, please acknowledge them and cite Aigrain et al. 2015. For more information about the light curves, a readme file written by S. Aigrain is included.

License and copyright

The current version of the module is licensed under MIT License.

All source code copyright belongs to Sylvain Breton, unless specified differently in the header source files.