Wannier90专题

Wannier90指定k空间区域解纠缠

复用硅12带、8Wannier轨道数据,实际比较Gamma球半径0.45和0.55 Å⁻¹,说明球内解纠缠、球外连续带选择、输入单位与结果提取。

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

如果只希望在某些k空间区域进行解纠缠,而在区域之外直接保留指定的一组连续能带,可使用Wannier90的dis_spheres设置。本篇从已有硅数据出发,实际运行两个球半径,演示改输入、运行、查看哪些点参与解纠缠、提取Wannier中心与spread。

使用12条前置能带、8个目标Wannier轨道、4×4×4共64个k点。复用已有amn/mmn/eig,没有新跑DFT;两组都重新执行了所需的解纠缠和局域化。

1.先看已有结果#

下载局部解纠缠实例包,进入wannier-disentanglement-spheres:

bash read.sh
bash plot.sh

得到两份CSV和两张图,不会重跑物理计算。

两个半径实际包含的k点与球外固定选择区域

两组球心都是Gamma。蓝色半径0.45 Å⁻¹只包含1个k点,橙色半径0.55 Å⁻¹包含9个。灰色点仍在前置网格中,没有被删除,只是采用球外指定的连续能带子空间。

目录 半径 / Å⁻¹ 球内k点 球外k点
gamma-only 0.45 1 63
gamma-neighbors 0.55 9 55

图按实际倒格矢把分数坐标差换成笛卡尔倒空间向量,采用程序所用的分数坐标最近整数折叠方式;没有把分数坐标距离直接当成Å⁻¹。

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,对两个半径依次执行:预处理、解纠缠与局域化、导出文本格式检查点。

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

也可进入其中一个新目录,逐条执行:

module load wannier90/4.0.3-serial
export OMP_NUM_THREADS=1
cd work-new/gamma-only
wannier90.x -pp silicon
wannier90.x silicon
w90chk2chk.x -export silicon

-pp生成邻居请求文件;本例已有与当前网格、投影和邻居设置匹配的amn/mmn/eig,因此不需要再次调用前置DFT接口。若改了前置k网格、邻居列表或投影,则应重新准备匹配数据,不能继续盲用旧矩阵。

3.添加球区域设置#

半径0.45的关键输入:

num_bands=12
num_wann=8

dis_spheres_num=1
dis_spheres_first_wann=1
begin dis_spheres
0 0 0 0.45
end dis_spheres

dis_spheres_num=1表示一个球。每行前三项为球心的晶格分数坐标,最后一项为半径,单位是Å⁻¹。

dis_spheres_first_wann=1表示球外从第1条带开始保留8条,即1至8。它不会要求球外也从12条带中自由优化选8条。若有exclude_bands,应先确认排除后的带编号;本例没有排除带。

把同一行最后的0.45改为0.55,球内点数变为9。这个数取决于当前倒格矢和离散网格;0.55不是“55%的布里渊区”,更不能把这里的1点或9点直接套给其他晶格。

4.能量窗口和迭代参数#

本例保留已有外窗口与内窗口:

dis_win_max=17.0
dis_froz_max=6.4
dis_num_iter=120
dis_mix_ratio=1.0
dis_conv_tol=1e-10
dis_conv_window=3
num_iter=300

能量单位为eV。球内按当前窗口进行解纠缠;球外使用指定连续带。本例球内活动窗口有11条带,目标维度仍为8。

两组实际满足了解纠缠的停止条件。随后Wannier局域化固定执行300步;这里展示这一组有限迭代操作结果,不据此证明找到了全局spread最小解。

完整输入包含原子、晶胞、投影、64个k点等,见下面折叠部分及实例包。

展开 gamma-only 的完整 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=1e-10

! 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

dis_spheres_num=1
dis_spheres_first_wann=1
dis_conv_window=3
begin dis_spheres
0 0 0 0.45
end dis_spheres
write_proj=true

5.检查输出与提取数据#

查看解纠缠停止信息和最终状态:

grep 'Disentanglement convergence criteria satisfied' reference-results/gamma-only/silicon.wout
grep -A 12 'Final State' reference-results/gamma-only/silicon.wout

配套提取命令:

bash read.sh
head analysis/Wannier-disentanglement-spheres.csv
head analysis/Wannier-sphere-centers.csv

第一份CSV逐k点列出分数坐标、到球心的倒空间距离、球内/球外标记和活动窗口维度;第二份保存8个Wannier轨道中心和spread。

本例还从实际格式化检查点核对球外子空间:它确实保留第1至8条带;在原始粗k点上的本征值与这些带一致,最大差小于7×10⁻¹³ eV。这说明球外选择按设定生效,不等于证明任意插值k点或所有高能导带都准确。

6.两组结果如何理解#

固定局域化步数后的spread与实际活动窗口维度

半径 / Å⁻¹ 球内点数 ΩI / Ų 最终总spread / Ų
0.45 1 13.21023839 20.30772951
0.55 9 13.00941411 19.92609412

扩大球后,更多点可以重新选择子空间,所以得到不同的Wannier函数和spread。**spread更小,不能单独作为材料能带插值更准确的证据。**真正研究目标能区时,还需比较原始能带、目标k路径或相应性质,并检查前置网格与窗口。

本例球外活动窗口维度固定为8;球内维度为11。两者都最终生成8个Wannier轨道,不应把“输入窗口包含11条带”误解为生成了11个Wannier轨道。

7.应用到自己的体系前先判断#

这种区域选择依赖球外那组连续带是否适合目标问题。若球外发生交叉或带序交换,应先检查带编号与轨道成分,避免把不连续的目标子空间固定下来。

保持球心、半径单位、外窗口和冻结窗口的定义清楚;多个球时每个球写一行,并使行数与dis_spheres_num一致。不要只通过不断增大半径追求更小spread,而忽略目标能区和子空间的连续性。

本篇复用小型硅前置数据,用于说明区域控制与终端流程,没有完成材料精度、网格收敛或最优半径研究。

参数参考Wannier90解纠缠参数说明。本文数据、检查点和图片来自配套的实际运行。

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

查看配图

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

100%查看原图 ↗