HAPPE 安装指南(避坑版):一次配好,后面省很多事

前面有介绍过HAPPE，但是它毕竟是个开源软件，不是那么的开箱即用。别急，HAPPE 本身不难，难的是前期的环境和配置。这篇就按实操顺序，带你一次装好。

也算是填坑了，不过技术性的可能不会像科普那么有趣，主要会稍微精简一些。

01.

先认识一下 HAPPE 是什么

HAPPE 是一套面向原始 EEG 数据的自动化预处理流程，整合了 HAPPE 2.0、HAPPE+ER 和 HAPPILEE。

它最初主要用于处理 EGI 婴幼儿数据——这类数据通常比成人 EEG 噪声更大、伪迹更多、处理难度也更高，现在是通用的数据处理步骤，认可度还是非常高的。

PS：HAPINNES 目前尚未发布。

适合想把预处理流程标准化、自动化的团队，尤其是多被试批处理场景。

02.

安装前准备（最关键）

1）MATLAB 版本

MATLAB 2019b 或更高（千万别头铁）

注意：HAPPE 当前版本与 NetStation 4.5 不兼容，不能和运行 NetStation 4.5 的环境混用在同一台机器上。

2）MATLAB 工具箱

必须安装以下 4 个：

Signal Processing Toolbox

Optimization Toolbox

Statistics and Machine Learning Toolbox

Wavelet Toolbox

3）HAPPE 自带免费依赖（下载包已含，不需要你单独下载）

EEGLAB（建议用下载的这个，不要用自己本来的，避免版本兼容问题）

CleanLine（EEGLAB的插件）

MARA（仅旧版需要装这个）

FASTER functions

4）下载地址

GitHub: https://github.com/PINE-Lab/HAPPE

03.

正式安装步骤（按顺序来）

Step 1：下载并解压 HAPPE

把 HAPPE 放到一个固定目录（建议英文路径、不要太深层级）。

Step 2（仅 Mac）：解除 EEGLAB 隔离

如果你是 Mac 用户，这一步非常重要，不做可能直接跑不起来。

在 Terminal 执行（把 FILEPATH 换成你的实际路径）：

sudo xattr -r -d com.apple.quarantine FILEPATH/HAPPE/Packages/eeglab2022.0

再执行：

sudo find FILEPATH/HAPPE/Packages/eeglab2022.0 -name \*.mexmaci64 -exec spctl --add {} \;

执行完后重开 MATLAB。

我这里是用的Windows，所有没有试这个，如果操作有问题可以评论区发一下。

Step 3：检查 MATLAB 工具箱是否齐全

路径：主页Home → Add-Ons → Manage Add-Ons

确认这四个都在：

Signal Processing Toolbox

Optimization Toolbox

Statistics and Machine Learning Toolbox

Wavelet Toolbox

缺哪个就点 Get Add-Ons 安装（建议选择 MathWorks 官方源）。

Step 4：调大 Java Heap（防止内存报错）

路径： HOME → Preferences → General → Java Heap Memory 把默认值（常见是 768 MB）拉到最大，点击 Apply / OK 。

Step 5：设置 MATLAB 路径（Path）

路径：主页 HOME → 设置路径 Set Path

用 “Add Folder” 添加：

HAPPE

HAPPE\1. pre-process

HAPPE\2. check

HAPPE\3. generate

HAPPE\4. validate

HAPPE\packages

HAPPE\packages\eeglab2024.0（说明书还是2020）

注意一下你下载的文件夹的名字是不是HAPPE，还是HAPPE-master。

用 “Add with Subfolders” 添加：

HAPPE\scripts

HAPPE\files

最后点 Save ，再 Close 。

Step 6：配置 EEGLAB 偏好设置

在 MATLAB 命令行输入：

eeglab

2. 打开 EEGLAB 后：File → Preferences

3. 勾选高级选项、显示旧版本完整菜单

4. 关闭 EEGLAB，再打开一次 Preferences

5. 按 HAPPE 文档推荐项勾选完成后保存

04.

运行HAPPE测试

先找到HAPPEN的路径，找到第一个文件夹1.pre-process，然后找到里面的HAPPE_V4.m，然后点击运行即可。

另外一种方式是，在 MATLAB Command Window 输入： HAPPE_v4

运行后，HAPPE 会在命令窗口一步步提问（数据路径、参数选项等），你按提示填写即可。

建议第一次先拿一小批数据试跑，确认流程和参数没问题，再批量处理全体数据——这一步能帮你省掉后面很多返工时间。

05.

常见问题汇总

脚本能跑，但中途报插件/函数缺失通常是 Path 没加全，尤其是 packages 、 scripts 、 files 。或者是用了自己的eeglab包，里面的版本和插件不全。
Mac 提示文件不可执行或权限问题大概率是没做 quarantine 解除（Step 2）。
运行到一半内存相关报错先确认 Java Heap 已调高，再看 MATLAB 可用内存。
EEGLAB 菜单项和教程不一致

先去 Preferences 打开“显示完整菜单/旧版菜单项”。