Function asarray

python/paddle/tensor/creation.py:1219–1300

r""" Constructs a ``paddle.Tensor`` from ``obj`` , which can be scalar, tuple, list, numpy\.ndarray, paddle\.Tensor. If the ``obj`` is already a tensor, copy will be performed and return a new tensor. .. note:: The parameter ``copy`` will not affect this api's behavior. Copy wi

(
    obj: TensorLike | NestedNumericSequence,
    *,
    dtype: DTypeLike | None = None,
    device: PlaceLike | None = None,
    copy: bool | None = None,
    requires_grad: bool = False,
)

def asarray(
    obj: TensorLike | NestedNumericSequence,
    *,
    dtype: DTypeLike | None = None,
    device: PlaceLike | None = None,
    copy: bool | None = None,
    requires_grad: bool = False,
):
    r"""
    Constructs a ``paddle.Tensor`` from ``obj`` ,
    which can be scalar, tuple, list, numpy\.ndarray, paddle\.Tensor.

    If the ``obj`` is already a tensor, copy will be performed and return a new tensor.

    .. note::
    The parameter ``copy`` will not affect this api's behavior. Copy will always be performed if ``obj`` is a tensor.

    .. code-block:: text

        We use the dtype conversion rules following this:
                Keep dtype
        np.number ───────────► paddle.Tensor
                                (0-D Tensor)
                    default_dtype
        Python Number ───────────────► paddle.Tensor
                                        (0-D Tensor)
                    Keep dtype
        np.ndarray ───────────► paddle.Tensor

    Args:
        obj(scalar|tuple|list|ndarray|Tensor): Initial data for the tensor.
            Can be a scalar, list, tuple, numpy\.ndarray, paddle\.Tensor.
        dtype(str|np.dtype, optional): The desired data type of returned tensor. Can be 'bool' , 'float16' ,
            'float32' , 'float64' , 'int8' , 'int16' , 'int32' , 'int64' , 'uint8',
            'complex64' , 'complex128'. Default: None, infers dtype from ``data``
            except for python float number which gets dtype from ``get_default_type`` .
        device(CPUPlace|CUDAPinnedPlace|CUDAPlace|str, optional): The place to allocate Tensor. Can be
            CPUPlace, CUDAPinnedPlace, CUDAPlace. Default: None, means global place. If ``place`` is
            string, It can be ``cpu``, ``gpu:x`` and ``gpu_pinned``, where ``x`` is the index of the GPUs.
        copy(bool, optional): This param is ignored and has no effect.
        requires_grad(bool, optional): Whether to block the gradient propagation of autograd. Default: False.

    Returns:
        Tensor: A Tensor constructed from ``data`` .

    Examples:
        .. code-block:: pycon

            >>> import paddle

            >>> type(paddle.asarray(1))
            <class 'paddle.Tensor'>

            >>> paddle.asarray(1)
            Tensor(shape=[], dtype=int64, place=Place(cpu), stop_gradient=True,
            1)

            >>> x = paddle.asarray(1, requires_grad=True)