QE专题

QE:Si的KCW与Wannier操作流程

用Si原胞演示自洽、占据与空态Wannier化及KCW接口,附完整输入和提交脚本。

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

1. 这条流程解决什么问题#

KCW是Quantum ESPRESSO的Koopmans谱学功能。本例从PBE自洽结果出发,分别构造占据与空态Wannier轨道,计算轨道屏蔽系数,再构建KI哈密顿量和能带。它不是给普通PBE能带统一加一个固定剪刀差。

使用两个Si原子的金刚石原胞,PBE ONCV赝势、40/160 Ry截断、完整2×2×2网格、20条能带。这是小规模操作参考,不是Si带隙的收敛预测。

下载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. 先准备自己的计算目录#

bash prepare.sh
ls work-new
cat job.slurm

准备脚本下载指定版本的Si赝势并核对SHA256;若已经有同一文件,可用 bash prepare.sh /自己的赝势目录。赝势和波函数不在下载包中。work-new 只创建一次;已有目录时会停止,避免覆盖计算。

输入里的 @WORK_TMP@ 与 @PSEUDO_DIR@ 是模板标记,准备后已换成自己的绝对路径,不需要手工填写。

3. 自洽:晶胞、原子位置与完整k网格#

完整 inputs/Si.scf.in:

&CONTROL
  calculation='scf'
  restart_mode='from_scratch',
  prefix='Si'
  outdir='@WORK_TMP@/'
  pseudo_dir = '@PSEUDO_DIR@/'
  verbosity='high'
 /
&SYSTEM
  ibrav=2,
  celldm(1)=10.263101844
  nat= 2, ntyp= 1,
  ecutwfc = 40.0, ecutrho=160.0, nosym=.true.,
  nbnd=20
  nspin = 2
  tot_magnetization = 0.0
/
&ELECTRONS
  diagonalization='david'
  mixing_mode = 'plain'
  mixing_beta = 0.7
  conv_thr =  1.0d-10
/
ATOMIC_SPECIES
Si 28.085 Si_ONCV_PBE-1.0.upf

ATOMIC_POSITIONS crystal
Si 0.00 0.00 0.00
Si 0.25 0.25 0.25

K_POINTS crystal
8
  0.00000000  0.00000000  0.00000000  1.250000e-01
  0.00000000  0.00000000  0.50000000  1.250000e-01
  0.00000000  0.50000000  0.00000000  1.250000e-01
  0.00000000  0.50000000  0.50000000  1.250000e-01
  0.50000000  0.00000000  0.00000000  1.250000e-01
  0.50000000  0.00000000  0.50000000  1.250000e-01
  0.50000000  0.50000000  0.00000000  1.250000e-01
  0.50000000  0.50000000  0.50000000  1.250000e-01

ibrav=2 是面心立方原胞;celldm(1) 是以Bohr计的常规立方晶格常数。ATOMIC_POSITIONS crystal 是相对原胞矢量的分数坐标,不能把原胞矢量当成三条相互垂直的立方边。

这里关闭对称性,显式提供8个等权k点,保证Wannier接口使用完整规则网格。也可以先用对称性做SCF,再单独做完整网格NSCF,但不能把约化网格直接交给需要完整网格的下一步。nspin=2、总磁矩0,本例取自旋向上通道构造4个占据及4个空态轨道,体系仍是非磁性Si。

以下手动命令均在已分配的4核CPU作业资源中执行;直接完整运行请看第6节。

cd work-new
mpirun -np 4 pw.x -in Si.scf.in > scf.out
grep "convergence has been achieved" scf.out

4. 占据态与空态分别Wannier化#

占据态取4条带;空态排除1–4号占据带,从剩余16条带中解缠出4个Wannier轨道。两套完整 .win 和接口输入都在资料包里。

cd wann_occ
wannier90.x -pp Si
mpirun -np 4 pw2wannier90.x < Si.pw2wann.in > interface.out
wannier90.x Si > wannier.out
cd ../wann_emp
wannier90.x -pp Si_emp
mpirun -np 4 pw2wannier90.x < Si_emp.pw2wann.in > interface.out
wannier90.x Si_emp > wannier.out
cd ..

空态完整输入如下。冻结窗和外窗的数值是本例实际使用的值,参考能量是接口输出的本征值能标,不能随意当成相对费米能:

num_bands         =   16
num_wann          =   4
exclude_bands     =  1-4
spin              = up
use_ws_distance   = .true.

dis_froz_max = 9.2
dis_win_max = 20.0

conv_window = 5
conv_tol = 1D-10
conv_noise_amp = 10000
conv_noise_num = 5

write_hr = .true.
write_xyz = .true.
write_u_matrices = .true.

bands_plot              = .true.
bands_num_points        = 40
begin kpoint_path
G 0.000 0.000 0.000  X 0.500 0.000 0.500
X 0.500 0.000 0.500  U 0.625 0.250 0.625
K 0.375 0.375 0.750  G 0.000 0.000 0.000
G 0.000 0.000 0.000  L 0.500 0.500 0.500
L 0.500 0.500 0.500  W 0.500 0.250 0.750
W 0.500 0.250 0.750  U 0.500 0.000 0.500
end kpoint_path

num_iter          = 1000
num_print_cycles  = 10

Begin Atoms_Frac
 Si 0.00 0.00 0.00
 Si 0.25 0.25 0.25
End Atoms_Frac

Begin Projections
f = 0.250, 0.250, 0.250 : sp3
End Projections

begin unit_cell_cart
bohr
-5.131550922  0.00000 5.131550922
 0.00000  5.131550922 5.131550922
-5.131550922  5.131550922 0.00000
end unit_cell_cart

mp_grid      = 2 2 2

begin kpoints
  0.00000000  0.00000000  0.00000000
  0.00000000  0.00000000  0.50000000
  0.00000000  0.50000000  0.00000000
  0.00000000  0.50000000  0.50000000
  0.50000000  0.00000000  0.00000000
  0.50000000  0.00000000  0.50000000
  0.50000000  0.50000000  0.00000000
  0.50000000  0.50000000  0.50000000
end kpoints

num_bands=16 指排除占据带后交给解缠的带数,num_wann=4 是最终轨道数。dis_froz_max=9.2、dis_win_max=20.0 均为eV。移植到其他材料时,应先检查实际带能范围与插值能带,不能只复制两个窗口值。只看到程序正常结束,不足以判断子空间是否合适。

实际Si原子与占据、空态Wannier中心

5. 将Wannier矩阵交给KCW#

在 work-new 中建立接口文件链接:

ln -s wann_occ/Si_u.mat Si_u.mat
ln -s wann_emp/Si_emp_u.mat Si_emp_u.mat
ln -s wann_emp/Si_emp_u_dis.mat Si_emp_u_dis.mat
ln -s wann_occ/Si_centres.xyz Si_centres.xyz
ln -s wann_emp/Si_emp_centres.xyz Si_emp_centres.xyz
mpirun -np 4 kcw.x -in Si.kcw-wann2kcw.in > wann2kcw.out
W2K Silicon
&control
  prefix='Si'
  outdir='@WORK_TMP@/'
  kcw_iverbosity = 2
  kcw_at_ks=.false.
  read_unitary_matrix = .true.
  calculation = 'wann2kcw'
  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.
/

num_wann_occ、num_wann_emp、have_empty 和 has_disentangle 必须与前面的两套Wannier结果一致。不要混用不同结构、k网格或窗口的矩阵与波函数。

6. 一次提交完整流程#

如果不需要手动逐步执行,从准备好的资料包根目录提交:

sbatch --chdir="$PWD" job.slurm
# 作业结束后
bash read.sh work-new analysis-new
bash plot.sh analysis-new

job.slurm 自动依次执行SCF、两套Wannier化、wann2kcw、屏蔽计算和KI能带,遇到非零退出码停止;不要同时手动运行同一目录。下一篇解释屏蔽系数、KI能带和HR文件。流程来源:QE固定版本KCW示例。

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

查看配图

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

100%查看原图 ↗