he_hartree_numerov.py ドキュメント

概要

he_hartree_numerov.py は、ヘリウム原子の基底状態( \(1s^2\) )を対象として、制限ハートリー(Restricted Hartree)法に基づいた自己無撞着場(SCF)計算を行うPythonプログラムです。動径方向のシュレディンガー方程式を両側Numerov(ヌメロフ)法を用いて数値的に解き、軌道エネルギーおよび全エネルギーを評価します。

理論的背景

対象コードは、ヘリウム原子のような2電子系を扱う物理シミュレーションプログラムであり、以下の物理的・数学的モデルに基づいて計算を行います。全角運動量がゼロの閉殻系であるため、制限ハートリー方程式は自己相互作用と交換積分が相殺する閉殻ハートリー・フォック(HF)方程式と一致します。

制限ハートリー方程式とポテンシャル

電子の動径波動関数を \(u(r) = r R(r)\)、動径確率密度を \(p(r) = u(r)^2\) と定義します。規格化条件は以下の通りです。

\[\int_{0}^{\infty} p(r) dr = \int_{0}^{\infty} u(r)^2 dr = 1\]

1電子が感じる有効ポテンシャル \(V_{\mathrm{eff}}(r)\) は、原子核からの引力ポテンシャルと、もう一方の電子が作るハートリーポテンシャル \(V_H(r)\) の和になります。

\[V_{\mathrm{eff}}(r) = -\frac{2}{r} + V_H(r)\]

ここで、 \(V_H(r)\) はガウスの法則と静電ポテンシャルの定義から、以下の積分で計算されます。

\[V_H(r) = \frac{1}{r} \int_{0}^{r} p(s) ds + \int_{r}^{\infty} \frac{p(s)}{s} ds\]

1電子の動径シュレディンガー方程式は、軌道エネルギーを \(\epsilon\) として以下のように表されます。

\[-\frac{1}{2} \frac{d^2 u(r)}{dr^2} + V_{\mathrm{eff}}(r) u(r) = \epsilon u(r)\]

数値解法(Numerov法)

上記の方程式を、Numerov法に適した2階常微分方程式の標準形 \(u''(r) = q(r)u(r)\) に変形します。

\[\frac{d^2 u(r)}{dr^2} = 2 \left( V_{\mathrm{eff}}(r) - \epsilon \right) u(r) = q(r) u(r)\]

プログラム内では、粗いグリッドでの三重対角行列の固有値計算( scipy.linalg.eigh_tridiagonal )により固有値の目安を得ます。その後、原点 \(r=0\) 側からの外向き積分と、遠方 \(r=r_{\mathrm{max}}\) 側からの内向き積分を独立に行い、適切な接続点でロンスキアンのミスマッチを評価します。このミスマッチがゼロになるような \(\epsilon\) を scipy.optimize.brentq を用いて探索することで、正確な軌道エネルギーと波動関数を決定します。

全エネルギーの計算

SCF反復、または初期波動関数を用いたエネルギー評価において、系の全エネルギー \(E_{\mathrm{total}}\) は以下の成分から計算されます。

\[E_{\mathrm{total}} = 2 (T + V_{\mathrm{ne}}) + J\]

各成分の定義は以下の通りです( \(T\) は運動エネルギー、 \(V_{\mathrm{ne}}\) は核引力ポテンシャルエネルギー、 \(J\) は電子間クーロンエネルギー)。

\[T = \frac{1}{2} \int_{0}^{\infty} \left( \frac{du(r)}{dr} \right)^2 dr\]
\[V_{\mathrm{ne}} = \int_{0}^{\infty} p(r) \left( -\frac{2}{r} \right) dr\]
\[J = \int_{0}^{\infty} p(r) V_H(r) dr\]

動作要件と依存ライブラリ

本プログラムの実行には、以下のPython環境およびライブラリが必要です。

  • Python 3環境

  • 標準ライブラリ: argparse, csv

  • 非標準ライブラリ:

    • numpy

    • scipy

    • matplotlib

入出力仕様

コマンドライン引数

プログラムはコマンドライン引数を通じて実行時のパラメータを設定します。

  • --iter : SCFの最大反復回数を指定します(デフォルト: \(1\)、ワンショット計算)。

  • --mixing : 新しい密度の混合割合を \((0, 1]\) の範囲で指定します(デフォルト: \(0.3\))。

  • --tol : 密度のL1残差許容誤差、およびデフォルトのエネルギー許容誤差。単位は \(\mathrm{Ha}\)(デフォルト: \(10^{-8}\))。

  • --tol-energy : エネルギー許容誤差。単位は \(\mathrm{Ha}\)。指定された場合は --tol のエネルギー基準を上書きします。

  • --ngrid : 動径方向の空間グリッド区間数を指定します(デフォルト: \(6000\))。

  • --rmax : 計算を行う外側境界の半径。単位は \(\mathrm{Bohr}\)(デフォルト: \(30.0\))。

  • --zeta : 初期推測として用いる水素様波動関数の指数を指定します(デフォルト: \(2.0\))。

  • --no-plot : 実行後に計算結果のプロット(グラフ)画面を表示しないフラグです。

  • --savefig : プロット結果を保存する画像ファイル名(パス)を指定します。

  • --csv : SCFの収束履歴を保存するCSVファイル名を指定します。

出力仕様

  • 標準出力:

    • SCF計算の反復ごとに、電子数、軌道エネルギー \(\epsilon\)、全エネルギー \(E_{\mathrm{total}}\)、エネルギー変化量、および密度のL1残差を出力します。

    • 計算終了時に、ビリアル定理の残差( \(2T + V_{\mathrm{ne}} + J\) )や各エネルギー成分の詳細を出力します。

  • CSVファイル:

    • --csv が指定された場合、反復回数、電子数、エネルギー値、残差などの詳細な履歴が書き出されます。

  • グラフ描画:

    • --no-plot が指定されていない場合、動径電子密度、有効ポテンシャル、SCF収束履歴のグラフが画面に表示されます。 --savefig が指定されていれば、その内容が画像ファイルとして保存されます。

実行例

以下は、コマンドラインからプログラムを実行するための具体的な実行例です。

初期密度を用いたワンショット計算(デフォルト動作):

python he_hartree_numerov.py

SCF計算を最大100回行い、収束判定の許容誤差を \(10^{-8}\) に設定して実行する例:

python he_hartree_numerov.py --iter 100 --mixing 0.3 --tol 1e-8

プロット画面を表示せず、計算履歴をCSVファイルに保存する例:

python he_hartree_numerov.py --iter 100 --no-plot --csv history.csv