emoPAD Universe
Cross-Platform Support
emoPAD Universe supports the following operating systems:
| OS | Image Viewer | Notes |
|---|
| Linux | eog (Eye of GNOME) | Window mode, closable |
| Windows |
System default image viewer | Window mode, closable |
Auto-Start
After installing this skill, the following operations will be performed automatically:
- 1. Check and install required Python dependencies
- Start emoPAD service (listening on http://127.0.0.1:8766)
- Start emoNebula auto-report (popup window displaying emotion nebula chart every 5 minutes)
No manual start needed, ready to use after installation.
Tools
emopad_status
Get current emotion PAD status and sensor connection status
Description: Returns values for three dimensions: Pleasure, Arousal, Dominance, and connection status of EEG, PPG, GSR sensors
Parameters: None
Returns: Formatted emotion status text, including sensor connection status
emopad_snapshot
Generate current emotion nebula chart
Description: Generate 3D PAD cube visualization screenshot
Parameters: None
Returns:
- - Status message
- PNG image data
emopadstartnebula
Start emoNebula auto-report
Description: Automatically generate and display emotion nebula chart in popup window every 5 minutes. Requires at least 2 sensors connected to display image, otherwise shows data missing reminder.
Parameters: None
Returns: Status message
emopadstopnebula
Stop emoNebula auto-report
Description: Stop automatically displaying emotion nebula chart
Parameters: None
Returns: Status message
Configuration
CODEBLOCK0
Dependencies
- - mne
- heartpy
- neurokit2
- bleak
- pyvista
- pyserial
- scipy
- numpy
- PyWavelets
- fastapi
- uvicorn
- pillow
- requests
- pyyaml
Hardware Support
Currently Supported Devices
| Type | Model | Connection |
|---|
| EEG | KSEEG102 | Bluetooth BLE |
| PPG |
Cheez PPG Sensor | Serial |
| GSR | Sichiray GSR V2 | Serial |
Future Planned Support
- - Muse series EEG devices
- Emotiv EEG devices
- Oura Ring smart ring
- Whoop smart wristband
- Other mainstream EEG devices and wearable devices
About Emotion PAD Calculation
Important Note: Currently, emotion PAD calculation is based on heuristic methods, mapping relationships summarized from extensive literature.
Characteristics of this method:
- - ✅ Based on statistical patterns from scientific literature
- ✅ Suitable for emotion recognition in general population
- ⚠️ Temporarily cannot reflect individual differences
Future Improvements: Will introduce personalized calibration training modules in new versions, through user-specific data training, to achieve true personalized emotion recognition.
emoPAD Universe
跨平台支持
emoPAD Universe 支持以下操作系统:
| 操作系统 | 图像查看器 | 备注 |
|---|
| Linux | eog(GNOME 之眼) | 窗口模式,可关闭 |
| Windows |
系统默认图像查看器 | 窗口模式,可关闭 |
自动启动
安装此技能后,将自动执行以下操作:
- 1. 检查并安装所需的 Python 依赖项
- 启动 emoPAD 服务(监听于 http://127.0.0.1:8766)
- 启动 emoNebula 自动报告(每 5 分钟弹出窗口显示情绪星云图)
无需手动启动,安装后即可使用。
工具
emopad_status
获取当前情绪 PAD 状态及传感器连接状态
描述:返回愉悦度、唤醒度、支配度三个维度的数值,以及脑电、PPG、GSR 传感器的连接状态
参数:无
返回:格式化的情绪状态文本,包含传感器连接状态
emopad_snapshot
生成当前情绪星云图
描述:生成 3D PAD 立方体可视化截图
参数:无
返回:
emopadstartnebula
启动 emoNebula 自动报告
描述:每 5 分钟自动生成并在弹出窗口中显示情绪星云图。需要至少连接 2 个传感器才能显示图像,否则显示数据缺失提醒。
参数:无
返回:状态消息
emopadstopnebula
停止 emoNebula 自动报告
描述:停止自动显示情绪星云图
参数:无
返回:状态消息
配置
yaml
serial_port: /dev/ttyACM0 # 串口设备路径(Linux)
serial_port: COM3 # 串口设备路径(Windows)
baudrate: 115200 # 串口波特率
eeg
windowsec: 2 # 脑电数据窗口(秒)
ppg
gsrwindow_sec: 60 # PPG/GSR 数据窗口(秒)
hop_sec: 2 # 计算间隔(秒)
history_length: 120 # 历史数据点数量
nebula_interval: 300 # 发送间隔(秒)
service_host: 127.0.0.1 # 服务监听地址
service_port: 8766 # 服务监听端口
依赖项
- - mne
- heartpy
- neurokit2
- bleak
- pyvista
- pyserial
- scipy
- numpy
- PyWavelets
- fastapi
- uvicorn
- pillow
- requests
- pyyaml
硬件支持
当前支持的设备
| 类型 | 型号 | 连接方式 |
|---|
| 脑电 | KSEEG102 | 蓝牙 BLE |
| PPG |
Cheez PPG 传感器 | 串口 |
| GSR | Sichiray GSR V2 | 串口 |
未来计划支持
- - Muse 系列脑电设备
- Emotiv 脑电设备
- Oura Ring 智能戒指
- Whoop 智能腕带
- 其他主流脑电设备及可穿戴设备
关于情绪 PAD 计算
重要说明:当前情绪 PAD 计算基于启发式方法,映射关系来源于大量文献总结。
该方法的特点:
- - ✅ 基于科学文献中的统计规律
- ✅ 适用于一般人群的情绪识别
- ⚠️ 暂时无法反映个体差异
未来改进:将在新版本中引入个性化校准训练模块,通过用户特定数据训练,实现真正的个性化情绪识别。