Quantum ESPRESSO pw.x 参数设置

注:内容为AI辅助生成并由本人进行校对,部分未校对的内容未必正确,后面会持续更新并校对。

目录

  1. 概述与基本结构
  2. &CONTROL — 任务控制
  3. &SYSTEM — 体系定义
  4. HUBBARD — DFT+U 校正
  5. &ELECTRONS — 电子自洽迭代
  6. &IONS — 离子弛豫
  7. &CELL — 晶格优化
  8. K_POINTS — k 点设置
  9. CELL_PARAMETERS — 晶格矢量
  10. ATOMIC_SPECIES / ATOMIC_POSITIONS
  11. 极化与 Berry 相
  12. 赝势与交换关联泛函
  13. 典型输入文件模板
  14. 能带后处理(bands.x / plotband.x)
  15. 投影态密度与电荷分析projwfcx

1. 概述与基本结构

pw.x 是 Quantum ESPRESSO 的核心 DFT 计算程序(PWscf)。输入文件采用 Fortran namelist 格式,由多个 &BLOCK / 组成。

文件基本框架

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
&CONTROL
calculation = 'scf'
prefix = 'my_calc'
outdir = './tmp'
pseudo_dir = './pseudo'
/
&SYSTEM
ibrav = 0
nat = 2
ntyp = 2
ecutwfc = 60.0
ecutrho = 480.0
/
&ELECTRONS
conv_thr = 1.0d-9
mixing_beta = 0.7
/
&IONS
ion_dynamics = 'bfgs'
/
&CELL
cell_dynamics = 'bfgs'
/
ATOMIC_SPECIES
Si 28.086 Si.pbe-n-rrkjus_psl.1.0.0.UPF
O 15.999 O.pbe-n-rrkjus_psl.1.0.0.UPF
ATOMIC_POSITIONS {angstrom}
Si 0.00 0.00 0.00
O 1.54 1.54 1.54
K_POINTS {automatic}
4 4 4 0 0 0
CELL_PARAMETERS {angstrom}
5.430 0.000 0.000
0.000 5.430 0.000
0.000 0.000 5.430

命名块一览

Block 作用
&CONTROL 任务类型、输出控制、并行策略
&SYSTEM 晶格、原子、截断能、自旋、范德华
&HUBBARD DFT+U 校正(强关联体系)
&ELECTRONS SCF 收敛、混合、对角化、展宽
&IONS 离子弛豫算法与参数
&CELL 晶格优化算法与参数
ATOMIC_SPECIES 元素名称、质量、赝势文件
ATOMIC_POSITIONS 原子坐标
K_POINTS k 点网格或路径
CELL_PARAMETERS 晶格矢量(当 ibrav = 0 时)

2. &CONTROL — 任务控制

calculation

1
calculation = 'scf'
取值 含义
'scf' 自洽场计算(单点能 + 电荷密度)
'nscf' 非自洽计算(读取电荷密度,计算更多 k 点/能带)
'bands' 能带计算(沿 k 路径的非自洽)
'relax' 离子位置弛豫(固定晶格)
'vc-relax' 同时弛豫离子位置和晶格参数
'md' 第一性原理分子动力学
'vc-md' 变胞分子动力学

prefix / outdir

1
2
prefix = 'my_calc'
outdir = './tmp'
参数 含义
prefix 输出文件前缀。中间文件以 <prefix>.save/、<prefix>.wfc 等命名
outdir 临时文件/波函数存储目录。跨任务(scf → nscf)需一致
pseudo_dir 赝势文件所在目录

verbosity

1
verbosity = 'high'    ! 'low' / 'medium' / 'high'

控制输出文件中的信息详细程度。

restart_mode

1
2
restart_mode = 'from_scratch'    ! 从头开始
! restart_mode = 'restart' ! 从已有电荷密度续算

tprnfor / tstress

1
2
tprnfor = .true.     ! 输出力(弛豫时必须)
tstress = .true. ! 输出应力(晶格优化时必须)

nstep

1
nstep = 100          ! 离子/分子动力学最大步数

etot_conv_thr

1
etot_conv_thr = 1.0d-5    ! 弛豫总能量收敛阈值 (Ry)

3. &SYSTEM — 体系定义

晶格设置

ibrav — Bravais 晶格类型

1
ibrav = 0    ! 自由晶格(需 CELL_PARAMETERS)
常用 ibrav 晶格类型 晶胞参数格式
0 自由 CELL_PARAMETERS 提供完整矢量
1 简单立方 (sc) A, B, C 为三个晶格常数
2 面心立方 (fcc) A
3 体心立方 (bcc) A
4 六方 (hex) A, C
5 三方 (trigonal, rhombohedral) A, cos(ab)
6 简单四方 (st) A, C
8 简单正交 (so) A, B, C

推荐始终使用 ibrav = 0 + CELL_PARAMETERS,避免因晶格类型选错导致的对称性问题。

nat / ntyp

1
2
nat  = 12     ! 总原子数
ntyp = 3 ! 元素种类数

ecutwfc / ecutrho

1
2
ecutwfc = 60.0     ! 波函数截断能 (Ry)
ecutrho = 480.0 ! 电荷密度截断能 (Ry)
参数 含义 建议值
ecutwfc 平面波展开的动能截断 取决于赝势类型。NC 赝势需更高(60-120 Ry),US/PAW 可较低(40-80 Ry)
ecutrho 电荷密度和势的截断 默认 = 4 × ecutwfc。US/PAW 赝势通常需要 8-12 × ecutwfc

ecutwfc 和 ecutrho 的收敛测试是任何 DFT 计算的必要前提。

occupations / smearing / degauss

1
2
3
occupations = 'smearing'    ! 金属/小带隙体系
smearing = 'gaussian' ! 或 'mp' (Methfessel-Paxton), 'mv' (Marzari-Vanderbilt)
degauss = 0.01 ! 展宽 (Ry),约 0.005-0.02
occupations 取值 适用体系
'fixed' 绝缘体/半导体(默认,带隙明确)
'smearing' 金属/小带隙/总能计算
'tetrahedra' 态密度/能带后处理(不用于总能)

phonopy 声子计算中使用 'smearing' + 适当 degauss 以避免金属体系的受力噪声。

nspin / noncolin / lspinorb

1
2
3
nspin    = 1       ! 1=非自旋极化, 2=共线自旋极化
noncolin = .false. ! 非共线磁性
lspinorb = .false. ! 自旋轨道耦合(需含 SOC 的赝势 + noncolin=.true.)
场景 设置
非磁性半导体/金属 nspin = 1
铁磁/反铁磁 nspin = 2 + starting_magnetization(i)
非共线磁性 / SOC noncolin = .true. + lspinorb = .true.(全相对论赝势)

starting_magnetization

1
2
starting_magnetization(1) = 0.5    ! 第 1 种元素的初始磁矩 (Bohr magneton)
starting_magnetization(2) = 0.0

仅当 nspin = 2 时有效。

tot_magnetization / tot_charge

1
2
tot_magnetization = 4.0    ! 总磁矩约束
tot_charge = 0.0 ! 总电荷约束(带电体系)

nbnd

1
nbnd = 40    ! 能带数。默认自动,但 nscf/bands 计算常需手动指定

assume_isolated

1
assume_isolated = '2D'    ! '2D'=二维(slab 真空), 'esm'=带电 slab

范德华修正

1
2
3
4
5
! DFT-D2
vdw_corr = 'grimme-d2'

! DFT-D3 (带 Becke-Johnson 阻尼)
vdw_corr = 'grimme-d3'
参数 含义
vdw_corr 范德华修正方法:'grimme-d2', 'grimme-d3', 'TS'(Tkatchenko-Scheffler)

4. HUBBARD — DFT+U 校正

QE 7.x 起 DFT+U 采用 card 格式(类似 K_POINTS、ATOMIC_POSITIONS),而非 &HUBBARD namelist。投影类型作为标签写在 card 行,每行指定原子和 U 值。

基本语法

1
2
3
HUBBARD {atomic}              ! 投影类型:{atomic} / {ortho-atomic} / {norm-atomic} / {pseudo}
U Fe1-3d 3.1 ! <原子标签>-<轨道> <U值(eV)>
U Fe2-3d 3.1

语法要点:

  • 第一行:HUBBARD {<projection_type>},{} 可省略
  • 后续行:U <label>-<orb> <value>,U 值单位是 eV(不是 Ry)
  • <label> 为 ATOMIC_SPECIES 中定义的元素标签,同一元素不同位点用不同标签区分(如 Fe1, Fe2)
  • <orb> 为轨道名:3d, 4f, 2p 等

投影类型

标签 含义
{atomic} 投影到赝势中的原子轨道(默认,最常用)
{ortho-atomic} 使用正交化的原子轨道
{norm-atomic} 使用归一化的原子轨道
{pseudo} 使用赝原子轨道

Hubbard 参数

参数 含义 示例
U label-orb value Hubbard U 值 (eV) U Fe-3d 4.0
J label-orb value Hund 交换 J 值 (eV),选填 J Fe-3d 1.0
alpha label-orb value J 参数 (eV),Dudarev 方案中 U_eff = U - alpha alpha Fe-3d 1.0

实用示例

例 1:同一元素不同位点不同 U(你的写法)

1
2
3
4
5
6
7
8
ATOMIC_SPECIES
Fe1 55.845 Fe.pbe-spn-kjpaw_psl.0.2.1.UPF
Fe2 55.845 Fe.pbe-spn-kjpaw_psl.0.2.1.UPF
Cl 35.453 cl_pbe_v1.4.uspp.F.UPF
O 15.999 O.pbe-n-kjpaw_psl.0.1.UPF
HUBBARD {atomic}
U Fe1-3d 3.1
U Fe2-3d 3.1

例 2:NiO(仅 Ni 加 U,O 不加)

1
2
3
4
5
ATOMIC_SPECIES
Ni 58.69 Ni.pbe-spn-rrkjus_psl.1.0.0.UPF
O 15.99 O.pbe-n-rrkjus_psl.1.0.0.UPF
HUBBARD {atomic}
U Ni-3d 5.0

例 3:f 电子体系

1
2
3
4
ATOMIC_SPECIES
Ce 140.12 Ce.pbe-spn-rrkjus_psl.1.0.0.UPF
HUBBARD {atomic}
U Ce-4f 4.5

与 lda_plus_u_kind 的关系

card 语法下不再显式写 lda_plus_u_kind,默认为简化旋转不变方案(kind=0,Cococcioni-de Gironcoli)。如需 Dudarev 方案(等效 VASP LDAUTYPE=2),用 alpha 参数:

1
2
3
HUBBARD {atomic}
U Fe-3d 4.0
alpha Fe-3d 1.0 ! U_eff = U - alpha = 3.0 eV (Dudarev)

常见问题

问题 原因 解决方法
HUBBARD card 不被识别 语法写成了 &HUBBARD namelist 改为 card 格式:HUBBARD {atomic} + U ...
U 值不生效 原子标签与轨道名不匹配 <label> 必须与 ATOMIC_SPECIES 中完全一致(含数字后缀);<orb> 需匹配赝势的价电子轨道
SCF 不收敛 U 值太大 减小 mixing_beta(0.7→0.3),改用 mixing_mode = 'local-TF'
单位错误 U 值填了 Ry U 的单位是 eV,不是 Ry

5. &ELECTRONS — 电子自洽迭代

conv_thr

1
conv_thr = 1.0d-9    ! SCF 收敛阈值 (Ry)
场景 推荐值
常规 DFT 1.0d-8
精确受力(声子计算) 1.0d-10 或更紧
初始预收敛 1.0d-6

mixing_mode / mixing_beta

1
2
mixing_mode = 'plain'     ! 'plain' (Broyden), 'TF' (Thomas-Fermi), 'local-TF'
mixing_beta = 0.7 ! 混合系数 (0.1-0.7),越小越稳定但收敛越慢
问题 调整方向
SCF 震荡/不收敛 减小 mixing_beta(如 0.3→0.1),改用 'local-TF'
SCF 收敛慢 增大 mixing_beta,或使用 mixing_ndim = 12

mixing_ndim

1
mixing_ndim = 8     ! Broyden 混合的内存步数,增大可改善收敛

diagonalization

1
diagonalization = 'david'    ! 'david' (Davidson, 默认), 'cg' (共轭梯度)

electron_maxstep

1
electron_maxstep = 100    ! 最大 SCF 迭代步数

startingpot / startingwfc

1
2
startingpot = 'atomic'     ! 初始势:'atomic'(原子叠加)/ 'file'(从文件读取)
startingwfc = 'atomic+random' ! 初始波函数

6. &IONS — 离子弛豫

仅在 calculation = 'relax' 或 'vc-relax' 时需要。

ion_dynamics

1
2
ion_dynamics = 'bfgs'    ! BFGS 准牛顿法(推荐,默认)
! ion_dynamics = 'damp' ! 阻尼动力学

ion_positions

1
ion_positions = 'default'    ! 所有原子可移动

upscale

1
upscale = 100.0    ! BFGS 的第一步试探步长上限

bfgs_ndim

1
bfgs_ndim = 1    ! BFGS 历史记忆步数,增大可加速收敛

trust_radius_max / trust_radius_min

1
2
trust_radius_max = 0.8    ! BFGS 信任域半径 (Bohr)
trust_radius_min = 1.0d-4

ion_temperature

1
ion_temperature = 'not_controlled'    ! 弛豫时不控温

力收敛标准

1
2
! 弛豫直到所有原子受力 < 阈值
forc_conv_thr = 1.0d-4 ! 力的收敛阈值 (Ry/Bohr)
场景 推荐 forc_conv_thr (Ry/Bohr)
常规弛豫 1.0d-4
声子计算前弛豫 1.0d-5 或更紧

7. &CELL — 晶格优化

仅在 calculation = 'vc-relax' 时需要。

cell_dynamics

1
cell_dynamics = 'bfgs'    ! BFGS 优化晶格

press / press_conv_thr

1
2
press           = 0.0         ! 目标外部压强 (kbar)
press_conv_thr = 0.5 ! 压强收敛阈值 (kbar)

cell_dofree

1
2
3
cell_dofree = 'all'       ! 所有分量可变化
! cell_dofree = 'xyz' ! 仅对角线(保持正交)
! cell_dofree = '2Dxy' ! 仅 xy 平面(2D 体系)

8. K_POINTS — k 点设置

所有格式一览

格式标签 含义
{automatic} 自动 Monkhorst-Pack 网格
{gamma} 仅 Γ 点(大超胞、分子)
{crystal_b} 晶体坐标的能带路径(分段,每段指定点数)
{crystal} 晶体坐标的手动 k 点列表
{tpiba_b} 直角坐标能带路径(单位 2π/a)
{tpiba} 直角坐标手动 k 点列表(单位 2π/a)

所有格式的 {} 均可省略(如 automatic 和 {automatic} 等效),官方习惯带 {},仅为书写规范。

自动 Monkhorst-Pack 网格

1
2
K_POINTS {automatic}
4 4 4 0 0 0
行 含义
{automatic} 自动生成 MP 网格
第一行 nk1 nk2 nk3(三个方向的 k 点密度)
第二行 sk1 sk2 sk3(网格偏移:0=Gamma-centered, 非 0 为 shift)

六方晶系建议使用 0 0 0(Gamma-centered),使用 1 1 1 会破坏六方对称性。

仅 Γ 点

1
K_POINTS {gamma}
含义 适用场景
只计算 k = (0,0,0) 一个点 大超胞(分子动力学、声子有限位移)、孤立分子、Γ-only 快速测试

不需要写 k 点坐标,QE 自动使用 Γ 点。大超胞计算中能显著加速。

能带路径(bands/nscf 计算)

1
2
3
4
5
6
7
K_POINTS {crystal_b}
5
0.000 0.000 0.000 20 ! Γ → X (20 个点)
0.500 0.000 0.000 20 ! X → M
0.500 0.500 0.000 20 ! M → Γ
0.000 0.000 0.000 20 ! Γ → R
0.500 0.500 0.500 0 ! R (终点,0 表示结束)
行 含义
{crystal_b} 晶体坐标的 k 路径
第一行 高对称点总数(不是 k 点数)
后续行 kx ky kz nk:高对称点坐标 + 该点到下一点的路径上的 k 点数
最后一行 nk = 0,表示路径结束

k 点密度经验值

1
k_i × a_i ≈ 常数 (通常 30-40 Å 为收敛标准)

即 nk_i ≈ ceil(40 / |a_i|)。

9. CELL_PARAMETERS — 晶格矢量

当 ibrav = 0 时必须提供,以三行晶格矢量定义晶胞。

语法

1
2
3
4
CELL_PARAMETERS {angstrom}    ! 或 {bohr}, {alat}
5.430 0.000 0.000 ! a₁
0.000 5.430 0.000 ! a₂
0.000 0.000 5.430 ! a₃
行 含义
第一行 坐标类型标签(同 ATOMIC_POSITIONS,{} 可省略,angstrom 和 {angstrom} 等效)
后三行 三个晶格矢量 a₁, a₂, a₃(行向量)

坐标类型

标签 单位 说明
{angstrom} Å 直角坐标,最常用
{bohr} Bohr (a₀) 直角坐标,与 celldm 同单位
{alat} a(晶格常数) 直角坐标,以 celldm(1) 或 A 为单位

若 ibrav ≠ 0 且未写 CELL_PARAMETERS,QE 由 celldm 自动推导晶格矢量,不需此块。

celldm 等效转换

1
2
3
4
5
6
7
8
9
10
11
12
! 这俩等价:
ibrav = 0
CELL_PARAMETERS {angstrom}
4.000 0.000 0.000
0.000 4.000 0.000
0.000 0.000 6.000

! ↓ 等同于
ibrav = 8 ! 简单正交
celldm(1) = 4.000 / 0.529177 ! Å → Bohr
celldm(2) = 4.000 / 4.000 = 1.0
celldm(3) = 6.000 / 4.000 = 1.5

ibrav = 0 更推荐的原因

  • 直观:直接填 DFT 优化后的晶格矢量,无需手动换算 Bohr/ratio
  • 通用:三斜、单斜等低对称性晶系只能用 ibrav = 0
  • 安全:不会因 ibrav 选错导致对称性分析错误
  • 跨程序兼容:与 VASP 的 POSCAR 晶格行格式一致,便于转换

10. ATOMIC_SPECIES / ATOMIC_POSITIONS

ATOMIC_SPECIES

1
2
3
ATOMIC_SPECIES
Fe 55.845 Fe.pbe-spn-rrkjus_psl.1.0.0.UPF
O 15.999 O.pbe-n-rrkjus_psl.1.0.0.UPF
列 含义
1 元素标签(大小写敏感)
2 原子质量 (amu,仅 MD 有意义;其余情况可随便填)
3 赝势文件名

ATOMIC_POSITIONS

1
2
3
4
ATOMIC_POSITIONS {angstrom}    ! {angstrom}, {bohr}, {crystal}, {alat}
Fe 0.00 0.00 0.00 ! {} 可省略,写成 angstrom 等同效
Fe 0.00 0.00 1.54
O 0.77 0.77 0.77
坐标类型 含义
{angstrom} 直角坐标,Å
{bohr} 直角坐标,Bohr
{crystal} 分数坐标,以晶格矢量为基
{alat} 直角坐标,以 A(晶格常数)为单位

与 K_POINTS 相同,ATOMIC_POSITIONS 和 CELL_PARAMETERS 的 {} 可省略,QE 两种写法均接受。


11. 极化与 Berry 相(Berry Phase / Polarization)

QE 通过 Berry 相方法计算体系的电子极化(现代极化理论),也可施加有限外电场。

相关 namelist 参数(&SYSTEM)

1
2
3
4
5
&SYSTEM
lberry = .true. ! 启用 Berry 相 / 极化计算
gdir = 3 ! 极化方向:1=x, 2=y, 3=z
nppstr = 6 ! 该方向上的 k 点字符串数(通常取 k 点密度)
/
参数 含义 典型值
lberry 启用 Berry 相/有限电场计算的总开关 .true.
gdir 极化方向(沿哪个倒格矢积分) 1/2/3
nppstr 极化方向上的 k 点"弦"数 6–10(越大越精确)

极化计算

计算绝缘体的电子极化 P(偶极矩/体积),输出自发极化、离子极化、电子极化。

K_POINTS 格式

1
2
K_POINTS {automatic}
4 4 6 0 0 0 ! 注意:gdir 方向的 k 点密度 = nppstr

工作流

1
2
3
4
5
# 1. 常规 SCF
pw.x < scf.in > scf.out

# 2. 计算极化(nscf + lberry)
pw.x < berry.in > berry.out
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
! ====== berry.in ======
&CONTROL
calculation = 'nscf' ! 非自洽,读入 scf 电荷密度
prefix = 'my_calc'
outdir = './tmp'
pseudo_dir = './pseudo'
/
&SYSTEM
...
lberry = .true.
gdir = 3
nppstr = 6
/
&ELECTRONS
conv_thr = 1.0d-10
/
K_POINTS {automatic}
6 6 6 0 0 0 ! gdir=3 方向至少 nppstr = 6

输出

pw.x 输出的 OUTCAR-风格极化信息在 QE 中写入标准输出(*berry.out):

1
2
3
Value of the electronic polarization (a.u.)
...
Total Phase: <Berry phase value>

有限外电场

在 lberry = .true. 基础上施加锯齿形电场(sawtooth potential),用于计算直流电导、介电击穿等。

1
2
3
4
5
6
7
8
9
10
11
&CONTROL
lelfield = .true. ! 启用有限电场
/
&SYSTEM
lberry = .true.
gdir = 3
nppstr = 6
efield_cart(1) = 0.0 ! 电场矢量 (a.u.),直角坐标
efield_cart(2) = 0.0
efield_cart(3) = 0.01 ! 沿 z 方向 0.01 a.u. ≈ 5.14 MV/cm
/
参数 含义 单位
lelfield 启用有限外电场(&CONTROL 中) —
efield_cart(1:3) 电场直角分量 a.u. (1 a.u. = 5.14×10⁹ V/cm)
efield(1:3) 电场晶格坐标分量 a.u.

nscf 模式下的 Berry 曲率(Wannier 前处理)

QE 不能直接输出 AHC/Berry 曲率(那是 Wannier90 的活),但可以生成 Wannier90 需要的 .mmn、.amn 等交叠矩阵:

1
2
3
4
5
6
7
8
9
&CONTROL
calculation = 'nscf'
/
&SYSTEM
nbnd = 40 ! 比占据带多 2-3 倍
...
/
K_POINTS {automatic}
10 10 10 0 0 0 ! 密 k 网格(Wannier90 需要)

QE 需要通过 wannier90.x 的后处理接口(pw2wannier90.x)生成 Wannier 函数,再由 Wannier90 做 Berry 曲率/AHC/拓扑等计算。详见 Wannier90 文档。

常见问题

问题 原因 解决方法
极化值为 0 绝缘体带隙不够 / k 点太稀 加密 k 网格(特别是 gdir 方向)
极化值跳变(分支问题) 极化量子 2eR/V 的分支选择 正常现象——极化定义在模量子之内,需追踪连续路径
lberry 报错 “not enough bands” 空带数不够 增大 nbnd

12. 赝势与交换关联泛函

赝势类型选择

类型 后缀特征 优点 缺点
模守恒 (NC) .UPF (无特殊标记) 精度最高,适用所有计算 截断能高
超软 (US) .UPF (含 us) 截断能低,计算快 某些性质(NMR)不够准
PAW .UPF (含 paw 或 PAW) 精度接近 NC,效率接近 US
全相对论 (FR) -fr- 或 -sr- 含 SOC 的赝势 仅需 SOC 时使用

常用赝势库

赝势库 特征
SSSP (PseudoDojo) 精度高,推荐使用
PSlibrary (psl.1.0.0) 标准赝势库,广泛使用
GBRV 超软,截断能极低
SG15 ONCV 模守恒,高精度

赝势的文件名规范(以 PSlibrary 为例)

1
元素.泛函-{n,s,sr,fr}-{rrkjus,paw,...}_psl.版本号.UPF
  • n = 非相对论, s = 标量相对论, sr = 标量相对论 (无 SOC), fr = 全相对论 (含 SOC)
  • rrkjus = Rappe-Rabe-Kaxiras-Joannopoulos 超软

示例:Si.pbe-n-rrkjus_psl.1.0.0.UPF = Si,PBE 泛函,模守恒/超软,v1.0.0


13. 典型输入文件模板

模板 1:SCF 自洽计算(绝缘体)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
&CONTROL
calculation = 'scf'
prefix = 'si_scf'
outdir = './tmp'
pseudo_dir = './pseudo'
tprnfor = .true.
tstress = .true.
/
&SYSTEM
ibrav = 0
nat = 2
ntyp = 1
ecutwfc = 60.0
ecutrho = 480.0
occupations = 'fixed'
/
&ELECTRONS
conv_thr = 1.0d-9
mixing_beta = 0.7
/
ATOMIC_SPECIES
Si 28.086 Si.pbe-n-rrkjus_psl.1.0.0.UPF
ATOMIC_POSITIONS {crystal}
Si 0.00 0.00 0.00
Si 0.25 0.25 0.25
K_POINTS {automatic}
6 6 6 0 0 0
CELL_PARAMETERS {angstrom}
5.430 0.000 0.000
0.000 5.430 0.000
0.000 0.000 5.430

模板 2:离子弛豫(固定晶格)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
&CONTROL
calculation = 'relax'
prefix = 'si_relax'
outdir = './tmp'
pseudo_dir = './pseudo'
tprnfor = .true.
/
&SYSTEM
ibrav = 0
nat = 2
ntyp = 1
ecutwfc = 60.0
ecutrho = 480.0
occupations = 'fixed'
/
&ELECTRONS
conv_thr = 1.0d-9
mixing_beta = 0.7
/
&IONS
ion_dynamics = 'bfgs'
forc_conv_thr = 1.0d-4
/
ATOMIC_SPECIES
Si 28.086 Si.pbe-n-rrkjus_psl.1.0.0.UPF
ATOMIC_POSITIONS {crystal}
Si 0.00 0.00 0.00
Si 0.26 0.26 0.26
K_POINTS {automatic}
6 6 6 0 0 0
CELL_PARAMETERS {angstrom}
5.430 0.000 0.000
0.000 5.430 0.000
0.000 0.000 5.430

模板 3:变胞弛豫(vc-relax)

与模板 2 相同,将 calculation = 'vc-relax',并添加:

1
2
3
4
5
&CELL
cell_dynamics = 'bfgs'
press = 0.0
press_conv_thr = 0.5
/

模板 4:非自洽能带计算(nscf → bands)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
! 第 1 步:nscf — 在密 k 点上计算波函数
&CONTROL
calculation = 'nscf'
prefix = 'si'
outdir = './tmp'
pseudo_dir = './pseudo'
/
&SYSTEM
ibrav = 0
nat = 2
ntyp = 1
ecutwfc = 60.0
ecutrho = 480.0
nbnd = 12 ! 多取几条空带
occupations = 'tetrahedra'
/
&ELECTRONS
conv_thr = 1.0d-9
/
K_POINTS {automatic}
10 10 10 0 0 0
...
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
! 第 2 步:bands — 沿高对称路径
&CONTROL
calculation = 'bands'
prefix = 'si'
outdir = './tmp'
pseudo_dir = './pseudo'
/
...
K_POINTS {crystal_b}
6
0.500 0.000 0.500 20 ! L → Γ
0.000 0.000 0.000 20 ! Γ → L
0.500 0.000 0.500 20 ! L → W
0.500 0.250 0.750 20 ! W → K
0.375 0.375 0.750 20 ! K → Γ
0.000 0.000 0.000 0 ! Γ (终点)

模板 5:自旋极化铁磁计算

1
2
3
4
5
6
7
8
9
&SYSTEM
nspin = 2
starting_magnetization(1) = 0.6
starting_magnetization(2) = 0.0
tot_magnetization = 4.0
occupations = 'smearing'
smearing = 'mp'
degauss = 0.02
/

模板 6:SOC(自旋轨道耦合)计算

1
2
3
4
5
&SYSTEM
noncolin = .true.
lspinorb = .true.
! 使用全相对论赝势 (含 -fr- 或 -sr- 标记)
/

模板 7:2D 材料(slab + 真空层)

1
2
3
4
5
6
7
8
9
10
11
&SYSTEM
ibrav = 0
assume_isolated = '2D' ! 消除层间假相互作用
vdw_corr = 'grimme-d3'
ecutwfc = 60.0
/
...
CELL_PARAMETERS {angstrom}
5.000 0.000 0.000
0.000 5.000 0.000
0.000 0.000 25.000 ! z 方向至少 15-20 Å 真空层

14. 能带后处理(bands.x / plotband.x)

QE 的 pw.x 只输出各 k 点上的本征值,不画图。能带后处理分两步完成。

工作流

1
2
3
4
5
scf     → 获得电荷密度
nscf → 在密 k 网格上计算波函数
bands → 沿高对称路径计算本征值
bands.x → 提取、排序、对称化能带数据
plotband.x → 转换为可直接画图的数据文件

bands.x 和 plotband.x 都是 QE 自带的后处理工具,不需要单独安装。


14.1 bands.x — 提取与整理能带

功能

  • 从 pw.x 的 bands 计算输出中读取本征值
  • 自动按能带交叉追踪(band crossing tracking)
  • 对称性分析,确定每个高对称点的标签
  • 输出 bandx.dat(结构化能带数据)和 gnuplot 脚本

输入文件

1
2
3
4
5
6
7
&INPUT_BANDS
prefix = 'my_calc' ! 与 pw.x 的 prefix 一致
outdir = './tmp' ! 与 pw.x 的 outdir 一致
filband = 'bands.dat' ! 输出文件名
lsym = .true. ! 使用对称性分析
lsigma = 3 ! 展宽 (cm⁻¹),选填,与 plotband.x 冲突时该处设置
/
参数 含义 默认值
prefix 与 pw.x 一致的输出前缀 —
outdir 临时文件目录 './'
filband 输出文件名 'bands.out'
lsym 是否使用对称性确定高对称点标签 .true.
spin_component 自旋通道:1=自旋上, 2=自旋下(nspin=2 时) 0(两个)
lsigma 能带展宽,输出到 filband 的第 4 列 无

运行

1
bands.x < bands.in > bands.out

输出

文件 内容
filband (如 bands.dat) 能带数据,供 plotband.x 使用
bands.out 高对称点坐标、对称性信息等

14.2 plotband.x — 转换为画图格式

功能

将 bands.x 的输出转换为紧凑的 x-y 数据格式,同时输出高对称点位置。

交互式输入

1
plotband.x

运行时依次提示:

1
2
3
4
Input file > bands.dat          # bands.x 的输出
Reading 16 bands
Emin, Emax > -10 10 # 能量范围 (eV)
output file > band.ps # 输出 PostScript 文件名(或 band.eps)

也可以通过管道一行搞定:

1
2
3
echo "bands.dat
-10 10
band.eps" | plotband.x

或者生成纯数据文件(不画 PostScript):

1
2
3
4
echo "bands.dat
-10 10
band.eps
band.gnu" | plotband.x
输出文件 内容
band.eps PostScript 能带图
band.gnu 纯数值数据(x, y),可直接导入 Origin/matplotlib

14.3 完整示例:从 SCF 到能带图

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
# 1. SCF
pw.x < cu.scf.in > cu.scf.out

# 2. bands 计算(沿高对称路径)
pw.x < cu.band.in > cu.band.out

# 3. bands.x — 提取能带
cat > bands.in << 'EOF'
&INPUT_BANDS
prefix = 'cu'
outdir = './temp/'
filband = 'cu_bands.dat'
/
EOF
bands.x < bands.in > bands.out

# 4. plotband.x — 生成数据
echo "cu_bands.dat
-10 10
cu_band.eps
cu_band.gnu" | plotband.x

# 5. cu_band.gnu 可直接用 matplotlib 画图
python3 -c "
import numpy as np
import matplotlib.pyplot as plt
data = np.loadtxt('cu_band.gnu')
plt.plot(data[:,0], data[:,1], 'k-', lw=0.8)
plt.axhline(0, color='gray', ls='--')
plt.ylabel('Energy (eV)')
plt.savefig('cu_bands.png', dpi=150)
"

14.4 plotband.x 常见选项

1
plotband.x

交互提示中:

提示 含义 典型输入
Input file bands.x 的输出 bands.dat
Emin, Emax 能量范围 -5 5
output file 输出 PostScript 文件名(*.ps 或 *.eps) band.eps
第四行(可选) 额外输出纯数据文件名 band.gnu

15. 投影态密度与电荷分析(projwfc.x)

projwfc.x 将 Kohn-Sham 波函数投影到原子轨道上,计算投影态密度(PDOS)、Löwdin 电荷和原子轨道占据数。

工作流

1
2
3
pw.x (scf)       → 获得基态电荷密度和波函数
pw.x (nscf) → 在需要的 k 点上重新计算波函数(可选,投影精度取决于 k 点密度)
projwfc.x → 投影 + 输出 PDOS / 电荷

输入文件

1
2
3
4
5
6
7
8
9
10
11
&PROJWFC
prefix = 'my_calc' ! 与 pw.x nscf 的 prefix 一致
outdir = './tmp'
filproj = 'pdos.dat' ! PDOS 输出文件
ngauss = 0 ! 展宽类型:0=Gaussian, 1=Methfessel-Paxton
degauss = 0.02 ! 展宽 (Ry)
Emin = -10.0 ! 能量下限 (eV)
Emax = 10.0 ! 能量上限 (eV)
DeltaE = 0.05 ! 能量步长 (eV)
lsym = .true. ! 使用对称性合并等价原子
/
参数 含义 典型值
prefix / outdir 与 pw.x nscf 一致 —
filproj PDOS 数据输出文件名 'pdos.dat'
ngauss 展宽函数类型 0 (Gaussian, 常用)
degauss 展宽宽度 0.01-0.05 Ry
Emin / Emax 能量范围 需涵盖所有价带和部分导带
DeltaE 能量步长 0.01-0.05 eV
lsym 对称性合并等价原子 .true.(推荐,减少输出冗余)

运行

1
projwfc.x < projwfc.in > projwfc.out

输出文件

文件 内容
<filproj> (如 pdos.dat) 总 DOS + 每条轨道的投影 DOS
<prefix>.pdos_atm#N(X)_wfc#M(s) 第 N 个原子、第 M 条波函数的 PDOS 分量
projwfc.out Löwdin 电荷、总轨道占据数、磁矩

PDOS 数据格式

pdos.dat 的列结构(自旋非极化):

1
E(eV)   DOS   PDOS(atom1_s)  PDOS(atom1_p)  PDOS(atom1_d)  PDOS(atom2_s)  ...

自旋极化时:

1
E(eV)   DOS(up)  DOS(dw)  PDOS(atom1_s_up)  PDOS(atom1_s_dw)  ...

Löwdin 电荷分析

projwfc.out 中搜索 Lowdin charges:

1
2
Atom #   1: Lowdin charge =   3.8214
Atom # 2: Lowdin charge = 6.1786
输出项 含义
Lowdin charge Löwdin 布居分析的总电荷
Spin polarization 自旋极化体系的净磁矩

实用示例:MnO PDOS

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
! ====== pw.x nscf ======
&CONTROL
calculation = 'nscf'
prefix = 'mno'
outdir = './tmp'
pseudo_dir = './pseudo'
/
&SYSTEM
ibrav = 0
nat = 2; ntyp = 2
ecutwfc = 60.0; ecutrho = 480.0
nspin = 2
starting_magnetization(1) = 0.5
occupations = 'smearing'
degauss = 0.01
/
&ELECTRONS
conv_thr = 1.0d-10
/
K_POINTS {automatic}
12 12 12 0 0 0
...
1
2
3
4
5
6
7
8
9
10
11
! ====== projwfc.x ======
&PROJWFC
prefix = 'mno'
outdir = './tmp'
filproj = 'mno_pdos.dat'
ngauss = 0
degauss = 0.02
Emin = -10.0
Emax = 10.0
DeltaE = 0.05
/

参考文献

  1. P. Giannozzi et al., J. Phys.: Condens. Matter 21, 395502 (2009). — Quantum ESPRESSO 主要文献 (PWscf)
  2. P. Giannozzi et al., J. Phys.: Condens. Matter 29, 465901 (2017). — QE v6.0 更新
  3. Quantum ESPRESSO 官方文档: https://www.quantum-espresso.org/Doc/INPUT_PW.html
  4. G. Prandini et al., npj Comput. Mater. 4, 72 (2018). — SSSP 赝势库精度基准