scipy.special.tklmbda#

scipy.special.tklmbda(x, lmbda, out=None) = <ufunc 'tklmbda'>#

Tukey lambda 分布的累積分布函數。

參數:
x, lmbdaarray_like

參數

outndarray, optional

函數結果的選用輸出陣列

回傳:
cdfscalar or ndarray

Tukey lambda CDF 的值

另請參閱

scipy.stats.tukeylambda

Tukey lambda 分布

範例

>>> import numpy as np
>>> import matplotlib.pyplot as plt
>>> from scipy.special import tklmbda, expit

計算 Tukey lambda 分布在 lmbda = -1.5 的幾個 x 值上的累積分布函數 (CDF)。

>>> x = np.linspace(-2, 2, 9)
>>> x
array([-2. , -1.5, -1. , -0.5,  0. ,  0.5,  1. ,  1.5,  2. ])
>>> tklmbda(x, -1.5)
array([0.34688734, 0.3786554 , 0.41528805, 0.45629737, 0.5       ,
       0.54370263, 0.58471195, 0.6213446 , 0.65311266])

lmbda 為 0 時,此函數為邏輯斯 sigmoid 函數,其在 scipy.special 中以 expit 實作。

>>> tklmbda(x, 0)
array([0.11920292, 0.18242552, 0.26894142, 0.37754067, 0.5       ,
       0.62245933, 0.73105858, 0.81757448, 0.88079708])
>>> expit(x)
array([0.11920292, 0.18242552, 0.26894142, 0.37754067, 0.5       ,
       0.62245933, 0.73105858, 0.81757448, 0.88079708])

lmbda 為 1 時,Tukey lambda 分布在區間 [-1, 1] 上均勻分布,因此 CDF 線性增加。

>>> t = np.linspace(-1, 1, 9)
>>> tklmbda(t, 1)
array([0.   , 0.125, 0.25 , 0.375, 0.5  , 0.625, 0.75 , 0.875, 1.   ])

在以下內容中,我們為幾個 lmbda 值生成圖表。

第一張圖顯示了 lmbda <= 0 的圖表。

>>> styles = ['-', '-.', '--', ':']
>>> fig, ax = plt.subplots()
>>> x = np.linspace(-12, 12, 500)
>>> for k, lmbda in enumerate([-1.0, -0.5, 0.0]):
...     y = tklmbda(x, lmbda)
...     ax.plot(x, y, styles[k], label=rf'$\lambda$ = {lmbda:-4.1f}')
>>> ax.set_title(r'tklmbda(x, $\lambda$)')
>>> ax.set_label('x')
>>> ax.legend(framealpha=1, shadow=True)
>>> ax.grid(True)

第二張圖顯示了 lmbda > 0 的圖表。圖表中的點顯示分布支持的邊界。

>>> fig, ax = plt.subplots()
>>> x = np.linspace(-4.2, 4.2, 500)
>>> lmbdas = [0.25, 0.5, 1.0, 1.5]
>>> for k, lmbda in enumerate(lmbdas):
...     y = tklmbda(x, lmbda)
...     ax.plot(x, y, styles[k], label=fr'$\lambda$ = {lmbda}')
>>> ax.set_prop_cycle(None)
>>> for lmbda in lmbdas:
...     ax.plot([-1/lmbda, 1/lmbda], [0, 1], '.', ms=8)
>>> ax.set_title(r'tklmbda(x, $\lambda$)')
>>> ax.set_xlabel('x')
>>> ax.legend(framealpha=1, shadow=True)
>>> ax.grid(True)
>>> plt.tight_layout()
>>> plt.show()
../../_images/scipy-special-tklmbda-1_00_00.png
../../_images/scipy-special-tklmbda-1_00_01.png

Tukey lambda 分布的 CDF 也實作為 scipy.stats.tukeylambdacdf 方法。在以下內容中,tukeylambda.cdf(x, -0.5)tklmbda(x, -0.5) 計算相同的值

>>> from scipy.stats import tukeylambda
>>> x = np.linspace(-2, 2, 9)
>>> tukeylambda.cdf(x, -0.5)
array([0.21995157, 0.27093858, 0.33541677, 0.41328161, 0.5       ,
       0.58671839, 0.66458323, 0.72906142, 0.78004843])
>>> tklmbda(x, -0.5)
array([0.21995157, 0.27093858, 0.33541677, 0.41328161, 0.5       ,
       0.58671839, 0.66458323, 0.72906142, 0.78004843])

tukeylambda 中的實作也提供位置和尺度參數,以及其他方法,例如 pdf() (機率密度函數) 和 ppf() (CDF 的反函數),因此對於使用 Tukey lambda 分布,tukeylambda 更通用。tklmbda 的主要優勢在於它比 tukeylambda.cdf 顯著更快。