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

用法: dask.array.ptp(a, axis=None)

沿軸的值範圍(最大值 - 最小值)。

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

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

該函數的名稱來自“peak to peak”的首字母縮寫詞。

警告

ptp 保留數組的數據類型。這意味著輸入具有 n 位的有符號整數(例如 np.int8 , np.int16 等)的返回值也是具有 n 位的有符號整數。在這種情況下，大於 2**(n-1)-1 的 peak-to-peak 值將作為負值返回。下麵顯示了帶有work-around 的示例。

參數：

a：array_like

輸入值。

axis：無或整數或整數元組，可選

沿其查找峰的軸。默認情況下，展平數組。 axis 可能為負數，在這種情況下，它從最後一個軸計數到第一個軸。

如果這是一個整數元組，則在多個軸上執行歸約，而不是像以前那樣在單個軸或所有軸上執行。

out：數組(在 Dask 中不支持)

用於放置結果的替代輸出數組。它必須具有與預期輸出相同的形狀和緩衝區長度，但如果需要，輸出值的類型將被強製轉換。

keepdims：bool，可選(在 Dask 中不支持)

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

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

ptp：ndarray: 保存結果的新數組，除非指定了 out，在這種情況下，將返回對 out 的引用。

例子：

>>> x = np.array([[4, 9, 2, 10],  
...               [6, 9, 7, 12]])

>>> np.ptp(x, axis=1)  
array([8, 6])

>>> np.ptp(x, axis=0)  
array([2, 0, 5, 2])

>>> np.ptp(x)  
10

此示例顯示當輸入是有符號整數數組時可以返回負值。

>>> y = np.array([[1, 127],  
...               [0, 127],
...               [-1, 127],
...               [-2, 127]], dtype=np.int8)
>>> np.ptp(y, axis=1)  
array([ 126,  127, -128, -127], dtype=int8)

work-around 是使用view() 方法將結果查看為具有相同位寬的無符號整數：

>>> np.ptp(y, axis=1).view(np.uint8)  
array([126, 127, 128, 129], dtype=uint8)

相關用法

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

用法:

參數：

返回：

例子：