Skip to content

thumbnail_cell

anomaly_match_ui.widgets.thumbnail_cell

Single thumbnail cell for the prediction gallery.

ThumbnailCell(on_magnify=None, on_star=None)

A single image thumbnail with filename, score, and action buttons.

Displays a 200x200 preview image with an overlay bar containing magnify button, score label, and star button.

Parameters:

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

Callback invoked with the filename when magnify is clicked.

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

Callback invoked with the filename when star is clicked.

 None
Source code in anomaly_match_ui/widgets/thumbnail_cell.py 
 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
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
def __init__(
    self,
    on_magnify: Callable[[str], None] | None = None,
    on_star: Callable[[str], None] | None = None,
) -> None:
    self._filename: str | None = None
    self._on_magnify = on_magnify
    self._on_star = on_star

    # Image display
    self._image = widgets.Image(
        format="png",
        layout=widgets.Layout(
            width=_CELL_SIZE,
            height=_CELL_SIZE,
            object_fit="contain",
            overflow="hidden",
        ),
    )

    # Placeholder shown when no image is available
    self._no_image_html = widgets.HTML(
        value="",
        layout=widgets.Layout(
            width=_CELL_SIZE,
            height=_CELL_SIZE,
            display="none",
        ),
    )

    # Action buttons + score (overlay bar): [magnify] [score] [esasky?] [star]
    self._magnify_btn = widgets.Button(
        description="",
        icon="search-plus",
        button_style="primary",
        layout=widgets.Layout(width="28px", height="24px", padding="0"),
    )
    self._magnify_btn.on_click(self._handle_magnify)

    self._score_html = widgets.HTML(
        value="",
        layout=widgets.Layout(flex="1 1 auto"),
    )

    self._esasky_btn = widgets.Button(
        description="",
        icon="globe",
        button_style="primary",
        layout=widgets.Layout(width="28px", height="24px", padding="0", display="none"),
    )
    self._esasky_url: str | None = None
    self._esasky_btn.on_click(self._handle_esasky)

    self._star_btn = widgets.Button(
        description="",
        icon="star",
        button_style="primary",
        layout=widgets.Layout(width="28px", height="24px", padding="0"),
    )
    self._star_btn.on_click(self._handle_star)

    # Single overlay row: [magnify] [score] [esasky] [star]
    self._overlay_bar = widgets.HBox(
        [self._magnify_btn, self._score_html, self._esasky_btn, self._star_btn],
        layout=widgets.Layout(
            width=_CELL_SIZE,
            align_items="center",
            gap="2px",
        ),
    )

    # Label (filename only)
    self._label = widgets.HTML(
        value="",
        layout=widgets.Layout(width=_CELL_SIZE, overflow="hidden"),
    )

    # Assemble cell: overlay (buttons+score) → image → filename
    self.widget = widgets.VBox(
        [self._overlay_bar, self._image, self._no_image_html, self._label],
        layout=widgets.Layout(
            width=_CELL_SIZE,
            background_color=BG_COLOR,
            align_items="center",
            overflow="hidden",
        ),
    )

    self.clear()

update(filename, score, image_bytes, esasky_url=None, display_name=None)

Refresh the cell with new image data.

Parameters:

Name Type Description Default
filename str

The source filename, passed back to on_magnify/ on_star and used as the cache key — never altered for display.

 required
score float

The anomaly score.

 required
image_bytes bytes

PNG-encoded image bytes.

 required
esasky_url str | None

Optional ESASky URL. Shows globe button when set.

 None
display_name str | None

Caption text to show instead of filename, for callers whose real id is misleading to show verbatim (e.g. a Zarr source id carrying a pre-conversion file extension). Defaults to filename.

 None
Source code in anomaly_match_ui/widgets/thumbnail_cell.py 
143
144
145
146
147
148
149
150
151
152
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
179
180
181
def update(
    self,
    filename: str,
    score: float,
    image_bytes: bytes,
    esasky_url: str | None = None,
    display_name: str | None = None,
) -> None:
    """Refresh the cell with new image data.

    Args:
        filename: The source filename, passed back to ``on_magnify``/
            ``on_star`` and used as the cache key — never altered for
            display.
        score: The anomaly score.
        image_bytes: PNG-encoded image bytes.
        esasky_url: Optional ESASky URL. Shows globe button when set.
        display_name: Caption text to show instead of *filename*, for
            callers whose real id is misleading to show verbatim (e.g.
            a Zarr source id carrying a pre-conversion file extension).
            Defaults to *filename*.
    """
    self._filename = filename
    self._esasky_url = esasky_url
    self._esasky_btn.layout.display = "" if esasky_url else "none"

    self._score_html.value = _score_markup(score)
    self._label.value = _filename_markup(display_name if display_name is not None else filename)
    self._overlay_bar.layout.display = ""

    if image_bytes:
        self._image.value = image_bytes
        self._image.layout.display = ""
        self._no_image_html.layout.display = "none"
    else:
        self._image.value = b""
        self._image.layout.display = "none"
        self._no_image_html.value = _NO_PREVIEW_BOX_HTML
        self._no_image_html.layout.display = ""

mark_loading(filename=None, score=None)

Show a loading spinner in the image slot without resizing the cell.

The spinner occupies the same square box the image will fill, so paging to an uncached image shows an in-place spinner that the pixels replace without a layout jump. When filename is known the overlay bar (magnify / score / star) is shown too so the user can act on the cell while it streams in; a bare call (page just flipped, metadata not yet queried) shows only the spinner.

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
Source code in anomaly_match_ui/widgets/thumbnail_cell.py 
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
def mark_loading(self, filename: str | None = None, score: float | None = None) -> None:
    """Show a loading spinner in the image slot without resizing the cell.

    The spinner occupies the same square box the image will fill, so
    paging to an uncached image shows an in-place spinner that the
    pixels replace without a layout jump.  When *filename* is known the
    overlay bar (magnify / score / star) is shown too so the user can
    act on the cell while it streams in; a bare call (page just flipped,
    metadata not yet queried) shows only the spinner.

    Args:
        filename: Source filename, or ``None`` if not yet known.
        score: Anomaly score, or ``None`` if not yet known.
    """
    self._filename = filename
    self._esasky_url = None
    self._esasky_btn.layout.display = "none"
    if filename is not None:
        self._score_html.value = _score_markup(score) if score is not None else ""
        self._label.value = _filename_markup(filename)
        self._overlay_bar.layout.display = ""
    else:
        self._score_html.value = ""
        self._label.value = ""
        self._overlay_bar.layout.display = "none"
    self._image.value = b""
    self._image.layout.display = "none"
    self._no_image_html.value = _SPINNER_BOX_HTML
    self._no_image_html.layout.display = ""

clear()

Reset the cell to an empty placeholder.

Source code in anomaly_match_ui/widgets/thumbnail_cell.py 
213
214
215
216
217
218
219
220
221
222
223
224
225
226
def clear(self) -> None:
    """Reset the cell to an empty placeholder."""
    self._filename = None
    self._esasky_url = None
    self._image.value = b""
    self._score_html.value = ""
    self._label.value = (
        f'<div style="color:#444; font-size:11px; text-align:center;'
        f" display:flex; align-items:center; justify-content:center;"
        f' height:{_CELL_SIZE}; border:1px dashed #333;">Waiting for results\u2026</div>'
    )
    self._overlay_bar.layout.display = "none"
    self._image.layout.display = "none"
    self._no_image_html.layout.display = "none"