QE专题

QE SIMPLE_BSE:从SiH₄输入到最低激发态

用真实SiH4例子完成SCF、显式Γ点NSCF、SIMPLE乘积基和最低激发态求解,附完整输入与短命令。

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

1. 这套流程能做什么#

用一个五原子SiH₄分子,实际走完 pw.x → simple.x → simple_bse.x,求电子—空穴哈密顿量的最低激发态。这里的SIMPLE_BSE是QE的一个独立分支,与GWW-BSE实操的数据文件格式不能混用。只想看独立粒子光谱时,可先看金刚石SIMPLE光学流程。

本例4个占据态、4个空态,Γ点共16个电子—空穴跃迁分量;采用20bohr立方盒、PBE、40/160Ry截断。这是理解命令和参数的小体系参考,不是收敛的分子光谱预测。

本例实际使用的SiH4结构

下载输入、原始结果、绘图脚本与个人目录编译脚本,保存为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源码。

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

查看配图

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

100%查看原图 ↗