CANN/asc-devkit Where条件选择API-三亩地-编程学习日记

Where

【免费下载链接】asc-devkit本项目是CANN 推出的昇腾AI处理器专用的算子程序开发语言，原生支持C和C++标准规范，主要由类库和语言扩展层构成，提供多层级API，满足多维场景算子开发诉求。项目地址: https://gitcode.com/cann/asc-devkit

产品支持情况

产品	是否支持
Ascend 950PR/Ascend 950DT	√
Atlas A3 训练系列产品 / Atlas A3 推理系列产品	x
Atlas A2 训练系列产品 / Atlas A2 推理系列产品	x

功能说明

根据指定的条件，从两个源操作数中选择元素，生成目标操作数。两个源操作数均可以是LocalTensor或标量。

函数原型

template <typename T, typename U, typename S, typename V> __aicore__ inline void Where(const LocalTensor<T>& dst, const U& src0, const S& src1, const LocalTensor<V>& condition, const uint32_t count)

参数说明

表 1模板参数说明

参数名	描述
T	目的操作数数据类型。 Ascend 950PR/Ascend 950DT，支持的数据类型为：bool、int8_t、uint8_t、int16_t、uint16_t、half、bfloat16_t、int32_t、uint32_t、float、int64_t、uint64_t。
U	LocalTensor类型或标量类型。根据输入参数src0自动推导类型，开发者无需配置该参数，保证src0的数据类型与目的操作数保持一致即可。
S	LocalTensor类型或标量类型。根据输入参数src1自动推导类型，开发者无需配置该参数，保证src1的数据类型与目的操作数保持一致即可。
V	条件的数据类型，当前支持的数据类型为：bool。

表 2参数说明

参数名称	类型	说明
dst	输出	目的操作数。类型为LocalTensor，支持的TPosition为VECIN/VECCALC/VECOUT。
src0、src1	输入	源操作数。类型为标量或LocalTensor，当类型为LocalTensor时，支持的TPosition为VECIN/VECCALC/VECOUT。数据类型需要与目的操作数保持一致。
condition	输入	条件操作数。类型为LocalTensor，支持的TPosition为VECIN/VECCALC/VECOUT。
count	输入	参与计算的元素个数。

返回值说明

无

约束说明

不支持源操作数与目的操作数地址重叠。
操作数地址偏移对齐要求请参见通用说明和约束。

调用示例

AscendC::LocalTensor<half> dst, src0, src1; AscendC::LocalTensor<bool> condition; uint32_t count = 512; AscendC::Where(dst, src0, src1, condition, count);

结果示例如下：

输入数据（src0）: [1, 2, 3, ... 511, 512] 输入数据（src1）: [-1, -2, -3, ... -511, -512] 条件输入数据（condition）: [0, 1, 0, ... 0, 1] 输出数据（dst）: [-1, 2, -3, ... -511, 512]

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

日记详情

CANN/asc-devkit Where条件选择API