Wannier90专题

Wannier90带权k点与DOS实操

用同一硅Wannier模型比较内建512点、显式512点和反演合并260点的DOS,演示kpoint.dat、权重归一、重算与画图,并说明约化前为什么要检查实际模型。

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

Wannier90的postw90.x不仅能生成均匀积分网格,也能读取用户给定的k点与权重文件。本篇用已有硅八Wannier轨道模型,演示怎样准备点表、运行DOS、比较结果,以及为什么不能仅凭“这个晶体有反演对称性”就直接删掉一半k点。

这里复用已有4×4×4前置网格得到的模型,新做三组DOS积分,没有重新运行DFT或Wannier局域化。本篇讲采样与读数,不是硅DOS的网格收敛研究。

1.先读取配套结果#

下载带权k点DOS实例包,解压后进入wannier-weighted-kpoints:

bash read.sh
bash plot.sh

会生成两份CSV和两张图:

文件 内容
analysis/Wannier-weighted-DOS.csv 三套原生DOS、独立重建曲线及差值
analysis/Wannier-inversion-weights.csv 260个代表点、权重、配对数与实际能量差
figures/Wannier-weighted-DOS.png DOS与两条差值曲线
figures/Wannier-weighted-kpoints.png 代表点分布与E(k)−E(−k)差异

完整网格、完整带权点表和260点近似的DOS

完整512点表与内建512网格在原生输出精度下完全一致。260点近似曲线肉眼接近,但差值并不为零;下图把差异单独画出来。

2.重新执行的步骤#

bash prepare.sh
bash run.sh
bash read.sh work-new analysis-new
bash plot.sh analysis-new figures-new

prepare.sh复制三套输入到新的work-new,已有目录时不会覆盖。run.sh使用wannier90/4.0.3-serial,先将文本格式检查点导入当前平台,再运行三组postw90.x。它不调用DFT程序,也不重新局域化。

当前环境为Wannier90 4.0.3串行AVX2版,oneAPI 2024.2 ifx、MKL sequential,单MPI、单线程。真实生产任务在已申请的Slurm计算资源中运行。

若想逐条操作,进入其中一个新目录:

module load wannier90/4.0.3-serial
export OMP_NUM_THREADS=1
cd work-new/explicit512
w90chk2chk.x -import silicon
postw90.x silicon

输入里的种子名是silicon,所以程序读取silicon.win、silicon.eig和导入得到的silicon.chk。实例包提供可移植的silicon.chk.fmt,不包含平台相关的二进制检查点。

3.三种采样分别做什么#

目录 点数 积分方式 本例用途
uniform512 512 程序内建8×8×8均匀网格 对照
explicit512 512 kpoint.dat列出完整网格,每点1/512,并改变行序 验证显式点表的正确读入
weighted260 260 k与−k配对,代表点权重为1/512或2/512 观察约化近似与完整结果的差异

这些是后处理积分网格。它们不同于输入中的mp_grid=4 4 4:后者描述这个已有Wannier模型的前置数据网格。不能将8×8×8后处理写成“已经完成8×8×8 DFT”。

三种情况使用完全相同的哈密顿量、能量范围、步长和展宽,比较时只改变积分点的来源。

4.设置DOS和点表开关#

关键部分如下:

dos=true
dos_task=dos_plot
dos_energy_min=-40
dos_energy_max=40
dos_energy_step=.02
dos_smr_type=gauss
num_elec_per_state=2
dos_kmesh=8 8 8
dos_adpt_smr=false
dos_smr_fixed_en_width=.1
wanint_kpoint_file=true

wanint_kpoint_file=true选择点表。文件名固定为**kpoint.dat**,不是silicon.kpoint.dat。设为false时,本例使用dos_kmesh生成完整网格。

dos_adpt_smr=false配合固定宽度0.1 eV,使三条曲线的展宽保持一致。这里高斯核采用exp[-((E−ε)/η)²]/(η√π),η=0.1 eV;不要直接把η当作正态分布的标准差σ。

num_elec_per_state=2表示每条带的自旋简并权重。本例8个轨道,在足够宽的能量范围积分后总态数约16;它不是“硅有16个价电子”的说法。

展开显式512点算例的完整 silicon.win
num_bands         =   12
num_wann          =   8

use_ws_distance = .false. ! "Old" interpolation method
search_shells=12

geninterp = false
geninterp_alsofirstder = false

dis_win_max       = 17.0d0
dis_froz_max      =  6.4d0
dis_num_iter      =  120
dis_mix_ratio     = 1.d0
dis_conv_tol      = 1.0e-13

! Large number of interations need to get reproducible values
! 300 seems a good compromise with speed.
num_iter          = 300
num_print_cycles  = 10

Begin Atoms_Frac
Si  -0.25   0.75  -0.25
Si   0.00   0.00   0.00
End Atoms_Frac

Begin Projections
Si : sp3
End Projections

begin kpoint_path
L 0.50000  0.50000 0.5000 G 0.00000  0.00000 0.0000
G 0.00000  0.00000 0.0000 X 0.50000  0.00000 0.5000
X 0.50000 -0.50000 0.0000 K 0.37500 -0.37500 0.0000
K 0.37500 -0.37500 0.0000 G 0.00000  0.00000 0.0000
end kpoint_path


Begin Unit_Cell_Cart
-2.6988 0.0000 2.6988
 0.0000 2.6988 2.6988
-2.6988 2.6988 0.0000
End Unit_Cell_Cart


mp_grid      = 4 4 4


begin kpoints
0.0000  0.0000   0.0000
0.0000  0.2500   0.0000
0.0000  0.5000   0.0000
0.0000  0.7500   0.0000
0.2500  0.0000   0.0000
0.2500  0.2500   0.0000
0.2500  0.5000   0.0000
0.2500  0.7500   0.0000
0.5000  0.0000   0.0000
0.5000  0.2500   0.0000
0.5000  0.5000   0.0000
0.5000  0.7500   0.0000
0.7500  0.0000   0.0000
0.7500  0.2500   0.0000
0.7500  0.5000   0.0000
0.7500  0.7500   0.0000
0.0000  0.0000   0.2500
0.0000  0.2500   0.2500
0.0000  0.5000   0.2500
0.0000  0.7500   0.2500
0.2500  0.0000   0.2500
0.2500  0.2500   0.2500
0.2500  0.5000   0.2500
0.2500  0.7500   0.2500
0.5000  0.0000   0.2500
0.5000  0.2500   0.2500
0.5000  0.5000   0.2500
0.5000  0.7500   0.2500
0.7500  0.0000   0.2500
0.7500  0.2500   0.2500
0.7500  0.5000   0.2500
0.7500  0.7500   0.2500
0.0000  0.0000   0.5000
0.0000  0.2500   0.5000
0.0000  0.5000   0.5000
0.0000  0.7500   0.5000
0.2500  0.0000   0.5000
0.2500  0.2500   0.5000
0.2500  0.5000   0.5000
0.2500  0.7500   0.5000
0.5000  0.0000   0.5000
0.5000  0.2500   0.5000
0.5000  0.5000   0.5000
0.5000  0.7500   0.5000
0.7500  0.0000   0.5000
0.7500  0.2500   0.5000
0.7500  0.5000   0.5000
0.7500  0.7500   0.5000
0.0000  0.0000   0.7500
0.0000  0.2500   0.7500
0.0000  0.5000   0.7500
0.0000  0.7500   0.7500
0.2500  0.0000   0.7500
0.2500  0.2500   0.7500
0.2500  0.5000   0.7500
0.2500  0.7500   0.7500
0.5000  0.0000   0.7500
0.5000  0.2500   0.7500
0.5000  0.5000   0.7500
0.5000  0.7500   0.7500
0.7500  0.0000   0.7500
0.7500  0.2500   0.7500
0.7500  0.5000   0.7500
0.7500  0.7500   0.7500
End Kpoints







dos=true
dos_task=dos_plot
dos_energy_min=-40
dos_energy_max=40
dos_energy_step=.02
dos_smr_type=gauss

dos_kmesh=8 8 8
dos_adpt_smr=false
dos_smr_fixed_en_width=.1
wanint_kpoint_file=true

num_elec_per_state=2

5.kpoint.dat怎么写#

第一行是点数,后面每行依次为三项晶格分数坐标、一个积分权重。完整点表开头为:

512
0 0 0 0.001953125
0 0 0.25 0.001953125
0 0 0.5 0.001953125
0 0 0.75 0.001953125
0 0.125 0 0.001953125
0 0.125 0.25 0.001953125

512点时每点权重为1/512=0.001953125,全部权重之和为1。点的行序可以改变,但坐标、权重和覆盖范围应保持一致。

若希望自己生成与本例相同的完整点表,可在一个单独的新目录运行:

python3 - <<'PY'
from itertools import product
points = list(product(range(8), repeat=3))
points = points[::2] + points[1::2]
with open('kpoint.dat', 'w') as f:
    f.write('512\n')
    for i, j, k in points:
        f.write(f'{i/8:.17g} {j/8:.17g} {k/8:.17g} {1/512:.17g}\n')
PY

生成后检查:

head kpoint.dat
wc -l kpoint.dat

应有513行:一行点数加512行数据。配套输入已经包含点表,不需要再执行生成命令才能运行。

6.为什么260点不是严格相同的结果#

在8×8×8网格中,按取模后的k与−k配对,有8个点与自身配对,其余504个点组成252对。因此代表点共8+252=260:自身配对点的权重为1/512,其他代表点为2/512,总和仍为1。

但权重之和正确,只说明归一化正确。能否把一对点的贡献合到一个代表点,还取决于当前模型给出的被积函数是否确实相同。

260个代表点与实际Wannier模型的反演能量差

本例对当前有限网格模型逐点比较八条带,max|E(k)−E(−k)|约为3.1049403 meV。因此,按一个代表点替代整对点会带来小差异;本篇把260点结果作为近似对照,不称为严格等价的不可约布里渊区积分。

对比 原生DOS最大绝对差 / states·cell⁻¹·eV⁻¹
完整显式512点 − 内建512点 0,按当前输出精度
反演合并260点 − 内建512点 0.0012968

三套DOS在−40至40 eV积分得到的总态数均约16。总态数一致,也不能证明曲线处处一致。

研究自己的材料时,先检查当前Wannier模型的对称性、插值误差和目标响应的变换性质,再考虑减少积分点。这里观察到的数值差异不代表硅晶体本身失去反演对称性,也不能仅凭本例确定某一种构模误差的来源。

7.读取输出和迁移到自己的体系#

直接查看DOS:

head reference-results/explicit512/silicon-dos.dat
head analysis/Wannier-weighted-DOS.csv

原生DOS文件的两列分别为模型能量和DOS,横坐标沿用已有模型的能量零点,未额外移到本征费米能级。本例没有用两套不同能量零点的模型作比较。

替换自己的模型时,保持检查点、能量文件和silicon.win之间的轨道数、前置k网格及种子名一致;点表则按你的后处理目标生成。对不同精度的模型,不应只比较点数,应比较目标能区的曲线或积分量。

本例仅验证标量DOS的自定义带权点表。Berry、光学、自旋等响应还涉及额外算符及其对称变换;不能直接照搬这里的反演合并规则。也不要仅由512/260的点数比宣称运行加速比。

点表参数参考Wannier90官方参数说明。本文曲线、数值和图片来自配套的实际后处理。

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

查看配图

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

100%查看原图 ↗