注:内容为AI辅助生成并由本人进行校对,部分未校对的内容未必正确,后面会持续更新并校对。
目录
概述与基本结构
&CONTROL — 任务控制
&SYSTEM — 体系定义
HUBBARD — DFT+U 校正
&ELECTRONS — 电子自洽迭代
&IONS — 离子弛豫
&CELL — 晶格优化
K_POINTS — k 点设置
CELL_PARAMETERS — 晶格矢量
ATOMIC_SPECIES / ATOMIC_POSITIONS
极化与 Berry 相
赝势与交换关联泛函
典型输入文件模板
能带后处理(bands.x / plotband.x)
投影态密度与电荷分析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
取值
含义
'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
控制输出文件中的信息详细程度。
restart_mode
1 2 restart_mode = 'from_scratch'
tprnfor / tstress
1 2 tprnfor = .true. tstress = .true.
nstep
etot_conv_thr
3. &SYSTEM — 体系定义
晶格设置
ibrav — Bravais 晶格类型
常用 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
ecutwfc / ecutrho
1 2 ecutwfc = 60.0 ecutrho = 480.0
参数
含义
建议值
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' degauss = 0.01
occupations 取值
适用体系
'fixed'
绝缘体/半导体(默认,带隙明确)
'smearing'
金属/小带隙/总能计算
'tetrahedra'
态密度/能带后处理(不用于总能)
phonopy 声子计算 中使用 'smearing' + 适当 degauss 以避免金属体系的受力噪声。
nspin / noncolin / lspinorb
1 2 3 nspin = 1 noncolin = .false. lspinorb = .false.
场景
设置
非磁性半导体/金属
nspin = 1
铁磁/反铁磁
nspin = 2 + starting_magnetization(i)
非共线磁性 / SOC
noncolin = .true. + lspinorb = .true.(全相对论赝势)
starting_magnetization
1 2 starting_magnetization(1 ) = 0.5 starting_magnetization(2 ) = 0.0
仅当 nspin = 2 时有效。
tot_magnetization / tot_charge
1 2 tot_magnetization = 4.0 tot_charge = 0.0
nbnd
assume_isolated
范德华修正
1 2 3 4 5 vdw_corr = 'grimme-d2' 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} U Fe1-3 d 3.1 U Fe2-3 d 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-3 d 3.1 U Fe2-3 d 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-3 d 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-4 f 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-3 d 4.0 alpha Fe-3 d 1.0
常见问题
问题
原因
解决方法
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
场景
推荐值
常规 DFT
1.0d-8
精确受力(声子计算)
1.0d-10 或更紧
初始预收敛
1.0d-6
mixing_mode / mixing_beta
1 2 mixing_mode = 'plain' mixing_beta = 0.7
问题
调整方向
SCF 震荡/不收敛
减小 mixing_beta(如 0.3→0.1),改用 'local-TF'
SCF 收敛慢
增大 mixing_beta,或使用 mixing_ndim = 12
mixing_ndim
diagonalization
1 diagonalization = 'david'
electron_maxstep
startingpot / startingwfc
1 2 startingpot = 'atomic' startingwfc = 'atomic+random'
6. &IONS — 离子弛豫
仅在 calculation = 'relax' 或 'vc-relax' 时需要。
ion_dynamics
ion_positions
1 ion_positions = 'default'
upscale
bfgs_ndim
trust_radius_max / trust_radius_min
1 2 trust_radius_max = 0.8 trust_radius_min = 1.0d-4
ion_temperature
1 ion_temperature = 'not_controlled'
力收敛标准
场景
推荐 forc_conv_thr (Ry/Bohr)
常规弛豫
1.0d-4
声子计算前弛豫
1.0d-5 或更紧
7. &CELL — 晶格优化
仅在 calculation = 'vc-relax' 时需要。
cell_dynamics
press / press_conv_thr
1 2 press = 0.0 press_conv_thr = 0.5
cell_dofree
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 会破坏六方对称性。
仅 Γ 点
含义
适用场景
只计算 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 0.500 0.000 0.000 20 0.500 0.500 0.000 20 0.000 0.000 0.000 20 0.500 0.500 0.500 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} 5.430 0.000 0.000 0.000 5.430 0.000 0.000 0.000 5.430
行
含义
第一行
坐标类型标签(同 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 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} Fe 0.00 0.00 0.00 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. gdir = 3 nppstr = 6 /
参数
含义
典型值
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
工作流
1 2 3 4 5 pw.x < scf.in > scf.out pw.x < berry.in > berry.out
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 &CONTROL calculation = 'nscf' 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
输出
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 efield_cart(2 ) = 0.0 efield_cart(3 ) = 0.01 /
参数
含义
单位
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 ... / K_POINTS {automatic} 10 10 10 0 0 0
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 &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 &CONTROL calculation = 'bands' prefix = 'si' outdir = './tmp' pseudo_dir = './pseudo' / ... K_POINTS {crystal_b} 6 0.500 0.000 0.500 20 0.000 0.000 0.000 20 0.500 0.000 0.500 20 0.500 0.250 0.750 20 0.375 0.375 0.750 20 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. /
模板 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
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' outdir = './tmp' filband = 'bands.dat' lsym = .true. lsigma = 3 /
参数
含义
默认值
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 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 pw.x < cu.scf.in > cu.scf.out pw.x < cu.band.in > cu.band.out cat > bands.in << 'EOF' &INPUT_BANDS prefix = 'cu' outdir = './temp/' filband = 'cu_bands.dat' / EOF bands.x < bands.in > bands.out echo "cu_bands.dat -10 10 cu_band.eps cu_band.gnu" | plotband.xpython3 -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 常见选项
交互提示中:
提示
含义
典型输入
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' outdir = './tmp' filproj = 'pdos.dat' ngauss = 0 degauss = 0.02 Emin = -10.0 Emax = 10.0 DeltaE = 0.05 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 &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 prefix = 'mno' outdir = './tmp' filproj = 'mno_pdos.dat' ngauss = 0 degauss = 0.02 Emin = -10.0 Emax = 10.0 DeltaE = 0.05 /
参考文献
P. Giannozzi et al., J. Phys.: Condens. Matter 21 , 395502 (2009). — Quantum ESPRESSO 主要文献 (PWscf)
P. Giannozzi et al., J. Phys.: Condens. Matter 29 , 465901 (2017). — QE v6.0 更新
Quantum ESPRESSO 官方文档: https://www.quantum-espresso.org/Doc/INPUT_PW.html
G. Prandini et al., npj Comput. Mater. 4 , 72 (2018). — SSSP 赝势库精度基准