Contiguous

Availability

Atlas training product

Atlas A2 training product/Atlas A2 inference product

Atlas 200I/500 A2 inference product

Atlas A3 training product/Atlas A3 inference product

Atlas inference product

Function Usage

Converts a non-contiguous tensor into a contiguous tensor. This function is a public L0 API.

An input tensor of L2 API may be non-contiguous, while an L0 operator supports only a contiguous tensor as the input. Therefore, the tensor needs to be converted into a contiguous tensor before being used as the input of another L0 operator.

An input tensor can be contiguous, which will be processed in the API for better compatibility.

Prototype

const aclTensor *Contiguous(const aclTensor *x, aclOpExecutor *executor)

Parameters

Returns

Success: A contiguous aclTensor is returned. Failure: nullptr is returned.

Constraints

The input tensor must be valid. The shape and stride data must be within the storage range. For example, if shape = (2, 3), stride = (10, 30), storageSize = 8, the actual data exceeds the storage size (8). Therefore, the tensor is invalid, and nullptr is returned by the Contiguous API.

Examples

1
2
3
4

// (Fixed writing) Create an OpExecutor.
auto uniqueExecutor = CREATE_EXECUTOR();
// If self is non-contiguous, conversion is required.
auto selfContiguous = l0op::Contiguous(self, executor);