ORCA Compound自动化:键长扫描与循环控制
用原生Compound脚本生成H2五个键长并依次计算,读回每步能量,再用实际运行的数组、分支、continue和break示例理解流程控制。
阅读本篇目录
下载完整输入、真实原生输出、生成的子步输入、CSV与绘图脚本。经常需要重复计算一组相似结构时,可以让ORCA自身的Compound脚本管理变量、循环、计算步骤和结果读取,不必手工改五次输入。
本篇在鸢算科技集群实际执行H2五点RHF/6-31G单点扫描,另外运行一个不启动电子结构的流程控制示例。粗网格扫描只比较采样点,不等于结构优化,也不据五个点提取振动频率。
1. 先读结果,再准备自己的输入#
unzip orca-Compound-H2-wave1155-*.zip
cd orca-Compound-H2
bash read.sh
bash plot.sh
cat analysis/ORCA-Compound-H2-scan.csv
reference-results/scan/保留原始输出和实际展开的子步输入。读数据和绘图不会重新计算电子结构。

2. 完整五点扫描脚本#
inputs/scan/input.inp:
%Compound
Variable bonds = {0.6,0.7,0.8,0.9,1.0};
Variable energies[5];
Variable distance = 0.0;
For i from 0 to 4 Do
distance = bonds[i];
NewStep
! RHF 6-31G VeryTightSCF
%maxcore 1024
* xyz 0 1
H 0 0 0
H 0 0 &{distance}
*
StepEnd
Alias current;
Read energies[i] = JOB_INFO_TOTAL_EN[current];
print("YS_SCAN %d %.12lf %.12lf\n", i, distance, energies[i]);
EndFor
End
bonds是五个距离,坐标单位Å;数组下标从0开始,因此循环为0到4。energies[5]预留五个结果位置。更改采样数量时,要同时调整距离数组、能量数组长度和循环范围。
NewStep ... StepEnd描述一次真正的计算,&{distance}把当前变量代入坐标。H1固定在原点,H2只沿z移动。RHF/6-31G规定电子结构方法和基组,VeryTightSCF控制电子收敛,0 1是中性单重态。
Alias current给刚完成的计算步骤命名;Read从该步骤的JOB_INFO_TOTAL_EN读回能量。最后一行打印下标、距离和能量,不是另算一次。这里的current是脚本内别名,不是操作系统目录。
3. 如何提交与查看进度#
bash prepare.sh
sbatch job.slurm
squeue -u "$USER"
tail -f work-new/scan/native.log
prepare.sh只生成输入,拒绝覆盖已有work-new/;默认作业1任务、1CPU、4G内存,顺序运行扫描和控制示例。按账号可用CPU分区调整job.slurm。
环境为module load orca/6.1.1,官方预编译OpenMPI 4.1.8安装包。供应商编译器版本未据MPI版本推定。脚本按完整路径启动ORCA驱动一次,不要在外面重复套mpirun或srun。完成后:
bash read.sh work-new analysis-new
bash plot.sh analysis-new figures-new
4. 查看真正生成了什么#
grep '^YS_SCAN' reference-results/scan/native.log
cat reference-results/scan/input_Compound_3.inp
grep 'FINAL SINGLE POINT ENERGY' reference-results/scan/native.log
input_Compound_3.inp对应第三个计算点,即数组下标2、距离0.8 Å。脚本的数组下标和自动生成文件的编号口径不同,不要混淆。
| 数组下标 | H—H距离/Å | 原生返回能量/Eh |
|---|---|---|
| 0 | 0.6 | −1.110030896125 |
| 1 | 0.7 | −1.126123161552 |
| 2 | 0.8 | −1.123712935679 |
| 3 | 0.9 | −1.111686373314 |
| 4 | 1.0 | −1.094807961952 |
五个采样点中0.7 Å能量最低,不能直接称为优化键长。若要找平衡结构,应另做优化或更细致、有依据的扫描。图中的连线仅引导读图,没有拟合未计算的势能。
5. 数组、条件、跳过与提前退出#
inputs/flow-variable-names/input.inp完整内容:
%Compound
Variable values = {1,2,3,4,5};
Variable accumulated = 0;
Variable arrayLength = values.GetSize();
Variable myFile = "H2.data";
Variable fileStem = myFile.GetBasename();
Variable fileExtension = myFile.GetSuffix();
For i from 0 to 9 Do
if (i=2) then
continue;
endif
if (i>4) then
break;
endif
accumulated = accumulated + values[i];
print("YS_FLOW_VISIT %d\n",i);
EndFor
print("YS_FLOW_SUM %d\n", accumulated);
print("YS_FLOW_SIZE %d\n",arrayLength);
print("YS_FLOW_NAME %s %s\n",fileStem,fileExtension);
End
这是Compound语法,条件相等使用本例中的i=2,不要按其他语言习惯随意改写。continue跳过本次循环剩余部分,break结束循环。因此i=2没有累加,i=5在访问数组前退出,也不会访问不存在的values[5]。
变量应避免与解释器关键字或内部标识符重名;这里使用accumulated、myFile、fileStem等明确名称。GetSize()返回数组长度,文件名方法把H2.data拆为H2和data。

6. 原生输出应该是什么#
grep '^YS_FLOW' reference-results/flow-variable-names/native.log
cat analysis/ORCA-Compound-flow.csv
YS_FLOW_VISIT 0
YS_FLOW_VISIT 1
YS_FLOW_VISIT 3
YS_FLOW_VISIT 4
YS_FLOW_SUM 12
YS_FLOW_SIZE 5
YS_FLOW_NAME H2 data
该输入没有NewStep,因此只演示控制流程,不启动电子结构计算。实际扫描则有五个收敛的SCF子步,返回值与各步原生单点能量一致。
7. 换成自己的任务时#
先用少量结构确认变量代入、电子收敛、结果读取和编号,再扩大参数范围。每次保留输入、输出及实际生成的子步输入;不要只看打印标签就判断计算成功。若改变电荷、自旋、方法或基组,应明确说明比较的物理含义,避免直接混合不同设置的总能。
本例仅演示实际运行过的扫描和控制命令。更多语法见ORCA Compound官方手册与详细语法。