Wannier90专题

Wannier90检查点迁移:二进制与文本互转

实际运行w90chk2chk的导出、导入和重新导出,检查矩阵与中心保持一致,再用导入后的检查点运行postw90。

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

已经完成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

实际检查点矩阵、全部k点酉性误差及导入后结果

读取脚本检查实/倒格矢的对偶关系、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数目或投影后,不要继续沿用不匹配的旧检查点。

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

查看配图

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

100%查看原图 ↗