jax.numpy.nanpercentile

jax.numpy.nanpercentile(a, q, axis=None, out=None, overwrite_input=False, method='linear', keepdims=False, *, interpolation=Deprecated)

沿指定軸計算資料的百分位數，忽略 NaN 值。

numpy.nanpercentile() 的 JAX 實作。

參數:

• a (ArrayLike) – N 維陣列輸入。

• q (ArrayLike) – 指定所需分位數的純量或一維陣列。q 應包含介於 0 和 100 之間的整數或浮點數值。

• axis (int | tuple[int, ...] | None) – 可選的軸或軸元組，沿這些軸計算分位數

• out (None) – JAX 未實作；如果不是 None 將會產生錯誤

• overwrite_input (bool) – JAX 未實作；如果不是 False 將會產生錯誤

• method (str) – 指定要使用的內插方法。選項為 ["linear", "lower", "higher", "midpoint", "nearest"] 之一。預設值為 linear。

• keepdims (bool) – 如果為 True，則傳回的陣列將與輸入具有相同的維度數。預設值為 False。

• interpolation (str | DeprecatedArg) – method 引數的已棄用別名。如果使用，將會導致 DeprecationWarning。

傳回:

一個陣列，包含沿指定軸的指定百分位數。

傳回型別:

Array

另請參閱

• jax.numpy.nanquantile()：計算 nan 感知分位數 (0.0-1.0)

• jax.numpy.percentile()：計算百分位數，不特別處理 NaN。

範例

計算一維陣列的中位數和四分位數

>>> x = jnp.array([0, 1, 2, jnp.nan, 3, 4, 5, 6])
>>> q = jnp.array([25, 50, 75])

由於 NaN 值，jax.numpy.percentile() 傳回全部 NaN，而 nanpercentile() 忽略它們

>>> jnp.percentile(x, q)
Array([nan, nan, nan], dtype=float32)
>>> jnp.nanpercentile(x, q)
Array([1.5, 3. , 4.5], dtype=float32)