Wannier90独立有效模型的能带与DOS实操
从明确给定的双轨道链哈密顿量开始,用个人兼容构建计算能带、倒空间能量梯度与DOS,比较完整与带权k点。
阅读本篇目录
已有明确的实空间紧束缚哈密顿量时,可以用Wannier90的effective_model路线做后处理,不必先做一次DFT或Wannier局域化。本篇以自己定义的双轨道链为例,在集群实际计算能带、倒空间能量梯度和DOS。
这是参数全部给出的教学模型,不是某种真实材料的DFT结果。随包提供针对4.0.3独立模型入口的个人兼容构建脚本;它只处理初始化兼容性,公共安装没有修改。
1.先下载、读取和画图#
下载独立有效模型实例包,解压进入wannier-effective-model:
bash read.sh
bash plot.sh
| 输出 | 内容 |
|---|---|
analysis/Wannier-effective-chain-bands.csv |
101个路径点、两个能带的原生能量与倒空间梯度,附解析公式结果 |
analysis/Wannier-effective-chain-DOS.csv |
两种k点采样的原生与解析DOS |
figures/Wannier-effective-model-chain-bands.png |
模型示意与实际能带 |
figures/Wannier-effective-model-DOS-derivative.png |
DOS与能量梯度 |
这两步使用随包保存的实际输出,不重新计算。

图中A/B位置仅示意两个基函数和跃迁关系,不是原子结构、Wannier轨道图或额外的位置矩阵数据。
2.重新运行的操作顺序#
bash prepare.sh
bash build.sh
bash run.sh
bash read.sh work-new analysis-new
bash plot.sh analysis-new figures-new
prepare.sh新建work-new,已有目录不会覆盖。build.sh加载wannier90/4.0.3-serial提供的编译环境,在自己的build中编译兼容程序;已有build时会保留。源码与GPL许可位于sources,兼容差异在effective-model-compatibility.patch。
环境为Wannier90 4.0.3、oneAPI 2024.2 ifx、AVX2串行版和MKL顺序版。构建与本篇小模型均采用单进程单线程。需要重新运行时,请在已申请的计算资源中执行。
只算一个目录时:
module load wannier90/4.0.3-serial
export OMP_NUM_THREADS=1
cd work-new/uniform40
../../build/postw90.x model
ls model_geninterp.dat model-dos.dat
不要将这里的本地兼容程序路径替换为公共postw90.x后,假定两者的独立模型入口完全一致。
3.模型怎样定义#
每个周期有A/B两个轨道,周期长度a=4 Å。A/B在位能分别为+0.3、−0.3 eV,胞内跃迁t1=1 eV,胞间跃迁t2=0.6 eV。
E±(q) = ±sqrt[0.3² + 1² + 0.6² + 2×1×0.6×cos(2πq)]
这里q为沿链的分数k坐标。这个公式用于独立读取和解释结果,原生程序仍从下面的实空间矩阵计算能级。
展开完整model_HH_R.dat
Own two-orbital dimerized chain: delta=.3,t1=1,t2=.6 eV
2
3
-1 0 0 1 1 0.000000 0.000000
-1 0 0 2 1 0.000000 0.000000
-1 0 0 1 2 0.600000 0.000000
-1 0 0 2 2 0.000000 0.000000
0 0 0 1 1 0.300000 0.000000
0 0 0 2 1 1.000000 0.000000
0 0 0 1 2 1.000000 0.000000
0 0 0 2 2 -0.300000 0.000000
1 0 0 1 1 0.000000 0.000000
1 0 0 2 1 0.600000 0.000000
1 0 0 1 2 0.000000 0.000000
1 0 0 2 2 0.000000 0.000000
文件前三行依次是说明、轨道数2、R向量数3;后续每行给出R的三个整数、两个轨道编号、矩阵元实部和虚部。同一R的矩阵元连续排列,并按该入口的定宽格式保存。
这是*_HH_R.dat输入,不是普通*_hr.dat简单换文件名。两种格式及权重约定应分别处理。
4.WIN和路径文件#
展开uniform40/model.win完整输入
num_wann=2
effective_model=true
use_ws_distance=false
fermi_energy=0
iprint=2
kmesh=40 1 1
dos=true
dos_energy_min=-2
dos_energy_max=2
dos_energy_step=.01
dos_adpt_smr=false
dos_smr_type=gauss
dos_smr_fixed_en_width=.05
geninterp=true
geninterp_alsofirstder=true
geninterp_single_file=true
wanint_kpoint_file=false
begin unit_cell_cart
4 0 0
0 10 0
0 0 10
end unit_cell_cart
dis_win_min=-10
dis_win_max=10
boltz_dos_energy_min=-2
boltz_dos_energy_max=2
kubo_freq_max=4
kubo_eigval_max=4
主要设置为:
effective_model=true
use_ws_distance=false
kmesh=40 1 1
dos=true
dos_adpt_smr=false
dos_smr_type=gauss
dos_smr_fixed_en_width=.05
geninterp=true
geninterp_alsofirstder=true
geninterp_single_file=true
model_geninterp.kpt指定从q=−0.5到+0.5共101点,并标明crystal分数坐标。可以先查看:
head -n 8 work-new/uniform40/model_geninterp.kpt
cat work-new/uniform40/model.win
随包的model.eig是0字节文件,只用于当前版本的参数入口兼容,不包含电子能级。实际能带全部来自model_HH_R.dat。WIN保留的部分未使用范围参数也用于版本兼容,不表示本例运行了BoltzWann或光学响应;使用配套脚本准备即可。
5.实际能带与梯度#
原生结果给出模型间隙1 eV,对应q=±0.5处的−0.5和+0.5 eV。能量与上面的解析公式最大差约4.90×10⁻¹⁰ eV。
model_geninterp.dat的列为点编号、三个笛卡尔k分量、能量、三个能量梯度。梯度是对笛卡尔倒空间坐标求导,因此单位为eV·Å,不是原子力的eV/Å。
head -n 9 work-new/uniform40/model_geninterp.dat
本例只有沿链的梯度非零;原生梯度与解析结果最大差约4.90×10⁻¹⁰ eV·Å。梯度曲线描述该能带的色散,不能直接当作原子受力。
6.完整40点与带权21点DOS#
uniform40使用完整40点。weighted21使用q=0至0.5的21个代表点:两个端点各权重1/40,其余各2/40,权重和为1。
head -n 8 work-new/weighted21/kpoint.dat
本模型的能量关于q正负对称,两种采样的DOS相同;不要据此对其他模型、Berry响应或自旋量直接套用同一套代表点与权重。

DOS能量范围−2至2 eV、步长0.01 eV,高斯宽度参数0.05 eV。这里的高斯形式为exp[-((E−ε)/η)²]/(η√π),η不是另一种标准差定义。
两个能带各有自旋简并2,因此DOS总积分约4.000000001个态。这是模型可用态总数,不表示模型里占据了四个电子。图中的小幅采样波纹也说明这是一组有限网格演示,未做材料DOS收敛研究。
7.换成自己的模型#
先明确轨道数、晶胞、R向量、矩阵元单位与厄米关系,再使用正确的HH_R格式。固定模型后,分别检查能带、k点采样与展宽,不能仅以程序生成文件判断模型合理。
本包还包含一份已有硅模型的普通DOS对照,用于确认兼容构建保留普通后处理路径;没有重新做该硅模型的DFT或局域化。
本篇只给出哈密顿量,没有AA位置矩阵和自旋算符,因此不据此计算或宣称光学、Berry及自旋响应。要扩展这些性质,必须先准备对应算符及匹配的模型约定。
参考:Wannier90参数与模型入口。