diff --git a/docs/guides/model_convert/convert_from_pytorch/api_difference/Tensor/torch.Tensor.scatter_.md b/docs/guides/model_convert/convert_from_pytorch/api_difference/Tensor/torch.Tensor.scatter_.md new file mode 100644 index 00000000000..0c9010f8d81 --- /dev/null +++ b/docs/guides/model_convert/convert_from_pytorch/api_difference/Tensor/torch.Tensor.scatter_.md @@ -0,0 +1,29 @@ +## [仅参数名不一致]torch.Tensor.scatter_ + +### [torch.Tensor.scatter_](https://pytorch.org/docs/1.13/generated/torch.Tensor.scatter_.html#torch.Tensor.scatter_) + +```python +torch.Tensor.scatter_(dim, + index, + src, + reduce=None) +``` + +### [paddle.Tensor.put_along_axis_](https://www.paddlepaddle.org.cn/documentation/docs/zh/api/paddle/put_along_axis__cn.html) + +```python +paddle.Tensor.put_along_axis_(indices, + value, + axis, + reduce) +``` + +两者功能一致且参数用法一致,仅参数名不一致,具体如下: + +### 参数差异 +| PyTorch | PaddlePaddle | 备注 | +| ------------- | ------------ | ------------------------------------------------------ | +| dim | axis | 表示在哪一个维度 scatter ,仅参数名不一致。 | +| index | indices | 表示输入的索引张量,仅参数名不一致。 | +| src | values | 表示需要插入的值,仅参数名不一致。 | +| reduce | reduce | 表示对输出 Tensor 的计算方式。 | diff --git a/docs/guides/model_convert/convert_from_pytorch/api_difference/Tensor/torch.Tensor.scatter_add_.md b/docs/guides/model_convert/convert_from_pytorch/api_difference/Tensor/torch.Tensor.scatter_add_.md new file mode 100644 index 00000000000..14521f11e06 --- /dev/null +++ b/docs/guides/model_convert/convert_from_pytorch/api_difference/Tensor/torch.Tensor.scatter_add_.md @@ -0,0 +1,28 @@ +## [仅 paddle 参数更多]torch.Tensor.scatter_add_ + +### [torch.Tensor.scatter_add_](https://pytorch.org/docs/1.13/generated/torch.Tensor.scatter_add_.html#torch.Tensor.scatter_add_) + +```python +torch.Tensor.scatter_add_(dim, + index, + src) +``` + +### [paddle.Tensor.put_along_axis_](https://www.paddlepaddle.org.cn/documentation/docs/zh/api/paddle/put_along_axis__cn.html) + +```python +paddle.Tensor.put_along_axis_(indices, + value, + axis, + reduce) +``` + +其中 Paddle 相比 Pytorch 支持更多其他参数,具体如下: + +### 参数差异 +| PyTorch | PaddlePaddle | 备注 | +| ------------- | ------------ | ------------------------------------------------------ | +| dim | axis | 表示在哪一个维度 scatter ,仅参数名不一致。 | +| index | indices | 表示输入的索引张量,仅参数名不一致。 | +| src | values | 表示需要插入的值,仅参数名不一致。 | +| - | reduce | 表示对输出 Tensor 的计算方式, PyTorch 无此参数, Paddle 应设置为 add 。 | diff --git a/docs/guides/model_convert/convert_from_pytorch/api_difference/ops/torch.bernoulli.md b/docs/guides/model_convert/convert_from_pytorch/api_difference/ops/torch.bernoulli.md index 308dc6ca3da..50a5b05495f 100644 --- a/docs/guides/model_convert/convert_from_pytorch/api_difference/ops/torch.bernoulli.md +++ b/docs/guides/model_convert/convert_from_pytorch/api_difference/ops/torch.bernoulli.md @@ -1,38 +1,38 @@ -## [torch 参数更多 ]torch.bernoulli - -### [torch.bernoulli](https://pytorch.org/docs/stable/generated/torch.bernoulli.html?highlight=bernoulli#torch.bernoulli) - -```python -torch.bernoulli(input, - *, - generator=None, - out=None) -``` - -### [paddle.bernoulli](https://www.paddlepaddle.org.cn/documentation/docs/zh/api/paddle/bernoulli_cn.html#bernoulli) - -```python -paddle.bernoulli(x, - name=None) -``` - -其中 Pytorch 相比 Paddle 支持更多其他参数,具体如下: - -### 参数映射 -| PyTorch | PaddlePaddle | 备注 | -| ------------- | ------------ | ------------------------------------------------------ | -| input| x | 表示输入的 Tensor ,仅参数名不同。 | -| generator | - | 用于采样的伪随机数生成器, Paddle 无此参数,一般对网络训练结果影响不大,可直接删除。 | -| out | - | 表示输出的 Tensor , Paddle 无此参数,需要进行转写。 | - - - -### 转写示例 -#### out:指定输出 -```python -# Pytorch 写法 -torch.bernoulli([3, 5], out=y) - -# Paddle 写法 -paddle.assign(paddle.bernoulli([3, 5]), y) -``` +## [torch 参数更多 ]torch.bernoulli + +### [torch.bernoulli](https://pytorch.org/docs/1.13/generated/torch.bernoulli.html#torch.bernoulli) + +```python +torch.bernoulli(input, + *, + generator=None, + out=None) +``` + +### [paddle.bernoulli](https://www.paddlepaddle.org.cn/documentation/docs/zh/api/paddle/bernoulli_cn.html) + +```python +paddle.bernoulli(x, + name=None) +``` + +其中 Pytorch 相比 Paddle 支持更多其他参数,具体如下: + +### 参数映射 +| PyTorch | PaddlePaddle | 备注 | +| ------------- | ------------ | ------------------------------------------------------ | +| input | x | 表示输入的 Tensor ,仅参数名不同。 | +| generator | - | 用于采样的伪随机数生成器, Paddle 无此参数,一般对网络训练结果影响不大,可直接删除。 | +| out | - | 表示输出的 Tensor , Paddle 无此参数,需要进行转写。 | + + + +### 转写示例 +#### out:指定输出 +```python +# Pytorch 写法 +torch.bernoulli(torch.tensor([3, 5]), out=y) + +# Paddle 写法 +paddle.assign(paddle.bernoulli(paddle.to_tensor([3, 5])), y) +``` diff --git a/docs/guides/model_convert/convert_from_pytorch/api_difference/ops/torch.multinomial.md b/docs/guides/model_convert/convert_from_pytorch/api_difference/ops/torch.multinomial.md index cbd0ee4e874..2493f038ec0 100644 --- a/docs/guides/model_convert/convert_from_pytorch/api_difference/ops/torch.multinomial.md +++ b/docs/guides/model_convert/convert_from_pytorch/api_difference/ops/torch.multinomial.md @@ -1,5 +1,5 @@ ## [torch 参数更多 ]torch.multinomial -### [torch.multinomial](https://pytorch.org/docs/stable/generated/torch.multinomial.html?highlight=multinomial#torch.multinomial) +### [torch.multinomial](https://pytorch.org/docs/1.13/generated/torch.multinomial.html#torch.multinomial) ```python torch.multinomial(input, num_samples, @@ -8,7 +8,7 @@ torch.multinomial(input, generator=None, out=None) ``` -### [paddle.multinomial](https://www.paddlepaddle.org.cn/documentation/docs/zh/api/paddle/multinomial_cn.html#multinomial) +### [paddle.multinomial](https://www.paddlepaddle.org.cn/documentation/docs/zh/api/paddle/multinomial_cn.html) ```python paddle.multinomial(x, num_samples=1, @@ -20,19 +20,20 @@ paddle.multinomial(x, ### 参数映射 | PyTorch | PaddlePaddle | 备注 | | ------------- | ------------ | ------------------------------------------------------ | -| input | x | 表示输入的 Tensor ,仅参数名不一致。 | -| num_samples | num_samples | 表示采样的次数。 | -| replacement | replacement | 表示是否是可放回的采样。 | -| generator | - | 用于采样的伪随机数生成器,PaddlePaddle 无此参数,一般对网络训练结果影响不大,可直接删除。 | -| out | - | 表示输出的 Tensor , Paddle 无此参数,需要进行转写。 | +| input | x | 表示输入的 Tensor ,仅参数名不一致。 | +| num_samples | num_samples | 表示采样的次数。 | +| replacement | replacement | 表示是否是可放回的采样。 | +| generator | - | 用于采样的伪随机数生成器,PaddlePaddle 无此参数,一般对网络训练结果影响不大,可直接删除。 | +| out | - | 表示输出的 Tensor , Paddle 无此参数,需要进行转写。 | ### 转写示例 #### out:指定输出 ```python # Pytorch 写法 -torch.multinomial([0.3, 0.5, 0.2], out=y) +torch.multinomial(torch.tensor([0.3, 0.5, 0.2]), out=y) # Paddle 写法 -paddle.assign(paddle.multinomial([0.3, 0.5, 0.2]), y) +paddle.assign(paddle.multinomial(paddle.to_tensor([0.3, 0.5, 0.2])), y) +``` ``` diff --git a/docs/guides/model_convert/convert_from_pytorch/api_difference/ops/torch.nonzero.md b/docs/guides/model_convert/convert_from_pytorch/api_difference/ops/torch.nonzero.md index f5d991c8994..6888dfe53c1 100644 --- a/docs/guides/model_convert/convert_from_pytorch/api_difference/ops/torch.nonzero.md +++ b/docs/guides/model_convert/convert_from_pytorch/api_difference/ops/torch.nonzero.md @@ -1,35 +1,35 @@ -## [torch 参数更多 ]torch.nonzero -### [torch.nonzero](https://pytorch.org/docs/1.13/generated/torch.nonzero.html?highlight=nonzero#torch.nonzero) - -```python -torch.nonzero(input, - *, - out=None, - as_tuple=False) -``` - -### [paddle.nonzero](https://www.paddlepaddle.org.cn/documentation/docs/zh/api/paddle/nonzero_cn.html#nonzero) - -```python -paddle.nonzero(x, - as_tuple=False) -``` - -其中 Pytorch 相比 Paddle 支持更多其他参数,具体如下: -### 参数映射 -| PyTorch | PaddlePaddle | 备注 | -| ------------- | ------------ | ------------------------------------------------------ | -| input | x | 表示输入的 Tensor ,仅参数名不一致。 | -| out | - | 表示输出的 Tensor , Paddle 无此参数,需要进行转写。 | -| as_tuple | as_tuple | 表示是否以元组格式返回。 | - - -### 转写示例 -#### out:指定输出 -```python -# Pytorch 写法 -torch.nonzero(x, out=y) - -# Paddle 写法 -paddle.assign(paddle.nonzero(x), y) -``` +## [torch 参数更多 ]torch.nonzero +### [torch.nonzero](https://pytorch.org/docs/1.13/generated/torch.nonzero.html#torch.nonzero) + +```python +torch.nonzero(input, + *, + out=None, + as_tuple=False) +``` + +### [paddle.nonzero](https://www.paddlepaddle.org.cn/documentation/docs/zh/api/paddle/nonzero_cn.html) + +```python +paddle.nonzero(x, + as_tuple=False) +``` + +其中 Pytorch 相比 Paddle 支持更多其他参数,具体如下: +### 参数映射 +| PyTorch | PaddlePaddle | 备注 | +| ------------- | ------------ | ------------------------------------------------------ | +| input | x | 表示输入的 Tensor ,仅参数名不一致。 | +| out | - | 表示输出的 Tensor , Paddle 无此参数,需要进行转写。 | +| as_tuple | as_tuple | bool 类型表示输出数据的格式,默认 False 时,输出一个张量,True 时输出一组一维张量。 | + + +### 转写示例 +#### out:指定输出 +```python +# Pytorch 写法 +torch.nonzero(torch.tensor([3, 5]), out=y) + +# Paddle 写法 +paddle.assign(paddle.nonzero(paddle.to_tensor([3, 5])), y) +``` diff --git a/docs/guides/model_convert/convert_from_pytorch/api_difference/ops/torch.normal.md b/docs/guides/model_convert/convert_from_pytorch/api_difference/ops/torch.normal.md index a26bc8da1f0..687fdb21526 100644 --- a/docs/guides/model_convert/convert_from_pytorch/api_difference/ops/torch.normal.md +++ b/docs/guides/model_convert/convert_from_pytorch/api_difference/ops/torch.normal.md @@ -1,38 +1,37 @@ -## [torch 参数更多 ]torch.normal -### [torch.normal](https://pytorch.org/docs/stable/generated/torch.normal.html?highlight=normal#torch.normal) -```python -torch.normal(mean, - std, - size=None, - *, - generator=None, - out=None) -``` -### [paddle.normal](https://www.paddlepaddle.org.cn/documentation/docs/zh/api/paddle/normal_cn.html#normal) -```python -paddle.normal(mean=0.0, - std=1.0, - shape=None, - name=None) -``` - -其中 Pytorch 相比 Paddle 支持更多其他参数,具体如下: -### 参数映射 -| PyTorch | PaddlePaddle | 备注 | -| ------------- | ------------ | ------------------------------------------------------ | -| mean | mean | 表示正态分布的均值。 | -| std | std | 表示正态分布的方差。 | -| size | shape | 表示输出 Tensor 的形状,仅参数名不一致。 | -| generator | - | 用于采样的伪随机数生成器,PaddlePaddle 无此参数,一般对网络训练结果影响不大,可直接删除。 | -| out | - | 表示输出的 Tensor, Paddle 无此参数,需要进行转写。 | - - -### 转写示例 -#### out:指定输出 -```python -# Pytorch 写法 -torch.normal(mean=[0., 0., 0.], std=[1., 2., 3.], out=y) - -# Paddle 写法 -paddle.assign(paddle.normal(mean=[0., 0., 0.], std=[1., 2., 3.]), y) -``` +## [torch 参数更多 ]torch.normal +### [torch.normal](https://pytorch.org/docs/1.13/generated/torch.normal.html#torch.normal) +```python +torch.normal(mean, + std, + *, + generator=None, + out=None) +``` +### [paddle.normal](https://www.paddlepaddle.org.cn/documentation/docs/zh/api/paddle/normal_cn.html) +```python +paddle.normal(mean=0.0, + std=1.0, + shape=None, + name=None) +``` + +其中 Pytorch 相比 Paddle 支持更多其他参数,具体如下: +### 参数映射 +| PyTorch | PaddlePaddle | 备注 | +| ------------- | ------------ | ------------------------------------------------------ | +| mean | mean | 表示正态分布的均值。 | +| std | std | 表示正态分布的方差。 | +| - | shape | 表示输出 Tensor 的形状,Pytorch 无此参数, Paddle 保持默认即可。 | +| generator | - | 用于采样的伪随机数生成器,PaddlePaddle 无此参数,一般对网络训练结果影响不大,可直接删除。 | +| out | - | 表示输出的 Tensor, Paddle 无此参数,需要进行转写。 | + + +### 转写示例 +#### out:指定输出 +```python +# Pytorch 写法 +torch.normal(torch.tensor([0, 0, 0]), torch.tensor([1.0, 2.0, 3.0]), out=y) + +# Paddle 写法 +paddle.assign(paddle.normal(paddle.to_tensor([0, 0, 0]), paddle.to_tensor([1.0, 2.0, 3.0])), y) +``` diff --git a/docs/guides/model_convert/convert_from_pytorch/api_difference/ops/torch.poisson.md b/docs/guides/model_convert/convert_from_pytorch/api_difference/ops/torch.poisson.md new file mode 100644 index 00000000000..a8430605dca --- /dev/null +++ b/docs/guides/model_convert/convert_from_pytorch/api_difference/ops/torch.poisson.md @@ -0,0 +1,18 @@ +## [torch 参数更多 ]torch.poisson +### [torch.poisson](https://pytorch.org/docs/1.13/generated/torch.poisson.html#torch.poisson) +```python +torch.poisson(input, + generator=None) +``` +### [paddle.poisson](https://www.paddlepaddle.org.cn/documentation/docs/zh/api/paddle/poisson_cn.html) +```python +paddle.poisson(x, + name=None) +``` + +其中 Pytorch 相比 Paddle 支持更多其他参数,具体如下: +### 参数映射 +| PyTorch | PaddlePaddle | 备注 | +| ------------- | ------------ | ------------------------------------------------------ | +| input | x | 表示输入的 Tensor ,仅参数名不一致。 | +| generator | - | 用于采样的伪随机数生成器,PaddlePaddle 无此参数,一般对网络训练结果影响不大,可直接删除。 | diff --git a/docs/guides/model_convert/convert_from_pytorch/api_difference/ops/torch.scatter.md b/docs/guides/model_convert/convert_from_pytorch/api_difference/ops/torch.scatter.md index b5653beb525..dc4662b7483 100644 --- a/docs/guides/model_convert/convert_from_pytorch/api_difference/ops/torch.scatter.md +++ b/docs/guides/model_convert/convert_from_pytorch/api_difference/ops/torch.scatter.md @@ -1,6 +1,6 @@ ## [ 仅 paddle 参数更多 ]torch.scatter -### [torch.scatter](https://pytorch.org/docs/stable/generated/torch.scatter.html?highlight=scatter#torch.scatter) +### [torch.scatter](https://pytorch.org/docs/1.13/generated/torch.scatter.html) ```python torch.scatter(input, @@ -19,13 +19,13 @@ paddle.put_along_axis(arr, reduce='assign') ``` -两者功能一致且参数用法一致,仅参数名不同,同时 Paddle 支持更多其他参数,具体如下: +其中 Paddle 相比 Pytorch 支持更多其他参数,具体如下: ### 参数差异 | PyTorch | PaddlePaddle | 备注 | | ------------- | ------------ | ------------------------------------------------------ | -| input | arr | 表示输入 Tensor ,仅参数名不一致。 | -| dim | axis | 表示在哪一个维度 scatter ,仅参数名不一致。 | -| index | indices | 表示输入的索引张量,仅参数名不一致。 | -| src | values | 表示需要插入的值,仅参数名不一致。 | -| - | reduce | 表示对输出 Tensor 的计算方式, PyTorch 无此参数, Paddle 保持默认即可。 | +| input | arr | 表示输入 Tensor ,仅参数名不一致。 | +| dim | axis | 表示在哪一个维度 scatter ,仅参数名不一致。 | +| index | indices | 表示输入的索引张量,仅参数名不一致。 | +| src | values | 表示需要插入的值,仅参数名不一致。 | +| - | reduce | 表示对输出 Tensor 的计算方式 , PyTorch 无此参数, Paddle 保持默认即可。 | diff --git a/docs/guides/model_convert/convert_from_pytorch/api_difference/ops/torch.scatter_add.md b/docs/guides/model_convert/convert_from_pytorch/api_difference/ops/torch.scatter_add.md new file mode 100644 index 00000000000..8a4822df814 --- /dev/null +++ b/docs/guides/model_convert/convert_from_pytorch/api_difference/ops/torch.scatter_add.md @@ -0,0 +1,31 @@ +## [ 仅 paddle 参数更多 ]torch.scatter_add + +### [torch.scatter_add](https://pytorch.org/docs/1.13/generated/torch.scatter_add.html#torch.scatter_add) + +```python +torch.scatter_add(input, + dim, + index, + src) +``` + +### [paddle.put_along_axis](https://www.paddlepaddle.org.cn/documentation/docs/zh/api/paddle/put_along_axis_cn.html) + +```python +paddle.put_along_axis(arr, + indices, + values, + axis, + reduce='assign') +``` + +其中 Paddle 相比 Pytorch 支持更多其他参数,具体如下: + +### 参数差异 +| PyTorch | PaddlePaddle | 备注 | +| ------------- | ------------ | ------------------------------------------------------ | +| input | arr | 表示输入 Tensor ,仅参数名不一致。 | +| dim | axis | 表示在哪一个维度 scatter ,仅参数名不一致。 | +| index | indices | 表示输入的索引张量,仅参数名不一致。 | +| src | values | 表示需要插入的值,仅参数名不一致。 | +| - | reduce | 表示对输出 Tensor 的计算方式, PyTorch 无此参数, Paddle 应设置此参数为 add 。| diff --git a/docs/guides/model_convert/convert_from_pytorch/api_difference/ops/torch.stack.md b/docs/guides/model_convert/convert_from_pytorch/api_difference/ops/torch.stack.md index 20715be86d9..ee49c2e69e7 100644 --- a/docs/guides/model_convert/convert_from_pytorch/api_difference/ops/torch.stack.md +++ b/docs/guides/model_convert/convert_from_pytorch/api_difference/ops/torch.stack.md @@ -1,5 +1,5 @@ ## [torch 参数更多 ]torch.stack -### [torch.stack](https://pytorch.org/docs/1.13/generated/torch.stack.html?highlight=stack#torch.stack) +### [torch.stack](https://pytorch.org/docs/1.13/generated/torch.stack.html#torch.stack) ```python torch.stack(tensors, @@ -8,7 +8,7 @@ torch.stack(tensors, out=None) ``` -### [paddle.stack](https://www.paddlepaddle.org.cn/documentation/docs/zh/api/paddle/stack_cn.html#stack) +### [paddle.stack](https://www.paddlepaddle.org.cn/documentation/docs/zh/api/paddle/stack_cn.html) ```python paddle.stack(x, @@ -20,17 +20,17 @@ paddle.stack(x, ### 参数映射 | PyTorch | PaddlePaddle | 备注 | | ------------- | ------------ | ------------------------------------------------------ | -| tensors | x | 表示输入的 Tensor ,仅参数名不一致。 | -| dim | axis | 表示要堆叠的轴,仅参数名不一致。 | -| out | - | 表示输出的 Tensor , Paddle 无此参数,需要进行转写。 | +| tensors | x | 表示输入的 Tensor ,仅参数名不一致。 | +| dim | axis | 表示要堆叠的轴,仅参数名不一致。 | +| out | - | 表示输出的 Tensor , Paddle 无此参数,需要进行转写。 | ### 转写示例 #### out:指定输出 ```python # Pytorch 写法 -torch.stack([x1, x2, x3], out=y) +torch.stack(torch.tensor([3, 5]), out=y) # Paddle 写法 -paddle.assign(paddle.stack([x1, x2, x3]), y) +paddle.assign(paddle.stack(paddle.to_tensor([3, 5])), y) ```