从muse耳机传输和可视化eeg数据。
muselsl的Python项目详细描述
缪斯LSL
一个python包,用于流媒体、可视化和记录muse 2016头带的脑电数据。
要求
该代码依赖于pygatt或bluemuse进行ble通信,并在不同的操作系统上以不同的方式工作。
- windows:在windows 10上,我们建议安装bluemuse并使用其gui来发现和连接muse设备。或者,如果您有bled112加密狗,您可以尝试muse lsl的bgapi后端(
muselsl stream--backend bgapi
)。 - mac:在mac上,需要一个bled112加密狗。bgapi后端是必需的,在从命令行运行muse lsl时默认使用bgapi后端
- Linux:不需要加密狗。但是,您可能需要运行一个命令来启用对蓝牙硬件的根级访问(请参见常见问题)。pygatt后端是必需的,默认情况下将从命令行使用。并确保阅读
与Python2.7和Python3.x兼容
仅与MUSE 2和MUSE 2016兼容
注意:如果您遇到任何问题,请先查看此存储库的常见问题,然后查看此存储库的问题部分 用pip安装muse lsl
在Windows 10上,我们建议使用Bluemuse图形用户界面设置LSL流。在Mac和Linux上,获取muse数据的最简单方法是直接从命令行使用muse lsl。使用 打印可用缪斯的列表: 从第一个可用的muse开始lsl流: 要连接到特定的muse,可以将设备的名称作为参数传递。设备名称可以在左听筒的内侧找到(例如muse-41d2): 你也可以直接传递你缪斯的mac地址。这提供了绕过设备发现步骤的好处,可以使连接到设备的速度更快、更可靠: 创建LSL流后,您可以访问以下命令。 注意:运行 查看数据: 如果可视化冻结或滞后,也可以尝试查看器的备用版本2。注意:这需要额外的vispy和mne依赖项。
将脑电图数据记录到csv中: 注意:此命令还将保存包含"标记"数据的任何LSL流中的数据,例如EEG笔记本中的刺激演示脚本中的数据 或者,您可以通过以下命令直接记录数据,而无需使用lsl: 注意:直接录制不允许录制"标记"数据
缪斯LSL的设计,使缪斯可以用来运行一些经典的脑电图实验,在包括p300事件相关电位和ssvep和ssaep诱发电位。
执行这些实验的代码仍然可用,但现在由neurotechx社区在eeg笔记本存储库中维护。 如果您想将muse lsl集成到您自己的python项目中,可以像导入任何python库一样导入和使用它的函数。示例可在 除了eeg,muse还提供来自加速度计、陀螺仪的数据,在muse 2的情况下,还提供了光体积描记(ppg)传感器的数据。这些数据类型可以通过命令行参数或通过将正确的参数传递给 要从命令行传输muse 2中所有传感器的数据: 作为库函数: 从备用数据源记录数据: 注意:记录过程一次只能记录一种数据类型。但是,可以使用多个终端或进程同时记录多个数据类型
实验室流媒体层(lsl)是为研究性实验统一采集时间序列数据而设计的系统。由于它能够在具有时间同步和近实时访问的网络上提供分离的数据流,它已成为基于eeg的脑-机接口领域的标准。有关更多信息,请查看此现代脑-机接口设计讲座或LSL知识库开始
安装
pip install muselsl
设置流
-h
标志可获得所有命令和选项的综合列表。$ muselsl list
$ muselsl stream
$ muselsl stream --name YOUR_DEVICE_NAME
$ muselsl stream --address YOUR_DEVICE_ADDRESS
使用流数据
stream
命令的进程必须保持活动状态才能维护lsl流。以下命令应在另一个终端或第二个进程中运行
$ muselsl view
$ muselsl view --version 2
$ muselsl record --duration 60
$ muselsl record_direct --duration 60
运行实验
用作库
examples
文件夹中找到:
0
pip install muselsl
替代数据类型
stream
函数来启用。启用后,PPG、加速计和陀螺仪数据将分别以各自独立的LSL流(称为"PPG"、"ACC"和"陀螺仪")传输。
1
pip install muselsl
2
pip install muselsl
3
pip install muselsl
什么是LSL?
常见问题
Mac和Windows
--interface
参数为BLED112设备提供适当的COM端口值。默认值为com9。要设置或查看设备的COM端口,请转到操作系统的系统设置Linux
pygatt.exceptions.bleerror:扫描时出现意外错误:设置扫描参数失败:不允许操作
(Linux)libcap
pygatt.exceptions.bleerror:未找到与273e0003-4c4d-454d-96be-f03bac821358匹配的特征
(Linux)pip install pygatt==3.1.1
pygatt.exceptions.bleerror:找不到BLE适配器
(Linux)