forked from mindspore-Ecosystem/mindspore
25 lines
1.4 KiB
ReStructuredText
25 lines
1.4 KiB
ReStructuredText
mindspore.ops.diff
|
||
==================
|
||
|
||
.. py:function:: mindspore.ops.diff(x, n=1, axis=-1, prepend=None, append=None)
|
||
|
||
沿着给定维度计算输入Tensor的n阶前向差分。
|
||
|
||
.. note::
|
||
- 不支持空Tensor, 如果传入了空Tensor，会出现ValueError。
|
||
|
||
参数：
|
||
- **x** (Tensor) - 输入Tensor。x元素的数据类型不支持uint16、uint32 或 uint64。
|
||
- **n** (int，可选) - 递归计算差分的阶数，目前只支持1。默认值：1。
|
||
- **axis** (int，可选)) - 计算差分的维度，默认是最后一维。默认值：-1。
|
||
- **prepend** (Tensor，可选)) - 在计算差分之前，沿 axis 将值添加到 input 或附加到 input。它们的维度必须与输入的维度相同，并且它们的shape必须与输入的shape匹配，但 axis 除外。默认值：None。
|
||
- **append** (Tensor，可选)) - 在计算差分之前，沿 axis 将值添加到 input 或附加到 input。它们的维度必须与输入的维度相同，并且它们的shape必须与输入的shape匹配，但 axis 除外。默认值：None。
|
||
|
||
返回：
|
||
Tensor，输入Tensor差分后的结果。
|
||
|
||
异常：
|
||
- **TypeError** - 如果 `x` 不是Tensor。
|
||
- **TypeError** - 如果 `x` 的元素的数据类型是uint16、uint32 或 uint64。
|
||
- **TypeError** - 如果 `x` 的维度小于1。
|
||
- **RuntimeError** - 如果 `n` 不是1。 |