Skip to content

pixano.features.utils.boxes

denormalize_coords(coord, height, width, rounded_int=True)

Denormalize coordinates.

Parameters:

Name Type Description Default
coord list[float]

Normalized coordinates.

 required
height int

Height.

 required
width int

Width.

 required
rounded_int bool

True to round denormalized float to nearest integer.

 True

Returns:

Type Description
list[float]

Unnormalized coordinates.
Source code in pixano/features/utils/boxes.py 
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
def denormalize_coords(coord: list[float], height: int, width: int, rounded_int: bool = True) -> list[float]:
    """Denormalize coordinates.

    Args:
        coord: Normalized coordinates.
        height: Height.
        width: Width.
        rounded_int: True to round denormalized float to nearest integer.

    Returns:
        Unnormalized coordinates.
    """
    denorm = []

    for i, c in enumerate(coord):
        if i % 2 == 0:
            denorm.append(round(c * width) if rounded_int else c * width)
        else:
            denorm.append(round(c * height) if rounded_int else c * height)

    return denorm

mask_to_bbox(mask)

Return the smallest bounding box containing all the mask pixels.

Parameters:

Name Type Description Default
mask ndarray

Mask as NumPy Array.

 required

Returns:

Type Description
list[float]

Normalized xywh bounding box.
Source code in pixano/features/utils/boxes.py 
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
def mask_to_bbox(mask: np.ndarray) -> list[float]:
    """Return the smallest bounding box containing all the mask pixels.

    Args:
        mask: Mask as NumPy Array.

    Returns:
        Normalized xywh bounding box.
    """
    height, width = mask.shape
    bool_mask = np.array(mask).astype(bool)

    # Find all columns and rows that contain ones
    rows = np.any(bool_mask, axis=1)
    cols = np.any(bool_mask, axis=0)

    # Find the min and max col/row index that contain ones
    rmin, rmax = np.where(rows)[0][[0, -1]]
    cmin, cmax = np.where(cols)[0][[0, -1]]

    # Calculate bbox height and width
    w = (cmax - cmin + 1) / width
    h = (rmax - rmin + 1) / height

    return [cmin / width, rmin / height, w, h]

normalize_coords(coord, height, width)

Normalize coordinates.

Parameters:

Name Type Description Default
coord list[float]

Unnormalized coordinates.

 required
height int

Height.

 required
width int

Width.

 required

Returns:

Type Description
list[float]

Normalized coordinates.
Source code in pixano/features/utils/boxes.py 
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
def normalize_coords(coord: list[float], height: int, width: int) -> list[float]:
    """Normalize coordinates.

    Args:
        coord: Unnormalized coordinates.
        height: Height.
        width: Width.

    Returns:
        Normalized coordinates.
    """
    norm = []

    for i, c in enumerate(coord):
        if i % 2 == 0:
            norm.append(c / width)
        else:
            norm.append(c / height)

    return norm

urle_to_bbox(urle)

Return the smallest bounding box containing all the mask pixels.

Parameters:

Name Type Description Default
urle dict

Mask as uncompressed RLE.

 required

Returns:

Type Description
list[float]

Normalized xywh bounding box.
Source code in pixano/features/utils/boxes.py 
84
85
86
87
88
89
90
91
92
93
def urle_to_bbox(urle: dict) -> list[float]:
    """Return the smallest bounding box containing all the mask pixels.

    Args:
        urle: Mask as uncompressed RLE.

    Returns:
        Normalized xywh bounding box.
    """
    return mask_to_bbox(rle_to_mask(urle_to_rle(urle)))

xywh_to_xyxy(xywh)

Convert bounding box coordinates from xywh (using top left point as reference) to xyxy.

Parameters:

Name Type Description Default
xywh list[float]

xywh coordinates.

 required

Returns:

Type Description
list[float]

xyxy coordinates.
Source code in pixano/features/utils/boxes.py 
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
def xywh_to_xyxy(xywh: list[float]) -> list[float]:
    """Convert bounding box coordinates from xywh
    (using top left point as reference) to xyxy.

    Args:
        xywh: xywh coordinates.

    Returns:
        xyxy coordinates.
    """
    return [
        float(xywh[0]),
        float(xywh[1]),
        float(xywh[0] + xywh[2]),
        float(xywh[1] + xywh[3]),
    ]

xyxy_to_xywh(xyxy)

Convert bounding box coordinates from xyxy to xywh (using top left point as reference).

Parameters:

Name Type Description Default
xyxy list[float]

xyxy coordinates.

 required

Returns:

Type Description
list[float]

xywh coordinates.
Source code in pixano/features/utils/boxes.py 
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
def xyxy_to_xywh(xyxy: list[float]) -> list[float]:
    """Convert bounding box coordinates from xyxy to xywh
    (using top left point as reference).

    Args:
        xyxy: xyxy coordinates.

    Returns:
        xywh coordinates.
    """
    return [
        float(xyxy[0]),
        float(xyxy[1]),
        float(xyxy[2] - xyxy[0]),
        float(xyxy[3] - xyxy[1]),
    ]