Skip to main content

extended Better Oscillation Detection, implemented in python3

Project description

eBOSC: extended Better OSCillation Detection


eBOSC (extended Better OSCillation detection) is a toolbox (or a set of scripts) that can be used to detect the occurrence of rhythms in continuous signals (i.e., at the single trial level). It uses a static aperiodic ‘background’ spectrum as the basis to define a ‘power threshold’ that continuous signals have to exceed in order to qualify as ‘rhythmic’. As such, it leverages the observation that stochastic components of the frequency spectrum of neural data are aharacterized by a '1/f'-like power spectrum. An additional ‘duration threshold’ can be set up in advance, or rhythmic episodes can be filtered by duration following detection to ensure that detected rhythmic episodes have a rather sustained vs. transient appearance.


A project wiki for eBOSC is available here.

Simulation scripts and data files regarding the 2020 NeuroImage paper can be found at

A MATLAB implementation can be found here.


Get the latest development version using git: git clone

To install this cloned copy, move into the cloned directory and run: pip install .

The example files in the /data directory are stored in Git Large File Storage. To retrieve them install the lfs (git lfs install), and then get the files with git lfs pull.

To get started, see the example provided in examples/eBOSC_example_empirical.ipynb. Data is based off a FieldTrip structure and conversion scripts to MNE-style format are provided in the examples directory.


If you want to use the tool but encounter issues, or would like to suggest a new feature, feel free to open an issue.


If you find the method useful, please cite the following papers:

Kosciessa, J. Q., Grandy, T. H., Garrett, D. D., & Werkle-Bergner, M. (2020). Single-trial characterization of neural rhythms: Potential and challenges. NeuroImage, 206, 116331.

Whitten, T. A., Hughes, A. M., Dickson, C. T., & Caplan, J. B. (2011). A better oscillation detection method robustly extracts EEG rhythms across brain state changes: The human alpha rhythm as a test case. NeuroImage, 54(2), 860–874.


eBOSC is an extension of the BOSC library and partially uses scripts from the original toolbox. These functions are included in the 'external' folder of the current package.

The eBOSC library (and the original BOSC library) are free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

The eBOSC library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ebosc-0.10.dev0.tar.gz (31.1 kB view hashes)

Uploaded source

Built Distribution

ebosc-0.10.dev0-py3-none-any.whl (31.9 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page