Home
4606 words
23 minutes
【計算化学】自作pythonライブラリで遷移状態構造を求めてみる(BH9データセットの9. Nucleophilic addition, No. 1, NNP(UMA)使用)
2025-12-21
Computational Chemistry
MultiOptPy
/
python

最終更新：2025-12-21

概要#

本記事では、自作ライブラリ(MultiOptPy)で、BH9データセットの9. Nucleophilic addition, No. 1の素過程の遷移状態構造を算出してみる。計算レベルは、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の汎関数の電子エネルギーの精度の比較などのベンチマークに主に使われることを想定していると考えられる。

使用した自作ライブラリMultiOptPyのバージョン#

v1.20.4

Video Demo#

https://www.youtube.com/watch?v=AE61iY2HZ8Y

環境#

Windows 11

※Windows 11環境下でAnaconda PowerShell Promptを使用した。

Source codeのダウンロード(Unixコマンド)#

wget https://github.com/ss0832/MultiOptPy/archive/refs/tags/v1.20.4.zip
unzip v1.20.4.zip
cd MultiOptPy-1.20.4

https://github.com/ss0832/MultiOptPy/releases/tag/v1.20.4 にアクセスして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.7

4, 先ほど作成した仮想環境を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の自作ライブラリへの導入方法について説明する。

UMAを使用可能にするための手順#

1, 以下のサイトにアクセスして、uma-s-1p1.ptをダウンロードする。（使用許諾が下りていれば可能である。）

https://huggingface.co/facebook/UMA

2, ダウンロード後、MultiOptPy-1.20.4ディレクトリ内に存在するsoftware_path.confに対して、uma-s-1p1.ptの絶対パスを用いて以下を追記する。

uma-s-1p1::(uma-s-1p1.ptの絶対パス)

これで、MultiOptPy-1.20.4がNNPuma-s-1p1を使用できるようになる。

※Linuxの場合#

すでにAnacondaの導入が終わっている前提で、環境の構築手段について述べる。以下を実行すると可能である。

## 1. Download and install MultiOptPy:
wget https://github.com/ss0832/MultiOptPy/archive/refs/tags/v1.20.4.zip
unzip v1.20.4.zip
cd MultiOptPy-1.20.4

## 2. Create and activate a conda environment:
conda env create -f environment.yml
conda activate test_mop

## 3. Copy the test configuration file and run the AutoTS workflow（任意で行う）:
cp test/config_autots_run_xtb_test.json .
python run_autots.py aldol_rxn.xyz -cfg config_autots_run_xtb_test.json


#### Installation via pip (Linux)
conda create -n <env-name> python=3.12 pip
conda activate <env-name>
pip install git+https://github.com/ss0832/MultiOptPy.git@v1.20.4 
# or pip install multioptpy
wget https://github.com/ss0832/MultiOptPy/archive/refs/tags/v1.20.4.zip
unzip v1.20.4.zip
cd MultiOptPy-1.20.4

あとは、「UMAを使用可能にするための手順」と同じように進めれば問題なく導入可能である。

使用する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_9_1.xyzとした。 初期構造は以下のものを使用した。

12
OptimizedStructure
C     -0.428333090170      0.010944621512      0.591200397634
C     -0.439299665203     -1.279903703583     -0.206928167341
H      0.166183633934     -1.207459327384     -1.106494815350
H     -1.482343333638     -1.488847636442     -0.477128635820
H     -0.068097916755     -2.088863705819      0.417316437443
C     -0.477588144172      1.297123873236     -0.211977344909
H      0.136034240669      1.239611046800     -1.107509728423
H     -0.135730079813      2.119315156982      0.411861054796
H     -1.524652655417      1.472381901416     -0.490513165068
C      1.969731985355      0.024577990157      0.409138325747
N      3.056492451902     -0.107716499259      0.009352859147
O     -0.772397426691      0.008836282383      1.761682782143
初期経路を求めるための初期構造

2. 遷移状態構造最適化#

　run_autots.pyを適切に使用することで、自動的に遷移状態構造が得られる。以下にその手順を説明していく。

初期構造をMultiOptPy-1.20.4ディレクトリ内にbh9_9_1.xyzとして保存する。その後、同じディレクトリ内で、config_bh9_9_1.jsonを作成し、以下のように記述する。

config_bh9_9_1.json

{
  "work_dir": "bh9_9_1",
  "top_n_candidates": 3,
  "multioptpy_version": "1.20.4",
  
  "step1_settings": {
    "othersoft": "uma-s-1p1",
    "opt_method": ["rsirfo_block_fsb"],
    "use_model_hessian": "fischerd3",
    "spin_multiplicity": 1,
    "electronic_charge": -1, 
	"manual_AFIR": ["100", "1", "10"]
  },
  
  "step2_settings": {
    "othersoft": "uma-s-1p1",
    "NSTEP": 18,
    "use_model_hessian": "fischerd3",
    "save_pict": true,
	"QSMv2": true,
    "node_distance": 0.40,
    "align_distances_energy_predicted": 1,
    "spin_multiplicity": 1,
    "electronic_charge": -1
  },
  
  "step3_settings": {
    "othersoft": "uma-s-1p1",
    "opt_method": ["rsirfo_block_bofill"],
    "calc_exact_hess": 5,
    "tight_convergence_criteria": true,
    "max_trust_radius": 0.20,
	"min_trust_radius": 0.02,
    "frequency_analysis": true,
	"NSTEP": 500,
	"detect_negative_eigenvalues": false,
    "spin_multiplicity": 1,
    "electronic_charge": -1
  },

  "step4_settings": {
    "othersoft": "uma-s-1p1",
	"opt_method": ["rsirfo_block_bofill"],
    "spin_multiplicity": 1,
    "electronic_charge": -1,
	"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_9_1.xyz -cfg config_bh9_9_1.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.20.4/OPTION_README.mdにて示されている。

Step 1#

Step1では、omolのデータセットを使用したuma-s-1p1モデルのNNPで得たエネルギーに対して、指定した人工力ポテンシャルを加えた上で初期構造を構造最適化を行っている。

以下のJSON内で記述したバイアスポテンシャルで、次の経路緩和アルゴリズムの初期経路として用いるトラジェクトリーを生成する。

  • "manual_AFIR": ["yyy", "a", "b]：yyykJ/molの活性化障壁を超えうるペア同士を近づける力を原子のラベル番号aとbのペアに構造最適化時に加えることを示す。
  • "shape_conditions": ["yyy", "lt", "a,b"]: 構造最適化中に、ラベル番号aの原子とラベル番号bの原子の間の距離yyy(Å)よりも大きくなった時に構造最適化を途中で打ち切る。“lt”を”gt”にすると、yyy(Å)よりも小さくなった時に途中で打ち切る。
  • "shape_conditions": ["yyy", "lt", "a,b,c"]: 構造最適化中に、角度の中心がラベル番号bの原子で、ラベル番号aの原子とラベル番号cで作る角度yyy(degrees)よりも大きくなった時に構造最適化を途中で打ち切る。“lt”を”gt”にすると、yyy(degrees)よりも小さくなった時に途中で打ち切る。
  • "shape_conditions": ["yyy", "lt", "a,b,c,d"]: 構造最適化中に、ラベル番号bとラベル番号cを軸とした、ラベル番号aの原子とラベル番号dの原子がなす二面角yyy(degrees)よりも大きくなった時に構造最適化を途中で打ち切る。“lt”を”gt”にすると、yyy(degrees)よりも小さくなった時に途中で打ち切る。
  • "keep_pot": ["c", "d", "a,b"]:力の定数c a.u.で、平行距離dÅの調和ポテンシャルをa番とb番の原子ペアにかける。初期経路生成時に開裂を防ぎたい結合を保持するとき等に使用する。

Step1が正常終了していれば作成されたwork_dirディレクトリ中に、bh9_9_1_step1_traj.xyzが存在する。必要に応じて確認し、目的に沿った初期経路が得られているか確認する。もし想定とは異なる場合は、プロセスをkillして再度設定を見直してやり直す。

bh9_9_1_step1_traj.xyzは構造最適化の過程をAvogadro（公式ページ:https://avogadro.cc/ ）等で可視化して確認できるようにしている。このbh9_9_1_step1_traj.xyzはStep2のNEB計算に使用している。

※bh9_9_1_step1_traj.xyzをアニメーションとして表示したい場合は、[https://github.com/ss0832/molecule_movie] を使うと良い。

Step 2#

Step2では、NEB法を用いることで、先ほど得られたbh9_9_1_step1_traj.xyz全体のエネルギーを下げることができる。これにより、パスのエネルギー極大値を持つ構造を遷移状態構造に近づける。（この時点ではまだ正確な遷移状態構造は求められていない。）

Step2固有のオプションについて以下に示す。

  • "NSTEP": nはn回分NEB法による経路の緩和を行うことを示す。

  • "save_pict": trueは緩和中のパスのエネルギープロファイルや各ノードの勾配のRMS値をmatplotlibで可視化するオプションである。

  • "node_distance": yyy: 入力された経路を経路座標上でyyy(Å)間隔で線形補間により構造を再配置して初期経路とする。

  • "align_distances_energy_predicted": a:経路緩和a回に1回、経路座標上で等間隔に線形補間により構造を置きなおす。エネルギー極大値を示す構造に対しては前後のノードの情報を使って経路座標を変数とした多項式を作り、真のエネルギー極大値の場所を連続最適化により推定し、再配置する。

MultiOptPy-v1.20.4/"work_dir"と同じディレクトリ内に、NEBという名前を含むディレクトリが生成されている。 そのディレクトリ内のenergy_plot.csvを確認し、緩和後のパスのエネルギー極大値を示す構造を確認する。

経路の緩和後の各ノードのエネルギー一覧(単位) (energy_plot.csvに保存されている。)

NEB計算の結果の可視化
NEB計算の結果の可視化

※bias_force_rms.csvにて、各Iterationごとのすべてのノードの勾配のRMS値を確認できる。

経路緩和の結果、以下の構造がstep3の初期構造として自動的に用いられた。“work_dir”内のbh9_9_1_step3_TS_Opt_Inputs内に保存されたbh9_9_1_ts_guess_X.xyzにて確認が可能である。ts_guessの番号が小さい順にエネルギー値が高い構造を示すようになっている。

※こちら[https://ss0832.github.io/molecule_viewer/] を使うことでも可視化は可能である。

bh9_9_1_ts_guess_1.xyz

12
-1 1
C      -0.247719846254      0.010433004625      0.582424518321
C      -0.410549582652     -1.270813221011     -0.233642681960
H       0.135812979530     -1.240888031022     -1.176264170563
H      -1.478445386418     -1.400180620271     -0.432322835015
H      -0.061458447508     -2.111416693355      0.362588781945
C      -0.442936079641      1.284447767269     -0.236069523757
H       0.112058575869      1.270212855894     -1.174044483246
H      -0.125901448847      2.135377676731      0.363348999623
H      -1.512456865070      1.380965138646     -0.445442813424
C       1.772845836160      0.011957183988      0.432862379882
N       2.899047425381     -0.077252563471      0.191472246215
O      -0.640297160549      0.007157501977      1.765089581979
NEB法により緩和した経路から得られた遷移状態構造を求めるための初期構造 (No.1)

Step 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-1.20.4/"work_dir"ディレクトリ内に生成された新規ディレクトリ内のbh9_9_1_ts_final_X.xyzとして保存されている。)

bh9_9_1_ts_final_1.xyz

12
OptimizedStructure
C     -0.176712491021     -0.000954689835      0.562341150847
C     -0.432304478186     -1.274218852689     -0.252950706978
H      0.057268139259     -1.251956976815     -1.228202827251
H     -1.514913097149     -1.372027224417     -0.389874815354
H     -0.075260668331     -2.132713320711      0.313637203159
C     -0.434032801894      1.272140672371     -0.251880672466
H      0.059224361962      1.254254061174     -1.225432256830
H     -0.084819320720      2.131699460367      0.317904386471
H     -1.516497470864      1.364210513484     -0.393549524290
C      1.754942078480      0.000932212101      0.415208897222
N      2.914204582774      0.009180092022      0.373050491726
O     -0.551098834311     -0.000545947051      1.759748673746
遷移状態構造 (No.1)

12回の反復計算により、停留点に収束した構造が得られた。"frequency_analysis": trueオプションにより生成されたnormal_modes.txtやvibration_animationディレクトリ内の振動モードのアニメーションを確認した。

以下に"frequency_analysis": trueオプションで生成されたnormal_modes.txtの一部を示す。

Mode                                 0                   1                   2
Freq [cm^-1]                     -275.5022            125.4028            135.9206
Reduced mass [au]                   9.3793              4.3988              6.1429
Force const [Dyne/A]               -0.4194              0.0408              0.0669
Char temp [K]                       0.0000            180.4267            195.5594
Normal mode                   x         y         z            x         y         z            x         y         z     
       C                 0.17281    0.00038   -0.01104    0.00026    0.04057   -0.00179    0.00298    0.00175    0.03824
       C                 0.02975    0.01011   -0.01351    0.10846    0.01783   -0.00205    0.07968   -0.00089    0.01668
       H                -0.01206   -0.03822   -0.04023    0.09735    0.06867   -0.00621    0.16889   -0.00324    0.06159
       H                 0.01835    0.09280    0.03875    0.11626   -0.08655    0.00915    0.09267   -0.00833   -0.08008
       H                -0.01372   -0.01789   -0.02517    0.19946    0.05107   -0.00970    0.03344    0.00323    0.05257
       C                 0.02837   -0.00930   -0.01357   -0.11586    0.01766    0.00017    0.06979    0.00329    0.01678
       H                -0.01911    0.03867   -0.04334   -0.11196    0.06859    0.00100    0.15900    0.01089    0.06195
       H                -0.01109    0.01789   -0.02715   -0.20379    0.05072    0.00489    0.01577    0.00153    0.05298
       H                 0.01677   -0.09104    0.04453   -0.12416   -0.08808   -0.00327    0.08243    0.00156   -0.08003
       C                -0.14055   -0.00197    0.02999   -0.00007    0.09682   -0.00340   -0.01322    0.00326    0.10704
       N                -0.14143    0.00006    0.01229    0.00216   -0.16700    0.00650   -0.02348   -0.00691   -0.16247
       O                 0.05733    0.00039   -0.00135    0.00521    0.01244   -0.00013   -0.11869    0.00012    0.00379
       
(...snip...)

その結果、虚振動が１つであることが確認できた。つまりこの構造は遷移状態構造である。

次に、vibration_animation内の虚振動を示す分子振動が示されたxyzファイル(mode_1_XXXi_wave_number.xyz)をAvogadroで確認すると、求められた遷移状態構造の中に、想定される反応系と生成系をつなぐ方向に振動している構造が存在することを確認できた。

終わりに#

　 　自作ライブラリで、UMAモデルのニューラルネットワークポテンシャル(NNP, uma-s-1p1)を用いて、BH9データセットの9. Nucleophilic addition, No. 1の反応のある1つの遷移状態構造を算出する手順を説明した。

参考#

【計算化学】自作pythonライブラリで遷移状態構造を求めてみる(BH9データセットの9. Nucleophilic addition, No. 1, NNP(UMA)使用)
https://ss0832.github.io/posts/20251221_mop_usage_bh9_9_1/
Author
ss0832
Published at
2025-12-21
【計算化学】自作pythonライブラリで遷移状態構造を求めてみる(BH9データセットの8. Nucleophilic substitution, No. 8の化学反応, NNP(UMA)使用)
【計算化学】自作pythonライブラリで遷移状態構造を求めてみる(BH9データセットの9. Nucleophilic addition, No. 10, NNP(UMA)使用)