yolo_loss

paddle.vision.ops. yolo_loss ( x, gt_box, gt_label, anchors, anchor_mask, class_num, ignore_thresh, downsample_ratio, gt_score=None, use_label_smooth=True, name=None, scale_x_y=1.0 ) [源代码]

该运算通过给定的预测结果和真实框计算 YOLOv3 损失。

YOLOv3 loss 前的网络输出形状为[N，C，H，W]，H 和 W 应该相同，用来指定网格(grid)大小。每个网格点预测 S 个边界框(bounding boxes)，S 由每个尺度中 anchors 簇的个数指定。在第二维（表示通道的维度）中，C 的值应为 S *（class_num + 5），class_num 是源数据集的对象种类数（如 coco 中为 80），另外，除了存储 4 个边界框位置坐标 x，y，w，h，还包括边界框以及每个 anchor 框的 one-hot 关键字的置信度得分。 假设有四个表征位置的坐标为 \(t_x, t_y, t_w, t_h\)，那么边界框的预测将会如下定义：

$$ b_x = \sigma(t_x) + c_x $$ $$ b_y = \sigma(t_y) + c_y $$ $$ b_w = p_w e^{t_w} $$ $$ b_h = p_h e^{t_h} $$

在上面的等式中，\(c_x, c_y\) 是当前网格的左上角，\(p_w, p_h\) 由 anchors 指定。 置信度得分是 anchor 框和真实框之间的 IoU 的逻辑回归值，anchor 框的得分最高为 1，此时该 anchor 框对应着最大 IoU。 如果 anchor 框之间的 IoU 大于忽略阀值 ignore_thresh，则该 anchor 框的置信度评分损失将会被忽略。

因此，YOLOv3 损失包括三个主要部分，框位置损失，目标性损失，分类损失。L1 损失用于 框坐标（w，h），同时，sigmoid 交叉熵损失用于框坐标（x，y），目标性损失和分类损失。

每个真实框将在所有 anchor 中找到最匹配的 anchor，对该 anchor 的预测将会计算全部（三种）损失，但是没有匹配 GT box(ground truth box 真实框)的 anchor 的预测只会产生目标性损失。

为了权衡大框(box)和小框(box)之间的框坐标损失，框坐标损失将与比例权重相乘而得。即：

$$ weight_{box} = 2.0 - t_w * t_h $$

最后的 loss 值将如下计算：

$$ loss = (loss_{xy} + loss_{wh}) * weight_{box} + loss_{conf} + loss_{class} $$

当 use_label_smooth 为 True 时，在计算分类损失时将平滑分类目标，将正样本的目标平滑到 1.0-1.0 / class_num，并将负样本的目标平滑到 1.0 / class_num。

gt_score （如果存在）表示真实框的 mixup 得分，那么真实框所产生的所有损失需要乘上 gt_score 。

参数

  • x (Tensor) - YOLOv3 损失运算的输入 Tensor，这是一个形状为[N，C，H，W]的四维 Tensor。H 和 W 应该相同，第二维（C）存储框的位置信息，以及每个 anchor box 的置信度得分和 one-hot 分类。数据类型为 float32 或 float64。

  • gt_box (Tensor) - 真实框，应该是[N，B，4]的形状。第三维用来承载 x、y、w、h，其中 x, y 是真实框的中心坐标，w, h 是框的宽度和高度，且 x、y、w、h 将除以输入图片的尺寸，缩放到[0,1]区间内。N 是 batch size，B 是图像中所含有的的最多的 box 数目。数据类型为 float32 或 float64。

  • gt_label (Tensor) - 真实框的类 id，应该形为[N，B]。数据类型为 int32。

  • anchors (list|tuple) - 指定 anchor 框的宽度和高度，它们将逐对进行解析

  • anchor_mask (list|tuple) - 当前 YOLOv3 损失计算中使用 anchor 的 mask 索引

  • class_num (int) - 要预测的类别数

  • ignore_thresh (float) - 一定条件下忽略某框置信度损失的忽略阈值

  • downsample_ratio (int) - 网络输入到 YOLOv3 loss 输入的下采样率，因此第一，第二和第三个 loss 的下采样率应分别为 32、16、8。

  • gt_score (Tensor，可选) - 真实框的混合得分，形为[N，B]。默认 None。数据类型为 float32 或 float64。

  • use_label_smooth (bool，可选) - 是否使用平滑标签。默认为 True

  • name (str，可选) - 具体用法请参见 Name，一般无需设置，默认值为 None。

  • scale_x_y (float，可选) - 缩放解码边界框的中心点。默认值：1.0。

返回

Tensor，yolov3 损失的值，具有形状[N]的 1-D Tensor。

代码示例

>>> import paddle
>>> x = paddle.rand([2, 14, 8, 8]).astype('float32')
>>> gt_box = paddle.rand([2, 10, 4]).astype('float32')
>>> gt_label = paddle.rand([2, 10]).astype('int32')
>>> loss = paddle.vision.ops.yolo_loss(x,
...                                    gt_box=gt_box,
...                                    gt_label=gt_label,
...                                    anchors=[10, 13, 16, 30],
...                                    anchor_mask=[0, 1],
...                                    class_num=2,
...                                    ignore_thresh=0.7,
...                                    downsample_ratio=8,
...                                    use_label_smooth=True,
...                                    scale_x_y=1.)