PyTorchMetrics MAPE 异常高值问题解析与正确使用指南

小静小哥_7745

小静小哥_7745

2026-11-16

267人浏览

原创

PyTorchMetrics MAPE 异常高值问题解析与正确使用指南

torchmetrics.MeanAbsolutePercentageError 在真实标签含零时会因极小 epsilon(1.17e-06)导致分母趋近于零,从而产生极大异常值;需手动规避零值或自定义 epsilon,或改用更稳健的实现。

pytorchmetrics mape 异常高值问题解析与正确使用指南:`torchmetrics.meanabsolutepercentageerror` 在真实标签含零时会因极小 epsilon(1.17e-06)导致分母趋近于零,从而产生极大异常值;需手动规避零值或自定义 epsilon,或改用更稳健的实现。

MeanAbsolutePercentageError(MAPE)是回归任务中常用的相对误差指标,其标准公式为:

$$ \text{MAPE} = \frac{100\%}{n} \sum_{i=1}^{n} \left| \frac{y_i - \hat{y}_i}{y_i} \right| $$

但该公式在 $ y_i = 0 $ 时无定义。为避免除零错误,torchmetrics 内部引入了数值稳定项 eps,但其默认值仅为 1.17e-06(即 torch.finfo(torch.float32).eps),远小于典型标签量级(如人脸关键点坐标、归一化像素值等)。当真实标签中存在 0 时,分母被替换为 max(|y_i|, eps) → 实际变为 eps,导致单个样本误差项飙升至 $ \left| \frac{y_i - \hat{y}_i}{\text{eps}} \right| $ 级别(例如 |1−3| / 1.17e-06 ≈ 1.7e6),最终 MAPE 失控。

验证如下:使用你提供的数据 y_true = [[1, 0, 3], [4, 5, 6]],y_pred = [[3, 2, 2], [7, 3, 6]],其中第二元素 y_true[0,1] == 0,torchmetrics 将其分母视为 1.17e-06,造成主导性偏差。而你的自定义函数使用 epsilon=1,使该项误差变为 |2−0|/1 = 2,整体可控。

✅ 正确解决方案:

PyTorch Linux版 2.11.0
PyTorch Linux版 2.11.0

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

下载
  1. 显式传入更大 eps(推荐):torchmetrics 的 MeanAbsolutePercentageError 支持 absolut 和 epsilon 参数(注意:epsilon 是构造器参数,非调用时传入):
    from torchmetrics import MeanAbsolutePercentageError
    import torch

mape_metric = MeanAbsolutePercentageError(epsilon=1.0) # 关键:设为业务可接受的最小真值量级 preds = torch.tensor([[3, 2, 2], [7, 3, 6]], dtype=torch.float32) targets = torch.tensor([[1, 0, 3], [4, 5, 6]], dtype=torch.float32)

result = mape_metric(preds, targets) * 100 print(result) # 输出: tensor(91.3889) —— 与你的自定义函数一致

2. **预处理过滤或平滑零值(谨慎使用)**:若零值确属无效标签(如缺失关键点),可在计算前掩码排除:
```python
def safe_mape(preds, targets, epsilon=1e-3):
    preds, targets = preds.flatten(), targets.flatten()
    valid_mask = targets != 0
    if not valid_mask.any():
        return torch.tensor(float('nan'))
    abs_errors = torch.abs(preds[valid_mask] - targets[valid_mask])
    rel_errors = abs_errors / torch.clamp(targets[valid_mask], min=epsilon)
    return (rel_errors.mean() * 100).item()

⚠️ 重要注意事项:

  • 不要混淆参数顺序:torchmetrics.MAPE 的调用签名是 mape(preds, targets),其中 preds 是模型输出(预测值),targets 是真实标签(ground truth)——与你代码中 calculate_mape_torch(y_pred, y_true) 一致,但需确保张量类型为 float(整数张量可能触发隐式精度问题);
  • 若任务本质是离散分类(如身份 ID 预测),请勿强行使用 MAPE;应选用 Accuracy、F1Score 等分类指标;
  • 对于人脸关键点回归等场景,若坐标允许为零(如左上角原点),建议统一归一化到 (0,1] 区间,或采用 MeanSquaredError / MeanAbsoluteError 等绝对误差指标,避免 MAPE 的固有缺陷。

总结:torchmetrics 的 MAPE 并非“bug”,而是对数值稳定性采取了保守策略;理解其 epsilon=1.17e-06 的设计意图,并根据实际数据分布主动设置合理 epsilon,即可获得可靠、可复现的结果。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

pytorch

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
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

热门下载

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

精品课程

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