mindspore.Tensor

class mindspore.Tensor(input_data=None, dtype=None, shape=None, init=None, internal=False, const_arg=False)[源代码]

张量,即存储多维数组(n-dimensional array)的数据结构。

参数:
  • input_data (Union[Tensor, float, int, bool, tuple, list, numpy.ndarray]) - 被存储的数据,可以是其它Tensor,也可以是Python基本数据(如int,float,bool等),或是一个NumPy对象。默认值:None。

  • dtype (mindspore.dtype) - 用于定义该Tensor的数据类型,必须是 mindspore.dtype 中定义的类型。如果该参数为None,则数据类型与 input_data 一致,默认值:None。

  • shape (Union[tuple, list, int]) - 用于定义该Tensor的形状。如果指定了 input_data ,则无需设置该参数。默认值:None。

  • init (Initializer) - 用于在并行模式中延迟Tensor的数据的初始化,如果指定该参数,则 dtypeshape 也必须被指定。不推荐在非自动并行之外的场景下使用该接口。只有当调用 Tensor.init_data 时,才会使用指定的 init 来初始化Tensor数据。默认值:None。

  • internal (bool) - Tensor是否由框架创建。如果为True,表示Tensor是由框架创建的,如果为False,表示Tensor是由用户创建的。默认值:False。

  • const_arg (bool) - 指定该Tensor作为网络输入时是否为常量。默认值:False。

输出:

Tensor。

样例:

>>> 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

详情请参考 mindspore.ops.abs()

mindspore.Tensor.absolute

mindspore.Tensor.abs() 的别名。

mindspore.Tensor.acos

详情请参考 mindspore.ops.acos()

mindspore.Tensor.add

详情请参考 mindspore.ops.add()

mindspore.Tensor.addbmm

详情请参考 mindspore.ops.addbmm()

mindspore.Tensor.addcdiv

详情请参考 mindspore.ops.addcdiv()

mindspore.Tensor.addcmul

详情请参考 mindspore.ops.addcmul()

mindspore.Tensor.addmm

详情请参考 mindspore.ops.addmm()

mindspore.Tensor.addmv

matvec 相乘。

mindspore.Tensor.addr

详情请参考 mindspore.ops.addr()

mindspore.Tensor.adjoint

详情请参考 mindspore.ops.adjoint()

mindspore.Tensor.all

检查在指定轴上所有元素是否均为True。

mindspore.Tensor.amax

详情请参考 mindspore.ops.amax()

mindspore.Tensor.amin

详情请参考 mindspore.ops.amin()

mindspore.Tensor.any

检查在指定轴方向上是否存在任意为True的Tensor元素。

mindspore.Tensor.angle

详情请参考 mindspore.ops.angle()

mindspore.Tensor.approximate_equal

详情请参考 mindspore.ops.approximate_equal()

mindspore.Tensor.arccos

mindspore.Tensor.acos() 的别名。

mindspore.Tensor.arccosh

详情请参考 mindspore.ops.arccosh()

mindspore.Tensor.arcsin

详情请参考 mindspore.ops.arcsin()

mindspore.Tensor.arcsinh

mindspore.Tensor.asinh() 的别名。

mindspore.Tensor.arctan

详情请参考 mindspore.ops.arctan()

mindspore.Tensor.arctan2

详情请参考 mindspore.ops.arctan2()

mindspore.Tensor.arctanh

mindspore.Tensor.atanh() 的别名。

mindspore.Tensor.argmax

详情请参考 mindspore.ops.argmax()

mindspore.Tensor.argmax_with_value

根据指定的索引计算最大值,并返回索引和值。

mindspore.Tensor.argmin

详情请参考 mindspore.ops.argmin()

mindspore.Tensor.argmin_with_value

根据指定的索引计算最小值,并返回索引和值。

mindspore.Tensor.asin

详情请参考 mindspore.ops.asin()

mindspore.Tensor.asinh

详情请参考 mindspore.ops.asinh()

mindspore.Tensor.asnumpy

将张量转换为NumPy数组。

mindspore.Tensor.assign_value

将另一个Tensor的值赋给当前Tensor。

mindspore.Tensor.astype

将Tensor转为指定数据类型,可指定是否返回副本。

mindspore.Tensor.atan

详情请参考 mindspore.ops.atan()

mindspore.Tensor.atan2

详情请参考 mindspore.ops.atan2()

mindspore.Tensor.atanh

详情请参考 mindspore.ops.atanh()

mindspore.Tensor.baddbmm

详情请参考 mindspore.ops.baddbmm()

mindspore.Tensor.bernoulli

详情请参考 mindspore.ops.bernoulli()

mindspore.Tensor.bitwise_and

详情请参考 mindspore.ops.bitwise_and()

mindspore.Tensor.bitwise_or

详情请参考 mindspore.ops.bitwise_or()

mindspore.Tensor.bitwise_xor

详情请参考 mindspore.ops.bitwise_xor()

mindspore.Tensor.bmm

详情请参考 mindspore.ops.bmm()

mindspore.Tensor.bool

将输入Tensor转换为 bool 类型,其中Tensor中的值为0时,则为False;非0时,则为True。

mindspore.Tensor.broadcast_to

详情请参考 mindspore.ops.broadcast_to()

mindspore.Tensor.ceil

详情请参考 mindspore.ops.ceil()

mindspore.Tensor.cholesky

详情请参考 mindspore.ops.cholesky()

mindspore.Tensor.cholesky_inverse

详情请参考 mindspore.ops.cholesky_inverse()

mindspore.Tensor.choose

根据原始Tensor数组和一个索引数组构造一个新的Tensor。

mindspore.Tensor.clip

裁剪Tensor中的值。

mindspore.Tensor.col2im

详情请参考 mindspore.ops.col2im()

mindspore.Tensor.conj

详情请参考 mindspore.ops.conj()

mindspore.Tensor.copy

复制一个Tensor并返回。

mindspore.Tensor.copysign

详情请参考 mindspore.ops.copysign()

mindspore.Tensor.cosh

详情请参考 mindspore.ops.cosh()

mindspore.Tensor.cross

详情请参考 mindspore.ops.cross()

mindspore.Tensor.cummax

详情请参考 mindspore.ops.cummax()

mindspore.Tensor.cummin

详情请参考 mindspore.ops.cummin()

mindspore.Tensor.cumprod

详情请参考 mindspore.ops.cumprod()

mindspore.Tensor.cumsum

详情请参考 mindspore.ops.cumsum()

mindspore.Tensor.deg2rad

详情请参考 mindspore.ops.deg2rad()

mindspore.Tensor.diag

详情请参考 mindspore.ops.diag()

mindspore.Tensor.diagonal

详情请参考 mindspore.ops.diagonal()

mindspore.Tensor.div

详情请参考 mindspore.ops.div()

mindspore.Tensor.divide

详情请参考 mindspore.ops.div()

mindspore.Tensor.dtype

返回张量的数据类型(mindspore.dtype)。

mindspore.Tensor.equal

详情请参考 mindspore.ops.equal()

mindspore.Tensor.erf

详情请参考 mindspore.ops.erf()

mindspore.Tensor.erfc

详情请参考 mindspore.ops.erfc()

mindspore.Tensor.erfinv

详情请参考 mindspore.ops.erfinv()

mindspore.Tensor.exp

详情请参考 mindspore.ops.exp()

mindspore.Tensor.expand

详情请参考 mindspore.ops.expand()

mindspore.Tensor.expand_as

将目标张量的维度扩展为输入张量的维度。

mindspore.Tensor.expand_dims

详情请参考 mindspore.ops.expand_dims()

mindspore.Tensor.expm1

详情请参考 mindspore.ops.expm1()

mindspore.Tensor.fill

详情请参考 mindspore.ops.fill()

mindspore.Tensor.flatten

详情请参考 mindspore.ops.flatten()

mindspore.Tensor.flip

详情请参考 mindspore.ops.flip()

mindspore.Tensor.fliplr

详情请参考 mindspore.ops.fliplr()

mindspore.Tensor.flipud

详情请参考 mindspore.ops.flipud()

mindspore.Tensor.float

将输入Tensor转换为 float32 类型。

mindspore.Tensor.floor

详情请参考 mindspore.ops.floor()

mindspore.Tensor.flush_from_cache

如果Tensor开启缓存作用,则将缓存数据刷新到host侧。

mindspore.Tensor.fold

详情请参考 mindspore.ops.fold()

mindspore.Tensor.from_numpy

将Numpy数组转换为张量。

mindspore.Tensor.gather

详情请参考 mindspore.ops.gather()

mindspore.Tensor.gather_elements

详情请参考 mindspore.ops.gather_elements()

mindspore.Tensor.gather_nd

详情请参考 mindspore.ops.gather_nd()

mindspore.Tensor.ge

详情请参考 mindspore.ops.ge()

mindspore.Tensor.ger

详情请参考 mindspore.ops.ger()

mindspore.Tensor.greater

详情请参考 mindspore.ops.greater()

mindspore.Tensor.greater_equal

详情请参考 mindspore.ops.greater_equal()

mindspore.Tensor.gt

详情请参考 mindspore.ops.gt()

mindspore.Tensor.half

将输入Tensor转换为 float16 类型。

mindspore.Tensor.hardshrink

详情请参考 mindspore.ops.hardshrink()

mindspore.Tensor.has_init

Tensor是否已经初始化。

mindspore.Tensor.heaviside

详情请参考 mindspore.ops.heaviside()

mindspore.Tensor.hypot

详情请参考 mindspore.ops.hypot()

mindspore.Tensor.i0

详情请参考 mindspore.ops.i0()

mindspore.Tensor.igamma

详情请参考 mindspore.ops.igamma()

mindspore.Tensor.igammac

详情请参考 mindspore.ops.igammac()

mindspore.Tensor.index_add

详情请参考 mindspore.ops.index_add()

mindspore.Tensor.index_fill

详情请参考 mindspore.ops.index_fill()

mindspore.Tensor.init_data

获取此Tensor的数据。

mindspore.Tensor.inplace_update

详情请参考 mindspore.ops.inplace_update()

mindspore.Tensor.int

将输入Tensor转换为 int32 类型,其中Tensor中的值为浮点数时,则会丢弃小数部分。

mindspore.Tensor.inv

详情请参考 mindspore.ops.inv()

mindspore.Tensor.invert

详情请参考 mindspore.ops.invert()

mindspore.Tensor.isclose

详情请参考 mindspore.ops.isclose()

mindspore.Tensor.isfinite

详情请参考 mindspore.ops.isfinite()

mindspore.Tensor.is_floating_point

详情请参考 mindspore.ops.is_floating_point()

mindspore.Tensor.isinf

详情请参考 mindspore.ops.isinf()

mindspore.Tensor.isnan

详情请参考 mindspore.ops.isnan()

mindspore.Tensor.is_signed

判断输入Tensor的dtype是否是有符号数类型。

mindspore.Tensor.item

获取Tensor中指定索引的元素。

mindspore.Tensor.itemset

将标量插入到Tensor(并将标量转换为Tensor的数据类型)。

mindspore.Tensor.itemsize

返回一个Tensor元素的长度(以字节为单位)。

mindspore.Tensor.lcm

详情请参考 mindspore.ops.lcm()

mindspore.Tensor.ldexp

详情请参考 mindspore.ops.ldexp()

mindspore.Tensor.le

详情请参考 mindspore.ops.le()

mindspore.Tensor.lerp

详情请参考 mindspore.ops.lerp()

mindspore.Tensor.less

详情请参考 mindspore.ops.less()

mindspore.Tensor.less_equal

详情请参考 mindspore.ops.less_equal()

mindspore.Tensor.log

详情请参考 mindspore.ops.log()

mindspore.Tensor.log10

详情请参考 mindspore.ops.log10()

mindspore.Tensor.log2

详情请参考 mindspore.ops.log2()

mindspore.Tensor.logaddexp

详情请参考 mindspore.ops.logaddexp()

mindspore.Tensor.logaddexp2

详情请参考 mindspore.ops.logaddexp2()

mindspore.Tensor.logsumexp

详情请参考 mindspore.ops.logsumexp()

mindspore.Tensor.log1p

详情请参考 mindspore.ops.log1p()

mindspore.Tensor.logical_and

详情请参考 mindspore.ops.logical_and()

mindspore.Tensor.logical_not

详情请参考 mindspore.ops.logical_not()

mindspore.Tensor.logical_or

详情请参考 mindspore.ops.logical_or()

mindspore.Tensor.logical_xor

详情请参考 mindspore.ops.logical_xor()

mindspore.Tensor.logit

详情请参考 mindspore.ops.logit()

mindspore.Tensor.long

将输入Tensor转换为 int64 类型,其中Tensor中的值为浮点数时,则会丢弃小数部分。

mindspore.Tensor.masked_fill

详情请参考 mindspore.ops.masked_fill()

mindspore.Tensor.masked_select

详情请参考 mindspore.ops.masked_select()

mindspore.Tensor.max

返回Tensor的最大值或轴方向上的最大值。

mindspore.Tensor.mean

详情请参考 mindspore.ops.mean()

mindspore.Tensor.median

详情请参考 mindspore.ops.median()

mindspore.Tensor.min

详情请参考 mindspore.ops.min()

mindspore.Tensor.minimum

详情请参考 mindspore.ops.minimum()

mindspore.Tensor.multiply

更多参考详见 mindspore.ops.multiply()

mindspore.Tensor.narrow

详情请参考 mindspore.ops.narrow()

mindspore.Tensor.nbytes

返回Tensor占用的总字节数。

mindspore.Tensor.ndim

返回Tensor维度的数量。

mindspore.Tensor.ndimension

mindspore.Tensor.ndim() 的别名。

mindspore.Tensor.negative

详情请参考 mindspore.ops.negative()

mindspore.Tensor.nelement

mindspore.Tensor.numel() 的别名。

mindspore.Tensor.numel

详情请参考 mindspore.ops.numel()

mindspore.Tensor.nonzero

详情请参考 mindspore.ops.nonzero()

mindspore.Tensor.norm

详情请参考 mindspore.ops.norm()

mindspore.Tensor.permute

详情请参考 mindspore.ops.permute()

mindspore.Tensor.positive

详情请参考 mindspore.ops.positive()

mindspore.Tensor.pow

详情请参考 mindspore.ops.pow()

mindspore.Tensor.prod

详情请参考 mindspore.ops.prod()

mindspore.Tensor.ptp

该函数名称是"peak to peak"的缩写。

mindspore.Tensor.rad2deg

详情请参考 mindspore.ops.rad2deg()

mindspore.Tensor.random_categorical

详情请参考 mindspore.ops.random_categorical()

mindspore.Tensor.ravel

返回一个展开的一维Tensor。

mindspore.Tensor.remainder

详情请参考 mindspore.ops.remainder()

mindspore.Tensor.renorm

详情请参考 mindspore.ops.renorm()

mindspore.Tensor.repeat

对数组中的元素进行重复复制。

mindspore.Tensor.repeat_interleave

详情请参考 mindspore.ops.repeat_interleave()

mindspore.Tensor.reshape

详情请参考 mindspore.ops.reshape()

mindspore.Tensor.reshape_as

不改变数据的情况下,将Tensor的shape改为 other 的shape。

mindspore.Tensor.resize

将Tensor改为输入的新shape,并将不足的元素补0。

mindspore.Tensor.reverse

详情请参考 mindspore.ops.reverse()

mindspore.Tensor.reverse_sequence

详情请参考 mindspore.ops.reverse_sequence()

mindspore.Tensor.round

详情请参考 mindspore.ops.round()

mindspore.Tensor.roll

详情请参考 mindspore.ops.roll()

mindspore.Tensor.rot90

沿轴指定的平面内将n-D Tensor旋转90度。

mindspore.Tensor.scatter_add

详情请参考 mindspore.ops.scatter_add()

mindspore.Tensor.scatter_div

详情请参考 mindspore.ops.scatter_div()

mindspore.Tensor.scatter_max

详情请参考 mindspore.ops.scatter_max()

mindspore.Tensor.scatter_min

详情请参考 mindspore.ops.scatter_min()

mindspore.Tensor.scatter_mul

详情请参考 mindspore.ops.scatter_mul()

mindspore.Tensor.scatter_sub

根据指定的更新值和输入索引,通过减法进行运算,将结果赋值到输出Tensor中。

mindspore.Tensor.searchsorted

查找应插入元素在有序数列中的位置索引。

mindspore.Tensor.select

详情请参考 mindspore.ops.select()

mindspore.Tensor.set_const_arg

指定该Tensor在作为网络入参时是否是一个常量。

mindspore.Tensor.shape

详情请参考 mindspore.ops.shape()

mindspore.Tensor.short

将输入Tensor转换为 int16 类型并返回一个拷贝,与 self.astype(mstype.int16) 等价,其中Tensor中的值为浮点数时,则会丢弃小数部分,具体请参考 mindspore.Tensor.astype()

mindspore.Tensor.sigmoid

详情请参考 mindspore.ops.sigmoid()

mindspore.Tensor.size

详情请参考 mindspore.ops.size()

mindspore.Tensor.soft_shrink

详情请参考 mindspore.ops.soft_shrink()

mindspore.Tensor.split

详情请参考 mindspore.ops.split()

mindspore.Tensor.sqrt

详情请参考 mindspore.ops.sqrt()

mindspore.Tensor.square

详情请参考 mindspore.ops.square()

mindspore.Tensor.squeeze

详情请参考 mindspore.ops.squeeze()

mindspore.Tensor.std

详情请参考 mindspore.ops.std()

mindspore.Tensor.strides

Tensor上每个维度跨度的字节元组。

mindspore.Tensor.sub

详情请参考 mindspore.ops.sub()

mindspore.Tensor.subtract

详情请参考 mindspore.ops.subtract()

mindspore.Tensor.sum

返回指定维度上数组元素的总和。

mindspore.Tensor.svd

详情请参考 mindspore.ops.svd()

mindspore.Tensor.swapaxes

交换Tensor的两个维度。

mindspore.Tensor.T

返回转置后的Tensor。

mindspore.Tensor.take

在指定维度上获取Tensor中的元素。

mindspore.Tensor.tan

详情请参考 mindspore.ops.tan()

mindspore.Tensor.tanh

详情请参考 mindspore.ops.tanh()

mindspore.Tensor.tile

详情请参考 mindspore.ops.tile()

mindspore.Tensor.to

执行Tensor类型的转换。

mindspore.Tensor.to_coo

将常规Tensor转为稀疏化的COOTensor。

mindspore.Tensor.to_csr

将常规Tensor转为稀疏化的CSRTensor。

mindspore.Tensor.to_tensor

返回init_data()的结果,并获取此Tensor的数据。

mindspore.Tensor.top_k

详情请参考 mindspore.ops.top_k()

mindspore.Tensor.trace

在Tensor的对角线方向上的总和。

mindspore.Tensor.transpose

详情请参考 mindspore.ops.transpose()

mindspore.Tensor.triu

根据对角线返回相应的三角矩阵。

mindspore.Tensor.true_divide

mindspore.Tensor.div()\(rounding\_mode=None\) 的别名。

mindspore.Tensor.unbind

详情请参考 mindspore.ops.unbind()

mindspore.Tensor.unfold

详情请参考 mindspore.ops.unfold()

mindspore.Tensor.unique_consecutive

详情请参考 mindspore.ops.unique_consecutive()

mindspore.Tensor.unique_with_pad

详情请参考 mindspore.ops.unique_with_pad()

mindspore.Tensor.unsorted_segment_max

详情请参考 mindspore.ops.unsorted_segment_max()

mindspore.Tensor.unsorted_segment_min

详情请参考 mindspore.ops.unsorted_segment_min()

mindspore.Tensor.unsorted_segment_prod

详情请参考 mindspore.ops.unsorted_segment_prod()

mindspore.Tensor.unsqueeze

详情请参考 mindspore.ops.unsqueeze()

mindspore.Tensor.var

在指定维度上的方差。

mindspore.Tensor.view

根据输入shape重新创建一个Tensor,与原Tensor数据相同。

mindspore.Tensor.xdivy

详情请参考 mindspore.ops.xdivy()

mindspore.Tensor.xlogy

详情请参考 mindspore.ops.xlogy()