---
title: LogSoftMax Tiling
description: "kernel侧LogSoftMax接口的计算需要开发者预留/申请临时空间，以下接口用于在host侧获取预留/申请的最大最小临时空间大小，开发者基于此范围选择合适的空间大小，并调用LogSoftMaxTilingFunc函数获取reduceSize，splitSize等参数，作为Tiling参数传递到kernel侧使用。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/ascendcopapi/atlasascendc_api_07_0769.html
sourcePath: /source/zh/canncommercial/900/API/ascendcopapi/atlasascendc_api_07_0769.html
indexId: a035e47fb1cc05e172266d4d5421185b9bd8368856df516957c4e913abe0899d76
---
# LogSoftMax Tiling

#### 功能说明

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

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


#### 函数原型

- 获取Kernel接口计算所需最大/最小临时空间的接口
  1 uint32_t GetLogSoftMaxMaxTmpSize(const ge::Shape srcShape, const uint32_t dataTypeSize, const bool isReuseSource)

  1 uint32_t GetLogSoftMaxMinTmpSize(const ge::Shape srcShape, const uint32_t dataTypeSize, const bool isReuseSource)


- Tiling计算接口
  1 void LogSoftMaxTilingFunc(const ge::Shape srcShape, const uint32_t dataTypeSize, const uint32_t localWorkSpaceSize, optiling::LogSoftMaxTiling& softmaxTiling)

  1 void LogSoftMaxTilingFunc(const ge::Shape srcShape, const uint32_t dataTypeSize, const uint32_t localWorkSpaceSize, AscendC::tiling::LogSoftMaxTiling& softmaxTiling)


#### 参数说明


**表1 GetLogSoftMaxMaxTmpSize/GetLogSoftMaxMinTmpSize接口参数列表**

| 接口 | 输入/输出 | 功能 |
| --- | --- | --- |
| srcShape | 输入 | 输入的shape信息。 |
| dataTypeSize | 输入 | 输入的数据类型大小，单位为字节。比如输入的数据类型为half，此处应传入2。 |
| isReuseSource | 输入 | 是否复用源操作数输入的空间，与LogSoftMax接口一致。 |


**表2 LogSoftMaxTilingFunc接口参数列表**

| 接口 | 输入/输出 | 功能 |
| --- | --- | --- |
| srcShape | 输入 | 输入的shape信息。 |
| dataTypeSize | 输入 | 输入的数据类型大小，单位为字节。比如输入的数据类型为half，此处应传入2。 |
| localWorkSpaceSize | 输入 | 输入的临时空间大小。 |
| softmaxTiling | 输出 | 传递到kernel侧使用的Tiling参数。 |


#### 返回值说明

GetLogSoftMaxMaxTmpSize/GetLogSoftMaxMinTmpSize接口返回值为最大/最小临时空间。

LogSoftMaxTilingFunc接口无返回值。


#### 约束说明

无


#### 调用示例

```
// shape：输入的shape信息
// dtypesize：输入的数据类型大小，单位为字节

// 定义 LogSoftMax 算子的 Tiling 参数结构体实例
AscendC::tiling::LogSoftMaxTiling tilingData;
// 是否复用源操作数输入的空间，与LogSoftMax接口一致
bool isReuseSource = false;

// 获取计算所需最大临时空间
const uint32_t tmpsize = AscendC::GetLogSoftMaxMaxTmpSize(shape, dtypesize, isReuseSource);
// 计算最优分片策略并填充到tilingData结构体中，供Kernel端使用。
AscendC::LogSoftMaxTilingFunc(shape, dtypesize, tmpsize, tilingData);
```