Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 12 additions & 6 deletions docs/api/paddle/Overview_cn.rst
Original file line number Diff line number Diff line change
Expand Up @@ -358,6 +358,8 @@ tensor 创建相关
" :ref:`paddle.Tensor <cn_api_paddle_Tensor__upper>` ", "Paddle 中最为基础的数据结构"
" :ref:`paddle.to_tensor <cn_api_paddle_to_tensor>` ", "通过已知的 data 来创建一个 tensor"
" :ref:`paddle.tensor <cn_api_paddle_tensor>` ", "通过已知的 data 来创建一个 tensor, 与 torch.tensor 参数和功能对齐"
" :ref:`paddle.from_numpy <cn_api_paddle_from_numpy>` ", "通过已知的 ndarray 来创建一个 tensor"
" :ref:`paddle.asarray <cn_api_paddle_asarray>` ", "通过已知的 obj 来创建一个 tensor"
" :ref:`paddle.tolist <cn_api_paddle_tolist>` ", "将 paddle Tensor 转化为 python list"
" :ref:`paddle.zeros <cn_api_paddle_zeros>` ", "创建形状为 shape 、数据类型为 dtype 且值全为 0 的 Tensor"
" :ref:`paddle.zeros_like <cn_api_paddle_zeros_like>` ", "返回一个和 x 具有相同的形状的全零 Tensor,数据类型为 dtype 或者和 x 相同"
Expand Down Expand Up @@ -438,6 +440,7 @@ tensor random 相关
" :ref:`paddle.rand_like <cn_api_paddle_rand_like>` ", "返回一个和 x 具有相同形状的服从均匀分布的、范围在[0, 1)的随机 Tensor,数据类型为 dtype 或者和 x 相同。"
" :ref:`paddle.randperm <cn_api_paddle_randperm>` ", "返回一个数值在 0 到 n-1、随机排列的 1-D Tensor"
" :ref:`paddle.seed <cn_api_paddle_seed>` ", "设置全局默认 generator 的随机种子"
" :ref:`paddle.seed <cn_api_paddle_manual_seed>` ", "设置全局默认 generator 的随机种子"
" :ref:`paddle.uniform <cn_api_paddle_uniform>` ", "返回数值服从范围[min, max)内均匀分布的随机 Tensor"
" :ref:`paddle.standard_normal <cn_api_paddle_standard_normal>` ", "返回符合标准正态分布(均值为 0,标准差为 1 的正态随机分布)的随机 Tensor,形状为 shape,数据类型为 dtype"
" :ref:`paddle.poisson <cn_api_paddle_poisson>` ", "返回服从泊松分布的随机 Tensor,输出 Tensor 的形状和数据类型与输入 x 相同"
Expand Down Expand Up @@ -555,15 +558,18 @@ tensor 元素操作相关(如:转置,reshape 等)
" :ref:`paddle.view_as <cn_api_paddle_view_as>` ", "使用 other 的 shape,返回 x 的一个 view Tensor"
" :ref:`paddle.unfold <cn_api_paddle_unfold>` ", "返回 x 的一个 view Tensor。以滑动窗口式提取 x 的值"
" :ref:`paddle.masked_fill <cn_api_paddle_masked_fill>` ", "根据 mask 信息,将 value 中的值填充到 x 中 mask 对应为 True 的位置。"
" :ref:`paddle.masked_scatter <cn_api_paddle_masked_scatter>` ", "根据 mask 信息,将 value 中的值逐个填充到 x 中 mask 对应为 True 的位置"
" :ref:`paddle.masked_scatter <cn_api_paddle_masked_scatter>` ", "根据 mask 信息,将 value 中的值逐个填充到 x 中 mask 对应为 True 的位置"
" :ref:`paddle.diagonal_scatter <cn_api_paddle_diagonal_scatter>` ", "根据给定的轴 axis 和偏移量 offset,将张量 y 的值填充到张量 x 中"
" :ref:`paddle.index_fill <cn_api_paddle_index_fill>` ", "沿着指定轴 axis 将 index 中指定位置的 x 的值填充为 value"
" :ref:`paddle.column_stack <cn_api_paddle_column_stack>` ", "沿水平轴堆叠输入 x 中的所有张量。"
" :ref:`paddle.row_stack <cn_api_paddle_row_stack>` ", "沿垂直轴堆叠输入 x 中的所有张量。"
" :ref:`paddle.hstack <cn_api_paddle_hstack>` ", "沿水平轴堆叠输入 x 中的所有张量。"
" :ref:`paddle.vstack <cn_api_paddle_vstack>` ", "沿垂直轴堆叠输入 x 中的所有张量。"
" :ref:`paddle.dstack <cn_api_paddle_dstack>` ", "沿深度轴堆叠输入 x 中的所有张量。"
" :ref:`paddle.narrow <cn_api_paddle_narrow>` ", "沿指定维度 dim 对输入 x 进行切片。"
" :ref:`paddle.column_stack <cn_api_paddle_column_stack>` ", "沿水平轴堆叠输入 x 中的所有张量"
" :ref:`paddle.row_stack <cn_api_paddle_row_stack>` ", "沿垂直轴堆叠输入 x 中的所有张量"
" :ref:`paddle.hstack <cn_api_paddle_hstack>` ", "沿水平轴堆叠输入 x 中的所有张量"
" :ref:`paddle.vstack <cn_api_paddle_vstack>` ", "沿垂直轴堆叠输入 x 中的所有张量"
" :ref:`paddle.dstack <cn_api_paddle_dstack>` ", "沿深度轴堆叠输入 x 中的所有张量"
" :ref:`paddle.conv1d <cn_api_paddle_conv1d>` ", "计算一维卷积"
" :ref:`paddle.conv2d <cn_api_paddle_conv2d>` ", "计算二维卷积"
" :ref:`paddle.conv3d <cn_api_paddle_conv3d>` ", "计算三维卷积"

.. _tensor_manipulation_inplace:

Expand Down
67 changes: 56 additions & 11 deletions docs/api/paddle/Tensor__upper_cn.rst
Original file line number Diff line number Diff line change
Expand Up @@ -34,16 +34,16 @@ Tensor
======================================= ===========================================
Data type \[Dtype\]Tensor
======================================= ===========================================
32-bit floating point ``paddle.FloatTensor``
64-bit floating point ``paddle.DoubleTensor``
16-bit floating point ``paddle.HalfTensor``
16-bit floating point ``paddle.BFloat16Tensor``
8-bit integer (unsigned) ``paddle.ByteTensor``
8-bit integer (signed) ``paddle.CharTensor``
16-bit integer (signed) ``paddle.ShortTensor``
32-bit integer (signed) ``paddle.IntTensor``
64-bit integer (signed) ``paddle.LongTensor``
Boolean ``paddle.BoolTensor``
32-bit floating point ``paddle.FloatTensor``
64-bit floating point ``paddle.DoubleTensor``
16-bit floating point ``paddle.HalfTensor``
16-bit floating point ``paddle.BFloat16Tensor``
8-bit integer (unsigned) ``paddle.ByteTensor``
8-bit integer (signed) ``paddle.CharTensor``
16-bit integer (signed) ``paddle.ShortTensor``
32-bit integer (signed) ``paddle.IntTensor``
64-bit integer (signed) ``paddle.LongTensor``
Boolean ``paddle.BoolTensor``
======================================= ===========================================

create_tensor(dtype, name=None, persistable=False)
Expand Down Expand Up @@ -1466,7 +1466,7 @@ exponential_(lam=1.0, name=None)
参数:
- **x** (Tensor) - 输入 Tensor,数据类型为 float32/float64。
- **lam** (float) - 指数分布的 :math:`\lambda` 参数。
别名: ``lambd``
别名: ``lambd``
- **name** (str,可选) - 具体用法请参见 :ref:`api_guide_Name`,一般无需设置,默认值为 None。


Expand Down Expand Up @@ -1718,6 +1718,15 @@ greater_equal(y, name=None)

请参考 :ref:`cn_api_paddle_greater_equal`

ge(y, name=None)
:::::::::

返回:计算后的 Tensor

返回类型:Tensor

请参考 :ref:`cn_api_paddle_ge`

greater_than(y, name=None)
:::::::::

Expand All @@ -1727,6 +1736,15 @@ greater_than(y, name=None)

请参考 :ref:`cn_api_paddle_greater_than`

gt(y, name=None)
:::::::::

返回:计算后的 Tensor

返回类型:Tensor

请参考 :ref:`cn_api_paddle_gt`

heaviside(y, name=None)
:::::::::

Expand Down Expand Up @@ -1943,6 +1961,15 @@ less_equal(y, name=None)

请参考 :ref:`cn_api_paddle_less_equal`

le(y, name=None)
:::::::::

返回:计算后的 Tensor

返回类型:Tensor

请参考 :ref:`cn_api_paddle_le`

less_than(y, name=None)
:::::::::

Expand All @@ -1961,6 +1988,15 @@ less(y, name=None)

请参考 :ref:`cn_api_paddle_less`

le(y, name=None)
:::::::::

返回:计算后的 Tensor

返回类型:Tensor

请参考 :ref:`cn_api_paddle_le`

lgamma(name=None)
:::::::::

Expand Down Expand Up @@ -2292,6 +2328,15 @@ not_equal(y, name=None)

请参考 :ref:`cn_api_paddle_not_equal`

ne(y, name=None)
:::::::::

返回:计算后的 Tensor

返回类型:Tensor

请参考 :ref:`cn_api_paddle_ne`

numel(name=None)
:::::::::

Expand Down
46 changes: 46 additions & 0 deletions docs/api/paddle/asarray_cn.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
.. _cn_api_paddle_asarray:

asarray
-------------------------------


.. py:function:: paddle.asarray(obj, *, dtype=None, device=None, copy=None, requires_grad=False)

通过已知的 ``obj`` 来创建一个 Tensor,Tensor 类型为 ``paddle.Tensor``。
``data`` 可以是 scalar,tuple,list,numpy\.ndarray,paddle\.Tensor。

如果 ``data`` 已经是一个 Tensor,且 ``dtype`` 、 ``device`` 没有发生变化,将不会发生 Tensor 的拷贝并返回原来的 Tensor。
否则会创建一个新的 Tensor,且不保留原来计算图。

.. code-block:: text

我们使用如下规则来进行类型转换:

保持类型
np.number ───────► paddle.Tensor
(0-D Tensor)
paddle 默认类型
Python Number ───────────────► paddle.Tensor
(0-D Tensor)
保持类型
np.ndarray ─────────► paddle.Tensor

参数
:::::::::

- **obj** (scalar|tuple|list|ndarray|Tensor) - 初始化 Tensor 的数据,可以是 scalar,list,tuple,numpy\.ndarray,paddle\.Tensor 类型。
- **dtype** (str|paddle.dtype|np.dtype,可选) - 创建 Tensor 的数据类型,可以是 bool、float16、float32、float64、int8、int16、int32、int64、uint8、complex64、complex128。
默认值为 None,如果 ``data`` 为 python 浮点类型,则从 :ref:`cn_api_paddle_get_default_dtype` 获取类型,如果 ``data`` 为其他类型,则会自动推导类型。
- **device** (CPUPlace|CUDAPinnedPlace|CUDAPlace,可选) - 创建 tensor 的设备位置,可以是 CPUPlace、CUDAPinnedPlace、CUDAPlace。默认值为 None,使用全局的 place。
- **copy** (bool,可选) - 兼容性参数,对于 API 的行为没有影响。
- **requires_grad** (bool,可选) - 是否阻断 Autograd 的梯度传导。默认值为 False,此时不进行梯度传传导。

返回
:::::::::
通过 ``obj`` 创建的 Tensor。


代码示例
:::::::::

COPY-FROM: paddle.asarray
8 changes: 8 additions & 0 deletions docs/api/paddle/conv1d_cn.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
.. _cn_api_paddle_conv1d:

conv1d
-------------------------------

.. py:function:: paddle.conv1d(x, weight, bias=None, stride=1, padding=0, dilation=1, groups=1, data_format="NCL", name=None)

``nn.functional.conv1d`` 的别名,请参考 :ref:`cn_api_paddle_nn_functional_conv1d`。
8 changes: 8 additions & 0 deletions docs/api/paddle/conv2d_cn.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
.. _cn_api_paddle_conv2d:

conv2d
-------------------------------

.. py:function:: paddle.conv2d(x, weight, bias=None, stride=1, padding=0, dilation=1, groups=1, data_format="NCHW", name=None)

``nn.functional.conv2d`` 的别名,请参考 :ref:`cn_api_paddle_nn_functional_conv2d`。
8 changes: 8 additions & 0 deletions docs/api/paddle/conv3d_cn.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
.. _cn_api_paddle_conv3d:

conv3d
-------------------------------

.. py:function:: paddle.conv3d(x, weight, bias=None, stride=1, padding=0, dilation=1, groups=1, data_format="NCDHW", name=None)

``nn.functional.conv3d`` 的别名,请参考 :ref:`cn_api_paddle_nn_functional_conv3d`。
26 changes: 26 additions & 0 deletions docs/api/paddle/from_numpy_cn.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
.. _cn_api_paddle_from_numpy:

from_numpy
-------------------------------


.. py:function:: paddle.from_numpy(ndarray)

从 ``ndarray`` 构造一个 Tensor。

返回的 Tensor 与 ``ndarray`` 共享同一片内存。


参数
:::::::::

- **ndarray** (ndarray) - 待转换的 ``ndarray``。
返回
:::::::::
与 ``ndarray`` 共享同一片内存的 Tensor。


代码示例
:::::::::

COPY-FROM: paddle.from_numpy
8 changes: 8 additions & 0 deletions docs/api/paddle/ge_cn.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
.. _cn_api_paddle_ge:

ge
-------------------------------

.. py:function:: paddle.ge(x, y, name=None, *, out=None)

``greater_equal`` 的别名,请参考 :ref:`cn_api_paddle_greater_equal`。
8 changes: 8 additions & 0 deletions docs/api/paddle/le_cn.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
.. _cn_api_paddle_le:

le
-------------------------------

.. py:function:: paddle.le(x, y, name=None, *, out=None)

``less_equal`` 的别名,请参考 :ref:`cn_api_paddle_less_equal`。
8 changes: 8 additions & 0 deletions docs/api/paddle/lt_cn.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
.. _cn_api_paddle_lt:

lt
-------------------------------

.. py:function:: paddle.lt(x, y, name=None, *, out=None)

``less_than`` 的别名,请参考 :ref:`cn_api_paddle_less_than`。
8 changes: 8 additions & 0 deletions docs/api/paddle/manual_seed_cn.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
.. _cn_api_paddle_manual_seed:

manual_seed
-------------------------------

.. py:function:: paddle.manual_seed(seed)

``seed`` 的别名,请参考 :ref:`cn_api_paddle_seed`。
8 changes: 8 additions & 0 deletions docs/api/paddle/ne_cn.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
.. _cn_api_paddle_ne:

ne
-------------------------------

.. py:function:: paddle.ne(x, y, name=None, *, out=None)

``not_equal`` 的别名,请参考 :ref:`cn_api_paddle_not_equal`。
8 changes: 8 additions & 0 deletions docs/api/paddle/nn/SiLU_cn.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
.. _cn_api_paddle_nn_SiLU:

SiLU
-------------------------------

.. py:class:: paddle.nn.SiLU(name=None)

``nn.Silu`` 的别名,请参考 :ref:`cn_api_paddle_nn_Silu`。