简介GRETNA 2.0.0 Release 是北京师范大学研发、面向 MATLAB 环境的脑成像与脑电分析插件主要服务于神经科学研究者及具备一定 MATLAB 编程基础的研究生。它针对 EEG、MEG 数据设计集成滤波去噪、源定位、功率谱分析、相干性分析与独立成分分析等算法可处理 VEP、AEP、ERP 等实验范式帮助用户从脑电信号中挖掘大脑网络的动态变化与连接模式。资源包共 845 个文件约 27.51MB以 387 个 m 脚本、51 个 hpp 与 24 个 c 源码、41 个 mat 数据、多种平台 mex 二进制文件及 nii 影像、png 图示为主兼顾源码编译与跨平台运行。目前已有 524 人学习下载。借助官方文档与批量处理脚本读者可快速完成安装配置、数据导入导出与结果可视化将复杂的大数据分析流程简化更专注于科学问题本身。1. 从一次 MATLAB 版本错配说起GRETNA-2.0.0 到底该怎么装有个做脑网络分析的 A 同学兴冲冲把 GRETNA-2.0.0_release.zip 解压到 MATLAB 的 toolbox 目录重启后敲gretna结果命令行只回了一行红字未定义函数或变量。他以为是压缩包坏了重新下载了三遍最后发现是 MATLAB 版本太新GRETNA 2.0.0 依赖的 SPM 老接口在新版里被移除了。这个坑我见过太多次——GRETNA 是北师大团队开发的静息态脑网络分析工具箱国内做功能磁共振的实验室几乎人手一份但它的安装门槛不在“下载”而在“版本对齐”和“路径配置”。装不好轻则函数找不到重则跑一半报矩阵维度错误数据白跑。这篇笔记面向两类人第一次装 GRETNA 的新手以及换了 MATLAB 版本后想重新部署的老手。我会把版本选择、解压路径、SPM 依赖、路径设置、验证跑通整条链路拆开讲每一步都给出可复现的命令和参数说明。2. 装前准备MATLAB 版本、SPM 与解压路径的取舍2.1 MATLAB 版本怎么选别追新追兼容GRETNA-2.0.0 是 2018 年前后发布的 release官方文档里明确测试过的 MATLAB 版本是 R2013b 到 R2017a。这不是说 R2020 以后完全不能用而是部分函数尤其是 SPM 的旧接口和spm_vol系列在新版里行为变了。我一般会这样处理如果实验室有正版授权且不强制升级优先用 R2016b 或 R2017a这两个版本对 GRETNA 2.0.0 的兼容性最稳。如果只能用 R2020a 及以上先装 SPM12 的最新版再把 GRETNA 的路径放在 SPM 之后让新版 SPM 覆盖旧接口。绝对不要用 MATLAB Runtime 代替完整 MATLABGRETNA 需要交互式调用 SPM 的图形接口Runtime 跑不起来。查看当前 MATLAB 版本在命令行敲version输出里会带版本号和 release 名称比如9.2.0.556344 (R2017a)。记下这个号后面配 SPM 时要对照。2.2 SPM 依赖GRETNA 不自带必须单独装GRETNA 本身不包含 SPM但它的预处理模块头动校正、配准、标准化全部调用 SPM 的函数。所以安装顺序是先装 SPM再装 GRETNA。SPM12 的获取方式这里不展开假设你已经拿到spm12.zip。解压到一个没有中文、没有空格的路径比如D:\tools\spm12。然后在 MATLAB 里把 SPM 加入路径addpath(D:\tools\spm12); savepath;addpath把 SPM 目录加到搜索路径最前面savepath把当前路径状态写进pathdef.m下次启动 MATLAB 自动生效。注意不要用addpath(genpath(...))把 SPM 所有子目录都加进去SPM 的external子目录里有大量第三方工具全加会拖慢启动速度还可能和 GRETNA 的函数名冲突。只加顶层目录即可。验证 SPM 是否可用spm(Ver)正常会返回SPM12和版本号。如果报错检查路径里有没有中文或者 SPM 是否解压完整。2.3 解压路径三个不能碰的雷区GRETNA-2.0.0_release.zip 解压后是一个名为GRETNA-2.0.0_release的文件夹里面包含gretna.m、gretna_*.m函数文件和一个GUI子目录。解压路径有三个雷区路径含中文MATLAB 对中文路径的支持时好时坏尤其是 SPM 的spm_vol读文件时中文路径直接报错。我一般放在D:\tools\GRETNA-2.0.0。路径含空格比如Program FilesSPM 拼接路径时不会自动加引号空格会被当成参数分隔符。直接解压到 MATLAB 的toolbox目录看似方便实则容易和 MATLAB 自带函数冲突而且升级 MATLAB 时会被覆盖。解压后确认目录结构# 在 Windows 资源管理器地址栏敲 cmd 后执行 dir D:\tools\GRETNA-2.0.0应该看到gretna.m、gretna_*.m、GUI、Utilities等条目。如果只有一层压缩包套压缩包说明解压不完整重新解压。3. 安装与路径配置把 GRETNA 挂进 MATLAB 搜索路径3.1 手动添加路径addpath 与 savepath 的正确顺序假设 GRETNA 解压在D:\tools\GRETNA-2.0.0在 MATLAB 命令行执行% 添加 GRETNA 顶层目录及其所有子目录 addpath(genpath(D:\tools\GRETNA-2.0.0)); % 把 GRETNA 路径移到搜索路径最前面避免被同名函数覆盖 addpath(D:\tools\GRETNA-2.0.0, -begin); % 保存路径下次启动自动加载 savepath;这里genpath会递归添加所有子目录因为 GRETNA 的Utilities和GUI子目录里有大量辅助函数不全部加进去调用时会报“未定义函数”。-begin参数把 GRETNA 路径插到最前面优先级最高。savepath写入pathdef.m但注意如果你没有管理员权限savepath可能失败这时需要手动把路径写进startup.m。验证路径是否加成功which gretna正常返回D:\tools\GRETNA-2.0.0\gretna.m。如果返回空或者指向别的目录说明路径没加对。3.2 用 startup.m 固化路径适合多版本切换实验室机器经常要切换 MATLAB 版本每次手动addpath太麻烦。我一般会在用户目录下建一个startup.mMATLAB 启动时自动执行。文件位置% 查看用户目录 userpath返回类似C:\Users\YourName\Documents\MATLAB。在这个目录下新建startup.m写入% startup.m 自动配置 GRETNA 和 SPM 路径 spm_path D:\tools\spm12; gretna_path D:\tools\GRETNA-2.0.0; if exist(spm_path, dir) addpath(spm_path); end if exist(gretna_path, dir) addpath(genpath(gretna_path)); addpath(gretna_path, -begin); end clear spm_path gretna_path;exist(..., dir)先判断目录是否存在避免换机器后路径失效导致报错。clear清掉临时变量不污染工作区。这样每次启动 MATLABSPM 和 GRETNA 自动就位。3.3 路径冲突排查同名函数谁优先GRETNA 和 SPM 都有spm_vol的封装如果路径顺序不对调用spm_vol时可能走到 GRETNA 的版本导致参数不兼容。排查方法which spm_vol -all会列出所有同名函数的路径按搜索顺序排列。第一个就是实际调用的。如果 GRETNA 的spm_vol排在 SPM 前面把 SPM 路径用addpath(..., -begin)提到最前。我一般会确保 SPM 路径在 GRETNA 之前因为 GRETNA 的预处理依赖 SPM 的底层实现。4. 避坑与常见问题装完跑不起来怎么救4.1 现象敲 gretna 报“未定义函数或变量”原因路径没加成功或者savepath没生效。先which gretna确认路径如果为空重新执行addpath(genpath(...))。如果which有返回但敲gretna还是报错检查函数名大小写——MATLAB 在 Windows 上不区分大小写但在 Linux 上区分GRETNA 的函数文件都是小写调用时保持一致。解决在命令行逐条执行addpath和savepath观察有没有报错。如果savepath报权限错误改用startup.m方案。4.2 现象SPM 能启动但 GRETNA 预处理报“spm_vol 参数不足”原因MATLAB 版本太新SPM12 的spm_vol接口变了而 GRETNA 2.0.0 调用的是旧版签名。常见于 R2020a 及以上。解决两个方案。一是降级 MATLAB 到 R2017a二是升级 SPM 到最新版并在 GRETNA 路径之前加载 SPM。如果还不行找到 GRETNA 里调用spm_vol的那一行手动补上缺失的参数。这个改动有风险建议先备份原文件。4.3 现象GUI 界面打开后按钮点不动或者报“Java 异常”原因MATLAB 的 Java 版本和 GRETNA 的 GUI 编译版本不匹配。GRETNA 2.0.0 的 GUI 是用旧版 MATLAB 的 GUIDE 做的新版 MATLAB 的 Java 运行时改了。解决在启动 MATLAB 时加-nojvm参数可以绕过 Java但 GUI 就用不了。如果必须用 GUI换 R2017a。或者直接用命令行函数gretna_*GRETNA 的大部分功能都有对应的命令行接口不依赖 Java。4.4 现象跑完预处理结果目录是空的原因输出路径含中文或空格SPM 写文件时静默失败。GRETNA 的日志里可能只有一行 warning不仔细看会漏掉。解决把所有输入输出路径改成纯英文、无空格比如D:\data\sub01。跑之前用dir确认输出目录存在且可写。我一般会在脚本开头加一句assert(~isempty(dir(output_dir)), 输出目录不存在)提前拦截。4.5 现象换了一台机器路径全失效原因pathdef.m和startup.m是机器相关的换机器后路径不存在。解决把startup.m里的路径改成相对路径或者用环境变量。比如gretna_path getenv(GRETNA_PATH); if isempty(gretna_path) gretna_path D:\tools\GRETNA-2.0.0; end这样在每台机器上设置GRETNA_PATH环境变量即可不用改脚本。5. 验证跑通用自带 Demo 数据走一遍完整流程装完不验证等于没装。GRETNA 的GUI目录下通常带一个Demo文件夹里面有示例数据。我一般会跑一遍最小流程加载数据、做头动校正、看输出。5.1 准备 Demo 数据假设 Demo 数据在D:\tools\GRETNA-2.0.0\GUI\Demo里面有一个sub01文件夹和若干.nii文件。在 MATLAB 里确认demo_dir D:\tools\GRETNA-2.0.0\GUI\Demo; dir(demo_dir)应该看到sub01和README之类的文件。如果没有 Demo用自己的一例静息态数据确保是.nii格式且已经做过格式转换。5.2 命令行调用预处理函数GRETNA 2.0.0 的预处理入口函数是gretna_preprocessing参数用键值对传。最小调用% 输入输出路径 input_dir D:\tools\GRETNA-2.0.0\GUI\Demo\sub01; output_dir D:\data\gretna_test; % 创建输出目录 if ~exist(output_dir, dir) mkdir(output_dir); end % 调用预处理只做头动校正和标准化 gretna_preprocessing(... InputDir, input_dir, ... OutputDir, output_dir, ... IsRealign, 1, ... IsNormalize, 1, ... IsSmooth, 0, ... TR, 2.0);参数说明InputDir是原始数据目录OutputDir是结果目录IsRealign为 1 表示做头动校正IsNormalize为 1 表示做空间标准化IsSmooth为 0 表示跳过平滑先验证流程平滑耗时TR是重复时间单位秒根据实际扫描参数填。这个调用会生成realign和normalize子目录里面是处理后的.nii文件。5.3 检查输出三个必须看的文件跑完后进output_dir看dir(fullfile(output_dir, realign)) dir(fullfile(output_dir, normalize))realign目录下应该有rp_*.txt头动参数和*.nii校正后图像。normalize目录下应该有w*.nii标准化后图像。如果目录为空回看第 4.4 节的路径问题。头动参数文件rp_*.txt有 6 列分别对应三个平移和三个旋转正常值在 ±1 以内超过 ±3 说明头动太大这例数据要慎用。5.4 一个我常犯的错有一次我图省事把output_dir设成和input_dir同一层结果 GRETNA 递归扫描输入目录时把输出目录也扫进去了导致重复处理跑了一晚上还没完。从那以后我每次跑预处理都强制把输出目录放在输入目录的上一级之外并且跑之前用dir确认输入目录里只有原始数据。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/23 17:45:54 · 阅读 1.2k GRETNA-2.0.0安装避坑指南：MATLAB版本兼容与SPM路径配置详解
简介GRETNA 2.0.0 Release 是北京师范大学研发、面向 MATLAB 环境的脑成像与脑电分析插件主要服务于神经科学研究者及具备一定 MATLAB 编程基础的研究生。它针对 EEG、MEG 数据设计集成滤波去噪、源定位、功率谱分析、相干性分析与独立成分分析等算法可处理 VEP、AEP、ERP 等实验范式帮助用户从脑电信号中挖掘大脑网络的动态变化与连接模式。资源包共 845 个文件约 27.51MB以 387 个 m 脚本、51 个 hpp 与 24 个 c 源码、41 个 mat 数据、多种平台 mex 二进制文件及 nii 影像、png 图示为主兼顾源码编译与跨平台运行。目前已有 524 人学习下载。借助官方文档与批量处理脚本读者可快速完成安装配置、数据导入导出与结果可视化将复杂的大数据分析流程简化更专注于科学问题本身。1. 从一次 MATLAB 版本错配说起GRETNA-2.0.0 到底该怎么装有个做脑网络分析的 A 同学兴冲冲把 GRETNA-2.0.0_release.zip 解压到 MATLAB 的 toolbox 目录重启后敲gretna结果命令行只回了一行红字未定义函数或变量。他以为是压缩包坏了重新下载了三遍最后发现是 MATLAB 版本太新GRETNA 2.0.0 依赖的 SPM 老接口在新版里被移除了。这个坑我见过太多次——GRETNA 是北师大团队开发的静息态脑网络分析工具箱国内做功能磁共振的实验室几乎人手一份但它的安装门槛不在“下载”而在“版本对齐”和“路径配置”。装不好轻则函数找不到重则跑一半报矩阵维度错误数据白跑。这篇笔记面向两类人第一次装 GRETNA 的新手以及换了 MATLAB 版本后想重新部署的老手。我会把版本选择、解压路径、SPM 依赖、路径设置、验证跑通整条链路拆开讲每一步都给出可复现的命令和参数说明。2. 装前准备MATLAB 版本、SPM 与解压路径的取舍2.1 MATLAB 版本怎么选别追新追兼容GRETNA-2.0.0 是 2018 年前后发布的 release官方文档里明确测试过的 MATLAB 版本是 R2013b 到 R2017a。这不是说 R2020 以后完全不能用而是部分函数尤其是 SPM 的旧接口和spm_vol系列在新版里行为变了。我一般会这样处理如果实验室有正版授权且不强制升级优先用 R2016b 或 R2017a这两个版本对 GRETNA 2.0.0 的兼容性最稳。如果只能用 R2020a 及以上先装 SPM12 的最新版再把 GRETNA 的路径放在 SPM 之后让新版 SPM 覆盖旧接口。绝对不要用 MATLAB Runtime 代替完整 MATLABGRETNA 需要交互式调用 SPM 的图形接口Runtime 跑不起来。查看当前 MATLAB 版本在命令行敲version输出里会带版本号和 release 名称比如9.2.0.556344 (R2017a)。记下这个号后面配 SPM 时要对照。2.2 SPM 依赖GRETNA 不自带必须单独装GRETNA 本身不包含 SPM但它的预处理模块头动校正、配准、标准化全部调用 SPM 的函数。所以安装顺序是先装 SPM再装 GRETNA。SPM12 的获取方式这里不展开假设你已经拿到spm12.zip。解压到一个没有中文、没有空格的路径比如D:\tools\spm12。然后在 MATLAB 里把 SPM 加入路径addpath(D:\tools\spm12); savepath;addpath把 SPM 目录加到搜索路径最前面savepath把当前路径状态写进pathdef.m下次启动 MATLAB 自动生效。注意不要用addpath(genpath(...))把 SPM 所有子目录都加进去SPM 的external子目录里有大量第三方工具全加会拖慢启动速度还可能和 GRETNA 的函数名冲突。只加顶层目录即可。验证 SPM 是否可用spm(Ver)正常会返回SPM12和版本号。如果报错检查路径里有没有中文或者 SPM 是否解压完整。2.3 解压路径三个不能碰的雷区GRETNA-2.0.0_release.zip 解压后是一个名为GRETNA-2.0.0_release的文件夹里面包含gretna.m、gretna_*.m函数文件和一个GUI子目录。解压路径有三个雷区路径含中文MATLAB 对中文路径的支持时好时坏尤其是 SPM 的spm_vol读文件时中文路径直接报错。我一般放在D:\tools\GRETNA-2.0.0。路径含空格比如Program FilesSPM 拼接路径时不会自动加引号空格会被当成参数分隔符。直接解压到 MATLAB 的toolbox目录看似方便实则容易和 MATLAB 自带函数冲突而且升级 MATLAB 时会被覆盖。解压后确认目录结构# 在 Windows 资源管理器地址栏敲 cmd 后执行 dir D:\tools\GRETNA-2.0.0应该看到gretna.m、gretna_*.m、GUI、Utilities等条目。如果只有一层压缩包套压缩包说明解压不完整重新解压。3. 安装与路径配置把 GRETNA 挂进 MATLAB 搜索路径3.1 手动添加路径addpath 与 savepath 的正确顺序假设 GRETNA 解压在D:\tools\GRETNA-2.0.0在 MATLAB 命令行执行% 添加 GRETNA 顶层目录及其所有子目录 addpath(genpath(D:\tools\GRETNA-2.0.0)); % 把 GRETNA 路径移到搜索路径最前面避免被同名函数覆盖 addpath(D:\tools\GRETNA-2.0.0, -begin); % 保存路径下次启动自动加载 savepath;这里genpath会递归添加所有子目录因为 GRETNA 的Utilities和GUI子目录里有大量辅助函数不全部加进去调用时会报“未定义函数”。-begin参数把 GRETNA 路径插到最前面优先级最高。savepath写入pathdef.m但注意如果你没有管理员权限savepath可能失败这时需要手动把路径写进startup.m。验证路径是否加成功which gretna正常返回D:\tools\GRETNA-2.0.0\gretna.m。如果返回空或者指向别的目录说明路径没加对。3.2 用 startup.m 固化路径适合多版本切换实验室机器经常要切换 MATLAB 版本每次手动addpath太麻烦。我一般会在用户目录下建一个startup.mMATLAB 启动时自动执行。文件位置% 查看用户目录 userpath返回类似C:\Users\YourName\Documents\MATLAB。在这个目录下新建startup.m写入% startup.m 自动配置 GRETNA 和 SPM 路径 spm_path D:\tools\spm12; gretna_path D:\tools\GRETNA-2.0.0; if exist(spm_path, dir) addpath(spm_path); end if exist(gretna_path, dir) addpath(genpath(gretna_path)); addpath(gretna_path, -begin); end clear spm_path gretna_path;exist(..., dir)先判断目录是否存在避免换机器后路径失效导致报错。clear清掉临时变量不污染工作区。这样每次启动 MATLABSPM 和 GRETNA 自动就位。3.3 路径冲突排查同名函数谁优先GRETNA 和 SPM 都有spm_vol的封装如果路径顺序不对调用spm_vol时可能走到 GRETNA 的版本导致参数不兼容。排查方法which spm_vol -all会列出所有同名函数的路径按搜索顺序排列。第一个就是实际调用的。如果 GRETNA 的spm_vol排在 SPM 前面把 SPM 路径用addpath(..., -begin)提到最前。我一般会确保 SPM 路径在 GRETNA 之前因为 GRETNA 的预处理依赖 SPM 的底层实现。4. 避坑与常见问题装完跑不起来怎么救4.1 现象敲 gretna 报“未定义函数或变量”原因路径没加成功或者savepath没生效。先which gretna确认路径如果为空重新执行addpath(genpath(...))。如果which有返回但敲gretna还是报错检查函数名大小写——MATLAB 在 Windows 上不区分大小写但在 Linux 上区分GRETNA 的函数文件都是小写调用时保持一致。解决在命令行逐条执行addpath和savepath观察有没有报错。如果savepath报权限错误改用startup.m方案。4.2 现象SPM 能启动但 GRETNA 预处理报“spm_vol 参数不足”原因MATLAB 版本太新SPM12 的spm_vol接口变了而 GRETNA 2.0.0 调用的是旧版签名。常见于 R2020a 及以上。解决两个方案。一是降级 MATLAB 到 R2017a二是升级 SPM 到最新版并在 GRETNA 路径之前加载 SPM。如果还不行找到 GRETNA 里调用spm_vol的那一行手动补上缺失的参数。这个改动有风险建议先备份原文件。4.3 现象GUI 界面打开后按钮点不动或者报“Java 异常”原因MATLAB 的 Java 版本和 GRETNA 的 GUI 编译版本不匹配。GRETNA 2.0.0 的 GUI 是用旧版 MATLAB 的 GUIDE 做的新版 MATLAB 的 Java 运行时改了。解决在启动 MATLAB 时加-nojvm参数可以绕过 Java但 GUI 就用不了。如果必须用 GUI换 R2017a。或者直接用命令行函数gretna_*GRETNA 的大部分功能都有对应的命令行接口不依赖 Java。4.4 现象跑完预处理结果目录是空的原因输出路径含中文或空格SPM 写文件时静默失败。GRETNA 的日志里可能只有一行 warning不仔细看会漏掉。解决把所有输入输出路径改成纯英文、无空格比如D:\data\sub01。跑之前用dir确认输出目录存在且可写。我一般会在脚本开头加一句assert(~isempty(dir(output_dir)), 输出目录不存在)提前拦截。4.5 现象换了一台机器路径全失效原因pathdef.m和startup.m是机器相关的换机器后路径不存在。解决把startup.m里的路径改成相对路径或者用环境变量。比如gretna_path getenv(GRETNA_PATH); if isempty(gretna_path) gretna_path D:\tools\GRETNA-2.0.0; end这样在每台机器上设置GRETNA_PATH环境变量即可不用改脚本。5. 验证跑通用自带 Demo 数据走一遍完整流程装完不验证等于没装。GRETNA 的GUI目录下通常带一个Demo文件夹里面有示例数据。我一般会跑一遍最小流程加载数据、做头动校正、看输出。5.1 准备 Demo 数据假设 Demo 数据在D:\tools\GRETNA-2.0.0\GUI\Demo里面有一个sub01文件夹和若干.nii文件。在 MATLAB 里确认demo_dir D:\tools\GRETNA-2.0.0\GUI\Demo; dir(demo_dir)应该看到sub01和README之类的文件。如果没有 Demo用自己的一例静息态数据确保是.nii格式且已经做过格式转换。5.2 命令行调用预处理函数GRETNA 2.0.0 的预处理入口函数是gretna_preprocessing参数用键值对传。最小调用% 输入输出路径 input_dir D:\tools\GRETNA-2.0.0\GUI\Demo\sub01; output_dir D:\data\gretna_test; % 创建输出目录 if ~exist(output_dir, dir) mkdir(output_dir); end % 调用预处理只做头动校正和标准化 gretna_preprocessing(... InputDir, input_dir, ... OutputDir, output_dir, ... IsRealign, 1, ... IsNormalize, 1, ... IsSmooth, 0, ... TR, 2.0);参数说明InputDir是原始数据目录OutputDir是结果目录IsRealign为 1 表示做头动校正IsNormalize为 1 表示做空间标准化IsSmooth为 0 表示跳过平滑先验证流程平滑耗时TR是重复时间单位秒根据实际扫描参数填。这个调用会生成realign和normalize子目录里面是处理后的.nii文件。5.3 检查输出三个必须看的文件跑完后进output_dir看dir(fullfile(output_dir, realign)) dir(fullfile(output_dir, normalize))realign目录下应该有rp_*.txt头动参数和*.nii校正后图像。normalize目录下应该有w*.nii标准化后图像。如果目录为空回看第 4.4 节的路径问题。头动参数文件rp_*.txt有 6 列分别对应三个平移和三个旋转正常值在 ±1 以内超过 ±3 说明头动太大这例数据要慎用。5.4 一个我常犯的错有一次我图省事把output_dir设成和input_dir同一层结果 GRETNA 递归扫描输入目录时把输出目录也扫进去了导致重复处理跑了一晚上还没完。从那以后我每次跑预处理都强制把输出目录放在输入目录的上一级之外并且跑之前用dir确认输入目录里只有原始数据。希望帮到你。本文还有配套的精品资源点击获取