Skip to content

Correct api difference format #7617

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 12 commits into from
Nov 11, 2025
Merged

Correct api difference format #7617

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
12 commits
Select commit Hold shift + click to select a range
26faff6
修复部分差异文档，完善format校验工具，新增一致性校验工具
hd9568 Nov 7, 2025
cd2a43b
修复部分差异文档，完善format校验工具，新增一致性校验工具
hd9568 Nov 7, 2025
c81b439
修复部分差异文档，完善format校验工具，新增一致性校验工具
hd9568 Nov 7, 2025
5679c26
完善格式不通过的api difference
hd9568 Nov 9, 2025
aba6fa9
fix url
hd9568 Nov 9, 2025
40a6c02
update develop
hd9568 Nov 11, 2025
494a74d
fix errors
hd9568 Nov 11, 2025
1d7b13a
add ci
hd9568 Nov 11, 2025
fdc90bb
rm tqdm
hd9568 Nov 11, 2025
fd1a87c
提交部分修改，完善一致性校验脚本
hd9568 Nov 11, 2025
ff38f64
对齐格式
hd9568 Nov 11, 2025
7e35222
增加返回码
hd9568 Nov 11, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 24 additions & 0 deletions ci_scripts/hooks/pre-doc-compile.sh
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -120,3 +120,27 @@ else
echo "ERROR: Generated API mapping file not found at $GENERATED_FILE"
handle_failure
fi

python "${APIMAPPING_ROOT}/tools/validate_api_difference_format.py"

# 获取上一条命令的退出状态码
exit_code=$?

# 根据退出状态码决定后续操作
if [ $exit_code -eq 0 ]; then
echo "API DIFFERENCE FORMAT VALIDATE SUCCESS!"
# 在这里继续添加您需要执行的命令
else
echo "ERROR: API DIFFERENCE FORMAT VALIDATE FAILURE! error code: $exit_code" >&2
exit 1
fi

python "${APIMAPPING_ROOT}/tools/validate_pytorch_api_mapping.py" --skip-url-check
exit_code=$?

if [ $exit_code -eq 0 ]; then
echo "PYTORCH API MAPPING VALIDATE SUCCESS!"
else
echo "ERROR: PYTORCH API MAPPING VALIDATE FAILURE! error code: $exit_code" >&2
exit 1
fi
6 changes: 3 additions & 3 deletions ...rt_from_pytorch/api_difference/args_default_value_diff/torch.linalg.diagonal.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ paddle.diagonal(x,

| PyTorch | PaddlePaddle | 备注 |
| ------------- | ------------ | ------------------------------------------------------ |
| <font color='red'> A </font> | <font color='red'> x </font> | 表示输入的 Tensor ，仅参数名不一致。 |
| A | x | 表示输入的 Tensor ，仅参数名不一致。 |
| offset | offset | 表示对角线偏移量。 |
| <font color='red'> dim1 </font> | <font color='red'> axis1 </font> | 获取对角线的二维平面的第一维，参数默认值不一致。PyTorch 默认为`-2`，Paddle 默认为`0`，Paddle 需设置为与 PyTorch 一致。 |
| <font color='red'> dim2 </font> | <font color='red'> axis2 </font> | 获取对角线的二维平面的第二维，参数默认值不一致。PyTorch 默认为`-1`，Paddle 默认为`1`，Paddle 需设置为与 PyTorch 一致。 |
| dim1 | axis1 | 获取对角线的二维平面的第一维，参数默认值不一致。PyTorch 默认为`-2`，Paddle 默认为`0`，Paddle 需设置为与 PyTorch 一致。 |
| dim2 | axis2 | 获取对角线的二维平面的第二维，参数默认值不一致。PyTorch 默认为`-1`，Paddle 默认为`1`，Paddle 需设置为与 PyTorch 一致。 |
2 changes: 1 addition & 1 deletion ..._convert/convert_from_pytorch/api_difference/args_name_diff/torch.Tensor.gcd.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,4 +14,4 @@ paddle.Tensor.gcd(y, name=None)

| PyTorch | PaddlePaddle | 备注 |
|----------------------------------|------------------------------| ------------------------------------------------------ |
| <font color='red'> other </font> | <font color='red'> y </font> | 输入的 Tensor ，仅参数名不一致。 |
| other | y | 输入的 Tensor ，仅参数名不一致。 |
2 changes: 1 addition & 1 deletion ...convert/convert_from_pytorch/api_difference/args_name_diff/torch.Tensor.gcd_.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,4 +14,4 @@ paddle.Tensor.gcd_(y)

| PyTorch | PaddlePaddle | 备注 |
|----------------------------------|------------------------------| ------------------------------------------------------ |
| <font color='red'> other </font> | <font color='red'> y </font> | 输入的 Tensor ，仅参数名不一致。 |
| other | y | 输入的 Tensor ，仅参数名不一致。 |
2 changes: 1 addition & 1 deletion ..._convert/convert_from_pytorch/api_difference/args_name_diff/torch.Tensor.ger.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,4 +14,4 @@ paddle.Tensor.outer(y, name=None)

| PyTorch | PaddlePaddle | 备注 |
|--------------------------------|------------------------------| ------------------------------------------------------ |
| <font color='red'> vec2 </font> | <font color='red'> y </font> | 输入的 Tensor ，仅参数名不一致。 |
| vec2 | y | 输入的 Tensor ，仅参数名不一致。 |
2 changes: 1 addition & 1 deletion ...t/convert_from_pytorch/api_difference/args_name_diff/torch.Tensor.hardshrink.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,4 +15,4 @@ paddle.nn.functional.hardshrink(x, threshold=0.5, name=None)

| PyTorch | PaddlePaddle | 备注 |
|-----------------------------------|------------------------------| ------------------------------------------------------ |
| <font color='red'> lambd </font> | <font color='red'> threshold </font> | Hardshrink 阈值，仅参数名不一致。 |
| lambd | threshold | Hardshrink 阈值，仅参数名不一致。 |
2 changes: 1 addition & 1 deletion ...rt/convert_from_pytorch/api_difference/args_name_diff/torch.Tensor.heaviside.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,4 +14,4 @@ paddle.Tensor.heaviside(y, name=None)

| PyTorch | PaddlePaddle | 备注 |
|-----------------------------------|------------------------------| ------------------------------------------------------ |
| <font color='red'> values </font> | <font color='red'> y </font> | 输入的 Tensor ，仅参数名不一致。 |
| values | y | 输入的 Tensor ，仅参数名不一致。 |
2 changes: 1 addition & 1 deletion ...nvert/convert_from_pytorch/api_difference/args_name_diff/torch.Tensor.igamma.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,4 +15,4 @@ paddle.Tensor.gammainc(y, name=None)

| PyTorch | PaddlePaddle | 备注 |
| ------- | ------------ | --------------------------- |
| other | y | 正参数 Tensor，仅参数名不同 |
| other | y | 正参数 Tensor，仅参数名不同。 |
2 changes: 1 addition & 1 deletion ...vert/convert_from_pytorch/api_difference/args_name_diff/torch.Tensor.igamma_.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,4 +15,4 @@ paddle.Tensor.gammainc_(y, name=None)

| PyTorch | PaddlePaddle | 备注 |
| ------- | ------------ | --------------------------- |
| other | y | 正参数 Tensor，仅参数名不同 |
| other | y | 正参数 Tensor，仅参数名不同。 |
2 changes: 1 addition & 1 deletion ...vert/convert_from_pytorch/api_difference/args_name_diff/torch.Tensor.igammac.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,4 +15,4 @@ paddle.Tensor.gammaincc(y, name=None)

| PyTorch | PaddlePaddle | 备注 |
| ------- | ------------ | --------------------------- |
| other | y | 正参数 Tensor，仅参数名不同 |
| other | y | 正参数 Tensor，仅参数名不同。 |
2 changes: 1 addition & 1 deletion ...ert/convert_from_pytorch/api_difference/args_name_diff/torch.Tensor.igammac_.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,4 +15,4 @@ paddle.Tensor.gammaincc_(y, name=None)

| PyTorch | PaddlePaddle | 备注 |
| ------- | ------------ | --------------------------- |
| other | y | 正参数 Tensor，仅参数名不同 |
| other | y | 正参数 Tensor，仅参数名不同。 |
6 changes: 3 additions & 3 deletions ...t/convert_from_pytorch/api_difference/args_name_diff/torch.Tensor.index_fill.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,6 @@ paddle.Tensor.index_fill(index, axis, value, name=None)

| PyTorch | PaddlePaddle | 备注 |
| ------------- | ------------ | ------------------------------------------------------ |
| <font color='red'> dim </font> | <font color='red'> axis </font> | 表示进行运算的轴，仅参数名不一致。 |
| <font color='red'> index </font> | <font color='red'> index </font> | 包含索引下标的 1-D Tensor。 |
| <font color='red'> value </font> | <font color='red'> value </font> | 填充的值。 |
| dim | axis | 表示进行运算的轴，仅参数名不一致。 |
| index | index | 包含索引下标的 1-D Tensor。 |
| value | value | 填充的值。 |
6 changes: 3 additions & 3 deletions .../convert_from_pytorch/api_difference/args_name_diff/torch.Tensor.index_fill_.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,6 @@ paddle.Tensor.index_fill_(index, axis, value, name=None)

| PyTorch | PaddlePaddle | 备注 |
| ------------- | ------------ | ------------------------------------------------------ |
| <font color='red'> dim </font> | <font color='red'> axis </font> | 表示进行运算的轴，仅参数名不一致。 |
| <font color='red'> index </font> | <font color='red'> index </font> | 包含索引下标的 1-D Tensor。 |
| <font color='red'> value </font> | <font color='red'> value </font> | 填充的值。 |
| dim | axis | 表示进行运算的轴，仅参数名不一致。 |
| index | index | 包含索引下标的 1-D Tensor。 |
| value | value | 填充的值。 |
6 changes: 3 additions & 3 deletions ...t/convert_from_pytorch/api_difference/args_name_diff/torch.Tensor.index_put_.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,6 @@ paddle.Tensor.index_put_(indices, value, accumulate=False)

| PyTorch | PaddlePaddle | 备注 |
| ------------- | ------------ | ------------------------------------------------------ |
| <font color='red'> indices </font> | <font color='red'> indices </font> | 包含用来索引的 tensors 的元组。数据类型为 int32，int64，bool。 |
| <font color='red'> values </font> | <font color='red'> value </font> | 用来给 x 赋值的 Tensor，仅参数名不一致。 |
| <font color='red'> accumulate </font> | <font color='red'> accumulate </font> | 指定是否将 value 加到 x 的参数。 默认值为 False。 |
| indices | indices | 包含用来索引的 tensors 的元组。数据类型为 int32，int64，bool。 |
| values | value | 用来给 x 赋值的 Tensor，仅参数名不一致。 |
| accumulate | accumulate | 指定是否将 value 加到 x 的参数。 默认值为 False。 |
2 changes: 1 addition & 1 deletion ...onvert/convert_from_pytorch/api_difference/args_name_diff/torch.Tensor.orgqr.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,4 +15,4 @@ paddle.Tensor.householder_product(tau, name=None)

| PyTorch | PaddlePaddle | 备注 |
| ------- | ------------ | ------------------------------ |
| input2 | tau | 用于计算矩阵乘积，仅参数名不同 |
| input2 | tau | 用于计算矩阵乘积，仅参数名不同。 |
8 changes: 4 additions & 4 deletions ...onvert/convert_from_pytorch/api_difference/args_name_diff/torch.Tensor.ormqr.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ paddle.linalg.ormqr(x, tau, y, left=True, transpose=False)

| PyTorch | PaddlePaddle | 备注 |
| --------- | ------------ | ---------------------------------- |
| input2 | tau | Householder 反射系数，仅参数名不同 |
| input3 | y | 用于矩阵乘积，仅参数名不同 |
| left | left | 决定了矩阵乘积运算的顺序 |
| transpose | transpose | 决定矩阵 Q 是否共轭转置变换 |
| input2 | tau | Householder 反射系数，仅参数名不同。 |
| input3 | y | 用于矩阵乘积，仅参数名不同。 |
| left | left | 决定了矩阵乘积运算的顺序。 |
| transpose | transpose | 决定矩阵 Q 是否共轭转置变换。 |
18 changes: 0 additions & 18 deletions ...convert/convert_from_pytorch/api_difference/args_name_diff/torch.Tensor.roll.md
View file
Open in desktop

This file was deleted.

2 changes: 1 addition & 1 deletion ...model_convert/convert_from_pytorch/api_difference/args_name_diff/torch.cdist.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,5 +16,5 @@ paddle.cdist(x, y, p=2.0, compute_mode='use_mm_for_euclid_dist_if_necessary', na
| ------------- | ------------ | ------------------------------------------------------ |
| x1 | x | 表示第一个输入的 Tensor ，仅参数名不一致。 |
| x2 | y | 表示第二个输入的 Tensor ，仅参数名不一致。 |
| p | p | 计算每个向量对之间的 p 范数距离的值。默认值为 2.0 |
| p | p | 计算每个向量对之间的 p 范数距离的值。默认值为 2.0。 |
| compute_mode | compute_mode |表示计算模式。 |
4 changes: 2 additions & 2 deletions ...vert/convert_from_pytorch/api_difference/args_name_diff/torch.cholesky_solve.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,6 @@ paddle.linalg.cholesky_solve(x, y, upper=False, name=None)

| PyTorch | PaddlePaddle | 备注 |
| ------- | ------------ | ---------------------------------------------------------------------------------- |
| input | x | 表示线性方程中的 B 矩阵。仅参数名不一致 |
| input2 | y | 表示线性方程中 A 矩阵的 Cholesky 分解矩阵 u。仅参数名不一致 |
| input | x | 表示线性方程中的 B 矩阵。仅参数名不一致。 |
| input2 | y | 表示线性方程中 A 矩阵的 Cholesky 分解矩阵 u。仅参数名不一致。 |
| upper | upper | 表示输入 x 是否是上三角矩阵，True 为上三角矩阵，False 为下三角矩阵。|
4 changes: 2 additions & 2 deletions ...el_convert/convert_from_pytorch/api_difference/args_name_diff/torch.corrcoef.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,5 +16,5 @@ paddle.linalg.corrcoef(x,

| PyTorch | PaddlePaddle | 备注 |
| ------------- | ------------ | ------------------------------------------------------ |
| <font color='red'> input </font> | <font color='red'> x </font> | 一个 N(N<=2) 维矩阵，包含多个变量。默认矩阵的每行是一个观测变量，由参数 rowvar 设置。 |
| - | <font color='red'> rowvar </font> | 以行或列作为一个观测变量， PyTorch 无此参数， Paddle 保持默认即可。 |
| input | x | 一个 N(N<=2) 维矩阵，包含多个变量。默认矩阵的每行是一个观测变量，由参数 rowvar 设置。 |
| - | rowvar | 以行或列作为一个观测变量， PyTorch 无此参数， Paddle 保持默认即可。 |
18 changes: 0 additions & 18 deletions ...onvert_from_pytorch/api_difference/args_name_diff/torch.cuda.nvtx.range_push.md
View file
Open in desktop

This file was deleted.

2 changes: 1 addition & 1 deletion ...s/model_convert/convert_from_pytorch/api_difference/args_name_diff/torch.det.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,4 +14,4 @@ paddle.linalg.det(x)

| PyTorch | PaddlePaddle | 备注 |
| ------------- | ------------ | ------------------------------------------------------ |
| <font color='red'> input </font> | <font color='red'> x </font> | 表示输入的 Tensor ，仅参数名不一致。 |
| input | x | 表示输入的 Tensor ，仅参数名不一致。 |
2 changes: 1 addition & 1 deletion ...el_convert/convert_from_pytorch/api_difference/args_name_diff/torch.diagflat.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,5 +17,5 @@ paddle.diagflat(x,

| PyTorch | PaddlePaddle | 备注 |
| ------------- | ------------ | ------------------------------------------------------ |
| <font color='red'> input </font> | <font color='red'> x </font> | 表示输入的 Tensor ，仅参数名不一致。 |
| input | x | 表示输入的 Tensor ，仅参数名不一致。 |
| offset | offset | 表示对角线偏移量。 |
6 changes: 3 additions & 3 deletions ...el_convert/convert_from_pytorch/api_difference/args_name_diff/torch.diagonal.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ paddle.diagonal(x,

| PyTorch | PaddlePaddle | 备注 |
| ------------- | ------------ | ------------------------------------------------------ |
| <font color='red'> input </font> | <font color='red'> x </font> | 表示输入的 Tensor ，仅参数名不一致。 |
| input | x | 表示输入的 Tensor ，仅参数名不一致。 |
| offset | offset | 表示对角线偏移量。 |
| <font color='red'> dim1 </font> | <font color='red'> axis1 </font> | 获取对角线的二维平面的第一维，仅参数名不一致。 |
| <font color='red'> dim2 </font> | <font color='red'> axis2 </font> | 获取对角线的二维平面的第二维，仅参数名不一致。 |
| dim1 | axis1 | 获取对角线的二维平面的第一维，仅参数名不一致。 |
| dim2 | axis2 | 获取对角线的二维平面的第二维，仅参数名不一致。 |
10 changes: 5 additions & 5 deletions ...rt/convert_from_pytorch/api_difference/args_name_diff/torch.diagonal_scatter.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,8 +23,8 @@ paddle.diagonal_scatter(x,

| PyTorch | PaddlePaddle | 备注 |
|---------|--------------| -------------------------------------------------- |
| <font color='red'> input </font> | <font color='red'> x </font> | 输入张量，被嵌入的张量，仅参数名不一致。 |
| <font color='red'> src </font> | <font color='red'> y </font> | 用于嵌入的张量，仅参数名不一致。 |
| <font color='red'> offset </font> | <font color='red'> offset </font> | 从指定的二维平面嵌入对角线的位置，默认值为 0，即主对角线。 |
| <font color='red'> dim1 </font> | <font color='red'> axis1 </font> | 对角线的第一个维度，默认值为 0，仅参数名不一致。 |
| <font color='red'> dim2 </font> | <font color='red'> axis2 </font> | 对角线的第二个维度，默认值为 1，仅参数名不一致。 |
| input | x | 输入张量，被嵌入的张量，仅参数名不一致。 |
| src | y | 用于嵌入的张量，仅参数名不一致。 |
| offset | offset | 从指定的二维平面嵌入对角线的位置，默认值为 0，即主对角线。 |
| dim1 | axis1 | 对角线的第一个维度，默认值为 0，仅参数名不一致。 |
| dim2 | axis2 | 对角线的第二个维度，默认值为 1，仅参数名不一致。 |
6 changes: 3 additions & 3 deletions .../model_convert/convert_from_pytorch/api_difference/args_name_diff/torch.dist.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,6 @@ paddle.dist(x,

| PyTorch | PaddlePaddle | 备注 |
| ------------- | ------------ | ------------------------------------------------------ |
| <font color='red'> input </font> | <font color='red'> x </font> | 表示输入的 Tensor ，仅参数名不一致。 |
| <font color='red'> other </font> | <font color='red'> y </font> | 表示输入的 Tensor ，仅参数名不一致。 |
| p | p | 表示需要计算的范数 |
| input | x | 表示输入的 Tensor ，仅参数名不一致。 |
| other | y | 表示输入的 Tensor ，仅参数名不一致。 |
| p | p | 表示需要计算的范数。 |
4 changes: 2 additions & 2 deletions .../model_convert/convert_from_pytorch/api_difference/args_name_diff/torch.flip.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,5 +17,5 @@ paddle.flip(x,

| PyTorch | PaddlePaddle | 备注 |
| ------------- | ------------ | ------------------------------------------------------ |
| <font color='red'> input </font> | <font color='red'> x </font> | 表示输入的 Tensor ，仅参数名不一致。 |
| <font color='red'> dims </font> | <font color='red'> axis </font> | 表示进行运算的轴，仅参数名不一致。 |
| input | x | 表示输入的 Tensor ，仅参数名不一致。 |
| dims | axis | 表示进行运算的轴，仅参数名不一致。 |
4 changes: 2 additions & 2 deletions ...del_convert/convert_from_pytorch/api_difference/args_name_diff/torch.isclose.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,8 +23,8 @@ paddle.isclose(x,

| PyTorch | PaddlePaddle | 备注 |
| ------------- | ------------ | ------------------------------------------------------ |
| <font color='red'> input </font> | <font color='red'> x </font> | 表示输入的 Tensor ，仅参数名不一致。 |
| <font color='red'> other </font> | <font color='red'> y </font> | 表示输入的 Tensor ，仅参数名不一致。 |
| input | x | 表示输入的 Tensor ，仅参数名不一致。 |
| other | y | 表示输入的 Tensor ，仅参数名不一致。 |
| rtol | rtol | 表示相对容忍误差。 |
| atol | atol | 表示绝对容忍误差。 |
| equal_nan | equal_nan | 表示是否将两个 NaN 数值视为相等。 |
4 changes: 2 additions & 2 deletions ...convert/convert_from_pytorch/api_difference/args_name_diff/torch.masked_fill.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,5 +16,5 @@ paddle.masked_fill(x, mask, value, name=None)
| PyTorch | PaddlePaddle | 备注 |
| ------- | ------------ | ------------------------------- |
| input | x | 输入的 Tensor，仅参数名不一致。 |
| mask | mask | 布尔张量，表示要填充的位置 |
| value | value | 用于填充目标张量的值 |
| mask | mask | 布尔张量，表示要填充的位置。 |
| value | value | 用于填充目标张量的值。 |
Loading