LCOV - code coverage report
Current view: top level - legacy/ascend910/framework/hcom/gradient_segment - gradient_segment.cc (source / functions) Coverage Total Hit
Test: coverage.info Lines: 1.1 % 177 2
Test Date: 2026-08-18 17:47:01 Functions: 23.1 % 13 3

            Line data    Source code
       1              : /**
       2              :  * Copyright (c) 2025 Huawei Technologies Co., Ltd.
       3              :  * This program is free software, you can redistribute it and/or modify it under the terms and conditions of
       4              :  * CANN Open Software License Agreement Version 2.0 (the "License").
       5              :  * Please refer to the License for details. You may not use this file except in compliance with the License.
       6              :  * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
       7              :  * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT, MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE.
       8              :  * See LICENSE in the root of the software repository for the full text of the License.
       9              :  */
      10              : 
      11              : #include "gradient_segment.h"
      12              : #include <math.h>
      13              : #include "externalinput_pub.h"
      14              : 
      15              : namespace hccl {
      16              : 
      17            1 : GradientSegment::GradientSegment() : shapeType_(OriginalGraphShapeType::KNOWN_SHAPE) {}
      18              : 
      19            2 : GradientSegment::~GradientSegment() {}
      20              : 
      21            0 : HcclResult GradientSegment::GetGradientSegmentExecutor(
      22              :     const std::string& group, const struct model_feature* feature, std::vector<u32>& segment_index,
      23              :     bool& isUseFusionLib, GradSplitForceMode force, OriginalGraphShapeType shapeType)
      24              : {
      25            0 :     CHK_PRT_RET(
      26              :         group.empty(), HCCL_ERROR("[GradientSegment][GetGradientSegmentExecutor]params invalid, group is empty"),
      27              :         HCCL_E_PARA);
      28            0 :     CHK_PTR_NULL(feature);
      29            0 :     isUseFusionLib = false;
      30            0 :     std::vector<u32> segList;
      31            0 :     std::vector<float> accumGradList;
      32            0 :     u32 featGradNum = feature->gradient_num;
      33            0 :     shapeType_ = shapeType;
      34              :     // 根据每层数据量,计算每层的累积数据量list
      35            0 :     accumGradList.push_back(feature->gradient_size[0]);
      36            0 :     for (u32 gradIdx = 1; gradIdx < featGradNum; gradIdx++) {
      37            0 :         float accumGrad = accumGradList.back() + feature->gradient_size[gradIdx];
      38            0 :         accumGradList.push_back(accumGrad);
      39              :     }
      40              :     // 获取基于梯度数据量的切分策略
      41            0 :     HcclResult ret = GetSegmentBySize(group, featGradNum, segList, accumGradList);
      42            0 :     if (ret != HCCL_SUCCESS) {
      43            0 :         if (ret != HCCL_E_PARA) {
      44              :             // 获取基于梯度层数的切分策略
      45            0 :             bool bSplitBySize = true;
      46            0 :             if (force == GradSplitForceMode::FORCE_SIZE) {
      47            0 :                 bSplitBySize = true;
      48            0 :                 HCCL_INFO("force split gradient segment by built-in size ratio.");
      49              :             } else {
      50            0 :                 bSplitBySize = (GetSegmentByIndex(group, featGradNum, segList) != HCCL_SUCCESS);
      51              :             }
      52            0 :             if (bSplitBySize) { // 基于数据量进行默认切分
      53            0 :                 isUseFusionLib = true;
      54            0 :                 CHK_RET(GetSegmentByDefaultRatio(accumGradList, featGradNum, segList));
      55              :             }
      56              :         } else {
      57            0 :             return HCCL_E_PARA;
      58              :         }
      59              :     }
      60            0 :     if (segList.size() > 0) {
      61            0 :         segment_index = segList;
      62              :     } else {
      63            0 :         HCCL_ERROR("[Get][GradientSegmentExecutor]segList is empty.");
      64            0 :         return HCCL_E_PARA;
      65              :     }
      66            0 :     return HCCL_SUCCESS;
      67            0 : }
      68              : 
      69            0 : HcclResult GradientSegment::GetSegmentByDefaultRatio(
      70              :     const std::vector<float>& accumGradList, u32 featGradNum, std::vector<u32>& segList)
      71              : {
      72            0 :     if (shapeType_ == OriginalGraphShapeType::UNKNOWN_SHAPE) {
      73            0 :         CHK_RET(GetFixedSizeSegmentByDefaultRatio(accumGradList, featGradNum, segList));
      74              :     } else {
      75            0 :         CHK_RET(GetTwoSegmentByDefaultRatio(accumGradList, featGradNum, segList));
      76              :     }
      77              : 
      78            0 :     return HCCL_SUCCESS;
      79              : }
      80              : 
      81            0 : HcclResult GradientSegment::GetTwoSegmentByDefaultRatio(
      82              :     const std::vector<float>& accumGradList, u32 featGradNum, std::vector<u32>& segList)
      83              : {
      84            0 :     std::vector<u32> segTempList;
      85            0 :     float gradSize = (GRADIENT_SEGMENT_SIZE_RATIO / GRADIENT_TOTAL_SIZE_RATIO) * accumGradList[featGradNum - 1];
      86            0 :     float allocGradSize = 0;
      87            0 :     float preSizeLeft = 0;
      88            0 :     HcclResult ret = GetSplitResInEachSegment(accumGradList, gradSize, segTempList, allocGradSize, preSizeLeft);
      89            0 :     CHK_PRT_RET(
      90              :         ret != HCCL_SUCCESS,
      91              :         HCCL_ERROR(
      92              :             "[Get][TwoSegmentByDefaultRatio]errNo[0x%016llx] get gradIdx with [%f]%% datasize "
      93              :             "fail",
      94              :             HCCL_ERROR_CODE(HCCL_E_PARA), GRADIENT_SEGMENT_SIZE_RATIO),
      95              :         HCCL_E_PARA);
      96              : 
      97            0 :     segList.push_back(segTempList[0]);
      98            0 :     if (featGradNum >= (segList[0] + 2)) { // 将得到梯度索引值加2与总梯度长比较,判断能否切第二段
      99            0 :         segList.push_back(featGradNum - 1); // 通过减1得到最后一层索引将第二段放入切分策略list
     100              :     }
     101            0 :     HCCL_DEBUG("<gradient segment size default result>");
     102            0 :     return HCCL_SUCCESS;
     103            0 : }
     104              : 
     105            0 : HcclResult GradientSegment::GetFixedSizeSegmentByDefaultRatio(
     106              :     const std::vector<float>& accumGradList, u32 featGradNum, std::vector<u32>& segList)
     107              : {
     108              :     std::vector<float> segmentSizeRatio
     109            0 :         = {GRADIENT_SEGMENT_SIZE_RATIO, (GRADIENT_TOTAL_SIZE_RATIO - GRADIENT_SEGMENT_SIZE_RATIO)};
     110            0 :     std::vector<float> segmentSize;
     111            0 :     CHK_PRT_RET(
     112              :         accumGradList.empty(), HCCL_ERROR("[Get][FixedSizeSegmentByDefaultRatio]accumGradList empty, fail"),
     113              :         HCCL_E_PARA);
     114              :     // 按默认切分方式切分两段,计算每段的数据量大小
     115            0 :     CHK_RET(CheckAndConfigSegment(segmentSizeRatio, accumGradList[featGradNum - 1], segmentSize));
     116              : 
     117            0 :     float allocGradSize = 0;
     118            0 :     float preSizeLeft = 0;
     119            0 :     for (u32 inputIdx = 0; inputIdx < segmentSize.size(); inputIdx++) {
     120              :         // 根据比例不一定能完整切分,将前一段中剩余未切分的梯度数据量累加到下一段中
     121            0 :         segmentSize[inputIdx] += preSizeLeft;
     122              :         HcclResult ret
     123            0 :             = GetSplitResInEachSegment(accumGradList, segmentSize[inputIdx], segList, allocGradSize, preSizeLeft);
     124            0 :         CHK_PRT_RET(
     125              :             ret != HCCL_SUCCESS,
     126              :             HCCL_ERROR(
     127              :                 "[Get][FixedSizeSegmentByDefaultRatio]errNo[0x%016llx] get gradIdx with [%u] "
     128              :                 "segment fail",
     129              :                 HCCL_ERROR_CODE(HCCL_E_PARA), inputIdx),
     130              :             HCCL_E_PARA);
     131            0 :         if (segList.back() == (featGradNum - 1)) {
     132            0 :             break;
     133              :         }
     134              :     }
     135            0 :     if (segList.back() < (featGradNum - 1)) {
     136            0 :         HCCL_WARNING("the last segment point[%u] is less than feednum[%u]", segList.back(), featGradNum - 1);
     137            0 :         segList.push_back(featGradNum - 1);
     138              :     }
     139            0 :     if (segList.empty()) {
     140            0 :         HCCL_ERROR("[Get][FixedSizeSegmentByDefaultRatio]<segList is empty>");
     141            0 :         return HCCL_E_PARA;
     142              :     }
     143            0 :     return HCCL_SUCCESS;
     144            0 : }
     145              : 
     146              : HcclResult
     147            0 : GradientSegment::GetSegmentByIndex(const std::string& group, u32 featGradNum, std::vector<u32>& segList) const
     148              : {
     149              :     (void)featGradNum;
     150            0 :     std::unique_lock<std::mutex> segmentIdxMapLock(g_segmentIdxMapLock);
     151            0 :     auto gsearch = g_segmentIdxMap.find(group); // 读取用户基于梯度层数的切分方案
     152            0 :     if (gsearch != g_segmentIdxMap.end()) {
     153            0 :         segList.assign(gsearch->second.begin(), gsearch->second.end());
     154              :     } else {
     155            0 :         return HCCL_E_NOT_FOUND;
     156              :     }
     157            0 :     segmentIdxMapLock.unlock();
     158            0 :     HCCL_DEBUG("<gradient segment user set index result>");
     159            0 :     return HCCL_SUCCESS;
     160            0 : }
     161              : 
     162            0 : HcclResult GradientSegment::GetSegmentBySize(
     163              :     const std::string& group, u32 featGradNum, std::vector<u32>& segList, const std::vector<float>& accumGradList)
     164              : {
     165              :     HcclResult ret;
     166            0 :     CHK_PRT_RET(accumGradList.empty(), HCCL_ERROR("[Get][SegmentBySize]accumGradList empty, fail"), HCCL_E_PARA);
     167            0 :     std::unique_lock<std::mutex> segmentSizeMapLock(g_segmentSizeMapLock);
     168            0 :     float totalSize = accumGradList[featGradNum - 1];
     169            0 :     auto gSizeSearch = g_segmentSizeMap.find(group); // 读取用户基于梯度数据量的切分方案
     170            0 :     if (gSizeSearch != g_segmentSizeMap.end()) {
     171            0 :         if (gSizeSearch->second.size() != 0) {
     172            0 :             std::vector<float> segmentSize;
     173            0 :             CHK_RET(CheckAndConfigSegment(gSizeSearch->second, totalSize, segmentSize));
     174            0 :             float allocGradSize = 0;
     175            0 :             float preSizeLeft = 0;
     176            0 :             for (u32 inputIdx = 0; inputIdx < segmentSize.size(); inputIdx++) {
     177              :                 // 根据比例不一定能完整切分,将前一段中剩余未切分的梯度数据量累加到下一段中
     178            0 :                 segmentSize[inputIdx] += preSizeLeft;
     179            0 :                 ret = GetSplitResInEachSegment(
     180            0 :                     accumGradList, segmentSize[inputIdx], segList, allocGradSize, preSizeLeft);
     181            0 :                 CHK_PRT_RET(
     182              :                     ret != HCCL_SUCCESS,
     183              :                     HCCL_ERROR(
     184              :                         "[Get][SegmentBySize]errNo[0x%016llx] get gradIdx with segment [%u] fail",
     185              :                         HCCL_ERROR_CODE(HCCL_E_PARA), inputIdx),
     186              :                     HCCL_E_PARA);
     187            0 :                 if (segList.back() == (featGradNum - 1)) {
     188            0 :                     break;
     189              :                 }
     190              :             }
     191            0 :             if (segList.empty()) {
     192            0 :                 HCCL_ERROR("[Get][SegmentBySize]<segList is empty>");
     193            0 :                 return HCCL_E_PARA;
     194              :             } else {
     195            0 :                 HCCL_DEBUG("<gradient segment user set size result>");
     196            0 :                 return HCCL_SUCCESS;
     197              :             }
     198            0 :         }
     199              :     }
     200            0 :     return HCCL_E_NOT_FOUND;
     201            0 : }
     202              : 
     203            0 : HcclResult GradientSegment::CheckAndConfigSegment(
     204              :     std::vector<float>& segmentSizeProportion, float totalSize, std::vector<float>& segmentSize) const
     205              : {
     206            0 :     float proportion = 0;
     207            0 :     float gradSize = 0;
     208              : 
     209            0 :     for (u32 inputIdx = 0; inputIdx < segmentSizeProportion.size(); inputIdx++) {
     210            0 :         proportion = segmentSizeProportion[inputIdx];
     211            0 :         gradSize = (proportion / GRADIENT_TOTAL_SIZE_RATIO) * totalSize;
     212            0 :         segmentSize.push_back(gradSize);
     213              :     }
     214            0 :     return HCCL_SUCCESS;
     215              : }
     216              : 
     217            0 : HcclResult GradientSegment::GetSplitResInEachSegment(
     218              :     const std::vector<float>& accumGradList, float gradSize, std::vector<u32>& segList, float& allocGradSize,
     219              :     float& preSizeLeft)
     220              : {
     221            0 :     bool bRet = accumGradList.size() == 0;
     222            0 :     CHK_PRT_RET(
     223              :         bRet,
     224              :         HCCL_ERROR(
     225              :             "[Get][SplitResInEachSegment]errNo[0x%016llx] accumGradList is empty!", HCCL_ERROR_CODE(HCCL_E_PARA)),
     226              :         HCCL_E_PARA);
     227            0 :     u64 cclBufferSize = GetExternalInputCCLBuffSize() - CCL_COMM_INBUFFER_UNALIGNED_RESERVE_SIZE;
     228            0 :     float commInputSize = static_cast<float>(cclBufferSize);
     229            0 :     float curSize = 0;
     230            0 :     float sizeLeft = gradSize;
     231            0 :     float allocGradSizeTmp = allocGradSize;
     232            0 :     u32 featGradNum = accumGradList.size();
     233            0 :     u32 segGradIdx = 0;
     234              :     while (1) {
     235            0 :         if (shapeType_ == OriginalGraphShapeType::UNKNOWN_SHAPE) {
     236            0 :             curSize = (sizeLeft > commInputSize) ? commInputSize : sizeLeft;
     237            0 :             curSize += allocGradSize;
     238              :         } else {
     239            0 :             curSize = sizeLeft + allocGradSize;
     240              :         }
     241              : 
     242            0 :         CHK_RET(GetIdxByBinarySearch(accumGradList, curSize, segGradIdx));
     243              : 
     244            0 :         if (segList.size() > 0 && segGradIdx <= segList.back()) {
     245            0 :             segGradIdx = segGradIdx + 1;
     246              :         }
     247            0 :         if (segGradIdx == featGradNum) {
     248            0 :             HCCL_ERROR("[Get][SplitResInEachSegment]segGradIdx[%u] already on the last layer", segList.back());
     249            0 :             return HCCL_E_PARA;
     250              :         }
     251            0 :         segList.push_back(segGradIdx);
     252            0 :         HCCL_DEBUG("<segment index print:[%u]>", segGradIdx);
     253              : 
     254              :         // 更新当前段内已分配的梯度数据量和当前段中剩余未分配完的梯度量
     255            0 :         allocGradSize = accumGradList[segGradIdx];
     256            0 :         sizeLeft = gradSize + allocGradSizeTmp - allocGradSize;
     257              :         // 满足两个条件退出循环:1,切分到最后一层  2,剩余的梯度量已无法切分
     258            0 :         if (segGradIdx == (featGradNum - 1)) {
     259            0 :             break;
     260            0 :         } else if (segGradIdx < (featGradNum - 1)) {
     261            0 :             if (((accumGradList[segGradIdx + 1] - accumGradList[segGradIdx]) - sizeLeft) > 1e-6) {
     262            0 :                 break;
     263              :             }
     264              :         }
     265            0 :     }
     266              :     // 更新大段已分配的梯度数据量和当前段中剩余未分配完的梯度量
     267            0 :     preSizeLeft = sizeLeft;
     268            0 :     return HCCL_SUCCESS;
     269              : }
     270              : 
     271              : HcclResult
     272            0 : GradientSegment::GetIdxByBinarySearch(const std::vector<float>& accumGradList, const float& curSize, u32& segGradIdx)
     273              : {
     274            0 :     s32 lowIdx = 0;
     275            0 :     s32 midIdx = 0;
     276            0 :     s32 highIdx = accumGradList.size() - 1;
     277              :     // 二分法找到有序数据量list中第一个大于等于curSize大小的索引
     278            0 :     while (lowIdx <= highIdx) {
     279            0 :         midIdx = (lowIdx + highIdx) / 2;                         // 通过除2得到前后索引的中间值
     280            0 :         if (std::fabs(accumGradList[midIdx] - curSize) < 1e-6) { // 中间值等于curSize则直接返回当前索引
     281            0 :             segGradIdx = static_cast<u32>(midIdx);
     282            0 :             return HCCL_SUCCESS;
     283            0 :         } else if (accumGradList[midIdx] > curSize) {
     284            0 :             highIdx = midIdx - 1;
     285              :         } else {
     286            0 :             lowIdx = midIdx + 1;
     287              :         }
     288              :     }
     289              :     /* 动态shape并且二分极限数据量始终小于curSize时,直接返回当前的idx,多1会溢出 */
     290            0 :     if ((shapeType_ == OriginalGraphShapeType::UNKNOWN_SHAPE) && (accumGradList[midIdx] < curSize)) {
     291            0 :         segGradIdx = static_cast<u32>(midIdx);
     292            0 :         return HCCL_SUCCESS;
     293              :     }
     294              :     /* 没找到对应数据量的index,找接近此数据量的index */
     295            0 :     HcclResult ret = GetNearIdxByDataSize(accumGradList, segGradIdx, curSize, midIdx);
     296            0 :     CHK_PRT_RET(
     297              :         ret != HCCL_SUCCESS,
     298              :         HCCL_ERROR(
     299              :             "[Get][IdxByBinarySearch]errNo[0x%016llx] get near Idx with [%f]%% datasize fail",
     300              :             HCCL_ERROR_CODE(HCCL_E_PARA), curSize),
     301              :         HCCL_E_PARA);
     302            0 :     return HCCL_SUCCESS;
     303              : }
     304              : 
     305            0 : HcclResult GradientSegment::GetNearIdxByDataSize(
     306              :     const std::vector<float>& accumGradList, u32& segGradIdx, float gradSize, s32 midIdx) const
     307              : {
     308            0 :     if (midIdx == 0) { // 如果当前索引在最开始则直接返回
     309            0 :         segGradIdx = static_cast<u32>(midIdx);
     310            0 :         return HCCL_SUCCESS;
     311              :     }
     312              : 
     313            0 :     if (shapeType_ == OriginalGraphShapeType::UNKNOWN_SHAPE) {
     314            0 :         segGradIdx = static_cast<u32>(midIdx) - 1;
     315              :     } else {
     316              :         // 判断前一个index和当前midIdx哪个位置的数据量与需要百分比数据量更为接近, 返回更接近的那个索引
     317            0 :         CHK_PRT_RET(
     318              :             accumGradList.empty(), HCCL_ERROR("[Get][NearIdxByDataSize]accumGradList empty, fail"), HCCL_E_PARA);
     319            0 :         float prevIdxGradDiff = gradSize - accumGradList[midIdx - 1];
     320            0 :         float idxGradDiff = accumGradList[midIdx] - gradSize;
     321            0 :         segGradIdx = (prevIdxGradDiff <= idxGradDiff) ? static_cast<u32>(midIdx) - 1 : static_cast<u32>(midIdx);
     322            0 :         HCCL_DEBUG("datasize: getIndex[%d] prevDiff[%.1f] curDiff[%.1f]", midIdx, prevIdxGradDiff, idxGradDiff);
     323              :     }
     324            0 :     return HCCL_SUCCESS;
     325              : }
     326              : } // namespace hccl
        

Generated by: LCOV version 2.0-1