PECCARY#

peccary (Permutation Entropy and statistiCal Complexity Analysis for astRophYsics) is a Python package for distinguishing between regular, complex, and stochastic behavior in timeseries. It is based on the work by Bandt & Pompe (2002), Rosso et al. (2007), and Weck et al. (2015). This code is also based on work by collaborator David Schaffner, who wrote the initial version of some of the method, called PESCy.

In addition to calculating the Permutation Entropy (\(H\)) and Statistical Complexity (\(C\)) values, this package also has plotting tools for the \(HC\)-plane and visualizing the resulting \([H,C]\) values for various timeseries, examples timeseries, and utility functions.

A detailed summary of the PECCARY method can be found in Hyman, Daniel, & Schaffner (arXiv:2407.11970). If you make use of PECCARY, please include a citation to Hyman, Daniel, & Schaffner (arXiv:2407.11970) in any publications.

Note

This project is under active development.

Contents#

Citation and Attribution#

If you make use of this code, please cite the paper:

@article{peccary,
  author = {{Hyman}, S{\'o}ley {\'O}. and {Daniel}, Kathryne J. and {Schaffner}, David A.},
  title = "{PECCARY: A novel approach for characterizing orbital complexity, stochasticity, and regularity}",
  journal = {arXiv e-prints},
  keywords = {Astrophysics - Instrumentation and Methods for Astrophysics, Astrophysics - Astrophysics of Galaxies},
  year = 2024,
  month = jul,
  eid = {arXiv:2407.11970},
  pages = {arXiv:2407.11970},
  archivePrefix = {arXiv},
  eprint = {2407.11970},
  primaryClass = {astro-ph.IM},
  adsurl = {https://ui.adsabs.harvard.edu/abs/2024arXiv240711970H},
  adsnote = {Provided by the SAO/NASA Astrophysics Data System}}

Indices and tables#