mindspore.Tensor
================

.. py:class:: mindspore.Tensor(input_data=None, dtype=None, shape=None, init=None, internal=False, const_arg=False, device=None)

    张量，即存储多维数组（n-dimensional array）的数据结构。

    .. note::
        - 当使用 `init` 参数来初始化 `Tensor` 时，通常需要使用 `Tensor.init_data` 来加载 `Tensor` 的数据。
        - CPU、GPU的所有模式，以及Atlas训练系列产品的 `图模式(mode=mindspore.GRAPH_MODE) <https://www.mindspore.cn/docs/zh-CN/r2.5.0/model_train/program_form/static_graph.html>`_ 尚不支持in-place操作。

    .. warning::
        当转换 `Tensor` 类型时，推荐使用 `Tensor.astype()` 而非 `Tensor(sourceTensor, dtype=newDtype)` 。

    参数：
        - **input_data** (Union[Tensor, float, int, bool, tuple, list, numpy.ndarray]) - 被存储的数据，可以是其他Tensor，也可以是Python基本数据（如int，float，bool等），或是一个NumPy对象。默认值： ``None`` 。
        - **dtype** (:class:`mindspore.dtype`) - 用于定义该Tensor的数据类型，必须是 `mindspore.dtype` 中定义的类型。如果该参数为 ``None`` ，则数据类型与 `input_data` 一致，默认值： ``None`` 。
        - **shape** (Union[tuple, list, int, :class:`mindspore.Symbol`]) - 用于定义该Tensor的形状。如果指定了 `input_data` ，则无需设置该参数。如果 `shape` 中存在 ``None`` 或 `Symbol` 类型数据，表示创建一个动态形状（dynamic shape）的Tensor，此时不需要设置 `input_data` 参数；如果 `shape` 中仅存在整数类型数据，表示创建一个静态形状（static shape）的Tensor，此时必须设置 `input_data` 或 `init` 参数。默认值： ``None`` 。
        - **init** (Initializer) - 用于在并行模式中延迟Tensor的数据的初始化，如果指定该参数，则 `dtype` 和 `shape` 也必须被指定。默认值： ``None`` 。
        - **internal** (bool) - Tensor是否由框架创建。如果为 ``True`` ，表示Tensor是由框架创建的，如果为 ``False`` ，表示Tensor是由用户创建的。默认值： ``False`` 。
        - **const_arg** (bool) - 指定该Tensor作为网络输入时是否为常量。默认值： ``False`` 。
        - **device** (str) - 该参数为保留参数，不需要用户配置。默认值： ``None`` 。

    输出：
        Tensor。

    .. note::
        `input_data` 的默认值 ``None`` 只作为一个占位符，并不意味着可以创建一个NoneType的Tensor。
        当前对 `shape` 中包含0的Tensor支持的不完善。

.. mscnautosummary::
    :toctree: Tensor
    :nosignatures:

    mindspore.Tensor.abs
    mindspore.Tensor.absolute
    mindspore.Tensor.acos
    mindspore.Tensor.acosh
    mindspore.Tensor.add_
    mindspore.Tensor.add
    mindspore.Tensor.addbmm
    mindspore.Tensor.addcdiv
    mindspore.Tensor.addcmul
    mindspore.Tensor.addmm
    mindspore.Tensor.addmm_
    mindspore.Tensor.addmv
    mindspore.Tensor.addr
    mindspore.Tensor.adjoint
    mindspore.Tensor.all
    mindspore.Tensor.allclose
    mindspore.Tensor.amax
    mindspore.Tensor.amin
    mindspore.Tensor.aminmax
    mindspore.Tensor.any
    mindspore.Tensor.angle
    mindspore.Tensor.approximate_equal
    mindspore.Tensor.arccos
    mindspore.Tensor.arccosh
    mindspore.Tensor.arcsin
    mindspore.Tensor.arcsinh
    mindspore.Tensor.arctan
    mindspore.Tensor.arctan2
    mindspore.Tensor.arctanh
    mindspore.Tensor.argmax
    mindspore.Tensor.argmax_with_value
    mindspore.Tensor.argmin
    mindspore.Tensor.argmin_with_value
    mindspore.Tensor.argsort
    mindspore.Tensor.argwhere
    mindspore.Tensor.asin
    mindspore.Tensor.asinh
    mindspore.Tensor.asnumpy
    mindspore.Tensor.assign_value
    mindspore.Tensor.astype
    mindspore.Tensor.atan
    mindspore.Tensor.atan2
    mindspore.Tensor.atanh
    mindspore.Tensor.baddbmm
    mindspore.Tensor.bernoulli
    mindspore.Tensor.bfloat16
    mindspore.Tensor.bincount
    mindspore.Tensor.bitwise_and
    mindspore.Tensor.bitwise_not
    mindspore.Tensor.bitwise_left_shift
    mindspore.Tensor.bitwise_or
    mindspore.Tensor.bitwise_right_shift
    mindspore.Tensor.bitwise_xor
    mindspore.Tensor.bmm
    mindspore.Tensor.bool
    mindspore.Tensor.broadcast_to
    mindspore.Tensor.byte
    mindspore.Tensor.cauchy
    mindspore.Tensor.ceil
    mindspore.Tensor.cholesky
    mindspore.Tensor.cholesky_solve
    mindspore.Tensor.choose
    mindspore.Tensor.chunk
    mindspore.Tensor.clamp
    mindspore.Tensor.clamp_
    mindspore.Tensor.clip
    mindspore.Tensor.clone
    mindspore.Tensor.col2im
    mindspore.Tensor.conj
    mindspore.Tensor.contiguous
    mindspore.Tensor.copy
    mindspore.Tensor.copy_
    mindspore.Tensor.copysign
    mindspore.Tensor.cos
    mindspore.Tensor.cosh
    mindspore.Tensor.count_nonzero
    mindspore.Tensor.cov
    mindspore.Tensor.cross
    mindspore.Tensor.cummax
    mindspore.Tensor.cummin
    mindspore.Tensor.cumprod
    mindspore.Tensor.cumsum
    mindspore.Tensor.deg2rad
    mindspore.Tensor.diag
    mindspore.Tensor.diagflat
    mindspore.Tensor.diagonal
    mindspore.Tensor.diagonal_scatter
    mindspore.Tensor.diff
    mindspore.Tensor.digamma
    mindspore.Tensor.div
    mindspore.Tensor.div_
    mindspore.Tensor.divide
    mindspore.Tensor.dot
    mindspore.Tensor.double
    mindspore.Tensor.dsplit
    mindspore.Tensor.dtype
    mindspore.Tensor.eigvals
    mindspore.Tensor.eq
    mindspore.Tensor.equal
    mindspore.Tensor.erf
    mindspore.Tensor.erfc
    mindspore.Tensor.erfinv
    mindspore.Tensor.exp
    mindspore.Tensor.exp_
    mindspore.Tensor.expand
    mindspore.Tensor.expand_as
    mindspore.Tensor.expand_dims
    mindspore.Tensor.expm1
    mindspore.Tensor.fill_
    mindspore.Tensor.fill_diagonal
    mindspore.Tensor.flatten
    mindspore.Tensor.flip
    mindspore.Tensor.fliplr
    mindspore.Tensor.flipud
    mindspore.Tensor.float
    mindspore.Tensor.float_power
    mindspore.Tensor.floor
    mindspore.Tensor.floor_
    mindspore.Tensor.floor_divide
    mindspore.Tensor.flush_from_cache
    mindspore.Tensor.fmax
    mindspore.Tensor.fmod
    mindspore.Tensor.fold
    mindspore.Tensor.frac
    mindspore.Tensor.from_numpy
    mindspore.Tensor.gather
    mindspore.Tensor.gather_elements
    mindspore.Tensor.gather_nd
    mindspore.Tensor.gcd
    mindspore.Tensor.ge
    mindspore.Tensor.geqrf
    mindspore.Tensor.ger
    mindspore.Tensor.greater
    mindspore.Tensor.greater_equal
    mindspore.Tensor.gt
    mindspore.Tensor.H
    mindspore.Tensor.half
    mindspore.Tensor.hardshrink
    mindspore.Tensor.has_init
    mindspore.Tensor.heaviside
    mindspore.Tensor.histc
    mindspore.Tensor.hsplit
    mindspore.Tensor.hypot
    mindspore.Tensor.i0
    mindspore.Tensor.igamma
    mindspore.Tensor.igammac
    mindspore.Tensor.imag
    mindspore.Tensor.index_add
    mindspore.Tensor.index_add_
    mindspore.Tensor.index_fill
    mindspore.Tensor.index_put
    mindspore.Tensor.index_put_
    mindspore.Tensor.index_select
    mindspore.Tensor.init_data
    mindspore.Tensor.inner
    mindspore.Tensor.inplace_update
    mindspore.Tensor.int
    mindspore.Tensor.inv
    mindspore.Tensor.inverse
    mindspore.Tensor.invert
    mindspore.Tensor.isclose
    mindspore.Tensor.isfinite
    mindspore.Tensor.is_complex
    mindspore.Tensor.is_contiguous
    mindspore.Tensor.is_floating_point
    mindspore.Tensor.isinf
    mindspore.Tensor.isnan
    mindspore.Tensor.isneginf
    mindspore.Tensor.isposinf
    mindspore.Tensor.isreal
    mindspore.Tensor.is_signed
    mindspore.Tensor.item
    mindspore.Tensor.itemset
    mindspore.Tensor.itemsize
    mindspore.Tensor.lcm
    mindspore.Tensor.ldexp
    mindspore.Tensor.le
    mindspore.Tensor.lerp
    mindspore.Tensor.less
    mindspore.Tensor.less_equal
    mindspore.Tensor.log
    mindspore.Tensor.log10
    mindspore.Tensor.log1p
    mindspore.Tensor.log2
    mindspore.Tensor.logaddexp
    mindspore.Tensor.logaddexp2
    mindspore.Tensor.logcumsumexp
    mindspore.Tensor.logdet
    mindspore.Tensor.logical_and
    mindspore.Tensor.logical_not
    mindspore.Tensor.logical_or
    mindspore.Tensor.logical_xor
    mindspore.Tensor.logit
    mindspore.Tensor.logsumexp
    mindspore.Tensor.log_normal
    mindspore.Tensor.long
    mindspore.Tensor.lt
    mindspore.Tensor.lu_solve
    mindspore.Tensor.masked_fill
    mindspore.Tensor.masked_fill_
    mindspore.Tensor.masked_scatter
    mindspore.Tensor.masked_select
    mindspore.Tensor.matmul
    mindspore.Tensor.max
    mindspore.Tensor.maximum
    mindspore.Tensor.mean
    mindspore.Tensor.median
    mindspore.Tensor.t
    mindspore.Tensor.mH
    mindspore.Tensor.min
    mindspore.Tensor.minimum
    mindspore.Tensor.mm
    mindspore.Tensor.moveaxis
    mindspore.Tensor.movedim
    mindspore.Tensor.move_to
    mindspore.Tensor.msort
    mindspore.Tensor.mT
    mindspore.Tensor.mul
    mindspore.Tensor.mul_
    mindspore.Tensor.multinomial
    mindspore.Tensor.multiply
    mindspore.Tensor.mvlgamma
    mindspore.Tensor.nan_to_num
    mindspore.Tensor.nanmean
    mindspore.Tensor.nanmedian
    mindspore.Tensor.nansum
    mindspore.Tensor.narrow
    mindspore.Tensor.nbytes
    mindspore.Tensor.ndim
    mindspore.Tensor.ndimension
    mindspore.Tensor.ne
    mindspore.Tensor.neg
    mindspore.Tensor.negative
    mindspore.Tensor.nelement
    mindspore.Tensor.new_ones
    mindspore.Tensor.new_zeros
    mindspore.Tensor.nextafter
    mindspore.Tensor.nonzero
    mindspore.Tensor.norm
    mindspore.Tensor.normal_
    mindspore.Tensor.not_equal
    mindspore.Tensor.numel
    mindspore.Tensor.numpy
    mindspore.Tensor.orgqr
    mindspore.Tensor.ormqr
    mindspore.Tensor.outer
    mindspore.Tensor.permute
    mindspore.Tensor.positive
    mindspore.Tensor.pow
    mindspore.Tensor.prod
    mindspore.Tensor.ptp
    mindspore.Tensor.rad2deg
    mindspore.Tensor.random_
    mindspore.Tensor.random_categorical
    mindspore.Tensor.ravel
    mindspore.Tensor.real
    mindspore.Tensor.reciprocal
    mindspore.Tensor.register_hook
    mindspore.Tensor.remainder
    mindspore.Tensor.renorm
    mindspore.Tensor.repeat
    mindspore.Tensor.repeat_interleave
    mindspore.Tensor.reshape
    mindspore.Tensor.reshape_as
    mindspore.Tensor.resize
    mindspore.Tensor.reverse
    mindspore.Tensor.reverse_sequence
    mindspore.Tensor.roll
    mindspore.Tensor.rot90
    mindspore.Tensor.round
    mindspore.Tensor.rsqrt
    mindspore.Tensor.scatter
    mindspore.Tensor.scatter_
    mindspore.Tensor.scatter_add
    mindspore.Tensor.scatter_add_
    mindspore.Tensor.scatter_div
    mindspore.Tensor.scatter_max
    mindspore.Tensor.scatter_min
    mindspore.Tensor.scatter_mul
    mindspore.Tensor.scatter_sub
    mindspore.Tensor.searchsorted
    mindspore.Tensor.select
    mindspore.Tensor.select_scatter
    mindspore.Tensor.set_const_arg
    mindspore.Tensor.sgn
    mindspore.Tensor.shape
    mindspore.Tensor.short
    mindspore.Tensor.sigmoid
    mindspore.Tensor.sign
    mindspore.Tensor.signbit
    mindspore.Tensor.sin
    mindspore.Tensor.sinc
    mindspore.Tensor.sinh
    mindspore.Tensor.size
    mindspore.Tensor.slice_scatter
    mindspore.Tensor.slogdet
    mindspore.Tensor.softmax
    mindspore.Tensor.sort
    mindspore.Tensor.split
    mindspore.Tensor.sqrt
    mindspore.Tensor.square
    mindspore.Tensor.squeeze
    mindspore.Tensor.std
    mindspore.Tensor.storage_offset
    mindspore.Tensor.stride
    mindspore.Tensor.strides
    mindspore.Tensor.sub
    mindspore.Tensor.sub_
    mindspore.Tensor.subtract
    mindspore.Tensor.sum
    mindspore.Tensor.sum_to_size
    mindspore.Tensor.svd
    mindspore.Tensor.swapaxes
    mindspore.Tensor.swapdims
    mindspore.Tensor.T
    mindspore.Tensor.t
    mindspore.Tensor.take
    mindspore.Tensor.tan
    mindspore.Tensor.tanh
    mindspore.Tensor.tensor_split
    mindspore.Tensor.tile
    mindspore.Tensor.to
    mindspore.Tensor.to_coo
    mindspore.Tensor.to_csr
    mindspore.Tensor.tolist
    mindspore.Tensor.topk
    mindspore.Tensor.trace
    mindspore.Tensor.transpose
    mindspore.Tensor.tril
    mindspore.Tensor.triu
    mindspore.Tensor.true_divide
    mindspore.Tensor.trunc
    mindspore.Tensor.type
    mindspore.Tensor.type_as
    mindspore.Tensor.unbind
    mindspore.Tensor.unfold
    mindspore.Tensor.uniform
    mindspore.Tensor.uniform_
    mindspore.Tensor.unique
    mindspore.Tensor.unique_consecutive
    mindspore.Tensor.unique_with_pad
    mindspore.Tensor.unsorted_segment_max
    mindspore.Tensor.unsorted_segment_min
    mindspore.Tensor.unsorted_segment_prod
    mindspore.Tensor.unsqueeze
    mindspore.Tensor.var
    mindspore.Tensor.view
    mindspore.Tensor.view_as
    mindspore.Tensor.vsplit
    mindspore.Tensor.where
    mindspore.Tensor.xdivy
    mindspore.Tensor.xlogy
    mindspore.Tensor.zero_