跳转至

1.1 读懂 INPUT、STRU 与 KPT

版本与执行状态。 核心语法按官方 ABACUS v3.9.0 文档和示例核对,核对日期为 2026-10-05。官方发布列表另有稳定版 v3.10.1 和 3.11 测试标签;本课程使用可追溯的 v3.9.0 基线,不声称它是最新版。以下均为未执行的教学模板。初始参数需要验证,不能当作已经收敛的推荐结果。本文不提供虚构的能量、计时或收敛曲线。

INPUT、STRU 与 KPT 的物理数据关系,以及实空间晶胞与倒空间采样示意

打开原尺寸图

1.1.1 问题:哪些文件定义了物理模型?

在让 ABACUS 求能量以前,先问:另一位读者能否复原相同的晶体与哈密顿量?INPUT 选择计算任务和数值表示,STRU 描述物种、外部数据、晶格与原子,KPT 描述倒空间采样。它们不是把 VASP 输入改个文件名。这里采用固定离子、非磁性、双原子金刚石硅原胞,使用待检验的小网格,先学习文件含义,再讨论精度。

完整说明还包括可执行文件版本、编译库、赝势数据,以及 LCAO 所用数值轨道。这些条件任一改变都可能改变结果。建立简短运行清单,记录文件哈希、来源、版本标签和目标可观测量。不要只写“默认参数”;不同基组和版本的默认值并不相同,也不一定适合硅。

前提与安装边界。 需要可用的 ABACUS 可执行文件、受支持运行环境、科学数据文件、文本编辑器及足够完成小算例的本地内存。安装属于独立任务,应参照 官方 v3.9.0 安装文档,选择与目标求解器一致的串行或 MPI 库。Windows 读者可在本地准备文本,但不能假定 Linux MPI 命令能在普通 PowerShell 直接运行;应使用已经获得授权的兼容 Linux 环境。本节不安装软件,也不修改集群环境。

授权计算前记录发行标签或源码 Git 提交、二进制 SHA-256,以及安装提供的编译和库清单。实际计算时保存日志启动横幅,核实真正使用的可执行文件。不要假设旧版本中没有核验的 abacus --version 一定安全;课程不依赖这一标志,也不会为探测版本启动程序。检查公开科学输入及校验和无需执行电子结构计算。具备可用安装和来源匹配数据后,下面的三文件模板即可供学习者开展自己的受控检验。

1.1.2 完整的三文件示例

INPUT

INPUT_PARAMETERS
suffix si_pw
calculation scf
basis_type pw
ntype 1
pseudo_dir ../data/pseudo
ecutwfc 60
scf_thr 1e-9
scf_nmax 150
nspin 1
smearing_method fixed
mixing_type broyden
mixing_beta 0.4
ks_solver cg
out_chg 1 10

STRU

ATOMIC_SPECIES
Si 28.085 Si.pz-vbc.UPF

LATTICE_CONSTANT
10.2

LATTICE_VECTORS
0.0 0.5 0.5
0.5 0.0 0.5
0.5 0.5 0.0

ATOMIC_POSITIONS
Direct
Si
0.0
2
0.00 0.00 0.00 0 0 0
0.25 0.25 0.25 0 0 0

KPT

K_POINTS
0
Gamma
4 4 4 0 0 0

Si.pz-vbc.UPF 和 Si_lda_8.0au_50Ry_2s2p1d 来自官方硅示例,分别是 LDA 赝势和 LDA 数值原子轨道。PW 只需要 UPF,LCAO 两者都需要。 这些外部文件本文没有附带下载。按基组需要获取来源匹配文件,检查头信息、保存哈希值;赝势放入 ../data/pseudo/,LCAO 另将轨道放入 ../data/orbitals/。文件名相同不保证内容相同。输入不指定 dft_functional,使程序采用 UPF 记录的交换关联泛函。若改用 PBE,LCAO 必须重新选择并记录匹配的 PBE 赝势与轨道;只添加 dft_functional PBE 并不能构成一致的新模型。

1.1.3 解读晶格与坐标

LATTICE_CONSTANT 的单位为 bohr;晶格矢量是乘以该尺度的无量纲系数。Direct 原子位置是相对于原胞矢量的分数坐标,不能把第二个原子的 0.25 0.25 0.25 读作埃,也不能当作常规胞笛卡尔坐标的比例。按上述矢量换算,它在常规笛卡尔坐标中是 \((a/4,a/4,a/4)\),其中 \(a=10.2\) bohr,最近邻距离为

\[d=\frac{\sqrt{3}}{4}a.\]

无量纲晶格矩阵的行列式为 \(1/4\),所以原胞体积为 \(V=a^3/4\),不是 \(a^3\)。这些代数关系无需运行模拟就能核验。换算长度时可用 \(1\) bohr 约等于 \(0.529177\) 埃。位置后的三个标志控制结构任务中各坐标分量能否移动;0 0 0 表示有意固定原子。物种下面的 0.0 是初始磁矩,不是原子电荷。

KPT 的 K_POINTS、0、Gamma 和网格行组成语法结构。这里的 0 指自动生成网格,绝不是没有物理 k 点;最后三个零是偏移量。对称性可能把完整网格的 64 个点约化为更少的不可约点,因此不能仅因日志中点数较少便认定网格损坏。

1.1.4 运行审计与输出定位

为每个算例建立独立目录,保留三个原始输入文件。在已配置好的本地 Linux 环境中,可以参考下列启动形式。可执行文件和 MPI 启动器必须符合实际编译环境;本课程编写时没有执行该命令。不要把陌生模板直接提交到生产队列。

OMP_NUM_THREADS=1 mpirun -np 2 abacus > screen.log 2>&1

依次阅读 screen.log 与 OUT.<suffix>/running_scf.log。提取最终能量以前,核对实际版本、基组、晶胞、物种、赝势、占据方式和电子迭代状态。基线版本的最终能量标记为 !FINAL_ETOT_IS,单位是 eV,但只有该标记并不证明 SCF 成功;失败运行也可能留下类似能量的值。保存完整迭代轨迹和警告。out_chg 1 10 要求以十位输出精度写出密度 cube,并不代表电子收敛阈值更严格。非自旋极化算例在确认收敛后才分析 SPIN1_CHG.cube。 运行前,从算例工作目录核验所有相对路径。pseudo_dir 会与 STRU 中每个物种的赝势文件名拼接。不要把 shell 的上一个目录或编辑器项目目录误认为运行目录。保留原始输入与程序生成输入记录,但必须区分含义:v3.9.0 输出文档提示 OUT./INPUT 可能包含初始默认值,而非实际有效设置。应从运行日志核验接受参数,不能把生成文件当作实际参数的权威记录。

1.1.5 不虚构结果的验收

检查 需要记录的证据 验收依据
物理晶胞 晶格矩阵、原子数、最近邻距离 两个 Si 原子与预期原胞一致
外部文件 可读路径与哈希值 使用预期 UPF,没有隐式替换
单位 晶格尺度与换算说明 区分 bohr 与分数坐标
电子结果 残差轨迹与终止状态 明确成功收敛
数值精度 截断与网格扫描 留待第 2 章验证,不能假定

只有真实运行通过检查后才填写能量。解析器接受文件只证明语法可读;显示很多小数位的能量仍可能来自错误晶胞或不完整基组。本节的目的,是在长计算之前把这类错误暴露出来。

1.1.6 易错点与练习

常见错误包括:不比较倒格矢长度便把常规胞 k 网格复制到原胞;在 bohr 尺度下直接写以埃为单位的晶格数值;把移动标志当作磁性数据。缺少赝势时应该找到正确数据,不能拿无关 UPF 改名凑数。

  1. 坐标练习。 把第二个原子变换到笛卡尔坐标,并用代数求原胞体积。提示:将分数坐标乘以三个晶格矢量,先完成矢量求和,再乘以 \(a\);体积用行列式,最后再把 bohr 的三次方换成埃的三次方。
  2. 文件关系练习。 把运行目录移动到更深一层,哪些路径需要检查?提示:几何不变,但相对 pseudo_dir 和 orbital_dir 可能需要更新。以新工作目录解析路径,重新比对哈希;修复路径不应改变所用物理数据。

完成审计后,继续学习 PW 硅计算,区分数值误差与 LDA 的物理局限。

1.1.7 官方参考与来源

这些来源用于核验文件语法与可用选项。解释、比较设计、代数练习和图示为原创教学内容,未把公开示例能量当作本课程结果。课程首页参考部分另收集学习资源。大学关联的 2024 指南仅作补充教学,不能代替已固定版本的输入参考。