mindspore/docs/api/api_python/ops/mindspore.ops.CumulativeLog...

25 lines
1.7 KiB
ReStructuredText
Raw Permalink Normal View History

2022-11-22 18:48:41 +08:00
mindspore.ops.CumulativeLogsumexp
==================================
.. py:class:: mindspore.ops.CumulativeLogsumexp(exclusive=False, reverse=False)
计算输入 `x` 沿轴 `axis` 的累积LogSumExp函数值。即在参数均为默认值的情况下若输入 `x` 为[a, b, c],则输出为[a, log(exp(a) + exp(b)), log(exp(a) + exp(b) + exp(c))]。
2022-11-22 18:48:41 +08:00
参数:
- **exclusive** (bool, 可选) - 如果为True将在计算时跳过最后一个元素此时输出为[-inf, a, log(exp(a) * exp(b))],其中-inf在输出时出于性能原因将以一个极小负数的形式呈现。默认值False。
- **reverse** (bool, 可选) - 如果为True将对 `x` 指定轴的元素进行翻转后再计算函数累积值,同时再将该计算结果进行翻转,此时输出为:[log(exp(c) + exp(b) + exp(a)), log(exp(c) + exp(b)), c]。默认值False。
输入:
- **x** (Tensor) - 数据类型需为float16、float32或float64之一维度必须大于0。
- **axis** (Tensor) - 0D Tensor表示 `x` 中将进行运算的维度数据类型需为int16、int32或int64之一取值范围应在区间[-rank(x), rank(x))中。默认值0。
输出:
`x` 的shape和数据类型一致的Tensor。
异常:
- **TypeError** - 输入 `x``axis` 不是Tensor。
- **TypeError** - `x` 的数据类型不是float16、float32或float64之一。
- **TypeError** - `axis` 的数据类型不是int16、int32或int64之一。
- **TypeError** - 参数 `exclusive``reverse` 不是布尔值。
- **ValueError** - `x` 的维度不大于0。
- **RuntimeError** - `axis` 中的值不在[-rank(x), rank(x))中。