WannierTools专题

WannierTools磁场HR格式转换与回读

将实际导出的磁场COO文件转成完整稠密Wannier90 HR,建立9基函数磁超胞输入,实际回读并核对36个指定点能级。

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

下载转换程序、完整稠密HR、输入和实际回读结果(ZIP)。本篇接独立兼容导出:先得到完整hr_mag.dat,再转换文件表示,最后用原生体能带指定点入口回读。这个步骤能直接发现单位、平移或文件头是否写错。

1 先看实际回读结果#

解压进入wanniertools-magnetic-HR-private:

bash read.sh
bash plot.sh
cat analysis/WT-magnetic-HR-export-validation.csv

两组磁通各两个指定k点的实际原生回读能级

两组共4个k点、36个能级,与独立Harper矩阵的最大差约5×10⁻¹¹ eV。横轴是能带编号,不是一条连续k路径。

2 稀疏与稠密文件头不同#

导出COO格式的头部依次是非零记录数36、基函数数9、R组数5;普通稠密Wannier90格式则先写基函数数9、R组数5,再给简并数和每组全部9×9矩阵元。不能只改一个Is_Sparse_Hr开关而保留原来的文件布局。

在资料包顶层复制一份实际导出结果并转换:

cp reference-results/one-flux/hr_mag.dat hr_mag.dat
python3 to_dense.py hr_mag.dat magnetic_dense_hr.dat
head -8 magnetic_dense_hr.dat

目标文件已存在时停止,避免覆盖。这个辅助程序匹配本篇兼容导出、简并数均为1的文件;不把它当作任意外部稀疏格式的通用转换器。

转换后每个R组都有81条记录,5组共405条,包括显式零矩阵元。新增的零不是额外物理相互作用,只是稠密表示需要完整矩阵。本例转换前后逐项傅里叶矩阵一致。

3 完整回读wt.in#

inputs/dense-reimport-one-flux/wt.in:

&TB_FILE
 Hrfile='magnetic_dense_hr.dat', Is_Sparse_Hr=F
/
&CONTROL
 BulkBand_points_calc=T
/
&SYSTEM
 NumOccupied=1, SOC=0, E_FERMI=0
/
&PARAMETERS
 Nk1=3,Nk2=3,Nk3=1
/
LATTICE
Angstrom
3 0 0
0 3 0
0 0 27
ATOM_POSITIONS
9
Direct
X 0 0 0.0000000000000000e+00
X 0 0 1.1111111111111110e-01
X 0 0 2.2222222222222221e-01
X 0 0 3.3333333333333331e-01
X 0 0 4.4444444444444442e-01
X 0 0 5.5555555555555558e-01
X 0 0 6.6666666666666663e-01
X 0 0 7.7777777777777779e-01
X 0 0 8.8888888888888884e-01
PROJECTORS
1 1 1 1 1 1 1 1 1
X s
X s
X s
X s
X s
X s
X s
X s
X s
KPOINTS_3D
2
Direct
0 .123 .217
0 .317 .431

原模型沿z复制9次后,磁超胞z晶格向量为27 Å;9个原子/轨道位置也按磁超胞分数坐标给出。不能把原来的3 Å晶胞和单轨道输入原封不动用于这个9基函数文件。

两个点以磁超胞倒格矢的分数坐标指定。路径或指定点的物理单位换算,应基于新的磁超胞,而不是原胞。

4 原生运行和读取#

在已经构建个人副本、且分配到CPU资源后,于资料包顶层准备独立目录:

source environment.sh
mkdir import-one
cp inputs/dense-reimport-one-flux/wt.in import-one/
cp magnetic_dense_hr.dat import-one/
cd import-one
../private-build/bin/wt.x > native.log
head -16 bulkek-pointsmode.dat

本篇用BulkBand_points_calc的稠密输入路径。当前2.7.0的这个指定点路径不能直接读取本例COO模型进行计算,先转换再回读;这不表示其他已支持的稀疏路径能带功能也不能用。

输出每个k点后列出能带编号和能量。后面的0–255列是程序写出的轨道图示权重,本篇核对能量,不把这些整数当作归一化概率。数值CSV中保留原生能量与独立矩阵能量,便于按band逐条查看。

5 一次完成导出、转换和回读#

直接用资料包的sbatch run.slurm即可按顺序完成:在个人目录构建副本,运行p=0/p=1两次导出,把两份HR分别转为稠密格式,随后完成两组指定点回读。每一步的文件保存在work-new/相应目录,不需要手动覆盖前一阶段。

本例采用自定义单轨道模型,不能据其能级给出实际材料的磁场响应或拓扑结论;它提供的是文件与计算流程的可操作参考。

在分配到的CPU资源中重做#

在资料包顶层提交:

sbatch run.slurm

模板按56核整节点规则申请资源,首次编译最多4个编译进程,原生计算使用一个MPI进程、一个CPU线程。入口在资料包自己的private-build/构建兼容程序,不修改公共安装;在新的work-new/运行,已有目录时停止。完成后:

bash read.sh work-new analysis-new
bash plot.sh work-new

基于安装的WannierTools2.7.0源码,编译器Intel oneAPI2023.2/ifort2021.10、Intel MPI2021.10、MKL LP64顺序库和ARPACK-NG3.9.1,采用AVX512 CPU目标。使用wanniertools/2.7.0-8173m模块提供编译环境,需要兼容CPU资源,不使用GPU。资料包附匹配补丁和GPL许可说明,不附二进制程序。

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

查看配图

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

100%查看原图 ↗