A Python signal processing package for computing spectral- and time-domain interactions using the bispectrum.

This package provides the tools for computing phase-amplitude coupling, time delay estimation, and waveshape features using the bispectrum and bicoherence. Additional tools for computing amplitude-amplitude coupling, phase-phase coupling, and spatio-spectral filters are also provided.

Parallel processing and Numba optimisation are implemented to reduce computation times.

If you use this toolbox in your work, please include the following citation:
Binns, TS, Pellegrini, F, Jurhar, T, Nguyen, TD, Köhler, RM, & Haufe, S (2025). PyBispectra: A toolbox for advanced electrophysiological signal processing using the bispectrum. Journal of Open Source Software. DOI: 10.21105/joss.08504

Contents:

• Motivation
• Installation
• Examples
  • Compute phase-amplitude coupling
  • Compute time delay estimates
  • Compute time delay estimates for frequency bands
  • Compute waveshape features
  • Spatio-spectral filtering for waveshape analysis
  • Compute time-resolved bispectral features
  • Compute the bispectrum and threenorm
• API
  • Cross-Frequency Coupling
  • Time Delay Estimation
  • Waveshape
  • General
  • Utilities
• Development