diff --git a/docs/api/paddle/Overview_cn.rst b/docs/api/paddle/Overview_cn.rst index 49f07a3365d..90301d80d75 100755 --- a/docs/api/paddle/Overview_cn.rst +++ b/docs/api/paddle/Overview_cn.rst @@ -72,6 +72,7 @@ tensor数学操作 " :ref:`paddle.log ` ", "Log激活函数(计算自然对数)" " :ref:`paddle.log10 ` ", "Log10激活函数(计算底为10的对数)" " :ref:`paddle.log2 ` ", "计算Log1p(加一的自然对数)结果" + " :ref:`paddle.logcumsumexp ` ", "计算 x 的指数的前缀和的对数" " :ref:`paddle.logical_and ` ", "逐元素的对 x 和 y 进行逻辑与运算" " :ref:`paddle.logical_not ` ", "逐元素的对 X Tensor进行逻辑非运算" " :ref:`paddle.logical_or ` ", "逐元素的对 X 和 Y 进行逻辑或运算" diff --git a/docs/api/paddle/Tensor/Overview_en.rst b/docs/api/paddle/Tensor/Overview_en.rst index 07848c31537..93d3f685cac 100644 --- a/docs/api/paddle/Tensor/Overview_en.rst +++ b/docs/api/paddle/Tensor/Overview_en.rst @@ -162,6 +162,7 @@ Methods log10 log1p log2 + logcumsumexp logical_and logical_not logical_or diff --git a/docs/api/paddle/Tensor_cn.rst b/docs/api/paddle/Tensor_cn.rst index 463851a520f..b84e1970db0 100755 --- a/docs/api/paddle/Tensor_cn.rst +++ b/docs/api/paddle/Tensor_cn.rst @@ -1355,6 +1355,15 @@ log1p(name=None) 请参考 :ref:`cn_api_paddle_tensor_log1p` +logcumsumexp(x, axis=None, dtype=None, name=None) +::::::::: + +返回:计算后的Tensor + +返回类型:Tensor + +请参考 :ref:`cn_api_paddle_tensor_logcumsumexp` + logical_and(y, out=None, name=None) ::::::::: diff --git a/docs/api/paddle/logcumsumexp_cn.rst b/docs/api/paddle/logcumsumexp_cn.rst new file mode 100644 index 00000000000..2e1accdc080 --- /dev/null +++ b/docs/api/paddle/logcumsumexp_cn.rst @@ -0,0 +1,34 @@ +.. _cn_api_tensor_logcumsumexp: + +logcumsumexp +------------------------------- + +.. py:function:: paddle.logcumsumexp(x, axis=None, dtype=None, name=None) + +计算 x 的指数的前缀和的对数。 + +.. note:: + 结果的第一个元素和输入的第一个元素相同。 + +假设输入是二维矩阵,j 是 axis 维的下标,i 是另一维的下标,那么运算结果将是 + +.. math:: + + logcumsumexp(x)_{ij} = log \sum_{i=0}^{j}exp(x_{ij}) + +参数 +::::::::: + - **x** (Tensor) - 需要进行操作的Tensor。 + - **axis** (int,可选) - 指明需要计算的维度。-1代表最后一维。默认:None,将输入展开为一维变量再进行计算。 + - **dtype** (str,可选) - 输出Tensor的数据类型,支持float32、float64. 如果指定了,那么在执行操作之前,输入张量将被转换为dtype. 这对于防止数据类型溢出非常有用。默认为:None。 + - **name** (str,可选)- 操作的名称(可选,默认值为None)。更多信息请参见 :ref:`api_guide_Name` 。 + +返回 +::::::::: + - Tensor (Tensor),x 的指数的前缀和的对数。 + + +代码示例 +::::::::: + +COPY-FROM: paddle.logcumsumexp