最終更新：2025-11-15
概要
本記事では、自作ライブラリ(MultiOptPy)で、BH9データセットの3. Halogen atom transfer, No. 7の素過程の遷移状態構造を算出してみる。計算レベルは、Meta社のFAIR Chemistryが開発したニューラルネットワークポテンシャル(NNP)であるUMA(Meta’s Universal Model for Atoms)とした。
MultiOptPyは電子状態計算ソフトウェアを用いた分子構造最適化手法の勉強を目的として作成したpythonライブラリである。
MultiOptPyのレポジトリ:https://github.com/ss0832/MultiOptPy
BH9のデータセットについて:
- J. Chem. Theory Comput. 2022, 18, 1, 151–166
https://doi.org/10.1021/acs.jctc.1c00694
この文献のSupporting Informationから、データセットの詳細を確認できる。
有機金属錯体が関わる反応を除いたさまざまなカテゴリの反応がまとめられたデータセットである。DFTの汎関数の電子エネルギーの精度の比較などのベンチマークに主に使われる。
今回使用したニューラルネットワークポテンシャルについて：
- https://ai.meta.com/blog/meta-fair-science-new-open-source-releases/ (UMAの公開に関する記事)
- https://github.com/facebookresearch/fairchem (FAIR Chemistryの提供するGitHubのレポジトリ)
- https://fair-chem.github.io/ (同上のレポジトリの内容に関して説明したサイト)
- https://huggingface.co/facebook/UMA (NNPの配布サイト, Hugging Faceへのアカウント登録と配布元の使用許諾が必要である。)
- arXiv preprint arXiv:2505.08762 (2025). (プレプリント)
使用した自作ライブラリMultiOptPyのバージョン
v1.19.6環境
Windows 11※Windows 11環境下でAnaconda PowerShell Promptを使用した。
Source codeのダウンロード(Unixコマンド)
wget https://github.com/ss0832/MultiOptPy/archive/refs/tags/v1.19.6.zip
unzip v1.19.6.zip
cd MultiOptPy-v1.19.6https://github.com/ss0832/MultiOptPy/releases/tag/v1.19.6 にアクセスしてzipファイルをダウンロードする。Unixコマンドの場合とはディレクトリ名が異なるので都度読み替えていただけると良い。
移動先のディレクトリでrequirements.txtを参照することで、本ソースコードで必要なモジュールを把握することが出来る。導入方法は各自の状況に合わせて適宜LLMとの対話などで調べると良い。
次に述べる環境構築手順を使用する場合は、環境構築が終わった後、pip install -r requirements.txtで本自作モジュールが動作させるために最低限必要なモジュールを導入することが可能である。
環境構築手順
今回は、Windows 11のPower Shellを使用した。初めに、NNPを使用できる環境が整ったAnaconda PowerShell Promptを用意する手順を説明する。
1, https://repo.anaconda.com/archive/ より、Anaconda3-2025.06-1-Windows-x86_64.exeでAnacondaをインストールする。
2, 検索機能を使い、スタートからAnaconda PowerShell Promptを開く。
3, 以下のコマンドを実行し、仮想環境を作成する。
conda create -n (任意の仮想環境名) python=3.12.74, 先ほど作成した仮想環境をconda activate (仮想環境名)で起動させる。
5, 以下のコマンドを実行し、必要なライブラリを導入する。
pip install ase==3.26.0 fairchem-core==2.7.1 torch==2.6.0- fairchem-coreは、FAIR Chemistryが管理しているNNPを動作させるために必要なライブラリである。
- aseはNNPに電子エネルギーを算出したい分子構造を渡すために必要なインターフェイスの役割を果たすために必要なライブラリである。
- torchはPyTorchライブラリを指す。これはニューラルネットワークなどの機械学習を行ったり、学習結果を扱ったりするために必須なライブラリである。
これで、Anaconda PowerShell Promptから仮想環境を立ち上げることで、NNPを使用する準備が整えることが出来る。
次に、NNPを使用するために必要なModelの情報が保存されている.ptファイルのダウンロードおよびNNPの自作ライブラリへの導入方法について説明する。
1, 以下のサイトにアクセスして、uma-s-1p1.ptをダウンロードする。（使用許諾が下りていれば可能である。）
https://huggingface.co/facebook/UMA2, ダウンロード後、MultiOptPy-v1.19.6ディレクトリ内に存在するsoftware_path.confに対して、uma-s-1p1.ptの絶対パスを用いて以下を追記する。
uma-s-1p1::(uma-s-1p1.ptの絶対パス)これで、MultiOptPy-v1.19.6がNNPuma-s-1p1を使用できるようになる。
使用するNNPに関する具体的な説明
今回使用するNNPについて具体的に説明する。
- UMAのModel Checkpointは
uma-s-1p1を使用した。 - 小分子系のトレーニングセットである
Omol25(omol)を使用して学習したニューラルネットワークポテンシャルを使用する。
※自作ライブラリでの具体的な使用の仕方に関しては、ase_calculation_tools.py を参照すると良い。omol以外のモデルを使用したい場合は、現バージョンでは、multioptpy/Calculator/ase_tools/firechem.py内の、self.task_nameを編集することで対応可能である。
手順
1. 初期構造の準備
モデル反応系として、以下の構造を用意した。今回はファイルの名前をbh9_3_7.xyzとした。 初期構造は以下のものを使用した。
23
OptimizedStructure
C 1.012834200234 -1.080282950056 -0.049164804905
F 1.869516918919 2.033869894832 1.013606166751
C 1.649881941350 -1.464767271810 -1.345140227991
C -0.214769355579 -0.373093231706 -0.039858892235
C 1.703542500966 -1.413461073565 1.233143568289
H 1.864174953247 -0.586303774044 -1.963580434464
H 1.003055318902 -2.116801662384 -1.942103515371
H 2.587689497920 -1.991612011890 -1.180305556794
C -0.898531346841 -0.053212430492 -1.238750022720
C -0.804525600901 0.075392081154 1.168129381298
H 1.054052352521 -1.972018691422 1.914381747490
H 2.014670629407 -0.507859172333 1.765474033508
H 2.593156405032 -2.014480540493 1.054526389431
S 1.169632170703 2.964270014597 -0.121071098611
H -0.045451884927 2.391477569745 -0.043138393199
C -1.979505274654 0.798691402536 1.176013160766
C -2.612002167659 1.096465852351 -0.024921899554
C -2.074654595271 0.667466549787 -1.232432256285
H -0.491622171866 -0.370824519984 -2.188678325525
H -2.582396274773 0.902183905149 -2.158143213108
H -0.319522048205 -0.134484673778 2.111181852903
H -2.410193926765 1.139577559165 2.107666421052
Cl -4.089032241762 2.009807174641 -0.0168340807252. 遷移状態構造最適化
run_autots.pyを適切に使用することで、自動的に遷移状態構造が得られる。以下にその手順を説明していく。
初期構造をカレントディレクトリにbh9_3_7.xyzとして保存する。その後、同じディレクトリ内で、config_bh9_3_7.jsonを作成し、以下のように記述する。
config_bh9_3_7.json
{
"work_dir": "bh9_3_7",
"top_n_candidates": 3,
"multioptpy_version": "v1.19.6",
"step1_settings": {
"othersoft": "uma-s-1p1",
"opt_method": ["rsirfo_block_fsb"],
"use_model_hessian": "fischerd3",
"spin_multiplicity": 2,
"electronic_charge": 0,
"manual_AFIR": ["500", "1", "2"]
},
"step2_settings": {
"othersoft": "uma-s-1p1",
"NSTEP": 15,
"ANEB": [3, 5],
"QSM": true,
"use_model_hessian": "fischerd3",
"save_pict": true,
"node_distance_bernstein": 0.80,
"align_distances": 9999,
"spin_multiplicity": 2,
"electronic_charge": 0
},
"step3_settings": {
"othersoft": "uma-s-1p1",
"opt_method": ["rsirfo_block_bofill"],
"calc_exact_hess": 5,
"tight_convergence_criteria": true,
"max_trust_radius": 0.2,
"frequency_analysis": true,
"NSTEP": 500,
"detect_negative_eigenvalues": true,
"spin_multiplicity": 2,
"electronic_charge": 0
},
"step4_settings": {
"othersoft": "uma-s-1p1",
"opt_method": ["rsirfo_block_bofill"],
"spin_multiplicity": 2,
"electronic_charge": 0,
"calc_exact_hess": 10,
"tight_convergence_criteria": true,
"frequency_analysis": true,
"intrinsic_reaction_coordinates": ["0.5", "200", "lqa"],
"step4b_opt_method": ["rsirfo_block_fsb"]
}
}その後、以下のコマンドを実行する。
python run_autots.py bh9_3_7.xyz -cfg config_bh9_3_7.jsonこれにより、これまでの似た内容の記事で行ってきたコマンドの操作をまとめ、遷移状態構造を求める処理を自動的に行う。
具体的な処理の流れは、
Step1. バイアスポテンシャルによるNEB法のための初期経路の作成
Step2. NEB法による経路の緩和
Step3. NEB法により得られた経路のエネルギー極大値を示す構造のうち、エネルギー値が上位の最大で3個
(`run_autots.py`にて、`--top_n X`で最大値を変更可能)の構造を初期構造とした遷移状態構造の算出
(Step4.得られた遷移状態構造に対するIRC計算とIRC経路の末端に存在する構造に対する構造最適化。
こちらは`--run_step4`をコマンドで追記しなければ行わない。)となっている。
run_autots.pyのオプションの説明：
-cfg YYY.jsonは、workflowを実行するためのオプションが記されたJSONファイルの読み込み先を指定する。
これらの一連の結果は、(jsonファイルの"work_dir"にて指定した名前)のディレクトリの中に存在するファイルを開いて確認できる。
以下にすべてのstepで共通のオプションに関する説明を載せる。
"opt_method": ["rsirfo_block_fsb"]は準ニュートン法であるRS-I-RFO法を構造最適化に使用することを示す。初期のへシアンに関しては、特にオプションで指定しない限り、単位行列が使われる。(以前のHessian更新法とは細かな点で異なる方法を使用している。具体的には、複数の座標変位や勾配変位を用いてHessianの更新を行う。)"spin_multiplicity": Zはスピン多重度の指定である。PySCFを使用するときは目的とするスピン多重度に1を引いた値を指定する。（デフォルトでは1が指定される。）"electronic_charge": 0は形式電荷をMとすることを示す。（デフォルトでは0が指定される。）"othersoft": "uma-s-1p1"は今回使用するNNPを指定している。これを使用する際にASEライブラリが必要である。"use_model_hessian": "fischerd3"は、計算コストが非常に低い数式を使用して、近似したHessianを生成する機能を呼び出すオプションである。デフォルトではこの機能は使用されない。
※オプションの説明はMultiOptPy-v1.19.6/OPTION_README.mdにて示されている。
Step 1
Step1では、omolのデータセットを使用したuma-s-1p1モデルのNNPで得たエネルギーに対して、指定した人工力ポテンシャルを加えた上で初期構造を構造最適化を行っている。
以下のJSON内で記述したバイアスポテンシャルで、次の経路緩和アルゴリズムの初期経路として用いるトラジェクトリーを生成する。
"manual_AFIR": ["yyy", "a", "b]：yyykJ/molの活性化障壁を超えうるペア同士を近づける力を原子のラベル番号aとbのペアに構造最適化時に加えることを示す。
Step1が正常終了していれば作成されたwork_dirディレクトリ中に、bh9_3_7_step1_traj.xyzが存在する。必要に応じて確認し、目的に沿った初期経路が得られているか確認する。もし想定とは異なる場合は、プロセスをkillして再度設定を見直してやり直す。
bh9_3_7_step1_traj.xyzは構造最適化の過程をAvogadro（公式ページ:https://avogadro.cc/ ）等で可視化して確認できるようにしている。このbh9_3_7_step1_traj.xyzはStep2のNEB計算に使用している。
※bh9_3_7_step1_traj.xyzをアニメーションとして表示したい場合は、[https://github.com/ss0832/molecule_movie] を使うと良い。
Step 2
Step2では、NEB法を用いることで、先ほど得られたbh9_3_7_step1_traj.xyz全体のエネルギーを下げることができる。これにより、パスのエネルギー極大値を持つ構造を遷移状態構造に近づける。（この時点ではまだ正確な遷移状態構造は求められていない。）
Step2固有のオプションについて以下に示す。
"NSTEP": nはn回分NEB法による経路の緩和を行うことを示す。"align_distances": Xは線形補間で、各ノード間の距離を全て等しくするための処理である。X回の反復計算ごとに本処理を行う。Xを"NSTEP": nよりも大きな数値を指定することで、初期経路に対してのみ処理を行うことが出来る。"node_distance_bernstein": Nはノード間の距離をN Åとして初期経路を作成することを示す。経路作成時に元のノードをベルンシュタイン多項式を用いてがたついた経路を滑らかにする。
→プログラムの仕様上"align_distances": Xの処理を行った後に、"node_distance_bernstein": Nの処理を行うようになっている。
"save_pict": trueは緩和中のパスのエネルギープロファイルや各ノードの勾配のRMS値をmatplotlibで可視化するオプションである。"ANEB": [A, B]これを指定すると、(B+1)回の緩和ごとに、エネルギー極大値を示すノードと前後のノードの間に線形補間でA個の新規ノードを内挿するようにできる。デフォルトではこのような操作は行われない。このオプションを使用するとノードの数が徐々に増えるため、計算コストが使用しない場合と比べて増加する。一方で、エネルギー極大値を示すノード周辺にノードを増加させるため、緩和している経路中のノードが遷移状態構造付近に存在する可能性が高くすることが出来る。
MultiOptPy-v1.19.6/"work_dir"と同じディレクトリ内に、NEBという名前を含むディレクトリが生成されている。 そのディレクトリ内のenergy_plot.csvを確認し、緩和後のパスのエネルギー極大値を示す構造を確認する。
経路の緩和後の各ノードのエネルギー一覧(単位
※bias_force_rms.csvにて、各Iterationごとのすべてのノードの勾配のRMS値を確認できる。
経路緩和の結果、以下の構造がstep3の初期構造として用いられることとなった。“work_dir”内のbh9_3_7_step3_TS_Opt_Inputs内に保存されたbh9_3_7_ts_guess_X.xyzにて確認が可能である。ts_guessの番号が小さい順にエネルギー値が高い構造を示すようになっている。
※こちら[https://ss0832.github.io/molecule_viewer/] を使うことでも可視化は可能である。
bh9_3_7_ts_guess_1.xyz
23
0 2
C 1.142736846793 -0.793200816824 0.013771794183
F 1.793348733196 1.032360236271 0.365696506280
C 1.696977119508 -1.319227927108 -1.288156988635
C -0.226271712870 -0.293033276885 -0.007635293586
C 1.729736389272 -1.354081545295 1.275994535505
H 1.900466923298 -0.515472639061 -2.001054119712
H 0.991244713870 -1.997996316016 -1.788929584276
H 2.613192531258 -1.885369893269 -1.139168309399
C -0.892721694641 -0.011670059064 -1.210969709989
C -0.833730736753 0.104076182295 1.189149288806
H 1.015841355851 -1.954772551272 1.847263445065
H 2.061267049128 -0.540874051685 1.919683781791
H 2.591387422375 -1.978975415906 1.051151214522
S 1.198771887955 2.872717241684 -0.075495718622
H -0.060535482242 2.396427799223 -0.046406914033
C -2.023029202218 0.801581929453 1.194054438795
C -2.639415911950 1.100842139333 -0.013614555162
C -2.091954538754 0.679991581215 -1.215913535691
H -0.467148649837 -0.310683804845 -2.159995423185
H -2.592110776474 0.911840988142 -2.145280138756
H -0.334637509524 -0.095421317013 2.127024542686
H -2.460708568872 1.133059398100 2.123916221056
Cl -4.112706188369 2.017882118529 -0.015085477645Step 3
step3のオプションで、追加での説明を要するものを以下に示す。
"opt_method": ["rsirfo_block_bofill"]は遷移状態構造の最適化向けのoptimizerを指定することを意味する。準ニュートン法であるRS-I-RFO法を使用する。今回は-fcで正確なHessianを計算するようにしているので、初期Hessianは正確なHessianを使用するようになっている。(Bofill法によるHessianの更新法を細かい点で変更している。具体的には、複数の座標変位や勾配変位を用いてHessianの更新を行う。)"saddle_order": 1は一次の鞍点を求めることを指定する。（step3のデフォルトでは一次の鞍点を指定する。それ以外の値の指定は、プログラムの使用目的上想定していないので、行わないことを勧める。）"calc_exact_hess": 5は5回の反復回数当たり1回正確なHessianを計算することを指定する。"frequency_analysis": trueは収束条件を満たした後に基準振動解析を行うことを示す。（自前で実装しているため、あくまで目安として使用することを推奨する。各振動モードをvibration_animation内のxyzファイルで可視化できる。）UMAモデルから算出されるHessianは数値微分により求めているため、原子数Zが多いとZの二乗オーダーで計算コストが急増する。"tight_convergence_criteria": trueは収束条件を厳しくすることを示す。（Gaussianのtightと同等）"max_trust_radius": Dは一回の反復計算ごとの計算されるステップ幅の最大値をDÅ以下にすることを示す。デフォルトでは、"saddle_order": 1を指定すると0.1Åが指定される。"detect_negative_eigenvalues": trueは、初めの計算時(ITR. 0)に、任意の次数の鞍点(遷移状態構造等)を求める際に、正確なへシアンから算出した固有値に１つも負の固有値がない場合、計算を打ち切るオプションである。
実行して得られた正確な遷移状態構造と思われる構造を以下に示す。
(実行して得られた正確な遷移状態構造は計算開始時に、MultiOptPy-v1.19.6/"work_dir"ディレクトリ内に生成された新規ディレクトリ内のbh9_3_7_ts_final_X.xyzとして保存されている。)
bh9_3_7_ts_final_1.xyz
23
OptimizedStructure
C 1.012411391439 -0.711768726913 0.012081757633
F 1.979672834958 1.017516879318 0.012873259294
C 1.604663496285 -1.225455603593 -1.257201424441
C -0.349881684196 -0.213705369064 0.010410285486
C 1.604904869645 -1.227586500924 1.280298422607
H 1.511569865221 -0.504801419137 -2.068443423529
H 1.099766526304 -2.148896264035 -1.566508101139
H 2.661712032423 -1.444601154868 -1.123598824633
C -1.039177712953 0.026751995893 -1.189098910850
C -1.026773676119 0.063959719563 1.208908873459
H 1.118204589344 -2.166982511161 1.569760230433
H 1.495713640181 -0.524224509217 2.103789156263
H 2.666609251755 -1.424015482944 1.146160048134
S 2.891178268889 2.670181426645 -0.056751036553
H 1.710353741408 3.296010980176 -0.152490394306
C -2.314035021610 0.565198448276 1.213599152663
C -2.957689287599 0.798108130516 0.007898778839
C -2.327084090654 0.527435351074 -1.196125387664
H -0.563655683866 -0.180553019787 -2.136910133290
H -2.844156277973 0.708660915547 -2.128115083010
H -0.540479549435 -0.109688900673 2.158042867627
H -2.820739986283 0.777550607900 2.144627166229
Cl -4.573087537162 1.430905007409 0.006792720748停留点に収束した構造が得られた。-freqオプションにより生成されたnormal_modes.txtやvibration_animationディレクトリ内の振動モードのアニメーションを確認した。
以下に-freqオプションで生成されたnormal_modes.txtの一部を示す。
Mode 0 1 2
Freq [cm^-1] -921.6338 22.3695 29.9821
Reduced mass [au] 13.1688 4.1576 10.6900
Force const [Dyne/A] -6.5904 0.0012 0.0057
Char temp [K] 0.0000 32.1847 43.1376
Normal mode x y z x y z x y z
C 0.07061 0.09572 -0.00014 0.00197 -0.00728 -0.02782 0.01454 -0.04073 0.00525
F -0.09586 -0.16026 0.00448 -0.00287 -0.00499 -0.01169 -0.01555 -0.02464 -0.00202
C 0.00478 0.00442 0.00393 -0.00626 -0.00323 -0.03293 0.01666 -0.04152 0.00659
C -0.01561 0.01456 0.00001 0.00259 -0.00578 -0.01827 0.01591 -0.03693 0.00347
C 0.00373 0.00425 -0.00377 0.01017 -0.01267 -0.03355 0.01539 -0.03516 0.00705
H -0.00479 -0.00513 0.00112 -0.02927 -0.00694 -0.03371 0.02007 -0.04128 0.00646
H -0.03612 0.01052 0.06612 0.00642 -0.01361 -0.02339 0.01497 -0.04015 0.00519
H 0.00050 -0.00428 -0.00585 -0.00117 0.01427 -0.04456 0.01580 -0.04436 0.00869
C 0.00188 -0.00190 0.00464 -0.04230 -0.10447 -0.01202 0.02759 -0.01071 0.00221
C 0.00269 -0.00195 -0.00479 0.04938 0.09722 -0.01556 0.01257 -0.04358 0.00284
H -0.03647 0.00914 -0.06926 0.00479 -0.00921 -0.03206 0.01794 -0.03554 0.01029
H -0.00721 -0.00845 0.00043 0.02299 -0.01508 -0.03013 0.01310 -0.03247 0.00447
H 0.00045 -0.00388 0.00513 0.00776 -0.01989 -0.04245 0.01585 -0.03334 0.00804
S 0.03386 0.05604 -0.00268 -0.01954 0.00758 0.06575 -0.12478 0.03623 -0.01058
H -0.03961 -0.08861 0.00382 -0.02417 -0.00143 0.06378 -0.17177 -0.04166 0.05864
C -0.00267 -0.00044 0.00025 0.05240 0.10369 -0.00854 0.02225 -0.01855 0.00117
C -0.00037 -0.00046 0.00023 0.00601 0.00257 -0.00379 0.03632 0.01391 0.00005
C -0.00236 -0.00082 -0.00041 -0.04211 -0.10276 -0.00482 0.03772 0.01513 0.00047
H 0.00593 0.00691 0.00508 -0.08081 -0.18929 -0.01284 0.03068 -0.00554 0.00263
H 0.00258 0.00264 -0.00118 -0.07845 -0.18274 -0.00020 0.04792 0.03935 -0.00048
H 0.00734 0.00579 -0.00603 0.08738 0.18064 -0.01982 0.00287 -0.06647 0.00364
H 0.00203 0.00176 0.00107 0.09008 0.18739 -0.00711 0.02013 -0.02147 0.00070
Cl 0.00265 -0.00095 0.00003 0.00834 0.00862 0.00548 0.05347 0.05756 -0.00234
(...snip...)その結果、虚振動が１つであることが確認できた。つまりこの構造は遷移状態構造である。
次に、vibration_animation内の虚振動を示す分子振動が示されたxyzファイル(mode_1_XXXi_wave_number.xyz)をAvogadroで確認すると、求められた遷移状態構造の中に、想定される反応系と生成系をつなぐ方向に振動している構造が存在することを確認できた。
終わりに
自作ライブラリで、UMAモデルのニューラルネットワークポテンシャル(NNP, uma-s-1p1)を用いて、BH9データセットの3. Halogen atom transfer, No. 7の反応のある1つの遷移状態構造を算出する手順を説明した。
参考
- https://github.com/ss0832/MultiOptPy (自作ライブラリMultiOptPyのレポジトリ)
- https://avogadro.cc/ (Avogadro、分子構造可視化ツール)
- https://ai.meta.com/blog/meta-fair-science-new-open-source-releases/ (UMAの公開に関する記事)
- https://github.com/facebookresearch/fairchem (FAIR Chemistryの提供するGitHubのレポジトリ)
- https://fair-chem.github.io/ (同上のレポジトリの内容に関して説明したサイト)
- https://huggingface.co/facebook/UMA (NNPの配布サイト, Hugging Faceへのアカウント登録と配布元の使用許諾が必要である。)
- arXiv preprint arXiv:2505.08762 (2025). (プレプリント)
- The Journal of Chemical Physics 2010, 132, 241102.
- The Journal of Chemical Physics 1991, 94, 751–760.
- In Classical and Quantum Dynamics in Condensed Phase Simulations; WORLD SCIENTIFIC: LERICI, Villa Marigola, 1998; pp 385–404.
- The Journal of Chemical Physics, 2020, 153, 024109.
- The Journal of Chemical Physics, 2022, 144, 214108.
- J. Phys. Chem. A 2019, 123, 3761−3781 http://dx.doi.org/10.1021/acs.jpca.9b01546 (MOBH35のデータセットについて)