hydrogen_numerov.py ダウンロード/コピー

hydrogen_numerov.py をダウンロード

hydrogen_numerov.py
hydrogen_numerov.py
  1#!/usr/bin/env python3
  2# -*- coding: utf-8 -*-
  3"""
  4概要:
  5    水素様原子に対する両方向Numerov法による動径Schrodinger方程式の教材スクリプトです。
  6
  7準備:
  8    python -m pip install numpy scipy matplotlib
  9
 10実行例:
 11    python hydrogen_numerov.py
 12    python hydrogen_numerov.py --Z 1 --n 2 --l 0 --check
 13    python hydrogen_numerov.py --Z 1 --n 3 --l 2 --check --no-show
 14
 15物理と単位:
 16    P(r) = r R(r), integral P(r)^2 dr = 1, r は Bohr半径 a0 単位です。
 17    P'' = [l(l+1)/r^2 - 2Z/r - E_Ry] P となります。
 18    E_Ry = 2 E_Hartree です。元のPerlコードもこのRy表記を採用しています。
 19    無限質量の核、非相対論、一電子Coulomb問題として扱います。
 20    解析解は E_Ry = -Z^2/n^2 で、節の数は n-l-1 です。
 21
 22アルゴリズム:
 23    内部座標 rho = Z*r, e = E_Ry/Z^2 を使用し、Zによる格子精度の差を避けます。
 24    Numerov更新式を使用して両側から接続点まで積分し、離散WronskianのゼロをBrent法で探索します。
 25    原点側は rho のべき級数、遠方側は漸近級数で初期化します。
 26    エネルギーと波動関数はNumerov積分から計算し、解析解と比較します。
 27
 28出力:
 29    指定された接頭辞をもとにCSVとPNGファイルを出力します。
 30
 31参考:
 32    https://docs.scipy.org/doc/scipy/reference/generated/scipy.optimize.brentq.html
 33    https://docs.scipy.org/doc/scipy/reference/generated/scipy.special.eval_genlaguerre.html
 34    原コード HS-DoubleSide-Noumerov.pl
 35"""
 36from __future__ import annotations
 37import argparse
 38from dataclasses import dataclass
 39from pathlib import Path
 40import sys
 41import numpy as np
 42from scipy.integrate import simpson
 43from scipy.optimize import brentq
 44from scipy.special import eval_genlaguerre, gammaln
 45
 46
 47@dataclass
 48class Grid:
 49    """
 50    概要:
 51        計算用のグリッド情報を保持するデータクラスです。
 52    詳細説明:
 53        内部座標や刻み幅、接続点、方位量子数などのパラメータを管理します。
 54    引数:
 55        :param rho: 内部座標の配列
 56        :type rho: numpy.ndarray
 57        :param h: 座標の刻み幅
 58        :type h: float
 59        :param match: 接続点のインデックス
 60        :type match: int
 61        :param l: 方位量子数
 62        :type l: int
 63    """
 64    rho: np.ndarray
 65    h: float
 66    match: int
 67    l: int
 68
 69
 70def make_grid(n, l, step, maximum, match=None):
 71    """
 72    概要:
 73        計算用のグリッドを生成します。
 74    詳細説明:
 75        指定されたパラメータに基づいて、内部座標配列や接続点を計算しGridオブジェクトを返します。
 76    引数:
 77        :param n: 主量子数
 78        :type n: int
 79        :param l: 方位量子数
 80        :type l: int
 81        :param step: 内部座標の刻み幅
 82        :type step: float
 83        :param maximum: 内部座標の上限
 84        :type maximum: float
 85        :param match: 接続点となる内部座標の値、またはNone
 86        :type match: float or None
 87    戻り値:
 88        :returns: 生成されたグリッド情報
 89        :rtype: Grid
 90    例外:
 91        :raises ValueError: グリッドの区間数が不正な場合、または接続点が適切でない場合
 92    """
 93    count = int(np.ceil(maximum/step))
 94    if count < 100 or count > 500000:
 95        raise ValueError('Grid requires 100..500000 intervals; change --step/--rhomax.')
 96    h = maximum/count
 97    rho = h*np.arange(1, count+1)  # rho=0ではODEを評価しない
 98    # 対象準位の外側古典転回点。通常、節を避けて接続できる。
 99    target = n*n+np.sqrt(n**4-l*(l+1)*n*n) if match is None else match
100    m = int(round(target/h))-1
101    if not 4 <= m <= count-5:
102        raise ValueError('Matching point must lie well inside the grid.')
103    if rho[0]*(l+1) > 0.1:
104        raise ValueError('Origin grid too coarse; reduce --step.')
105    return Grid(rho, h, m, l)
106
107
108def origin(rho, e, l):
109    """
110    概要:
111        原点側の境界条件に基づく波動関数の初期値を計算します。
112    詳細説明:
113        常微分方程式から係数を逐次決定し、rhoのべき級数として計算します。
114    引数:
115        :param rho: 内部座標の配列
116        :type rho: numpy.ndarray
117        :param e: スケールされたエネルギー
118        :type e: float
119        :param l: 方位量子数
120        :type l: int
121    戻り値:
122        :returns: 原点付近の波動関数の配列
123        :rtype: numpy.ndarray
124    """
125    coef = [1.]
126    for j in range(1, 13):
127        prev2 = coef[j-2] if j >= 2 else 0.
128        coef.append((-2*coef[j-1]-e*prev2)/(j*(2*l+j+1)))
129    return rho**(l+1)*np.polynomial.polynomial.polyval(rho, coef)
130
131
132def tail(rho, e, l):
133    """
134    概要:
135        遠方側の境界条件に基づく波動関数の初期値を計算します。
136    詳細説明:
137        漸近級数を使用して初期値を計算し、共通指数を除いてアンダーフローを回避します。
138    引数:
139        :param rho: 内部座標の配列
140        :type rho: numpy.ndarray
141        :param e: スケールされたエネルギー
142        :type e: float
143        :param l: 方位量子数
144        :type l: int
145    戻り値:
146        :returns: 遠方付近の波動関数の配列
147        :rtype: numpy.ndarray
148    """
149    k = np.sqrt(-e)
150    s = 1/k
151    term = np.ones_like(rho)
152    series = term.copy()
153    for j in range(1, 9):
154        term = term*(-((s-j+1)*(s-j)-l*(l+1))/(2*k*j))/rho
155        series += term
156    return np.exp(-k*(rho-rho[-1])+s*np.log(rho/rho[-1]))*series
157
158
159def integrate_sides(e, grid):
160    """
161    概要:
162        Numerov法を用いて両側から波動関数を積分します。
163    詳細説明:
164        接続点の周囲だけ重複させることで、不要な側への不安定な長距離積分を避けます。
165    引数:
166        :param e: スケールされたエネルギー
167        :type e: float
168        :param grid: グリッド情報
169        :type grid: Grid
170    戻り値:
171        :returns: 前進積分の結果と後退積分の結果のタプル
172        :rtype: tuple
173    例外:
174        :raises ValueError: Numerov法の分母がゼロに近すぎる場合
175        :raises RuntimeError: 積分の過程でオーバーフローが発生した場合
176    """
177    x, h, m, l = grid.rho, grid.h, grid.match, grid.l
178    g = l*(l+1)/x**2-2/x-e
179    a = 1-h*h*g/12
180    b = 2*(1+5*h*h*g/12)
181    if np.min(np.abs(a)) < 1e-8:
182        raise ValueError('Numerov denominator near zero; reduce --step.')
183    f, q = np.full(len(x), np.nan), np.full(len(x), np.nan)
184    f[:2] = origin(x[:2], e, l)
185    q[-2:] = tail(x[-2:], e, l)
186    for i in range(1, m+2):
187        f[i+1] = (b[i]*f[i]-a[i-1]*f[i-1])/a[i+1]
188    for i in range(len(x)-2, m-2, -1):
189        q[i-1] = (b[i]*q[i]-a[i+1]*q[i+1])/a[i-1]
190    if not np.all(np.isfinite(f[:m+3])) or not np.all(np.isfinite(q[m-2:])):
191        raise RuntimeError('Numerov overflow; use a smaller domain/state.')
192    # 正の係数での再スケール。Wronskianの符号を保存する。
193    f /= np.max(np.abs(f[:m+3]))
194    q /= np.max(np.abs(q[m-2:]))
195    return f, q
196
197
198def mismatch(e, grid):
199    """
200    概要:
201        接続点における前進解と後退解の不一致度を計算します。
202    詳細説明:
203        離散Wronskianを評価して、両側からの解が滑らかに接続するかを判定する値を返します。
204    引数:
205        :param e: スケールされたエネルギー
206        :type e: float
207        :param grid: グリッド情報
208        :type grid: Grid
209    戻り値:
210        :returns: 正規化された離散Wronskianの値
211        :rtype: float
212    """
213    f, q = integrate_sides(e, grid)
214    m = grid.match
215    fv, qv = f[m:m+2], q[m:m+2]
216    return (fv[0]*qv[1]-fv[1]*qv[0])/(np.linalg.norm(fv)*np.linalg.norm(qv))
217
218
219def energy_bracket(n, l):
220    """
221    概要:
222        対象となる準位のエネルギー探索区間を計算します。
223    詳細説明:
224        同じ方位量子数に対する隣接準位との中点を用いて、エネルギー探索の上限と下限を定めます。
225    引数:
226        :param n: 主量子数
227        :type n: int
228        :param l: 方位量子数
229        :type l: int
230    戻り値:
231        :returns: 探索区間の下限と上限のタプル
232        :rtype: tuple
233    """
234    # 同じlに対する隣接準位との中点で、1つの対象状態を囲む。
235    lower = -2/n**2 if n == l+1 else (-1/(n-1)**2-1/n**2)/2
236    upper = (-1/n**2-1/(n+1)**2)/2
237    return lower, upper
238
239
240def solve_state(n, l, step, maximum, match=None, bracket=None):
241    """
242    概要:
243        指定された量子状態に対するエネルギー固有値と波動関数を計算します。
244    詳細説明:
245        Brent法を用いてエネルギーを探索し、求まった固有値で波動関数を計算して規格化します。
246    引数:
247        :param n: 主量子数
248        :type n: int
249        :param l: 方位量子数
250        :type l: int
251        :param step: 内部座標の刻み幅
252        :type step: float
253        :param maximum: 内部座標の上限
254        :type maximum: float
255        :param match: 接続点となる内部座標の値、またはNone
256        :type match: float or None
257        :param bracket: エネルギー探索区間のタプル、またはNone
258        :type bracket: tuple or None
259    戻り値:
260        :returns: グリッド、エネルギー、座標、波動関数などの情報を含む辞書
261        :rtype: dict
262    例外:
263        :raises RuntimeError: 波束の節の数が期待値と異なる場合
264    """
265    grid = make_grid(n, l, step, maximum, match)
266    bounds = energy_bracket(n, l) if bracket is None else bracket
267    e, result = brentq(mismatch, *bounds, args=(grid,), xtol=2e-13,
268                       rtol=2e-13, maxiter=100, full_output=True)
269    f, q = integrate_sides(e, grid)
270    m = grid.match
271    overlap = slice(m-2, m+3)
272    # 1点で割らず重複領域の最小二乗で振幅を合わせる(節の近くでも安定)。
273    q *= np.dot(f[overlap], q[overlap])/np.dot(q[overlap], q[overlap])
274    x = np.r_[0., grid.rho]
275    u = np.r_[0., f[:m+1], q[m+1:]]
276    norm = np.sqrt(simpson(u*u, x=x))
277    u, f, q = u/norm, f/norm, q/norm
278    # 厳密ゼロの格子点を除いて符号変化を数える。
279    nonzero = u[1:][u[1:] != 0]
280    nodes = int(np.count_nonzero(nonzero[1:]*nonzero[:-1] < 0))
281    if nodes != n-l-1:
282        raise RuntimeError(f'Wrong state: nodes={nodes}, expected={n-l-1}. Check bracket/grid.')
283    return dict(grid=grid, e=e, x=x, u=u, f=np.r_[0., f], q=np.r_[np.nan, q],
284                nodes=nodes, iterations=result.iterations, bounds=bounds,
285                mismatch=mismatch(e, grid))
286
287
288def exact_u(x, n, l):
289    """
290    概要:
291        解析的な動径波動関数を計算します。
292    詳細説明:
293        核電荷Zが1のとき規格化された動径関数 u = xR をLaguerre多項式を用いて計算します。
294    引数:
295        :param x: 座標の配列
296        :type x: numpy.ndarray
297        :param n: 主量子数
298        :type n: int
299        :param l: 方位量子数
300        :type l: int
301    戻り値:
302        :returns: 解析的な波動関数の値の配列
303        :rtype: numpy.ndarray
304    """
305    pref = np.exp(0.5*(3*np.log(2/n)+gammaln(n-l)-np.log(2*n)-gammaln(n+l+1)))
306    t = 2*x/n
307    return pref*x*np.exp(-x/n)*t**l*eval_genlaguerre(n-l-1, 2*l+1, t)
308
309
310def main(argv=None):
311    """
312    概要:
313        コマンドライン引数を解析し、計算の実行と結果の出力を行います。
314    詳細説明:
315        水素様原子の動径方程式を解き、解析解との比較結果を標準出力に表示し、CSVおよびPNGファイルとして保存します。
316    引数:
317        :param argv: コマンドライン引数のリスト、またはNone
318        :type argv: list or None
319    戻り値:
320        :returns: なし
321        :rtype: None
322    """
323    ap = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
324    ap.add_argument('--Z', type=float, default=5., help='核電荷 (default: 5)')
325    ap.add_argument('--n', type=int, default=1, help='主量子数 (1..8)')
326    ap.add_argument('--l', type=int, default=0, help='方位量子数 (0..n-1)')
327    ap.add_argument('--step', type=float, default=0.005, help='内部座標rho=Zrの刻み')
328    ap.add_argument('--rhomax', type=float, help='内部座標の上限。既定max(40,12n^2)')
329    ap.add_argument('--match', type=float, help='内部座標での接続点(既定:外側転回点)')
330    ap.add_argument('--bracket', nargs=2, type=float, metavar=('LOW', 'HIGH'), help='e=E_Ry/Z^2 の探索区間')
331    ap.add_argument('--check', action='store_true', help='刻み半減・範囲1.5倍の確認')
332    ap.add_argument('--prefix', default='hydrogen_numerov', help='CSV/PNG名の接頭辞')
333    ap.add_argument('--no-show', action='store_true', help='図を表示せず保存のみ')
334    args = ap.parse_args(argv)
335    maximum = args.rhomax if args.rhomax is not None else max(40., 12.*args.n**2)
336    if not (1 <= args.n <= 8 and 0 <= args.l < args.n):
337        ap.error('1 <= n <= 8, 0 <= l < n が必要です。')
338    if not all(np.isfinite(v) and v > 0 for v in (args.Z, args.step, maximum)):
339        ap.error('Z, step, rhomax は正の有限値にしてください。')
340    if args.match is not None and not np.isfinite(args.match):
341        ap.error('match は有限値にしてください。')
342    if args.bracket and not (np.all(np.isfinite(args.bracket)) and args.bracket[0] < args.bracket[1] < 0):
343        ap.error('bracket は LOW < HIGH < 0 にしてください。')
344    s = solve_state(args.n, args.l, args.step, maximum, args.match, args.bracket)
345    e, z = s['e'], args.Z
346    r = s['x']/z
347    p = np.sqrt(z)*s['u']
348    analytic = np.sqrt(z)*exact_u(s['x'], args.n, args.l)
349    error = np.sqrt(simpson((p-analytic)**2, x=r))
350    radial = np.full_like(r, np.nan)
351    radial[1:] = p[1:]/r[1:]
352    print(f'Hydrogen-like ion: Z={z:g}, n={args.n}, l={args.l}')
353    print(f'Energy [Ry]     : {e*z*z:.12f}  (exact {-z*z/args.n**2:.12f})')
354    print(f'Energy [Hartree]: {e*z*z/2:.12f}')
355    print(f'Relative E error: {abs(e+1/args.n**2)*args.n**2:.3e}')
356    print(f'Norm integral   : {simpson(p*p, x=r):.12f}')
357    print(f'Radial nodes    : {s["nodes"]} (expected {args.n-args.l-1})')
358    print(f'Wavefunction L2 error: {error:.3e}')
359    print(f'Matching residual   : {s["mismatch"]:.3e}; Brent iterations: {s["iterations"]}')
360    print(f'rmax={r[-1]:g} a0; dr={s["grid"].h/z:g} a0; match={s["grid"].rho[s["grid"].match]/z:g} a0')
361    print('Finite grid/domain and asymptotic boundary errors are separate from root tolerance.')
362    if args.check:
363        for label, step, extent in [('Half step', args.step/2, maximum), ('Larger domain', args.step, maximum*1.5)]:
364            other = solve_state(args.n, args.l, step, extent, args.match, args.bracket)
365            print(f'{label:15s}: E_Ry={other["e"]*z*z:.12f}; delta E_Ry={(other["e"]-e)*z*z:+.3e}')
366    prefix = Path(args.prefix)
367    prefix.parent.mkdir(parents=True, exist_ok=True)
368    np.savetxt(str(prefix)+'.csv', np.column_stack((r, p, radial, p*p, analytic, p-analytic,
369                np.sqrt(z)*s['f'], np.sqrt(z)*s['q'])), delimiter=',', comments='',
370                header='r_a0,P,R,radial_probability,P_exact,P_error,P_outward,P_inward', fmt='%.12e')
371    import matplotlib
372    if args.no_show:
373        matplotlib.use('Agg')
374    import matplotlib.pyplot as plt
375    fig, axes = plt.subplots(2, 2, figsize=(12, 8), constrained_layout=True)
376    match_r = s['grid'].rho[s['grid'].match]/z
377    ax = axes[0, 0]
378    ax.plot(r, p, label='Numerov', lw=2)
379    ax.plot(r, analytic, '--', label='Analytical', lw=1.5)
380    ax.axvline(match_r, color='gray', ls=':', label='Matching point')
381    ax.set(ylabel='P(r) = r R(r)', title='Normalized radial wavefunction')
382    ax.legend()
383    ax = axes[0, 1]
384    ax.plot(r, p*p)
385    ax.set(ylabel='P(r)^2', title='Radial probability density (integral = 1)')
386    ax = axes[1, 0]
387    ax.plot(r, p-analytic)
388    ax.set(ylabel='P - P exact', title=f'Wavefunction error; L2 = {error:.2e}')
389    for ax in axes.flat[:3]:
390        ax.set(xlim=(0, min(r[-1], 8*args.n**2/z)), xlabel='r / a0')
391    # 接続条件のエネルギー依存性を描く。計算解の探索とは独立の描画用走査。
392    es = np.linspace(*s['bounds'], 51)
393    ws = np.array([mismatch(value, s['grid']) for value in es])
394    ax = axes[1, 1]
395    ax.plot(es*z*z, ws)
396    ax.axhline(0, color='gray', lw=0.8)
397    ax.axvline(e*z*z, color='tab:red', ls='--', label='Numerical eigenvalue')
398    ax.set(xlabel='Energy / Ry', ylabel='Normalized discrete Wronskian', title='Matching condition: W(E) = 0')
399    ax.legend()
400    for ax in axes.flat:
401        ax.grid(alpha=0.25)
402    fig.suptitle(f'Two-sided Numerov: Z={z:g}, n={args.n}, l={args.l}, E={e*z*z:.8f} Ry')
403    fig.savefig(str(prefix)+'.png', dpi=150)
404    print(f'Saved: {prefix}.csv\nSaved: {prefix}.png')
405    if not args.no_show:
406        plt.show()
407    plt.close(fig)
408
409
410if __name__ == '__main__':
411    try:
412        main()
413    except (RuntimeError, ValueError, OSError) as exc:
414        print(f'Error: {exc}', file=sys.stderr)
415        sys.exit(1)