QE SIMPLE_BSE:从SiH₄输入到最低激发态
用真实SiH4例子完成SCF、显式Γ点NSCF、SIMPLE乘积基和最低激发态求解,附完整输入与短命令。
阅读本篇目录
1. 这套流程能做什么#
用一个五原子SiH₄分子,实际走完 pw.x → simple.x → simple_bse.x,求电子—空穴哈密顿量的最低激发态。这里的SIMPLE_BSE是QE的一个独立分支,与GWW-BSE实操的数据文件格式不能混用。只想看独立粒子光谱时,可先看金刚石SIMPLE光学流程。
本例4个占据态、4个空态,Γ点共16个电子—空穴跃迁分量;采用20bohr立方盒、PBE、40/160Ry截断。这是理解命令和参数的小体系参考,不是收敛的分子光谱预测。

下载输入、原始结果、绘图脚本与个人目录编译脚本,保存为example.zip:
python3 -m zipfile -e example.zip .
cd qe-simple-exciton
bash read.sh
bash plot.sh
先运行这两条命令读取保存结果,会生成 analysis-read 和 figures。不需要重新计算DFT。
本例使用QE7.6 CPU版,Intel oneAPI2024.2、Intel MPI2021.13、MKL2024.2,配套ELPA、HDF5与Libxc;读取和绘图用ASE3.29.0环境中的NumPy、Matplotlib。可执行程序面向集群8173M平台,不能直接拷到任意CPU或GPU上运行。
2. 准备赝势和SCF输入#
新体系按先自洽、再非自洽、再建立SIMPLE矩阵的顺序计算。附件中的 inputs/scf.in 为:
&control
calculation = 'scf',
restart_mode='from_scratch',
prefix='SiH4',
tprnfor = .true.,
pseudo_dir='./pseudo/',
outdir='./tmp/'
/
&system
ibrav = 1,
celldm(1) = 20.0,
nat = 5,
ntyp = 2,
ecutwfc = 40.0,
ecutrho = 160.0,
nbnd = 8
/
&electrons
diagonalization = 'cg'
mixing_beta = 0.5,
conv_thr = 1.0d-8
/
ATOMIC_SPECIES
H 1.0 H.pbe-vbc.UPF
Si 28.0 Si_ONCV_PBE-1.0.upf
ATOMIC_POSITIONS {angstrom}
Si 0.000000000 0.000000000 0.000000000
H 0.861290004 0.861290004 0.861290004
H -0.861290004 -0.861290004 0.861290004
H -0.861290004 0.861290004 -0.861290004
H 0.861290004 -0.861290004 -0.861290004
K_POINTS {gamma}
celldm(1) 的单位是bohr,原子位置这里使用Å。Si—H距离约1.492Å;本例固定这一结构,不把它当作经过几何、盒长和截断收敛研究的最终结构。孤立分子的激发能可能对周期盒子、库仑截断和空带数敏感。
赝势不放在附件内。准备新计算时,在解压目录放入自己取得的 H.pbe-vbc.UPF 和 Si_ONCV_PBE-1.0.upf。MODEL.json 记录了本例来源及SHA256,准备脚本会核对;若没有本地文件,会尝试从记录的官方/原始来源下载。取得文件时仍应确认其许可与适用范围。
3. NSCF为什么仍要显式写Γ点#
附件 inputs/nscf.in 保留相同结构、截断和8条能带,把计算改为非自洽,并写出显式k点:
&control
calculation = 'nscf',
restart_mode='from_scratch',
prefix='SiH4',
tprnfor = .true.,
pseudo_dir='./pseudo/',
outdir='./tmp/'
/
&system
ibrav = 1,
celldm(1) = 20.0,
nat = 5,
ntyp = 2,
ecutwfc = 40.0,
ecutrho = 160.0,
nbnd = 8
/
&electrons
diagonalization = 'cg'
mixing_beta = 0.5,
conv_thr = 1.0d-8
/
ATOMIC_SPECIES
H 1.0 H.pbe-vbc.UPF
Si 28.0 Si_ONCV_PBE-1.0.upf
ATOMIC_POSITIONS {angstrom}
Si 0.000000000 0.000000000 0.000000000
H 0.861290004 0.861290004 0.861290004
H -0.861290004 -0.861290004 0.861290004
H -0.861290004 0.861290004 -0.861290004
H 0.861290004 -0.861290004 -0.861290004
K_POINTS crystal
1
0 0 0 1
K_POINTS crystal 的最后一列1是权重。本例需要SIMPLE读入完整复数表示;不要为了省事把这里改回SCF使用的 K_POINTS gamma 简写,也不要只复制电荷密度却漏掉NSCF产生的波函数。
4. 建立共同基和电子—空穴相互作用#
inputs/simple.in:
&inputsimple
prefix='SiH4'
outdir='./tmp/'
calc_mode=0
num_nbndv=4
num_val=4
num_cond=4
s_bands=0.001
s_product=0.001
nkpoints(1)=1
nkpoints(2)=1
nkpoints(3)=1
numpw=0
l_truncated_coulomb=.true.
truncation_radius=10.0
w_type=1
epsm=2.0
lambdam=1.0
l_debug=.false.
n_debug=1
n_shrink=1
nonlocal_commutator=.false.
/
calc_mode=0 是本页的关键,建立乘积基、库仑/模型屏蔽相互作用和动量相关矩阵;不是独立粒子光学教程使用的 calc_mode=1。本例得到36个乘积基函数。
num_val=4、num_cond=4 决定参与的占据态和空态数。s_bands、s_product 控制基的筛选;不能仅凭程序结束就认定基已收敛。
l_truncated_coulomb 与10bohr截断对应此有限盒分子例子。w_type=1、epsm=2、lambdam=1 是人为指定的教学屏蔽模型,后者单位为Å⁻¹;numpw=0 表示这里不从GWW屏蔽数据文件构造W。它不等于完成了第一性原理介电屏蔽或GW计算。
5. 求最低激发态#
以模型BSE单重态为例,输入为:
&inputsimple
simple_in%prefix='SiH4'
simple_in%outdir='./tmp/'
simple_in%task=0
simple_in%diago=1
simple_in%nvec=1
simple_in%thr_evc=1.0d-7
simple_in%max_nstep=200
simple_in%l_step=0.1
simple_in%h_level=3
simple_in%spin_state=1
simple_in%scissor=0.0
simple_in%spectrum_points=501
simple_in%omega_min=0.0
simple_in%omega_max=15.0
simple_in%eta=0.1
simple_in%lanczos_step=30
/
task=0 求本征态,nvec=1 只求一个最低态,diago=1 使用该入口的CG求解器。scissor=0 的单位是eV,表示不额外移动空带能量。若加入剪刀修正,必须说明修正值的来源,不能把人为修正写成实际算得的GW能隙。
五个近似的输入已分别放在 inputs 中,参数与结果见近似选择与结果解读。本资料包为RPA、TDH及TDHF三重态提供个人目录中的显式数组SD实现,只支持本例 nvec=1;TDHF单重态和模型BSE单重态使用公共CG入口。原版SD入口不作为这三个例子的推荐命令。
6. 从已有矩阵运行:最短操作#
如果只想练习最低态求解,不重做前面的SCF、NSCF和SIMPLE:
bash build.sh
bash prepare.sh
sbatch run.slurm
build.sh 只在当前目录生成 personal-build/simple_bse.x,链接已部署的QE库。它不会覆盖模块或公共软件。prepare.sh 把附件中的实际计算矩阵复制到自己的 work-new。
提交脚本申请4个CPU进程;运行脚本对三个SD例子使用1个MPI进程,对两个CG例子使用4个MPI进程。这里一个Γ点,增加进程并不一定更快。CPU资源需要按集群实际可用状态排队,本文不以这些短例比较节点性能。
结束后读取并重画:
bash read.sh work-new analysis-new
bash plot.sh analysis-new
python -c "from pathlib import Path; print(Path('analysis-new/SIMPLE-BSE-lowest-states.csv').read_text())"
read.py 既读取原生保存态,也与附件中按同一原生哈密顿量构造的16×16参考矩阵比较,检查归一化和本征残差。更换结构、赝势、基或参数后,旧参考矩阵就不能继续用作新计算的正确性判据。
7. 从SCF完整重新计算#
请使用另一份新解压目录,避免把上一段 work-new 和新的DFT数据混在一起:
bash build.sh
bash prepare.sh --fresh
sbatch run.slurm --fresh
脚本先运行SCF、显式Γ点NSCF和 simple.x,再向五个独立目录传递以下四个文件:
ls work-new/tmp/SiH4.wfc_basis
ls work-new/tmp/SiH4.product_basis
ls work-new/tmp/SiH4.v_mat0
ls work-new/tmp/SiH4.epe
手动操作时,前置三步命令是:
mpirun -np 4 pw.x < scf.in > scf.out
mpirun -np 4 pw.x < nscf.in > nscf.out
mpirun -np 4 simple.x < simple.in > simple.out
然后在含有本例 tmp 与相应输入的独立目录运行,例如:
mpirun -np 4 simple_bse.x < input.in > native.out
不要把未结束的前置任务和后置任务同时启动,也不要把SCF的Γ点波函数误当成已经准备好的SIMPLE乘积基。
8. 最后得到哪些文件#
| 文件或目录 | 用户用途 |
|---|---|
tmp/SiH4.exciton.0001 |
该近似下的最低激发态、能量分解及复数跃迁系数 |
analysis-read/SIMPLE-BSE-lowest-states.csv |
五个近似的能量、归一化及残差 |
SIMPLE-BSE-transition-weights.csv |
16个电子—空穴分量的系数与归一化权重 |
SIMPLE-BSE-direct-spectrum.csv |
本例小矩阵的完整本征值参考,不是吸收谱 |
figures |
结构、最低能量和各能量项对比图 |
原生CG的停止提示不能代替查看保存态。通常至少检查电子收敛、文件是否完整、态的归一化和残差;求得最低态也不意味着它就是最强的光学谱峰。下一步可看Lanczos系数与响应谱。
参数定义参考QE SIMPLE_BSE源码。