WannierTools磁场Lanczos谱函数的读取与兼容运行
使用个人副本运行p/q=1/9小模型,读取原生谱函数,换算单位并区分连分式符号、Krylov精度和随机向量采样误差。
阅读本篇目录
下载完整输入、实际结果、个人构建补丁和绘图程序(ZIP)。本篇接磁场谱函数与Lanczos输出:公共2.7.0原版曾出现负谱值,本例使用个人目录中的匹配副本,把有限连分式尾部的展宽符号与其余递推保持一致。公共wt.x没有更新,不要混用程序。
1 先读现成结果#
解压进入wanniertools-Lanczos-causal:
bash read.sh
bash plot.sh
cat analysis/WT-Lanczos-causal-summary.csv
参考结果位于reference-results/one-flux,图片生成到analysis/figures。这些命令只读取已完成数据,不启动新计算。

本例为自定义一轨道方格模型,跃迁−1 eV、晶格常数3 Å,磁通p/q=1/9。三个路径点ky=0、0.25、0.5,每点实际运行4个随机初始向量、9步Lanczos;不是某种真实材料的拟合。每个向量的原生结果与同一向量的完整9×9矩阵的预解式比较,最大原始量差约2.7×10⁻¹²。
图中虚线是独立完整矩阵的归一化迹;实线是4个随机向量的估计。峰位相近、峰高有差异,主要说明少量随机向量不能代替迹收敛。按自己的资源逐步增大NumRandomConfs;每次在新目录运行,比较峰强及积分。随机初始向量没有固定种子,新运行不要求与本图逐点相同。
2 准备完整输入#
inputs/one-flux/wt.in:
&TB_FILE
Hrfile='model_hr.dat'
/
&CONTROL
LandauLevel_k_dos_calc=T
LandauLevel_wavefunction_calc=.FALSE.
/
&SYSTEM
NSLAB=9
NumOccupied=1
SOC=0
E_FERMI=0
/
&PARAMETERS
Magq=9
Magp=1
Nk1=3
Nk2=17
Nk3=1
OmegaNum=301
OmegaMin=-4.5
OmegaMax=4.5
Eta_Arc=0.05
NumLCZVecs=9
NumRandomConfs=4
/
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_hr.dat完整内容:
Owned one-orbital square yz model, t=1eV, a=3A; not fitted material
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
这是9维磁超胞的短例。对真实材料,NumLCZVecs应随矩阵大小、能量分辨率和谱收敛选择,不能机械照抄9。Eta_Arc=0.05为0.05 eV展宽;先保持同一展宽比较Krylov步数、随机向量数,再研究更窄谱峰。原生Tesla标注仍有旧版单位问题,本例用p/q描述磁通。
3 在自己的目录构建、提交#
集群中提交配套脚本:
sbatch run.slurm
模板申请56核CPU整节点,首次编译最多4个进程,原生程序为1个MPI进程、1个CPU线程。编译结果在资料包自己的private-build/bin/wt.x,计算结果在新建work-new/one-flux。脚本不覆盖已有构建或计算目录;已有结果请保留,换新的解压目录。
在已经分配到的兼容CPU资源中,也可分步操作:
bash build.sh
bash run.sh
bash read.sh work-new analysis-new
bash plot.sh analysis-new
使用当前安装的匹配WannierTools2.7.0源码、Intel oneAPI2023.2/ifort2021.10、Intel MPI2021.10、MKL LP64顺序库和ARPACK-NG3.9.1,CPU目标AVX512,不使用GPU。程序和模块保留在公共原处,补丁只用于个人副本。附件包含GPL许可和补丁,不附编译后的程序。
补丁还为这个单MPI流程保存lanczos_coefficients.dat,包含实际CSR矩阵、初始向量及Alpha/Beta,方便读取程序独立核对;它不改变原始模型或随机向量。大体系会增大诊断文件,本篇副本只用于这种短例核对。
4 输出单位怎样换算#
head -8 work-new/one-flux/LandauLevel_k_dos.dat
head -8 work-new/one-flux/lanczos_coefficients.dat
LandauLevel_k_dos.dat第三列虽然标为LDOS,这个分支实际写出随机向量平均的原始连分式虚部,不是选定某个原子的局域态密度。其能量参数内部用Hartree,第三列为1/Hartree,且未除π。转换为本例每状态、每eV的谱密度:
per_state_per_eV = native_raw / (27.211385 * numpy.pi)
本例有9个基函数,若需要整个磁超胞的总谱密度,再乘9。不要把一条归一化随机向量的谱当作已求和全部轨道的总DOS。这里−4.5到4.5 eV有限窗口积分约0.990;Lorentzian尾部延伸到窗口外,不要把有限窗口积分强制缩放到1后再宣称收敛。
5 为什么不能把负数直接取绝对值#

这张图是独立双位点数学反例,不是原生材料计算:矩阵非对角元为1、对角元为0,两个本征值为±1。有限连分式底部和上层必须使用一致的虚部符号;只在底部反号会产生负谱和错误峰形。取绝对值、删去负值或任意平移曲线都不能修复这个问题。
本篇个人副本的数值变更仅涉及有限尾部符号,不证明所有Lanczos分支或终止器均已修复。另一个零磁通参考条件在简并能级下,连分式与完整矩阵的原始量差约3.6×10⁻⁶,因此不作为本篇的完整矩阵一致性成功例。完整矩阵很小时可直接对角化作对照;大体系仍需分别检查递推精度和随机迹收敛。