<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/models/blob/v2.20.0/official/vision/ops/box_ops.py#L617-L670) |

Calculates the overlap between proposal and ground truth boxes.

    tfm.vision.box_ops.bbox_overlap(
        boxes, gt_boxes
    )

Some `boxes` or `gt_boxes` may have been padded. The returned `iou` tensor
for these boxes will be -1.

<br />

<br />

<br />

| ## Args ||
|---|---|
| `boxes` | a tensor with a shape of \[batch_size, N, 4\]. N is the number of proposals before groundtruth assignment (e.g., rpn_post_nms_topn). The last dimension is the pixel coordinates in \[ymin, xmin, ymax, xmax\] form. |
| `gt_boxes` | a tensor with a shape of \[batch_size, MAX_NUM_INSTANCES, 4\]. This tensor might have paddings with a negative value. |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| `iou` | a tensor with as a shape of \[batch_size, N, MAX_NUM_INSTANCES\]. |

<br />