WannierTools磁场能带展开与选定能量谱
实际运行磁超胞专用展开分支,在5个路径点读取选定3个本征态的9种高斯展宽,说明磁通、展开权重、单位及局部谱范围。
阅读本篇目录
下载完整输入、真实展开数据、独立读取和绘图程序(ZIP)。本篇实际使用公共WannierTools2.7.0的Landaulevel_unfold_line_calc磁场分支;它会启用展开入口,还会建立磁超胞、扩展轨道索引,不能只改成普通BulkBand_unfold_line_calc就认为两者相同。
1 先看模型和结果#
解压进入wanniertools-magnetic-unfold:
bash read.sh
bash plot.sh
cat analysis/WT-magnetic-unfold-summary.csv
这些命令读取参考结果,不启动新计算,图片在analysis/figures。

本例为自定义方格yz模型:原胞晶格常数3 Å、一个s轨道、最近邻跃迁−1 eV,磁通p/q=1/9,磁超胞沿z复制9份、长27 Å。它不是某种真实材料的拟合。

本例只求最靠近0.123 eV的3个本征态,矩阵总共有9维;5个路径点共15个选定能级。图中的其余能级没有被计算到谱里,不能把没有颜色的区域当作真实能隙。
2 完整wt.in怎么写#
配套inputs/sparse-selected3/wt.in:
&TB_FILE
Hrfile='model_sparse_hr.dat'
Is_Sparse_Hr=T
/
&CONTROL
Landaulevel_unfold_line_calc=T
LandauLevel_wavefunction_calc=.FALSE.
/
&SYSTEM
NSLAB=9
NumOccupied=1
SOC=0
E_FERMI=0
/
&PARAMETERS
Magq=9
Magp=1
Nk1=5
Nk2=17
Nk3=1
OmegaNum=101
OmegaNum_unfold=201
NumSelectedEigenVals=3
E_arc=0.123
OmegaMin=-4.5
OmegaMax=4.5
Eta_Arc=0.05
/
LATTICE
Angstrom
3 0 0
0 3 0
0 0 3
ATOM_POSITIONS
1
Direct
X 0 0 0
PROJECTORS
1
X s
SURFACE
1 0 0
0 1 0
0 0 1
KPATH_BULK
1
G 0 0 0 Y 0 0.5 0
KPLANE_BULK
0 0 0
0 1 0
0 0 1
配套稀疏model_sparse_hr.dat完整内容:
Own one-orbital square yz sparse model, t=-1eV a=3A; not fitted material
5
1
5
1 1 1 1 1
0 0 0 1 1 0.000000000000 0.000000000000
0 1 0 1 1 -1.000000000000 0.000000000000
0 -1 0 1 1 -1.000000000000 0.000000000000
0 0 1 1 1 -1.000000000000 0.000000000000
0 0 -1 1 1 -1.000000000000 0.000000000000
注意这是稀疏格式:头部5为记录条数、1为原始轨道数、后一个5为R组数;不要拿普通致密Wannier90 HR的头部规则解释它。
Magq=9设磁超胞倍数,Magp=1设磁通分子。E_arc=0.123是选谱的中心,NumSelectedEigenVals=3通过ARPACK求中心附近的3个本征态,不等于只保留某3个原子轨道。换真实材料后应按实际能量窗口增加选态数并检查窗口覆盖;若只想完整磁场本征值,可先看磁场路径能带。
这里没有另设LATTICE_UNFOLD,默认展开参考晶胞就是原始3 Å晶胞。KPATH_BULK中的G—Y对应这个原胞的分数坐标ky=0到0.5,5个点分别为0、0.125、0.25、0.375、0.5。展开路径和磁超胞布里渊区的坐标不是同一个概念,不要把9倍超胞的z尺度直接写进原胞k路径。
3 自己提交一次#
在资料包顶层操作:
sbatch run.slurm
CPU模板按整节点规则申请56核,本例原生程序使用一个MPI进程、一个CPU线程。它调用公共wanniertools/2.7.0-8173m,不申请GPU,在新目录work-new/sparse-selected3运行;已有work-new时停止,避免覆盖之前结果。
在已经分配到的兼容CPU资源中,也可先bash run.sh。结束后读取自己的新结果:
bash read.sh work-new/sparse-selected3 analysis-new
bash plot.sh analysis-new
head -8 work-new/sparse-selected3/spectrum_unfold_kpath.dat
该构建使用Intel oneAPI2023.2/ifort2021.10、Intel MPI2021.10、MKL LP64顺序库与ARPACK-NG3.9.1,CPU AVX512目标。本篇直接使用公共原版,没有改源或构建个人补丁。
4 结果文件每列是什么#
spectrum_unfold_kpath.dat有11列:第1列为路径距离,第2列为eV能量,第3到11列为9种展宽的展开谱。这个分支使用高斯展宽,不是Lorentzian;当Eta_Arc=0.05 eV时,9列标准差分别为5、10、20、40、50、100、200、400、500 meV。
head -3 reference-results/sparse-selected3/spectrum_unfold_kpath.dat
cat data/WT-magnetic-unfold-selected-bands.csv
图中用50 meV列。能量网格步长约44.776 meV,5 meV窄峰可能落在网格之间,本例不把窄峰列用于积分或峰高判断。要研究更窄峰,应增加OmegaNum_unfold并比较能量网格收敛。
本版本按(OmegaMax-OmegaMin)/OmegaNum_unfold取步长,因此201点最后一个约4.455224 eV,不包含4.5 eV上端点。画图时用文件中的实际能量列。
原生谱列内部为1/Hartree,转为每eV要除以27.211385;配套读取程序已经换算。这里的高斯函数本身已含归一化因子,不要再照搬Lanczos虚部额外除π的规则。
5 展开权重不能强制归一成总DOS#
本例每个态的权重由磁超胞本征向量在原胞投影上叠加得到。对这里单轨道、kz=0条件,匹配程序的表达式为abs(sum(psi))**2/9**2,包含轨道组平均及原胞/磁超胞体积比。它不是每个磁超胞态都等于1的普通轨道权重。
3个选定态的权重和随ky约为0.02540到0.02198,50 meV曲线的有限窗口积分与它们一致。不能把曲线缩放到积分1后再当作绝对总DOS。实际原始谱的全部9045个数值与独立Harper矩阵、本征向量投影及高斯展开比较,最大差约5×10⁻⁹,数据和CSV已包含在包内。
真正的材料模型还需要正确的Wannier轨道中心、原胞与超胞原子对应、展开晶胞以及选态能量窗口;本例用于理解完整操作步骤和文件含义,不替代这些模型检查。