PyTorchMetrics MAPE 的数值异常问题解析与正确用法

酷晨姑娘_2313

酷晨姑娘_2313

2026-11-16

801人浏览

原创

PyTorchMetrics MAPE 的数值异常问题解析与正确用法

torchmetrics.MeanAbsolutePercentageError 在真实标签含零时会因未充分防除零而产生极大异常值,其内部 eps=1.17e-06 过小,无法有效抑制分母为零导致的数值爆炸;需手动规避零值或改用自定义稳健实现。

`torchmetrics.meanabsolutepercentageerror` 在真实标签含零时会因未充分防除零而产生极大异常值,其内部 `eps=1.17e-06` 过小,无法有效抑制分母为零导致的数值爆炸;需手动规避零值或改用自定义稳健实现。

在使用 torchmetrics 计算 Mean Absolute Percentage Error(MAPE) 时,若真实标签(ground truth)中存在 0 值,极易触发数值不稳定问题——这正是你观察到 tensor(28490084.) 这类荒谬高值的根本原因。

? 问题根源:eps 不足以应对真实零值

torchmetrics 的 MeanAbsolutePercentageError 实现中确实包含防除零机制,但其默认 eps = 1.17e-06(即 torch.finfo(torch.float32).tiny),仅用于浮点精度保护,并非面向业务场景的“安全分母”设计。当 targets[i] == 0 时,计算项变为:

[ \frac{|pred_i - 0|}{\max(\text{eps},\, 0)} = \frac{|pred_i|}{\text{eps}} \gg 1 ]

例如 pred_i = 2 → 2 / 1.17e-06 ≈ 1.7e6,单个样本即可主导整个 MAPE,完全丧失指标意义。

验证如下(复现你案例):

import torch
import numpy as np
from torchmetrics import MeanAbsolutePercentageError

y_true = torch.tensor([[1, 0, 3], [4, 5, 6]], dtype=torch.float32)
y_pred = torch.tensor([[3, 2, 2], [7, 3, 6]], dtype=torch.float32)

mape_torch = MeanAbsolutePercentageError()
print(mape_torch(y_pred, y_true) * 100)  # 输出: tensor(28490084.)

# 手动用 torchmetrics 内部 eps 复现(等价逻辑)
eps = 1.17e-06
mape_manual = torch.mean(torch.abs(y_pred - y_true) / torch.clamp(y_true, min=eps)) * 100
print(mape_manual)  # 同样输出 ~28490084.

✅ 正确解决方案

✅ 方案一:预处理 —— 屏蔽/过滤零标签样本(推荐用于回归任务)

def safe_mape_torch(preds, targets, eps=1e-3):
    """带业务级 eps 的 MAPE,自动忽略 target==0 的样本"""
    preds, targets = preds.flatten(), targets.flatten()
    valid_mask = targets != 0
    if not valid_mask.any():
        return torch.tensor(float('nan'))

    # 使用合理 eps(如 1e-3)避免极端放大,同时保留非零样本
    denominator = torch.where(valid_mask, targets, torch.tensor(eps))
    errors = torch.abs(preds - targets) / denominator
    return torch.mean(errors[valid_mask]) * 100

# 测试
print(safe_mape_torch(y_pred, y_true))  # 输出: tensor(91.3889) —— 与你的 NumPy 版一致

✅ 方案二:使用 torchmetrics 的 safe=True 参数(v1.3+ 支持)

⚠️ 注意:该参数仅在 torchmetrics>=1.3.0 中可用,且行为是跳过所有 target==0 的样本(非填充 eps):

from torchmetrics import MeanAbsolutePercentageError
mape_safe = MeanAbsolutePercentageError(safe=True)  # 自动忽略零标签样本
print(mape_safe(y_pred, y_true) * 100)  # tensor(91.3889)

❌ 避免方案:强行用极小 eps 补零

不推荐将 eps 设为 1e-8 或更小——它无法解决本质问题,反而使结果对微小扰动极度敏感,违背 MAPE 的可解释性初衷。

PyTorch Linux版 2.11.0
PyTorch Linux版 2.11.0

PyTorch 2.11.0 历史版本下载,来自 PyPI 官方发布,适合旧项目兼容、实验复现和指定环境安装。

下载

? 重要注意事项

  • MAPE 本身不适用于含零真实值的场景:其数学定义要求 y_true > 0。若你的任务中天然存在零(如人脸关键点坐标归零、缺失值标记),请优先考虑替代指标:

    • Mean Absolute Error (MAE)
    • Symmetric MAPE (sMAPE)
    • 分类指标(如关键点检测转为热图 + Dice/IoU)
  • 输入类型务必为 float:torchmetrics.MAPE 对整数张量可能触发隐式类型转换异常,始终显式指定 dtype=torch.float32。

  • 维度一致性:确保 preds 与 targets 形状严格相同(广播不被支持),否则报错而非静默错误。

✅ 总结

torchmetrics.MAPE 的超高值并非 bug,而是其 eps 策略与实际业务零值冲突所致。不要依赖默认 eps 处理语义零。生产环境中,请统一采用 safe=True(新版)或自定义过滤逻辑,并在数据预处理阶段明确约定零值语义——这才是鲁棒指标实践的核心。

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1931

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

5464

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1889

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

33377

23

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3927

5

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3927

5

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1283

5

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

636

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

3043

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程