User Tools

Site Tools


muse_software

This is an old revision of the document!



Under Construction!

Muse Software

This page describes my software setup to communicate with the Muse brain-sensing headband.

Overview

I am running the Muse software on a MacBook Pro (Retina, 13-inch, Early 2015).

Base software environment:

  • Mac OS Mojave (10.14.3)
  • Default installation of Python 2.7 will work, but 3.x is preferred

To Install Python 3

These instructions are based largely on Installing Python 3 on Mac OS X from The Hitcher's Guide to Python

Open a terminal (e.g., iTerm) to run these commands.

$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
  • magic happens here
  • Install Python:2)
$ brew install python

Setup Virtual Environment

$ mkdir muse
$ cd muse

Python 2

$ virtualenv -p python2 py2
$ source py2/bin/activate

Python 3

$ virtualenv -p python3 py3
$ source py3/bin/activate

When Done

When done working with muse, either close the terminal window, or deactivate the virtual environment with…

$ deactivate

Install Muse LSL and Run a Streamer and a Viewer

Muse software is Muse LSL.

$ pip install muselsl

Plug in the Bluetooth USB (BLED112) dongle and turn on your Muse headband before launching muselsl.

$ muselsl stream

Open another terminal window, switch to the install directory, and run the visualizer:

$ cd muse
$ muselsl view -v 2

What Could Go Wrong?

Missing Packages

If some packages show up as missing when installing muselsl, install them manually:

$ pip install nose coverage

Uninstalling a Distutils Package

If an old version of a package (e.g., scipy) was installed using (the old) distutils, the new version might have problems uninstalling it. In that case, use the –ignore-installed option:

$ pip install --ignore-installed scipy

Some Depended Packages Don't get Installed

If when installing scipy, it complains that matplotlib is not installed, then install it directly:

$ pip install matplotlib

Permission Denied

If some packages cannot be installed in the virtual environment (or in the system environment), use –user to install them locally (in the user's ~/Library folder):

$ pip install muselsl --user

Useful Resources

*

1)
I am also using Mac Ports to manage some software packages, which may cause conflicts with Homebrew.
2)
Python 3 installed by default with this command.
muse_software.1555781409.txt.gz · Last modified: 2019/04/20 10:30 by jtkorb