QE专题

QE到Wannier90与Critic2:四个占据轨道的完整流程

从SiH₄的已有电荷出发,准备占据带、导出投影与重叠、生成局域轨道,并让Critic2正确读取检查点。

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

下载输入、已计算的波函数与结果、读取和绘图脚本(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,不能直接拿两个数字比较。

实际SiH₄结构、四个Wannier中心及占据子空间的变换权重

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

三个网格点的KS、Wannier和Critic2密度,以及四个轨道的实际展宽

自己新算完成后可读取同格式输出:

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网格收敛。

扩展阅读:Wannier90参数、Critic2波函数与检查点读取、官方离域指数流程及密度要求。

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

查看配图

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

100%查看原图 ↗