Wannier90近邻壳层与重叠矩阵请求
在Si的4×4×4网格上实际运行自动壳层、shell_list、自定义kshell和显式nnkpts预处理,解释近邻数量、差分权重、B1条件及与MMN的关系。
阅读本篇目录
Wannier90不仅需要一张k点网格,还需要知道每个k点连接哪些邻居,用于请求重叠矩阵并建立k空间差分。本篇用Si两原子原胞的4×4×4网格,实际比较五种输入方式。
这里只执行wannier90.x -pp预处理,没有重新运行DFT或Wannier局域化,不需要赝势、波函数或.amn/.mmn/.eig。结果是几何与重叠矩阵请求列表,不能据此声称插值能带已经收敛。
1.查看数据和图,再按需重新运行#
下载近邻壳层实例包,进入wannier-neighbor-shells:
bash read.sh
bash plot.sh
analysis/Wannier-neighbor-shells.csv比较邻居数量、权重与一致性;analysis/Wannier-neighbor-vectors.csv给出第一个k点的近邻向量。图片在figures/。
bash prepare.sh
bash run.sh
bash read.sh work-new analysis-new
bash plot.sh analysis-new figures-new
run.sh加载wannier90/4.0.3-serial,依次运行五组预处理,不重复电子结构或局域化。软件为Wannier90 4.0.3、oneAPI 2024.2 ifx、MKL顺序库、AVX2,单线程。已有work-new不会自动覆盖。
2.公共结构与网格输入#
五组输入使用相同的结构与k点:
num_wann=8
num_bands=12
mp_grid=4 4 4
search_shells=12
kmesh_tol=1.d-6
skip_B1_tests=.false.
iprint=3
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
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 kpoints ... end kpoints中的全部64个分数k点;实例包提供完整输入。mp_grid声明网格尺寸,不能替代这个显式列表。原胞向量单位为Å,k点坐标相对于原始倒格矢。
单独运行一个尚未计算的目录:
module load wannier90/4.0.3-serial
cd work-new/automatic
wannier90.x -pp silicon
读取silicon.wout中的壳层、权重和B1信息;读取silicon.nnkp中的k点、投影及nnkpts请求。如果已经执行bash run.sh,直接查看结果即可。
3.自动选择与shell_list指定壳层#
不填写shell_list时,程序自动寻找满足差分一致性的壳层。shell_list=1明确只使用第一壳层;shell_list=2明确只使用第二壳层。
shell_list=1
shell_list=2
这两个片段分别用于不同的.win文件,不能同时写入同一个输入。

| 实际输入 | 每k点邻居数 | 总请求数 | 近邻长度 / Å⁻¹ | 打印壳层权重 / Ų |
|---|---|---|---|---|
| 自动选择 | 8 | 512 | 0.50405718 | 1.4759500 |
| shell_list=1 | 8 | 512 | 0.50405718 | 1.4759500 |
| shell_list=2 | 6 | 384 | 0.58203510 | 1.4759500 |
| 自定义本例第一壳层 | 8 | 512 | 0.50405718 | 1.4759500 |
第一壳层沿立方体8个体对角方向,第二壳层沿6个坐标轴方向。壳层编号按邻居距离分组,不等于“再加几个k点”。search_shells=12是搜索范围,也不意味着最后一定使用12个壳层。
4.自定义.kshell文件#
在本例相同结构和网格上,kshell1/silicon.win使用:
kmesh_shell_from_file=.true.
同目录silicon.kshell只有一行:
1 2 3 4 5 6 7 8
每一行定义一个自选壳层,数字引用该网格搜索得到的b向量编号。这些1–8只针对本例,不能直接搬到不同晶格或网格。 运行后仍由程序计算权重并检查B1。本例自定义结果与自动第一壳层一致。
示例保持这份文件的简单单行格式。对于实际不规则或偶然简并的邻居问题,需要先确认自己的向量编号与分组,再使用自定义文件;不要把skip_B1_tests=.true.作为通用解决方法。num_shells属于旧兼容参数,新输入优先直接使用shell_list,对应4.0.3输入解析源码。
5.B1满足了,是否就代表数值一定更准确#
B1要求加权向量二阶矩为单位矩阵,即Σw bαbβ=δαβ,见4.0.3近邻网格源码。实例从.nnkp的分数k点与整数倒格矢重新构建向量,并用.wout打印权重核对全部64个k点。两种壳层都满足;受文本打印精度影响,重建的最大残差约1.8e-8。

图右另用解析函数f(q)=qx³作数学演示:它在原点的真实梯度为零,第一壳层差分残差约0.08469,第二壳层约0.33876。这不是材料能带或DFT计算数据,只是说明B1保证线性差分一致性,不保证任意高阶函数、材料网格或Wannier插值都已收敛。更远的壳层也不必然给出更小误差。
6.显式nnkpts:只指定要请求哪些重叠#
第五组使用预处理专用的显式邻居列表,实际再次导出与自动结果相同的512个请求。输入形式为:
postproc_setup=.true.
begin nnkpts
中间每行填5个整数:原k点编号、邻居k点编号、三个整数倒格矢分量,最后用end nnkpts结束。实例包的explicit-nnkpts/silicon.win包含完整512行,不需要手工输入。
这个输入块不带.nnkp输出中紧跟begin nnkpts的“每k点邻居数”那一行。它用于明确请求重叠,不应当作完整Wannier运行里替代差分壳层设置的通用入口;本例只确认列表的输入与导出,不把这个路径称作新的权重或局域化结果。
7.与后续DFT接口怎样衔接#
预处理生成.nnkp后,再由相应DFT接口按请求生成.mmn等文件。更改近邻、网格或晶格后,应重新运行接口生成匹配的重叠矩阵;不要把新.nnkp与旧邻居对应的.mmn混用。
这篇到预处理结束;真正的能带插值还需正确的电子结构、投影、能量窗口及局域化步骤。参数范围和输入格式见Wannier90官方参数说明。