Function: set_tensor_format

C Prototype

aclError aclSetTensorFormat(aclTensorDesc *desc, aclFormat format)

Python Function

ret = acl.set_tensor_format(desc, format)

Function Usage

Call acl.set_tensor_format to set the format of a tensor when the tensor is processed in an Ascend AI Processor after a tensor description is created by the acl.create_tensor_desc call. This API is mainly used in the PyTorch scenarios.

The Atlas Training Series Product does not support this API.

NOTE:

For example, if the original operator shape is 4D with format NHWC or 5D with format NDHWC, the format is automatically converted to NC1HWC0 or NDC1HWC0 during model conversion or online network build to facilitate data access efficiency on the Ascend AI Processor. Along the process, the operator shape is also inferred to facilitate internal computation.

Input Description

desc: int, pointer address of the tensor description data.

Call acl.create_tensor_desc to create data of the aclTensorDesc type in advance.

format: int, format of the specified tensor description.

Return Value

ret: int, error code.

Restrictions

None