Function: set_tensor_format

Applicability

Product	Supported (√/x)
Atlas A3 training products/Atlas A3 inference products	√
Atlas A2 training products/Atlas A2 inference products	√
Atlas training products	x
Atlas inference products	√
Atlas 200I/500 A2 inference products	√

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.

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 Ascend AI Processor. Along the process, the operator shape is also inferred to facilitate internal computation.

Prototype

C Prototype

aclError aclSetTensorFormat(aclTensorDesc *desc, aclFormat format)

Python Function

ret = acl.set_tensor_format(desc, format)

Parameter Description

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

Parameter

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 Description

Return Value	Description
ret	Int, error code. 0: success. Other values: failure.

Parent topic: aclmdlTensorDesc