From 0c4ba997f8e6f2f454908c093ca583e6383de9c1 Mon Sep 17 00:00:00 2001 From: zhouwei25 Date: Tue, 7 Apr 2026 11:48:56 +0000 Subject: [PATCH] [API Compatibility] sgn/signbit/tensordot/tril_indices/vander/logaddexp/moveaxis/nan_to_num/nanmean/nansum/*scatter Edit By AI Agent --- docs/api/paddle/select_scatter_cn.rst | 5 +++-- docs/api/paddle/sgn_cn.rst | 8 ++++++-- docs/api/paddle/signbit_cn.rst | 10 +++++++--- docs/api/paddle/take_cn.rst | 2 +- docs/api/paddle/tril_indices_cn.rst | 3 +++ docs/api/paddle/triu_indices_cn.rst | 3 +++ 6 files changed, 23 insertions(+), 8 deletions(-) diff --git a/docs/api/paddle/select_scatter_cn.rst b/docs/api/paddle/select_scatter_cn.rst index c9b73e2e728..f25365da8db 100644 --- a/docs/api/paddle/select_scatter_cn.rst +++ b/docs/api/paddle/select_scatter_cn.rst @@ -4,7 +4,8 @@ select_scatter ------------------------------- .. py:function:: paddle.select_scatter(x, values, axis, index, name=None) -将 ``values`` 矩阵的值嵌入到 ``x`` 矩阵的第 ``axis`` 维的 ``index`` 列 + +将 ``values`` 矩阵的值嵌入到 ``x`` 矩阵的第 ``axis`` 维的 ``index`` 列。 参数 ::::::::: @@ -17,7 +18,7 @@ select_scatter 返回 ::::::::: -输出 Tensor， ``x`` 矩阵的第 ``axis`` 维的第 ``index`` 列会被插入 ``value``，与 ``x`` 数据类型相同。 +输出 Tensor， ``x`` 矩阵的第 ``axis`` 维的第 ``index`` 列会被插入 ``values``，与 ``x`` 数据类型相同。 代码示例 ::::::::: diff --git a/docs/api/paddle/sgn_cn.rst b/docs/api/paddle/sgn_cn.rst index 528efe9369e..20f93f11339 100644 --- a/docs/api/paddle/sgn_cn.rst +++ b/docs/api/paddle/sgn_cn.rst @@ -3,7 +3,7 @@ sgn ------------------------------- -.. py:function:: paddle.sgn(x, name=None) +.. py:function:: paddle.sgn(x, name=None, *, out=None) 对于复数 Tensor，此函数返回一个新的 Tensor，其元素与 input 元素的角度相同且绝对值为 1。 @@ -11,9 +11,13 @@ sgn 参数 :::::::::::: - - **x** (Tensor) – 输入 Tensor，数据类型为 float16、float32、float64、complex64 或 complex128。 + - **x** (Tensor) – 输入 Tensor，数据类型为 float16、float32、float64、complex64 或 complex128。别名 ``input``。 - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。 +关键字参数 +::::::::: + - **out** (Tensor，可选) - 输出 Tensor，若不为 ``None``，计算结果将保存在该 Tensor 中，默认值为 ``None``。 + 返回 :::::::::::: Tensor，输出正负号或复数的单位向量，数据的 shape 大小及数据类型和输入 ``x`` 一致。 diff --git a/docs/api/paddle/signbit_cn.rst b/docs/api/paddle/signbit_cn.rst index 32d193663e7..5f0954f052c 100644 --- a/docs/api/paddle/signbit_cn.rst +++ b/docs/api/paddle/signbit_cn.rst @@ -3,18 +3,22 @@ signbit ------------------------------- -.. py:function:: paddle.signbit(x, name=None) +.. py:function:: paddle.signbit(x, name=None, *, out=None) 对输入参数 ``x`` 的每个元素判断是否设置了其符号位，并输出判断值。若存在符号位，则输出 True，否则输出 False。 参数 :::::::::::: - - **x** (Tensor) – 进行符号位判断的多维 Tensor，数据类型为 uint8，int8，int16，int32，int64，bfloat16，float16，float32 或 float64。 + - **x** (Tensor) – 进行符号位判断的多维 Tensor，数据类型为 uint8，int8，int16，int32，int64，bfloat16，float16，float32 或 float64。别名 ``input``。 - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。 +关键字参数 +::::::::: + - **out** (Tensor，可选) - 输出 Tensor，若不为 ``None``，计算结果将保存在该 Tensor 中，默认值为 ``None``。 + 返回 :::::::::::: -Tensor，输出掩码，数据的 shape 大小及数据类型和输入 ``x`` 一致。 +Tensor，输出掩码，数据的 shape 大小和输入 ``x`` 一致，数据类型为 bool。 代码示例 diff --git a/docs/api/paddle/take_cn.rst b/docs/api/paddle/take_cn.rst index 02c3739960c..9697f55fb69 100644 --- a/docs/api/paddle/take_cn.rst +++ b/docs/api/paddle/take_cn.rst @@ -11,7 +11,7 @@ take 参数 ::::::::: - - **x** (Tensor) - 输入的 Tensor，支持 int32、int64、float32、float64 数据类型。 + - **x** (Tensor) - 输入的 Tensor，支持 int32、int64、float32、float64 数据类型。别名 ``input``。 - **index** (Tensor) - 索引矩阵，支持 int32、int64 数据类型。 - **mode** (str，可选) - 索引越界处理，可选 ``'raise'``，``'wrap'``，``'clip'``，默认为 ``'raise'``。 diff --git a/docs/api/paddle/tril_indices_cn.rst b/docs/api/paddle/tril_indices_cn.rst index b83874ca329..ae848185efc 100644 --- a/docs/api/paddle/tril_indices_cn.rst +++ b/docs/api/paddle/tril_indices_cn.rst @@ -19,6 +19,9 @@ tril_indices - **dtype** (int，可选) - 指定输出 Tensor 的数据类型，默认值为 int64。 + .. note:: + Paddle 不支持 PyTorch 的 ``device`` 和 ``layout`` 参数。若传入这些参数，将被自动忽略。在转换 PyTorch 代码时，这些参数可以安全地传入而不影响功能，但 Paddle 会忽略它们的值。 + 返回 ::::::::: Tensor，二维矩阵的下三角矩阵行坐标和列坐标。数据类型和参数 dtype 一致。 diff --git a/docs/api/paddle/triu_indices_cn.rst b/docs/api/paddle/triu_indices_cn.rst index d1896487ab6..d4b9c7c406e 100644 --- a/docs/api/paddle/triu_indices_cn.rst +++ b/docs/api/paddle/triu_indices_cn.rst @@ -19,6 +19,9 @@ triu_indices - **dtype** (str|np.dtype|paddle.dtype，可选) - 指定输出 Tensor 的数据类型，可以是 int32，int64，默认值为 int64。 + .. note:: + Paddle 不支持 PyTorch 的 ``device`` 和 ``layout`` 参数。若传入这些参数，将被自动忽略。在转换 PyTorch 代码时，这些参数可以安全地传入而不影响功能，但 Paddle 会忽略它们的值。 + 返回 ::::::::: Tensor，返回 row*col 大小矩阵的上三角元素的坐标，其中第一行包含行坐标，第二行包含列坐标