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。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。

用法:

参数：

返回：

例子：