numpy.nanmin#

numpy.nanmin(a, axis=None, out=None, keepdims=<no value>, initial=<no value>, where=<no value>)[source]#

傳回陣列最小值或沿軸線的最小值,並忽略任何 NaN。當遇到全為 NaN 的切片時,會引發 RuntimeWarning,並為該切片傳回 Nan。

參數:
aarray_like (類陣列)

包含欲求最小值的數字陣列。如果 a 不是陣列,則會嘗試轉換。

axis{int, int 元組, None}, 選項性

計算最小值的軸或軸線。預設值是計算展平陣列的最小值。

outndarray, 選項性

用於放置結果的替代輸出陣列。預設值為 None;如果提供,則其形狀必須與預期輸出相同,但必要時將轉換型別。詳見 輸出型別判斷 以取得更多詳細資訊。

keepdimsbool, 選項性

如果設定為 True,則縮減的軸會保留在結果中,作為大小為一的維度。使用此選項,結果將針對原始 a 正確廣播。

如果值不是預設值,則 keepdims 將傳遞至 min 方法,該方法屬於 ndarray 的子類別。如果子類別方法未實作 keepdims,則會引發任何例外。

initial純量, 選項性

輸出元素的最大值。必須存在才能允許對空切片進行計算。詳見 reduce 以取得詳細資訊。

在 1.22.0 版本中新增。

wherebool 類陣列, 選項性

用於比較最小值的元素。詳見 reduce 以取得詳細資訊。

在 1.22.0 版本中新增。

傳回值:
nanminndarray

一個與 a 形狀相同的陣列,並移除指定的軸線。如果 a 是 0 維陣列,或者如果 axis 為 None,則會傳回 ndarray 純量。傳回與 a 相同的 dtype。

另請參閱

nanmax

沿給定軸線的陣列最大值,忽略任何 NaN。

amin

沿給定軸線的陣列最小值,傳播任何 NaN。

fmin

兩個陣列的元素級最小值,忽略任何 NaN。

minimum

兩個陣列的元素級最小值,傳播任何 NaN。

isnan

顯示哪些元素不是數字 (NaN)。

isfinite

顯示哪些元素既不是 NaN 也不是無限大。

amax, fmax, maximum

注意事項

NumPy 使用 IEEE 754 二進制浮點算術標準。這表示非數字 (NaN) 不等於無限大。正無限大被視為非常大的數字,而負無限大被視為非常小的(即負數)數字。

如果輸入具有整數型別,則此函數等效於 np.min。

範例

>>> import numpy as np
>>> a = np.array([[1, 2], [3, np.nan]])
>>> np.nanmin(a)
1.0
>>> np.nanmin(a, axis=0)
array([1.,  2.])
>>> np.nanmin(a, axis=1)
array([1.,  3.])

當存在正無限大和負無限大時

>>> np.nanmin([1, 2, np.nan, np.inf])
1.0
>>> np.nanmin([1, 2, np.nan, -np.inf])
-inf