scipy.special.jve#

scipy.special.jve(v, z, out=None) = <ufunc 'jve'>#

指数缩放的贝塞尔函数，第一类，阶数 v。

定义为:

jve(v, z) = jv(v, z) * exp(-abs(z.imag))

参数:

varray_like: 顺序 (浮点数)。
zarray_like: 参数（浮点数或复数）。
出ndarray，可选: 函数值的可选输出数组

返回:

J标量或ndarray: 指数缩放贝塞尔函数的值。

参见

jv: 未缩放的第一类贝塞尔函数

注释

对于正值 v ，计算是通过使用 AMOS [1] zbesj 例程进行的，该例程利用了与修正贝塞尔函数 \(I_v\) 的连接。

\[ \begin{align}\begin{aligned}J_v(z) = \exp(v\pi\imath/2) I_v(-\imath z)\qquad (\Im z > 0)\\J_v(z) = \exp(-v\pi\imath/2) I_v(\imath z)\qquad (\Im z < 0)\end{aligned}\end{align} \]

对于负的 v 值，公式，

\[J_{-v}(z) = J_v(z) \cos(\pi v) - Y_v(z) \sin(\pi v)\]

使用时，其中 \(Y_v(z)\) 是第二类贝塞尔函数，通过 AMOS 例程 zbesy 计算。请注意，对于整数 v，第二项恰好为零；为了提高准确性，对于 v 值使得 v = floor(v) 的情况，第二项被显式省略。

指数缩放的贝塞尔函数对于大参数 z 非常有用：对于这些参数，未缩放的贝塞尔函数可能会轻易地下溢或溢出。

参考文献

[1]

Donald E. Amos, “AMOS, 一个用于复数参数和非负阶贝塞尔函数的便携式软件包”, http://netlib.org/amos/

示例

通过计算 z=1000j 处阶数 v=1 的值，比较 jv 和 jve 对于大型复杂参数 z 的输出。我们看到 jv 溢出，而 jve 返回一个有限数：

>>> import numpy as np
>>> from scipy.special import jv, jve
>>> v = 1
>>> z = 1000j
>>> jv(v, z), jve(v, z)
((inf+infj), (7.721967686709077e-19+0.012610930256928629j))

对于 z 的实际参数，jve 返回的结果与 jv 相同。

>>> v, z = 1, 1000
>>> jv(v, z), jve(v, z)
(0.004728311907089523, 0.004728311907089523)

通过为 v 提供一个列表或 NumPy 数组，可以同时对多个阶数进行函数求值：

>>> jve([1, 3, 5], 1j)
array([1.27304208e-17+2.07910415e-01j, -4.99352086e-19-8.15530777e-03j,
       6.11480940e-21+9.98657141e-05j])

同样地，通过为 z 提供一个列表或 NumPy 数组，可以在一次调用中在多个点上评估函数：

>>> jve(1, np.array([1j, 2j, 3j]))
array([1.27308412e-17+0.20791042j, 1.31814423e-17+0.21526929j,
       1.20521602e-17+0.19682671j])

通过为 v 和 z 提供形状兼容的数组，也可以同时在多个点上评估多个阶数。计算 jve 对于两个不同的阶数 v 和三个点 z，结果为一个 2x3 的数组。

>>> v = np.array([[1], [3]])
>>> z = np.array([1j, 2j, 3j])
>>> v.shape, z.shape
((2, 1), (3,))

>>> jve(v, z)
array([[1.27304208e-17+0.20791042j,  1.31810070e-17+0.21526929j,
        1.20517622e-17+0.19682671j],
       [-4.99352086e-19-0.00815531j, -1.76289571e-18-0.02879122j,
        -2.92578784e-18-0.04778332j]])