當前位置: 首頁>>代碼示例 >>用法及示例精選 >>正文


Python dask.array.max用法及代碼示例


用法:

dask.array.max(a, axis=None, keepdims=False, split_every=None, out=None)

返回數組的最大值或沿軸的最大值。

此文檔字符串是從 numpy.max 複製的。

可能存在與 Dask 版本的一些不一致之處。

參數

aarray_like

輸入數據。

axis無或整數或整數元組,可選

沿其操作的一個或多個軸。默認情況下,使用扁平化輸入。

如果這是一個整數元組,則在多個軸上選擇最大值,而不是像以前那樣選擇單個軸或所有軸。

outndarray,可選

用於放置結果的替代輸出數組。必須與預期輸出具有相同的形狀和緩衝區長度。有關更多詳細信息,請參閱輸出類型確定。

keepdims布爾型,可選

如果將其設置為 True,則縮小的軸將作為尺寸為 1 的尺寸留在結果中。使用此選項,結果將針對輸入數組正確廣播。

如果傳遞了默認值,那麽 keepdims 將不會傳遞給 ndarray 的子類的 amax 方法,但是任何非默認值都會傳遞。如果 sub-class' 方法未實現 keepdims,則將引發任何異常。

initial標量,可選(Dask 中不支持)

輸出元素的最小值。必須存在以允許對空切片進行計算。有關詳細信息,請參閱~numpy.ufunc.reduce

where數組 of bool,可選(在 Dask 中不支持)

要比較最大值的元素。有關詳細信息,請參閱~numpy.ufunc.reduce

返回

amaxndarray 或標量

a 的最大值。如果axis 為無,則結果為標量值。如果給出 axis,則結果是一個維度為 a.ndim - 1 的數組。

注意

傳播 NaN 值,即如果至少一項為 NaN,則相應的最大值也將為 NaN。要忽略 NaN 值(MATLAB 行為),請使用 nanmax。

不要將amax 用於 2 個數組的元素比較;當 a.shape[0] 為 2 時, maximum(a[0], a[1])amax(a, axis=0) 快。

例子

>>> a = np.arange(4).reshape((2,2))  
>>> a  
array([[0, 1],
       [2, 3]])
>>> np.amax(a)           # Maximum of the flattened array  
3
>>> np.amax(a, axis=0)   # Maxima along the first axis  
array([2, 3])
>>> np.amax(a, axis=1)   # Maxima along the second axis  
array([1, 3])
>>> np.amax(a, where=[False, True], initial=-1, axis=0)  
array([-1,  3])
>>> b = np.arange(5, dtype=float)  
>>> b[2] = np.NaN  
>>> np.amax(b)  
nan
>>> np.amax(b, where=~np.isnan(b), initial=-1)  
4.0
>>> np.nanmax(b)  
4.0

您可以使用初始值來計算空切片的最大值,或者將其初始化為不同的值:

>>> np.amax([[-50], [10]], axis=-1, initial=0)  
array([ 0, 10])

請注意,初始值用作確定最大值的元素之一,這與 Python 的默認參數 max 函數不同,該函數僅用於空迭代。

>>> np.amax([5], initial=6)  
6
>>> max([5], default=6)  
5

相關用法


注:本文由純淨天空篩選整理自dask.org大神的英文原創作品 dask.array.max。非經特殊聲明,原始代碼版權歸原作者所有,本譯文未經允許或授權,請勿轉載或複製。