非官方中文翻译 本页译自 MNE-Python 官方文档: 查看英文原文 ↗。 文档版权归 MNE Developers 所有(BSD-3-Clause)。

通过 pip 或 conda 安装#

提示

如果你不熟悉 Python,我们建议改用我们的 MNE-Python 安装器。

MNE-Python 要求 Python 3.11 或更高版本。如果在安装 Python 方面需要帮助,请参阅我们的《安装 Python》指南。

安装包含全部依赖的 MNE-Python#

如果你使用 Anaconda,建议将 MNE-Python 安装到独立的 conda 环境中。

首先,请确保你使用的是较新版本的 conda。在终端中运行:

$ conda update --name=base conda  # update conda
$ conda --version

已安装的 conda 版本应为 23.10.0 或更新版本。

现在,你可以安装 MNE-Python:

$ conda create --channel=conda-forge --strict-channel-priority --name=mne mne

这将创建一个名为 mne 的新 conda 环境(可通过 --name 传入其他名称来自定义),并将全部依赖安装到其中。

如果你需要将结构 MRI 扫描转换为头皮、内颅骨/外颅骨以及皮层表面模型,还需要安装 FreeSurfer。

安装仅含核心依赖的 MNE-Python#

如果你只需要 MNE-Python 的核心功能(包括二维绘图,但不支持三维可视化),可通过 pip 安装:

$ pip install mne

或者通过 conda 安装:

$ conda create --channel=conda-forge --strict-channel-priority --name=mne mne-base

这将创建一个名为 mne 的新 conda 环境(可通过 --name 传入其他名称来自定义)。

这种最小化安装仅需少量依赖。如果后续需要额外功能,可以按需单独安装相应的包。

安装支持 HDF5 的 MNE-Python#

如果你计划使用 MNE-Python 中需要 HDF5 I/O 的函数(包括 mne.io.read_raw_eeglab()、mne.SourceMorph.save() 等),应通过 pip 安装:

$ pip install "mne[hdf5]"

或者通过 conda 安装:

$ conda create --override-channels --channel=conda-forge --name=mne mne-base h5io h5py pymatreader

这将创建一个名为 mne 的新 conda 环境(可通过 --name 传入其他名称来自定义)。

如果你已安装仅含核心依赖的 MNE-Python(例如通过 pip install mne),可以安装以下两个包以启用 HDF5 支持:

$ pip install h5io pymatreader

其他场景下的 MNE-Python 安装#

“高级设置”页面提供了针对特殊场景(服务器、notebook、CUDA、安装开发版本等)的更多技巧与提示。“贡献指南”则为 MNE-Python 的(未来)贡献者提供了额外的安装说明(例如运行测试和构建文档所需的额外依赖)。