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

更新 MNE-Python#

如果你想将 MNE-Python 更新到更新的版本,根据你最初安装它的方式,有几种不同的选择。

提示

要通过 MNE-Python 安装器 更新,只需下载并运行适用于你所在平台的最新安装器即可。MNE-Python 将与现有安装并行安装,如果不再需要旧版本,你可以将其卸载或删除。

如果你没有使用 MNE-Python 安装器,请继续阅读。

仅升级 MNE-Python#

如果你只想更新 MNE-Python 而让其他软件包保持当前状态,通常可以安全地使用 pip 来完成,即使你最初是通过 conda 安装的。在 mne 环境处于激活状态时(conda activate name_of_environment),执行:

$ pip install -U mne

升级所有软件包#

一般来说,如果你想升级整个软件栈(包括所有依赖项),最好的做法是将其重新创建为一个新的虚拟环境,因为无论是 conda 还是 pip,都无法万无一失地确保所有软件包在升级过程中始终保持相互兼容。

下面我们将演示先重命名旧环境,以此作为一种安全措施。我们假设现有环境名为 mne,而你想重命名旧环境,以便升级后的新环境可以改叫 mne。

警告

在运行下面的命令之前,请确保你现有的 MNE conda 环境处于未激活状态。如有疑问,请运行 conda deactivate。

$ conda rename --name=mne old_mne  # rename existing "mne" env to "old_mne"

然后,只需按照我们常规的安装说明 通过 pip 或 conda 安装 进行操作即可。

注意

如果你曾在旧的 mne 环境中安装过额外的软件包,那么在重新创建更新后的环境之后,你需要重复这一安装过程。对比 conda list --name old_mne 与 conda list --name mne 的输出,就能看出新环境中缺少哪些包。在 Linux 上,你可以像下面这样自动完成这一对比:

$ diff <(conda list -n mne | cut -d " " -f 1 | sort) <(conda list -n old_mne | cut -d " " -f 1 | sort) | grep "^>" | cut -d " " -f 2

升级到开发版本#

有时会出现对你的研究很重要的新功能或错误修复,而你实在等不及 MNE-Python 的下一个正式版本发布,就想马上加以利用。在这种情况下,你可以使用 pip 安装 MNE-Python 的开发版本。请先运行 conda activate mne 激活 MNE conda 环境。

$ pip install -U --no-deps https://github.com/mne-tools/mne-python/archive/refs/heads/main.zip