Quantum ESPRESSO ph.x 参数设置

注:内容为AI辅助生成并由本人进行校对,部分未校对的内容未必正确,后面会持续更新并校对。

目录

  1. 概述与工作流
  2. &INPUTPH — 主输入参数
  3. q 点设置
  4. 输出文件与后处理工具
  5. LO/TO 劈裂与 NAC 校正
  6. 电声耦合与超导(lambda.x)
  7. 典型输入文件模板
  8. 常见问题与排查

1. 概述与工作流

ph.x 是 Quantum ESPRESSO 的 DFPT 声子计算模块。与 Phonopy 不同,它不需要外部超胞生成——DFPT 直接在原胞倒空间计算动力学矩阵,q 网格密度等效于实空间超胞大小。

完整工作流

1
2
3
4
5
pw.x (scf)     → 获得基态电荷密度
ph.x (q 网格) → 对每个不可约 q 点计算动力学矩阵 D(q)
q2r.x → 将 D(q) 傅里叶变换为实空间力常数 Φ(R)
matdyn.x → 从力常数插值得到任意 q 点声子频率(画能带)
dynmat.x → 单个 q 点的对角化与模式分析

输入文件

1
2
3
4
5
6
7
8
&INPUTPH
prefix = 'my_calc' ! 与 pw.x scf 的 prefix 一致
outdir = './tmp' ! 与 pw.x 的 outdir 一致
fildyn = 'dynmat' ! 动力学矩阵输出前缀
tr2_ph = 1.0d-14 ! 声子收敛阈值
ldisp = .true. ! 自动 q 网格计算
nq1=4, nq2=4, nq3=4 ! q 网格密度
/

2. &INPUTPH — 主输入参数

prefix / outdir / fildyn

1
2
3
prefix = 'my_calc'
outdir = './tmp'
fildyn = 'dynmat'
参数 含义
prefix 与 pw.x scf 计算一致的前缀
outdir 临时文件目录,与 pw.x 一致
fildyn 动力学矩阵输出文件前缀,实际生成 <fildyn>0, <fildyn>1, … <fildyn>N

tr2_ph

1
tr2_ph = 1.0d-14    ! 声子微扰自洽收敛阈值
场景 推荐值
常规声子 1.0d-12 ~ 1.0d-14
高精度(力常数 / 虚频排查) 1.0d-16
快速测试 1.0d-10

这是 ph.x 最重要的收敛参数。太松会导致虚频或力常数不准确。

epsil

1
epsil = .true.    ! 计算介电张量和 Born 有效电荷(LO/TO 劈裂必须)

等价于 VASP 的 LEPSILON = .TRUE.。仅对 q = Γ 有效,通常与 ldisp = .true. 配合使用——程序会自动处理 Γ 点。

ldisp — 自动 q 网格

1
2
ldisp = .true.          ! 自动在 q 网格上计算
nq1 = 4, nq2 = 4, nq3 = 4 ! q 网格密度
参数 含义
ldisp .true. = 自动按 MP 网格生成 q 点
nq1, nq2, nq3 三个方向的 q 网格密度(等同于 k 网格的逻辑)

设置 ldisp = .true. 后,不需要在输入文件中手动写 q 点列表。

start_q / last_q

1
2
start_q = 1           ! 起始不可约 q 点索引
last_q = 10 ! 终止不可约 q 点索引

用于分片并行:把 q 网格拆成多段,每段作为一个独立 ph.x 作业分别提交。不做分片时保持默认(全部计算)。

alpha_mix

1
alpha_mix(1) = 0.7    ! 电荷密度混合系数
问题 调整方向
ph.x 不收敛 减小 alpha_mix(1) 至 0.3–0.5
收敛慢 适度增大

recover

1
recover = .true.    ! 从上次中断续算

electron_phonon

1
electron_phonon = 'interpolated'   ! 计算电子-声子耦合矩阵元

输出文件可用于 EPW(electron-phonon Wannier)计算。注意计算电声耦合时前面的SCF.fit部分要加上la2F = .true.并用致密的k网格生成a2Fsave文件,然后再进行一遍常规SCF计算,之后ph.x同时读取SCF.fit的a2Fsave与SCF的电荷密度进行电声计算。

lshift_q

1
lshift_q = .false.    ! .true. = 移动 q 网格(避免 Γ 点的赝势奇异性问题)

trans — 输出电声耦合文件

1
trans = .true.    ! 输出 elph.inp_lambda.N 文件
参数 含义
trans = .true. 为 lambda.x 生成 elph.inp_lambda.N 文件(每个不可约 q 点一个)

仅在设置 electron_phonon = 'interpolated' 时有意义。

zeu / zue — 有效电荷与介电常数

1
2
zeu = .true.    ! 计算 Born 有效电荷 Z*
zue = .true. ! 计算介电常数 ε(等价于 epsil)
参数 含义 与 epsil 的关系
zeu = .true. 从声子计算中提取 Born 有效电荷 Z* epsil=.true. 时自动输出 Z*
zue = .true. 从声子计算中提取介电张量 ε 等价于 epsil=.true.

通常直接使用 epsil = .true. 即可同时获得 ε^∞ 和 Z*。zeu/zue 为历史遗留参数,独立设置这些 flag 的场景很少。

lraman — Raman 散射截面

1
lraman = .true.    ! 计算 Raman 散射活性

在 Γ 点计算非共振 Raman 散射张量,输出三个偏振方向的 Raman 强度和退偏比。仅对 q = Γ 有效。需要 epsil = .true. 或使用 zeu/zue 预先获得 Born 电荷和介电常数。

elop — 电光系数(Pockels 效应)

1
elop = .true.    ! 计算电光张量

计算线性电光效应(Pockels)系数和二次电光效应(Kerr)系数。需要 epsil = .true. 和电场微扰。仅对绝缘体有效。


3. q 点设置

方式 A:自动 q 网格(推荐)

1
2
3
4
&INPUTPH
ldisp = .true.
nq1 = 4, nq2 = 4, nq3 = 4
/

程序自动生成 4×4×4 Monkhorst-Pack q 网格,遍历所有不可约 q 点,每个 q 点输出一个 <fildyn>N 文件。

方式 B:手动 q 路径(能带用)

1
2
3
4
5
6
7
8
9
10
&INPUTPH
ldisp = .false.
lqdir = .true. ! 为每个 q 点创建独立子目录,避免覆盖
/
5 ! 高对称点数量
0.000 0.000 0.000 1 ! Γ, weight=1
0.500 0.000 0.000 1 ! X
0.500 0.500 0.000 1 ! M
0.000 0.000 0.000 1 ! Γ
0.500 0.500 0.500 1 ! R

注意:手动 q 点方式的坐标是 2π/a 单位(与 K_POINTS {tpiba} 一致)。

方式 C:单个 q 点

1
2
3
4
&INPUTPH
ldisp = .false.
/
0.0 0.0 0.0 ! q = Γ

q 网格密度建议

与 k 网格逻辑相同:nq_i × |a_i| ≈ 常数。经验上 4×4×4 起步,力常数收敛测试需加到 6×6×6 或更密。


4. 输出文件与后处理工具

ph.x 输出

文件 内容
<fildyn>0 q=(0,0,0) 的动力学矩阵
<fildyn>1, <fildyn>2, … 各不可约 q 点的动力学矩阵
<prefix>.dyn 或 <prefix>.dyn.xml XML 格式动力学矩阵(VASP 风格)

每个 <fildyn>N 文件包含:

  • Bravais 晶格与原子坐标
  • 当前 q 点坐标
  • 声子本征频率与模式
  • 动力学矩阵元 D_{iα,jβ}(q)

q2r.x — q → R 傅里叶变换

将倒空间动力学矩阵变换为实空间力常数(等效 Phonopy 的 FORCE_CONSTANTS)。

1
2
3
4
5
6
7
8
cat > q2r.in << 'EOF'
&INPUT
fildyn = 'dynmat' ! 与 ph.x 的 fildyn 一致
flfrc = 'fc.mat' ! 输出力常数文件名
zasr = 'crystal' ! 声学求和规则
/
EOF
q2r.x < q2r.in > q2r.out
参数 含义 默认值
fildyn ph.x 输出的动力学矩阵前缀 必填
flfrc 输出实空间力常数文件名 必填
zasr 声学求和规则: 'no', 'simple', 'crystal'(推荐), 'one-dim', 'zero-dim' 'no'
loto_2d 2D 体系的 LO-TO 修正(真空方向 NAC 处理不同) .false.
write_lr 将 NAC 长程部分也写入 flfrc(asr='all' 时需要) .false.

3D 体系直接使用默认参数即可——Born 电荷数据从 dyn 文件自动检测分离,无需额外 flag。2D 体系需设 loto_2d = .true.。若 matdyn.x 使用 asr='all',需在 q2r.x 中设 write_lr = .true.。

matdyn.x — 声子能带 / 态密度

从力常数插值到任意 q 点,生成声子色散和态密度。

输入参数

参数 含义
flfrc q2r.x 输出的力常数
flfrq 输出频率数据
dos .true. = 同时计算声子态密度
nk1, nk2, nk3 DOS 积分的 q 网格(dos=.true. 时需要)
q_in_band_form 默认 .false.;.true. = 路径段模式(每行终点+点数)
q_in_cryst_coord 默认 .false.(q 坐标为 2π/a 直角坐标);.true. = 晶体分数坐标

q 点输入格式

默认(q_in_band_form = .false.):逐个列出所有离散 q 点,每行一个。

1
2
3
4
5
6
5                          ! q 点总数
0.000 0.000 0.000 ! q1
0.500 0.000 0.000 ! q2
0.500 0.500 0.000
0.000 0.000 0.000
0.500 0.500 0.500

坐标默认以 2π/a 为单位(直角坐标)。若设 q_in_cryst_coord = .true.,则为晶体分数坐标。没有路径段的概念,每个点独立输出。

q_in_band_form = .true.(路径段模式):每行写一段的终点坐标 + 段内点数,起点自动承接上一段的终点(首段起点默认为 Γ)。

1
2
3
4
5
4                          ! 段数(不是 q 点数!)
0.333 0.577 0.0 40 ! K, 40 个点
0.000 0.577 0.0 20 ! M
0.000 0.000 0.0 30 ! Γ
0.000 0.000 0.0 1 ! 最后一段回到 Γ,1 表示终点

每行 4 个数:终点 q 坐标(3 个) + 点数(1 个)。程序在相邻终点间线性插值。这种写法比逐点列举更紧凑,且不容易把路径接错。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
cat > matdyn.in << 'EOF'
&INPUT
asr = 'crystal'
flfrc = 'fc.mat'
flfrq = 'phonon_band.dat'
q_in_band_form = .true.
dos = .false.
/
4 ! 4 段
0.500 0.000 0.000 20 ! X
0.500 0.500 0.000 20 ! M
0.000 0.000 0.000 20 ! Γ
0.500 0.500 0.500 1 ! R
EOF
matdyn.x < matdyn.in > matdyn.out

matdyn.x 不分高对称标签列(不像 K_POINTS {crystal_b} 那样写 G X M Γ 标签),只接收纯数值坐标。

dynmat.x — 单个 q 点模式分析

1
2
3
4
5
6
7
8
cat > dynmat.in << 'EOF'
&INPUT
fildyn = 'dynmat0'
asr = 'crystal'
filout = 'dynmat_out'
/
EOF
dynmat.x < dynmat.in > dynmat.out

5. LO/TO 劈裂与 NAC 校正

极性材料在 Γ → 0 时限的 LO/TO 劈裂由长程电偶极相互作用引起,需非解析项校正(NAC)。ph.x 通过 epsil = .true. 获取 Born 有效电荷和介电张量。

ph.x 阶段:获取 Born 电荷

1
2
3
&INPUTPH
epsil = .true. ! 计算 ε^∞ 和 Z*(仅对 Γ 点有效)
/

若使用 ldisp = .true.,程序自动在遍历 q 网格时对 Γ 点做 epsil 计算。

q2r.x 阶段:力常数中包含 NAC

1
2
3
4
5
6
7
cat > q2r.in << 'EOF'
&INPUT
fildyn = 'dynmat'
flfrc = 'fc.mat'
zasr = 'crystal'
/
EOF

q2r.x 读取动力学矩阵文件时,若检测到 Born 电荷数据(由 epsil=.true. 写入),会自动将 NAC 贡献分离为短程力常数 + 长程偶极项,写入 flfrc 文件。3D 体系无需额外参数;2D 体系需设 loto_2d = .true.。

matdyn.x 阶段:NAC 默认自动生效

matdyn.x 读取 flfrc 时,Born 电荷和 ε^∞ 已内嵌在文件中,NAC 默认自动应用(loto_disable = .false.)。程序自动重建含 NAC 的动力学矩阵,声子能带在所有 q 路径上显现 LO/TO 劈裂。

1
2
3
4
5
6
7
&INPUT
asr = 'crystal'
flfrc = 'fc.mat'
flfrq = 'phonon_band.dat'
loto_disable = .false. ! 默认值,NAC 自动生效
loto_2d = .false. ! 2D 体系需设为 .true.(真空方向 LO-TO 处理不同)
/
参数 含义
loto_disable 默认 .false.(NAC 自动开启)。设为 .true. 可关掉 LO/TO 劈裂用于对比验证
loto_2d 默认 .false.。2D 材料需设为 .true.,否则真空方向的 NAC 处理不正确
read_lr 默认 .false.。是否同时读取 q2r.x 预存的长程力常数;通常不需要手动开启

若 ph.x 未设 epsil = .true.,flfrc 中自然不含 Born 电荷数据,loto_disable 设置无效——劈裂不会出现。NAC 的源头始终是 ph.x 中的 epsil。

效果验证

1
2
ω_LO ≠ ω_TO   at q → 0 along different directions
ω_LO > ω_TO (Lyddane-Sachs-Teller)

若设置 epsil = .false. 重新计算,Γ 点光学支应退化(无劈裂)。


6. 电声耦合(lambda.x)

lambda.x 是电声耦合计算的最后一步,读取 ph.x(设 trans=.true.)输出的 elph.inp_lambda.N 文件(每个不可约 q 点一个),计算总耦合常数 λ 和超导 Tc。

有两种等价路径获得 λ 和 α²F(ω):

路径 流程 特点
直接法 ph.x → lambda.x 直接从离散 q 点的 elph 数据求 λ,快速,不需 q2r/matdyn
插值法 ph.x → q2r.x → matdyn.x 将离散 q 点数据变换到实空间再插值回连续 q 空间,得到更平滑的 α²F(ω) 和 γ(q) 曲线,收敛性更好

两条路径可独立使用也可互为验证。完整流程(含 la2F 的两个 pw.x SCF + q2r + matdyn)见 §7 模板 4。

输入文件(纯文本格式,非 namelist)

1
2
3
4
5
6
7
<emax>  <degauss>  <smearing>    ! 第 1 行
<nq> ! 第 2 行
<qx> <qy> <qz> <weight> ! 第 3 行起:每个 q 点及其权重(共 nq 行)
...
<elph_file_1> ! 第 nq+3 行起:ph.x 输出的电声文件(共 nq 行)
...
<mu_star> ! 最后一行:Coulomb 赝势 μ*

实际示例(8 个 q 点的 Al):

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
10  0.12  1                      ! emax(THz), degauss(Ry), smearing(1=Gaussian)
8 ! q 点数量
0.000 0.000 0.000 1.00 ! q1, weight
-0.250 -0.250 0.250 8.00
-0.500 -0.500 0.500 4.00
0.000 0.000 0.500 6.00
-0.250 -0.250 0.750 24.00
-0.500 -0.500 1.000 12.00
0.000 0.000 1.000 3.00
-0.500 0.000 1.000 6.00
elph_dir/elph.inp_lambda.1 ! ph.x 输出的 elph 文件,按 q 顺序一一对应
elph_dir/elph.inp_lambda.2
...
elph_dir/elph.inp_lambda.8
0.10 ! μ* (Coulomb pseudopotential)
行 内容 说明
1 emax degauss smearing 最大声子能量 (THz);展宽 (Ry);展宽方法 (1=Gaussian)
2 nq q 点数量
3–(nq+2) qx qy qz weight 每个不可约 q 点的坐标(2π/a 单位)和权重
(nq+3)–(2nq+2) 文件路径 ph.x 输出的 elph.inp_lambda.N 文件,一行一个
最后一行 μ* 有效 Coulomb 赝势(通常 0.10–0.15)

运行

1
lambda.x < lambda.in > lambda.out

关键输出

输出文件 内容
lambda.out 总耦合常数 λ、ω_log、各个声子支的分波贡献
a2F.dat α²F(ω) 谱(ω, α²F, λ(ω))

输出解读

1
2
lambda = 0.85
omega_log = 250.0 K
物理量 含义
λ 电声耦合常数,λ > 0.5 通常预示有超导可能
ω_log 对数平均声子频率
α²F(ω) Eliashberg 谱函数,声子态密度按耦合强度加权

Tc 估算(McMillan-Allen-Dynes 公式)

1
Tc = (ω_log / 1.2) exp[ -1.04(1+λ) / (λ - μ*(1+0.62λ)) ]

其中 μ* 为有效库仑赝势(通常取 0.10–0.15)。

常见问题

问题 原因 解决方法
lambda.x 报 “file not found” ph.x 未设 trans = .true. 或缺少 elph 文件 检查 ph.x 设置和 elph_dir/ 路径
λ 值太小 q 网格太稀 加密 nq1,nq2,nq3
双 δ 积分噪声大 k 网格太稀 pw.x 的 k 网格至少 16×16×16

7. 典型输入文件模板

模板 1:完整声子计算(q 网格 → 力常数 → 能带)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
! ====== 步骤 1: pw.x SCF ======
&CONTROL
calculation = 'scf'
prefix = 'si'
outdir = './tmp'
pseudo_dir = './pseudo'
/
&SYSTEM
ibrav = 0
nat = 2
ntyp = 1
ecutwfc = 60.0
ecutrho = 480.0
occupations = 'fixed'
/
&ELECTRONS
conv_thr = 1.0d-10
/
ATOMIC_SPECIES
Si 28.086 Si.pbe-n-rrkjus_psl.1.0.0.UPF
ATOMIC_POSITIONS {crystal}
Si 0.00 0.00 0.00
Si 0.25 0.25 0.25
K_POINTS {automatic}
8 8 8 0 0 0
CELL_PARAMETERS {angstrom}
5.430 0.000 0.000
0.000 5.430 0.000
0.000 0.000 5.430
1
2
3
4
5
6
7
8
9
! ====== 步骤 2: ph.x q 网格 ======
&INPUTPH
prefix = 'si'
outdir = './tmp'
fildyn = 'si_dyn'
tr2_ph = 1.0d-14
ldisp = .true.
nq1 = 4, nq2 = 4, nq3 = 4
/
1
2
3
4
5
6
! ====== 步骤 3: q2r.x 力常数 ======
&INPUT
fildyn = 'si_dyn'
flfrc = 'si_fc.mat'
zasr = 'crystal'
/
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
! ====== 步骤 4: matdyn.x 声子能带 ======
&INPUT
asr = 'crystal'
flfrc = 'si_fc.mat'
flfrq = 'si_band.dat'
q_in_band_form = .true.
dos = .false.
/
6
0.500 0.000 0.500 20 ! L
0.000 0.000 0.000 20 ! Γ
0.500 0.000 0.500 20 ! L
0.500 0.250 0.750 20 ! W
0.375 0.375 0.750 20 ! K
0.000 0.000 0.000 1 ! Γ

模板 2:极性材料(含 LO/TO 劈裂)

1
2
3
4
5
6
7
8
9
10
11
! ====== ph.x ======
&INPUTPH
prefix = 'fe2cl2o'
outdir = './tmp'
fildyn = 'fe2cl2o_dyn'
tr2_ph = 1.0d-14
epsil = .true. ! LO/TO 劈裂必须
ldisp = .true.
nq1 = 4, nq2 = 4, nq3 = 1
alpha_mix(1) = 0.5 ! +U 体系 SCF 收敛困难,降低混合系数
/
1
2
3
4
5
6
! ====== q2r.x ======
&INPUT
fildyn = 'fe2cl2o_dyn'
flfrc = 'fe2cl2o_fc.mat'
zasr = 'crystal'
/
1
2
3
4
5
6
7
8
9
10
11
12
13
! ====== matdyn.x ======
&INPUT
asr = 'crystal'
flfrc = 'fe2cl2o_fc.mat'
flfrq = 'fe2cl2o_band.dat'
q_in_band_form = .true.
/
5
0.000 0.000 0.000 20 ! X
0.500 0.000 0.000 20 ! M
0.500 0.500 0.000 20 ! Γ
0.000 0.000 0.000 20 ! Z
0.000 0.000 0.500 1 ! Z(终点)

模板 3:分片并行(大 q 网格拆分)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
! Job 1: q 点 1-5
&INPUTPH
prefix = 'big'
outdir = './tmp'
fildyn = 'dyn'
tr2_ph = 1.0d-14
ldisp = .true.
nq1 = 6, nq2 = 6, nq3 = 6
start_q = 1
last_q = 5
/

! Job 2: q 点 6-10
&INPUTPH
...
start_q = 6
last_q = 10
/
...

运行前先跑一次 ldisp = .true. 看输出中总共多少不可约 q 点,再按数量均分。


模板 4:电声耦合完整流程(插值法)

路径选择:此模板走 ph.x → q2r.x → matdyn.x → lambda.x 的插值法,α²F(ω) 更平滑。若只需快速得到 λ 和 Tc,可在步骤 3 后跳过步骤 4–6 直接 lambda.x(见 §6)。

1
2
3
4
5
6
7
pw.x SCF (密 k 网格, la2F=.true.)  → 电子态密度基底
pw.x SCF (正常 k 网格) → 声子计算的基态电荷密度
ph.x (elph, q 网格) → 力常数 + 电声矩阵元 |g|²
q2r.x (la2F=.true.) → 力常数和 elph 数据傅里叶变换到实空间
matdyn.x (dos=.false., la2F) → γ(q)
matdyn.x (dos=.true., la2F) → α²F(ω) 和 λ
lambda.x → 最终 λ、ω_log、Tc
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
! ====== 步骤 1: pw.x SCF — 密 k 网格(la2F=.true.)======
&CONTROL
calculation = 'scf'
prefix = 'aluminum'
outdir = './tmp'
pseudo_dir = './pseudo'
/
&SYSTEM
ibrav = 2, celldm(1) = 7.5, nat = 1, ntyp = 1
ecutwfc = 15.0
occupations = 'smearing', smearing = 'marzari-vanderbilt', degauss = 0.05
la2F = .true. ! 保存电子 DOS 数据供后续使用
/
&ELECTRONS
conv_thr = 1.0d-8
/
ATOMIC_SPECIES
Al 26.98 Al.pz-vbc.UPF
ATOMIC_POSITIONS {alat}
Al 0.00 0.00 0.00
K_POINTS {automatic}
16 16 16 0 0 0 ! 必须比正常 k 网格密得多
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
! ====== 步骤 2: pw.x SCF — 正常 k 网格(声子用)======
&CONTROL
calculation = 'scf'
prefix = 'aluminum'
outdir = './tmp'
pseudo_dir = './pseudo'
/
&SYSTEM
ibrav = 2, celldm(1) = 7.5, nat = 1, ntyp = 1
ecutwfc = 15.0
occupations = 'smearing', smearing = 'marzari-vanderbilt', degauss = 0.05
/
&ELECTRONS
conv_thr = 1.0d-8
/
ATOMIC_SPECIES
Al 26.98 Al.pz-vbc.UPF
ATOMIC_POSITIONS {alat}
Al 0.00 0.00 0.00
K_POINTS {automatic}
8 8 8 0 0 0 ! 正常 k 网格
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
! ====== 步骤 3: ph.x — 力常数 + 电声矩阵元 ======
&INPUTPH
tr2_ph = 1.0d-10
prefix = 'aluminum'
fildvscf = 'aldv' ! 微扰势导数存储
amass(1) = 26.98
outdir = './tmp'
fildyn = 'al.dyn'
electron_phonon = 'interpolated'
el_ph_sigma = 0.005 ! 双 δ 积分展宽 (Ry)
el_ph_nsigma = 10 ! 多个展宽值,输出到 a2Fq2r.*
trans = .true. ! 输出 elph.inp_lambda.N(lambda.x 需要)
ldisp = .true.
nq1 = 4, nq2 = 4, nq3 = 4
/
1
2
3
4
5
6
7
8
9
10
# ====== 步骤 4: q2r.x — 力常数 + elph 数据到实空间 ======
cat > q2r.in << 'EOF'
&INPUT
zasr = 'simple'
fildyn = 'al.dyn'
flfrc = 'Al444.fc'
la2F = .true. ! 同时处理电声耦合数据
/
EOF
q2r.x < q2r.in > q2r.out
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# ====== 步骤 5: matdyn.x — γ(q) 计算 ======
cat > matdyn.in.freq << 'EOF'
&INPUT
asr = 'simple'
amass(1) = 26.98
flfrc = 'Al444.fc'
flfrq = 'Al444.freq'
la2F = .true.
dos = .false.
/
19 ! q 点数量
0.000 0.000 0.000 0
0.125 0.000 0.000 0
... ! 其余 q 点
EOF
matdyn.x < matdyn.in.freq > matdyn.out.freq
1
2
3
4
5
6
7
8
9
10
11
12
13
14
# ====== 步骤 6: matdyn.x — α²F(ω) 和 λ ======
cat > matdyn.in.dos << 'EOF'
&INPUT
asr = 'simple'
amass(1) = 26.98
flfrc = 'Al444.fc'
flfrq = 'Al444.freq'
la2F = .true.
dos = .true.
fldos = 'phonon.dos'
nk1 = 10, nk2 = 10, nk3 = 10, ndos = 50
/
EOF
matdyn.x < matdyn.in.dos > matdyn.out.dos
1
2
# ====== 步骤 7: lambda.x — 最终 λ 和 Tc ======
lambda.x < lambda.in > lambda.out

关键参数说明:la2F=.true. 需在 pw.x、q2r.x、matdyn.x 中分别设置;el_ph_sigma 控制双 δ 积分的展宽,可设多个值(el_ph_nsigma)做收敛测试;k 网格密度是电声耦合计算的瓶颈,16×16×16 仅为示例,实际计算可能需要 24×24×24 以上。

8. 常见问题与排查

问题 可能原因 解决方法
ph.x 不收敛 alpha_mix 不当 / tr2_ph 太紧 减小 alpha_mix(1) 至 0.3;放宽 tr2_ph;减小 nq
+U 体系 ph.x 发散 alpha_mix(1) 太大 减小至 0.3–0.5
出现虚频 原胞未充分弛豫 / tr2_ph 太松 / q 网格太稀 收紧 tr2_ph 至 1.0d-16;加密 q 网格;检查 EDIFF 和 EDIFFG
q2r.x 报错 “wrong number of q points” q 网格不完整 确保所有不可约 q 点均已计算(不要漏跑或跳号)
matdyn.x 频率异常 asr 设置错误 确认 asr = 'crystal'(3D 体系)
LO/TO 不劈裂 epsil = .false. 设为 .true.
epsil 计算失败 Γ 点不在 q 网格中 使用 ldisp = .true.;或手动将 0 0 0 作为第一个 q 点
ph.x 占用内存过大 大超胞 / 密集 q 网格 使用 reduce_io = .true.;分片并行
多个 <fildyn>N 文件不连续 分片并行时 start_q / last_q 交叉 检查分片边界不重叠、不遗漏
动力学矩阵不满足求和规则 平移对称性被数值误差破坏 检查 zasr = 'crystal' 并在 q2r.x 中启用

参考文献

  1. S. Baroni, S. de Gironcoli, A. Dal Corso, P. Giannozzi, Rev. Mod. Phys. 73, 515 (2001). — DFPT 理论基础
  2. Quantum ESPRESSO 官方文档: https://www.quantum-espresso.org/Doc/INPUT_PH.html
  3. A. Togo, I. Tanaka, Scr. Mater. 108, 1 (2015). — Phonopy(与 ph.x 的对比参考)