Wannier90检查点迁移:二进制与文本互转
实际运行w90chk2chk的导出、导入和重新导出,检查矩阵与中心保持一致,再用导入后的检查点运行postw90。
阅读本篇目录
已经完成Wannier化,想把结果移到另一台机器继续后处理,可以先把二进制seed.chk转换成可读的seed.chk.fmt,到目标机器再导入。Wannier90自带w90chk2chk.x,无需重新求DFT或重新局域化。
下载可读检查点、实际转换日志、矩阵读取与绘图脚本。使用Wannier90 4.0.3 AVX2 serial版,oneAPI2024.2 ifx、Intel MPI2021.13和MKL。这里只验证同版本文件转换,不据此保证不同Wannier90版本的格式一定兼容。
1. 最短的实际操作#
在原机器的计算目录:
module load wannier90/4.0.3
w90chk2chk.x -export seed
ls seed.chk.fmt
程序读取seed.chk,生成seed.chk.fmt。把文本检查点及所需的配套输入转移到目标工作目录,然后:
module load wannier90/4.0.3
w90chk2chk.x -import seed
ls seed.chk
postw90.x seed
seed是文件名前缀,不带.chk后缀。命令行中的动作在前、前缀在后;程序也接受-u2f和-f2u作为相应动作的别名。运行前备份目标目录里的旧检查点,避免导入时覆盖已有结果。
2. 本例实际做了什么#
本篇复用自建4带模型的自旋霍尔实例已有结果,依次执行:
# 三个独立目录,避免覆盖源文件
cd exported
w90chk2chk.x -export model
cd ../imported
w90chk2chk.x -import model
postw90.x model
cd ../reexported
w90chk2chk.x -export model
目录之间复制的是对应的model.chk或model.chk.fmt;下载包已经保留完整参考目录。该模型的.win里有H占位符,它只用于轨道/自旋记账,不是氢材料的DFT计算。用它来检查文件转换,是为了有一套可独立核对的小矩阵和后续结果。
| 实际内容 | 数值 |
|---|---|
| 能带数 / Wannier函数数 | 4 / 4 |
| k网格 / 总k点数 | 4×4×1 / 16 |
| 每个k点的邻居数 | 6 |
| 再次导出的文本检查点 | 与第一次导出逐字节相同 |
| 导入后postw90的SHC | 387.17772 (ℏ/e) S/cm |
导入后的SHC与原已完成结果一致。这个数值用于检查后续计算是否接上了相同数据,不是某种真实材料的预测值。
3. 看可读检查点里的内容#
unzip wannier-checkpoint-text-wave1182-*.zip
cd wannier-checkpoint-text
head reference-results/exported/model.chk.fmt
bash read.sh
bash plot.sh
cat analysis/Wannier-checkpoint-metadata.csv

读取脚本检查实/倒格矢的对偶关系、16个k点的U矩阵、每点6个邻居的M矩阵,以及4个Wannier中心与展宽。图中的矩阵不是示意占位数据,来自真实导出的文本。
二进制文件的SHA可能因读写布局等细节不同而变化。本例恢复的二进制与原文件并非逐字节相同,但重新导出的文本相同,矩阵及后处理结果一致。因此检查“是否保留科学内容”与检查“两个文件字节是否相同”应分别进行,不能只比较二进制SHA就下结论。
4. 在自己的目录重做导入#
bash prepare.sh
bash run.sh
cat work-new/model-shc-fermiscan.dat
准备脚本只复制文本输入;运行脚本导入检查点并做小规模postw90,不重新求DFT。参考包不包含二进制.chk、Wannier90软件或波函数;二进制检查点在自己的新目录中由工具生成。
读取参考数据和绘图不需要先导入。这样即使暂时没有计算资源,也能先查看文件内容与已有结果。
5. 迁移任务还要带哪些文件#
.chk.fmt保留检查点内容,但不是整个计算目录的替代品。至少保留对应的.win和该后处理所需数据;不同任务可能还需要.eig、.mmn、.spn以及其他矩阵或网格文件。必须来自同一套结构、轨道窗口、投影和Wannier函数设置。
目标环境加载相同版本后,先在新目录导入,再做一个已有小结果的对照,确认无误后开展新的后处理。修改能带窗口、Wannier数目或投影后,不要继续沿用不匹配的旧检查点。