QE专题

QE:实空间波函数与Cube导出

实际导出SiH4的HOMO和LUMO,读取原生二进制与Octave抽样文本,使用ASE生成三维概率密度Cube。

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

1. 把已算好的波函数导出到实空间#

wfck2r.x 将QE保存的平面波系数变换到实空间网格。它不重新求解电子结构,适合把选中的能带交给自己的分析程序,或导出波函数概率分布用于查看。

本例复用SiH₄流程的实际显式Γ点NSCF:5原子、8电子、8条能带、20bohr立方盒。选择第4条态和第5条态,分别作为本例最高占据态的一支与最低空态。最高占据态存在近简并,不能把某次编号4的形状直接当成唯一不变的分子轨道名称。

下载真实波函数、两种原生导出、Cube和绘图脚本,保存为example.zip:

python3 -m zipfile -e example.zip .
cd qe-realspace-wavefunctions
bash read.sh
bash plot.sh

使用QE7.6 CPU版,Intel2024.2、Intel MPI2021.13和MKL2024.2。读取HDF5与绘图所需Python环境已写在封装脚本中;导出Cube使用ASE3.29.0。

2. 完整网格二进制输入#

inputs/binary-HOMO.in:

&inputpp
 prefix='SiH4'
 outdir='./tmp/'
 first_k=1
 last_k=1
 first_band=4
 last_band=4
 loctave=.false.
 nevery(1)=1
 nevery(2)=1
 nevery(3)=1
/

first_k/last_k 和 first_band/last_band 明确选择第1个k点和第4条能带。loctave=.false. 写二进制实空间数组,nevery=1 保留本例81×81×81完整网格。

二进制文件本身不携带完整的可移植格式说明,需要同时保存网格、能带编号、数据类型和输出环境。本例按x86平台的complex128、Fortran数组顺序读取,不把这种直接访问格式泛化成所有平台通用格式。

3. 抽样文本输入#

inputs/octave-HOMO-LUMO.in:

&inputpp
 prefix='SiH4'
 outdir='./tmp/'
 first_k=1
 last_k=1
 first_band=4
 last_band=5
 loctave=.true.
 nevery(1)=3
 nevery(2)=3
 nevery(3)=3
/

文本选择第4—5条态,沿三个方向每3个格点取一个,得到27×27×27的两条复数波函数。nevery 必须与实际网格匹配;本例81能被3整除。

这是对已有网格的抽样,减少文本输出量,不是重新进行粗网格DFT,也不省去程序前面的完整FFT。抽样后的离散模方平均不必恰好等于1;不要为使结果好看而强行归一化后再宣称与原网格完全等价。

4. 在自己的目录运行#

bash prepare.sh
sbatch run.slurm

准备脚本复制附件中的实际 .save 计算数据,另行准备匹配的赝势。本例未在附件中分发UPF;可以把自己取得的 H.pbe-vbc.UPF、Si_ONCV_PBE-1.0.upf 放在解压目录,否则脚本会尝试从 MODEL.json 所列原始来源下载并核对SHA256。请确认文件许可和适用范围。

脚本申请1个CPU进程,依次处理两个独立目录。手动运行一个例子时:

cd work-new/binary-HOMO
mpirun -np 1 wfck2r.x < input.in > native.out
ls -lh tmp/SiH4.wfc_r1
cd ../octave-HOMO-LUMO
mpirun -np 1 wfck2r.x < input.in > native.out
head wfck2r.oct
cd ../..

整套 sbatch 命令和这段手动命令择一执行,保留独立结果,避免在同一目录重复写输出。

5. 两种输出的区别#

输出 本例内容
tmp/SiH4.wfc_r1 完整81³复数HOMO数组,使用原能带绝对编号写入直接访问记录
wfck2r.oct k点、权重、能量、占据、抽样网格及两条态的复数文本数据

二进制只选择第4条能带时,程序仍把它写到第4条记录,因此本例文件逻辑长度为34,012,224字节。前3条零记录不代表程序计算了3条零波函数,也不是完整导出了第1—4条态;配套读取脚本按实际编号定位。

文本模式以 wfck2r.oct 为结果,不能用旁边可能为空的二进制文件判断文本导出是否成功。文本的数组维数为27×27×27×2×1,最后两维分别是选中态数和k点数。

6. 查看真实空间分布#

bash read.sh work-new analysis-new
bash plot.sh analysis-new

默认 bash read.sh 读取附件保存结果。完整HOMO二进制与原始平面波系数直接FFT相比,复数值最大差约1E-14;两条抽样文本与对应网格点相比,最大差小于1E-9。比较复数值同时保留了这次输出的相位约定,但任意整体相位不应被当作可直接观测的电荷差异。

原生文本导出的HOMO和LUMO在z等于0的实际采样切片

图中显示概率密度模方,不是任意选取的实部。两幅图使用各自色标,比较数值时应看刻度,不能只比较颜色。只取一个切片不能展示全部三维节点和局域特征;空态的空间扩展也可能受到有限周期盒影响,不能单凭这张图预测实验激发态。

本例Γ点原生数组的全网格模方平均为1,转成单位体积归一化波函数时需除以√8000;概率密度相应除以8000,单位bohr⁻³。沿xy积分后的z分布单位为bohr⁻¹:

由完整原生二进制网格得到的HOMO方向分布

7. 用ASE生成三维Cube#

附件已提供两份从原生文本采样值生成的概率密度Cube;需要自己重新导出时:

bash export-cubes.sh
ls cubes/*.cube

脚本使用ASE实际写出、重新读取Cube,保留原子结构、晶胞和27³采样网格。坐标原点按网格平移,使本例分子位于图像中心;数据不做插值或额外归一化。

把Cube下载到本地支持Gaussian Cube的图形软件后,可以查看三维等值面。文件中的数值是选定单态的概率密度,不是整分子的总电子密度;该空态未被占据,不能把它单独当成现有电子电荷。

8. 数据表和适用范围#

CSV 内容
QE-realspace-wavefunction-FFT-checks.csv 原生复数数组与平面波FFT的差、完整与抽样模方平均
QE-realspace-wavefunction-native-slices.csv 两条态z=0平面的原生实部、虚部和归一化概率密度
QE-realspace-wavefunction-HOMO-z-profile.csv 完整HOMO网格沿z的概率分布

本例核对的是NC赝势、共线、显式Γ点标量波函数。不同k点、自旋量子态、Gamma-only压缩存储和不同平台的数据布局需要另行确认;不要套用本例固定的81³和第4条记录。前置计算的结构、赝势或截断改变后,也不能继续拿旧波函数作为新结果。

如果只需要每条态的xy平面分布,可以直接看逐态平面平均教程。原生参数与输出方式参考QE wfck2r源码。

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

查看配图

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

100%查看原图 ↗