forked from mindspore-Ecosystem/mindspore
28 lines
1.5 KiB
ReStructuredText
28 lines
1.5 KiB
ReStructuredText
mindspore.ops.trapz
|
||
====================
|
||
|
||
.. py:function:: mindspore.ops.trapz(y, x=None, dx=1.0, dim=-1)
|
||
|
||
使用梯形法则沿给定轴对 `y` (x)进行积分。
|
||
默认情况下，点之间的x轴距离将为1，或者它们可以由数组 `x` 或者标量 `dx` 提供。
|
||
|
||
.. math::
|
||
\mathop{ \int }\nolimits_{{}}^{{}}{y}{ \left( {x} \right) } \text{d} x
|
||
|
||
参数：
|
||
- **y** (Tensor) - 要积分的Tensor。
|
||
- **x** (Tensor，可选) - 对应于 `y` 值的样本点。如果 `x` 为None，则采样点均匀间隔 `dx` ，默认值：None。如果x不为None，则由 `dim` 指定的轴减去1后，x的形状应与 `y` 相同或者可以广播到 `y` 。
|
||
- **dx** (float，可选) - 当 `x` 为None时，采样点之间的间距。默认值：1.0。
|
||
- **dim** (int，可选) - 进行积分的维度。默认值：-1。
|
||
|
||
返回：
|
||
浮点类型Tenor，用梯形规则近似的定积分。如果 `y` 是一维数组，则结果是浮点数。如果 `y` 是n维数组，结果是一个N-1维数组。
|
||
|
||
异常：
|
||
- **RuntimeError** - 如果 `x` 维度为1且x.shape[0]不等于y.shape[dim]。
|
||
- **ValueError** - 如果 `dim` 不在 :math:`[-y.ndim, y.ndim)` 范围内。
|
||
- **TypeError** - 如果 `y` 不是Tensor。
|
||
- **TypeError** - 如果 `x` 不为None的同时不是Tensor。
|
||
- **TypeError** - 如果 `dx` 不是浮点数。
|
||
- **TypeError** - 如果 `dim` 不是整数。
|