通过 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 的(未来)贡献者提供了额外的安装说明(例如运行测试和构建文档所需的额外依赖)。