QE子包操作导航:按目标找程序和前置文件
按计算目标串起QE各子包的真实教程,说明pw、PHonon、EPW、TDDFPT及工具接口的数据依赖。
阅读本篇目录
QE安装后会出现很多可执行文件。先按自己的计算目标选择路线,再进入对应教程准备结构、赝势和输入,不必从几十个程序名中猜起。本页把已经有实际输入、输出和图的流程集中起来;每条链接进入独立教程,不将子包名等同于所有参数都已经跑过。
下载子包导航表、Si输入检查工具和真实结果。本页以已装QE 7.6为线索。CPU版主要使用oneAPI2024.2、Intel MPI2021.13和MKL,P100/V100版使用NVHPC25.3、CUDA12.8和HPC-X2.22.1。各教程会说明具体版本、适用后端与编译依赖;不能混用不同MPI环境中的程序。
1. 先认清文件流向#

大多数静态物性从pw.x开始,但不是所有子包都只需一个已完成的SCF目录。例如TDDFPT还需要响应输入和未占据态设置,EPW还涉及声子网格及Wannier接口,CP/路径积分有独立的初始化与动力学输入。不要把不同结构、赝势、泛函或自旋设置下的prefix.save拼在一起。
| 子包/入口 | 已有实际体系与结果 | 操作教程 |
|---|---|---|
PW:pw.x |
Si基态、截断和k点 | 完整输入、命令与结果 |
CPV:cp.x |
H2O电子初始化和CP轨迹,NVHPC/P100限定 | 完整输入、命令与结果 |
PP:wfck2r.x |
HOMO/LUMO实空间网格 | 完整输入、命令与结果 |
PHonon:dynmat.x |
GaN Γ点动力学矩阵和ASR | 完整输入、命令与结果 |
EPW:epw.x |
金刚石电子—声子插值 | 完整输入、命令与结果 |
GWW:gww.x |
CH4 GW准粒子 | 完整输入、命令与结果 |
HP:hp.x |
四原子LiCoO2的Hubbard U线性响应 | 完整输入、命令与结果 |
KCW:kcw.x |
Si屏蔽参数和KI能带 | 完整输入、命令与结果 |
NEB:neb.x |
H3反应路径 | 完整输入、命令与结果 |
PWCOND:pwcond.x |
Al链透射与H散射;按教程构建个人兼容PWCOND,共享原程序控制未转记通过 | 完整输入、命令与结果 |
TDDFPT:turbo_lanczos.x |
H2O分子吸收;另有EELS和magnon | 完整输入、命令与结果 |
XSpectra:xspectra.x |
金刚石C K边 | 完整输入、命令与结果 |
atomic:ld1.x |
H/He径向全电子与赝势生成前置 | 完整输入、命令与结果 |
QEHeat:all_currents.x |
水快照、正反速度能量流 | 完整输入、命令与结果 |
PIOUD:pioud.x |
H2路径积分珠子与质心 | 完整输入、命令与结果 |
upflib:virtual_v2.x |
虚晶赝势混合及实际C/Si端点与混合结构SCF | 完整输入、命令与结果 |
Wannier接口:pw2wannier90.x / wannier90.x |
Si占据态Wannier化,实空间文件与Critic2联用 | 完整输入、命令与结果 |
COUPLE:c2libpwscf API1 |
H2两键长C接口与原生pw.x四次实际SCF | 完整输入、命令与结果 |
GUI:PWgui --reformat pw.x |
Si真实输入重排、语义保留与GUI窗口 | 完整输入、命令与结果 |
2. 基态、谱与实空间数据#
PW负责SCF、NSCF、结构与晶胞优化等基础计算。PP工具接收保存的电荷密度、波函数和投影数据;要画能带或DOS,首先需要覆盖目标路径/能量窗的电子结构结果。
# 在Slurm分配的计算节点和同一案例目录中,按教程准备输入后运行
pw.x -in scf.in > scf.out
pw.x -in nscf.in > nscf.out
projwfc.x < projwfc.in > projwfc.out
这些是调用顺序,不是替代完整输入的通用脚本。实际文件名和命令以表中的对应案例为准。要看波函数在实空间的形状,可进入PP波函数导出例子,保留导出需要的wfc数据,再用图像脚本读取网格。
Wannier不是只运行wannier90.x一次。常见顺序是:
wannier90.x -pp seed
pw2wannier90.x < pw2wan.in > pw2wan.out
wannier90.x seed
在这之前完成相匹配的SCF/NSCF和.win输入;中间得到的.amn/.mmn/.eig必须来自同一套计算。表中的Si实际教程还展示了实空间与Critic2结果。
3. 声子、电子—声子和超胞能量流#
PHonon通常从SCF保存目录开始,再求q点响应,经过q2r.x和matdyn.x导出声子。极性晶体的Born电荷/介电响应与LO–TO处理,参见极性声子教程。
ph.x < ph.in > ph.out
q2r.x < q2r.in > q2r.out
matdyn.x < matdyn.in > matdyn.out
传统电子—声子路线另见Al完整流程与λ、ωlog、Tc读取。它保留稠密电子数据、粗网格响应和elph_dir,不是拿任意声子DOS就能得到α²F。
EPW在声子与Wannier化数据基础上做精细插值,输入、粗网格文件和重启数据的关系比单纯SCF更复杂;进入金刚石实际教程逐步运行。QEHeat使用带速度的原子快照计算能量流,缺少速度不能只靠静态结构补出热输运轨迹;现有水快照例子分别读取正、反速度贡献。
4. 激发态、光谱与关联修正#
TDDFPT提供分子吸收、周期体系EELS及自旋响应等不同路线。分子吸收的一种调用次序为:
turbo_lanczos.x < response.in > response.out
turbo_spectrum.x < spectrum.in > spectrum.out
先完成对应教程的基态与响应准备。EELS和magnon的输入变量、响应通道及前置数据不同,不把分子吸收脚本直接改个文件名就当成等价方法。
XSpectra需要合适的吸收原子、赝势和芯态信息;金刚石C K边教程给出实际光谱操作。GWW有自己的波函数/极化预处理步骤;甲烷教程展开pw4gww到后续GW程序的文件依赖。KCW从参考轨道和Koopmans工作流开始,Si例子说明校正和输出。HP计算Hubbard U线性响应,LiCoO₂例子涉及SCF、响应及结果读取;输入原子标签和相关轨道必须相匹配。
5. 动力学、反应和输运#
NEB需要首末态和中间图像输入;小反应教程展示势垒、图像能量和收敛过程。CPV的电子初始化与Car–Parrinello动力学有独立变量,现有水例子明确其NVHPC/P100适用环境。PIOUD处理路径积分珠子和质心,H₂例子显示实际输出;它不等同于普通经典MD。
PWCOND需要相容的电极和散射区电子结构数据。Al导线/H散射例子提供已经适配的私有工具构建步骤、输入和透射结果;在自己的工作目录按教程构建所需工具,不能假定任意公共pwcond.x都能不经检查替换。
6. 赝势、GUI和外部接口#
atomic/ld1.x处理径向原子和赝势相关任务;H/He实际例子分别说明全电子径向求解与生成前置条件。upflib/virtual_v2.x将两个相容UPF做虚晶混合,随后仍要通过真实SCF检查混合体系;C/Si案例展示了端点及混合结果。
PWgui可以整理和检查支持的输入语法,见Si输入检查教程。它不会替代SCF收敛或物理模型判断。COUPLE面向把QE嵌入外部C/Fortran程序的开发者,见H₂的C接口实际调用;普通计算用户优先使用可执行程序即可。
独立GIPAW、D3Q、Yambo、Environ等扩展有各自的安装及工作流条件。本页没有把它们列为“加载QE模块后自动全部可用”;需要这些方法时,先确认具体版本、模型和依赖,再选对应教程或补充环境。
7. 实际上手顺序#
先在对应教程中下载小算例,用read.sh/plot.sh查看已算结果,再修改结构和输入,准备赝势,通过自己的Slurm账号提交,最后提取和画图。已有输入检查可以在登录工作目录完成;SCF、响应、动力学等计算使用Slurm分配的计算资源。查看当前可用模块:
module avail qe
module show qe/7.6-p100
每个程序的参数仍以本版输入说明为准,不按文件名或子包名字推断一个未运行的功能已经得到结果。