Skip to content

labelable_thumbnail_cell

anomaly_match_ui.widgets.labelable_thumbnail_cell

Thumbnail cell with a three-way label toggle for the training gallery.

LabelState

Bases: Enum

Three-way label state for a gallery cell.

LabelableThumbnailCell(on_magnify=None, on_star=None, on_label_change=None)

Thumbnail cell with Anomaly / Unlabelled / Normal toggle buttons.

Composes a :class:ThumbnailCell and adds a row of three toggle buttons below it. Exactly one button is active at a time.

Parameters:

Name Type Description Default
on_magnify Callable[[str], None] | None

Forwarded to the inner ThumbnailCell.

 None
on_star Callable[[str], None] | None

Forwarded to the inner ThumbnailCell.

 None
on_label_change Callable[[str, LabelState], None] | None

Called with (filename, new_label) when the user clicks a label button. Not fired for programmatic changes.

 None
Source code in anomaly_match_ui/widgets/labelable_thumbnail_cell.py 
 49
 50
 51
 52
 53
 54
 55
 56
 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
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
def __init__(
    self,
    on_magnify: Callable[[str], None] | None = None,
    on_star: Callable[[str], None] | None = None,
    on_label_change: Callable[[str, LabelState], None] | None = None,
) -> None:
    self._on_label_change = on_label_change
    self._label_state = LabelState.UNLABELLED

    self._cell = ThumbnailCell(on_magnify=on_magnify, on_star=on_star)

    # Three toggle buttons: [Anomaly] [Unlabelled] [Normal]
    self._buttons: dict[LabelState, widgets.Button] = {}
    btn_widgets: list[widgets.Button] = []
    for state, (desc, _color) in _BUTTON_SPECS.items():
        btn = widgets.Button(
            description=desc,
            layout=widgets.Layout(width="auto", height="26px", padding="0 6px"),
        )
        btn.on_click(self._make_click_handler(state))
        self._buttons[state] = btn
        btn_widgets.append(btn)

    self._toggle_bar = widgets.HBox(
        btn_widgets,
        layout=widgets.Layout(
            justify_content="center",
            gap="4px",
            background_color=BG_COLOR,
        ),
    )
    self._refresh_button_styles()

    # Rearrange layout: filename → overlay_bar → image → toggles.
    # ThumbnailCell default is [overlay_bar, image, no_image_html, label].
    c = self._cell
    # Tighten spacing between filename and overlay bar
    c._label.layout.margin = "0"
    c._overlay_bar.layout.margin = "0"
    # Use 100% width so cells scale with the CSS Grid column width
    c._label.layout.width = "100%"
    c._overlay_bar.layout.width = "100%"
    c._image.layout.width = "100%"
    c._image.layout.height = "auto"
    c._no_image_html.layout.width = "100%"
    # Let the square spinner/no-preview box (padding-bottom:100%) drive
    # the height so it matches the aspect-driven image and the cell keeps
    # a stable size across the loading → loaded swap (no layout jump).
    c._no_image_html.layout.height = "auto"

    self.widget = widgets.VBox(
        [c._label, c._overlay_bar, c._image, c._no_image_html, self._toggle_bar],
        layout=widgets.Layout(
            width="100%",
            # Cap generously rather than tightly: the column count is
            # user-chosen now, so fewer columns on a wide panel are
            # meant to enlarge the cutout for detail.  The cap only
            # stops a single cell from filling an ultra-wide screen.
            max_width="480px",
            background_color=BG_COLOR,
            align_items="center",
            overflow="hidden",
        ),
    )

filename property

The filename currently displayed, or None if cleared.

label_state property

The current label state.

update(filename, score, image_bytes, label=LabelState.UNLABELLED, esasky_url=None, display_name=None)

Refresh the cell with new image data and label state.

Parameters:

Name Type Description Default
filename str

The source filename.

 required
score float

The anomaly score.

 required
image_bytes bytes

PNG-encoded image bytes.

 required
label LabelState

Initial label state for this cell.

 UNLABELLED
esasky_url str | None

Optional ESASky URL.

 None
display_name str | None

Caption text to show instead of filename — see :meth:ThumbnailCell.update.

 None
Source code in anomaly_match_ui/widgets/labelable_thumbnail_cell.py 
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
def update(
    self,
    filename: str,
    score: float,
    image_bytes: bytes,
    label: LabelState = LabelState.UNLABELLED,
    esasky_url: str | None = None,
    display_name: str | None = None,
) -> None:
    """Refresh the cell with new image data and label state.

    Args:
        filename: The source filename.
        score: The anomaly score.
        image_bytes: PNG-encoded image bytes.
        label: Initial label state for this cell.
        esasky_url: Optional ESASky URL.
        display_name: Caption text to show instead of *filename* — see
            :meth:`ThumbnailCell.update`.
    """
    self._cell.update(
        filename, score, image_bytes, esasky_url=esasky_url, display_name=display_name
    )
    self._label_state = label
    self._refresh_button_styles()
    self._toggle_bar.layout.display = ""

mark_loading(filename=None, score=None, label=LabelState.UNLABELLED)

Show a loading spinner for the image while metadata stays visible.

Delegates the spinner to the inner cell and, when filename is known, keeps the label toggle bar visible with the stored label so the user can label the source before its pixels finish streaming in. A bare call (page just flipped) hides the toggle bar.

Parameters:

Name Type Description Default
filename str | None

Source filename, or None if not yet known.

 None
score float | None

Anomaly score, or None if not yet known.

 None
label LabelState

Stored label state to reflect on the toggle bar.

 UNLABELLED
Source code in anomaly_match_ui/widgets/labelable_thumbnail_cell.py 
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
def mark_loading(
    self,
    filename: str | None = None,
    score: float | None = None,
    label: LabelState = LabelState.UNLABELLED,
) -> None:
    """Show a loading spinner for the image while metadata stays visible.

    Delegates the spinner to the inner cell and, when *filename* is
    known, keeps the label toggle bar visible with the stored label so
    the user can label the source before its pixels finish streaming
    in. A bare call (page just flipped) hides the toggle bar.

    Args:
        filename: Source filename, or ``None`` if not yet known.
        score: Anomaly score, or ``None`` if not yet known.
        label: Stored label state to reflect on the toggle bar.
    """
    self._cell.mark_loading(filename, score)
    if filename is not None:
        self._label_state = label
        self._refresh_button_styles()
        self._toggle_bar.layout.display = ""
    else:
        self._label_state = LabelState.UNLABELLED
        self._toggle_bar.layout.display = "none"

set_label(label)

Set the label state programmatically (no callback fired).

Parameters:

Name Type Description Default
label LabelState

New label state.

 required
Source code in anomaly_match_ui/widgets/labelable_thumbnail_cell.py 
180
181
182
183
184
185
186
187
def set_label(self, label: LabelState) -> None:
    """Set the label state programmatically (no callback fired).

    Args:
        label: New label state.
    """
    self._label_state = label
    self._refresh_button_styles()

clear()

Reset the cell to an empty placeholder.

Source code in anomaly_match_ui/widgets/labelable_thumbnail_cell.py 
189
190
191
192
193
194
def clear(self) -> None:
    """Reset the cell to an empty placeholder."""
    self._cell.clear()
    self._label_state = LabelState.UNLABELLED
    self._refresh_button_styles()
    self._toggle_bar.layout.display = "none"