Skip to main content

Tools for EEG, ECoG, iEEG, especially for sleep

Project description

Package to analysis EEG, ECoG and other electrophysiology formats. It allows for visualization of the results and for a GUI that can be used to score sleep stages.


  • Can read files of format:
    • Axon (.abf, ABF2 only)
    • BCI2000 (.dat)
    • Blackrock (.nev, .ns2, .ns3, .ns5)
    • Brain Vision (.vhdr, .vmrk, .eeg / .dat)
    • EEGLAB (.set, .set / .fdt)
    • European Data Format (.edf)
    • EGI MFF (.mff)
    • Fieldtrip (.mat)
    • mne FIFF (.fiff)
    • Moberg (“EEG,Composite,SampleSeries,Composite,MRIAmp,data”)
    • openephys (.continuous, .openephys)
  • Interface for Sleep Scoring
  • Computes frequency analysis (spectrogram), time-frequency analysis (short-time spectrogram, Morlet wavelet)
  • Detection of spindles and slow waves
  • Pure Python


Install wonambi by running:

pip install wonambi

See Installation for details

If you want to scroll recordings and do some sleep scoring (requires PyQt5)


Run it!

From the command line, simply type:


To open a dataset directly, add the full path to the file you want to open:

wonambi /home/me/sleep_recordings.edf


See Documentation

Change Log

See Change Log


  • Python 3.6
  • numpy
  • scipy

Optional Requirements

  • PyQt5 (optional for sleep scoring GUI)
  • python-vlc (optional, to watch embedded movies)
  • vispy (optional to plot 3D brain surfaces and electrodes)
  • h5py (optional to read FieldTrip Matlab files)
  • mne (optional, to export to mne FIFF files)
  • nibabel (optional to read freesurfer)
  • tensorpac (optional to run phase-amplitude analysis, tensorpac version should be 0.5.6)
  • fooof (optional to run parametrization of power spectra)



The project is licensed under the GPLv3 license. Other licenses available upon request.

Project details

Release history Release notifications

This version


Download files

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

Files for wonambi, version 6.9
Filename, size File type Python version Upload date Hashes
Filename, size wonambi-6.9.tar.gz (289.7 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page