QE专题

QE 泛函查询:名称、Libxc与默认参数

实际查询PZ、PBE、PBEsol、SCAN、PBE0、HSE和显式Libxc PBE,读懂组成项、库来源、精确交换比例与屏蔽参数。

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

写 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

当前版本对7个实际输入的组成解析

每个格子上方是组成项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源码及原生输出为准。

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

查看配图

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

100%查看原图 ↗