Skip to content

Add a GUI guide with screenshots to README and docs#35

Merged
jacobson30-bot merged 1 commit into
mainfrom
readme-gui-guide
Jun 12, 2026
Merged

Add a GUI guide with screenshots to README and docs#35
jacobson30-bot merged 1 commit into
mainfrom
readme-gui-guide

Conversation

@jacobson30-bot

Copy link
Copy Markdown
Contributor

What

Documents the GUI in the same task-oriented style as the CLI guide, with screenshots of the real widgets.

  • README — new "A tour of the GUI" section after Quick start, covering the four key workflows with one screenshot each: loading images (Browse grid + image viewer), background subtraction with model switching (STM scan-line dialog), the FFT viewer, and the Feature finder. docs/gui.md added to the Documentation list.
  • docs/gui.md — full step-by-step walkthrough: opening folders and the thumbnail browser, the viewer (channels, contrast, command search), the STM background dialog (fit region, line statistic, the model dropdown, residual plots, apply/undo), plane/background subtraction, the FFT viewer tabs (Inspect / Grid / Correction / Mains / Inverse FFT), the Feature finder (detection mode, thresholds, min distance, pre-smooth, CSV/feature-image export), the Feature Counting window and the features extra, plus pointers to ROIs, measurements, spectroscopy, and provenance-carrying export.
  • scripts/generate_gui_screenshots.py — renders the real widgets offscreen against test_data fixtures and writes docs/images/*.png (~720 KB total), so the screenshots can be regenerated after UI changes. Fixtures are copied to a temp dir (sidecars write next to scans) and the user's ~/.probeflow_config.json is left untouched.

Screenshot subjects: terraced topograph for the viewer and background dialog (clear step edges, visible residual structure), the moiré .sxm for FFT (hexagonal superlattice spots) and the Feature finder (minima detection marking each moiré site).

Verification

  • All five screenshots visually verified.
  • ruff check probeflow tests scripts clean; full suite 2449 passed, 3 skipped.

🤖 Generated with Claude Code

README gains "A tour of the GUI" — loading images, background
subtraction with model switching, the FFT viewer, and the Feature
finder, each with a screenshot — plus a link to the new docs/gui.md,
which walks through the same workflows step by step in the style of the
CLI guide and points at ROIs, measurements, spectroscopy, and export.

Screenshots are captured from the real widgets rendered offscreen
against test_data fixtures by scripts/generate_gui_screenshots.py;
rerun it after UI changes to refresh docs/images/.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant