bool[N]#

产品支持情况#

Ascend 950PR/Ascend 950DT：支持

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

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

功能说明#

在TilingData类中声明定长同构数组字段。元素类型限定为int、float或bool，分别映射为IR类型INDEX、FP32、BOOL。

数组字段在IR中表示为包含N个标量元素的嵌套Tuple。例如offsets: int[4]对应一个包含4个INDEX元素的Tuple字段。

函数原型#

int[N]     # N 个 INDEX 元素
float[N]   # N 个 FP32 元素
bool[N]    # N 个 BOOL 元素

参数类型#

参数	输入/输出	说明
元素类型	输入	仅限`int`、`float`、`bool`
`N`	输入	数组长度，正整数

参数范围#

参数	输入/输出	说明
元素类型	输入	`int` → `DataType.INDEX` `float` → `DataType.FP32` `bool` → `DataType.BOOL` 不支持其他元素类型
`N`	输入	取值范围为1～2048，必须直接写出整数值 `N <= 0`、`N > 2048`、布尔值或变量均为非法配置

补充说明#

使用int[N]、float[N]或bool[N]标注时，文件开头须包含from __future__ import annotations，使字段标注以字符串形式保留并由PyPTO解析。

运行时使用普通Python序列为数组字段赋值，序列长度必须与声明的N一致：

tiling = MyTiling(m=64, n=128, offsets=[0, 64, 128, 192])

在Kernel中可通过下标访问数组元素，也可以先读取整个数组字段再访问。常量下标越界时编译报错；数组元素类型相同时，也支持使用运行时下标。

first_offset = tiling.offsets[0]
offsets = tiling.offsets
current_offset = offsets[index]

调用示例#

以下代码展示TilingData类声明和Kernel内字段访问片段：

from __future__ import annotations

from dataclasses import dataclass

import pypto_pro.language as pl


@dataclass
class MyTiling:
    m: int
    n: int
    offsets: int[4]


@pl.jit()
def kernel(
    x: pl.Tensor[[64, 128], pl.DT_FP16],
    out: pl.Tensor[[64, 128], pl.DT_FP16],
    tiling: MyTiling,
):
    m = tiling.m
    n = tiling.n
    first_offset = tiling.offsets[0]
    ...

运行时传入tiling实例：

tiling = MyTiling(m=64, n=128, offsets=[0, 64, 128, 192])
kernel(x, out, tiling)