Wannier90专题

Wannier90近邻壳层与重叠矩阵请求

在Si的4×4×4网格上实际运行自动壳层、shell_list、自定义kshell和显式nnkpts预处理,解释近邻数量、差分权重、B1条件及与MMN的关系。

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

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文件,不能同时写入同一个输入。

Si网格上实际导出的第一与第二壳层向量

实际输入 每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。

打印权重重建的B1张量与解析差分函数示意

图右另用解析函数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官方参数说明。

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

查看配图

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

100%查看原图 ↗