maxframe.tensor.ptp#

maxframe.tensor.ptp(a, axis=None, out=None, keepdims=None)[源代码]#

沿轴的值范围（最大值 - 最小值）。

函数名称来源于“peak to peak”（峰到峰）的缩写。

参数:

  • a (array_like) -- 输入值。

  • axis (int, optional) -- 用于查找峰的轴。默认将数组展平。

  • out (array_like) -- 用于放置结果的替代输出 Tensor。它必须具有与预期输出相同的形状和缓冲区长度，但必要时将强制转换输出值的类型。

  • keepdims (bool, optional) -- 如果设置为 True，则被规约的轴将保留在结果中，其大小为 1。使用此选项时，结果将正确地与输入数组广播。如果传入默认值，则 keepdims 不会被传递给 Tensor 子类的 ptp 方法；但若传入非默认值，则会被传递。如果子类方法未实现 keepdims，则会引发异常。

返回:

ptp -- 一个保存结果的新 tensor，除非指定了 out，在这种情况下将返回对 out 的引用。

返回类型:

Tensor

示例

>>> import maxframe.tensor as mt

>>> x = mt.arange(4).reshape((2,2))
>>> x.execute()
array([[0, 1],
       [2, 3]])

>>> mt.ptp(x, axis=0).execute()
array([2, 2])

>>> mt.ptp(x, axis=1).execute()
array([1, 1])