QE到Critic2:波函数导出与密度查询
从真实SiH4的QE波函数导出PWC,实际加载Critic2并查询价密度,说明分数坐标、占据权重和伪价电子范围。
阅读本篇目录
1. 将QE保存波函数交给Critic2#
QE的 pw2critic.x 可以把结构、k点、能带、占据和Kohn–Sham平面波系数写入 .pwc 文件,随后由Critic2读取。它比单独传一个结构文件包含更多电子结构信息。
本例使用SiH₄实际NSCF流程中的5原子、8价电子、8条能带,显式Γ点、NC赝势、20bohr立方盒;不重新计算DFT。下面实际完成导出、Critic2读入、三个点的密度查询和一条Si—H直线的采样。

下载NSCF数据、PWC、原生输入输出、CSV及绘图脚本,保存为example.zip:
python3 -m zipfile -e example.zip .
cd qe-critic-wavefunction
bash read.sh
bash plot.sh
读取保存结果不需要重新准备赝势。源QE7.6 CPU构建采用Intel2024.2、Intel MPI2021.13和MKL2024.2;Critic2为1.4.155,使用GCC13.3构建。封装脚本已加载读取HDF5和绘图所需的Python环境。
2. 准备导出输入#
inputs/export.in:
&inputpp
prefix='SiH4'
outdir='./tmp/'
seedname='SiH4'
smoothgrid=.false.
/
prefix/outdir 必须指向已经完成并保留波函数的 .save 数据。seedname 决定输出文件名,本例得到 SiH4.pwc;smoothgrid=.false. 写出本例的电荷网格尺寸。
这个入口要求单进程,不能为它增加多个MPI进程。原生导出命令是:
pw2critic.x < export.in > export.out
ls -lh SiH4.pwc
本例原生PWC包含1个k点、8条能带、81³网格和34265个平面波系数。附件读取脚本同时核对它们与原始HDF5的映射,不靠文件存在就认定导出完整。
3. 在自己的副本里运行#
bash prepare.sh
sbatch run.slurm
准备脚本复制附件中的相同NSCF数据,并另外准备匹配的两份赝势。你可以将自己取得的 H.pbe-vbc.UPF、Si_ONCV_PBE-1.0.upf 放在解压目录;没有本地文件时,脚本会尝试从 MODEL.json 所列原始来源下载并核对SHA256。请确认文件许可及物理适用性。
脚本申请1个CPU进程,先运行 pw2critic.x,然后让Critic2读取新文件。结束后:
ls work-new/SiH4.pwc
bash read.sh work-new analysis-new
bash plot.sh analysis-new
如果手动操作,请进入自己含有 .save、输入和赝势的工作目录,执行导出后再运行:
critic2 < critic.cri > critic.out
不要把另一套结构或赝势对应的 .save、PWC和图像混在同一组结果里。
4. Critic2怎样加载和查询#
本例 inputs/critic.cri 的完整输入为:
crystal SiH4.pwc
load SiH4.pwc
reference 1
point 0.037037037037037035 0.037037037037037035 0.037037037037037035
point 0.07407407407407407 0.07407407407407407 0.07407407407407407
point 0.037037037037037035 0 0
line 0 0 0 0.081380111 0.081380111 0.081380111 101 file SiH-line-rho.dat
line 0 0 0 0.081380111 0.081380111 0.081380111 101 gmod file SiH-line-grad.dat
line 0 0 0 0.081380111 0.081380111 0.081380111 101 lap file SiH-line-lap.dat
end
crystal 从PWC读取晶胞和原子结构,load 加载相应的伪价电子密度及波函数,reference 1 选中该场。
这里的POINT和LINE输入位置采用晶胞分数坐标。 本例晶胞边长20bohr,分数坐标 (3/81,3/81,3/81) 对应约 (0.740741,0.740741,0.740741) bohr。不能把输入中的0.037037直接当作0.037037bohr。
| 查询点 | 实际位置/bohr | Critic2价密度/e·bohr⁻³ |
|---|---|---|
| P1 | 0.740741,0.740741,0.740741 | 0.1012802955 |
| P2 | 1.481481,1.481481,1.481481 | 0.2684130224 |
| P3 | 0.740741,0,0 | 0.02817423742 |
这三个点恰在原81³网格上,与同一实际波函数直接平面波求值得到的密度差小于1E-10 e/bohr³。输出坐标有打印位数限制,读取脚本用原输入坐标计算参考,不把截短后的显示值当作新的精确位置。
5. 八个电子意味着什么#
本例四个占据态的带权占据数各为2,其余四个空态为0;每条平面波态模方归一化为1,合计是8个价电子。PWC里的带权占据已经含k点权重,不能再随意乘一次权重。
SiH₄的全部核电荷合计为18,硅的内层电子并没有由这个NC伪价密度自动补齐。因此不能把8电子的密度当作18电子全电子密度,也不能直接用它的积分差宣称获得了可靠的全电子原子净电荷。
如果目标是原子盆积分,可结合Critic2原子电荷教程选择正确的参考密度和被积分的价密度。本页只完成接口和查询;程序初始化时列出的核位置也不等于已经完成了键临界点搜索。
6. LINE输出与导数#
三条实际LINE分别输出密度、梯度模长和拉普拉斯。数据文件前四列为x、y、z及沿线距离;对于本例周期结构,前三列仍为分数坐标,距离列为bohr。密度单位为e/bohr³,梯度模长为e/bohr⁴,拉普拉斯为e/bohr⁵。
采样直线不等于密度梯度键路径。本例粗网格的导数与直接平面波求导存在明显差异,核位置还有特殊处理;下一页给出后处理网格加密和核位置的读取方法,不要仅凭一条粗网格曲线判断成键性质。
7. 导出表格#
cat analysis-read/QE-critic-interface-states.csv
cat analysis-read/QE-critic-interface-points.csv
head analysis-read/QE-critic-interface-bond-line.csv
三个CSV分别保存能带/占据/模方、查询点的实际位置和数值、沿线原生及参考数据。用于离域指数时,还需要相应的Wannier90检查点等前置数据;仅生成PWC不等于完成了离域指数计算。
接口定义参考QE原生pw2critic、Critic2结构读入和PWC场读入。
元素标签与后续局域轨道接口#
本例直接读取PWC的网格密度及平面波态;QE 7.6的PWC元素标签长度与这里的Critic2结构读取器存在差异,直接用crystal SiH4.pwc时Si可能显示为未知元素。这不改变本文按独立平面波对照的密度数值,但后续结构显示、核电荷、原子盆与成键分析应先改用同源独立CIF,并确认Si/H种类、晶胞和坐标一致,不能据未知元素做盆积分。可用的CIF与具体命令见四条占据轨道的QE→Wannier90→Critic2流程。该流程还说明了Critic2对解纠缠检查点的限制;本文没有计算离域指数或全电子原子盆。