scipy.special.

ellip_harm#

scipy.special.ellip_harm(h2, k2, n, p, s, signm=1, signn=1)[原始碼]#

橢球諧波函數 E^p_n(l)

這些函數也稱為第一類拉梅函數，是拉梅方程式的解

\[(s^2 - h^2)(s^2 - k^2)E''(s) + s(2s^2 - h^2 - k^2)E'(s) + (a - q s^2)E(s) = 0\]

其中 \(q = (n+1)n\) 且 \(a\) 是對應於解的特徵值（未返回）。

參數:

h2float: h**2
k2float: k**2；應大於 h**2
nint: 次數
sfloat: 座標
pint: 階數，範圍可介於 [1,2n+1]
signm{1, -1}, optional: 函數前置因子的符號。可以是 +/-1。請參閱「註解」。
signn{1, -1}, optional: 函數前置因子的符號。可以是 +/-1。請參閱「註解」。

返回:

Efloat: 諧波函數 \(E^p_n(s)\)

另請參閱

ellip_harm_2, ellip_normal

註解

橢球函數的幾何解釋在 [2], [3], [4] 中說明。signm 和 signn 參數根據函數類型控制前置因子的符號

K : +1
L : signm
M : signn
N : signm*signn

在版本 0.15.0 中新增。

參考文獻

[1]

Digital Library of Mathematical Functions 29.12 https://dlmf.nist.gov/29.12

[2]

Bardhan and Knepley, “Computational science and re-discovery: open-source implementations of ellipsoidal harmonics for problems in potential theory”, Comput. Sci. Disc. 5, 014006 (2012) DOI:10.1088/1749-4699/5/1/014006。

[3]

David J.and Dechambre P, “Computation of Ellipsoidal Gravity Field Harmonics for small solar system bodies” pp. 30-36, 2000

[4]

George Dassios, “Ellipsoidal Harmonics: Theory and Applications” pp. 418, 2012

範例

>>> from scipy.special import ellip_harm
>>> w = ellip_harm(5,8,1,1,2.5)
>>> w
2.5

檢查函數是否確實是拉梅方程式的解

>>> import numpy as np
>>> from scipy.interpolate import UnivariateSpline
>>> def eigenvalue(f, df, ddf):
...     r = (((s**2 - h**2) * (s**2 - k**2) * ddf
...           + s * (2*s**2 - h**2 - k**2) * df
...           - n * (n + 1)*s**2*f) / f)
...     return -r.mean(), r.std()
>>> s = np.linspace(0.1, 10, 200)
>>> k, h, n, p = 8.0, 2.2, 3, 2
>>> E = ellip_harm(h**2, k**2, n, p, s)
>>> E_spl = UnivariateSpline(s, E)
>>> a, a_err = eigenvalue(E_spl(s), E_spl(s,1), E_spl(s,2))
>>> a, a_err
(583.44366156701483, 6.4580890640310646e-11)