diff --git a/docs/api/paddle/Overview_cn.rst b/docs/api/paddle/Overview_cn.rst index 07df7fd02e4..f891ea48b06 100755 --- a/docs/api/paddle/Overview_cn.rst +++ b/docs/api/paddle/Overview_cn.rst @@ -358,6 +358,8 @@ tensor 创建相关 " :ref:`paddle.Tensor ` ", "Paddle 中最为基础的数据结构" " :ref:`paddle.to_tensor ` ", "通过已知的 data 来创建一个 tensor" " :ref:`paddle.tensor ` ", "通过已知的 data 来创建一个 tensor, 与 torch.tensor 参数和功能对齐" + " :ref:`paddle.from_numpy ` ", "通过已知的 ndarray 来创建一个 tensor" + " :ref:`paddle.asarray ` ", "通过已知的 obj 来创建一个 tensor" " :ref:`paddle.tolist ` ", "将 paddle Tensor 转化为 python list" " :ref:`paddle.zeros ` ", "创建形状为 shape 、数据类型为 dtype 且值全为 0 的 Tensor" " :ref:`paddle.zeros_like ` ", "返回一个和 x 具有相同的形状的全零 Tensor，数据类型为 dtype 或者和 x 相同" @@ -438,6 +440,7 @@ tensor random 相关 " :ref:`paddle.rand_like ` ", "返回一个和 x 具有相同形状的服从均匀分布的、范围在[0, 1)的随机 Tensor，数据类型为 dtype 或者和 x 相同。" " :ref:`paddle.randperm ` ", "返回一个数值在 0 到 n-1、随机排列的 1-D Tensor" " :ref:`paddle.seed ` ", "设置全局默认 generator 的随机种子" + " :ref:`paddle.seed ` ", "设置全局默认 generator 的随机种子" " :ref:`paddle.uniform ` ", "返回数值服从范围[min, max)内均匀分布的随机 Tensor" " :ref:`paddle.standard_normal ` ", "返回符合标准正态分布（均值为 0，标准差为 1 的正态随机分布）的随机 Tensor，形状为 shape，数据类型为 dtype" " :ref:`paddle.poisson ` ", "返回服从泊松分布的随机 Tensor，输出 Tensor 的形状和数据类型与输入 x 相同" @@ -555,15 +558,18 @@ tensor 元素操作相关（如：转置，reshape 等） " :ref:`paddle.view_as ` ", "使用 other 的 shape，返回 x 的一个 view Tensor" " :ref:`paddle.unfold ` ", "返回 x 的一个 view Tensor。以滑动窗口式提取 x 的值" " :ref:`paddle.masked_fill ` ", "根据 mask 信息，将 value 中的值填充到 x 中 mask 对应为 True 的位置。" - " :ref:`paddle.masked_scatter ` ", "根据 mask 信息，将 value 中的值逐个填充到 x 中 mask 对应为 True 的位置。" + " :ref:`paddle.masked_scatter ` ", "根据 mask 信息，将 value 中的值逐个填充到 x 中 mask 对应为 True 的位置" " :ref:`paddle.diagonal_scatter ` ", "根据给定的轴 axis 和偏移量 offset，将张量 y 的值填充到张量 x 中" " :ref:`paddle.index_fill ` ", "沿着指定轴 axis 将 index 中指定位置的 x 的值填充为 value" - " :ref:`paddle.column_stack ` ", "沿水平轴堆叠输入 x 中的所有张量。" - " :ref:`paddle.row_stack ` ", "沿垂直轴堆叠输入 x 中的所有张量。" - " :ref:`paddle.hstack ` ", "沿水平轴堆叠输入 x 中的所有张量。" - " :ref:`paddle.vstack ` ", "沿垂直轴堆叠输入 x 中的所有张量。" - " :ref:`paddle.dstack ` ", "沿深度轴堆叠输入 x 中的所有张量。" " :ref:`paddle.narrow ` ", "沿指定维度 dim 对输入 x 进行切片。" + " :ref:`paddle.column_stack ` ", "沿水平轴堆叠输入 x 中的所有张量" + " :ref:`paddle.row_stack ` ", "沿垂直轴堆叠输入 x 中的所有张量" + " :ref:`paddle.hstack ` ", "沿水平轴堆叠输入 x 中的所有张量" + " :ref:`paddle.vstack ` ", "沿垂直轴堆叠输入 x 中的所有张量" + " :ref:`paddle.dstack ` ", "沿深度轴堆叠输入 x 中的所有张量" + " :ref:`paddle.conv1d ` ", "计算一维卷积" + " :ref:`paddle.conv2d ` ", "计算二维卷积" + " :ref:`paddle.conv3d ` ", "计算三维卷积" .. _tensor_manipulation_inplace: diff --git a/docs/api/paddle/Tensor__upper_cn.rst b/docs/api/paddle/Tensor__upper_cn.rst index f0cd2e95cdc..1df9ea93182 100755 --- a/docs/api/paddle/Tensor__upper_cn.rst +++ b/docs/api/paddle/Tensor__upper_cn.rst @@ -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) @@ -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。 @@ -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) ::::::::: @@ -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) ::::::::: @@ -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) ::::::::: @@ -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) ::::::::: @@ -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) ::::::::: diff --git a/docs/api/paddle/asarray_cn.rst b/docs/api/paddle/asarray_cn.rst new file mode 100644 index 00000000000..d2373ef392c --- /dev/null +++ b/docs/api/paddle/asarray_cn.rst @@ -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 diff --git a/docs/api/paddle/conv1d_cn.rst b/docs/api/paddle/conv1d_cn.rst new file mode 100644 index 00000000000..ab92338e1c1 --- /dev/null +++ b/docs/api/paddle/conv1d_cn.rst @@ -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`。 diff --git a/docs/api/paddle/conv2d_cn.rst b/docs/api/paddle/conv2d_cn.rst new file mode 100644 index 00000000000..d3639da8e24 --- /dev/null +++ b/docs/api/paddle/conv2d_cn.rst @@ -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`。 diff --git a/docs/api/paddle/conv3d_cn.rst b/docs/api/paddle/conv3d_cn.rst new file mode 100644 index 00000000000..7e32e3bd032 --- /dev/null +++ b/docs/api/paddle/conv3d_cn.rst @@ -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`。 diff --git a/docs/api/paddle/from_numpy_cn.rst b/docs/api/paddle/from_numpy_cn.rst new file mode 100644 index 00000000000..b670a3aa36b --- /dev/null +++ b/docs/api/paddle/from_numpy_cn.rst @@ -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 diff --git a/docs/api/paddle/ge_cn.rst b/docs/api/paddle/ge_cn.rst new file mode 100644 index 00000000000..388060dfadf --- /dev/null +++ b/docs/api/paddle/ge_cn.rst @@ -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`。 diff --git a/docs/api/paddle/le_cn.rst b/docs/api/paddle/le_cn.rst new file mode 100644 index 00000000000..f840b127f77 --- /dev/null +++ b/docs/api/paddle/le_cn.rst @@ -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`。 diff --git a/docs/api/paddle/lt_cn.rst b/docs/api/paddle/lt_cn.rst new file mode 100644 index 00000000000..84245153d83 --- /dev/null +++ b/docs/api/paddle/lt_cn.rst @@ -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`。 diff --git a/docs/api/paddle/manual_seed_cn.rst b/docs/api/paddle/manual_seed_cn.rst new file mode 100644 index 00000000000..9686ae94220 --- /dev/null +++ b/docs/api/paddle/manual_seed_cn.rst @@ -0,0 +1,8 @@ +.. _cn_api_paddle_manual_seed: + +manual_seed +------------------------------- + +.. py:function:: paddle.manual_seed(seed) + +``seed`` 的别名，请参考 :ref:`cn_api_paddle_seed`。 diff --git a/docs/api/paddle/ne_cn.rst b/docs/api/paddle/ne_cn.rst new file mode 100644 index 00000000000..fdb37f582ca --- /dev/null +++ b/docs/api/paddle/ne_cn.rst @@ -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`。 diff --git a/docs/api/paddle/nn/SiLU_cn.rst b/docs/api/paddle/nn/SiLU_cn.rst new file mode 100644 index 00000000000..662617d4cf5 --- /dev/null +++ b/docs/api/paddle/nn/SiLU_cn.rst @@ -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`。