plot_wf.py ドキュメント

概要

plot_wf.py は、水素原子における電子の波動関数、およびその絶対値、位相、確率密度分布などを多様な形式で可視化するための Python スクリプトです。コマンドラインから指定するモードと関数タイプに応じて、静的な3D表面プロット、等値面表現、確率密度に比例した3D散布図、さらにそれらの時間発展や空間回転を表現するアニメーションを作成・保存することができます。

量子力学的な現象を視覚的に理解するためのシミュレーション・解析ツールとして機能します。

理論的背景と計算手法

水素原子における電子の定常状態の波動関数 \(\psi_{nlm}(r, \theta, \phi)\) は、シュレディンガー方程式の極座標系での変数分離によって得られ、動径波動関数 \(R_{nl}(r)\) と球面調和関数 \(Y_l^m(\theta, \phi)\) の積として記述されます。

\[\psi_{nlm}(r, \theta, \phi) = R_{nl}(r) Y_l^m(\theta, \phi)\]

ここで、\(n\) は主量子数、\(l\) は方位量子数、\(m\) は磁気量子数を表します。 動径波動関数 \(R_{nl}(r)\) はラゲールの陪多項式を用いて表され、電子が原子核から距離 \(r\) の位置に見出される確率に寄与します。動径方向の確率密度分布 \(P_{nl}(r)\) は次式で定義されます。

\[P_{nl}(r) = r^2 |R_{nl}(r)|^2\]

角度成分である球面調和関数 \(Y_l^m(\theta, \phi)\) はルジャンドルの陪多項式を含み、電子雲の空間的な形状と配向を決定します。波動関数の全空間における存在確率は正規化されており、全空間積分は \(1\) となります。

本スクリプトでは、空間的な電子の分布を視覚化するために「リジェクションサンプリング(棄却法)」を用いたモンテカルロシミュレーションが実装されています(dot, dotc, dotanim モードなど)。この手法では、確率密度 \(|\psi_{nlm}|^2\) に比例するような3次元座標 \((X, Y, Z)\) の乱数サンプリングを行い、それらを3D空間上に散布図として描画することで、量子力学的な電子雲を直感的に可視化しています。また、波動関数の複素数の位相(偏角)情報はカラーマップを用いて表現されます。

動作環境

本スクリプトの実行には、Pythonの標準ライブラリに加えて以下の非標準ライブラリが必要です。

  • numpy

  • scipy

  • matplotlib

また、以下の外部モジュールが同じ環境(パスが通っているディレクトリ)に存在する必要があります。

  • tkWavefunction_H

  • tklib.tkgraphic.tkPlot3d

入出力仕様

入力(コマンドライン引数)

プログラムの動作はコマンドライン引数で制御します。

  • mode (位置引数)

    • 実行する描画モードを指定します。

    • 指定可能な値: rplot, ranim, dot, dotc, dotanim, iso3d, iso3danim, rsurface, Rnl, Ylm, Theta, Phi, normalize, 3dMC_animation, contour3d, torus, isosurface3d

  • functype (位置引数)

    • 可視化する関数の種類(軌道や成分)を指定します。

    • 例: 100r, 2pxa, 1s, 2s, 2px, 3dxy など。

    • 接尾辞として c (複素数), r (実部), i (虚部), a (絶対値), a2 (絶対値の2乗) を組み合わせることができます。

  • nsamples (位置引数)

    • モンテカルロサンプリングなどを使用する際のサンプル数を整数で指定します。

  • --fplot (オプション引数)

    • 処理完了時に画面にグラフを表示するかどうかを指定します(1: 表示する, 0: 表示しない)。

  • --fsave (オプション引数)

    • 生成されたグラフやアニメーションをファイルとして保存するかどうかを指定します(1: 保存する, 0: 保存しない)。

出力

  • コンソール出力: 計算の対象となった軌道名、量子数 \((n, l, m)\)、エネルギー準位 \(E_n\) \([\mathrm{eV}]\)、リジェクションサンプリングの推定最大値などの計算詳細が出力されます。

  • 画像・動画ファイル: 引数 --fsave 1 が指定されている場合、現在のディレクトリに結果が出力されます。

    • 静止画プロットの場合: plot_wf_モード_関数タイプ.png

    • 動径分布などの特定モードの場合: plot_wf_Rnl.png または plot_wf_Pnl.png

    • アニメーションモード(ranim, dotanim, iso3danim など)の場合: plot_wf_モード_関数タイプ.gif

実行例

波動関数の絶対値を3D表面としてプロットし、画面に表示する実行例です。

python plot_wf.py rplot 2px

動径波動関数と動径確率密度分布の2Dグラフを生成する実行例です。

python plot_wf.py Rnl

リジェクションサンプリングを用いて確率密度に比例した点の分布を3Dアニメーションとして描画し、ファイルに保存する実行例です。

python plot_wf.py dotanim 100r --fsave 1 --fplot 0

等値面を用いた波動関数の3Dアニメーションを生成する実行例です。

python plot_wf.py iso3danim 3dxy

波動関数が正しく正規化されているか(全空間積分が \(1\) になるか)を数値計算を用いてコンソール上で検証する実行例です。

python plot_wf.py normalize