Wannier90能带移能:SHC参数与响应能量窗口
用六组实际postw90结果说明shc_bandshift的用法,比较默认与显式响应能量上限,提供完整模型文件、终端操作和数据图。
阅读本篇目录
使用 postw90.x 计算自旋霍尔电导 SHC 时,能带移能参数和响应能量窗口需要一起检查。本例展示如何设置移能起始带、移能大小,以及如何避免移能后的高能带意外落到默认响应窗口外。
下载六组输入、文本检查点、原生输出、数据与绘图程序。使用集群 wannier90/4.0.3;程序为 oneAPI 2024.2 ifx、MKL LP64 sequential 构建,AVX2 CPU,单进程单线程。
本例是实际运行的四带、自旋守恒紧束缚教学模型,不代表真实氢材料的第一性原理计算。模型和原生矩阵准备可参考四带自旋霍尔模型。输入中的 H 原子标签只用于满足文件格式;晶胞为3×3×10 Å,电导体积归一化包含所选10 Å厚度。
1. 先读已有结果#
保存下载包为 example.zip:
python3 -m zipfile -e example.zip .
cd wannier-SHC-bandshift
bash read.sh
bash plot.sh
cat analysis/Wannier90-SHC-bandshift-results.csv
reference-results 保存六组实际 model.wpout 和 model-shc-fermiscan.dat。analysis 输出参数、总 SHC,以及明确标注为独立模型积分函数的 k 网格数据;figures 输出两张图。
| 目录 | 移能范围 | 移能 / eV | 响应上限 / eV | 实际SHC / ((ħ/e) S/cm) |
|---|---|---|---|---|
| zero | 第3带及以上 | 0 | 3.6667,默认 | 387.17772 |
| conduction025 | 第3带及以上 | 0.25 | 3.6667,默认 | 386.84025 |
| conduction05 | 第3带及以上 | 0.5 | 3.6667,默认 | 386.55868 |
| conduction1 | 第3带及以上 | 1.0 | 3.6667,默认 | 397.50582 |
| conduction1-wide | 第3带及以上 | 1.0 | 10.0,显式 | 386.11571 |
| uniform05 | 第1带及以上 | 0.5 | 3.6667,默认 | 387.17772 |
这些数据使用61×61×1响应积分网格、费米能0 eV、固定展宽0.05 eV。展宽参数不等于电子温度。

上图左侧纵轴从380开始,用来显示数值细节。导带移能1 eV的默认窗口结果突然升高,需要先检查响应窗口,而不能直接解释成材料的物理趋势。
2. 这三个移能参数怎样填#
本例启用 Qiao 方法的 SHC,相关输入为:
berry = true
berry_task = shc
shc_method = qiao
spn_formatted = true
shc_freq_scan = false
shc_alpha = 1
shc_beta = 2
shc_gamma = 3
berry_kmesh = 61 61 1
berry_curv_adpt_kmesh = 1
fermi_energy = 0
kubo_adpt_smr = false
kubo_smr_fixed_en_width = 0.05
shc_bandshift = true
shc_bandshift_firstband = 3
shc_bandshift_energyshift = 1.0
shc_bandshift:是否启用这项 SHC 移能处理。shc_bandshift_firstband:从哪个带编号开始处理,本例四带中,第1、2带为占据带,第3、4带为未占据带。shc_bandshift_energyshift:增加到所选能带上的能量,单位 eV;本例为上移1 eV。
自己的模型不能直接照抄起始带3,应先检查所用能带、占据和 Wannier 子空间。改变移能后也要重新检查费米能对应的占据。本文均匀平移0.5 eV后费米能仍在带隙内,才得到相同的对照结果。
完整 model.win 还包含晶胞、投影、原始4×4×1矩阵网格及 k 点列表,均在附件中:
cat inputs/conduction1-wide/model.win
这里4×4×1是原始矩阵网格,61×61×1是后处理积分网格。提高后处理积分密度不能代替原始矩阵、窗口和模型本身的检查。
3. 为什么1eV移能要检查响应上限#
本例没有解缠和冻结窗口,原始矩阵能量最大值为3 eV;4.0.3对应默认规则给出的响应上限为:
3.0 + 0.6667 = 3.6667 eV
这是本例的默认值,不是所有材料都应该使用的常数。其它解缠或窗口设置应核对相应默认规则。
当导带上移1 eV后,部分导带能量超过3.6667 eV。原生 SHC 求和会排除涉及超过上限能带的跃迁;本例3721个积分 k 点中,有316个点的最高导带超过该上限。
如果目的是在本模型中保留全部移能后导带,应明确写入足够高的上限:
kubo_eigval_max = 10.0
这个上限与能带使用相同的能量零点,不能直接当成“相对费米能的窗口宽度”。10 eV只是本模型的宽窗口对照;实际材料应根据需要参与响应的能带范围选择,并继续检查结果对上限的依赖。

左图灰色区域表示最高导带被默认窗口排除的采样点,中图使用显式宽窗口;右图显示两种积分函数的差。被排除区域原本提供负贡献,因此排除后总 SHC 反而升高。图中分布来自独立模型按相同算法定义的计算,其网格平均与原生总响应一致,不是从原生总值拟合出来的图片。
4. 重做六个后处理实例#
资料包使用文本检查点,准备后由同版本工具导入成本地二进制检查点。先在已获得的 CPU 资源中执行:
module load wannier90/4.0.3
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 对每组先运行 w90chk2chk.x -import,再运行 postw90.x;全部采用单进程单线程。已有 work-new 或检查点时请保留旧结果,再从新副本开始,避免覆盖。
如果只想查看单组的原生操作,在加载同版本模块后:
cd work-new/conduction1-wide
w90chk2chk.x -import model
postw90.x model
cat model-shc-fermiscan.dat
上面两种方式任选一种,不要对已经由 run.sh 完成导入的目录再次重复导入。文本检查点的使用见检查点导出与导入教程。
5. 先核对参数,再看输出列#
grep -E 'shc_bandshift|kubo_eigval_max|berry_kmesh|fermi_energy' \
work-new/conduction1-wide/model.win
grep 'Using shc_bandshift' work-new/conduction1-wide/model.wpout
cat work-new/conduction1-wide/model-shc-fermiscan.dat
数据文件三列为序号、费米能/eV和 SHC/((ħ/e) S/cm)。本例只有费米能0这一点;若自己的任务扫描多个费米能,应逐行对应读取。
#No. Fermi energy(eV) SHC((hbar/e)*S/cm)
1 0.000000 0.38611571E+03
不要只看程序结束;同时确认移能起始带、移能大小、费米能、积分网格、展宽和响应上限都对应自己想比较的条件。对均匀移能、不同电子数或不同能量零点,也应重新判断占据的变化。
6. 适用范围与换成自己的材料#
使用材料数据时,需要自己的 eig/mmn/spn、匹配检查点和可靠 Wannier 模型。配套读取程序专门计算这个四带模型的独立参照,不适用于任意材料的数值判断;原生命令和参数组织方式可以参考。
这项处理不会重新计算 DFT 波函数,不能替代杂化泛函或 GW 计算。程序也会更新 SHC 算符构造中相关的粗网格能量矩阵,因此不要把已有 SHC 按一个能隙比例手工缩放。shc_bandshift 与非零 scissors_shift 不能同时启用。
参数行为可对照固定4.0.3版本的响应计算源码、算符构造源码和默认响应窗口读取规则。