CANN/GE Tensor张量类API文档
2026/5/30 21:48:39 网站建设 项目流程

Tensor

【免费下载链接】geGE(Graph Engine)是面向昇腾的图编译器和执行器,提供了计算图优化、多流并行、内存复用和模型下沉等技术手段,加速模型执行效率,减少模型内存占用。 GE 提供对 PyTorch、TensorFlow 前端的友好接入能力,并同时支持 onnx、pb 等主流模型格式的解析与编译。项目地址: https://gitcode.com/cann/ge

产品支持情况

产品是否支持
Atlas A3 训练系列产品/Atlas A3 推理系列产品
Atlas A2 训练系列产品/Atlas A2 推理系列产品

模块导入

from ge.graph import Tensor

功能说明

Tensor 类是张量数据类,支持通过内存数据或文件创建张量。支持设置和获取张量的格式(Format)、数据类型(DataType)、形状(Shape)、数据(TensorLike)以及放置位置(Placement)。张量支持在 Host 和 Device 之间迁移。

函数原型

构造函数

Tensor(data=None, file_path=None, data_type=DataType.DT_FLOAT, format=Format.FORMAT_ND, shape=None, placement=Placement.PLACEMENT_HOST)

属性

@property format -> Format
@property data_type -> DataType
@property shape -> Shape
@property data -> TensorLike
@property placement -> Placement

方法

set_format(format: Format) -> Tensor
get_format() -> Format
set_data_type(data_type: DataType) -> Tensor
get_data_type() -> DataType
get_shape() -> Shape
get_data() -> TensorLike
get_tensor_desc() -> TensorDesc
get_placement() -> Placement
to_host() -> Tensor
to_device() -> Tensor

参数说明

构造函数参数

参数名类型是否必选说明
dataUnion[List[int], List[float], List[bool], None]内存数据,通过列表传入张量数据。与 file_path 二选一,不能同时指定。
file_pathUnion[str, None]文件路径,从文件读取张量数据。与 data 二选一,不能同时指定。
data_typeDataType张量的数据类型,使用 DataType 枚举值,默认值为 DataType.DT_FLOAT。
formatFormat张量的数据格式,使用 Format 枚举值,默认值为 Format.FORMAT_ND。
shapeUnion[List[int], None]张量的形状,用整数列表表示各维度大小。若为 None,表示标量。
placementPlacement张量的放置位置,使用 Placement 枚举值,默认值为 Placement.PLACEMENT_HOST。

set_format 参数

参数名类型是否必选说明
formatFormat目标数据格式,使用 Format 枚举值。

set_data_type 参数

参数名类型是否必选说明
data_typeDataType目标数据类型,使用 DataType 枚举值。

返回值说明

构造函数

返回 Tensor 对象实例。

属性返回值

属性返回类型说明
formatFormat张量的数据格式。
data_typeDataType张量的数据类型。
shapeShape张量的形状信息。
dataTensorLike张量的数据内容。标量返回单个数值,非标量返回嵌套列表结构。
placementPlacement张量的放置位置。

方法返回值

方法返回类型说明
set_formatTensor返回自身,支持链式调用。
get_formatFormat返回张量的数据格式。
set_data_typeTensor返回自身,支持链式调用。
get_data_typeDataType返回张量的数据类型。
get_shapeShape返回张量的形状信息。
get_dataTensorLike返回张量的数据内容。标量返回单个数值,非标量返回嵌套列表结构。
get_tensor_descTensorDesc返回张量的描述信息(TensorDesc 对象)。
get_placementPlacement返回张量的放置位置。
to_hostTensor返回自身,将张量从 Device 迁移到 Host。
to_deviceTensor返回自身,将张量从 Host 迁移到 Device。

约束说明

  • 构造张量时,data 和 file_path 只能指定其中一个,不能同时指定,也不能都不指定(都不指定时创建空张量)。
  • 支持的数据类型包括:DT_FLOAT、DT_FLOAT16、DT_INT8、DT_INT32、DT_UINT8、DT_INT16、DT_UINT16、DT_UINT32、DT_INT64、DT_UINT64、DT_BOOL。不支持 DT_DOUBLE。
  • shape 参数必须为整数列表(list of int),若为 None 则表示标量。
  • placement 参数必须为 Placement 枚举值。
  • Tensor 不支持拷贝(copy)和深拷贝(deepcopy)。
  • to_host() 仅适用于当前位于 Device 的张量;to_device() 仅适用于当前位于 Host 的张量。

【免费下载链接】geGE(Graph Engine)是面向昇腾的图编译器和执行器,提供了计算图优化、多流并行、内存复用和模型下沉等技术手段,加速模型执行效率,减少模型内存占用。 GE 提供对 PyTorch、TensorFlow 前端的友好接入能力,并同时支持 onnx、pb 等主流模型格式的解析与编译。项目地址: https://gitcode.com/cann/ge

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询