QE到Wannier90与Critic2:四个占据轨道的完整流程
从SiH₄的已有电荷出发,准备占据带、导出投影与重叠、生成局域轨道,并让Critic2正确读取检查点。
阅读本篇目录
下载输入、已计算的波函数与结果、读取和绘图脚本(ZIP)。本例使用 QE 7.6、独立 Wannier90 4.0.3 和 Critic2 1.4.155。QE与Wannier90使用Intel oneAPI 2024.2 / ifx,QE配Intel MPI,Wannier90串行版配顺序MKL;这里每步只需一个CPU核心。
1 先看完整流程#
已有收敛电荷 → 四条占据带的NSCF → 导出PWC波函数 → 生成Wannier邻居列表 → 导出投影与重叠 → 局域化 → Critic2读取PWC和CHK。最后得到四个Si—H键附近的局域轨道、各轨道中心和展宽,以及可继续交给Critic2的波函数接口文件。
资料包同时带有已完成结果,先读结果可执行:
unzip qe-wannier-critic-wave1023-*.zip
cd qe-wannier-critic
bash read.sh
bash plot.sh
ls analysis figures
这两步读取实际输出、导出三个CSV并画图,不启动新的DFT。要从已有电荷自行重做本流程,再执行:
bash prepare.sh
sbatch run.slurm
prepare.sh创建独立的work-new/,复制电荷和输入并核对程序版本。两份匹配的赝势由使用者单独提供,资料包不包含赝势:可以把Si_ONCV_PBE-1.0.upf、H.pbe-vbc.UPF放在当前目录;未提供时脚本尝试从MODEL.json列出的原始地址下载并校验SHA-256。无法联网时先取得这两个文件再准备。重新准备前请保存或重命名已有的work-new/。
2 为什么本例只保留四条带#
SiH₄的赝价电子为8个,自旋非极化时四条占据带各容纳2个电子。这里的Critic2检查点接口要求PWC与Wannier90带数一致,而且不能包含解纠缠或排除带列表。因此本例实际重算了nbnd=4的NSCF,随后使用num_bands=4、num_wann=4,不设置exclude_bands。
八条DFT带中冻结四条占据带再做解纠缠,在Wannier90里能够局域化,但本例安装的Critic2会提示cannot handle disentangled wannier functions。仅把num_wann改成4不能解决PWC与CHK的带数匹配问题。这一限制针对这里的Critic2接口,不是说Wannier90不能做解纠缠。
已有电荷后使用的NSCF输入如下;晶胞、原子、赝势及截断必须与前置SCF匹配。
&control
calculation = 'nscf',
restart_mode='from_scratch',
prefix='SiH4',
tprnfor = .true.,
pseudo_dir = './pseudo/',
outdir='./tmp/'
/
&system
ibrav = 1,
celldm(1) = 20.0,
nat = 5,
ntyp = 2,
ecutwfc = 40.0,
ecutrho = 160.0,
nbnd = 4
/
&electrons
diagonalization = 'cg'
mixing_beta = 0.5,
conv_thr = 1.0d-8
/
ATOMIC_SPECIES
H 1.0 H.pbe-vbc.UPF
Si 28.0 Si_ONCV_PBE-1.0.upf
ATOMIC_POSITIONS {angstrom}
Si 0.000000000 0.000000000 0.000000000
H 0.861290004 0.861290004 0.861290004
H -0.861290004 -0.861290004 0.861290004
H -0.861290004 0.861290004 -0.861290004
H 0.861290004 -0.861290004 -0.861290004
K_POINTS crystal
1
0 0 0 1
这是一个20 bohr立方盒中的孤立分子教学例,40/160 Ry截断,显式复数Γ点。已有SCF电荷直接复用;conv_thr=1d-8控制这一步本征态求解,不表示重新做了一轮SCF。
3 准备Wannier90输入#
完整的inputs/SiH4.win:
num_bands = 4
num_wann = 4
mp_grid = 1 1 1
gamma_only = false
num_iter = 400
conv_window = 5
conv_tol = 1.0d-10
write_xyz = true
write_hr = true
write_tb = true
begin unit_cell_cart
bohr
20 0 0
0 20 0
0 0 20
end unit_cell_cart
begin atoms_cart
ang
Si 0 0 0
H .861290004 .861290004 .861290004
H -.861290004 -.861290004 .861290004
H -.861290004 .861290004 -.861290004
H .861290004 -.861290004 -.861290004
end atoms_cart
begin projections
Si:sp3
end projections
begin kpoints
0 0 0
end kpoints
Si:sp3提供四个初始投影;num_wann=4指定最终四个轨道。投影是初猜,最终中心和展宽由局域化给出。这里没有指定能量内外窗口,因为四条占据带全部保留,不做解纠缠。gamma_only=false与实际保存的复数Γ点波函数保持一致。
4 逐步执行与文件传递#
通常直接提交run.slurm即可。它调用run.py按以下顺序执行,各程序使用独立模块环境,避免两个模块重复初始化Intel运行库。以下命令用于理解每步在做什么,使用run.slurm后无需重复逐步运行。
cd work-new
# QE模块环境:四条占据带的NSCF
mpirun -np 1 pw.x < nscf.in > nscf.out
# QE模块环境:导出PWC
pw2critic.x < export.in > export.out
# Wannier90模块环境:生成SiH4.nnkp
wannier90.x -pp SiH4
# QE模块环境:读取nnkp,生成amn、mmn和eig
mpirun -np 1 pw2wannier90.x < interface.in > interface.out
# Wannier90模块环境:读取上述矩阵,生成CHK和局域轨道结果
wannier90.x SiH4
# Critic2模块环境:读取结构、PWC和CHK
critic2 < read.cri > critic.out
其中interface.in为:
&inputpp
prefix='SiH4'
outdir='./tmp/'
seedname='SiH4'
write_mmn=.true.
write_amn=.true.
write_unk=.false.
/
write_unk=false表示不额外输出实空间UNK轨道网格;生成中心、展宽和CHK不需要这份大文件。export.in为:
&inputpp
prefix='SiH4'
outdir='./tmp/'
seedname='SiH4'
smoothgrid=.false.
/
Critic2输入为:
units bohr
crystal SiH4.cif
load SiH4.pwc SiH4.chk
reference 1
point .037037037037037035 .037037037037037035 .037037037037037035
point .07407407407407407 .07407407407407407 .07407407407407407
point .037037037037037035 0 0
本例用独立的SiH4.cif提供原子种类、晶胞和坐标。QE 7.6的PWC元素标签长度与这里的Critic2结构读取器不一致,直接用crystal SiH4.pwc可能把Si显示为未知元素;独立CIF可避免这一结构标签问题,PWC中的波函数保持原样。CIF用Å记录晶胞,不同程序的bohr换算常数有末位差异,这里晶胞体积相对差约10⁻⁸。
POINT在晶体中输入的是分数坐标;units bohr不会把这三个坐标改成bohr。本例选取81³网格上的三个点,便于对照直接平面波求和密度。
5 看结果:轨道中心、展宽和密度#
rg -A6 'Final State' work-new/SiH4.wout
cat work-new/SiH4_centres.xyz
rg -A12 'Wannier functions information' work-new/critic.out
rg 'ERROR|Field number 1 is now REFERENCE' work-new/critic.out
本例四个中心约为(±0.662009, ±0.662009, ±0.662009) Å,符号组合分别朝向四条Si—H键;每个轨道展宽约0.936011 Ų,总展宽3.744042 Ų。Wannier90的展宽是二阶矩,单位Ų;Critic2在此处打印的是均方根展宽,约1.828265 bohr,不能直接拿两个数字比较。

轨道形状发生变化,总占据密度应保持一致。这里从原生CHK读取4×4复数变换矩阵,检查其正交性,并分别由KS态和Wannier态求密度;三个点处的密度差小于3×10⁻¹⁶ e/bohr³。Critic2读取后的密度与直接平面波求和值相差小于3×10⁻¹¹ e/bohr³。

自己新算完成后可读取同格式输出:
bash read.sh work-new analysis-new
bash plot.sh analysis-new
对应CSV为Wannier-SiH4-centres.csv、Wannier-SiH4-rotation.csv和Wannier-SiH4-density.csv。SiH4.chk保存轨道旋转,SiH4.pwc保存平面波态;两者必须来自相容的带数、k点、晶胞和自旋设置,不能随意混用不同计算目录里的文件。
6 使用边界与后续分析#
这里证明了占据子空间局域化及PWC+CHK的正确读取,未计算原子盆、Bader电荷或离域指数。8个电子是赝价电子数,不是SiH₄的18个全电子。继续做离域指数时,还要准备适合定义原子盆的参考密度、匹配网格并检查盆积分与周期性,不能把本例的赝密度直接称为全电子密度。孤立分子Γ点结果也不能代替晶体的k网格收敛。