This page details hardware prerequisites for running MUSE experiments and how to install the necessary software packages.
Prerequisites
Hardware
This tutorial presupposes some knowledge of Mac OS X or other Unix-like system such as Linux, in that entering and running commands in a terminal is required.
- A recent Apple Mac. We have tested successfully on both MacBook Pros and MacBook Airs.
- Mac OS X 10.10 or newer. Older versions may work but we have not confirmed this.
- a MUSE headset
- a fast Internet connection to download the required software.
This tutorial presupposes some knowledge of Mac OS X or other Unix-like system such as Linux, in that entering and running commands in a terminal is required.
Software Setup
1. Install MATLAB.
Follow directions in install wizard to complete the MATLAB install (this will take a while).
2. Regardless of the Mac OS X version your computer is running, If you installed MATLAB 2016a or later, go to Step 3.
Otherwise, if you installed a version of MATLAB earlier than 2016a, AND you are on Mac OS X El Capitan (10.11), perform the following steps:
After MATLAB is installed, close MATLAB and open an OSX Terminal:
a. Open a Terminal from Application --> Utilities --> Terminal
b. In Terminal, run the following commands to fix mex file compilation on OS X 10.11 (El Capitan):
cd /Applications/MATLAB_R201xx.app/bin/maci64/mexopts/
where xx = the version of your MATLAB.
chmod 666 clang*
c. Using your favourite text editor (not word processor), such as TextEdit or vim, open the clang_maci64.xml file and search for the following line:
“<dirExists name="$$/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.10.sdk" />”
d. Copy that line, and replace “10.10” in the new line with “10.11”.
e. Find the line “<cmdReturns name="find $$ -name MacOSX10.10.sdk" />”
f. Copy that line, and replace “10.10” in the new line with “10.11”. There are TWO of each of these lines in the file for a total of four lines that must be duplicated and edited.
g. Save and close clang_maci64.xml.
h. Open clang++_maci64.xml in your text editor and search for the following line:
“<dirExists name="$$/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.10.sdk" />”.
i. Copy that line, and replace “10.10” in the new line with “10.11”.
j. Find the line:
“<cmdReturns name="find $$ -name MacOSX10.10.sdk" />”
k. Copy that line, and replace “10.10” in the new line with “10.11”. There are TWO of each of these lines in the file for a total of four lines that must be duplicated and edited.
l. Save and close clang++_maci64.xml.
m. In the Terminal, type and run chmod 444 clang* to reset file permissions to defaults.
3. Install XCode Command Line Tools from Apple:
a. In Terminal, run: xcode-select --install
b. In Terminal, run: sudo xcodebuild -license
c. At the end of the license, type ‘accept’ and then hit Enter.
d. Hit Space repeatedly to scroll through the license agreement
e. Enter your password and hit Enter.
4. Install Psychtoolbox:
a. Save the DownloadPsychToolbox.m script listed on the Download page to your desktop.
b. Open Matlab and type the following commands:
cd ~/Desktop
DownloadPsychtoolbox
c. Follow prompts in the to complete Psychtoolbox install. If asked about a certificate, accept it permanently by pressing ‘p’ and then Enter.
d. When the script completes, exit Matlab.
5. Install liblo:
a. Download liblo.tar.gz to the Downloads folder on your computer.
b. Open Terminal and run the following command to change to your Downloads folder: cd Downloads/
c. Run the following command to expand the liblo archive file: tar xvzf liblo-0.28.tar.gz
d. Change directory into the liblo-0.28 folder: cd liblo-0.28/
e. Run: make clean
f. Run: ./configure
g. Run: make
You will get warnings, but as long as there are no errors reported, continue.
h. Run the following command: sudo make install
You will need to enter your password to gain root access for this command.
6. Install Muse SDK
Download the OSX research tools and follow the prompts. Install all components.
7. Install the OSC libraries in MATLAB:
a. Download OSC for Mac i64 from the OSC page.
b. Copy the osc-mexmaci64/osc-mexmaci64 directory to /Users/<yourusername>/MATLAB/
c. Open MATLAB.
d. Add /Users/<yourusername>/MATLAB/osc-meximac64 to the MATLAB path using the Set Path tool.
Your computer should now be set up and ready to run MUSE experiments!
If you have questions, please contact us using the form below.
Follow directions in install wizard to complete the MATLAB install (this will take a while).
2. Regardless of the Mac OS X version your computer is running, If you installed MATLAB 2016a or later, go to Step 3.
Otherwise, if you installed a version of MATLAB earlier than 2016a, AND you are on Mac OS X El Capitan (10.11), perform the following steps:
After MATLAB is installed, close MATLAB and open an OSX Terminal:
a. Open a Terminal from Application --> Utilities --> Terminal
b. In Terminal, run the following commands to fix mex file compilation on OS X 10.11 (El Capitan):
cd /Applications/MATLAB_R201xx.app/bin/maci64/mexopts/
where xx = the version of your MATLAB.
chmod 666 clang*
c. Using your favourite text editor (not word processor), such as TextEdit or vim, open the clang_maci64.xml file and search for the following line:
“<dirExists name="$$/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.10.sdk" />”
d. Copy that line, and replace “10.10” in the new line with “10.11”.
e. Find the line “<cmdReturns name="find $$ -name MacOSX10.10.sdk" />”
f. Copy that line, and replace “10.10” in the new line with “10.11”. There are TWO of each of these lines in the file for a total of four lines that must be duplicated and edited.
g. Save and close clang_maci64.xml.
h. Open clang++_maci64.xml in your text editor and search for the following line:
“<dirExists name="$$/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.10.sdk" />”.
i. Copy that line, and replace “10.10” in the new line with “10.11”.
j. Find the line:
“<cmdReturns name="find $$ -name MacOSX10.10.sdk" />”
k. Copy that line, and replace “10.10” in the new line with “10.11”. There are TWO of each of these lines in the file for a total of four lines that must be duplicated and edited.
l. Save and close clang++_maci64.xml.
m. In the Terminal, type and run chmod 444 clang* to reset file permissions to defaults.
3. Install XCode Command Line Tools from Apple:
a. In Terminal, run: xcode-select --install
b. In Terminal, run: sudo xcodebuild -license
c. At the end of the license, type ‘accept’ and then hit Enter.
d. Hit Space repeatedly to scroll through the license agreement
e. Enter your password and hit Enter.
4. Install Psychtoolbox:
a. Save the DownloadPsychToolbox.m script listed on the Download page to your desktop.
b. Open Matlab and type the following commands:
cd ~/Desktop
DownloadPsychtoolbox
c. Follow prompts in the to complete Psychtoolbox install. If asked about a certificate, accept it permanently by pressing ‘p’ and then Enter.
d. When the script completes, exit Matlab.
5. Install liblo:
a. Download liblo.tar.gz to the Downloads folder on your computer.
b. Open Terminal and run the following command to change to your Downloads folder: cd Downloads/
c. Run the following command to expand the liblo archive file: tar xvzf liblo-0.28.tar.gz
d. Change directory into the liblo-0.28 folder: cd liblo-0.28/
e. Run: make clean
f. Run: ./configure
g. Run: make
You will get warnings, but as long as there are no errors reported, continue.
h. Run the following command: sudo make install
You will need to enter your password to gain root access for this command.
6. Install Muse SDK
Download the OSX research tools and follow the prompts. Install all components.
7. Install the OSC libraries in MATLAB:
a. Download OSC for Mac i64 from the OSC page.
b. Copy the osc-mexmaci64/osc-mexmaci64 directory to /Users/<yourusername>/MATLAB/
c. Open MATLAB.
d. Add /Users/<yourusername>/MATLAB/osc-meximac64 to the MATLAB path using the Set Path tool.
Your computer should now be set up and ready to run MUSE experiments!
If you have questions, please contact us using the form below.