企业官网建设流程全解析

简介：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 代替完整 MATLAB，GRETNA 需要交互式调用 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 Files，SPM 拼接路径时不会自动加引号，空格会被当成参数分隔符。
• 直接解压到 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.m，MATLAB 启动时自动执行。文件位置：

% 查看用户目录 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清掉临时变量，不污染工作区。这样每次启动 MATLAB，SPM 和 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确认输入目录里只有原始数据。希望帮到你。

本文还有配套的精品资源，点击获取