QE专题

QE:逐态波函数的平面分布

用真实SiH4波函数运行plan_avg个人兼容版本,检查逐态剖面、真实晶胞长度和归一化,说明空态与电子占据的区别。

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

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占据态按占据数加权后的z方向密度

这张图是本组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源码和逐态密度实现。

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

查看配图

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

100%查看原图 ↗