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)