box_convert

torchvision.ops.box_convert(boxes: Tensor, in_fmt: str, out_fmt: str) → Tensor

Converts torch.Tensor boxes from a given in_fmt to out_fmt.

Note

For converting a torch.Tensor or a BoundingBoxes object between different formats, consider using convert_bounding_box_format() instead. Or see the corresponding transform ConvertBoundingBoxFormat().

Supported in_fmt and out_fmt strings are:

'xyxy': boxes are represented via corners, x1, y1 being top left and x2, y2 being bottom right. This is the format that torchvision utilities expect.

'xywh': boxes are represented via corner, width and height, x1, y2 being top left, w, h being width and height.

'cxcywh': boxes are represented via centre, width and height, cx, cy being center of box, w, h being width and height.

Parameters:

• boxes (Tensor[N, 4]) – boxes which will be converted.

• in_fmt (str) – Input format of given boxes. Supported formats are [‘xyxy’, ‘xywh’, ‘cxcywh’].

• out_fmt (str) – Output format of given boxes. Supported formats are [‘xyxy’, ‘xywh’, ‘cxcywh’]

Returns:

Boxes into converted format.

Return type:

Tensor[N, 4]