scipy.special.

lambertw#

scipy.special.lambertw(z, k=0, tol=1e-8)[源代码][源代码]#

Lambert W 函数。

Lambert W 函数 W(z) 被定义为 w * exp(w) 的反函数。换句话说,对于任意复数 zW(z) 的值使得 z = W(z) * exp(W(z))

Lambert W 函数是一个具有无限多分支的多值函数。每个分支给出了方程 z = w exp(w) 的一个单独解。这里,分支由整数 k 索引。

参数:
zarray_like

输入参数。

kint, 可选

分支索引。

tolfloat, 可选

评估容差。

返回:
w数组

w 将与 z 具有相同的形状。

参见

wrightomega

赖特欧米茄函数

注释

所有分支都由 lambertw 支持:

  • lambertw(z) 给出主解(分支 0)

  • lambertw(z, k) 给出分支 k 上的解

Lambert W 函数有两个部分实部分支:主分支(k = 0)在实数 z > -1/e 时为实数,而 k = -1 分支在 -1/e < z < 0 时为实数。除 k = 0 外的所有分支在 z = 0 处都有一个对数奇点。

可能的问题

在非常接近 -1/e 的分支点时,评估可能会变得不准确。在一些极端情况下,lambertw 可能目前无法收敛,或者可能会落在错误的分支上。

算法

哈雷迭代法用于反转 w * exp(w),使用一阶渐近近似(O(log(w)) 或 O(w))作为初始估计。

分支的定义、实现和选择基于 [2]

参考文献

[2]

Corless 等人, “关于 Lambert W 函数”, Adv. Comp. Math. 5 (1996) 329-359. https://cs.uwaterloo.ca/research/tr/1993/03/W.pdf

示例

Lambert W 函数是 w exp(w) 的反函数:

>>> import numpy as np
>>> from scipy.special import lambertw
>>> w = lambertw(1)
>>> w
(0.56714329040978384+0j)
>>> w * np.exp(w)
(1.0+0j)

任何分支都给出有效的逆:

>>> w = lambertw(1, k=3)
>>> w
(-2.8535817554090377+17.113535539412148j)
>>> w*np.exp(w)
(1.0000000000000002+1.609823385706477e-15j)

应用于方程求解

Lambert W 函数可以用来解决各种类型的方程。我们在这里给出两个例子。

首先,该函数可用于求解形如的隐式方程

\(x = a + b e^{c x}\)

对于 \(x\) 。我们假设 \(c\) 不为零。经过一点代数运算,方程可以写成

\(z e^z = -b c e^{a c}\)

其中 \(z = c (a - x)\)\(z\) 可以用 Lambert W 函数表示。

\(z = W(-b c e^{a c})\)

给予

\(x = a - W(-b c e^{a c})/c\)

例如,

>>> a = 3
>>> b = 2
>>> c = -0.5

方程 \(x = a + b e^{c x}\) 的解是:

>>> x = a - lambertw(-b*c*np.exp(a*c))/c
>>> x
(3.3707498368978794+0j)

验证它是否解决了方程:

>>> a + b*np.exp(c*x)
(3.37074983689788+0j)

Lambert W 函数也可用于求解无穷幂塔 \(z^{z^{z^{\ldots}}}\) 的值:

>>> def tower(z, n):
...     if n == 0:
...         return z
...     return z ** tower(z, n-1)
...
>>> tower(0.5, 100)
0.641185744504986
>>> -lambertw(-np.log(0.5)) / np.log(0.5)
(0.64118574450498589+0j)