QE六方晶胞参数与ibrav转换
用六方晶胞实际运行scan_ibrav,核对CELL_PARAMETERS、A/C与celldm的单位、基矢和体积,说明多个匹配及输出限制。
阅读本篇目录
已有三条晶格向量时,可以直接用ibrav=0输入,也可以在明确晶格类型后转换成对应ibrav及晶格参数。本篇用a=3Å、c=5Å的六方原胞,实际运行QE的scan_ibrav.x,解释转换过程。
这里只检查晶胞几何,没有添加原子、赝势或进行DFT。晶胞形状本身不能确定某个材料的空间群。
1.查看原始数据和图#
下载完整输入、实际扫描输出、CSV与画图脚本,保存为example.zip:
python3 -m zipfile -e example.zip .
cd qe-hexagonal-cell
bash read.sh
bash plot.sh
cat analysis/QE-hexagonal-cell.csv
QE-scan-ibrav-settings.csv列出20种Bravais设置的原生报告;另一个CSV给出三条输入基矢与按参数重新生成的基矢。
2.四行输入怎样写#
cat inputs/hexagonal-A/input.txt
完整内容是:
angstrom
3 0 0
-1.5 2.598076211353316 0
0 0 5
第一行给长度单位,后面每行一条晶胞基矢。程序也接受bohr,但不要把Å数值直接放到bohr输入里。
重新运行这一个例子:
bash prepare.sh
bash run.sh
bash read.sh work-new analysis-new
直接手动操作时,核心命令为:
module load qe/7.6-8173m
cd work-new/hexagonal-A
scan_ibrav.x < input.txt > native.out
这是轻量晶胞预处理,不需要启动pw.x或准备POTCAR/UPF。集群QE7.6 CPU构建采用oneAPI2024.2编译器、IntelMPI和MKL环境;本例以普通账号单进程、单线程实际运行。
3.读出ibrav=4的参数#
原生输出中,六方设置对应这一段:
Scanning ibrav 4
Minimization succeeded (chisq=0.8E-25)
ibrav = 4
celldm( 1) = 5.669178374
celldm( 3) = 1.666666667
celldm(1)是以bohr为单位的a,不是Å;celldm(3)是比值c/a,不是c的绝对长度。使用QE常数1bohr=0.529177210903Å,得到:
a = 5.669178374 × 0.529177210903 ≈ 3 Å
c = a × 1.666666667 ≈ 5 Å
因此在自己的pw.x输入中,晶胞参数可选择下面任一组写法,不要把两组同时写入。
! 写法一:长度直接用Å
ibrav = 4
A = 3.0
C = 5.0
! 写法二:a用bohr,c用c/a
ibrav = 4
celldm(1) = 5.669178374
celldm(3) = 1.666666667
这些是&SYSTEM中的晶胞参数片段,不是完整的DFT输入;还需要填写自己体系的原子、赝势、截断、k点等设置。具体定义见QE官方pw.x输入说明。
4.三条基矢怎样对应#
ibrav=4的标准基矢为:
a1 = (a, 0, 0)
a2 = (-a/2, sqrt(3)*a/2, 0)
a3 = (0, 0, c)

本例a1、a2长度都为3Å,夹角120°,a3长度5Å,体积为38.97114317ų。图中画的是平行六面体原胞,不是把外轮廓画成六边形的多胞棱柱。
配套read.py根据原生celldm重新构造基矢,独立核对输入、单位和体积。判断转换是否正确时,应检查这些几何关系,而不只是看到某个ibrav编号。
5.为什么还会报告其他匹配#
更一般的晶格参数化也能表示高对称晶胞。因此本例除了ibrav=4,还出现三斜ibrav=14等匹配;这不表示材料同时具有多个空间群,也不应该自动选择输出中的第一个匹配。
这个版本的扫描程序会在拟合后探测哪些参数影响结果,部分分支打印的at1/at2/at3可能仍是探测时的向量。不要盲目复制这些打印向量替换自己的结构;本篇采用ibrav=4参数,并按标准公式重新构造、与输入核对。
更换基矢方向时,还要核对原子坐标。若只是整体旋转晶胞,Cartesian原子位置必须同步旋转;如果改变晶格基底或原胞选取,分数坐标也要作相应变换,不能只替换晶格行。
6.什么时候直接用ibrav=0#
如果已经有可信的晶胞矩阵,尤其是结构优化得到的低对称晶胞,可以直接写:
! &SYSTEM中
ibrav = 0
! 晶胞卡片
CELL_PARAMETERS angstrom
3 0 0
-1.5 2.598076211353316 0
0 0 5
这样不用先把任意晶胞拟合成某个Bravais编号。仍需保证原子位置与该晶胞一致。
本篇只示范已正常完成的六方输入。扫描程序在另外一些晶胞上可能长时间停留在某个拟合分支;资料包运行器保留20秒限时,不自动无限重试。遇到这种情况,优先使用明确的晶格参数或ibrav=0,不需要为了开始自己的DFT计算而等待扫描结束。