ABACUS 参数查找与输入示例

下载参数查找工具、982条参数版本记录与258份输入快照，解压进入附件根目录。目录含参数表、来源文件哈希、查询脚本和两张索引图；它不会修改公共软件或提交计算。

1 按参数名直接查#

使用Python3.9或更新版本。集群上可以先加载包含Python的环境：

module load ase/3.29.0
python lookup.py smearing_sigma

输出会告诉你参数所属分类、操作教程、已有输入中的实际取值、完整流程附件，以及使用限制。smearing_sigma在当前ABACUS中的能量单位为Ry；费米–狄拉克占据时表示kBT，不是离子温度。

查询本身只用Python标准库，不需要联网。想看本目录收录范围：

python lookup.py --list

2 413个标题为什么变成424个参数#

3.10.1手册有27个功能组、413个参数标题，其中有nx, ny, nz、md_tfirst, md_tlast等多参数标题。工具拆成424个独立参数名；另保留2026-10-27采集的发展分支手册558个标题、558个参数名。两个版本范围合计982条记录，不是982种物理功能。

发展分支快照不是集群已安装版本，也不等于今天最新提交。即使参数名两边都有，新取值、后端和文件格式仍要按所用版本确认。查到BSE、DFPT、TDOFDFT等手册条目，不代表当前3.10.1或现有构建已经支持。

3 按相关词找参数#

python lookup.py --search spin

它搜索参数名和英文功能分类，返回当前版本与发展分支的相应条目。想搜索中文教程的标题或正文，请用官网文档左侧的搜索框；本工具不是文献搜索器。

4 正确理解三类来源状态#

• 已有成功输入出现字段：258份已发布输入中可找到该参数和值，但可能显式写的是0、关闭状态或默认值，不能据此断言对应非零功能已算过。
• 只在有效INPUT默认值中观察到：程序打印过这个默认字段，不代表该方法已经运行，也不能证明所有编译依赖齐全。
• 手册参考：此附件未收录满足来源条件的显式输入；请按关联教程检查版本、依赖和需要的数据。查不到示例不等于软件必然不支持。

本附件是一个有明确来源范围的参数索引，其他教程可能还有未收入的实际例子。发展分支记录单独标注，不借用当前版本的例子证明新方法可用。

图中蓝色只是字段在输入中显式出现，黄色只是默认输出观察，灰色是手册参考；这些颜色不表示材料性质的实算覆盖率。

5 先读限制，再复制取值#

查询实时脉冲中心：

python lookup.py td_gauss_t0

本版t0填步数，实际中心时刻为t0 × md_dt。改时间步时同步改t0和总步数，不能只换一个数字。

查询线性响应输出：

python lookup.py out_wfc_lr

即使有效INPUT显示开关开启，也不能假定完整激发矢量文件一定生成。当前构建按教程读取实际跃迁表和吸收文件；这个限制与“参数能解析”不同。

查询RDMFT：

python lookup.py rdmft

当前3.10.1原生入口的能量/梯度评价，不等于已经完成轨道和占据全优化。QO的病态投影、旧Si标签实际配Sn赝势/轨道的接口测试，也不能被当成稳定的物理硅模型；脚本和关联教程保留这些区别。

6 怎样使用输入快照#

inputs/*.INPUT只用于查看某个参数在原例里的写法。它们没有单独附上所有STRU、赝势和轨道，不能把这个目录直接当完整算例提交。查询结果给出的完整流程附件，才包含对应计算所需的结构、文件和步骤；模型物理范围仍以原教程为准。

case-evidence.json记录输入快照哈希和原公开附件。全部参数记录在parameters.json，可用普通文本编辑器查看，不必依赖查询脚本只显示的前3个例子。

若要核对附件数据并重画索引图，可执行：

bash analyze.sh

表在reference/analysis/groups.csv，图在reference/figures。这里核对的是文档、来源和值的对应关系，没有新增DFT模拟。

方法范围见官方功能与参数全索引，具体计算从ABACUS专题进入。参数目录依据3.10.1官方手册及已保存的发展分支手册快照整理；不要把版本间的参数标题直接当成当前模块的可用功能清单。