QE:Si的KCW与Wannier操作流程
用Si原胞演示自洽、占据与空态Wannier化及KCW接口,附完整输入和提交脚本。
阅读本篇目录
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。移植到其他材料时,应先检查实际带能范围与插值能带,不能只复制两个窗口值。只看到程序正常结束,不足以判断子空间是否合适。

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示例。