diff --git a/docs/api/paddle/Overview_cn.rst b/docs/api/paddle/Overview_cn.rst index 43dd133a974..57d7a8c1bbb 100755 --- a/docs/api/paddle/Overview_cn.rst +++ b/docs/api/paddle/Overview_cn.rst @@ -338,6 +338,7 @@ tensor 线性代数相关 " :ref:`paddle.triu ` ", "返回输入矩阵 input 的上三角部分,其余部分被设为 0" " :ref:`paddle.triu_indices ` ", "返回输入矩阵在给定对角线右上三角部分元素坐标" " :ref:`paddle.cdist ` ", "计算两组输入集合 x, y 中每对之间的 p 范数" + " :ref:`paddle.pdist ` ", "计算输入形状为 N x M 的 Tensor 中 N 个向量两两组合(pairwise)的 p 范数" .. _tensor_manipulation: diff --git a/docs/api/paddle/pdist_cn.rst b/docs/api/paddle/pdist_cn.rst new file mode 100644 index 00000000000..dcc07acfecb --- /dev/null +++ b/docs/api/paddle/pdist_cn.rst @@ -0,0 +1,25 @@ +.. _cn_api_paddle_pdist: + +pdist +------------------------------- + +.. py:function:: paddle.pdist(x, p=2.0, name=None): + +计算输入形状为 N x M 的 Tensor 中 N 个向量两两组合(pairwise)的 p 范数。 + + +参数 +:::::::::::: + + - **x** (Tensor) - 输入的 Tensor,形状为 :math:`N \times M` 。 + - **p** (float, 可选) - 计算每个向量对之间的 p 范数距离的值。默认值为 :math:`2.0`。 + - **name** (str, 可选) - 具体用法请参见 :ref:`api_guide_Name` ,一般无需设置,默认值为 None。 + +返回 +:::::::::::: +Tensor,数据类型与输入张量相同,输出的形状为 :math:`N \times (N-1) \div 2`。 + +代码示例 +:::::::::::: + +COPY-FROM: paddle.pdist