映射文档 No. 26 (PaddlePaddle#5799)

* add the api mapping NO 26 after fixed

* fix some error of mapping api NO 26

* fix some error of mapping api NO 26

* fix some error of mapping api NO 26

* update API mapping NO 26

* update API mapping NO 26 softmax

Author: zeyuxionghust

docs/guides/model_convert/convert_from_pytorch/api_difference/distributions/torch.distributions.kl.register_kl.md

@@ -0,0 +1,20 @@
+## [ 仅参数名不一致 ] torch.distributions.kl.register_kl
+
+### [torch.distributions.kl.register_kl](https://pytorch.org/docs/1.13/distributions.html?highlight=register_kl#torch.distributions.kl.register_kl)
+
+```python
+torch.distributions.kl.register_kl(type_p, type_q)
+```
+
+### [paddle.distribution.register_kl](https://www.paddlepaddle.org.cn/documentation/docs/zh/api/paddle/distribution/register_kl_cn.html)
+
+```python
+paddle.distribution.register_kl(cls_p, cls_q)
+```
+
+两者功能一致且参数用法一致，仅参数名不一致，具体如下：
+### 参数映射
+| PyTorch       | PaddlePaddle | 备注                                                   |
+| ------------- | ------------ | ------------------------------------------------------ |
+| type_p           | cls_p           | 实例 p 的分布类型，继承于 Distribution 基类，仅参数名不一致。               |
+| type_q           | cls_q           | 实例 q 的分布类型，继承于 Distribution 基类，仅参数名不一致。               |

docs/guides/model_convert/convert_from_pytorch/api_difference/fft/torch.fft.fftshift.md

@@ -0,0 +1,20 @@
+## [ 仅参数名不一致 ] torch.fft.fftshift
+
+### [torch.fft.fftshift](https://pytorch.org/docs/1.13/generated/torch.fft.fftshift.html#torch.fft.fftshift)
+
+```python
+torch.fft.fftshift(input, dim=None)
+```
+
+### [paddle.fft.fftshift](https://www.paddlepaddle.org.cn/documentation/docs/zh/api/paddle/fft/fftshift_cn.html)
+
+```python
+paddle.fft.fftshift(x, axes=None, name=None)
+```
+
+两者功能一致且参数用法一致，仅参数名不一致，具体如下：
+### 参数映射
+| PyTorch       | PaddlePaddle | 备注                                                   |
+| ------------- | ------------ | ------------------------------------------------------ |
+| input           | x           | 输入 Tensor，仅参数名不一致。               |
+| dim           | axes           | 进行移动的轴，仅参数名不一致。               |

docs/guides/model_convert/convert_from_pytorch/api_difference/fft/torch.fft.ifftshift.md

@@ -0,0 +1,20 @@
+## [ 仅参数名不一致 ] torch.fft.ifftshift
+
+### [torch.fft.ifftshift](https://pytorch.org/docs/1.13/generated/torch.fft.ifftshift.html#torch.fft.ifftshift)
+
+```python
+torch.fft.ifftshift(input, dim=None)
+```
+
+### [paddle.fft.ifftshift](https://www.paddlepaddle.org.cn/documentation/docs/zh/api/paddle/fft/ifftshift_cn.html)
+
+```python
+paddle.fft.ifftshift(x, axes=None, name=None)
+```
+
+两者功能一致且参数用法一致，仅参数名不一致，具体如下：
+### 参数映射
+| PyTorch       | PaddlePaddle | 备注                                                   |
+| ------------- | ------------ | ------------------------------------------------------ |
+| input           | x           | 输入 Tensor，仅参数名不一致。               |
+| dim           | axes           | 进行移动的轴，仅参数名不一致。               |

docs/guides/model_convert/convert_from_pytorch/api_difference/init/torch.nn.init.calculate_gain.md

@@ -0,0 +1,21 @@
+## [ 参数完全一致 ] torch.nn.init.calculate_gain
+
+### [torch.nn.init.calculate_gain](https://pytorch.org/docs/1.13/nn.init.html?highlight=gain#torch.nn.init.calculate_gain)
+
+```python
+torch.nn.init.calculate_gain(nonlinearity, param=None)
+```
+
+### [paddle.nn.initializer.calculate_gain](https://www.paddlepaddle.org.cn/documentation/docs/zh/api/paddle/nn/initializer/calculate_gain_cn.html)
+
+```python
+paddle.nn.initializer.calculate_gain(nonlinearity, param=None)
+```
+
+两者参数和用法完全一致，具体如下：
+
+### 参数映射
+| PyTorch       | PaddlePaddle | 备注                                                   |
+| ------------- | ------------ | ------------------------------------------------------ |
+| nonlinearity           |  nonlinearity          | 非线性激活函数的名称，两者参数和用法完全一致。               |
+| param           | param           | 某些激活函数的参数，默认为 None，两者参数和用法完全一致。               |

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

@@ -0,0 +1,20 @@
+## [ 仅参数默认值不一致 ] torch.linalg.svd
+
+### [torch.linalg.svd](https://pytorch.org/docs/1.13/generated/torch.linalg.svd.html?highlight=svd#torch.linalg.svd)
+
+```python
+torch.linalg.svd(A, full_matrices=True)
+```
+
+### [paddle.linalg.svd](https://www.paddlepaddle.org.cn/documentation/docs/zh/api/paddle/linalg/svd_cn.html)
+
+```python
+paddle.linalg.svd(x, full_matrics=False, name=None)
+```
+
+两者仅参数默认值不一致，具体如下：
+### 参数映射
+| PyTorch       | PaddlePaddle | 备注                                                   |
+| ------------- | ------------ | ------------------------------------------------------ |
+| A           | x           | 输入 Tensor，仅参数名不一致。               |
+| full_matrices           | full_matrics           | 是否计算完整的 U 和 V 矩阵，Pytorch 为 True，Paddle 为 False。               |

docs/guides/model_convert/convert_from_pytorch/api_difference/others/torch.random.manual_seed.md

@@ -0,0 +1,20 @@
+## [ 参数完全一致 ] torch.random.manual_seed
+
+### [torch.random.manual_seed](https://pytorch.org/docs/1.13/random.html?highlight=torch+random+manual_seed#torch.random.manual_seed)
+
+```python
+torch.random.manual_seed(seed)
+```
+
+### [paddle.seed](https://www.paddlepaddle.org.cn/documentation/docs/zh/api/paddle/seed_cn.html)
+
+```python
+paddle.seed(seed)
+```
+
+两者参数和用法完全一致，具体如下：
+
+### 参数映射
+| PyTorch       | PaddlePaddle | 备注                                                   |
+| ------------- | ------------ | ------------------------------------------------------ |
+| seed           |  seed          | 要设置的的随机种子，两者参数和用法完全一致。               |

docs/guides/model_convert/convert_from_pytorch/api_difference/sparse/torch.sparse.addmm.md

@@ -0,0 +1,25 @@
+## [ 仅参数名不一致 ] torch.sparse.addmm
+
+### [torch.sparse.addmm](https://pytorch.org/docs/1.13/generated/torch.sparse.addmm.html?highlight=addmm#torch.sparse.addmm)
+
+```python
+torch.sparse.addmm(mat, mat1, mat2, beta=1.0, alpha=1.0)
+```
+
+### [paddle.sparse.admm](https://www.paddlepaddle.org.cn/documentation/docs/zh/api/paddle/sparse/addmm_cn.html)
+
+```python
+paddle.sparse.addmm(input, x, y, beta=1.0, alpha=1.0, name=None)
+```
+
+两者功能一致，仅参数名不一致，具体如下：
+
+### 参数映射
+
+|PyTorch |  PaddlePaddle |  备注   |
+|--------|  ------------- | --------------------------------------------------------------------------------------|
+|mat | input|         输入 Tensor，仅参数名不一致。|
+|mat1 |      x   |输入 Tensor，仅参数名不一致。|
+|mat2|y| 输入 Tensor，仅参数名不一致。|
+|beta|beta| input 的系数，默认 1.0。两者完全一致|
+|alpha|alpha|  x * y 的系数，默认 1.0。两者完全一致|

docs/guides/model_convert/convert_from_pytorch/api_difference/sparse/torch.sparse.mm.md

@@ -0,0 +1,22 @@
+## [ 仅参数名不一致 ] torch.sparse.mm
+
+### [torch.sparse.mm](https://pytorch.org/docs/1.13/generated/torch.sparse.mm.html?highlight=torch+sparse+mm#torch.sparse.mm)
+
+```python
+torch.sparse.mm(input, mat2)
+```
+
+### [paddle.sparse.matmul](https://www.paddlepaddle.org.cn/documentation/docs/zh/api/paddle/sparse/matmul_cn.html)
+
+```python
+paddle.sparse.matmul(x, y, name=None)
+```
+
+两者功能一致，仅参数名不一致，具体如下：
+
+### 参数映射
+
+ |PyTorch |  PaddlePaddle |  备注|
+ |--------|  ------------- | ------|
+ |input | x|         输入的 Tensor，仅参数名不一致。|
+ |mat2   |      y   |输入的第二个 Tensor，仅参数名不一致。|

docs/guides/model_convert/convert_from_pytorch/api_difference/sparse/torch.sparse.softmax.md

@@ -0,0 +1,33 @@
+## [ torch 参数更多 ] torch.sparse.softmax
+
+### [torch.sparse.softmax](https://pytorch.org/docs/1.13/generated/torch.sparse.softmax.html#torch.sparse.softmax)
+
+```python
+torch.sparse.softmax(input, dim, dtype=None)
+```
+
+### [paddle.sparse.nn.functional.softmax](https://www.paddlepaddle.org.cn/documentation/docs/zh/api/paddle/sparse/nn/functional/softmax_cn.html)
+
+```python
+paddle.sparse.nn.functional.softmax(x, axis=-1, name=None)
+```
+
+Pytorch 相比 Paddle 支持更多其他参数，具体如下：
+
+### 参数映射
+
+ |PyTorch  | PaddlePaddle |  备注       |
+ |--------|  -------------| --------------------------------------------------------------------------------------|
+ |input  |x       |  输入的稀疏 Tensor，仅参数名不一致。|
+ |dim   |      axis|   指定对输入 SparseTensor 计算 softmax 的轴，Paddle 的默认值：-1。仅参数名不一致。|
+ |dtype | -  | 指定数据类型，可选项，Pytorch 默认值为 None，Paddle 无此参数，需要转写。|
+### 转写示例
+#### dytpe：指定数据类型
+```Python
+# Pytorch 写法
+y = torch.sparse.softmax(x, dim=-1, dtype=torch.float32)
+
+# Paddle 写法
+y = paddle.sparse.cast(x, value_dtype='float32')
+y = paddle.sparse.nn.functional.softmax(y)
+```