Coshape

产品支持情况

• Ascend 950PR/Ascend 950DT：支持

• Atlas A3 训练系列产品/Atlas A3 推理系列产品：不支持

• Atlas A2 训练系列产品/Atlas A2 推理系列产品：不支持

• Atlas 200I/500 A2 推理产品：不支持

• Atlas 推理系列产品AI Core：不支持

• Atlas 推理系列产品Vector Core：不支持

• Atlas 训练系列产品：不支持

功能说明

需要包含的头文件为：#include "tensor_api/tensor.h"。

Coshape表示Layout陪域（codomain）区间的标量大小，即逻辑坐标映射到一维索引后，所有可能的索引值构成的区间大小。其计算公式为：

C++

Coshape = Σ( (shape[i] - 1) × stride[i] ) + 1

函数原型

C++

template <size_t... Is, typename Shape, typename Stride>
__aicore__ inline constexpr auto Coshape(const Layout<Shape, Stride>& layout)

参数说明

表1 模板参数说明

参数名	类型	描述
Shape	输入	组成Layout的shape的类型，即元组（tuple）类型。
Stride	输入	组成Layout的stride的类型，即元组（tuple）类型。
Is...	size_t...	索引序列，指定子维度范围，仅对选定维度进行计算。

表2 参数说明

参数名	类型	描述
layout	输入	Layout用于描述张量的布局。

返回值说明

返回Layout的陪域（codomain）的形状。

约束说明

Is...必须为有效范围内的索引。

调用示例

C++

using namespace AscendC::Te;

// 示例1：基础计算
auto layout = MakeLayout(MakeShape(10, 20), MakeStride(1, 100));
auto coshape = Coshape(layout);
// (10-1)*1 + (20-1)*100 + 1 = 9 + 1900 + 1 = 1910

// 示例2：指定子维度
auto coshape0 = Coshape<0>(layout);
// (10-1)*1 + 1 = 9 + 1 = 10

auto coshape1 = Coshape<1>(layout);
// (20-1)*100 + 1 = 1900 + 1 = 1901