企业官网建设流程全解析

AdaptiveAvgPool3D 算子 API 描述

【免费下载链接】cann-bench评测AI在处理CANN领域代码任务的能力，涵盖算子生成、算子优化等领域，支撑模型选型、训练效果评估，统一量化评估标准，识别Agent能力短板，构建CANN领域评测平台，推动AI能力在CANN领域的持续演进。项目地址: https://gitcode.com/cann/cann-bench

1. 算子简介

完成输入张量的3D自适应平均池化计算。

主要应用场景：

• 3D 视频特征的空间和时间维度自适应降采样
• 点云和体素数据的空间压缩
• 全局平均池化（output_size=1）用于分类网络的特征聚合
• 不同分辨率输入统一到固定尺寸输出

算子特征：

• 难度等级：L3（Reduction）
• 单输入单输出，输入为 [N, C, D, H, W] 5维张量，输出空间维度由 output_size 决定

2. 算子定义

数学公式

$$ y = \text{adaptive_avg_pool3d}(x, \text{output_size}) $$

自适应平均池化根据目标输出尺寸自动计算每个输出位置对应的池化窗口大小和步长，对窗口内元素取平均值。对于每个输出位置 $(d, h, w)$，其对应的输入区域由 output_size 和输入尺寸共同决定。

3. 接口规范

算子原型

cann_bench.adaptive_avg_pool3_d(Tensor x, list[int] output_size) -> Tensor y

输入参数说明

输出

数据类型

规则与约束

• 输入必须为5维张量，shape 格式为 [N, C, D, H, W]
• output_size 指定输出的空间维度大小
• 输出 dtype 与输入 dtype 一致
• 输出的 N 和 C 维度与输入保持一致，仅空间维度 (D, H, W) 发生变化

4. 精度要求

采用生态算子精度标准进行验证。

误差指标：

1. 平均相对误差（MERE）：采样点中相对误差平均值

   $$ \text{MERE} = \text{avg}(\frac{\text{abs}(actual - golden)}{\text{abs}(golden)+\text{1e-7}}) $$

2. 最大相对误差（MARE）：采样点中相对误差最大值

   $$ \text{MARE} = \max(\frac{\text{abs}(actual - golden)}{\text{abs}(golden)+\text{1e-7}}) $$

通过标准：

当平均相对误差 MERE < Threshold，最大相对误差 MARE < 10 * Threshold 时判定为通过。

5. 标准 Golden 代码

import torch """ AdaptiveAvgPool3D算子Torch Golden参考实现 完成输入张量的3D自适应平均池化计算 公式: y = adaptive_avg_pool3d(x, output_size) """ def adaptive_avg_pool3_d( x: torch.Tensor, output_size: tuple[int, int, int] ) -> torch.Tensor: """ 完成输入张量的3D自适应平均池化计算 公式: y = adaptive_avg_pool3d(x, output_size) Args: x: 输入张量，shape 为 [N, C, D, H, W] output_size: 输出尺寸，格式为 (output_d, output_h, output_w) Returns: 输出张量，池化结果 """ y = torch.nn.functional.adaptive_avg_pool3d(x, output_size) return y

6. 额外信息

算子调用示例

import torch import cann_bench x = torch.randn(2, 32, 16, 64, 64, dtype=torch.float16, device="npu") y = cann_bench.adaptive_avg_pool3_d(x, [8, 8, 8]) # 自适应池化到 8x8x8 x = torch.randn(2, 64, 32, 128, 128, dtype=torch.float32, device="npu") y = cann_bench.adaptive_avg_pool3_d(x, [1, 1, 1]) # 全局平均池化

【免费下载链接】cann-bench评测AI在处理CANN领域代码任务的能力，涵盖算子生成、算子优化等领域，支撑模型选型、训练效果评估，统一量化评估标准，识别Agent能力短板，构建CANN领域评测平台，推动AI能力在CANN领域的持续演进。项目地址: https://gitcode.com/cann/cann-bench