QE专题

QE 赝势格式转换:UPF2与XML

用集群实际生成并原子测试过的Si规范守恒赝势演示upfconv格式转换,说明文件、轨道半径和径向数据的检查方法。

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

upfconv.x 是QE附带的赝势工具。它可以把支持的输入格式转换为UPF v2或QE_PP XML,也可以导出径向数据。格式转换保留已有算符与数据,不会把一个赝势变成更适合目标材料的新赝势,也不会替代赝势生成和物性测试。

下载真实命令日志、转换摘要、径向数据、图片和脚本。本例使用QE 7.6 CPU版,主要编译环境为oneAPI 2024.2、Intel MPI 2021.13、MKL;单进程单线程,两个Si转换各约0.06–0.07秒,没有新增SCF。

1. 本例输入来自哪里#

Si输入是集群此前实际完成的PBE、Troullier–Martins规范守恒赝势,随后进行过基态、激发态和离子态原子测试。相关生成步骤见Si规范守恒赝势生成和原子组态与散射测试。它是教学输入,并不表示已通过各种晶体结构与性质的生产级验证。

项目 实际值
价电子数 4
径向网格点 1819
非局域投影子 1
赝原子波函数 2,3S与3P
3S轨道截断半径 2.4 bohr
3P轨道截断半径 2.37323226336714 bohr

实际Si径向波函数与转换保留的数组规模

图中的3S、3P是文件保存的径向赝波函数,不是三维电子密度。转换后两种格式的径向网格、局域势、原子价电子径向密度、投影子、波函数和D矩阵逐项保持一致;本例比较的数值数组最大绝对差为0。

2. 先读已有结果#

unzip qe-UPF-tools-wave1281-*.zip
cd qe-UPF-tools
bash read.sh
bash plot.sh
cat CONVERSION-REPORT.json
cat analysis/QE-UPF-tools-summary.csv

下载包提供实际日志、转换文件的SHA256、摘要和导出的文本数据;完整UPF、UPF2及QE_PP XML赝势文件不放入资料包。离线查看结果不需要赝势。

3. 转为UPF v2#

在自己的工作目录中放入要转换的赝势。本例命令是:

module load qe/7.6-8173m
upfconv.x -u source.UPF > convert-upf.out
ls source.UPF2

输出后缀为 .UPF2。文件名变了不代表泛函、价电子数或截断建议经过重新计算。本例输入本来已经是UPF v2,实际演示了重新读写及数据保持;旧格式输入则要核对该工具是否支持。

4. 转为QE_PP XML#

upfconv.x -x source.UPF > convert-xml.out
head -20 source.xml

会得到以 qe_pp:pseudo 为根节点、标明 QE_PP-1.0 的XML。这与UPF v2的 <UPF version="2.0.1"> 是不同的结构;不要仅把UPF改名为.xml就认为完成了转换。

除了原子序数、价电子数、NC/US/PAW类型、泛函、相对论与自旋轨道设置,还应关注可选的轨道元数据。原文件中若半径字段缺失或本身没有合理含义,转换并不能推导出可靠的新半径。本例用有完整轨道半径记录的Si输入来展示转换。

5. 用资料包重做#

在资料包根目录创建 pseudo,准备本例使用的三个NC、无非线性芯修正文件,分别命名为 H.UPF、C.UPF、Si.UPF。Si可按前述生成教程在自己的目录重建;H/C部分供同包的径向数据教程使用。

mkdir -p pseudo
# 将适用的H、C、Si赝势放入pseudo,并与文件名对应
bash prepare.sh
bash run.sh
bash read-new.sh

prepare.sh 只复制用户提供的输入并建立新目录;run.sh 分别执行H/C数据导出与Si两种格式转换;read-new.sh 对本次新输出进行读取与比较。已有 work-new 会被保留,重做时使用新的解压目录。

如果只需要转换自己的某一个文件,直接使用前两节的短命令即可,不必为了使用转换工具准备所有三个元素。

6. 其他选项的范围#

upfconv.x -h

-e 导出径向波函数、投影子和势;-p 导出用于绘图的实空间及q空间数据,下一篇展开说明。-c 是旧CASINO转换选项,程序自己的帮助明确提示其可靠性限制;本例没有把它列为已验证的生产转换路线。需要CASINO或其他旧格式时,应核对局域通道与后续软件要求,再用目标程序实际测试。

转换成功仍要检查输出和实际用途,尤其不要把文件头里的 wfc_cutoff=0 当作可直接用于材料计算的推荐截断。

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

查看配图

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

100%查看原图 ↗