gridImage Mosaic

Inspecting individual seed images in a grid layout with feature overlays

The Image Mosaic screen displays classified seed images in a grid layout, organized by classification result (OK vs. Defective). You can inspect individual seeds, view feature overlays, edit classifications, and navigate through paginated results.

Prerequisites

  • An analysis file with completed AI classification and captured images.

Screen Layout

The screen shows two side-by-side mosaic panels:

  • Left panel: Seeds classified as OK (acceptable quality).

  • Right panel: Seeds classified as Defective (various defect categories).

Each panel displays a grid of individual seed images with pagination controls.

Step-by-Step Walkthrough

1. View the Mosaic

Navigate to the Image Mosaic screen from the sidebar. The application generates mosaic images from the HDF5 file using the Python mosaic script. Both panels load with the first page of results.

The image count for each panel is displayed in the header (e.g., "OK: 1,245 seeds" / "Defective: 87 seeds").

2. Navigate Pages

Use the pagination controls below each panel to browse through the seed images:

  • Next/Previous arrows move one page at a time.

  • The current page number and total pages are displayed.

3. Select Seeds for Inspection

Click on any individual cell in the mosaic grid to select it. A detail drawer opens on the right side showing:

  • Enlarged seed image for close inspection.

  • Feature table with all extracted measurements (area, perimeter, color channels, circularity, entropy, etc.).

  • Classification result and confidence score.

4. Enable Feature Overlays

Toggle the feature overlay buttons to visualize extracted features directly on the mosaic:

Overlay
Description

Color

Displays the dominant color of each seed as a tinted overlay

Perimeter

Highlights the detected seed boundary

Min Axis

Shows the minimum axis measurement for each seed

circle-info

Feature overlays help identify why seeds were classified in a particular category. For example, color overlays can reveal subtle color differences between OK and borderline seeds.

5. Edit Seed Classification

If you disagree with the model's classification for a specific seed:

  1. Click the seed in the mosaic to open the detail drawer.

  2. Change the classification using the dropdown selector.

  3. The updated classification is written back to the HDF5 file.

circle-exclamation

6. Configure Grid Layout

Adjust the grid dimensions (number of rows and columns) using the layout controls. This changes how many seeds are visible per page.

7. Save Individual Images

Right-click or use the save option on a selected seed to export its image as a standalone file. This is useful for documenting specific defects or creating reference samples.

Configuration Persistence

Grid layout settings (rows, columns) are persisted in the Electron Store.

Troubleshooting

Issue
Possible Cause
Solution

Mosaic shows no images

No AI analysis run or no images in file

Run AI Classification; verify images were recorded

Images are blurry or pixelated

Grid is zoomed out too far

Reduce the number of columns to enlarge individual cells

Feature overlay not visible

Overlay not toggled on

Click the overlay button to enable it

Classification edit not saving

File is locked or read-only

Check file permissions; ensure no other application has the file open

Slow mosaic loading

Large number of seeds in the file

The mosaic script processes images in pages; wait for the current page to load

Last updated