CANN/asc-devkit WelfordUpdate分块

WelfordUpdate Tiling

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

功能说明

Ascend C提供WelfordUpdate Tiling API，方便用户获取WelfordUpdate kernel计算时所需的Tiling参数。

获取Tiling参数主要步骤如下：

具体为，通过GetWelfordUpdateMaxMinTmpSize获取WelfordUpdate接口计算所需最大和最小临时空间大小。

kernel侧WelfordUpdate接口的计算需要开发者预留/申请临时空间，GetWelfordUpdateMaxMinTmpSize用于在host侧获取预留/申请的最大最小临时空间大小，开发者基于此范围选择合适的空间大小作为Tiling参数传递到kernel侧使用。

• 为保证功能正确，预留/申请的临时空间大小不能小于最小临时空间大小；
• 在最小临时空间-最大临时空间范围内，随着临时空间增大，kernel侧接口计算性能会有一定程度的优化提升。为了达到更好的性能，开发者可以根据实际的内存使用情况进行空间预留/申请。

函数原型

void GetWelfordUpdateMaxMinTmpSize(const ge::Shape& srcShape, const uint32_t typeSizeT, const uint32_t typeSizeU, const bool isReuseSource, const bool isInplace, uint32_t& maxValue, uint32_t& minValue)

参数说明

表1GetWelfordUpdateMaxMinTmpSize接口参数说明

返回值说明

无

约束说明

无

调用示例

1. 将WelfordUpdate Tiling结构体参数增加至TilingData结构体，作为TilingData结构体的一个字段。

   BEGIN_TILING_DATA_DEF(WelfordUpdateCustomTilingData) // 注册一个tiling的类，以tiling的名字作为入参 TILING_DATA_FIELD_DEF(uint32_t, inplace); // 添加tiling字段，output是否复用input TILING_DATA_FIELD_DEF(uint32_t, nLength); TILING_DATA_FIELD_DEF(uint32_t, rLength); TILING_DATA_FIELD_DEF(uint32_t, abComputeLength); TILING_DATA_FIELD_DEF(uint32_t, nRec); END_TILING_DATA_DEF; REGISTER_TILING_DATA_CLASS( WelfordUpdateCustom, WelfordUpdateCustomTilingData) // 将WelfordUpdateCustomTilingData结构体参数增加至TilingData结构体

2. Tiling实现函数中，首先调用GetWelfordUpdateMaxMinTmpSize接口获取WelfordUpdate接口能完成计算所需最大/最小临时空间大小，根据该范围结合实际的内存使用情况设置合适的空间大小，然后根据输入shape、剩余的可供计算的空间大小等信息获取WelfordUpdate kernel侧接口所需tiling参数。

   namespace optiling { static ge::graphStatus TilingFunc(gert::TilingContext* context) { WelfordUpdateCustomTilingData tiling; const gert::RuntimeAttrs* attrs = context->GetAttrs(); const uint32_t inplace = *(attrs->GetAttrPointer<uint32_t>(0)); const uint32_t abComputeLength = *(attrs->GetAttrPointer<uint32_t>(1)); const uint32_t sharedtmpbuffer = *(attrs->GetAttrPointer<uint32_t>(2)); const gert::StorageShape* x1_shape = context->GetInputShape(1); const gert::Shape shape = x1_shape->GetStorageShape(); auto nLength = shape.GetDim(0); auto rLength = shape.GetDim(1); std::vector<int64_t> srcDims = {nLength, rLength}; ge::Shape srcShape(srcDims); uint32_t maxTmpsize = 0; uint32_t minTmpsize = 0; // 本样例中仅作为样例说明，通过GetWelfordUpdateMaxMinTmpSize获取最小值并传入，来保证功能正确，开发者可以根据需要传入合适的空间大小 AscendC::GetWelfordUpdateMaxMinTmpSize(srcShape, 4, 4, false, false, maxTmpsize, minTmpsize); // auto ascendcPlatform = platform_ascendc::PlatformAscendC(context->GetPlatformInfo()); // AscendC::GetWelfordUpdateMaxMinTmpSize(srcShape, 4, 4, false, false, ascendcPlatform, maxTmpsize, minTmpsize); ... // 其他逻辑 context->SetTilingKey(1); tiling.SaveToBuffer(context->GetRawTilingData()->GetData(), context->GetRawTilingData()->GetCapacity()); context->GetRawTilingData()->SetDataSize(tiling.GetDataSize()); size_t* currentWorkspace = context->GetWorkspaceSizes(1); currentWorkspace[0] = 0; return ge::GRAPH_SUCCESS; } } // namespace optiling

3. 对应的kernel侧通过在核函数中调用GET_TILING_DATA获取TilingData，继而将TilingData中的WelfordUpdate Tiling信息传入WelfordUpdate接口参与计算。完整的kernel侧样例请参考WelfordUpdate。

   extern "C" __global__ __aicore__ void welford_update_custom( GM_ADDR inputX_gm, GM_ADDR mean_gm, GM_ADDR var_gm, GM_ADDR outputMean_gm, GM_ADDR outputVariance_gm, GM_ADDR workspace, GM_ADDR tiling) { GET_TILING_DATA(tilingData, tiling); if (TILING_KEY_IS(1)) { if (tilingData.inplace) { KernelWelfordUpdate<DTYPE_INPUTX, DTYPE_U, true> op; op.Init( inputX_gm, mean_gm, var_gm, outputMean_gm, outputVariance_gm, tilingData.nLength, tilingData.rLength, tilingData.abComputeLength); op.Process(); } else { KernelWelfordUpdate<DTYPE_INPUTX, DTYPE_U, false> op; op.Init( inputX_gm, mean_gm, var_gm, outputMean_gm, outputVariance_gm, tilingData.nLength, tilingData.rLength, tilingData.abComputeLength); op.Process(); } } }

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