映射文档更新 (#7301)

* add some docs

* update api_mappinp

* update docs

* fix docs

* fix torch.linalg.vecdot

Author: Xuxuanang

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

@@ -1,21 +1,15 @@
-## [ 组合替代实现 ] torch.Tensor.mT
+## [ 无参数 ] torch.Tensor.mT
 
 ### [torch.Tensor.mT](https://pytorch.org/docs/stable/tensors.html?#torch.Tensor.mT)
 
 ```python
 torch.Tensor.mT
 ```
 
-Paddle 无此 API，需要组合实现。
-PyTorch 中等于 x.transpose(-2, -1)，Paddle 中 transpose 参数 perm 为转换后的维度位置。
-
-### 转写示例
+### [paddle.Tensor.mT](https://github.com/PaddlePaddle/Paddle/blob/develop/python/paddle/base/dygraph/math_op_patch.py#L208)
 
 ```python
-# 假设 x 为 4D
-# PyTorch 写法
-y = x.mT
-
-# Paddle 写法
-y = x.transpose(x, perm=[0, 1, 3, 2])
+paddle.Tensor.mT
 ```
+
+两者功能一致，无参数。

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

@@ -6,10 +6,10 @@
 torch.Tensor.stft(n_fft, hop_length=None, win_length=None, window=None, center=True, pad_mode='reflect', normalized=False, onesided=None, return_complex=None)
 ```
 
-### [paddle.signal.stft](https://www.paddlepaddle.org.cn/documentation/docs/zh/develop/api/paddle/signal/stft_cn.html)
+### [paddle.Tensor.stft](https://www.paddlepaddle.org.cn/documentation/docs/zh/develop/api/paddle/signal/stft_cn.html)
 
 ```python
-paddle.signal.stft(x, n_fft, hop_length=None, win_length=None, window=None, center=True, pad_mode='reflect', normalized=False, onesided=True, name=None)
+paddle.Tensor.stft(n_fft, hop_length=None, win_length=None, window=None, center=True, pad_mode='reflect', normalized=False, onesided=True, name=None)
 ```
 
 PyTorch 相比 Paddle 支持更多其他参数，具体如下：
@@ -35,5 +35,5 @@ PyTorch 相比 Paddle 支持更多其他参数，具体如下：
 y = torch.rand(512,512).stft(n_fft=512, return_complex=False)
 
 # Paddle 写法
-y = paddle.as_real(paddle.signal.stft(paddle.rand((512,512)), n_fft=512))
+y = paddle.as_real(paddle.rand((512,512)).stft(n_fft=512))
 ```

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

@@ -6,10 +6,10 @@
 torch.linalg.svdvals(A, *, driver=None, out=None)
 ```
 
-### [paddle.linalg.svd](https://www.paddlepaddle.org.cn/documentation/docs/zh/develop/api/paddle/linalg/svd_cn.html)
+### [paddle.linalg.svdvals](https://github.com/PaddlePaddle/Paddle/blob/develop/python/paddle/tensor/linalg.py#L3019)
 
 ```python
-paddle.linalg.svd(x, full_matrices=False, name=None)
+paddle.linalg.svdvals(x, name=None)
 ```
 
 其中 PyTorch 相比 Paddle 支持更多其他参数，具体如下：
@@ -20,28 +20,16 @@ paddle.linalg.svd(x, full_matrices=False, name=None)
 | ------- | ------------- | ------------------------------------------------------------------------------------ |
 | A       | x             | 输入 Tensor，仅参数名不一致。                                                        |
 | driver  | -             | cuSOLVER 方法名，Paddle 无此参数，一般对网络训练结果影响不大，可直接删除。           |
-| -       | full_matrices | 是否计算完整的 U 和 V 矩阵，Paddle 为 False，PyTorch 无此参数，Paddle 使用默认即可。 |
 | out     | -             | 表示输出的 Tensor，Paddle 无此参数，需要转写。                                       |
-| 返回值  | 返回值        | PyTorch 返回值为 S，Paddle 返回 U、S、VH，需要转写。                                 |
 
 ### 转写示例
 
 #### out 参数：输出的 Tensor
 
 ```python
 # PyTorch 写法:
-torch.linalg.svdvals(x, out=y)
+torch.linalg.svdvals(A=x, out=y)
 
 # Paddle 写法:
-paddle.assign(paddle.linalg.svd(x)[1], y)
-```
-
-#### 返回值
-
-```python
-# PyTorch 写法:
-y = torch.linalg.svdvals(x)
-
-# Paddle 写法:
-y = paddle.linalg.svd(x)[1]
+paddle.assign(paddle.linalg.svdvals(x=x), output=y)
 ```

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

@@ -0,0 +1,36 @@
+## [torch 参数更多]torch.linalg.vecdot
+
+### [torch.linalg.vecdot](https://pytorch.org/docs/stable/generated/torch.linalg.vecdot.html)
+
+```python
+torch.linalg.vecdot(x, y, *, dim=-1, out=None)
+```
+
+### [paddle.linalg.vecdot](https://github.com/PaddlePaddle/Paddle/blob/develop/python/paddle/tensor/linalg.py#L1881)
+
+```python
+paddle.linalg.vecdot(x, y, axis=-1, name=None)
+```
+
+其中 PyTorch 相比 Paddle 支持更多其他参数，具体如下：
+
+### 参数映射
+
+| PyTorch | PaddlePaddle | 备注                                                                            |
+| ------- | ------------ | ------------------------------------------------------------------------------- |
+| x       | x            | 输入 Tensor。                                                                   |
+| y     | y            | 输入 Tensor。 |
+| dim     | axis         | 计算向量点积的维度 ，仅参数名不一致。                                             |
+| out     | -            | 表示输出的 Tensor ， Paddle 无此参数，需要转写。                                |
+
+### 转写示例
+
+#### out：指定输出
+
+```python
+# PyTorch 写法
+torch.linalg.vecdot(x=a, y=b, out=out)
+
+# Paddle 写法
+paddle.assign(paddle.linalg.vecdot(x=a, y=b), output=out)
+```

docs/guides/model_convert/convert_from_pytorch/api_difference/torch/torch.e.md

@@ -0,0 +1,15 @@
+## [ 无参数 ]torch.e
+
+### [torch.e](https://github.com/pytorch/pytorch/blob/main/torch/__init__.py#L1815)
+
+```python
+torch.e
+```
+
+### [paddle.e](https://github.com/PaddlePaddle/Paddle/blob/develop/python/paddle/__init__.py#L787)
+
+```python
+paddle.e
+```
+
+功能一致，无参数。

docs/guides/model_convert/convert_from_pytorch/api_difference/torch/torch.inf.md

@@ -0,0 +1,15 @@
+## [ 无参数 ]torch.inf
+
+### [torch.inf](https://github.com/pytorch/pytorch/blob/main/torch/__init__.py#L1815)
+
+```python
+torch.inf
+```
+
+### [paddle.inf](https://github.com/PaddlePaddle/Paddle/blob/develop/python/paddle/__init__.py#L784)
+
+```python
+paddle.inf
+```
+
+功能一致，无参数。

docs/guides/model_convert/convert_from_pytorch/api_difference/torch/torch.nan.md

@@ -0,0 +1,15 @@
+## [ 无参数 ]torch.nan
+
+### [torch.nan](https://github.com/pytorch/pytorch/blob/main/torch/__init__.py#L1815)
+
+```python
+torch.nan
+```
+
+### [paddle.nan](https://github.com/PaddlePaddle/Paddle/blob/develop/python/paddle/__init__.py#L785)
+
+```python
+paddle.nan
+```
+
+功能一致，无参数。

docs/guides/model_convert/convert_from_pytorch/api_difference/torch/torch.newaxis.md

@@ -0,0 +1,16 @@
+## [ 无参数 ]torch.newaxis
+
+### [torch.newaxis](https://github.com/pytorch/pytorch/blob/main/torch/__init__.py#L1814)
+
+```python
+torch.newaxis
+
+```
+
+### [paddle.newaxis](https://github.com/PaddlePaddle/Paddle/blob/develop/python/paddle/__init__.py#L783)
+
+```python
+paddle.newaxis
+```
+
+功能一致，无参数。

docs/guides/model_convert/convert_from_pytorch/api_difference/torch/torch.pi.md

@@ -6,10 +6,10 @@
 torch.pi
 ```
 
-### [numpy.pi](https://github.com/numpy/numpy)
+### [paddle.pi](https://github.com/PaddlePaddle/Paddle/blob/develop/python/paddle/__init__.py#L786)
 
 ```python
-numpy.pi
+paddle.pi
 ```
 
 功能一致，无参数。

docs/guides/model_convert/convert_from_pytorch/pytorch_api_mapping_cn.md

@@ -372,6 +372,7 @@
 | ALIAS-REFERENCE-ITEM(`torch.igammac`, `torch.special.gammaincc`) |
 | ALIAS-REFERENCE-ITEM(`torch.distributions.multivariate_normal.MultivariateNormal`, `torch.distributions.MultivariateNormal`) |
 | ALIAS-REFERENCE-ITEM(`torch.concatenate`, `torch.cat`) |
+| ALIAS-REFERENCE-ITEM(`torch.concat`, `torch.cat`) |
 
  ## <span id="id25">功能缺失的 API 列表</span>
 
@@ -550,7 +551,6 @@
 | NOT-IMPLEMENTED-ITEM(`torch.optim.lr_scheduler.ChainedScheduler`, https://pytorch.org/docs/stable/generated/torch.optim.lr_scheduler.ChainedScheduler.html#torch.optim.lr_scheduler.ChainedScheduler, 可新增，且框架底层有相关设计，成本低) |
 | NOT-IMPLEMENTED-ITEM(`torch.futures.collect_all`, https://pytorch.org/docs/stable/futures.html#torch.futures.collect_all, 可新增，但框架底层无相关设计，成本高) |
 | NOT-IMPLEMENTED-ITEM(`torch.sparse_compressed_tensor`, https://pytorch.org/docs/stable/generated/torch.sparse_compressed_tensor.html#torch-sparse-compressed-tensor, 可新增，且框架底层有相关设计，成本低) |
-| NOT-IMPLEMENTED-ITEM(`torch.linalg.vecdot`, https://pytorch.org/docs/stable/generated/torch.linalg.vecdot.html#torch-linalg-vecdot, 可新增，且框架底层有相关设计，成本低) |
 | NOT-IMPLEMENTED-ITEM(`torch.mps.current_allocated_memory`, https://pytorch.org/docs/stable/generated/torch.mps.current_allocated_memory.html#torch-mps-current-allocated-memory, 可新增，但框架底层无相关设计，成本高) |
 | NOT-IMPLEMENTED-ITEM(`torch.profiler.tensorboard_trace_handler`, https://pytorch.org/docs/stable/profiler.html#torch.profiler.tensorboard_trace_handler, 可新增，且框架底层有相关设计，成本低) |
 | NOT-IMPLEMENTED-ITEM(`torch.xpu.is_available`, https://pytorch.org/docs/stable/generated/torch.xpu.is_available.html#torch-xpu-is-available, 有对应相近功能但设计差异大无法映射，一般无需新增) |