PLS_Toolbox 软件：安装指南与系统配置说明

概述

PLS_Toolbox 提供 Windows Installer（.exe 格式，仅支持 Windows）或压缩 ZIP 文件（所有平台）两种交付方式。安装过程分为两步：将文件复制并解压到本地文件夹，然后将这些文件添加到 MATLAB 路径中。安装时需要提供购买时获得的许可证代码。

系统要求

• PLS_Toolbox 的使用要求计算机上已安装 MATLAB。

• PLS_Toolbox 兼容该版本发布之日起 5 年内发行的 MATLAB 版本。Eigenvector 产品可在大多数现代计算机上运行。

• PLS_Toolbox 不要求其他 MATLAB 工具箱，但如果 MATLAB 中已安装 Parallel Computing Toolbox，在某些场景下会加以利用。

MATLAB 兼容性

我们尽可能保持与 MATLAB 附加工具箱的兼容性，但部分不兼容情况确实存在。多数情况源于 PLS_Toolbox 已有某函数，而 MathWorks 后续推出了同名函数且不愿意更名。

不兼容函数：

• cluster.m（Stats Toolbox）

• crossval.m（Stats Toolbox）

• regression.m（Neural Net Toolbox）

• ridge.m（Stats Toolbox）

有意的重载：

• boxplot.m（Stats Toolbox，因 DataSet 对象冲突）

兼容函数：

• dendrogram.m（Stats Toolbox）

• range.m（Stats Toolbox）

• kstest.m（Stats Toolbox）

为管理调用哪个函数，可通过调整 MATLAB 路径中 PLS_Toolbox 的位置来控制。将 PLS_Toolbox 置于路径底部将允许使用 MATLAB 原生函数，但通常会使 PLS_Toolbox 无法正常运行，直到将其移回路径顶部。

使用 Windows EXE 安装程序

1. 将 .exe 文件复制到桌面（或其他本地位置）

2. 双击图标并按照说明编辑。确认安装文件夹位置；默认路径为当前 MATLAB 安装的 toolbox 文件夹。Windows 用户可能需要选择个人 Documents 文件夹中的目录，以避免 Windows 防护机制导致的权限问题。

3. 安装完成后，会提示启动 MATLAB 并运行安装脚本。若 MATLAB 未启动，请参阅下面的手动安装步骤。

从 ZIP 文件手动安装（所有平台）

文件解压：
将 PLS_Toolbox ZIP 文件解压。建议将解压后的 PLS_Toolbox 主文件夹放入 MATLAB 安装的 userpath 文件夹中（默认位置为用户的 Documents 文件夹）。旧版 PLS_Toolbox 可能放置于 MATLAB 的 toolbox 文件夹中（例如 C:\Program Files\MATLAB\R2016a\toolbox），但不再建议此做法。

运行 evriinstall：

1. 启动 MATLAB，使用“当前文件夹”工具栏导航到 PLS_Toolbox 主文件夹。

2. 在指令行窗口输入：>> evriinstall

3. 弹出对话框后按需更改设置，点击“安装”。EVRIINSTALL 会将 PLS_Toolbox 添加到 MATLAB 路径，检查安装问题，并将结果输出到窗口。

Java 配置（旧版 MATLAB）

在包括 7.0.4（R14SP2）在内的某些旧版 MATLAB 中，需要手动将 PLS_Toolbox 附带的 jar 文件添加到 MATLAB Java 类路径中。

Solo 安装

系统要求

Solo 类产品的系统要求与构建 Solo 所使用的 MATLAB 版本对应。具体请参考发布说明中 MATLAB Runtime 版本列，然后查阅该版本 MATLAB 的系统要求。MATLAB Runtime 在安装过程中自动安装。所有 Solo 类产品均需互联网连接才能完成安装。

Windows 平台安装

安装 Solo 9.0 及更新版本：

重要系统要求：请确保计算机上已安装 Microsoft Windows Visual C++ 可再发行组件库（64位）。可从 Microsoft 官方下载。若未安装，将显示错误“无法继续执行代码，因为未找到 VCRUNTIME140.dll”。

1. 将 installer.exe 文件复制到桌面或其他本地位置

2. 双击图标并按照说明编辑

3. 在安装选项窗口中，选择安装文件夹（默认在 Program Files 的 EVRI 文件夹中），并选择是否创建桌面快捷方式

4. 在必需软件窗口中，若计算机尚未安装 MATLAB Runtime，系统将自动安装

5. 确认窗口显示 Solo 和 Runtime 的安装位置，点击“安装”

6. 完成后点击“完成”

启动 Solo：

• 导航到安装位置，进入 application 文件夹

• 若使用许可证文件（evrilicense.lic）或许可证服务器文件（evrilm.xml），将其移入 application 文件夹

• 双击 Solo 图标。初次启动时需输入许可证代码

安装 Solo 8.9.2 及更早版本：
流程类似，但需注意将许可证文件置于与安装程序 .exe 同级的文件夹中。安装完成后可选择是否立即启动 Solo，初次运行时需解压若干库文件，需等待数分钟。

macOS 平台安装

Solo 8.9.2 及更新版本：

1. 双击 Solo.dmg 磁盘映像文件挂载

2. 右键单击 Solo_WebInstaller.app，选择“打开”，输入密码

3. 按对话框说明编辑，MATLAB Runtime 将自动安装

4. 应用程序默认位于 /Applications/EigenvectorResearchInc/ 文件夹中，可将应用拖到 Dock 方便访问

Catalina 及更新版本上的旧版 Solo：
需先安装 MATLAB 2019b MCR，然后复制 Solo.app 到 Applications 文件夹。若出现“磁盘已损坏”提示，可能需要禁用 Gatekeeper。

Linux 平台安装

Solo 9.0 及更新版本：

1. 解压 Solo_WebInstaller.install 包

2. 以超级用户权限运行安装程序，默认位置为 /usr/local/bin

3. 使用提供的 shell 脚本启动：./run_Solo.sh /usr/local/MATLAB/MATLAB_Runtime/v99/

旧版安装：
解压 tar.gz 文件后，在控制台窗口中进入目标文件夹执行 ./solo。

脱机安装建议

在无互联网接入的环境中，可将以下内容保存到介质并在离线计算机上安装：

1. MATLAB 或 MCR（MATLAB Compiler Runtime）：应匹配 Solo 版本所需的 MCR 版本。

2. 将 MATLAB_Runtime .zip 文件复制到目标计算机，解压后运行 setup.exe 安装。

3. Miniconda3：Python 虚拟环境管理软件，用于启用 PLS_Toolbox 和 Solo 中的 Python 工具。

4. PLS_Toolbox：从 Eigenvector 网站账户下载。

5. Solo 系列产品：离线安装程序仅支持 Windows，需向 Eigenvector 技术支持申请。对于其他 Solo 产品，可在有网络的计算机上运行安装程序，然后将生成的安装文件夹复制到离线计算机。

验证安装

• PLS_Toolbox：运行 evridebug MATLAB 指令，应报告“未发现 PLS_Toolbox 安装问题”。

• Solo：启动后应显示浏览器窗口，可运行 PCA 等分析方法确认安装正确。

• 可通过 Help > About 菜单获取产品信息。

验证指令：

ver          % 显示已安装产品列表

path         % 显示当前 MATLAB 路径上的文件夹

evridebug    % 检查常见安装问题