Skip to content

Commit 6ffb109

Browse files
committed
更新映射文档分类简介,添加第二类api示例
1 parent f6fb3f5 commit 6ffb109

File tree

1 file changed

+28
-31
lines changed

1 file changed

+28
-31
lines changed

docs/guides/model_convert/convert_from_pytorch/pytorch_api_mapping_cn.md

Lines changed: 28 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -12,8 +12,8 @@
1212

1313
| 序号 | 类别 | 简介 |
1414
| ---- | ---- | ---- |
15-
| 1 |API 完全一致|**此类 API 能极大降低代码迁移成本,其使用方式完全一致** 只需要将代码中所有前缀 `torch.`替换为 `paddle.`即可。(或者只需在文件最上方插入一行 `import paddle as torch`即可|
16-
| 2 |仅 API 调用方式不一致|参数一致,但 API 调用方式不一致。此类 API 需要转换,但转换成本较低,只需要对 API 调用方式进行改写,无需处理 API 参数部分。包括:API 名称不同、API 路径不同、Tensor 类方法改成普通方法、Tensor 方法改成属性、Tensor 属性改成方法 等情况。|
15+
| 1 |API 完全一致| **此类 API 没有转写成本,两者用法完全一致** 只需将代码中所有前缀 ``torch.`` 替换为 ``paddle.`` 即可。(也可只在文件最上方插入一行 ``import paddle as torch``|
16+
| 2 |仅 API 调用方式不一致|此类 API 的转写成本较低,只需对 API 调用方式进行改写,无需转写 API 参数部分|
1717
| 3 |仅参数名不一致|此类 API 功能相同,但部分参数名称不同|
1818
| 4 |paddle 参数更多|此类 API 在 PaddlePaddle 中提供了更多可选参数|
1919
| 5 |参数默认值不一致|此类 API 功能相同,但某些参数的默认值不同|
@@ -27,11 +27,9 @@
2727
| 13 |功能缺失|此类 PyTorch API 的功能在 PaddlePaddle 中暂时没有等效实现|
2828

2929
### 1. API 完全一致
30-
**分类简介**
3130

32-
此类 API 只需要将代码中所有前缀 `torch.`替换为 `paddle.`即可。(或者只需在文件最上方插入一行 `import paddle as torch`即可)
31+
**简介:此类 API 没有转写成本,两者用法完全一致,** 只需将代码中所有前缀 ``torch.`` 替换为 ``paddle.`` 即可。(也可只在文件最上方插入一行 ``import paddle as torch``)。示例如下。
3332

34-
**转写示例**
3533
```python
3634
# PyTorch 写法
3735
torch.eye(5)
@@ -49,110 +47,109 @@ paddle.nn.Softplus(beta=0.5, threshold=15)
4947
|------|-------------------|---------------|----------|------|
5048

5149
### 2. 仅 API 调用方式不一致
52-
**分类简介**
5350

54-
此类 API 需要转换,但转换成本较低,只需要对 API 调用方式进行改写,无需处理 API 参数部分。
51+
**简介:** 此类 API 的转写成本较低,只需对 API 调用方式进行改写,无需转写 API 参数部分。示例如下
5552

53+
```python
54+
# PyTorch 写法
55+
torch.numel(x)
56+
out = x.matrix_exp()
57+
out = x.to_sparse(1)
58+
out = x.clamp_(-0.5, 0.5)
59+
60+
# Paddle 写法
61+
x.size
62+
out = paddle.linalg.matrix_exp(x)
63+
out = x.to_sparse_coo(1)
64+
out = x.clip_(-0.5, 0.5)
65+
```
5666

5767
| 序号 | Pytorch 最新 release | Paddle develop | 映射分类 | 备注 |
5868
|------|-------------------|---------------|----------|------|
5969

6070
### 3. 仅参数名不一致
61-
**分类简介**
6271

63-
此类 API 功能相同,但部分参数名称不同。
72+
**简介:** 此类 API 功能相同,但部分参数名称不同。
6473

6574
| 序号 | Pytorch 最新 release | Paddle develop | 映射分类 | 备注 |
6675
|------|-------------------|---------------|----------|------|
6776

6877
### 4. paddle 参数更多
69-
**分类简介**
70-
71-
此类 API 在 PaddlePaddle 中提供了更多可选参数。
7278

79+
**简介:** 此类 API 在 PaddlePaddle 中提供了更多可选参数。
7380

7481
| 序号 | Pytorch 最新 release | Paddle develop | 映射分类 | 备注 |
7582
|------|-------------------|---------------|----------|------|
7683

7784

7885
### 5. 参数默认值不一致
79-
**分类简介**
80-
81-
此类 API 功能相同,但某些参数的默认值不同
8286

87+
**简介:** 此类 API 功能相同,但某些参数的默认值不同
8388

8489
| 序号 | Pytorch 最新 release | Paddle develop | 映射分类 | 备注 |
8590
|------|-------------------|---------------|----------|------|
8691

8792

8893
### 6. torch 参数更多
89-
**分类简介**
9094

91-
此类 API 在 PyTorch 中提供了更多参数。
95+
**简介:** 此类 API 在 PyTorch 中提供了更多参数。
9296

9397
| 序号 | Pytorch 最新 release | Paddle develop | 映射分类 | 备注 |
9498
|------|-------------------|---------------|----------|------|
9599

96100

97101
### 7. 输入参数用法不一致
98-
**分类简介**
99102

100-
此类 API 对输入参数的处理方式不同。
103+
**简介:** 此类 API 对输入参数的处理方式不同。
101104

102105
| 序号 | Pytorch 最新 release | Paddle develop | 映射分类 | 备注 |
103106
|------|-------------------|---------------|----------|------|
104107

105108
### 8. 输入参数类型不一致
106-
**分类简介**
107109

108-
此类 API 要求的输入数据类型不同。
110+
**简介:** 此类 API 要求的输入数据类型不同。
109111

110112

111113
| 序号 | Pytorch 最新 release | Paddle develop | 映射分类 | 备注 |
112114
|------|-------------------|---------------|----------|------|
113115

114116

115117
### 9. 返回参数类型不一致
116-
**分类简介**
117118

118-
​此类 API 返回值的类型或结构不同。
119+
**简介:** ​此类 API 返回值的类型或结构不同。
119120

120121

121122
| 序号 | Pytorch 最新 release | Paddle develop | 映射分类 | 备注 |
122123
|------|-------------------|---------------|----------|------|
123124

124125

125126
### 10. 组合替代实现
126-
**分类简介**
127127

128-
此类功能在 PaddlePaddle 中没有直接对应的单一 API,需要通过多个 PaddlePaddle API 组合来实现。
128+
**简介:** 此类功能在 PaddlePaddle 中没有直接对应的单一 API,需要通过多个 PaddlePaddle API 组合来实现。
129129

130130
| 序号 | Pytorch 最新 release | Paddle develop | 映射分类 | 备注 |
131131
|------|-------------------|---------------|----------|------|
132132

133133

134134
### 11. 可删除
135-
**分类简介**
136135

137-
此类 PyTorch API 在 PaddlePaddle 中可以直接删除。
136+
**简介:** 此类 PyTorch API 在 PaddlePaddle 中可以直接删除。
138137

139138
| 序号 | Pytorch 最新 release | Paddle develop | 映射分类 | 备注 |
140139
|------|-------------------|---------------|----------|------|
141140

142141

143142
### 12. API 别名
144-
**分类简介**
145143

146-
此类 PyTorch API 是其他 Pytorch API 的别名
144+
**简介:** 此类 PyTorch API 是其他 Pytorch API 的别名
147145

148146
| 序号 | Pytorch 最新 release | Paddle develop | 映射分类 | 备注 |
149147
|------|-------------------|---------------|----------|------|
150148

151149

152150
### 13. 功能缺失
153-
**分类简介**
154151

155-
此类 PyTorch API 的功能在 PaddlePaddle 中暂时没有等效实现。
152+
**简介:** 此类 PyTorch API 的功能在 PaddlePaddle 中暂时没有等效实现。
156153

157154

158155
| 序号 | Pytorch 最新 release | Paddle develop | 映射分类 | 备注 |

0 commit comments

Comments
 (0)