QE 赝势径向数据:导出、读取与绘图
实际导出H/C规范守恒赝势的径向波函数、局域势、投影子与4000点q空间数据,讲清Bohr/Ry单位及归一化。
阅读本篇目录
想了解赝势文件中的径向数据时,不必手工从很长的UPF中复制数字。upfconv.x -e 可以导出表格,-p 可以输出直接绘图的径向和q空间文件。
下载H/C真实导出数据、图片、CSV和短脚本。与UPF格式转换教程共用资料包。本篇复用此前甲烷GW实例所用的H、C规范守恒LDA赝势,没有新增分子或材料SCF计算。
1. 先看实际数据#
unzip qe-UPF-tools-wave1281-*.zip
cd qe-UPF-tools
bash read.sh
bash plot.sh
cat analysis/QE-UPF-tools-summary.csv
| 元素 | 价电子数 | 径向网格点 | 径向波函数 | 非局域投影子 |
|---|---|---|---|---|
| H | 1 | 131 | 1 | 0 |
| C | 4 | 269 | 2 | 1 |
H在本例是没有非局域投影子的局域形式;不能据此认为所有H赝势都一样。每个文件的类型、泛函和价电子定义都应单独看头部。

左图长度单位bohr、局域势单位Ry。右图采用原工具的数值定义,q单位bohr⁻¹;不能把纵轴未经换算就当成晶胞中的平面波矩阵元。
2. 导出径向波函数、投影子和势#
在包含自己赝势文件的目录执行:
module load qe/7.6-8173m
upfconv.x -e source.UPF > extract.out
ls source.wfc source.beta source.pot
head source.pot
输出含义为:
| 文件 | 列 |
|---|---|
source.wfc |
r,以及各个径向赝波函数 |
source.beta |
r,以及各个非局域投影子 |
source.pot |
r、局域势、价电子径向密度、芯密度径向量 |
source.wfc 中的波函数是赝原子的径向函数,不是晶体的Bloch波函数。source.beta 中列的数量取决于实际投影子数;本例H文件只有r列,这是因为其非局域投影子数为0,不是导出漏了数据。
径向密度与三维电子密度的含义不同,不要把这些一维数据直接画成材料空间电荷分布。本例使用无非线性芯修正的NC势,芯密度列为0;其他类型要结合文件中的芯修正定义判断。
-e 的普通表格以6位小数写出。本例读回与原UPF之间的差别符合这个文本精度;如需要更高精度的数值分析,应读取原始UPF或采用更高精度的输出。
3. 导出实空间和q空间曲线#
upfconv.x -p source.UPF > plot-potential.out
ls source-vofr.dat source-vofq.dat
head source-vofq.dat
本例q空间有4000行,q从0到39.99 bohr⁻¹,间隔0.01 bohr⁻¹。
source-vofr.dat 的三列为r、Vloc(r)和工具定义的短程参考组合。其第三列使用 Vloc + 2*Zval/max(0.1,r),因此r<0.1 bohr时采用截断分母,不是未经处理的库仑项抵消。需要解释曲线时,不能忽略这一处理。
source-vofq.dat 保存全径向网格和r<10 bohr截断网格两种积分结果。该工具使用约定的径向积分与解析库仑尾项,未乘 4π/晶胞体积;q=0处应得到 q²V(q)=-2*Zval。本例H为-2、C为-8,与实测文件一致。
4. 投影子的绘图文件#
有非局域投影子时,-p 还会生成:
source-betar-1.dat
source-betaq-1.dat
本例C的第1个投影子在r空间输出219行;-e 导出的beta表格则与269点的完整径向网格对应。输出行数不同,是截断范围与文件用途不同,不能仅凭行数判为数据丢失。
这个版本的 betaq 实现直接采用代码中的正弦积分,并输出两种求积结果。它不能自动等同于任意角动量投影子的一般球Bessel变换。本例C投影子的角动量为l=0;其他通道作物理解读前,应核对变换定义。
5. 读取和绘图#
资料包中的 read.sh 从实际导出文本提取数据,plot.sh 生成图片。也可用自己的Python脚本直接读表:
import numpy as np
import matplotlib.pyplot as plt
r, vloc, remainder = np.loadtxt('source-vofr.dat', unpack=True)
plt.plot(r, vloc)
plt.xlim(0, 5)
plt.xlabel('r / bohr')
plt.ylabel('Vloc / Ry')
plt.savefig('local-potential.png', dpi=200)
如果要以Å显示长度,按约0.529177 Å/bohr换算;不要把势的Ry单位也跟着误当成eV。相关文件第一行通常说明列的含义,绘图前先读头部。
6. 在自己的输入上重做#
本例完整输入准备见同包的格式转换教程。对单个文件,只需要本篇两条短命令:
upfconv.x -e my-potential.UPF > extract.out
upfconv.x -p my-potential.UPF > plot.out
该工具用于检查与展示已有赝势数据。比较不同文件时,要同时核对元素、价电子数、泛函、相对论处理及局域/非局域定义;两条曲线更接近,并不能单独说明哪一个势更准确。