o
    Ne$                    @   s^  d dl mZ d dlZd dlZd dlZddlmZ ddlmZ ddl	m
Z
 ddlmZmZmZmZmZmZmZmZ ddlmZ dd	l	mZ dd
lmZ ddlmZ ddlmZ ddlmZ ddlmZmZmZm Z  d dl!m"Z" ddlm#Z# d dl$m%Z%m&Z& g dZ'dXddZ(				dYddZ)			dZddZ*dd Z+d[ddZ,d\dd Z-d]d!d"Z.d]d#d$Z/d^d%d&Z0e"d'd(d)e 	 	 	d_d*d+Z1d`d,d-Z2d`d.d/Z3dad1d2Z4dbd3d4Z5dcd5d6Z6d7d8 Z7ddd:d;Z8ddd<d=Z9d>d? Z:d@dA Z;dBdC Z<dDdE Z=d]dFdGZ>dedHdIZ?d]dJdKZ@e"dLdMd)dNdO ZA			P	dfdQdRZBd]dSdTZCe"dLdUd)d[dVdWZDdS )g    )print_functionN   )LayerHelper)	ParamAttr)Initializer)_current_expected_placeconvert_np_dtype_to_dtype__non_static_mode_varbase_creatordevice_guard_in_legacy_dygraphin_dygraph_mode_get_paddle_place)Variable)Constant)VarDesc)core   )templatedoc)utils)check_variable_and_dtype
check_typecheck_dtypeconvert_dtype)
deprecated)check_shape)_C_ops_legacy_C_ops)create_tensorcreate_parametercreate_global_varcasttensor_array_to_tensorconcatsumsassignfill_constant_batch_size_likefill_constantargminargmaxargsortoneszerosreversehas_infhas_nanisfiniterangelinspace
zeros_like	ones_likediageyetriuFc                 C   s4   t | dg dd tdi t }|j|j| |dS )a  
    Create a variable, which will hold a Tensor with data type dtype.

    Args:
        dtype(string|numpy.dtype): the data type of Tensor to be created, the
            data type is bool, float16, float32, float64, int8, int16, int32 and int64.
        name(string, optional): The default value is None.  Normally there is no need for 
            user to set this property.  For more information, please refer to :ref:`api_guide_Name`
        persistable(bool): Set the persistable flag of the create tensor.
            default value is False.

    Returns:
        Variable: The tensor to be created according to dtype.

    Examples:
        .. code-block:: python

          import paddle.fluid as fluid
          tensor = fluid.layers.create_tensor(dtype='float32')
    dtype)boolfloat16float32float64int8int32r>   int64r   )namer8   persistableN)r   )r   r   localsZcreate_variabler@   )r8   r@   rA   helper rD   JD:\Projects\ConvertPro\env\Lib\site-packages\paddle/fluid/layers/tensor.pyr   C   s   r   c              
   C   s   t | dtttjfd | D ]}t |dttjtjtjtj	tj
fd qt|dg dd t |dtdtfd t |dtdtfd td
i t }|du rRt|d	}||| t|||S )a  
	:api_attr: Static Graph

    This function creates a parameter. The parameter is a learnable variable, which can have
    gradient, and can be optimized.

    NOTE: this is a very low-level API. This API is useful when you create
    operator by your self. instead of using layers.

    Parameters:
        shape (list of int): Shape of the parameter
        dtype (str): Data type of the parameter
        name (str, optional): For detailed information, please refer to
           :ref:`api_guide_Name` . Usually name is no need to set and None by default.
        attr (ParamAttr, optional): Attributes of the parameter
        is_bias (bool, optional): This can affect which default initializer is chosen
                       when default_initializer is None. If is_bias,
                       initializer.Constant(0.0) will be used. Otherwise,
                       Xavier() will be used.
        default_initializer (Initializer, optional): Initializer for the parameter

    Returns:
        The created parameter.

    Examples:
        .. code-block:: python

            import paddle
            paddle.enable_static()
            W = paddle.static.create_parameter(shape=[784, 200], dtype='float32')
    shaper   item of shaper8   )	r9   r:   r;   r<   r=   int16r>   r?   uint8attrNdefault_initializer)r@   )r   )r   listtuplenumpyndarrayintrI   r=   rH   r>   r?   r   typer   r   r   rB   r   r   )rF   r8   r@   rJ   Zis_biasrK   itemrC   rD   rD   rE   r   b   s*   %
r   c           	   
   C   s   t | dtttjfd | D ]}t |dttjtjtjtj	tj
fd qt|dg dd tdi t }|j|| ||dd}|j|tt||d	d
 |S )a*  
    This function creates a new tensor variable with value in the global block(block 0).

    Parameters:
        shape (list[int]|tuple[int]): Shape of the variable
        value (float): The value of the variable. The new created
                      variable will be filled with it.
        dtype (str): Data type of the variable
        persistable (bool, optional): If this variable is persistable.
                           Default: False
        force_cpu (bool, optional): Force this variable to be on CPU.
                         Default: False
        name (str, optional): For detailed information, please refer to
           :ref:`api_guide_Name` . Usually name is no need to set and None by default.

    Returns:
        Variable: The created Variable

    Examples:
        .. code-block:: python

            import paddle
            paddle.enable_static()
            var = paddle.static.create_global_var(shape=[2,3], value=1.0, dtype='float32',
                                           persistable=True, force_cpu=True, name='new_var')
    rF   r    rG   r8   
r9   r:   r;   r<   r=   rH   r>   r?   rI   uint16
global_varT)r8   rF   rA   r@   stop_gradient)value	force_cpu)initializerN)rU   )r   rL   rM   rN   rO   rP   rI   r=   rH   r>   r?   r   r   rB   Zcreate_global_variableZset_variable_initializerr   float)	rF   rW   r8   rA   rX   r@   rR   rC   varrD   rD   rE   r       s4    r    c                 C   s   t  rt|tjjst|}t| |S t r.t|tjjs"t|}t	| d| j
d|}|S t| dg dd t|dg dd tdi t }|j|| jd}|jdd	| gid
|gi| j
|j
dd |S )a  

    This OP takes in the Tensor :attr:`x` with :attr:`x.dtype` and casts it
    to the output with :attr:`dtype`. It's meaningless if the output dtype
    equals the input dtype, but it's fine if you do so.

    Args:
        x(Tensor): An input N-D Tensor with data type bool, float16,
            float32, float64, int32, int64, uint8.
        dtype(np.dtype|str): Data type of the output:
            bool, float16, float32, float64, int8, int32, int64, uint8.

    Returns:
        Tensor: A Tensor with the same shape as input's.

    Examples:
        .. code-block:: python

            import paddle

            x = paddle.to_tensor([2, 3, 4], 'float64')
            y = paddle.cast(x, 'uint8')
    in_dtype	out_dtypex)	r9   r:   r;   r<   rH   r>   r?   rI   rT   r!   r8   rS   r8   rV   XOut)r\   r]   rQ   inputsoutputsattrsN)r!   )r   
isinstancer   r   VarTyper   r   r!   r	   r   r8   r   r   r   rB   "create_variable_for_type_inferencerV   	append_op)r^   r8   outrC   rD   rD   rE   r!      s6   r!   c           
      C   s  t  r%t|tr| }|d}t| tsdd | D } t| |}|S t rOt|tr6| }|d}t| tsBdd | D } t }t	| |d| |S t
| dtttfd t| tst| D ]\}}t|dt| d	 g d
d |j| d jkrtdqbn| g} t
|dttfd t|trt|jdddgdd tdi t }|j| d}| d j tjjjkrt| dksJ dt|  |jdd}|jdd| d i|g|gd|ddd |S d| i}i }	t|trd|_ ||	d< |jd|d|gi|	d |S )a  
    This OP concatenates the input along the axis.

    Args:
        input(list|tuple|Tensor): ``input`` can be Tensor, Tensor list or Tensor tuple which is with data type
            bool, float16, float32, float64, int32, int64. All the Tensors in ``input`` must have the same data type. 
        axis(int|Tensor, optional): Specify the axis to operate on the input Tensors.
            It's a scalar with data type int or a Tensor with shape [1] and data type int32 or int64.
            The effective range is [-R, R), where R is Rank(x). When ``axis < 0``, it works the same way
            as ``axis+R``. Default is 0.
        name (str, optional): The default value is None. Normally there is no
            need for user to set this property. For more information, please
            refer to :ref:`api_guide_Name`.

    Returns:
        Tensor: A Tensor with the same data type as ``input``.

    Examples:
        .. code-block:: python

            import paddle.fluid as fluid
            import numpy as np

            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]])
            with fluid.dygraph.guard():
                x1 = fluid.dygraph.to_variable(in1)
                x2 = fluid.dygraph.to_variable(in2)
                x3 = fluid.dygraph.to_variable(in3)
                # When the axis is negative, the real axis is (axis + Rank(x)).
                # As follows, axis is -1, Rank(x) is 2, the real axis is 1
                out1 = fluid.layers.concat(input=[x1, x2, x3], axis=-1)
                out2 = fluid.layers.concat(input=[x1, x2], axis=0)
                print(out1.numpy())
                # [[ 1  2  3 11 12 13 21 22]
                #  [ 4  5  6 14 15 16 23 24]]
                print(out2.numpy())
                # [[ 1  2  3]
                #  [ 4  5  6]
                #  [11 12 13]
                #  [14 15 16]]
    r   c                 S       g | ]}|j d d kr|qS r   rF   count.0trD   rD   rE   
<listcomp>K       zconcat.<locals>.<listcomp>c                 S   rk   rl   rm   ro   rD   rD   rE   rr   T  rs   axisinputr#   input[])r9   r:   r;   r<   r>   r?   z:All the Tensors in the input must have the same data type.r>   r?   zBThe data type of axis must be int32 or int64 when axis is a Tensorr8   r   zuIf the elements of 'input' in concat are Variable(LoDTensorArray), number of the elements must be 1, but received %s.r"   r`   ra   ZOutIndexFrt   	use_stackrb   Tra   N)r#   )!r   rf   r   rN   rR   r   r#   r   r
   r   r   rL   rM   	enumerater   strr8   	TypeErrorrP   r   r   rB   rh   input_dtypedescrQ   r   r   rg   ZLOD_TENSOR_ARRAYlenri   rV   )
ru   rt   r@   rj   idr^   rC   	out_indexrc   re   rD   rD   rE   r#     s   0










r#   c                    s  t  r:t| tsJ dddlm}m} ddlm} |r|n|}||  d}|t	tt
 fdd| }	||	fS t| d	ttfd
 t| tr^t| D ]\}
}t|dt|
 d td
 qLtdi t }|j| d}|jdd}|jd
d| i|g|gd |dd ||fS )a
  
    This function concatenates or stacks all tensors in the input LoDTensorArray
    along the axis mentioned and returns that as the output.

    For Example:

    .. code-block:: text

        Case 1:

            Given:

                input.data = {[[0.6, 0.1, 0.3],
                               [0.5, 0.3, 0.2]],
                              [[1.3],
                               [1.8]],
                              [[2.3, 2.1],
                               [2.5, 2.4]]}

                axis = 1, use_stack = False

            Then:

                output.data = [[0.6, 0.1, 0.3, 1.3, 2.3, 2.1],
                               [0.5, 0.3, 0.2, 1.8, 2.5, 2.4]]

                output_index.data = [3, 1, 2]

        Case 2:

            Given:

                input.data = {[[0.6, 0.1],
                               [0.5, 0.3]],
                              [[0.3, 1.3],
                               [0.2, 1.8]],
                              [[2.3, 2.1],
                               [2.5, 2.4]]}

                axis = 1, use_stack = True

            Then:

                output.data = [[[0.6, 0.1]
                                [0.3, 1.3]
                                [2.3, 2.1],
                               [[0.5, 0.3]
                                [0.2, 1.8]
                                [2.5, 2.4]]]

                output_index.data = [2, 2, 2]

    Args:
        input(Variable): A LodTensorArray variable.
        axis(int): The axis along which the tensors in attr::`input` will be
            concatenated or stacked.
        name(str|None): A name for this layer(optional). If set None, the layer
                       will be named automatically.
        use_stack(bool): Act as concat_op or stack_op. For stack mode, all
            tensors in the tensor array must have the same shape.

    Returns:
        Variable: The concatenated or stacked tensor variable.
        Variable: A 1-D tensor variable with int32 data type. The data in this \
            tensor contains all input including tensors' sizes along the axis.

    Examples:
        .. code-block:: python

            import paddle.fluid as fluid
            import numpy as np
            x0 = fluid.layers.assign(np.random.rand(2, 2).astype("float32"))
            x1 = fluid.layers.assign(np.random.rand(2, 2).astype("float32"))
            i = fluid.layers.fill_constant(shape=[1], dtype="int64", value=0)
            array = fluid.layers.create_array(dtype='float32')
            fluid.layers.array_write(x0, i, array)
            fluid.layers.array_write(x1, i + 1, array)
            output, output_index = fluid.layers.tensor_array_to_tensor(input=array)
    z2The 'input' in tensor_array_to_tensor must be listr   )stackr#   r   )to_variablert   c                    s   t | j  S N)rP   rF   r^   r   rD   rE   <lambda>  s    z(tensor_array_to_tensor.<locals>.<lambda>ru   r"   rv   rw   rx   r>   r`   ry   rz   rb   N)r"   )r	   rf   rL   nnr   r#   Zdygraphr   rN   arraymapr   r   r|   r}   r   rB   rh   r   ri   )ru   rt   r@   r{   r   r#   r   opressizesiZinput_xrC   rj   r   rD   r   rE   r"     sB   P

r"   c                 C   s   t | dtttfd t| tst| tr#| D ]}t|dg dd qn	t| dg dd tdi t }|du rA|j|	 d}n	t|dg dd |j
dd	| id
|iddid |S )a  
    This function computes the sum of multiple input Tensors elementwisely.

    - Case 1, sum of 3 Tensors

    .. code-block:: text

        # Input Tensors
        x0.shape = [2, 3]
        x0.data = [[1., 2., 3.],
                   [4., 5., 6.]]
        x1.shape = [2, 3]
        x1.data = [[10., 20., 30.],
                   [40., 50., 60.]]
        x2.shape = [2, 3]
        x2.data = [[100., 200., 300.],
                   [400., 500., 600.]]

        # Output Tensor
        out.shape = [2, 3]
        out.data = [[111., 222., 333.],
                    [444., 555., 666.]]

    Args:
        input (list): A list of Variables which hold input Tensors with the same
            data type and shape. Optional data types are: float32, float64, int32, int64.
        out (Variable, optional): Output Tensor. It can be any existing Variable.
            The default value is None, then a new Variable will be created and returned.

    Returns:
        Variable: The sum of inputs. The shape and data type is the same with input. \
            If :code:`out` is not None, the returned value is :code:`out` .

    Examples:
        .. code-block:: python

            import paddle.fluid as fluid

            x0 = fluid.layers.fill_constant(shape=[16, 32], dtype='int64', value=1)
            x1 = fluid.layers.fill_constant(shape=[16, 32], dtype='int64', value=2)
            x2 = fluid.layers.fill_constant(shape=[16, 32], dtype='int64', value=3)
            x3 = fluid.layers.fill_constant(shape=[16, 32], dtype='int64', value=0)

            # Sum of multiple Tensors, the result is stored to a new Variable sum0 (sum0=x0+x1+x2, the value is [[6, ..., 6], ..., [6, ..., 6]])
            sum0 = fluid.layers.sums(input=[x0, x1, x2])

            # Sum of multiple Tensors, sum1 and x3 represents the same Variable (x3=x0+x1+x2, the value is [[6, ..., 6], ..., [6, ..., 6]])
            sum1 = fluid.layers.sums(input=[x0, x1, x2], out=x3)
    ru   r$   r:   r;   r<   r>   r?   sumNrx   rj   r;   r<   r>   r?   r`   ra   Z
use_mkldnnFrb   )r   )r   r   rM   rL   rf   r   r   rB   rh   r   ri   )ru   rj   Zinput_sectionrC   rD   rD   rE   r$     s2   2r$   c              
   C   s"  t d!i t }t| dttjtttt	t
fd |durdnd}t| r0t| ts0t| g} nt| ttfr<t| } t| ttjfrt r}t rU|du rUt| }n/t rd|durdt| | n |du rut rpt }ntj }t| | nt| jdg ddd |du r|j| jd}|jdd	| gid
|gid nt| tjrt| jdkrt dd | D rt!dt"| j}|t#j$j%krt&'d t#j$j(}|t#j$j)krd}dd | j*D }n=|t#j$j(krd}dd | j*D }n,|t#j$j+krd}dd | j*D }n|t#j$j,krd}dd | j*D }nt!dt-| | j.dkr)t/dt rH|du r:t0t| j|}t1|t| j||t2  n<t rd|du rUt }t3|dt| jd||| n |du rp|j| jd}|jdd
|gid|dt| j||id  |rt r|4  |S )"a`  

    The OP copies the :attr:`input` to the :attr:`output`.

    Parameters:
        input (Tensor|numpy.ndarray|list|tuple|scalar): A tensor, numpy ndarray, tuple/list of scalar,
            or scalar. Its data type supports float16, float32, float64, int32, int64, and bool.
            Note: the float64 data will be converted to float32 because of current platform protobuf
            data limitation.
        output (Tensor, optional): A tensor. If :attr:`output` is None, a new tensor will
            be created as :attr:`output`. Default: None.

    Returns:
        Tensor: A tensor with the same shape, data type and value as :attr:`input`.

    Examples:
        .. code-block:: python

          import paddle
          import numpy as np
          data = paddle.full(shape=[3, 2], fill_value=2.5, dtype='float64') # [[2.5, 2.5], [2.5, 2.5], [2.5, 2.5]]
          array = np.array([[1, 1],
                            [3, 4],
                            [1, 3]]).astype(np.int64)
          result1 = paddle.zeros(shape=[3, 3], dtype='float32')
          paddle.assign(array, result1) # result1 = [[1, 1], [3 4], [1, 3]]
          result2 = paddle.assign(data)  # result2 = [[2.5, 2.5], [2.5, 2.5], [2.5, 2.5]]
          result3 = paddle.assign(np.array([[2.5, 2.5], [2.5, 2.5], [2.5, 2.5]], dtype='float32')) # result3 = [[2.5, 2.5], [2.5, 2.5], [2.5, 2.5]]
    r%   ru   NTF)r:   rT   r;   r<   r>   r?   rI   r9   z/(When the type of input in assign is Variable.)rx   r`   ra   rQ   rc   rd   r   c                 s   s    | ]}t |tV  qd S r   )rf   r   )rp   r^   rD   rD   rE   	<genexpr>  s    zassign.<locals>.<genexpr>zHRequired type(input) numpy.ndarray, but found `list(Variable)` in input.zzpaddle.assign doesn't support float64 input now due to current platform protobuf data limitation, we convert it to float32Zbool_valuesc                 S      g | ]}t |qS rD   rP   rp   vrD   rD   rE   rr         zassign.<locals>.<listcomp>Zfp32_valuesc                 S   r   rD   )rZ   r   rD   rD   rE   rr     r   Zint32_valuesc                 S   r   rD   r   r   rD   rD   rE   rr     r   Zint64_valuesc                 S   r   rD   r   r   rD   rD   rE   rr     r   zWhen the type of 'input' in assign is numpy.ndarray, the data type of 'input' must be bool, float32, int32 or int64, but received %s.i   zXThe size of input is too big. Please consider saving it to file and 'load_op' to load itrF   r8   assign_value)rQ   rd   re   )r%   )5r   rB   r   r   rN   rO   rL   rM   rZ   rP   r9   Zisscalarrf   r}   r   r   VarBaser	   r   r   r%   Zassign_out_r   eagerTensorr   r   r8   rh   ri   r   rF   anyr~   r   r   rg   ZFP64warningswarnZFP32BOOLflatZINT32INT64r   size
ValueErrorr,   Zassign_value_r   r   Z_bump_inplace_version)ru   outputrC   Z
is_inplacer8   Z
value_namevaluesrD   rD   rE   r%   L  s   


 




r%   c                 C   s  d|i}t |}t|ts.|dv r tt||d< t||d< ntt||d< t||d< t rt }|r:t	 }t| t
tfrV| D ]}t|tsUt
tdd | }  nqCt|tjjsat|}|du rtt| t|||}d|_|S |durt|| t||| d|_|S t rt| } |du rt|d	}t|tr|dv rtt| d
|d< ntt| d
|d< t|dt|d|d|jd|d d|  d|_|S tdi t }	i }
t|trt |j|krt||}||
d< t |  t!|dg dd t"| dtt
tfd |durt#|dt |gd tdi t }	tj$|
|| dd |du r7|	j%|d	}|j|d< |	j&d|
d|gi|dd d|_|S )a	  

    This OP creates a Tensor with specified `shape` and `dtype`, and
    initializes it with a constant specified by `value`.

    The attribute `stop_gradient` of the created Tensor is set to True.

    Args:
        shape(list|tuple|Tensor): Shape of the output Tensor, the data type of ``shape`` is int32 or int64.
            If ``shape`` is a list or tuple, the elements of it should be integers or Tensors with shape [1].
            If ``shape`` is an Tensor, it should be an 1-D Tensor with date type int32 or int64.
        dtype(np.dtype|str): Data type of the output Tensor which can
            be float16, float32, float64, uint8, int16, int32, int64.
        value(bool|float|int|Tensor): The constant value used to initialize 
            the Tensor to be created. If ``value`` is an Tensor, it should be an 1-D Tensor.
        force_cpu(bool, optional): data should be on CPU if it's true, default value is False.
        out(Tensor, optional): Optional output which can be any created 
            Tensor that meets the requirements to store the result of operation.
            if ``out`` is None, a new Tensor will be create to store the result.
        name(str, optional): The default value is None.  Normally there is no need for user to set this
            property.  For more information, please refer to :ref:`api_guide_Name`.

    Returns:
        Tensor: Tensor which is created according to shape and dtype.

    Examples:
        .. code-block:: python

          import paddle.fluid as fluid
          # attr shape is a list which doesn't contain  Tensor.
          data1 = fluid.layers.fill_constant(shape=[2,1], value=0, dtype='int64') # data1=[[0],[0]]
          data2 = fluid.layers.fill_constant(shape=[2,1], value=5, dtype='int64', out=data1)
          # data1=[[5], [5]] data2=[[5], [5]]

          # attr shape is a list which contains Tensor.
          positive_2 = fluid.layers.fill_constant([1], "int32", 2)
          data3 = fluid.layers.fill_constant(shape=[1, positive_2], dtype='float32', value=1.5) # data3=[[1.5, 1.5]]

          # attr shape is a Tensor.
          shape = fluid.layers.fill_constant([2], "int32", 2) # shape=[2,2]
          data4 = fluid.layers.fill_constant(shape=shape, dtype='bool', value=True) # data4=[[True,True],[True,True]]
          
          # attr value is a Tensor.
          val = fluid.layers.fill_constant([1], "float32", 2.0) # val=[2.0]
          data5 = fluid.layers.fill_constant(shape=[2,1], value=val, dtype='float32') #data5=[[2.0],[2.0]]
    rX   )rI   rH   r>   r?   	str_valuerW   c                 S   s   t | tr|  jd S | S )Nr   )rf   r   rN   r   r   rD   rD   rE   r     s   zfill_constant.<locals>.<lambda>NTrx   r   r8   rF   r'   ZValueTensor)
r9   r:   r;   r<   rI   rH   r>   r?   Z	complex64Z
complex128rj   )rc   re   rF   Zop_typera   rQ   rc   rd   re   rV   )r'   )'r   rf   r   r}   rP   rZ   r   r   r   CPUPlacerL   rM   r   r   rg   r   r   fullrV   Zfull_r   r   Zconvert_shape_to_listr
   rN   rR   r   r'   r8   r   rB   r!   r   r   r   r   Zget_shape_tensor_inputsrh   ri   )rF   r8   rW   rX   rj   r@   re   placerR   rC   rc   rD   rD   rE   r'     s   0











r'   z1.8.0z!paddle.fluid.layers.fill_constant)ZsinceZ	update_toc              	   C   s   t  r't|tjjst|}t }|rt }t	| ||||||}d|_
|S tdi t }	|	j|d}||jt||||d}
t|dv rPtt||
d< ntt||
d< |	jdd| id|gi|
d	 d|_
|S )a  
    This OP creates a Tesnor according the shape and dtype, and initializes the
    Tensor with the constants provided in ``value``. When the input is LoDTensor
    and the input_dim_idx is 0, the output_dim_idx dimension is set to the value
    of the batch_size input by the input, the Stop_gradient attribute of the created
    Tensor is False by default.

    Args:
        input(Variable): Tensor which data type is float32, float64, int32 and int64.
        shape(list): The shape of Tensor to be created, Tensor's shape may be changed
            according the input.
        dtype(np.dtype|core.VarDesc.VarType|str): The data type of created Tensor which
            can be float32, float64, int32, int64.
        value(float|int): The constant value used to initialize the Tensor to be created. 
        input_dim_idx(int): When the value is 0 and the input is LoDTensor, the output_dim_idx
            dimension of the created Tensor is set to the batch_size value of input.
            The default value is 0.
        output_dim_idx(int): Used to specify which dimension of Tensor is created to be set
            the value of batch_size of input Tensor. The default value is 0.
        force_cpu(bool): data should be on CPU if it's true, default value is False.

    Returns:
        Variable: Tensor which will be created according to dtype.

    Examples:

        .. code-block:: python

             import paddle.fluid as fluid
             like = fluid.layers.fill_constant(shape=[1,2], value=10, dtype='int64') #like=[[10, 10]]
             data = fluid.layers.fill_constant_batch_size_like(
                    input=like, shape=[1], value=0, dtype='int64') #like=[[10, 10]] data=[0]

    Tr&   rx   )rF   r8   rW   input_dim_idxoutput_dim_idxrX   )r?   r>   r   ZInputra   rb   N)r&   )r   rf   r   r   rg   r   r   r   r   Zfull_batch_size_likerV   r   rB   rh   r8   rZ   r   r}   rP   ri   )ru   rF   r8   rW   r   r   rX   r   rj   rC   re   rD   rD   rE   r&   Z  s<   +r&   c                 C   Z   t | dg dd tdi t }|tjj}|jdd| id|gid|id d	|_|S )a  
	:alias_main: paddle.argmin
	:alias: paddle.argmin,paddle.tensor.argmin,paddle.tensor.search.argmin
	:old_api: paddle.fluid.layers.argmin

    **argmin**

    This OP computes the indices of the min elements of the input tensor's
    element along the provided axis.

    Args:
        x(Variable): An input N-D Tensor with type float32, float64, int16,
            int32, int64, uint8.
        axis(int, optional): Axis to compute indices along. The effective range
            is [-R, R), where R is Rank(x). when axis<0, it works the same way
            as axis+R. Default is 0.

    Returns:
        Variable: A Tensor with data type int64.

    Examples:
        .. code-block:: python

            import paddle.fluid as fluid
            import numpy as np

            in1 = np.array([[[5,8,9,5],
                            [0,0,1,7],
                            [6,9,2,4]],
                            [[5,2,4,2],
                            [4,7,7,9],
                            [1,7,0,6]]])
            with fluid.dygraph.guard():
                x = fluid.dygraph.to_variable(in1)
                out1 = fluid.layers.argmin(x=x, axis=-1)
                out2 = fluid.layers.argmin(x=x, axis=0)
                out3 = fluid.layers.argmin(x=x, axis=1)
                out4 = fluid.layers.argmin(x=x, axis=2)
                print(out1.numpy())
                # [[0 0 2]
                #  [1 0 2]]
                print(out2.numpy())
                # [[0 1 1 1]
                #  [0 0 0 0]
                #  [1 1 1 0]]
                print(out3.numpy())
                # [[1 1 1 2]
                #  [2 0 2 0]]
                print(out4.numpy())
                # [[0 0 2]
                #  [1 0 2]]
    r^   r;   r<   rI   rH   r>   r?   r(   arg_minr`   ra   rt   rb   TN)r   	r   r   rB   rh   r   rg   r   ri   rV   r^   rt   rC   rj   rD   rD   rE   r(     s   5
r(   c                 C   r   )a4  
    **argmax**

    This OP computes the indices of the max elements of the input tensor's
    element along the provided axis.

    Args:
        x(Variable): An input N-D Tensor with type float32, float64, int16,
            int32, int64, uint8.
        axis(int, optional): Axis to compute indices along. The effective range
            is [-R, R), where R is Rank(x). when axis<0, it works the same way
            as axis+R. Default is 0.

    Returns:
        Variable: A Tensor with data type int64.

    Examples:
        .. code-block:: python

            import paddle.fluid as fluid
            import numpy as np

            in1 = np.array([[[5,8,9,5],
                            [0,0,1,7],
                            [6,9,2,4]],
                            [[5,2,4,2],
                            [4,7,7,9],
                            [1,7,0,6]]])
            with fluid.dygraph.guard():
                x = fluid.dygraph.to_variable(in1)
                out1 = fluid.layers.argmax(x=x, axis=-1)
                out2 = fluid.layers.argmax(x=x, axis=0)
                out3 = fluid.layers.argmax(x=x, axis=1)
                out4 = fluid.layers.argmax(x=x, axis=2)
                print(out1.numpy())
                # [[2 3 1]
                #  [0 3 1]]
                print(out2.numpy())
                # [[0 0 0 0]
                #  [1 1 1 1]
                #  [0 0 0 1]]
                print(out3.numpy())
                # [[2 2 0 1]
                #  [0 1 1 1]]
                print(out4.numpy())
                # [[2 3 1]
                #  [0 3 1]]
    r^   r   r)   arg_maxr`   ra   rt   rb   TN)r   r   r   rD   rD   rE   r)     s   1
r)   c                 C   sn   t | dg dd tdi t }|j| jdd}|jtjjdd}|jdd| i||d||d	d
 ||fS )a  
	:alias_main: paddle.argsort
	:alias: paddle.argsort,paddle.tensor.argsort,paddle.tensor.search.argsort
	:old_api: paddle.fluid.layers.argsort

    This OP sorts the input along the given axis, and returns sorted output
    data Varibale and its corresponding index Variable with the same shape as
    :attr:`input`.

    Args:
        input(Variable): An input N-D Tensor with type float32, float64, int16,
            int32, int64, uint8.
        axis(int, optional): Axis to compute indices along. The effective range
            is [-R, R), where R is Rank(x). when axis<0, it works the same way
            as axis+R. Default is 0.
        descending(bool, optional) : Descending is a flag, if set to true,
            algorithm will sort by descending order, else sort by
            ascending order. Default is false.
        name(str, optional): The default value is None. Normally there is no
            need for user to set this property. For more information, please
            refer to :ref:`api_guide_Name`.

    Returns:
        tuple: A tuple of sorted data Variable(with the same shape and data
        type as input) and the sorted indices(with the same shape as input's
        and with data type int64).

    Examples:
        .. code-block:: python

            import paddle.fluid as fluid
            import numpy as np

            in1 = np.array([[[5,8,9,5],
                            [0,0,1,7],
                            [6,9,2,4]],
                            [[5,2,4,2],
                            [4,7,7,9],
                            [1,7,0,6]]]).astype(np.float32)
            with fluid.dygraph.guard():
                x = fluid.dygraph.to_variable(in1)
                out1 = fluid.layers.argsort(input=x, axis=-1)
                out2 = fluid.layers.argsort(input=x, axis=0)
                out3 = fluid.layers.argsort(input=x, axis=1)
                print(out1[0].numpy())
                # [[[5. 5. 8. 9.]
                #   [0. 0. 1. 7.]
                #   [2. 4. 6. 9.]]
                #  [[2. 2. 4. 5.]
                #   [4. 7. 7. 9.]
                #   [0. 1. 6. 7.]]]
                print(out1[1].numpy())
                # [[[0 3 1 2]
                #   [0 1 2 3]
                #   [2 3 0 1]]
                #  [[1 3 2 0]
                #   [0 1 2 3]
                #   [2 0 3 1]]]
                print(out2[0].numpy())
                # [[[5. 2. 4. 2.]
                #   [0. 0. 1. 7.]
                #   [1. 7. 0. 4.]]
                #  [[5. 8. 9. 5.]
                #   [4. 7. 7. 9.]
                #   [6. 9. 2. 6.]]]
                print(out3[0].numpy())
                # [[[0. 0. 1. 4.]
                #   [5. 8. 2. 5.]
                #   [6. 9. 9. 7.]]
                #  [[1. 2. 0. 2.]
                #   [4. 7. 4. 6.]
                #   [5. 7. 7. 9.]]]
    ru   )r;   r<   rH   r>   r?   rI   r*   Tr_   )rV   r`   )ra   ZIndices)rt   
descendingrb   N)r*   )	r   r   rB   rh   r8   r   rg   r   ri   )ru   rt   r   r@   rC   rj   ZidsrD   rD   rE   r*   '  s*   J

r*   c                 C      t dddit S )a  
    The OP creates a tensor of specified :attr:`shape` and :attr:`dtype`, and fills it with 1.
    Its :attr:`stop_gradient` will be set to True to stop gradient computation.

    Parameters:
        shape(tuple|list|Tensor): Shape of output Tensor, the data type of shape is int32 or int64.
        dtype (np.dtype|str): Data type of output Tensor, it supports
            bool, float16, float32, float64, int32 and int64.
        force_cpu (bool, optional): Whether force to store the output Tensor in CPU memory.
            If :attr:`force_cpu` is False, the output Tensor will be stored in running device memory.
            Default: False.

    Returns:
        Tensor: A tensor of data type :attr:`dtype` with shape :attr:`shape` and all elements set to 1.

    Examples:
        .. code-block:: python

          import paddle.fluid as fluid
          data0 = fluid.layers.ones(shape=[2, 4], dtype='float32') # [[1., 1., 1., 1.], [1., 1., 1., 1.]]
          
          # shape is a Tensor
          shape = fluid.layers.fill_constant(shape=[2], dtype='int32', value=2)
          data1 = fluid.layers.ones(shape=shape, dtype='int32') #[[1, 1], [1, 1]]
    rW         ?NrD   r'   rB   )rF   r8   rX   rD   rD   rE   r+     s   r+   c                 C   r   )aG  
    The OP creates a tensor of specified :attr:`shape` and :attr:`dtype`, and fills it with 0.
    Its :attr:`stop_gradient` will be set to True to stop gradient computation.

    Parameters:
        shape(tuple|list|Tensor): Shape of output Tensor, the data type of ``shape`` is int32 or int64.
        dtype (np.dtype|str): Data type of output Tensor, it supports
            bool, float16, float32, float64, int32 and int64.
        force_cpu (bool, optional): Whether force to store the output Tensor in CPU memory.
            If :attr:`force_cpu` is False, the output Tensor will be stored in running device memory.
            Default: False.
        name(str, optional): The default value is None.  Normally there is no need for user to set this
            property.  For more information, please refer to :ref:`api_guide_Name`.

    Returns:
        Tensor: A tensor of data type :attr:`dtype` with shape :attr:`shape` and all elements set to 0.

    Examples:
        .. code-block:: python

          import paddle.fluid as fluid
          data = fluid.layers.zeros(shape=[3, 2], dtype='float32') # [[0., 0.], [0., 0.], [0., 0.]]
          
          # shape is a Tensor
          shape = fluid.layers.fill_constant(shape=[2], dtype='int32', value=2)
          data1 = fluid.layers.zeros(shape=shape, dtype='int32') #[[0, 0], [0, 0]]
    rW   g        NrD   r   )rF   r8   rX   r@   rD   rD   rE   r,     s   r,   c                 C   s   t | ddd t|dttttfd t|tr|g}t r#t	| |S t
d
i t }|j| jd}|jdd| id|gid|id |S )a!
  
	:alias_main: paddle.reverse
	:alias: paddle.reverse,paddle.tensor.reverse,paddle.tensor.manipulation.reverse
	:old_api: paddle.fluid.layers.reverse

    The OP reverses the tensor :attr:`x` along the given :attr:`axis`.

    .. code-block:: text

        Case 1:

            Given a LoDTensor:
                x = [[0, 1, 2], [3, 4, 5], [6, 7, 8]]
                axis = [0, 1]

            Then:
                output = [[8, 7, 6], [5, 4, 3], [2, 1, 0]]

        Case 2:

            Given a LoDTensorArray:
                x = {[[0, 1], [2, 3]],
                     [[4, 5, 6]],
                     [[7],[8], [9]]}
                axis = 0

            Then:
                output = {[[7],[8], [9]],
                          [[4, 5, 6]],
                          [[0, 1], [2, 3]]}

    Parameters:
        x (Variable): A tensor or LoDTensorArray to be reversed, its data type supports bool, float32, float64, int32, int64 and uint8.
                      If input is a LoDTensorArray, returns a new reversed LoDTensorArray without changing the internal order of each inner tensor.
        axis (int|tuple|list): A dimension or a set of dimensions of :attr:`x` to reverse. Must be
            in the range [-rank( :attr:`x` ), rank( :attr:`x` )). If it is a tuple or a list, reversing
            will be apply on each axis in the tuple or list. If input is a LoDTensorArray, the value of axis shall be 0, or a
            list [0] or tuple (0, ) with shape [1].

    Returns:
        Variable: The reversed tensor with the same shape and data type as :attr:`x`.

    Examples:
        .. code-block:: python

          import paddle.fluid as fluid
          import numpy as np
          data = fluid.layers.assign(np.array([[0, 1, 2], [3, 4, 5], [6, 7, 8]], dtype='float32')) # [[0., 1., 2.], [3., 4., 5.], [6., 7., 8.]]
          result1 = fluid.layers.reverse(data, 0) # [[6., 7., 8.], [3., 4., 5.], [0., 1., 2.]]
          result2 = fluid.layers.reverse(data, [0, 1]) # [[8., 7., 6.], [5., 4., 3.], [2., 1., 0.]]

          # example of LoDTensorArray
          data1 = fluid.layers.assign(np.array([[0, 1, 2]], dtype='float32'))
          data2 = fluid.layers.assign(np.array([[3, 4, 5]], dtype='float32'))
          tensor_array = fluid.layers.create_array(dtype='float32')
          i = fluid.layers.fill_constant(shape=[1], dtype='int64', value=0)
          fluid.layers.array_write(data1, i, tensor_array)
          fluid.layers.array_write(data2, i+1, tensor_array)

          reversed_tensor_array = fluid.layers.reverse(tensor_array, 0) # {[[3, 4, 5]], [[0, 1, 2]]}
    r^   )r;   r<   r>   r?   rI   r-   rt   rx   r`   ra   rb   N)r-   )r   r   rP   rM   rL   r   rf   r   r   r-   r   rB   rh   r8   ri   r   rD   rD   rE   r-     s"   >
r-   Tc                 C   0   t di t }|jdd| ii ||dd dS )an  
    Saves a variable as a file.

    Args:
        x(variable): The Tensor/LoDTensor to be saved.
        file_path(str): The file path where the variable will be saved.
        overwrite(bool): Whether or not cover the given file when it has already
            existed. If it's set 'False' and the file is existed, a runtime
            error will be thrown.
    saveru   	file_path	overwriterQ   rc   rd   argsN)r   r   rB   ri   r^   r   r   rC   rD   rD   rE   r     s   
r   c                 C   r   )a  
    Saves a list of variables into a single file.

    Args:
        x(list): A list of Tensor/LoDTensor variables to be saved together in
                 a single file.
        file_path(str): The file path where variables will be saved.
        overwrite(bool): Whether or not cover the given file when it has already
            existed. If it's set 'False' and the file is existed, a runtime
            error will be thrown.

    Returns:
        There is no return value.

    Examples:

        .. code-block:: python

            import paddle.fluid as fluid
            v1 = fluid.layers.data(name="data",
                                   shape=(4, 6),
                                   dtype="float32")
            v2 = fluid.layers.data(name="data",
                                   shape=(6, 8, 4),
                                   dtype="float32")
            normed = fluid.layers.save_combine([v1, v2], file_path="output")
    save_combineru   r   r   N)r   r   r   rD   rD   rE   r   &  s   
r   c                 C   s.   t di t }|jdi d| id|id dS )z
    Loads a list of variable from a single file.

    Args:
        out(list): The list of variables to be read from the disk file.
        file_path(str): The path of the disk file.
    load_combinera   r   )rQ   rc   r   r   N)r   r   )rj   r   rC   rD   rD   rE   r   L  s   
r   c                 C   X   t  rt| S t| dtd td	i t }|j| jd}|j	dd| id|id |S )
a  
    Test if any of x contains an infinity number

    Args:
       x (Tensor): The Tensor to be checked.

    Returns:
       Tensor: The tensor storing the output, only a bool value, indicating that whether there is infinity number in x or not.
    
    Examples:
        .. code-block:: python
          
          import paddle
          data = paddle.randn(shape=[4, 32, 32], dtype="float32")
          res = paddle.fluid.layers.has_inf(data)
          # [False]

    r^   r.   isinfrx   r`   ra   r   N)r   )
r	   r   r   r   r   r   rB   rh   r8   ri   r^   rC   rj   rD   rD   rE   r.   [     
r.   c                 C   r   )
a  
    Test if any of x contains a NAN

    Args:
       x (Tensor): The Tensor to be checked.

    Returns:
       Tensor: The tensor variable storing the output, only a bool value, indicating that whether there is NAN in x or not.
    
    Examples:
        .. code-block:: python
    
          import paddle
          data = paddle.randn(shape=[2,3], dtype="float32")
          res = paddle.fluid.layers.has_nan(data)
          # [False]

    r^   r/   isnanrx   r`   ra   r   N)r   )
r	   r   r   r   r   r   rB   rh   r8   ri   r   rD   rD   rE   r/   x  r   r/   c                 C   sJ   t | dg dd td
i t }|jdd}|jdd| id|id |S )a  

    Test if any of x contains an infinity/NAN number. If all the elements are finite,
    returns true, else false.

    Args:
        x(Tensor): The Tensor to be checked.

    Returns:
        Tensor: The tensor storing the output, contains a bool value.

    Examples:

        .. code-block:: python

            import paddle

            x = paddle.rand(shape=[4, 6], dtype='float32')
            y = paddle.fluid.layers.isfinite(x)
            print(y)

    r^   r   r0   r9   rx   r`   ra   r   N)r0   )r   r   rB   rh   ri   r   rD   rD   rE   r0     s   r0   c                 C   s   d}t | tst |tst |tstt||  | g}t |tjjs(t|}t | tsKt	d t
dg|| dd} W d   n1 sEw   Y  n
| j|krUt| |} t |tsxt	d t
dg||dd}W d   n1 srw   Y  n
|j|krt||}t |tst	d t
dg||dd}W d   n1 sw   Y  n
|j|krt||}t rt| |||t S t rt| ||}d|_|S t|dg dd tdi t }|j||d
}|jd	| ||dd|id d|_|dur|j| |S )aT  
    This OP returns a 1-D Tensor with spaced values within a given interval.

    Values are generated into the half-open interval [``start``, ``end``) with
    the ``step``. (the interval including ``start`` but excluding ``end``).

    If ``dtype`` is float32 or float64, we advise adding a small epsilon to
    ``end`` to avoid floating point rounding errors when comparing against ``end``.

    Parameters:
        start(float|int|Tensor): Start of interval. The interval includes this
            value. If ``start`` is a Tensor, it is a 1-D Tensor with shape [1],
            with data type int32, int64, float32, float64.
        end(float|int|Tensor): End of interval. The interval does not include
            this value. If ``end`` is a Tensor, it is a 1-D Tensor with shape
            [1], with data type int32, int64, float32, float64.
        step(float|int|Tensor): Spacing between values. For any out, it is
            the istance between two adjacent values, out[i+1] - out[i]. If
            ``step`` is a Tensor, it is a 1-D Tensor with shape [1], with data
            type int32, int64, float32, float64.
        dtype(str|np.dtype|core.VarDesc.VarType, optional): The data type of the
            output tensor. Supported data types: int32, int64, float32, float64.
        name(str, optional): The default value is None. Normally there is no
            need for user to set this property. For more information, please
            refer to :ref:`api_guide_Name`.

    Returns: 
        Tensor: A 1-D Tensor with values from the interval [``start``, ``end``)
            taken with common difference ``step`` beginning from ``start``. Its
            data type is set by ``dtype``.

    Raises:
        TypeError: If ``dtype`` is not int32, int64, float32, float64.

    examples:

        .. code-block:: python

            import paddle.fluid as fluid

            out1 = fluid.layers.range(0, 10, 2, 'int32')
            # [0, 2, 4, 6, 8]

            start_var = fluid.layers.fill_constant([1], 'int64', 3)
            out2 = fluid.layers.range(start_var, 7, 1, 'int64')
            # [3, 4, 5, 6]

    Ncpur   T)rX   r8   r   zrange/aranger1   )rF   )StartZEndZStepra   r   )r1   )rf   r   rP   mathceilr   r   rg   r   r   r'   r8   r!   r   r   Zaranger   r   r   r1   rV   r   r   rB   rh   ri   r   	set_shape)startendstepr8   r@   Z	out_shaperj   rC   rD   rD   rE   r1     sh   1











r1   c                 C   s  |du rd}|}| }|}t |tst|dtd t |tjjs#t|}t | tsCtd t	dg|| }W d   n1 s>w   Y  t |tsctd t	dg||}W d   n1 s^w   Y  t |tstd t	dgd|}W d   n1 s~w   Y  t
 rt||||t S t rt|||d|S tdi t }t|j}	t|j}
t|}t | trt| jd	g d
d n	t| d	ttfd t |trt|jdg d
d n	t|dttfd t |trt|jddgd t|dg dd |
dks|	dkr
|dv s|
dks|	dkr"|dkr"td|	|
||j|d}|jd|||dd|id|gid t |trG|j|f |S )a  
    This OP return fixed number of evenly spaced values within a given interval.

    Args:
        start(int|float|Tensor): The input :attr:`start` is start variable of range. It is a scalar, \
            or a Tensor of shape [1] with input data type int32, int64, float32 or float64.
        stop(int|float|Tensor): The input :attr:`stop` is start variable of range. It is a scalar, \
            or a Tensor of shape [1] with input data type int32, int64, float32 or float64.
        num(int|Tensor): The input :attr:`num` is given num of the sequence. It is an int scalar, \
            or a Tensor of shape [1] with data type int32.
        dtype(np.dtype|str, optional): The data type of output tensor, it could be
            int32, int64, float32 and float64. Default: if None, the data type is float32.
        name(str, optional): Normally there is no need for user to set this property. 
            For more information, please refer to :ref:`api_guide_Name`.Default: None.

    Returns:
        Tensor: the output data type will be float32, float64. The 1-D tensor with fixed number of evenly spaced values, \
        the data shape of this tensor is :math:`[num]` . If the :attr:`num` is set 1, the output tensor just has \
        the value with input :attr:`start`. 

    Examples:
        .. code-block:: python

             import paddle
             data = paddle.linspace(0, 10, 5, 'float32') # [0.0,  2.5,  5.0,  7.5, 10.0]
             data = paddle.linspace(0, 10, 1, 'float32') # [0.0]

    Nr;   numr2   r   r   r>   r8   r   r   stop)r>   r?   r;   r<   r<   )r;   r>   r?   zThe dtype of start/stop is {}/{} but the attr(dtype) of linspace is {}, which may cause data type overflows. Please reset attr(dtype) of linspace.rx   )r   ZStopNumra   rQ   rc   re   rd   )r2   )rf   r   r   rP   r   r   rg   r   r   r'   r   r   r2   r   r   r   r   rB   r   r8   r   rZ   r   formatrh   ri   r   r   )r   r   r   r8   r@   Z
tensor_numZtensor_startZtensor_stoprC   Zstart_dtypeZ
stop_dtyper]   rj   rD   rD   rE   r2     s   















r2   c                 C   s|   t | dg dd tdi t }|du r|j| jd}n	t |dg dd |jdd| gid	| jd
d|gid d|_|S )a  
    This OP creates a zeros tensor which has identical shape and dtype 
    with `x`.

    Args:
        x(Variable): The input tensor which specifies shape and dtype, the
            input data dtype could be bool, float32, float64, int32, int64.
        out(Variable, optional): If is :attr:`None` , the op will create the
            variable as output, the data type and shape of this variable will
            be same as input :attr:`x`. If is a tensor, the data type and shape
            need to be same as input :attr:`x`. The default value is :attr:`None` .

    Returns:
        Variable: The N-D tensor, the element in tensor is related to input
            data type, if the input data type is bool, the output value is
            False, otherwise is zero. The output shape is the same as the input.

    Examples:
        .. code-block:: python

          import paddle.fluid as fluid
          x = fluid.data(name='x', dtype='float32', shape=[3])
          data = fluid.layers.zeros_like(x) # [0.0, 0.0, 0.0]

    r^   r9   r;   r<   r>   r?   r3   Nrx   rj   fill_any_liker`   r   )rW   r8   ra   r   T)r3   )r   r   rB   rh   r8   ri   rV   r^   rj   rC   rD   rD   rE   r3   z  s(   
r3   z2.0.0zpaddle.diagc                 C   s~   t | dttjfd t| jdg dd td
i t }t| ts%t	| } |j
| jd}|jdd| gid|gid d|_|S )a1  
	:alias_main: paddle.diag
	:alias: paddle.diag,paddle.tensor.diag,paddle.tensor.creation.diag
	:old_api: paddle.fluid.layers.diag

    This OP creates a square matrix which has diagonal values specified by input :attr:`diagonal`.

    Args:
        diagonal(Variable|numpy.ndarray): The input tensor should be 1D tensor, the input shape is :math:`[ N]` , \
            specifying diagonal values by this input tensor. The input data type should be float32, float64, int32, int64.

    Returns:
        Variable, the output data type is the same as input data type.: The tensor variable storing the square matrix, \
            the diagonal values specified by input :attr:`diagonal`. the output shape is :math:`[N, N]` with two dims.

    Examples:
        .. code-block:: python

          # [[3, 0, 0]
          #  [0, 4, 0]
          #  [0, 0, 5] 

          import paddle.fluid as fluid
          import numpy as np
          diagonal = np.arange(3, 6, dtype='int32')
          data = fluid.layers.diag(diagonal)
          # diagonal.shape=(3,) data.shape=(3, 3)

    diagonalr5   r   rx   ZDiagonalra   r   TN)r5   )r   r   rN   rO   r   r8   r   rB   rf   r%   rh   ri   rV   )r   rC   rj   rD   rD   rE   r5     s   
r5   r;   c                 C   s|  dd }|| d t |tjjst|}|dur||d n| }t r-t| ||t }n6t	 r;t
d|d| d|}n(tdi t }t|dg dd |j|d	}|jdi d
|gi| ||ddd |durdgt| }|| |g }|ddg }	t rt
|dd|\}}
t
|dd|	S t |tstd|D ]
}|dkrtdqddlm}m} |||d}|||	d}d|_|S )a  
    This function constructs a or a batch of 2-D tensor with ones on the diagonal and zeros elsewhere. 

    Args:
        num_rows(int): the number of rows in each batch tensor.
        num_columns(int, optional): the number of columns in each batch tensor.
            If None, default: num_rows.
        batch_shape(list, optional): If provided, the returned tensor will have a leading
            batch size of this shape, the data type of ``batch_shape`` is int. Default is None.
        dtype(np.dtype|str, optional): The data type of the returned tensor.
            It should be int32, int64, float16, float32, float64, default is 'float32'.
        name(str, optional): The default value is None. Normally there is no
            need for user to set this property. For more information, please
            refer to :ref:`api_guide_Name`.

    Returns:
        Tensor: An identity Tensor or LoDTensor of shape batch_shape + [num_rows, num_columns].

    Examples:
        .. code-block:: python

          import paddle.fluid as fluid
          data = fluid.layers.eye(3, dtype='int32')
          # [[1, 0, 0]
          #  [0, 1, 0]
          #  [0, 0, 1]]

          data = fluid.layers.eye(2, 3, dtype='int32')
          # [[1, 0, 0]
          #  [0, 1, 0]]

          data = fluid.layers.eye(2, batch_shape=[3])
          # Construct a batch of 3 identity tensors, each 2 x 2.
          # data[i, :, :] is a 2 x 2 identity tensor, i = 0, 1, 2.

    c                 S   s^   t | ttjtjjfrt| jdkr| jd dv sJ d S t | tr&| dk r-t	d
|d S )Nr   r   )r   r   z {} should be a non-negative int.)rf   r   r   r   r   r   r   rF   rP   r~   r   )rJ   messagerD   rD   rE   _check_attr  s
   $zeye.<locals>._check_attrnum_rowsNnum_columnsr8   r6   r   rx   ra   )r   r   r8   Tr   r   rF   expand_timeszbatch_shape should be a listr   z)batch_shape should be a positive int list)reshapeexpand)r^   rF   )r^   r   )r6   )rf   r   r   rg   r   r   r   r6   r   r   r   r   rB   r   rh   ri   r   r	   Zreshape2r   rL   r~   r   r   rV   )r   r   Zbatch_shaper8   r@   r   rj   rC   Zre_shaper   _Z	batch_valr   r   rD   rD   rE   r6     s^   *



r6   c                 C   sr   t | dg dd tdi t }|du r|j| jd}n	t |dg dd |jdd| gid	d
id|gid |S )a0  
    **ones_like**

    This function creates a ones tensor which has identical shape and dtype 
    with `x`.

    Args:
        x(Variable): The input tensor which specifies shape and dtype.
        out(Variable): The output tensor.

    Returns:
        out(Variable): The tensor variable storing the output.

    Examples:
        .. code-block:: python

          import paddle.fluid as fluid

          x = fluid.layers.data(name='x', dtype='float32', shape=[3], append_batch_size=False)
          data = fluid.layers.ones_like(x) # [1.0, 1.0, 1.0]

    r^   r   r4   Nrx   rj   r   r`   rW   r   ra   r   )r4   )r   r   rB   rh   r8   ri   r   rD   rD   rE   r4   =  s"   
r4   zpaddle.triuc                 C   s   dd l }|jj| ||dS )Nr   )r^   r   r@   )paddleZtensorr7   )ru   r   r@   r   rD   rD   rE   r7   f  s   r7   )NF)NNFN)FFN)r   N)r   NFr   )FNN)r   r   Frl   )r   FN)F)FN)T)NN)NNr;   N)E
__future__r   r   rN   r   Zlayer_helperr   Z
param_attrr   rY   r   Z	frameworkr   r   r	   r
   r   r   r   r   r   r   r   r    Zlayer_function_generatorr   r   Zdata_feederr   r   r   r   Zpaddle.utilsr   r   r   r   r   __all__r   r   r    r!   r#   r"   r$   r%   r'   r&   r(   r)   r*   r+   r,   r-   r   r   r   r.   r/   r0   r1   r2   r3   r5   r6   r4   r7   rD   rD   rD   rE   <module>   s   (
!
=
A
9
{
p
K 
 

K
B
>
_

O
&
 
d
a
/
1

c
)