From af4ea3afbcaf109d226a7f85024152ac275d78d0 Mon Sep 17 00:00:00 2001 From: wangchaochaohu Date: Sat, 22 Aug 2020 22:54:41 +0800 Subject: [PATCH] fix chinese doc for API (#2409) --- doc/fluid/api/tensor.rst | 1 + doc/fluid/api/tensor/concat.rst | 10 +++++-- doc/fluid/api/tensor/eye.rst | 10 +++++-- doc/fluid/api/tensor/full.rst | 11 +++++--- doc/fluid/api/tensor/index_select.rst | 11 ++++++++ doc/fluid/api/tensor/linspace.rst | 10 +++++-- doc/fluid/api/tensor/ones.rst | 11 ++++++-- doc/fluid/api/tensor/split.rst | 10 +++++-- doc/fluid/api/tensor/zeros.rst | 11 ++++++-- doc/fluid/api_cn/layers_cn/linspace_cn.rst | 16 +++++------ doc/fluid/api_cn/layers_cn/ones_cn.rst | 2 +- doc/fluid/api_cn/layers_cn/zeros_cn.rst | 2 +- doc/fluid/api_cn/paddle_cn.rst | 1 + doc/fluid/api_cn/tensor_cn/concat_cn.rst | 8 +++--- doc/fluid/api_cn/tensor_cn/eye_cn.rst | 8 +++--- doc/fluid/api_cn/tensor_cn/full_cn.rst | 10 +++---- doc/fluid/api_cn/tensor_cn/full_like_cn.rst | 4 +-- .../api_cn/tensor_cn/index_select_cn.rst | 6 ++-- doc/fluid/api_cn/tensor_cn/linspace_cn.rst | 28 ++++++++----------- doc/fluid/api_cn/tensor_cn/ones_cn.rst | 4 +-- doc/fluid/api_cn/tensor_cn/split_cn.rst | 6 ++-- doc/fluid/api_cn/tensor_cn/zeros_cn.rst | 2 +- 22 files changed, 109 insertions(+), 73 deletions(-) create mode 100644 doc/fluid/api/tensor/index_select.rst diff --git a/doc/fluid/api/tensor.rst b/doc/fluid/api/tensor.rst index a4f2b214f..8ac2aa597 100644 --- a/doc/fluid/api/tensor.rst +++ b/doc/fluid/api/tensor.rst @@ -50,6 +50,7 @@ paddle.tensor tensor/has_nan.rst tensor/increment.rst tensor/is_empty.rst + tensor/index_select.rst tensor/isfinite.rst tensor/less_equal.rst tensor/less_than.rst diff --git a/doc/fluid/api/tensor/concat.rst b/doc/fluid/api/tensor/concat.rst index 67c36d744..a87f247c0 100644 --- a/doc/fluid/api/tensor/concat.rst +++ b/doc/fluid/api/tensor/concat.rst @@ -1,7 +1,11 @@ -.. _api_tensor_cn_concat: +.. THIS FILE IS GENERATED BY `gen_doc.{py|sh}` + !DO NOT EDIT THIS FILE MANUALLY! + +.. _api_tensor_concat: concat -------------------------------- -:doc_source: paddle.fluid.layers.concat +-------- +.. autofunction:: paddle.tensor.concat + :noindex: diff --git a/doc/fluid/api/tensor/eye.rst b/doc/fluid/api/tensor/eye.rst index 6a30fcc0e..88f0eb373 100644 --- a/doc/fluid/api/tensor/eye.rst +++ b/doc/fluid/api/tensor/eye.rst @@ -1,7 +1,11 @@ -.. _api_tensor_cn_eye: +.. THIS FILE IS GENERATED BY `gen_doc.{py|sh}` + !DO NOT EDIT THIS FILE MANUALLY! + +.. _api_tensor_eye: eye -------------------------------- -:doc_source: paddle.fluid.layers.eye +-------- +.. autofunction:: paddle.tensor.full + :noindex: diff --git a/doc/fluid/api/tensor/full.rst b/doc/fluid/api/tensor/full.rst index 5bfcfc559..8905deaf3 100644 --- a/doc/fluid/api/tensor/full.rst +++ b/doc/fluid/api/tensor/full.rst @@ -1,7 +1,10 @@ -.. _api_tensor_cn_full: +.. THIS FILE IS GENERATED BY `gen_doc.{py|sh}` + !DO NOT EDIT THIS FILE MANUALLY! -full -------------------------------- -:doc_source: paddle.fluid.layers.fill_constant +.. _api_tensor_full: +full +-------- +.. autofunction:: paddle.tensor.full + :noindex: diff --git a/doc/fluid/api/tensor/index_select.rst b/doc/fluid/api/tensor/index_select.rst new file mode 100644 index 000000000..d95a199d4 --- /dev/null +++ b/doc/fluid/api/tensor/index_select.rst @@ -0,0 +1,11 @@ +.. THIS FILE IS GENERATED BY `gen_doc.{py|sh}` + !DO NOT EDIT THIS FILE MANUALLY! + +.. _api_tensor_index_select: + +index_select +------------- + +.. autofunction:: paddle.tensor.index_select + :noindex: + diff --git a/doc/fluid/api/tensor/linspace.rst b/doc/fluid/api/tensor/linspace.rst index d66cc8669..637c9b780 100644 --- a/doc/fluid/api/tensor/linspace.rst +++ b/doc/fluid/api/tensor/linspace.rst @@ -1,7 +1,11 @@ -.. _api_tensor_cn_linspace: +.. THIS FILE IS GENERATED BY `gen_doc.{py|sh}` + !DO NOT EDIT THIS FILE MANUALLY! + +.. _api_tensor_linspace: linspace -------------------------------- -:doc_source: paddle.fluid.layers.linspace +-------- +.. autofunction:: paddle.tensor.linspace + :noindex: diff --git a/doc/fluid/api/tensor/ones.rst b/doc/fluid/api/tensor/ones.rst index a1ca5e072..047198c18 100644 --- a/doc/fluid/api/tensor/ones.rst +++ b/doc/fluid/api/tensor/ones.rst @@ -1,7 +1,12 @@ -.. _api_tensor_cn_ones: +.. THIS FILE IS GENERATED BY `gen_doc.{py|sh}` + !DO NOT EDIT THIS FILE MANUALLY! + +.. _api_tensor_ones: ones -------------------------------- -:doc_source: paddle.fluid.layers.ones +-------- + +.. autofunction:: paddle.tensor.ones + :noindex: diff --git a/doc/fluid/api/tensor/split.rst b/doc/fluid/api/tensor/split.rst index 07c2e1480..60e6f037a 100644 --- a/doc/fluid/api/tensor/split.rst +++ b/doc/fluid/api/tensor/split.rst @@ -1,7 +1,11 @@ -.. _api_tensor_cn_split: +.. THIS FILE IS GENERATED BY `gen_doc.{py|sh}` + !DO NOT EDIT THIS FILE MANUALLY! + +.. _api_tensor_split: split -------------------------------- -:doc_source: paddle.fluid.layers.split +-------- +.. autofunction:: paddle.tensor.split + :noindex: diff --git a/doc/fluid/api/tensor/zeros.rst b/doc/fluid/api/tensor/zeros.rst index 4da38cd94..616719db2 100644 --- a/doc/fluid/api/tensor/zeros.rst +++ b/doc/fluid/api/tensor/zeros.rst @@ -1,7 +1,12 @@ -.. _api_tensor_cn_zeros: +.. THIS FILE IS GENERATED BY `gen_doc.{py|sh}` + !DO NOT EDIT THIS FILE MANUALLY! + +.. _api_tensor_zeros: zeros -------------------------------- -:doc_source: paddle.fluid.layers.zeros +-------- + +.. autofunction:: paddle.tensor.zeros + :noindex: diff --git a/doc/fluid/api_cn/layers_cn/linspace_cn.rst b/doc/fluid/api_cn/layers_cn/linspace_cn.rst index ca9775016..51cee5f51 100644 --- a/doc/fluid/api_cn/layers_cn/linspace_cn.rst +++ b/doc/fluid/api_cn/layers_cn/linspace_cn.rst @@ -5,25 +5,23 @@ linspace .. py:function:: paddle.fluid.layers.linspace(start, stop, num, dtype=None, name=None) - - - 该OP返回一个Tensor，Tensor的值为在区间start和stop上均匀间隔的num个值，输出Tensor的长度为num。 **注意：该OP不进行梯度计算** 参数： - - **start** (float|Tensor) – ``start`` 是区间开始的变量，可以是一个浮点标量，或是一个shape为[1]的Tensor，该Tensor的数据类型可以是float32或者是float64。 - - **stop** (float|Tensor) – ``end`` 是区间结束的变量，可以是一个浮点标量，或是一个shape为[1]的Tensor，该Tensor的数据类型可以是float32或者是float64。 + - **start** (int|float|Tensor) – ``start`` 是区间开始的变量，可以是一个浮点标量，或是一个shape为[1]的Tensor，该Tensor的数据类型可以是float32，float64，int32 或者int64。 + - **stop** (int|float|Tensor) – ``stop`` 是区间结束的变量，可以是一个浮点标量，或是一个shape为[1]的Tensor，该Tensor的数据类型可以是float32，float64，int32或者int64。 - **num** (int|Tensor) – ``num`` 是给定区间内需要划分的区间数，可以是一个整型标量，或是一个shape为[1]的Tensor，该Tensor的数据类型需为int32。 - - **dtype** (string, 可选) – 输出Tensor的数据类型，可以是float32或者是float64，如果dtype的数据类型为None，输出Tensor数据类型为float32。 + - **dtype** (np.dtype|str, 可选) – 输出Tensor的数据类型，可以是float32，float64， int32或者int64。如果dtype的数据类型为None，输出Tensor数据类型为float32。 - **name** （str， 可选）- 具体用法请参见 :ref:`api_guide_Name` ，一般无需设置，默认值为None。 返回：表示等间隔划分结果的1-D Tensor，该Tensor的shape大小为 :math:`[num]` ，在mum为1的情况下，仅返回包含start元素值的Tensor。 抛出异常： - - ``TypeError`` - 当start或者stop的数据类型不是float32或者float64。 - - ``TypeError`` - 当num的数据类型不是float32或者float64。 - - ``TypeError`` - 当dtype的类型不是float32或者float64。 + - ``TypeError`` - 当 ``start`` 或者 ``stop`` 的数据类型不是float32，float64， int32或者int64。 + - ``TypeError`` - 当 ``dtype`` 的类型不是float32，float64，int32或者int64。 + - ``TypeError`` - ``num`` 的类型必须是int当 ``num`` 不是Tensor的时候。 + - ``TypeError`` - ``num`` 的数据类型必须是int32当 ``num`` 是Tensor的时候。 **代码示例**： diff --git a/doc/fluid/api_cn/layers_cn/ones_cn.rst b/doc/fluid/api_cn/layers_cn/ones_cn.rst index 647b8d8c7..1eb93c5e0 100644 --- a/doc/fluid/api_cn/layers_cn/ones_cn.rst +++ b/doc/fluid/api_cn/layers_cn/ones_cn.rst @@ -9,7 +9,7 @@ ones 参数： - **shape** (tuple|list|Tensor) - 输出Tensor的形状， ``shape`` 的数据类型为int32或者int64。 - - **dtype** (np.dtype|core.VarDesc.VarType|str) - 输出Tensor的数据类型，数据类型必须为bool、 float16、float32、float64、int32或int64。 + - **dtype** (np.dtype|str) - 输出Tensor的数据类型，数据类型必须为bool、 float16、float32、float64、int32或int64。 - **force_cpu** (bool， 可选) – 是否强制将输出Tensor写入CPU内存。如果 ``force_cpu`` 为False，则将输出Tensor写入当前所在运算设备的内存，默认为False。 返回：值全为1的Tensor，数据类型和 ``dtype`` 定义的类型一致。 diff --git a/doc/fluid/api_cn/layers_cn/zeros_cn.rst b/doc/fluid/api_cn/layers_cn/zeros_cn.rst index 7e9973e10..170007734 100644 --- a/doc/fluid/api_cn/layers_cn/zeros_cn.rst +++ b/doc/fluid/api_cn/layers_cn/zeros_cn.rst @@ -9,7 +9,7 @@ zeros 参数： - **shape** (tuple|list|Tensor) - 输出Tensor的形状， ``shape`` 的数据类型为int32或者int64。 - - **dtype** (np.dtype|core.VarDesc.VarType|str) - 输出Tensor的数据类型，数据类型必须为bool、 float16、float32、float64、int32或int64。 + - **dtype** (np.dtype|str) - 输出Tensor的数据类型，数据类型必须为bool、 float16、float32、float64、int32或int64。 - **force_cpu** (bool， 可选) - 是否强制将输出Tensor写入CPU内存。如果 ``force_cpu`` 为False，则将输出Tensor写入当前所在运算设备的内存，默认为False。 返回：值全为0的Tensor，数据类型和 ``dtype`` 定义的类型一致。 diff --git a/doc/fluid/api_cn/paddle_cn.rst b/doc/fluid/api_cn/paddle_cn.rst index 1d347f8f4..4952b3b2d 100644 --- a/doc/fluid/api_cn/paddle_cn.rst +++ b/doc/fluid/api_cn/paddle_cn.rst @@ -65,6 +65,7 @@ paddle paddle_cn/flatten_cn.rst paddle_cn/flip_cn.rst paddle_cn/floor_cn.rst + paddle_cn/full_cn.rst paddle_cn/full_like_cn.rst paddle_cn/gather_cn.rst paddle_cn/gather_nd_cn.rst diff --git a/doc/fluid/api_cn/tensor_cn/concat_cn.rst b/doc/fluid/api_cn/tensor_cn/concat_cn.rst index aa36dd238..b66f67025 100644 --- a/doc/fluid/api_cn/tensor_cn/concat_cn.rst +++ b/doc/fluid/api_cn/tensor_cn/concat_cn.rst @@ -28,16 +28,16 @@ concat import paddle import numpy as np - paddle.enable_imperative() # Now we are in imperative mode + paddle.disable_static() # Now we are in imperative mode in1 = np.array([[1, 2, 3], [4, 5, 6]]) in2 = np.array([[11, 12, 13], [14, 15, 16]]) in3 = np.array([[21, 22], [23, 24]]) - x1 = paddle.imperative.to_variable(in1) - x2 = paddle.imperative.to_variable(in2) - x3 = paddle.imperative.to_variable(in3) + x1 = paddle.to_tensor(in1) + x2 = paddle.to_tensor(in2) + x3 = paddle.to_tensor(in3) zero = paddle.full(shape=[1], dtype='int32', fill_value=0) # When the axis is negative, the real axis is (axis + Rank(x)) # As follow, axis is -1, Rank(x) is 2, the real axis is 1 diff --git a/doc/fluid/api_cn/tensor_cn/eye_cn.rst b/doc/fluid/api_cn/tensor_cn/eye_cn.rst index 87e746f90..c105c4b06 100644 --- a/doc/fluid/api_cn/tensor_cn/eye_cn.rst +++ b/doc/fluid/api_cn/tensor_cn/eye_cn.rst @@ -8,9 +8,9 @@ eye 该OP用来构建二维Tensor(主对角线元素为1，其他元素为0)。 参数： - - **num_rows** (int) - 生成二维Tensor的行数，数据类型为非负int32。 - - **num_columns** (int，可选) - 生成二维Tensor的列数，数据类型为非负int32。若为None，则默认等于num_rows。 - - **dtype** (np.dtype|core.VarDesc.VarType|str， 可选) - 返回Tensor的数据类型，可为float16，float32，float64， int32， int64。若为None, 则默认等于float32。 + - **num_rows** (int) - 生成2-D Tensor的行数，数据类型为非负int32。 + - **num_columns** (int，可选) - 生成2-D Tensor的列数，数据类型为非负int32。若为None，则默认等于num_rows。 + - **dtype** (np.dtype|str， 可选) - 返回Tensor的数据类型，可为float16，float32，float64， int32， int64。若为None, 则默认等于float32。 - **name** （str， 可选）- 具体用法请参见 :ref:`api_guide_Name` ，一般无需设置，默认值为None。 返回： ``shape`` 为 [num_rows, num_columns]的Tensor。 @@ -25,7 +25,7 @@ eye .. code-block:: python import paddle - paddle.enable_imperative() # Now we are in imperative mode + paddle.disable_static() # Now we are in imperative mode data = paddle.eye(3, dtype='int32') # [[1 0 0] # [0 1 0] diff --git a/doc/fluid/api_cn/tensor_cn/full_cn.rst b/doc/fluid/api_cn/tensor_cn/full_cn.rst index 68dc4d658..5c38053f3 100644 --- a/doc/fluid/api_cn/tensor_cn/full_cn.rst +++ b/doc/fluid/api_cn/tensor_cn/full_cn.rst @@ -7,12 +7,12 @@ full -该OP创建形状大小为shape并且数据类型为dtype的Tensor，其中元素值均为 ``fill_value``。 +该OP创建形状大小为 ``shape`` 并且数据类型为 ``dtype`` 的Tensor，其中元素值均为 ``fill_value`` 。 参数： - **shape** (list|tuple|Tensor) – 指定创建Tensor的形状(shape), 数据类型为int32 或者int64。 - **fill_value** (bool|float|int|Tensor) - 用于初始化输出Tensor的常量数据的值。注意：该参数不可超过输出变量数据类型的表示范围。 - - **dtype** （np.dtype|core.VarDesc.VarType|str， 可选）- 输出变量的数据类型。若为None，则输出变量的数据类型和输入变量相同，默认值为None。 + - **dtype** （np.dtype|str， 可选）- 输出变量的数据类型。若为None，则输出变量的数据类型和输入变量相同，默认值为None。 - **name** （str，可选）- 具体用法请参见 :ref:`api_guide_Name` ，一般无需设置，默认值为None。 返回：返回一个存储结果的Tensor，数据类型和dtype相同。 @@ -28,13 +28,13 @@ full import paddle - paddle.enable_imperative() # Now we are in imperative mode + paddle.disable_static() # Now we are in imperative mode data1 = paddle.full(shape=[2,1], fill_value=0, dtype='int64') #[[0] # [0]] # attr shape is a list which contains Tensor. - positive_3 = paddle.fill_constant([1], "int32", 2) + positive_2 = paddle.fill_constant([1], "int32", 2) data3 = paddle.full(shape=[1, positive_2], dtype='float32', fill_value=1.5) # [[1.5 1.5]] @@ -46,6 +46,6 @@ full # attr fill_value is a Tensor. val = paddle.fill_constant([1], "float32", 2.0) - data5 = paddle.full(shape=[2,1], fill_value=val, dtype='float32') i + data5 = paddle.full(shape=[2,1], fill_value=val, dtype='float32') # [[2.0] # [2.0]] diff --git a/doc/fluid/api_cn/tensor_cn/full_like_cn.rst b/doc/fluid/api_cn/tensor_cn/full_like_cn.rst index f0f26348a..577143ace 100644 --- a/doc/fluid/api_cn/tensor_cn/full_like_cn.rst +++ b/doc/fluid/api_cn/tensor_cn/full_like_cn.rst @@ -11,7 +11,7 @@ full_like 参数： - **x** (Tensor) – 输入Tensor, 输出Tensor和x具有相同的形状，x的数据类型可以是bool，float16，float32，float64，int32，int64。 - **fill_value** (bool|float|int) - 用于初始化输出张量的常量数据的值。注意：该参数不可超过输出变量数据类型的表示范围。 - - **dtype** （np.dtype|core.VarDesc.VarType|str， 可选）- 输出变量的数据类型。若参数为None，则输出变量的数据类型和输入变量相同，默认值为None。 + - **dtype** （np.dtype|str， 可选）- 输出变量的数据类型。若参数为None，则输出变量的数据类型和输入变量相同，默认值为None。 - **name** （str，可选）- 具体用法请参见 :ref:`api_guide_Name` ，一般无需设置，默认值为None。 返回：返回一个存储结果的Tensor，数据类型和dtype相同。 @@ -27,7 +27,7 @@ full_like import paddle import numpy as np - paddle.enable_imperative() # Now we are in imperative mode + paddle.disable_static() # Now we are in imperative mode input = paddle.full(shape=[2, 3], fill_value=0.0, dtype='float32', name='input') output = paddle.full_like(input, 2.0) # [[2. 2. 2.] diff --git a/doc/fluid/api_cn/tensor_cn/index_select_cn.rst b/doc/fluid/api_cn/tensor_cn/index_select_cn.rst index dfb235db5..0a964a981 100644 --- a/doc/fluid/api_cn/tensor_cn/index_select_cn.rst +++ b/doc/fluid/api_cn/tensor_cn/index_select_cn.rst @@ -11,7 +11,7 @@ index_select **参数**： - **x** （Tensor）– 输入Tensor。 ``x`` 的数据类型可以是float32，float64，int32，int64。 - - **index** （Tensor）– 包含索引下标的一维Tensor。 + - **index** （Tensor）– 包含索引下标的1-D Tensor。 - **axis** (int, 可选) – 索引轴，若未指定，则默认选取第0维。 - **name** （str，可选）- 具体用法请参见 :ref:`api_guide_Name` ，一般无需设置，默认值为None。 @@ -36,8 +36,8 @@ index_select [9.0, 10.0, 11.0, 12.0]]) data_index = np.array([0, 1, 1]).astype('int32') - x = paddle.to_variable(data) - index = paddle.to_variable(data_index) + x = paddle.to_tensor(data) + index = paddle.to_tensor(data_index) out_z1 = paddle.index_select(x=x, index=index) #[[1. 2. 3. 4.] # [5. 6. 7. 8.] diff --git a/doc/fluid/api_cn/tensor_cn/linspace_cn.rst b/doc/fluid/api_cn/tensor_cn/linspace_cn.rst index 7c228c413..818a8da56 100644 --- a/doc/fluid/api_cn/tensor_cn/linspace_cn.rst +++ b/doc/fluid/api_cn/tensor_cn/linspace_cn.rst @@ -5,36 +5,32 @@ linspace .. py:function:: paddle.linspace(start, stop, num, dtype=None, name=None) -:alias_main: paddle.linspace -:alias: paddle.tensor.linspace, paddle.tensor.creation.linspace - - - 该OP返回一个Tensor，Tensor的值为在区间start和stop上均匀间隔的num个值，输出Tensor的长度为num。 - **注意：该OP不进行梯度计算** 参数： - - **start** (float|Tensor) – ``start`` 是区间开始的变量，可以是一个浮点标量，或是一个shape为[1]的Tensor，该Tensor的数据类型可以是float32或者是float64。 - - **stop** (float|Tensor) – ``end`` 是区间结束的变量，可以是一个浮点标量，或是一个shape为[1]的Tensor，该Tensor的数据类型可以是float32或者是float64。 + - **start** (int|float|Tensor) – ``start`` 是区间开始的变量，可以是一个浮点标量，或是一个shape为[1]的Tensor，该Tensor的数据类型可以是float32，float64，int32 或者int64。 + - **stop** (int|float|Tensor) – ``stop`` 是区间结束的变量，可以是一个浮点标量，或是一个shape为[1]的Tensor，该Tensor的数据类型可以是float32，float64，int32或者int64。 - **num** (int|Tensor) – ``num`` 是给定区间内需要划分的区间数，可以是一个整型标量，或是一个shape为[1]的Tensor，该Tensor的数据类型需为int32。 - - **dtype** (np.dtype|core.VarDesc.VarType|str，可选) – 输出Tensor的数据类型，可以是float32或者是float64。如果dtype为None，默认类型为float32。 - - **name** （str，可选）- 具体用法请参见 :ref:`api_guide_Name` ，一般无需设置，默认值为None。 - -返回：输出结果的数据类型是float32或float64，表示等间隔划分结果的1-D Tensor，该Tensor的shape大小为 :math:`[num]` ，在mum为1的情况下，仅返回包含start元素值的Tensor。 + - **dtype** (np.dtype|str, 可选) – 输出Tensor的数据类型。数据类型可以是float32，float64，int32，int64。如果dtype的数据类型为None，输出Tensor数据类型为float32。 + - **name** （str， 可选）- 具体用法请参见 :ref:`api_guide_Name` ，一般无需设置，默认值为None。 -返回类型：Variable +返回：表示等间隔划分结果的1-D Tensor，该Tensor的shape大小为 :math:`[num]` ，在mum为1的情况下，仅返回包含start元素值的Tensor。 抛出异常： - - ``TypeError`` - 当start或者stop的数据类型不是float32或者float64。 - - ``TypeError`` - 当num的数据类型不是float32或者float64。 - - ``TypeError`` - 当dtype的类型不是float32或者float64。 + - ``TypeError`` - 当 ``start`` 或者 ``stop`` 的数据类型不是float32，float64，int32或者int64。 + - ``TypeError`` - 当 ``dtype`` 的类型不是float32，float64，int32或者int64。 + - ``TypeError`` - ``num`` 的类型必须是int当 ``num`` 不是Tensor的时候。 + - ``TypeError`` - ``num`` 的数据类型必须是int32当 ``num`` 是Tensor的时候。 + **代码示例**： .. code-block:: python import paddle + + paddle.disable_static() data = paddle.linspace(0, 10, 5, dtype='float32') # [0.0, 2.5, 5.0, 7.5, 10.0] data = paddle.linspace(0, 10, 1, dtype='float32') # [0.0] diff --git a/doc/fluid/api_cn/tensor_cn/ones_cn.rst b/doc/fluid/api_cn/tensor_cn/ones_cn.rst index fa13c3412..05e9ded48 100644 --- a/doc/fluid/api_cn/tensor_cn/ones_cn.rst +++ b/doc/fluid/api_cn/tensor_cn/ones_cn.rst @@ -11,7 +11,7 @@ ones 参数： - **shape** (tuple|list|Tensor) - 输出Tensor的形状， ``shape`` 的数据类型为int32或者int64。 - - **dtype** (np.dtype|core.VarDesc.VarType|str， 可选) - 输出Tensor的数据类型，数据类型必须为bool、 float16、float32、float64、int32或int64。如果 ``dtype`` 为None，默认数据类型为float32。 + - **dtype** (np.dtype|str， 可选) - 输出Tensor的数据类型，数据类型必须为bool、 float16、float32、float64、int32或int64。如果 ``dtype`` 为None，默认数据类型为float32。 - **name** （str，可选）- 具体用法请参见 :ref:`api_guide_Name` ，一般无需设置，默认值为None。 返回：值全为1的Tensor，数据类型和 ``dtype`` 定义的类型一致。 @@ -27,7 +27,7 @@ ones import paddle - paddle.enable_imperative() + paddle.disable_static() #default dtype for ones OP data1 = paddle.ones(shape=[3, 2]) diff --git a/doc/fluid/api_cn/tensor_cn/split_cn.rst b/doc/fluid/api_cn/tensor_cn/split_cn.rst index 52f85fccc..9c1293baf 100644 --- a/doc/fluid/api_cn/tensor_cn/split_cn.rst +++ b/doc/fluid/api_cn/tensor_cn/split_cn.rst @@ -17,7 +17,7 @@ split 返回：分割后的Tensor列表。 抛出异常： - - :code:`TypeError`：``x`` 的数据类型不是float16、float32、float64、int32或int64时 。 + - :code:`TypeError`：``x`` 的数据类型不是bool、float16、float32、float64、int32或int64时 。 - :code:`TypeError`：``num_or_sections`` 不是int、list 或 tuple时。 - :code:`TypeError`：``axis`` 不是 int 或 Tensor时。当 ``axis`` 为Tensor，其数据类型不是int32或int64时。 @@ -28,10 +28,10 @@ split import numpy as np import paddle - paddle.enable_imperative() + paddle.disable_static() # x is a Tensor which shape is [3, 9, 5] x_np = np.random.random([3, 9, 5]).astype("int32") - x = paddle.imperative.to_variable(x_np) + x = paddle.to_tensor(x_np) out0, out1, out22 = paddle.split(x, num_or_sections=3, axis=1) # out0.shape [3, 3, 5] diff --git a/doc/fluid/api_cn/tensor_cn/zeros_cn.rst b/doc/fluid/api_cn/tensor_cn/zeros_cn.rst index e84538f78..40e54e0da 100644 --- a/doc/fluid/api_cn/tensor_cn/zeros_cn.rst +++ b/doc/fluid/api_cn/tensor_cn/zeros_cn.rst @@ -25,7 +25,7 @@ zeros .. code-block:: python import paddle - paddle.enable_imperative() # Now we are in imperative mode + paddle.disable_static() # Now we are in imperative mode data = paddle.zeros(shape=[3, 2], dtype='float32') # [[0. 0.] # [0. 0.] -- GitLab