Muse S is a commercial brainwave scanner developed for meditation, sleeping etc. This tutorial will walk you through connecting Muse S to your computer and accessing the raw datastreams via OSC and Processing. Muse provides health related data which consists of PPG (heart rate) and EGG (Brain wavelengths). Besides these can also be gathered physical movement with gyroscope- and accelerometer data. With this tutorial we provide two ‘bare minimum’ Processing example codes for reading PPG and EEG to act as starting point to interface the Muse headset in your project.
Reading heart rate (PPG) from Muse S
- Download Petal Metrics app to your computer (In order to get download link fill in information as seen in screenshot below – replace “xxxx” with your ITU initials)
- Download Processing software to your computer and install.
- Clone or download the AIRLab Muse example code from Github
- Turn on the Muse S headset and launch the Petal Metrics software. Set the type of stream to OSC, and change the port to 12001. Click ‘save’ and then ‘start streaming’. If any changes are made to the settings you need to restart stream for the changes to take affect, it is not enough to press save.
- Open the ‘HeartBlob_bareMinimum’ code with processing and launch the program
The code creates a blob where size is more or less directly linked to the raw data from the PPG sensor. You can hit ‘r’ to refresh the threshold values, as the mean data can vary a lot depending on user, lighting etc. The OSC message follows the pattern defined in petal stream such as /PetalStream/PPG. Each PPG-message has the typetag iififfff – the first five datapoints are standard to every message from PetalStream, the last three are specific to PPG as unfolded in this schematic:
Reading brain wavelengths (EEG) from Muse S
- Open the ‘BrainWave_bareMinimum’ code with processing and launch the program
The code creates a small diagram of a select EEG-channel representing the raw datastream. You can change which channel to visualise within the code. The OSC message follows much the same pattern as above such as /PetalStream/EEG. Each EEG-message, however, has a different typetag of iififfffff – where the first five are standards, and the last five are specific EEG data: