QE:轨道屏蔽、KI能带与HR文件
提取实际响应、屏蔽参数和KI能带,说明负参数、路径差异及哈密顿量格式。
阅读本篇目录
1. 前置文件与运行顺序#
先完成Si的SCF与两套Wannier接口,保留自洽目录、Wannier矩阵和wann2kcw结果。后续顺序为 screen → ham → 提取数据 → 绘图,不是直接把PBE输出文本改成KI能带。
下载Si的KCW完整输入、实际输出、CSV与绘图脚本,保存为 example.zip。先读取已有结果:
python3 -m zipfile -e example.zip .
cd qe-kcw-silicon
module load ase/3.29.0
bash read.sh
bash plot.sh
提取文件在 analysis-read,图片在 figures。读取和画图不会重新计算电子结构。实际计算使用集群QE 7.6 CPU版本,Intel oneAPI 2024.2、Intel MPI 2021.13、MKL;本例每项计算4个MPI进程、每进程1线程。
2. 计算轨道屏蔽系数#
完整 inputs/Si.kcw-screen.in:
KCW Silicon screen
&control
prefix='Si'
outdir='@WORK_TMP@/'
kcw_iverbosity = 2
kcw_at_ks=.false.
read_unitary_matrix = .true.
calculation = 'screen'
lrpa =.false.
mp1 = 2
mp2 = 2
mp3 = 2
/
&wannier
seedname = 'Si'
check_ks = .true.
num_wann_occ = 4
num_wann_emp = 4
have_empty = .true.
has_disentangle = .true.
/
&screen
tr2 =1.0d-18
nmix = 4
niter = 33
/
cd work-new
mpirun -np 4 kcw.x -in Si.kcw-screen.in > screen.out
grep -E "iwann|alpha|ddv_scf" screen.out | tail -20
tr2=1e-18 控制这里线性响应迭代的残差,不是SCF的 conv_thr。本例8个轨道、每轨道8个q点,共64项有效响应;最终残差最大9.113×10⁻¹⁹。
屏蔽系数由响应的relaxed/unrelaxed比值得到。实际4个占据轨道α约 0.281580,4个空态约 −0.13340。负值按原始输出保留,不能取绝对值、截成0或改成经验参数。这组粗q网格及空态子空间只用于演示流程;若用于材料结论,应检查轨道局域性、窗口、q网格和响应收敛,不能把这里的空态参数直接移植到其他计算。

若只修正了空态Wannier子空间而SCF和占据轨道完全不变,可用 &screen 的 i_orb=5 等选项分别重算对应轨道。本例只重新计算了5–8号轨道;资料包保留了每个q点的原始响应记录,提取脚本独立求和。通常新体系应直接运行完整screen,不要跨体系拼接α文件。
3. 构造KI哈密顿量并输出能带#
完整 inputs/Si.kcw-ham.in:
KI Silicon
&control
prefix='Si'
outdir='@WORK_TMP@'
kcw_iverbosity = 1
kcw_at_ks=.false.
homo_only = .false.
read_unitary_matrix = .true.
calculation = 'ham'
lrpa =.false.
mp1 = 2
mp2 = 2
mp3 = 2
/
&wannier
seedname = 'Si'
check_ks = .true.
num_wann_occ = 4
num_wann_emp = 4
have_empty = .true.
has_disentangle = .true.
/
&ham
do_bands = .true.
use_ws_distance = .true.
write_hr = .true.
on_site_only = .true.
/
K_POINTS crystal_b
8
0.000 0.000 0.000 10 ! GAMMA
0.500 0.000 0.500 10 ! X
0.625 0.250 0.625 1 ! U
0.375 0.375 0.750 10 ! K
0.000 0.000 0.000 10 ! GAMMA
0.500 0.500 0.500 10 ! L
0.500 0.250 0.750 10 ! W
0.500 0.000 0.500 1 ! U
mpirun -np 4 kcw.x -in Si.kcw-ham.in > ham.out
ls Si.kcw_bands.dat Si.kcw_hr*.dat
cd ..
bash read.sh work-new analysis-new
bash plot.sh analysis-new
on_site_only=.true. 是本例采用的近似,use_ws_distance=.true. 用于插值中的距离处理。write_hr=.true. 导出实空间哈密顿量;这几个设置都不能在介绍结果时省略。
4. 如何读本次能带#

| 结果 | 本次采样路径上的最小带隙/eV |
|---|---|
| PBE Wannier插值 | 0.2849354 |
| KI | 0.9755 |
数值是有限采样路径、粗网格和上述近似下的结果,不等于全布里渊区收敛带隙,也不是与实验的定量比较。两套原生文件的路径距离与采样不完全相同,其中KI包含U到K的连接;因此分面展示,保留各自原始能量,没有独立移动价带顶后再伪装成相同能标。
CSV bands.csv 保留方法、带号、原生路径坐标和eV能量;可自行选择统一路径重新计算,再做逐点比较。
5. HR文件不能直接当成标准Wannier90格式#
本例 Si.kcw_hr.dat 的第二行是 Rtot=8, num_wann=8 两个数字,后面为R向量、矩阵指标与复数矩阵元,单位eV;它没有标准Wannier90 HR文件的简并度表。不要只改文件名后交给默认的Wannier90读取器。
资料包脚本在原2×2×2规则网格上独立傅里叶检查厄米性,并核对Γ、X、L本征值。网格外插值还需要Wigner–Seitz距离处理,直接对这8个R求和不能代替KCW输出的整条能带。
head -5 reference-results/Si.kcw_hr.dat
head analysis-read/KI-mesh-eigenvalues.csv
head analysis-read/screening-parameters.csv
cat analysis-read/SUMMARY.json
若只查看已有结果,上述路径直接可用;对新计算将 reference-results 换成 work-new,analysis-read 换成 analysis-new。
6. 常见操作问题#
修改结构、晶格、k网格或赝势后,应从相应前置步骤重新生成数据,不能复用旧的屏蔽响应。修改绘图颜色或导出CSV只需运行 read.sh、plot.sh,不需要重新提交SCF。遇到空态插值跌入价带区,先检查解缠窗口与KS插值,再继续KI;不要用后处理平移能带掩盖子空间问题。