QE专题

QE:轨道屏蔽、KI能带与HR文件

提取实际响应、屏蔽参数和KI能带,说明负参数、路径差异及哈密顿量格式。

更新于 2026-11-15约 5 分钟阅读按任务与环境选择适用配置
阅读本篇目录

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. 如何读本次能带#

PBE-Wannier与KI各自原生路径的能带

结果 本次采样路径上的最小带隙/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;不要用后处理平移能带掩盖子空间问题。

需要根据你的体系选择资源?联系讨论计算需求。实际可用软件与权限,以当前账户和运行环境为准。

查看配图

放大后可滚动查看细节,按 Esc 关闭。

100%查看原图 ↗