QE 泛函查询:名称、Libxc与默认参数
实际查询PZ、PBE、PBEsol、SCAN、PBE0、HSE和显式Libxc PBE,读懂组成项、库来源、精确交换比例与屏蔽参数。
阅读本篇目录
写 input_dft 前,可以先用 qe_xc_infos.x 查看泛函名称如何被当前QE版本解析。它会列出LDA、GGA、meta-GGA的交换/关联组成、使用QE内置实现还是Libxc,以及可用的默认参数和参考文献。查询本身不运行SCF,也不会计算某个材料的能量。
下载7组真实输入输出、结果表与绘图脚本。本例使用QE 7.6 CPU版,主要编译环境为oneAPI 2024.2、Intel MPI 2021.13、MKL与Libxc;单进程、单线程查询,每个名称约0.01–0.02秒。
1. 最短的使用方式#
module load qe/7.6-8173m
qe_xc_infos.x
出现 Insert DFT name: 后,输入一个名称,例如:
PBE
也可以保存输入,便于记录:
printf 'PBE\n' > functional.in
qe_xc_infos.x < functional.in > functional.out
cat functional.out
这类信息查询只需要一个进程,不要使用多进程MPI启动同一次查询。
2. 先看实测结果#
unzip qe-XC-info-wave1277-*.zip
cd qe-XC-info
bash read.sh
bash plot.sh
cat analysis/QE-XC-components.csv

每个格子上方是组成项ID,下方是库来源。ID是各库内部的编号,没有物理大小含义;QE内部的3与Libxc的101不能按数值比较。none表示这个槽位没有独立项,不表示整个泛函没有该类物理贡献。
| 输入名称 | 本例解析结果 |
|---|---|
| PZ | QE内置LDA交换和PZ关联 |
| PBE | QE内置LDA基础项与PBE梯度修正 |
| PBESOL | QE内置PBEsol组成 |
| SCAN | 解析为Libxc MGGA交换263与关联267 |
| PBE0 | QE内置混合GGA,默认精确交换比例0.25 |
| HSE | QE内置屏蔽混合GGA,默认精确交换比例0.25、屏蔽参数0.106 bohr⁻¹ |
| 显式Libxc PBE | GGA交换101与关联130 |
SCAN的短名称在本版会转换为Libxc组合。因此,看到名称是SCAN,不能据此认定它使用QE内部的旧包装编号。本例记录的是程序最终打印出的组成。
3. 如何读PBE输出#
LDA
Exchange ID: 1, Library: QE_internal ; Correlation ID: 4, Library: QE_internal
GGA
Exchange ID: 3, Library: QE_internal ; Correlation ID: 4, Library: QE_internal
MGGA
Exchange ID: 0, Library: none ; Correlation ID: 0, Library: none
随后按组成项列出名称、泛函族、交换/关联类型、参数和文献。这里LDA与GGA两行是QE内部实现的分解方式,不能把它们当成需要用户在输入文件中重复添加的两套完整泛函。
4. 查询显式Libxc组合#
本例实际使用:
printf 'XC-000I-000I-101L-130L-000I-000I\n' > libxc.in
qe_xc_infos.x < libxc.in > libxc.out
cat libxc.out
六个槽位依次为LDA交换、LDA关联、GGA交换、GGA关联、MGGA交换、MGGA关联;I表示QE内部项,L表示Libxc项,000表示该槽位不启用。本例的101L/130L组合对应Libxc PBE交换和关联。
不要用QE内部ID替代Libxc ID。也不要因为两种输入都打印“PBE”,就直接认为不同版本、参数或实现的能量逐点完全相同;这里验证了名称解析和参数读取,没有额外运行数值等价性的SCF比较。
在实际PW输入中,相关字段位于 &SYSTEM,例如:
&SYSTEM
ibrav = 0,
nat = 2,
ntyp = 1,
ecutwfc = 60,
input_dft = 'PBE'
/
其余结构、赝势、k点与电子收敛设置应按QE首次计算教程准备。input_dft会覆盖程序读取到的泛函选择,应与自己的研究方法和赝势适用条件相符。
5. 混合泛函还要看默认参数#
printf 'HSE\n' > hse.in
qe_xc_infos.x < hse.in > hse.out
cat hse.out
本例打印:
exx_fraction (default)= 0.250000000000000
screening_parameter (default)= 0.106000000000000
屏蔽参数单位为bohr⁻¹。查询工具显示的是该名称在当前程序中的默认值,不会读取某个SCF输入里后来显式修改的参数。记录计算方法时,应保留最终实际使用的QE输入文件及计算日志,写明自己使用的 exx_fraction、screening_parameter 等设置。
6. 从资料包重新查询#
bash prepare.sh
bash run.sh
会在新建的 work-new 中依次查询7个输入,原始参考结果保留。若已经有该目录,请换一个新的解压目录。工具能解析一个名称,只能说明当前查询入口识别它;涉及所需导数、特定计算模块、CPU/GPU后端与赝势时,仍应核对对应功能和实际计算输出。此工具也不覆盖全部vdW泛函信息。
参考:QE PW输入说明。本例的短名称解析以实际使用的QE 7.6源码及原生输出为准。