tkWavefunction_H.py ドキュメント

概要

tkWavefunction_H.py は、水素原子の波動関数およびエネルギー準位を解析的・数値的に計算するためのPythonモジュールです。量子数(主量子数 $n$、方位量子数 $l$、磁気量子数 $m$)に基づくエネルギーの算出から、ラゲール陪多項式やルジャンドル陪関数を用いた動径波動関数および球面調和関数の評価、さらには球座標系・直交座標系における複素数・実数表現の3次元波動関数の空間分布計算までを包括的にサポートしています。

理論的背景と数式

本プログラムは、非相対論的シュレディンガー方程式に基づく水素原子の解析解を計算します。使用されている主要な物理定数(電子の質量 $m_e$、素電荷 $e$、プランク定数 $h$、真空の誘電率 $\epsilon_0$)から、以下の理論式に従って物理量を導出します。

エネルギー準位

主量子数 $n$ に対する水素原子のエネルギー準位 $E_n$ は、以下の式で与えられます。

\[E_n = - \frac{m_e e^4}{8 \epsilon_0^2 h^2 n^2}\]

プログラム内では、ジュール( $J$ )で計算された値を素電荷 $e$ で割ることで、単位を電子ボルト( $eV$ )に変換して出力します。

動径波動関数

動径波動関数 $R_{nl}(r)$ は、ボーア半径 $a_0$ を用いた無次元化距離 $\rho = \frac{2Zr}{na_0}$ を用いて、ラゲール陪多項式 $L_{n-l-1}^{2l+1}(\rho)$ により以下のように計算されます。

\[R_{nl}(r) = \sqrt{ \left( \frac{2Z}{n a_0} \right)^3 \frac{(n-l-1)!}{2n(n+l)!^3} } e^{-\rho/2} \rho^l L_{n-l-1}^{2l+1}(\rho)\]

本コードでは計算の最適化のため、$n \le 4$ の低次軌道(1s、2s、2p、3s、3p、3d、4sなど)については、あらかじめ展開された解析式を用いた条件分岐によって高速に計算されるよう実装されています。

球面調和関数

角度方向の分布を表す球面調和関数 $Y_l^m(\theta, \phi)$ は、方位角成分 $\Phi_m(\phi)$ と極角成分 $\Theta_l^m(\theta)$ に分離して計算されます。極角成分にはルジャンドル陪関数 $P_l^m(\cos\theta)$ が用いられます。

\[Y_l^m(\theta, \phi) = \sqrt{ \frac{2l+1}{4\pi} \frac{(l-m)!}{(l+m)!} } P_l^m(\cos\theta) e^{im\phi}\]

また、化学や固体物理学における軌道の可視化で多用される「実数型の球面調和関数(実関数表現)」も計算可能であり、磁気量子数 $m$ の符号に応じて複素数関数の実部と虚部を適切に線形結合する処理が行われます。

水素原子の波動関数

最終的な3次元の波動関数 $\psi_{nlm}(r, \theta, \phi)$ は、動径成分と角度成分の積として定義されます。

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

直交座標系( $x$、$y$、$z$ )が入力された場合は、プログラム内部で以下の座標変換を行った上で波動関数が評価されます。

\[r = \sqrt{x^2 + y^2 + z^2}\]
\[\theta = \arccos\left(\frac{z}{r}\right)\]
\[\phi = \text{arctan2}(y, x)\]

機能と特徴

  • エネルギー準位の算出 量子数 $n$ を指定するだけで、水素原子のエネルギー準位を計算できます。

  • 柔軟な座標系サポート 球座標系(極座標)と直交座標系の両方で、波動関数および球面調和関数を評価できます。

  • 複素数と実数表現の切り替え 理論物理学で扱われる純粋な複素波動関数に加え、化学結合などの議論で多用される実数表現(例: $p_x$, $d_{xy}$ など)を直接計算する関数を備えています。

  • 文字列解析機能 3dxy や 210r のような軌道を示す文字列をパースし、対応する主量子数・方位量子数・磁気量子数、および実数/複素数の指定タイプを自動で抽出する機能が含まれています。

  • 配列演算への対応 内部で numpy および scipy を活用しているため、空間メッシュを表す配列(ベクトルやグリッドデータ)を直接引数として渡し、空間全体の波動関数分布を一度に高速計算することが可能です。

依存ライブラリ

本プログラムは標準ライブラリ(re, math)に加え、以下の非標準ライブラリに依存しています。

  • numpy

  • scipy (scipy.special, scipy.constants を使用)

入出力仕様

  • 入力

    • 空間座標:動径距離 r、極角 theta、方位角 phi または直交座標成分 x, y, z(これらは単一の浮動小数点数、または numpy 配列として入力可能です)。

    • 量子数:主量子数 n、方位量子数 l、磁気量子数 m(整数)。

    • 文字列解析:3dxy のような軌道指定文字列。

    • その他:必要に応じて位相シフト量 phase または phase_m を指定できます。

  • 出力

    • エネルギー準位は $eV$ 単位のスカラー値(浮動小数点数)として返されます。

    • 波動関数および球面調和関数の計算関数は、入力された座標データと同じ形状の複素数(または実数)を返します。入力が numpy 配列であれば、出力も numpy 配列となります。

    • 文字列や量子数の変換・解析関数は、対応する名前文字列やパラメータのリスト/タプルを返します。計算対象外のパラメータが渡された場合は None が返る場合があります。

実行例

本モジュールを外部のPythonスクリプトからインポートし、各種計算を実行する例を以下に示します。

import numpy as np
import tkWavefunction_H as wave

# 1. 主量子数 n=2 のエネルギー準位を計算
E_2 = wave.En(2)
print(f"n=2 エネルギー準位: {E_2} eV")

# 2. 文字列表現 '3dxy' から量子数と型を解析
type_str, params = wave.analyze_function("3dxy")
print(f"解析結果 - タイプ: {type_str}, パラメータ: {params}")

# 3. 空間の1点における 2p軌道 (n=2, l=1, m=0) の波動関数を直交座標で計算
# ここでは x=0, y=0, z=a0 (ボーア半径) の位置を評価します
a0 = wave.a0
psi_val = wave.psi_xyz(0.0, 0.0, a0, n=2, l=1, m=0)
print(f"(0, 0, a0) での複素波動関数の値: {psi_val}")

# 4. numpy配列を用いた実数表現波動関数の空間分布計算
z_array = np.linspace(-2 * a0, 2 * a0, 5)
# x=a0, y=0 上での z 軸方向の分布を評価
psi_real_array = wave.psi_xyz_real(a0, 0.0, z_array, n=3, l=2, m=1) # 3d軌道の実数表現
print(f"z軸に沿った波動関数の分布:\n{psi_real_array}")