GetSelectWithBytesMaskMaxMinTmpSize
功能说明
kernel侧SelectWithBytesMask接口的计算需要开发者申请临时空间，本接口用于在host侧获取申请的最大最小临时空间大小，开发者基于此范围选择合适的空间大小作为Tiling参数传递到kernel侧使用。
- 为保证功能正确，申请的临时空间大小不能小于最小临时空间大小；
- 在最小临时空间-最大临时空间范围内，随着临时空间增大，kernel侧接口计算性能会有一定程度的优化提升。为了达到更好的性能，开发者可以根据实际的内存使用情况进行空间申请。
函数原型
1 | uint32_t GetSelectWithBytesMaskMinTmpSize(const ge::Shape &src0Shape, const ge::Shape &src1Shape, const uint32_t srcTypeSize, const ge::Shape &maskShape, const uint32_t maskTypeSize, const bool isReuseMask) |
1 | uint32_t GetSelectWithBytesMaskMaxTmpSize(const ge::Shape &src0Shape, const ge::Shape &src1Shape, const uint32_t srcTypeSize, const ge::Shape &maskShape, const uint32_t maskTypeSize, const bool isReuseMask) |
1 | void GetSelectWithBytesMaskMaxMinTmpSize(const ge::Shape &src0Shape, const ge::Shape &src1Shape, const uint32_t srcTypeSize, const ge::Shape &maskShape, const uint32_t maskTypeSize, const bool isReuseMask, uint32_t &maxValue, uint32_t &minValue) |
参数说明
接口 |
输入/输出 |
功能 |
|---|---|---|
src0Shape |
输入 |
输入src0的shape信息。src0为scalar时，shape应为{1}。 |
src1Shape |
输入 |
输入src1的shape信息。src1为scalar时，shape应为{1}。 |
srcTypeSize |
输入 |
输入srcTensor的数据类型大小，比如数据类型为half，此处应传入2。 |
maskShape |
输入 |
输入maskTensor的shape信息。 |
maskTypeSize |
输入 |
输入maskTensor的数据类型大小，比如数据类型为bool，此处应传入1。 |
isReuseMask |
输入 |
是否复用maskTensor输入的空间。与kernel侧保持一致。 |
maxValue |
输出 |
SelectWithBytesMask接口能完成计算所需最大临时空间大小。 说明：
maxValue仅作为参考值，有可能大于Unified Buffer剩余空间的大小，该场景下，开发者需要根据Unified Buffer剩余空间的大小来选取合适的临时空间大小。 |
minValue |
输出 |
SelectWithBytesMask接口能完成计算所需最小临时空间大小。 |
返回值
GetSelectWithBytesMaskMinTmpSize返回SelectWithBytesMask接口能完成计算所需最小临时空间大小。
GetSelectWithBytesMaskMaxTmpSize返回SelectWithBytesMask接口能完成计算所需最大临时空间大小。
GetSelectWithBytesMaskMaxMinTmpSize无返回值。
调用示例
std::vector<int64_t> shape0Vec = {64, 128};
std::vector<int64_t> shape1Vec = {1};
std::vector<int64_t> mask1Vec = {64, 128};
ge::Shape src0Shape(shape0Vec);
ge::Shape src1Shape(shape1Vec);
ge::Shape maskShape(maskShape);
uint32_t maxValue = 0;
uint32_t minValue = 0;
AscendC::GetSelectWithBytesMaskMaxMinTmpSize(src0Shape, src1Shape, 2, maskShape, 1, false, maxValue, minValue);