Skip to main content

This package contains code for graphing Muse EEG data

Project description


Algorithmic Biofeedback Control System - Chart Tools

This script will generate a number of charts from Muse headband EEG CSV data files created by the Mind Monitor app. Future versions of these tools will support Muse Direct and Muse Lab files.

Install instructions:

Download and Install

  1. Download the archive file, save in a temp directory
  2. Unzip the file:
    $ unzip
  3. Change diretory into the Muse-Analysis-Tools-master directory:
    $ cd Muse-Analysis-Tools-master
  4. Run the to install the application:
    $ python3 install

Clone using Git and Install

  1. Clone the project using git in a temp directory.
    $ git clone
  2. Change diretory into the Muse-Analysis-Tools-master directory:
    $ cd Muse-Analysis-Tools-master
  3. Run the to install the application:
    $ python3 install

Install from the Python Package Index

The project can be view here:

Using the 'pip' command:
$ pip install Muse-Analysis-Tools

Using the 'pip3' command to ensure you're installing the Python 3 packages:
$ pip3 install Muse-Analysis-Tools

NOTE: This application requires Python version 3. To check which version of python you have installed enter this command:
$ python --version
Python 3.7.4

To fix an error with pandas on Linux that occasionally happens, force a reinstall with this command:

pip install --upgrade --force-reinstall pandas


  1. Change directory to where the data files are located (sometimes this makes it easier to locate files).
$ cd /Volumes/Archive/muse_recordings/muse_monitor_recordings/   
  1. Startup the application:
  2. Select the options and CSV file you want to process.
  3. Make plots!


  1. Output images and session data are created within the same directory that the CSV files live. This will change in the future to allow the user to select the output directory.

For more information about the graphs interface (from matplotlib) please refer to this link:


$ -h 

usage: [-h] [--version] [-f CSV_FILE] [-v VERBOSE] [-d]
                            [-b] [-dm] [-pm] [-e] [-p] [-ep] [-hdf5] [-ag]
                            [-mc] [-s] [-c] [--plot_style PLOT_STYLE] [-sm]
                            [-sw SMOOTH_WINDOW] [-r] [-eegc EEG_CLIP] [-fd]
                            [-ft FILTER_TYPE] [-lc LOWCUT] [-hc HIGHCUT]
                            [-o FILTER_ORDER] [-db]

optional arguments:
  -h, --help            show this help message and exit
  --version             Print the current version number
  -f CSV_FILE, --csv_file CSV_FILE
                        CSV file to read)
  -v VERBOSE, --verbose VERBOSE
                        Increase output verbosity
  -d, --display_plots   Display Plots
  -b, --batch           Batch Mode
  -dm, --data_markers   Add Data Markers
  -pm, --plot_markers   Add Plot Markers
  -e, --eeg             Plot EEG Data
  -p, --power           Plot Power Bands
  -ep, --eeg_power      Plot EEG & Power Data Combined
  -hdf5, --write_hdf5_file
                        Write output data into HDF5 file
  -ag, --accel_gyro     Plot Acceleration and Gyro Data
  -mc, --mellow_concentration
                        Plot Mellow and Concentratio Data (Only For Mind
                        Monitor Data)
  -s, --stats_plots     Plot Statistcal Data
  -c, --coherence_plots
                        Plot Coherence Data
  --plot_style PLOT_STYLE
                        Plot Syle: 1=seaborn, 2=seaborn-pastel, 3=seaborn-
                        ticks, 4=fast, 5=bmh
  -sm, --smooth_data    Smooth EEG Data
  -sw SMOOTH_WINDOW, --smooth_window SMOOTH_WINDOW
                        Smoothing Window (Seconds)
  -r, --auto_reject_data
                        Auto Reject EEG Data
  -eegc EEG_CLIP, --eeg_clip EEG_CLIP
                        Cliping for Auto Reject EEG Data
  -fd, --data_filtering
                        Filter EEG Data
  -ft FILTER_TYPE, --filter_type FILTER_TYPE
                        Filter Type 0=default 1=low pass, 2=bandpass
  -lc LOWCUT, --lowcut LOWCUT
                        Filter Low Cuttoff Frequency
  -hc HIGHCUT, --highcut HIGHCUT
                        Filter High Cuttoff Frequency
  -o FILTER_ORDER, --filter_order FILTER_ORDER
                        Filter Order
  -db, --data_base      Send session data and statistics to database

To find the current version of the application:

Current version:  1.1.22

The ".ABCS_parms.rc" runtime configuration file can be configured to define often used parameters or for batch processing.

{"First Name": "Debra", "Last Name": "Peri", "Data Dir": "/Volumes/Archive/muse_recordings/muse_monitor_recordings",
"Data Base Location": "/Volumes/Archive/muse_recordings/muse_monitor_recordings", "Filter Data": 1, "Filter Type": 1, "Filter LowCut": 0.5, "Filter HighCut": 70.0}

picture alt

Important note on sampling rate: Select "Constant" from the Mind Monitor recording interval option.

picture alt

Session data in JSON format.

picture alt

Session data in SQL (SQLite) Database.

picture alt

Session/EEG data in HDF5 format.

picture alt

picture alt


If you would like to support this project, to help to contribute to disabled folks and to help youth gain access to yoga (in the Olympia, WA area) please send your kind donations to this paypal account. We appreciate any and all help for this important work.

You can read more about our outreach program here:


Project details

Download files

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

Files for Muse-Analysis-Tools, version 1.1.23
Filename, size File type Python version Upload date Hashes
Filename, size Muse_Analysis_Tools-1.1.23-py3.7.egg (542.4 kB) File type Egg Python version 3.7 Upload date Hashes View hashes
Filename, size Muse_Analysis_Tools-1.1.23-py3-none-any.whl (472.7 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size Muse-Analysis-Tools-1.1.23.tar.gz (230.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