QE:逐态波函数的平面分布
用真实SiH4波函数运行plan_avg个人兼容版本,检查逐态剖面、真实晶胞长度和归一化,说明空态与电子占据的区别。
阅读本篇目录
1. 逐态平面平均和总电荷密度平均有什么不同#
plan_avg.x 读取QE保存的波函数,为每个k点、每条能带计算xy平面上的波函数模方平均,沿z输出剖面。它适合查看某条态在不同z位置的分布;如果要对已有总电荷密度或电势文件做平面/宏观平均,应看average.x教程。
本页使用SiH₄前置流程的实际显式Γ点NSCF波函数:5原子、8电子、8条能带、20bohr立方盒,NC赝势。读取保存波函数,不重新做DFT。
下载实际波函数数据、原生剖面、个人目录兼容构建与绘图脚本,保存为example.zip:
python3 -m zipfile -e example.zip .
cd qe-state-planar-average
bash read.sh
bash plot.sh
先读取保存结果不需要赝势。脚本使用集群包含NumPy、Matplotlib和h5py的Python环境,读取HDF5并绘图;封装脚本已加载所需环境。
源程序为QE7.6,CPU构建采用Intel2024.2、Intel MPI2021.13与MKL2024.2。本例使用个人目录的立方晶胞兼容版本,下面说明原因和运行方法;公共模块中的程序不会被覆盖。
2. 准备输入和.save目录#
input.in 只有一个namelist:
&inputpp
prefix='SiH4'
outdir='./tmp/'
filplot='SiH4-state-planes.dat'
/
需要与前置计算匹配的保存目录:
ls reference-save
ls work-new/tmp/SiH4.save
第一条查看附件中的计算数据;第二条应在后面的准备步骤完成后再执行。正式运行需要 data-file-schema.xml、电荷密度、波函数和匹配的赝势,不能只复制一个电荷密度文件。
此入口不支持Gamma-only简化存储方式;本例前置NSCF使用显式 K_POINTS crystal 中的 0 0 0 1,不是 K_POINTS gamma。重新准备其他体系时应先确认波函数表示与程序支持范围。
3. 本例为什么使用个人目录兼容版本#
该版本对立方晶胞缺省 c/a 的处理会把晶胞边长误当成比例:本例边长20bohr,原生输出的平面剖面按400bohr长度归一化。若直接用真实20bohr积分,每个态只有0.05;文件中打印的分区积分仍可能为1,因此不能只看那一行就认为长度归一化正确。
资料包的 build.sh 只把这个缺省比例改为1,在自己的 personal-build 目录编译;保持原来波函数和其他参数不变。修改后的8个态在真实20bohr范围积分均为1,与直接从原始平面波系数FFT重建的剖面相符,最大点差小于0.000000000001。
该兼容实现是在本例NC、共线、显式Γ点、立方晶胞下使用的。不能由此推断超软/PAW增广项、自旋量子态、非正交晶胞和任意多k点情况都已验证。
4. 运行自己的后处理副本#
bash build.sh
bash prepare.sh
sbatch run.slurm
build.sh 只链接集群已有QE库,编译个人目录中的程序。prepare.sh 把附件里的实际NSCF数据复制到 work-new/tmp/SiH4.save,然后准备两份赝势。
赝势没有放进附件。你可以将自己取得的 H.pbe-vbc.UPF、Si_ONCV_PBE-1.0.upf 放在解压目录;没有本地文件时,准备脚本会尝试从 MODEL.json 所列原始来源下载,并核对SHA256。请先确认文件许可和物理适用性。更换赝势后,不能继续套用旧波函数。
提交脚本申请1个CPU进程。手动运行时,在含有 tmp/SiH4.save 的独立目录执行:
mpirun -np 1 ../personal-build/plan_avg.x < input.in > native.out
脚本结束后:
ls work-new/SiH4-state-planes.dat
bash read.sh work-new analysis-new
bash plot.sh analysis-new
默认 bash read.sh 读取保存结果;指定 work-new 才读取新输出。不要把新体系的输出与附件旧波函数配对比较。
5. 输出文件怎样读#
SiH4-state-planes.dat 先给出FFT网格、晶胞和原子信息,再给出分区数、k点数和能带数。每条态随后包含k点、能带编号、分区积分,以及沿z的网格序号和剖面。
本例为81×81×81网格、1个k点、8条能带。源程序根据原子z位置和自身分区规则把本例归为1个分区;这不是说SiH₄只有一个原子层,也不能用它自动识别任意异质结的材料分层。

图中比较了能带1、4、5和8;横坐标将周期盒的z坐标移动到中心附近显示,单位bohr。蓝线来自兼容程序的原生剖面,虚线由附件中的真实平面波系数独立FFT重建。
这里沿xy做了积分式归一化,纵轴是沿z的概率密度,单位bohr⁻¹。它不是完整三维电荷密度e/bohr³,不能直接与三维密度图的色标相比。
6. 空态为什么也能积分为1#
每条波函数都归一化为1,程序逐态读取时不按原有占据数保留电子权重。因此空态也有非零剖面和单位积分;不能把8条能带不加权相加后当作SiH₄的实际总电子密度。
本例4个占据态各乘2,合计积分为8电子:

这张图是本组NSCF波函数的占据态密度和,不将它说成新的自洽电荷密度计算。对于金属、分数占据、多k点或自旋极化体系,应使用实际占据与k点权重,不能照搬本例“前4条乘2”的规则。
7. 查看归一化和数据#
cat analysis-read/QE-state-planar-normalization.csv
head analysis-read/QE-state-planar-profiles.csv
| CSV | 用途 |
|---|---|
QE-state-planar-profiles.csv |
每条态的网格位置、兼容程序剖面、直接FFT参考与原版长度归一化对照 |
QE-state-planar-normalization.csv |
平面波模方和、真实长度积分、分区积分及逐点差 |
QE-state-planar-structure.csv |
同一实际结构的原子坐标,单位bohr |
读取脚本从原始HDF5平面波系数和Miller索引重建网格,因此能同时检查网格、长度和归一化。只把曲线手动除以一个常数,不能替代核对晶胞、波函数和物理单位。
原生接口与算法参考QE plan_avg源码和逐态密度实现。