第一性原理计算 / Quantum ESPRESSO

用 Quantum ESPRESSO 计算能带

本页以单层 MoS2 为例,从输入文件做到能带图和带隙判定,包括收敛测试、态密度和自旋轨道耦合(SOC)。每一步都给出实际运行的输入和输出数字,输入文件可以下载后直接运行。

本页数字来自一次在 Scientify 云电脑 2 核 CPU 上完成的 QE 7.5 计算,用时 6 小时 18 分,未租用外部算力。 查看运行记录

直接答案

用 Quantum ESPRESSO(QE)计算能带分三步:先用 pw.x 做 scf 得到收敛的电荷密度;再用 pw.x 做 calculation='bands',读取这份电荷密度,沿高对称路径求本征值;最后用 bands.x 导出能带数据。带隙要用数值判定:在所有 k 点上取价带最高值和导带最低值,两者之差是基本带隙。本页单层 MoS2 的 PBE 结果是:不开 SOC 时为 Γ→K 弱间接带隙 1.669 eV,K 点直接带隙 1.686 eV;开 SOC 后为 K 点直接带隙 1.608 eV,K 点价带劈裂 148.89 meV。

本页说明

教程
这页解决什么
你要用 QE 计算一个材料的能带,但不确定参数怎么定、能带算完怎么判断带隙类型,也不确定结果和文献差多少才正常。
适合谁
第一次用 QE 的材料、物理和化学方向研究生。需要会用 Linux 命令行,知道什么是布里渊区和 k 点。
读完你会得到
读完能跑通单层 MoS2 的全部计算,并把同一套流程用到自己的二维材料上。
覆盖
  • 单层 MoS2 的 scf、结构优化、能带和态密度输入文件
  • 截断能、k 点和真空层的收敛测试结果
  • 用脚本判定直接带隙和间接带隙
  • 开启 SOC 需要改什么,K 点劈裂怎么读
  • 体相 MoS2 与 D3 色散校正的影响
  • 计算值和文献、实验值的对照
不覆盖
  • QE 的编译安装
  • GW 和 BSE 计算
  • 声子谱和光学性质

主线步骤

第 1 步

为什么做这一步QE 的输入文件需要晶胞、原子坐标和赝势文件名。这一步确定这三项。

单层 MoS2 属于 P-6m2 空间群,一个原胞有 1 个 Mo 和 2 个 S。本页把晶胞高度 c 设为 15 Å,层与层之间靠真空隔开。下面的 scf 输入已经是优化后的结构。

本页使用 SSSP 1.3.0 PBE efficiency 数据集:Mo 为 SG15 ONCV 赝势,S 为 GBRV 1.4 超软赝势。Mo 和 S 的价电子分别是 14 和 6 个,一个原胞共 26 个电子。不开 SOC 时每条带占 2 个电子,所以占据带数是 13;nbnd=18 表示再多算 5 条空带。

ATOMIC_POSITIONS crystal 表示分数坐标。本页的面内基矢夹角为 120°,这个约定会影响后面 K 点的坐标。

02-scf.intext
&CONTROL
 calculation='scf', prefix='mos2', pseudo_dir='./pseudo',
 outdir='./tmp', tprnfor=.true., tstress=.true., verbosity='high',
/
&SYSTEM
 ibrav=0, nat=3, ntyp=2, ecutwfc=55, ecutrho=440, nbnd=18, occupations='fixed',
/
&ELECTRONS
 conv_thr=1d-9, mixing_beta=0.4, diagonalization='david',
/
ATOMIC_SPECIES
Mo 95.95 Mo_ONCV_PBE-1.0.oncvpsp.upf
S 32.06 s_pbe_v1.4.uspp.F.UPF
CELL_PARAMETERS angstrom
3.1837669586084907 0 0
-1.5918834793042453 2.7572230658844723 0
0 0 14.999999999999998
ATOMIC_POSITIONS crystal
Mo 0 0 0.5
S 0.333333333333 0.666666666667 0.6042046659769958
S 0.333333333333 0.666666666667 0.39579533402300415
K_POINTS automatic
12 12 1 0 0 0
单层 MoS2 优化后结构的俯视图和侧视图
优化后的单层 MoS2 结构。左为俯视图,右为侧视图,蓝色为 Mo,黄色为 S。

第 2 步

为什么做这一步这些参数决定结果的数值误差。每次只改一个参数,其他参数固定。

判据要在看结果之前定好。本页的判据是:相邻两个取值的总能差小于 1 meV/原子,带隙差小于 10 meV。SSSP 对这两种赝势的推荐值是 ecutwfc 35 Ry、ecutrho 280 Ry,它只是测试的起点。实测中 35 Ry 比 65 Ry 高 2.40 meV/原子,45 Ry 比 65 Ry 高 1.29 meV/原子,都超过 1 meV,因此采用 55 Ry。

ecutrho 要单独测试。主线扫描让 ecutrho 固定为 ecutwfc 的 8 倍,这样分不清两者各自的误差。所以另外固定 ecutwfc 为 55 Ry,测试 330、440、550、660 Ry。440 Ry 与 660 Ry 的总能只差 0.008 meV/原子。

这个体系里带隙比总能收敛得快。截断能从 55 Ry 升到 65 Ry,总能变化 0.64 meV/原子,间接带隙只变化 0.04 meV。如果只看带隙,容易过早停止测试;需要优化结构时,还应当同时看总能和受力。

参数测试取值采用采用值的变化
ecutwfc(ecutrho = 8 倍)35、45、55、65 Ry55/440 Ry相对 65 Ry:总能 0.64 meV/原子,间接带隙 0.04 meV
ecutrho(ecutwfc = 55 Ry)330、440、550、660 Ry440 Ry相对 660 Ry:总能 0.008 meV/原子,间接带隙 0.02 meV
k 点网格 N×N×16、9、12、1512×12×1k6 相对更密网格已满足判据:总能差最大 0.43 meV/原子,带隙差最大 1.59 meV;取 12 是为了结构优化时受力更稳定
晶胞高度 c15、20、25、30 Å15 Å相对更高的晶胞:总能差最大 0.0001 meV/原子,带隙差最大 0.03 meV
全相对论赝势 ecutwfc(ecutrho = 4 倍)35 至 95 Ry,每 10 Ry 一档95/380 Ry85→95 Ry:总能 0.18 meV/原子
单层 MoS2 的收敛测试。15 Å 的结论只适用于上下对称的中性单层,带电、缺陷或上下不对称的体系要重新测试。
单层 MoS2 总能和带隙随截断能、k 点网格和晶胞高度变化的曲线
上排是总能相对最高测试值的差,虚线为 ±1 meV/原子判据;下排是带隙。

第 3 步

为什么做这一步把晶格常数和原子位置优化到平衡,同时保持真空层厚度不变。

优化单层时用 calculation='vc-relax',并在 &CELL 中设置 cell_dofree='2Dxy'。这样晶胞只在面内变化,c 保持 15 Å。relax 只移动原子,不改变晶胞,不能得到平衡晶格常数。

本页从 a = 3.18 Å 开始优化,受力阈值为 1×10⁻⁴ Ry/bohr,面内应力阈值为 0.1 kbar。结果是 a = 3.18377 Å,Mo–S 键长 2.41288 Å,两层 S 之间的距离 3.12614 Å。

01-relax.in 中与 scf 不同的部分text
&CONTROL
 calculation='vc-relax', forc_conv_thr=1d-4, etot_conv_thr=1d-6,
/
&IONS
 ion_dynamics='bfgs'
/
&CELL
 cell_dynamics='bfgs', cell_dofree='2Dxy', press_conv_thr=0.1
/

第 4 步

为什么做这一步bands 计算读取 scf 的电荷密度,沿指定路径求本征值。

先用优化后的结构运行 scf。bands 输入与 scf 使用相同的结构、赝势、截断能、prefix 和 outdir,只改 calculation 和 K_POINTS。

K_POINTS crystal_b 下,第一行是路径节点数。之后每行是倒格矢分数坐标和到下一节点之间的点数,最后一行的整数不起作用,但不能省略。本页基矢夹角为 120°,所以 M 为 (1/2, 0, 0),K 为 (1/3, 1/3, 0)。基矢约定不同时,K 的分数坐标也不同,要按自己的基矢重新确认。

bands.x 只做后处理,它把 pw.x 算出的本征值写到 path.dat。能量零点没有物理意义,画图时要减去价带顶。

03-bands.in 中与 scf 不同的部分text
&CONTROL
 calculation='bands',
/
K_POINTS crystal_b
4
0 0 0 35
0.5 0 0 35
0.333333333333 0.333333333333 0 35
0 0 0 1
04-bandsx.intext
&BANDS
 prefix='mos2', outdir='./tmp', filband='path.dat', lsym=.false.
/
运行顺序bash
pw.x -in 02-scf.in > 02-scf.out
pw.x -in 03-bands.in > 03-bands.out
bands.x -in 04-bandsx.in > 04-bandsx.out

第 5 步

为什么做这一步能带图上差几十 meV 的价带顶很难用肉眼分辨,所以要用数值判定。

设每个 k 点上第 13 条带的能量是价带 Ev(k),第 14 条带是导带 Ec(k)。基本带隙等于所有 k 点上 Ec 的最小值减去 Ev 的最大值。最小直接带隙等于每个 k 点上 Ec−Ev 的最小值。两个数相等时是直接带隙,不相等时是间接带隙。

下面的脚本按这个定义计算。它输出的 k 坐标是 bands.x 写入的笛卡尔坐标,单位是 2π/a,所以 K 点显示为 (0.333, 0.577, 0)。

高对称路径不能证明已经找到全局带边。本页又用 24×24×1 均匀网格核对,基本带隙与路径结果相差 0.07 meV,带边仍在 Γ 和 K。

bands.x 的能量只保留三位小数。比较小于 1 meV 的差别时,要读 outdir 下 XML 文件中的本征值。本页表中的五位小数都来自 XML。

band_edges.pypython
#!/usr/bin/env python3
"""从 bands.x 的 filband 文件读出价带顶、导带底和带隙。
用法:python3 band_edges.py path.dat 13
第二个参数是占据带数:不开 SOC 时单层 MoS2 为 13,开 SOC 时为 26。"""
import re
import sys

path, occupied = sys.argv[1], int(sys.argv[2])
numbers = re.compile(r"-?\d+\.\d+")
with open(path) as handle:
    nbnd, nks = map(int, re.findall(r"\d+", handle.readline())[:2])
    points = []
    for _ in range(nks):
        kpoint = tuple(float(v) for v in handle.readline().split()[:3])
        energies = []
        while len(energies) < nbnd:
            energies += [float(v) for v in numbers.findall(handle.readline())]
        points.append((kpoint, energies))

vbm_k, vbm = max(((k, e[occupied - 1]) for k, e in points), key=lambda x: x[1])
cbm_k, cbm = min(((k, e[occupied]) for k, e in points), key=lambda x: x[1])
direct_k, direct = min(
    ((k, e[occupied] - e[occupied - 1]) for k, e in points), key=lambda x: x[1]
)
print(f"VBM {vbm:.3f} eV at k = {vbm_k}")
print(f"CBM {cbm:.3f} eV at k = {cbm_k}")
print(f"fundamental gap {cbm - vbm:.3f} eV")
print(f"smallest direct gap {direct:.3f} eV at k = {direct_k}")
用本页 path.dat 运行的输出text
$ python3 band_edges.py path.dat 13
VBM 0.664 eV at k = (0.0, 0.0, 0.0)
CBM 2.333 eV at k = (0.333333, 0.57735, 0.0)
fundamental gap 1.669 eV
smallest direct gap 1.686 eV at k = (0.333333, 0.57735, 0.0)
采样点数基本带隙(eV)K 点直接带隙(eV)价带顶导带底
高对称路径 Γ–M–K–Γ1061.668821.68564ΓK
24×24×1 均匀网格61(不可约)1.668891.68564ΓK
单层 MoS2 沿 Γ–M–K–Γ 的能带图,标出价带顶、导带底和 1.669 eV 带隙
单层 MoS2 的 PBE 能带,不含 SOC。Γ 点价带比 K 点价带高 16.76 meV,所以基本带隙是 Γ→K。

第 6 步

为什么做这一步投影态密度显示每个能量上的电子态主要来自哪些原子轨道。

态密度需要均匀且较密的 k 点网格。本页用 24×24×1 网格和 occupations='tetrahedra' 重新运行 pw.x,再运行 dos.x 和 projwfc.x。这一步用的 outdir 与能带相同,运行顺序不能调换。

结果显示,价带顶以下约 1 eV 内和导带底附近,Mo d 轨道的贡献都大于 S p 轨道;在 −1 到 −5 eV 的能量范围内,S p 轨道的贡献更大。

运行顺序bash
pw.x -in 05-scf-dense.in > 05-scf-dense.out
dos.x -in 06-dos.in > 06-dos.out
projwfc.x -in 07-projwfc.in > 07-projwfc.out
单层 MoS2 的总态密度以及 Mo d、S p 投影态密度
灰线是总态密度,蓝线是 Mo d,橙色虚线是两个 S 原子的 p 轨道之和。投影不是完整的电荷分配,各项之和不一定等于总态密度。

第 7 步

为什么做这一步Mo 的 SOC 使 K 点价带劈裂,这个值可以直接和文献对照。

开启 SOC 要改三处。第一,赝势换成全相对论版本,本页用 SG15 的 Mo_ONCV_PBE_FR-1.0 和 S_ONCV_PBE_FR-1.1。第二,在 &SYSTEM 中设置 noncolin=.true. 和 lspinorb=.true.。第三,nbnd 改为 36。这时每条带只占 1 个电子,占据带数从 13 变为 26,判定带隙时第二个参数要写 26。设置 nspin=2 是共线自旋计算,不能代替 SOC。

全相对论赝势要重新测试截断能,不能沿用前面的 55 Ry。本页测试到 95 Ry,采用 95/380 Ry。

比较 SOC 的影响时,开和不开都要用同一套全相对论赝势和同一个结构,只切换 lspinorb。如果拿标量赝势的结果和全相对论赝势的结果相减,赝势本身的差别也会算进去。本页的结构固定为前面标量赝势优化的结果,全相对论赝势下残余受力约 0.0012 Ry/bohr,没有重新优化。

K 点价带劈裂取 K 点第 26 条和第 25 条带的能量差,结果是 148.89 meV。Xiao 等(2012)给出的 2λ 是 0.15 eV,两者相差 1.11 meV。

soc/01-soc-on-scf.in 中与标量计算不同的部分text
&SYSTEM
 ecutwfc=95, ecutrho=380, nbnd=36,
 noncolin=.true., lspinorb=.true.,
/
&ELECTRONS
 conv_thr=1d-10, mixing_beta=0.3, mixing_ndim=4, electron_maxstep=150,
/
ATOMIC_SPECIES
Mo 95.95 Mo_ONCV_PBE_FR-1.0.upf
S 32.06 S_ONCV_PBE_FR-1.1.upf
量不开 SOC(eV)开 SOC(eV)变化(meV)
基本带隙1.66644(Γ→K)1.60847(K→K)−57.98
K 点直接带隙1.688401.60847−79.94
K 点价带劈裂00.14889148.89
同一套全相对论赝势、同一结构,只切换 lspinorb。
单层 MoS2 开与不开 SOC 的能带对比,右侧放大 K 点并标出 148.89 meV 劈裂
虚线不开 SOC,实线开 SOC,各自以自身价带顶为零点。右图放大 K 点。

按你的情况选择

体相

为什么做这一步体相 MoS2 的层间作用来自范德华力,PBE 本身描述不好,需要单独处理。

不加色散校正时,优化后的 c 是 14.58 Å,比文献值 12.70 Å 大 1.89 Å。加入 DFT-D3 后 c 是 12.49 Å,基本带隙从 1.432 eV 变为 0.952 eV。D3 不直接改变固定结构的电子本征值,这个带隙变化主要来自层间距的变化。

体相的带边不在高对称点上。开启 D3 后导带底在 Γ 与 K 之间的 Q 谷。在优化前的结构上,12×12×4 的 scf 网格漏掉了这个谷,带隙比路径采样大 11.36 meV,所以后面在谷底做了局部加密。所以 scf 网格收敛和找到真正的带边是两个独立的问题。

量PBEPBE-D3Kuc 等(2011)
a(Å)3.18443.16733.173
c(Å)14.582512.489412.696
基本带隙(eV)1.432(Γ→K)0.952(Γ→Q)1.2
K 点直接带隙(eV)1.6711.6731.8
体相 MoS2 的 PBE-D3 能带图,间接带隙从 Γ 到 Q 谷,0.952 eV
体相 MoS2 的 PBE-D3 能带,基本带隙从 Γ 到 Q 谷。
体相 MoS2 不加色散校正的 PBE 能带图
不加色散校正的 PBE 能带,层间距偏大,基本带隙为 1.432 eV。

原理与判断

原理

为什么做这一步很多资料写单层 MoS2 是 K 点直接带隙。本页不开 SOC 时得到的结果与此不同,需要解释。

原因是 Γ 和 K 的价带能量非常接近。本页标量 PBE 结果中,Γ 比 K 高 16.76 meV。差值这么小时,排序容易受赝势和结构影响,所以要用第二套赝势核对。

本页用另一套全相对论赝势(同样不开 SOC)在同一结构上核对,Γ 仍高于 K,差值是 21.96 meV。因此在这个结构和泛函下,两套赝势给出相同的排序。

开启 SOC 后,K 点价带劈裂成两支,上面一支超过 Γ 点。bands.x 输出显示它比 Γ 高约 50 meV,基本带隙因此变为 K 点直接带隙。这些结果只对应本页的 PBE 泛函和结构,不能单独用来判断真实材料的带隙类型。

原理

为什么做这一步对比实验值前,要先确认两边是不是同一种带隙。

PBE 带隙是 Kohn–Sham 本征值之差。准粒子带隙是加入和移走一个电子所需的能量差,GW 计算的是这个量。光学带隙是吸收或发光对应的能量,还包含电子和空穴之间的吸引,也就是激子效应。

Mak 等(2010)测得的 1.90 eV 是单层 MoS2 的光致发光峰,属于光学带隙。本页的 1.608 eV 是 PBE 带隙。两者定义不同,直接相减不能作为误差。本页没有运行 GW 或 BSE,所以不给出这个差值的分解。

带隙含义计算或测量方法
Kohn–Sham 带隙DFT 本征值之差PBE,本页使用
准粒子带隙加入和移走一个电子的能量差GW、光电子能谱加逆光电子能谱
光学带隙含激子效应的光激发能BSE、吸收谱、光致发光

参考与附录

对照

为什么做这一步参数在看文献之前已经确定,文献值没有用来调参。

文献的条件与本页不完全相同:Kuc 等(2011)的基组不同,单层结构是从优化后的体相切出来的。所以下表的差值不能全部归为误差。体相 D3 的基本带隙比 Kuc 等小 0.25 eV,本次没有把这个差值归因到单一原因。

量本页文献差值来源
单层 K 点价带劈裂148.89 meV150 meV−1.11 meVXiao 2012
单层 a3.1838 Å3.193 Å−0.0092 ÅXiao 2012
单层 K 点直接带隙1.6856 eV1.9 eV−0.214 eVKuc 2011
体相 D3 a3.1673 Å3.173 Å−0.0057 ÅKuc 2011
体相 D3 c12.4894 Å12.696 Å−0.2066 ÅKuc 2011
体相 D3 基本带隙0.9517 eV1.2 eV−0.248 eVKuc 2011
单层光致发光峰不可比1.90 eV定义不同Mak 2010

运行记录

为什么做这一步说明计算条件、用时和核验方式。

2026 年 11 月 5 日在 Scientify 上运行的一次长周期研究任务。上传任务书后,Agent 自行选择赝势、做收敛测试、优化结构、计算能带和 SOC、查文献并写报告,全程 6 小时 18 分,共 354 次操作,没有人工介入,也没有租用外部算力。

计算只用了云电脑的 2 核 CPU,QE 7.5 按单进程单线程串行运行。最耗时的是 SOC 部分,22 次 QE 调用合计约 2.35 小时。6 小时 18 分包括全部收敛测试、体相、文献查阅和写报告。下载本页的文件包在同一台云电脑上重新运行,单层从结构优化到投影态密度约 10 分钟,优化后的晶胞和原计算一致。

Agent 另开一个审阅任务做了最终检查,从原始 XML 重新计算带隙,并把复现包移到新目录重新解析,结论是通过。已知的局限写在报告中:SOC 没有重新优化结构;标量赝势敏感性对照中有一个 k12 的 XML 没有保留,相应差值只给出约 0.29 meV 的保守上界;Qiu 等(2013)的勘误全文未能核实,所以没有作为基准。

计算墙钟时间(s)峰值内存(MiB)
单层最终 scf56.75574
单层结构优化284.99582
单层路径 bands126.39510
单层 DOS / PDOS5.81 / 5.92485
体相 D3 结构优化581.98709
体相 D3 路径 bands375.09433
SOC 全部 22 次 QE8475.67255
代表性计算的用时,2 核云电脑,单进程单线程。
Scientify 工作区中 QE 任务完成后的交付物、计划和成果列表
任务完成后的工作区:报告、数据表、复现包和运行记录。

常见问题排查

续算时报错,提示电子数或电荷不对,例如算出的电荷约 0.05,实际应为 52

原因:上一次计算中断后留下的电荷文件不可用。本页体相续算时遇到过这个问题。

怎么解决:不要沿用这份电荷,改为从头计算。长时间优化可以用 max_seconds 分段安全停止,并保留每段输出。

能带图上看着是 K 点直接带隙,脚本却说是间接带隙

原因:Γ 和 K 的价带只差几十 meV,图上看不出来。占据带数填错也会得到错误结果。

怎么解决:先确认占据带数:不开 SOC 是电子数除以 2,开 SOC 是电子数。再看脚本输出的两个 k 点。

参数变化后带隙完全不变,或者相差正好 0.001 eV

原因:bands.x 只保留三位小数,小差别被舍入了。

怎么解决:比较小于 1 meV 的差别时,读 outdir 里 XML 的本征值。

能带图里找不到 K 点的谷,形状和文献不一样

原因:K 点的分数坐标取决于基矢约定。本页 120° 基矢下是 (1/3, 1/3, 0),换一套基矢坐标就不同。

怎么解决:先按自己 CELL_PARAMETERS 的基矢核对高对称点坐标,再运行 bands。

设置 lspinorb=.true. 后报赝势错误,或 K 点没有劈裂

原因:使用了标量相对论赝势,或者只设置了 nspin=2。

怎么解决:换全相对论赝势,同时设置 noncolin=.true. 和 lspinorb=.true.,重新测试截断能。

云电脑上 df 显示磁盘快满

原因:Scientify 云电脑的项目盘按需扩容,df 显示的是当前大小,小于实际可用容量。

怎么解决:运行 scientify-resources,看 Project disk 一行的总容量和剩余空间。

把 OpenMP 线程数从 1 改成 2,计算没有明显变快

原因:本次在 2 核云电脑上试用两线程,没有观察到明确收益。这次测试不是严格的配对比较。

怎么解决:在同样的小算例上先测一次,再决定线程数。同时运行的作业不要超出内存上限。

参考资料

常见问题

QE 算能带用 bands 还是 nscf?

两者都可以读取 scf 的电荷密度,不重新自洽。沿路径计算时一般用 calculation='bands';算态密度等需要均匀网格的量时用 nscf。本页态密度用的是更密网格的 scf,occupations='tetrahedra'。

ecutrho 应该设成 ecutwfc 的几倍?

取决于赝势。本页超软赝势的主线用 8 倍,全相对论范数守恒赝势用 4 倍。比例只是起点,本页另外单独测试了 ecutrho,确认 440 Ry 已经足够。

二维材料的真空层要多厚?

要用收敛测试决定。本页单层 MoS2 的 c = 15 Å 与 30 Å 相比,带隙只差 0.03 meV。这个结论只适用于上下对称的中性单层,有偶极或带电的体系需要更厚的真空或者其他修正。

算出来的带隙比实验小正常吗?

PBE 带隙和实验光学带隙定义不同,不能直接相减。本页 PBE 带隙为 1.608 eV,实验发光峰为 1.90 eV。要接近实验值需要 GW 和 BSE。

跑完本页全部计算要多久?

按本页文件包实跑,单层从结构优化到投影态密度共约 10 分钟:优化 4.5 分钟,scf 1 分钟,路径 bands 2 分钟,24×24×1 网格 2 分钟。SOC 的 scf 约 5.5 分钟。原始任务的 SOC 部分合计约 2.35 小时,因为其中包括截断能测试和更密网格。

把第一性原理计算交给 Scientify

说明材料和要算的性质,Scientify 会在预装 QE 的云电脑上选赝势、做收敛测试、计算能带并查文献,交付报告、数据表和全部输入输出。