映射文档No.79 #5853

zhangtailai · 2023-05-05T02:53:40Z

完成 #5691 中No.79的文档映射工作，其中新增10个api映射文档，有问题请联系

paddle-bot · 2023-05-05T02:53:44Z

感谢你贡献飞桨文档，文档预览构建中，Docs-New 跑完后即可预览，预览链接：http://preview-pr-5853.paddle-docs-preview.paddlepaddle.org.cn/documentation/docs/zh/api/index_cn.html
预览工具的更多说明，请参考：飞桨文档预览工具

CLAassistant · 2023-05-05T02:53:44Z

All committers have signed the CLA.

zhangtailai · 2023-05-05T12:52:32Z

@Tomoko-hjf 请检查一下还有没有什么问题

Skylark-hjyp

需要保持和已合并PR格式上的统一，可以参考格式文档https://github.com/PaddlePaddle/docs/blob/develop/docs/guides/model_convert/convert_from_pytorch/api_difference/pytorch_api_mapping_format_cn.md 和已经合并的PR
辛苦修改一下格式~

zhangtailai · 2023-05-06T06:18:44Z

@Tomoko-hjf 已修改，麻烦在检查一下

Skylark-hjyp

有几个共性问题：

api签名和转写示例部分代码前面的空格可以删去
参数映射部分前面需要一句话说明，可以参考格式文档。如果是参数不一致的情况，需要说明哪个参数用法不一致，并用强调
文档里有很多无用的注释，可以检查后删去
参数映射部分的备注部分可以精简一下，不必把官网内容全都拿过来
辛苦修改一下~

Skylark-hjyp · 2023-05-08T07:55:27Z

docs/guides/model_convert/convert_from_pytorch/api_difference/Tensor/torch.Tensor.permute.md

+### [torch.Tensor.permute](https://pytorch.org/docs/1.13/generated/torch.Tensor.permute.html)
+
+```python
+    torch.Tensor.permute(*dims)


可以删去前面多余的空格

Skylark-hjyp · 2023-05-08T07:55:45Z

docs/guides/model_convert/convert_from_pytorch/api_difference/Tensor/torch.Tensor.permute.md

+### 转写示例
+#### *dim: Tensor 的维度序列，可变参数用法
+```python
+    # pytorch


转写示例也可以删去前面多余的空格

Skylark-hjyp · 2023-05-08T08:01:17Z

docs/guides/model_convert/convert_from_pytorch/api_difference/Tensor/torch.Tensor.permute.md

+```
+
+### 参数映射
+两者部分参数用法不同，具体如下：


改为 Pytorch 的 dims 参数与 Paddle 的 perm 参数用法不同，具体如下：

位置放在 ### 参数映射的上一行

Skylark-hjyp · 2023-05-08T08:02:53Z

docs/guides/model_convert/convert_from_pytorch/api_difference/Tensor/torch.Tensor.permute.md

+两者部分参数用法不同，具体如下：
+| PyTorch       | PaddlePaddle | 备注                                                   |
+| ------------- | ------------ | ------------------------------------------------------ |
+| *dims | perm | dim ：torch 可以为 *dim 和 list/tuple 的用法; perm ：paddle 仅为 list/tuple 的用法。 torch 的参数为 *dim 时需要转写 |


备注改为 torch 支持可变参数或list/tuple，paddle仅支持list/tuple，参数用法不一致，需要进行转写。

Skylark-hjyp · 2023-05-08T08:04:02Z

docs/guides/model_convert/convert_from_pytorch/api_difference/Tensor/torch.Tensor.repeat.md

+```
+
+### 参数映射
+两者部分参数用法不同，具体如下：


改为 Pytorch 的 sizes 参数与 Paddle 的 repeat_times 参数用法不同，具体如下：

位置放在 ### 参数映射的上一行

Skylark-hjyp · 2023-05-08T08:06:20Z

docs/guides/model_convert/convert_from_pytorch/api_difference/Tensor/torch.Tensor.repeat.md

+### 转写示例
+#### *sizes: 各个维度重复的次数，可变参数用法
+```python
+    # pytorch


前面的空格可以去掉~

Skylark-hjyp · 2023-05-08T08:07:01Z

docs/guides/model_convert/convert_from_pytorch/api_difference/Tensor/torch.Tensor.reshape.md

+### [torch.Tensor.reshape](https://pytorch.org/docs/1.13/generated/torch.Tensor.reshape.html)
+
+```python
+    torch.Tensor.reshape(*shape)


可以去掉空格，顺便检查一下其他文件~

Skylark-hjyp · 2023-05-08T08:08:51Z

docs/guides/model_convert/convert_from_pytorch/api_difference/Tensor/torch.Tensor.svd.md

+| some | full_matrices | 表示是否计算完整的 U 和 V 矩阵。默认时效果一致。 some 为 True 时， full_matrices 需设置为 False ，反之同理。 |
+| compute_uv | - | 如果 compute_uv 为 False ，则返回的 U 和 V 将分别为形状为 (m, m) 和 (n ,n) 的零填充矩阵，并且与输入设备相同。当 compute_uv 为 False 时，参数 some 不起作用。一般直接删除即可，无需转写。 |
+
+<!-- ### torch 多的参数


这部分多余的内容可以删去

Skylark-hjyp · 2023-05-08T08:09:21Z

docs/guides/model_convert/convert_from_pytorch/api_difference/Tensor/torch.Tensor.svd.md

+| ------------- | -------------------------------------------------------------------- |
+| compute_uv | 默认参数，默认一致。如果 compute_uv 为 False ，则返回的 U 和 V 将分别为形状为 (m, m) 和 (n ,n) 的零填充矩阵，并且与输入设备相同。当 compute_uv 为 False 时，参数 some 不起作用。 | -->
+
+<!-- ### 转写示例


转写示例前后的  注释符号删去

Skylark-hjyp · 2023-05-08T08:11:06Z

.../guides/model_convert/convert_from_pytorch/api_difference/cuda/torch.cuda.get_device_name.md

+```
+
+<!-- ### 一致的参数
+| PyTorch       | PaddlePaddle | 备注                                                   |


一致的参数也需要写到参数映射中去，不能注释起来

zhangtailai · 2023-05-08T12:55:18Z

@Tomoko-hjf 已修改，麻烦再检查一下还有什么问题。

Skylark-hjyp

有几个api名称和链接不一致，辛苦检查修改一下 ~
一句话描述部分的参数用一对 ` ` 强调即可，不需要两对

Skylark-hjyp · 2023-05-10T03:42:38Z

.../guides/model_convert/convert_from_pytorch/api_difference/cuda/torch.cuda.get_device_name.md

+torch.cuda.get_device_name(device=None)
+```
+
+### [paddle.Tensor.transpose](https://www.paddlepaddle.org.cn/documentation/docs/zh/api/paddle/device/cuda/get_device_properties_cn.html#get-device-properties)


api名称不正确

Skylark-hjyp · 2023-05-10T03:44:19Z

docs/guides/model_convert/convert_from_pytorch/api_difference/cuda/torch.cuda.device.md

+paddle.CUDAPlace(id)
+```
+
+Pytorch 的 ``device`` 与 Paddle 的 ``id`` 用法不同，具体如下：


用一对 ` ` 包含即可，目前是用了两对

Skylark-hjyp · 2023-05-10T03:45:24Z

.../guides/model_convert/convert_from_pytorch/api_difference/cuda/torch.cuda.get_device_name.md

+### 参数映射
+| PyTorch       | PaddlePaddle | 备注                                                   |
+| ------------- | ------------ | ------------------------------------------------------ |
+| device | device | torch 的 device 参数类型为 torch.device 或 int 或 str。paddle 的 id 为 paddle.CUDAPlace 或 int 或 str。 |


应该是 paddle 的 device 吧

Skylark-hjyp · 2023-05-10T03:46:05Z

docs/guides/model_convert/convert_from_pytorch/api_difference/cuda/torch.cuda.device.md

+torch.cuda.device(device)
+```
+
+### [paddle.Tensor.transpose](https://www.paddlepaddle.org.cn/documentation/docs/zh/api/paddle/CUDAPlace_cn.html#cudaplace)


api 名称不正确

Skylark-hjyp · 2023-05-10T03:46:49Z

docs/guides/model_convert/convert_from_pytorch/api_difference/Tensor/torch.Tensor.transpose.md

@@ -0,0 +1,31 @@
+## [参数不一致]torch.Tensor.transpose
+
+### [torch.Tensor.transpose](https://pytorch.org/docs/1.13/generated/torch.Tensor.swapdims.html)


链接不正确

Skylark-hjyp · 2023-05-10T03:53:10Z

docs/guides/model_convert/convert_from_pytorch/api_difference/Tensor/torch.Tensor.svd.md

+paddle.linalg.svd(x, full_matrics=False, name=None)
+```
+
+两者部分参数用法不同，具体如下：


说明一下哪个参数用法不一致吧~

Skylark-hjyp · 2023-05-10T03:53:57Z

docs/guides/model_convert/convert_from_pytorch/api_difference/Tensor/torch.Tensor.svd.md

+### 参数映射
+| PyTorch       | PaddlePaddle | 备注                                                   |
+| ------------- | ------------ | ------------------------------------------------------ |
+| some | full_matrices | 表示是否计算完整的 U 和 V 矩阵。默认时效果一致。 some 为 True 时， full_matrices 需设置为 False ，反之同理。 |


这个参数可以写一个转写示例，some 为 True ， full_matrices 设置为 False 。

Skylark-hjyp · 2023-05-10T03:54:42Z

docs/guides/model_convert/convert_from_pytorch/api_difference/Tensor/torch.Tensor.svd.md

+| PyTorch       | PaddlePaddle | 备注                                                   |
+| ------------- | ------------ | ------------------------------------------------------ |
+| some | full_matrices | 表示是否计算完整的 U 和 V 矩阵。默认时效果一致。 some 为 True 时， full_matrices 需设置为 False ，反之同理。 |
+| compute_uv | - | 默认时效果一致。一般直接删除即可，无需转写。 |


如果compute_uv 为 False可以进行转写吗，不可以的话备注写暂不支持转写就可以

Skylark-hjyp · 2023-05-10T03:58:25Z

docs/guides/model_convert/convert_from_pytorch/api_difference/Tensor/torch.Tensor.reshape.md

+paddle.Tensor.reshape(shape, name=None)
+```
+
+Pytorch 的 ``*shape`` 参数与 Paddle 的 ``shape`` 参数用法不同，具体如下：


用一对 ` ` 包含既可~

Skylark-hjyp · 2023-05-10T04:01:18Z

docs/guides/model_convert/convert_from_pytorch/api_difference/Tensor/torch.Tensor.repeat.md

+paddle.Tensor.tile(repeat_times, name=None)
+```
+
+Pytorch 的 sizes 参数与 Paddle 的 repeat_times 参数用法不同，具体如下：


sizes 和 repeat_times 用 `` 强调一下吧~

zhangtailai · 2023-05-10T07:13:56Z

@Tomoko-hjf 已修改，麻烦再次检查

Skylark-hjyp

转写示例部分pytorch和paddle最终的输出变量名统一成y，或者一致的名称吧，现在是不一致的，辛苦修改一下~

Skylark-hjyp · 2023-05-11T02:12:07Z

docs/guides/model_convert/convert_from_pytorch/api_difference/cuda/torch.cuda.device.md

+### 参数映射
+| PyTorch       | PaddlePaddle | 备注                                                   |
+| ------------- | ------------ | ------------------------------------------------------ |
+| device | id | torch 的 device 参数类型为 torch.device 或 int 。paddle 的 id 为 int。 torch 参数为 int 时无需转写， 参数为 torch.device 时， paddle 暂无转写方式。|


当参数为torch.device 时也可以进行转写，转写方法为

# PyTorch 写法 torch.cuda.device(torch.device('cuda:0')) # Paddle 写法 paddle.CUDAPlace(0)

Skylark-hjyp · 2023-05-11T02:14:40Z

docs/guides/model_convert/convert_from_pytorch/api_difference/Tensor/torch.Tensor.swapdims.md

+
+# paddle
+x = paddle.randn([2, 3, 5])
+x_transposed = x.transpose(perm=[1, 0, 2])


pytorch和paddle转写示例的两个输出变量都统一成y吧，或者名称要一致，现在一个是x_swapdims，一个是x_transposed

Skylark-hjyp · 2023-05-11T02:15:37Z

docs/guides/model_convert/convert_from_pytorch/api_difference/Tensor/torch.Tensor.swapaxes.md

+
+# paddle
+x = paddle.randn([2, 3, 5])
+x_transposed = x.transpose(perm=[1, 0, 2])


两个输出变量名要一致

Skylark-hjyp · 2023-05-11T02:18:04Z

docs/guides/model_convert/convert_from_pytorch/api_difference/Tensor/torch.Tensor.reshape.md

+
+# paddle
+x = paddle.randn([2, 3, 5])
+x_tile_tuple = x.tile((6,5))


输出变量名统一成一致的吧~

Skylark-hjyp · 2023-05-11T02:18:33Z

docs/guides/model_convert/convert_from_pytorch/api_difference/Tensor/torch.Tensor.repeat.md

+
+# paddle
+x = paddle.randn([2, 3, 5])
+x_tile_tuple = x.tile((4,2,1))


输出变量名统一成一致的吧

Skylark-hjyp · 2023-05-11T02:19:20Z

docs/guides/model_convert/convert_from_pytorch/api_difference/Tensor/torch.Tensor.permute.md

+paddle.Tensor.transpose(perm, name=None)
+```
+
+torch 的 `*dims` 与 paddle 的 `perm` 两者部分参数用法不同，具体如下：


写完整吧，改为 PyTorch 的 dim 与 paddle 的 perm 两者部分参数用法不同，具体如下：

zhangtailai · 2023-05-11T04:29:47Z

@Tomoko-hjf 已修改，麻烦再检查一下

Skylark-hjyp

LGTM

zhwesky2010 · 2023-05-16T09:16:23Z

docs/guides/model_convert/convert_from_pytorch/api_difference/Tensor/torch.Tensor.reshape.md

+
+# paddle
+x = paddle.randn([2, 3, 5])
+y = x.tile((6,5))


这个写错了

这个应该是x.reshape

zhwesky2010 · 2023-05-16T09:16:44Z

docs/guides/model_convert/convert_from_pytorch/api_difference/Tensor/torch.Tensor.reshape.md

+### 参数映射
+| PyTorch       | PaddlePaddle | 备注                                                   |
+| ------------- | ------------ | ------------------------------------------------------ |
+| *shape | shape | torch 的 *shape 既可以接收 list 也可接收可变参数。需要转写。|


paddle的支持哪些也写下

torch 的 *shape 既可以是可变参数，也可以是 list/tuple

Skylark-hjyp · 2023-05-31T12:05:53Z

@zhangtailai 同学你好，有时间的话可以按照意见再修改一下，这样就能尽快合并了~

No.79

e248500

paddle-bot bot added contributor status: proposed labels May 5, 2023

luotao1 assigned zhwesky2010 and Skylark-hjyp May 5, 2023

Skylark-hjyp mentioned this pull request May 5, 2023

PyTorch 1.13 与 Paddle 2.4 API 映射文档开源任务 #5691

Closed

zhangtailai added 2 commits May 5, 2023 15:07

fix some errors

53d9301

fix some errors

e931707

Skylark-hjyp reviewed May 6, 2023

View reviewed changes

修改文档格式

101ab04

Skylark-hjyp reviewed May 8, 2023

View reviewed changes

修改文档格式

f3fb432

Skylark-hjyp reviewed May 10, 2023

View reviewed changes

修改文档格式

b446a54

修改文档格式

628ee63

Skylark-hjyp reviewed May 11, 2023

View reviewed changes

修改文档格式

ed00a1d

zhangtailai added 2 commits May 11, 2023 12:31

修改文档格式

a5e9de6

Merge branch 'develop' into No.79

e03139a

Skylark-hjyp approved these changes May 13, 2023

View reviewed changes

zhwesky2010 reviewed May 16, 2023

View reviewed changes

luotao1 added the HappyOpenSource 快乐开源活动issue与PR label May 17, 2023

luotao1 self-assigned this Jun 26, 2023

zhwesky2010 mentioned this pull request Jun 27, 2023

映射文档 add some api #5982

Merged

zhwesky2010 closed this Jun 27, 2023

		@@ -0,0 +1,31 @@
		## [参数不一致]torch.Tensor.transpose

		### [torch.Tensor.transpose](https://pytorch.org/docs/1.13/generated/torch.Tensor.swapdims.html)

映射文档No.79 #5853

映射文档No.79 #5853

Conversation

zhangtailai commented May 5, 2023 • edited Loading

paddle-bot bot commented May 5, 2023

CLAassistant commented May 5, 2023 • edited Loading

zhangtailai commented May 5, 2023

Skylark-hjyp left a comment

Choose a reason for hiding this comment

zhangtailai commented May 6, 2023

Skylark-hjyp left a comment • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

zhangtailai commented May 8, 2023

Skylark-hjyp left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

zhangtailai commented May 10, 2023

Skylark-hjyp left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

zhangtailai commented May 11, 2023

Skylark-hjyp left a comment

Choose a reason for hiding this comment

zhwesky2010 May 16, 2023 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Skylark-hjyp commented May 31, 2023

zhangtailai commented May 5, 2023 •

edited

Loading

CLAassistant commented May 5, 2023 •

edited

Loading

Skylark-hjyp left a comment •

edited

Loading

zhwesky2010 May 16, 2023 •

edited

Loading