mindspore.Tensor

class mindspore.Tensor(input_data=None, dtype=None, shape=None, init=None, internal=False, const_arg=False)[source]

Tensor is a data structure that stores an n-dimensional array.

Parameters

input_data (Union[Tensor, float, int, bool, tuple, list, numpy.ndarray]) – The data to be stored. It can be another Tensor, Python number or NumPy ndarray. Default: None.
dtype (mindspore.dtype) – Used to indicate the data type of the output Tensor. The argument should be defined in mindspore.dtype. If it is None, the data type of the output Tensor will be the same as the input_data. Default: None.
shape (Union[tuple, list, int]) – Used to indicate the shape of the output Tensor. The argument should be a list of integers, a tuple of integers or an integer. If input_data is available, shape doesn’t need to be set. If None in shape, a tensor of dynamic shape is created, input_data doesn’t need to be set; if None not in shape, a tensor of static shape is created, input_data or init must be set. Default: None.
init (Initializer) – The information of init data. ‘init’ is used for delayed initialization in parallel mode. Usually, it is not recommended to use ‘init’ interface to initialize Tensor in the other conditions. If ‘init’ interface is used to initialize Tensor, the Tensor.init_data API needs to be called to convert Tensor to the actual data. Default: None.
internal (bool) – Whether it is created by the framework. ‘True’ means that the tensor is created by framework. ‘False’ means that the tensor is created by user. Default: False
const_arg (bool) – Whether the tensor is a constant when it is used for the argument of a network. Default: False.

Outputs:: Tensor.

Examples

>>> import numpy as np
>>> import mindspore as ms
>>> from mindspore import Tensor
>>> from mindspore.common.initializer import One
>>> # initialize a tensor with numpy.ndarray
>>> t1 = Tensor(np.zeros([1, 2, 3]), ms.float32)
>>> print(t1)
[[[0. 0. 0.]
[0. 0. 0.]]]
>>> print(type(t1))
<class 'mindspore.common.tensor.Tensor'>
>>> print(t1.shape)
(1, 2, 3)
>>> print(t1.dtype)
Float32
>>>
>>> # initialize a tensor with a float scalar
>>> t2 = Tensor(0.1)
>>> print(t2)
0.1
>>> print(type(t2))
<class 'mindspore.common.tensor.Tensor'>
>>> print(t2.shape)
()
>>> print(t2.dtype)
Float32
>>>
>>> # initialize a tensor with a tuple
>>> t3 = Tensor((1, 2))
>>> print(t3)
[1 2]
>>> print(type(t3))
<class 'mindspore.common.tensor.Tensor'>
>>> print(t3.shape)
(2,)
>>> print(t3.dtype)
Int64
...
>>> # initialize a tensor with init
>>> t4 = Tensor(shape = (1, 3), dtype=ms.float32, init=One())
>>> print(t4)
[[1. 1. 1.]]
>>> print(type(t4))
<class 'mindspore.common.tensor.Tensor'>
>>> print(t4.shape)
(1, 3)
>>> print(t4.dtype)
Float32

`mindspore.Tensor.abs`	For details, please refer to `mindspore.ops.abs()`.
`mindspore.Tensor.absolute`	Alias for `mindspore.Tensor.abs()`.
`mindspore.Tensor.acos`	For details, please refer to `mindspore.ops.acos()`.
`mindspore.Tensor.add`	For details, please refer to `mindspore.ops.add()`.
`mindspore.Tensor.addbmm`	For details, please refer to `mindspore.ops.addbmm()`.
`mindspore.Tensor.addcdiv`	For details, please refer to `mindspore.ops.addcdiv()`.
`mindspore.Tensor.addcmul`	For details, please refer to `mindspore.ops.addcmul()`.
`mindspore.Tensor.addmm`	For details, please refer to `mindspore.ops.addmm()`.
`mindspore.Tensor.addmv`	Multiplies matrix mat and vector vec.
`mindspore.Tensor.addr`	For details, please refer to `mindspore.ops.addr()`.
`mindspore.Tensor.adjoint`	For details, please refer to `mindspore.ops.adjoint()`.
`mindspore.Tensor.all`	Check all tensor elements along a given axis evaluate to True.
`mindspore.Tensor.amax`	For details, please refer to `mindspore.ops.amax()`.
`mindspore.Tensor.amin`	For details, please refer to `mindspore.ops.amin()`.
`mindspore.Tensor.any`	Check any tensor element along a given axis evaluate to True.
`mindspore.Tensor.angle`	For details, please refer to `mindspore.ops.angle()`.
`mindspore.Tensor.approximate_equal`	For details, please refer to `mindspore.ops.approximate_equal()`.
`mindspore.Tensor.arccos`	Alias for `mindspore.Tensor.acos()`.
`mindspore.Tensor.arccosh`	For details, please refer to `mindspore.ops.arccosh()`.
`mindspore.Tensor.arcsin`	For details, please refer to `mindspore.ops.arcsin()`.
`mindspore.Tensor.arcsinh`	Alias for `mindspore.Tensor.asinh()`.
`mindspore.Tensor.arctan`	For details, please refer to `mindspore.ops.arctan()`.
`mindspore.Tensor.arctan2`	For details, please refer to `mindspore.ops.arctan2()`.
`mindspore.Tensor.arctanh`	Alias for `mindspore.Tensor.atanh()`.
`mindspore.Tensor.argmax`	For details, please refer to `mindspore.ops.argmax()`.
`mindspore.Tensor.argmax_with_value`	Returns the maximum value with corresponding index.
`mindspore.Tensor.argmin`	For details, please refer to `mindspore.ops.argmin()`.
`mindspore.Tensor.argmin_with_value`	Returns the minimum value with corresponding index.
`mindspore.Tensor.asin`	For details, please refer to `mindspore.ops.asin()`.
`mindspore.Tensor.asinh`	For details, please refer to `mindspore.ops.asinh()`.
`mindspore.Tensor.asnumpy`	Convert tensor to numpy array.
`mindspore.Tensor.assign_value`	Assign another tensor value to this tensor.
`mindspore.Tensor.astype`	Return a copy of the tensor, cast to a specified type.
`mindspore.Tensor.atan`	For details, please refer to `mindspore.ops.atan()`.
`mindspore.Tensor.atan2`	For details, please refer to `mindspore.ops.atan2()`.
`mindspore.Tensor.atanh`	For details, please refer to `mindspore.ops.atanh()`.
`mindspore.Tensor.baddbmm`	For details, please refer to `mindspore.ops.baddbmm()`.
`mindspore.Tensor.bernoulli`	For details, please refer to `mindspore.ops.bernoulli()`.
`mindspore.Tensor.bitwise_and`	For details, please refer to `mindspore.ops.bitwise_and()`.
`mindspore.Tensor.bitwise_or`	For details, please refer to `mindspore.ops.bitwise_or()`.
`mindspore.Tensor.bitwise_xor`	For details, please refer to `mindspore.ops.bitwise_xor()`.
`mindspore.Tensor.bmm`	For details, please refer to `mindspore.ops.bmm()`.
`mindspore.Tensor.bool`	Converts input tensor dtype to bool.
`mindspore.Tensor.broadcast_to`	For details, please refer to `mindspore.ops.broadcast_to()`.
`mindspore.Tensor.ceil`	For details, please refer to `mindspore.ops.ceil()`.
`mindspore.Tensor.cholesky`	For details, please refer to `mindspore.ops.cholesky()`.
`mindspore.Tensor.cholesky_inverse`	For details, please refer to `mindspore.ops.cholesky_inverse()`.
`mindspore.Tensor.choose`	Construct a tensor from an index tensor and a list of tensors to choose from.
`mindspore.Tensor.clip`	Clips (limits) the values in a Tensor.
`mindspore.Tensor.col2im`	For details, please refer to `mindspore.ops.col2im()`.
`mindspore.Tensor.conj`	For details, please refer to `mindspore.ops.conj()`.
`mindspore.Tensor.copy`	Return a copy of the tensor.
`mindspore.Tensor.copysign`	For details, please refer to `mindspore.ops.copysign()`.
`mindspore.Tensor.cosh`	For details, please refer to `mindspore.ops.cosh()`.
`mindspore.Tensor.cross`	For details, please refer to `mindspore.ops.cross()`.
`mindspore.Tensor.cummax`	For details, please refer to `mindspore.ops.cummax()`.
`mindspore.Tensor.cummin`	For details, please refer to `mindspore.ops.cummin()`.
`mindspore.Tensor.cumprod`	For details, please refer to `mindspore.ops.cumprod()`.
`mindspore.Tensor.cumsum`	For details, please refer to `mindspore.ops.cumsum()`.
`mindspore.Tensor.deg2rad`	For details, please refer to `mindspore.ops.deg2rad()`.
`mindspore.Tensor.diag`	For details, please refer to `mindspore.ops.diag()`.
`mindspore.Tensor.diagonal`	For details, please refer to `mindspore.ops.diagonal()`.
`mindspore.Tensor.div`	For details, please refer to `mindspore.ops.div()`.
`mindspore.Tensor.divide`	For details, please refer to `mindspore.ops.div()`.
`mindspore.Tensor.dtype`	Return the dtype of the tensor (`mindspore.dtype`).
`mindspore.Tensor.equal`	For details, please refer to `mindspore.ops.equal()`.
`mindspore.Tensor.erf`	For details, please refer to `mindspore.ops.erf()`.
`mindspore.Tensor.erfc`	For details, please refer to `mindspore.ops.erfc()`.
`mindspore.Tensor.erfinv`	For details, please refer to `mindspore.ops.erfinv()`.
`mindspore.Tensor.exp`	For details, please refer to `mindspore.ops.exp()`.
`mindspore.Tensor.expand`	For details, please refer to `mindspore.ops.expand()`.
`mindspore.Tensor.expand_as`	Expand the dimension of target tensor to the dimension of input tensor.
`mindspore.Tensor.expand_dims`	For details, please refer to `mindspore.ops.expand_dims()`.
`mindspore.Tensor.expm1`	For details, please refer to `mindspore.ops.expm1()`.
`mindspore.Tensor.fill`	For details, please refer to `mindspore.ops.fill()`.
`mindspore.Tensor.flatten`	For details, please refer to `mindspore.ops.flatten()`.
`mindspore.Tensor.flip`	For details, please refer to `mindspore.ops.flip()`.
`mindspore.Tensor.fliplr`	For details, please refer to `mindspore.ops.fliplr()`.
`mindspore.Tensor.flipud`	For details, please refer to `mindspore.ops.flipud()`.
`mindspore.Tensor.float`	Converts input tensor dtype to float32.
`mindspore.Tensor.floor`	For details, please refer to `mindspore.ops.floor()`.
`mindspore.Tensor.flush_from_cache`	Flush cache data to host if tensor is cache enable.
`mindspore.Tensor.fold`	For details, please refer to `mindspore.ops.fold()`.
`mindspore.Tensor.from_numpy`	Convert numpy array to Tensor.
`mindspore.Tensor.gather`	For details, please refer to `mindspore.ops.gather()`.
`mindspore.Tensor.gather_elements`	For details, please refer to `mindspore.ops.gather_elements()`.
`mindspore.Tensor.gather_nd`	For details, please refer to `mindspore.ops.gather_nd()`.
`mindspore.Tensor.ge`	For details, please refer to `mindspore.ops.ge()`.
`mindspore.Tensor.ger`	For details, please refer to `mindspore.ops.ger()`.
`mindspore.Tensor.greater`	For details, please refer to `mindspore.ops.greater()`.
`mindspore.Tensor.greater_equal`	For details, please refer to `mindspore.ops.greater_equal()`.
`mindspore.Tensor.gt`	For details, please refer to `mindspore.ops.gt()`.
`mindspore.Tensor.half`	Converts input tensor dtype to float16.
`mindspore.Tensor.hardshrink`	For details, please refer to `mindspore.ops.hardshrink()`.
`mindspore.Tensor.has_init`	Whether tensor is initialized.
`mindspore.Tensor.heaviside`	For details, please refer to `mindspore.ops.heaviside()`.
`mindspore.Tensor.hypot`	For details, please refer to `mindspore.ops.hypot()`.
`mindspore.Tensor.i0`	For details, please refer to `mindspore.ops.i0()`.
`mindspore.Tensor.igamma`	For details, please refer to `mindspore.ops.igamma()`.
`mindspore.Tensor.igammac`	For details, please refer to `mindspore.ops.igammac()`.
`mindspore.Tensor.index_add`	For details, please refer to `mindspore.ops.index_add()`.
`mindspore.Tensor.index_fill`	For details, please refer to `mindspore.ops.index_fill()`.
`mindspore.Tensor.init_data`	Get the tensor format data of this Tensor.
`mindspore.Tensor.inplace_update`	For details, please refer to `mindspore.ops.inplace_update()`.
`mindspore.Tensor.int`	Converts input tensor dtype to int32.
`mindspore.Tensor.inv`	For details, please refer to `mindspore.ops.inv()`.
`mindspore.Tensor.invert`	For details, please refer to `mindspore.ops.invert()`.
`mindspore.Tensor.isclose`	For details, please refer to `mindspore.ops.isclose()`.
`mindspore.Tensor.isfinite`	For details, please refer to `mindspore.ops.isfinite()`.
`mindspore.Tensor.is_floating_point`	For details, please refer to `mindspore.ops.is_floating_point()`.
`mindspore.Tensor.isinf`	For details, please refer to `mindspore.ops.isinf()`.
`mindspore.Tensor.isnan`	For details, please refer to `mindspore.ops.isnan()`.
`mindspore.Tensor.is_signed`	Judge whether the data type of tensor is a signed data type.
`mindspore.Tensor.item`	Get the item at the specified index of the tensor.
`mindspore.Tensor.itemset`	Insert scalar into a tensor (scalar is cast to tensor's dtype, if possible).
`mindspore.Tensor.itemsize`	Return the length of one tensor element in bytes.
`mindspore.Tensor.lcm`	For details, please refer to `mindspore.ops.lcm()`.
`mindspore.Tensor.ldexp`	For details, please refer to `mindspore.ops.ldexp()`.
`mindspore.Tensor.le`	For details, please refer to `mindspore.ops.le()`.
`mindspore.Tensor.lerp`	For details, please refer to `mindspore.ops.lerp()`.
`mindspore.Tensor.less`	For details, please refer to `mindspore.ops.less()`.
`mindspore.Tensor.less_equal`	For details, please refer to `mindspore.ops.less_equal()`.
`mindspore.Tensor.log`	For details, please refer to `mindspore.ops.log()`.
`mindspore.Tensor.log10`	For details, please refer to `mindspore.ops.log10()`.
`mindspore.Tensor.log2`	For details, please refer to `mindspore.ops.log2()`.
`mindspore.Tensor.logaddexp`	For details, please refer to `mindspore.ops.logaddexp()`.
`mindspore.Tensor.logaddexp2`	For details, please refer to `mindspore.ops.logaddexp2()`.
`mindspore.Tensor.logsumexp`	For details, please refer to `mindspore.ops.logsumexp()`.
`mindspore.Tensor.log1p`	For details, please refer to `mindspore.ops.log1p()`.
`mindspore.Tensor.logical_and`	For details, please refer to `mindspore.ops.logical_and()`.
`mindspore.Tensor.logical_not`	For details, please refer to `mindspore.ops.logical_not()`.
`mindspore.Tensor.logical_or`	For details, please refer to `mindspore.ops.logical_or()`.
`mindspore.Tensor.logical_xor`	For details, please refer to `mindspore.ops.logical_xor()`.
`mindspore.Tensor.logit`	For details, please refer to `mindspore.ops.logit()`.
`mindspore.Tensor.long`	Converts input tensor dtype to int64.
`mindspore.Tensor.masked_fill`	For details, please refer to `mindspore.ops.masked_fill()`.
`mindspore.Tensor.masked_select`	For details, please refer to `mindspore.ops.masked_select()`.
`mindspore.Tensor.max`	Return the maximum of a tensor or maximum along an axis.
`mindspore.Tensor.mean`	For details, please refer to `mindspore.ops.mean()`.
`mindspore.Tensor.median`	For details, please refer to `mindspore.ops.median()`.
`mindspore.Tensor.min`	For details, please refer to `mindspore.ops.min()`.
`mindspore.Tensor.minimum`	For details, please refer to `mindspore.ops.minimum()`.
`mindspore.Tensor.multiply`	For details, please refer to `mindspore.ops.multiply()`.
`mindspore.Tensor.narrow`	For details, please refer to `mindspore.ops.narrow()`.
`mindspore.Tensor.nbytes`	Return the total number of bytes taken by the tensor.
`mindspore.Tensor.ndim`	Return the number of tensor dimensions.
`mindspore.Tensor.ndimension`	Alias for `mindspore.Tensor.ndim()`.
`mindspore.Tensor.negative`	For details, please refer to `mindspore.ops.negative()`.
`mindspore.Tensor.nelement`	Alias for `mindspore.Tensor.numel()`.
`mindspore.Tensor.numel`	For details, please refer to `mindspore.ops.numel()`.
`mindspore.Tensor.nonzero`	For details, please refer to `mindspore.ops.nonzero()`.
`mindspore.Tensor.norm`	For details, please refer to `mindspore.ops.norm()`.
`mindspore.Tensor.permute`	For details, please refer to `mindspore.ops.permute()`.
`mindspore.Tensor.positive`	For details, please refer to `mindspore.ops.positive()`.
`mindspore.Tensor.pow`	For details, please refer to `mindspore.ops.pow()`.
`mindspore.Tensor.prod`	For details, please refer to `mindspore.ops.prod()`.
`mindspore.Tensor.ptp`	The name of the function comes from the acronym for "peak to peak".
`mindspore.Tensor.rad2deg`	For details, please refer to `mindspore.ops.rad2deg()`.
`mindspore.Tensor.random_categorical`	For details, please refer to `mindspore.ops.random_categorical()`.
`mindspore.Tensor.ravel`	Return a contiguous flattened tensor.
`mindspore.Tensor.remainder`	For details, please refer to `mindspore.ops.remainder()`.
`mindspore.Tensor.renorm`	For details, please refer to `mindspore.ops.renorm()`.
`mindspore.Tensor.repeat`	Repeat elements of a tensor.
`mindspore.Tensor.repeat_interleave`	For details, please refer to `mindspore.ops.repeat_interleave()`.
`mindspore.Tensor.reshape`	For details, please refer to `mindspore.ops.reshape()`.
`mindspore.Tensor.reshape_as`	Change the shape of the Tensor to the shape of other without changing the data.
`mindspore.Tensor.resize`	Changes shape and size of tensor in-place.
`mindspore.Tensor.reverse`	For details, please refer to `mindspore.ops.reverse()`.
`mindspore.Tensor.reverse_sequence`	For details, please refer to `mindspore.ops.reverse_sequence()`.
`mindspore.Tensor.round`	For details, please refer to `mindspore.ops.round()`.
`mindspore.Tensor.roll`	For details, please refer to `mindspore.ops.roll()`.
`mindspore.Tensor.rot90`	Rotate a n-D tensor by 90 degrees in the plane specified by dims axis.
`mindspore.Tensor.scatter_add`	For details, please refer to `mindspore.ops.scatter_add()`.
`mindspore.Tensor.scatter_div`	For details, please refer to `mindspore.ops.scatter_div()`.
`mindspore.Tensor.scatter_max`	For details, please refer to `mindspore.ops.scatter_max()`.
`mindspore.Tensor.scatter_min`	For details, please refer to `mindspore.ops.scatter_min()`.
`mindspore.Tensor.scatter_mul`	For details, please refer to `mindspore.ops.scatter_mul()`.
`mindspore.Tensor.scatter_sub`	Creates a new tensor by subtracting the values from the positions in self tensor indicated by indices, with values from updates.
`mindspore.Tensor.searchsorted`	Finds indices where elements should be inserted to maintain order.
`mindspore.Tensor.select`	For details, please refer to `mindspore.ops.select()`.
`mindspore.Tensor.set_const_arg`	Specify whether the tensor is a constant when it is used for the argument of a network.
`mindspore.Tensor.shape`	For details, please refer to `mindspore.ops.shape()`.
`mindspore.Tensor.short`	Return a copy of the tensor, cast to int16 type, equivalent to self.astype(mstype.int16).
`mindspore.Tensor.sigmoid`	For details, please refer to `mindspore.ops.sigmoid()`.
`mindspore.Tensor.size`	For details, please refer to `mindspore.ops.size()`.
`mindspore.Tensor.soft_shrink`	For details, please refer to `mindspore.ops.soft_shrink()`.
`mindspore.Tensor.split`	For details, please refer to `mindspore.ops.split()`.
`mindspore.Tensor.sqrt`	For details, please refer to `mindspore.ops.sqrt()`.
`mindspore.Tensor.square`	For details, please refer to `mindspore.ops.square()`.
`mindspore.Tensor.squeeze`	For details, please refer to `mindspore.ops.squeeze()`.
`mindspore.Tensor.std`	For details, please refer to `mindspore.ops.std()`.
`mindspore.Tensor.strides`	Return the tuple of bytes to step in each dimension when traversing a tensor.
`mindspore.Tensor.sub`	For details, please refer to `mindspore.ops.sub()`.
`mindspore.Tensor.subtract`	For details, please refer to `mindspore.ops.subtract()`.
`mindspore.Tensor.sum`	Return sum of tensor elements over a given axis.
`mindspore.Tensor.svd`	For details, please refer to `mindspore.ops.svd()`.
`mindspore.Tensor.swapaxes`	Interchange two axes of a tensor.
`mindspore.Tensor.T`	Return the transposed tensor.
`mindspore.Tensor.take`	Takes elements from a tensor along an axis.
`mindspore.Tensor.tan`	For details, please refer to `mindspore.ops.tan()`.
`mindspore.Tensor.tanh`	For details, please refer to `mindspore.ops.tanh()`.
`mindspore.Tensor.tile`	For details, please refer to `mindspore.ops.tile()`.
`mindspore.Tensor.to`	Performs tensor dtype conversion.
`mindspore.Tensor.to_coo`	Convert a Tensor to COOTensor.
`mindspore.Tensor.to_csr`	Convert a Tensor to CSRTensor.
`mindspore.Tensor.to_tensor`	Return init_data() and get the tensor format data of this Tensor.
`mindspore.Tensor.top_k`	For details, please refer to `mindspore.ops.top_k()`.
`mindspore.Tensor.trace`	Return the sum along diagonals of the tensor.
`mindspore.Tensor.transpose`	For details, please refer to `mindspore.ops.transpose()`.
`mindspore.Tensor.triu`	Returns a triangular matrix based on the diagonal.
`mindspore.Tensor.true_divide`	Alias for Tensor.div() with \(rounding\_mode=None\).
`mindspore.Tensor.unbind`	For details, please refer to `mindspore.ops.unbind()`.
`mindspore.Tensor.unfold`	For details, please refer to `mindspore.ops.unfold()`.
`mindspore.Tensor.unique_consecutive`	For details, please refer to `mindspore.ops.unique_consecutive()`.
`mindspore.Tensor.unique_with_pad`	For details, please refer to `mindspore.ops.unique_with_pad()`.
`mindspore.Tensor.unsorted_segment_max`	For details, please refer to `mindspore.ops.unsorted_segment_max()`.
`mindspore.Tensor.unsorted_segment_min`	For details, please refer to `mindspore.ops.unsorted_segment_min()`.
`mindspore.Tensor.unsorted_segment_prod`	For details, please refer to `mindspore.ops.unsorted_segment_prod()`.
`mindspore.Tensor.unsqueeze`	For details, please refer to `mindspore.ops.unsqueeze()`.
`mindspore.Tensor.var`	Compute the variance along the specified axis.
`mindspore.Tensor.view`	Reshape the tensor according to the input shape.
`mindspore.Tensor.xdivy`	For details, please refer to `mindspore.ops.xdivy()`.
`mindspore.Tensor.xlogy`	For details, please refer to `mindspore.ops.xlogy()`.