安装 ASE

总结：根据 python 版本选择 ase 版本。python3 及以上最新即可。python2 选 3.17.0 及以下。学校集群由于其他依赖包版本低，需要装 3.9.1。

Requirements

最新版本的 ase 需要的环境条件 ^[1]：

• Python 3.6 or newer
• NumPy 1.11 or newer (base N-dimensional array package)
• SciPy 0.18 or newer (library for scientific computing)

Optional but strongly recommended:

• Matplotlib 2.0.0 or newer for plotting
• tkinter for ase.gui

Optional:

• Flask for ase.db web-interface
• pytest 3.6.1 or newer for running tests
• pytest-xdist 1.22.1 or newer for running tests in parallel
• spglib for certain symmetry-related features

Windows

1.安装并配置 Python 环境

python38 即可，Python for Windows。

注意版本，不要下载未正式发布的版本，否则可能出现 找不到指定文件 报错。

2. 安装 ASE

打开命令行/终端，输入以下命令的任意一个，即可安装 ASE。两行作用一致，但第二行配置了从清华大学镜像源下载安装，因此大陆网络使用第二行更快 ^[2]。

pip install --upgrade --user ase
pip install ase -i https://pypi.tuna.tsinghua.edu.cn/simple

注意，是在命令行直接启动 pip，不是在命令行中运行 Python 后再 pip，否则你会收到如下报错：

PS C:\Users\northword> python
Python 3.10.4 (tags/v3.10.4:9d38120, Mar 23 2022, 23:13:41) [MSC v.1929 64 bit (AMD64)] on win32
Type "help", "copyright", "credits" or "license" for more information.
>>> pip install ase
  File "<stdin>", line 1
    pip install ase
        ^^^^^^^
SyntaxError: invalid syntax
>>>

3. 检查是否安装正确

PS C:\Users\northword> ase --version
ase-3.22.1
PS C:\Users\northword>

返回以上结果既为正确。

如不正确，例如如下报错，则请进入下一步添加环境变量。

PS C:\Users\northword> ase
ase : 无法将“ase”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。请检查名称的拼写，如果包括路径，请确保路径正确
，然后再试一次。
所在位置 行:1 字符: 1
+ ase
+ ~~~~
    + CategoryInfo          : ObjectNotFound: (ase1:String) [], CommandNotFoundException
    + FullyQualifiedErrorId : CommandNotFoundException

PS C:\Users\northword>

4. 添加环境变量

将以下添加到PATH
%AppData%\Roaming\Python\Python38\Scripts

该变量可能不一样，需要自行确定

Linux

需要注意的是，支持 Python2 的 ase 最高版本是 3.17.0 ^[3]。学校的集群是 python2.7，需要

pip install --user ase==3.17.0

该版本要求 numpy-1.9.0，而学校配置的 1.7.1，需要

pip install --user numpy==1.9.0

经测试会报错，没找到原因，把 ase 降级到 3.9.1，正常运行。

pip install --user ase==3.9.1

或：下载：https://files.pythonhosted.org/packages/c1/32/c7a102936e877b43a90e3242c95a719c2056fd3184b33767948c16defd22/ase-3.9.1.tar.gz，上传，解压缩，pip install --user ase-3.9.1/setup.py(绝对路径)。

与新版本不同，此时必须通过 ase-gui，而新版本可以 ase gui，因为旧版本 /home/2020223055092/.local/bin/ 下没有 ase.

---

在 Windows 10 20H2 版本上，ASE 可能报错，可能是由于 numpy 与 Windows 20H2 不兼容导致，参考 03.numpy-in-win20H2。

---

1. https://wiki.fysik.dtu.dk/ase/install.html#installation-using-pip ↩︎

2. 由于 Python Pip 默认源服务器在境外，速度较慢，故须换为国内镜像源或配置科学上网。第二行安装命令已配置为清华大学镜像源。详细参考 pip 换源。 ↩︎

3. https://pypi.org/project/ase/3.17.0/ ↩︎