Skip to content

Add waveorder-tutorial and visualize-otf-from-config Claude skills#569

Open
talonchandler wants to merge 3 commits into
mainfrom
waveorder-tutorial-skill
Open

Add waveorder-tutorial and visualize-otf-from-config Claude skills#569
talonchandler wants to merge 3 commits into
mainfrom
waveorder-tutorial-skill

Conversation

@talonchandler

@talonchandler talonchandler commented Jul 16, 2026

Copy link
Copy Markdown
Collaborator

Adds two Claude Code skills under .claude/skills/.

waveorder-tutorial: walks a user through their first waveorder reconstruction over the CLI: environment check, OME-Zarr conversion, config authoring, napari viewing, and regularization sweeps.

  • SKILL.md — the interactive step-by-step flow
  • references/ — conversion guide, config reference, and a ready-to-run QPI-2D config
  • scripts/ — example-data fetch, TIFF/array → OME-Zarr converter, and a parameter-sweep helper

visualize-otf-from-config: computes a transfer function (OTF) from a config and opens it in napari. Two calls: wo compute-tf -i <input>/0/0/0 -c <config> -o otf.zarr, then wo view otf.zarr.

How to trial

  1. Check out this branch and open Claude Code in the repo root.
  2. /waveorder-tutorial (or "try waveorder on my data") — with no data of your own, it fetches the QPI-defocus sample (recOrder_session from Zenodo) and reconstructs 2D phase from a defocus stack (config pre-filled in references/example_qpi_2d.yml). Bring your own TIFF/zarr/array to run the full convert → configure → reconstruct → sweep flow.
  3. /visualize-otf-from-config <config.yml> <input.zarr> — computes the OTF for that config and opens it in napari.

Results are shown interactively in napari (wo view).

Interactive CLI walkthrough for a first reconstruction: environment check,
OME-Zarr conversion, config authoring, napari viewing, and parameter sweeps.
Includes a QPI 2D-from-defocus worked example using the zenodo recOrder_session
sample. Un-ignores .claude/skills/ so the skill ships with the repo.
@talonchandler
talonchandler marked this pull request as ready for review July 16, 2026 18:57
Two-call skill: `wo compute-tf` on a config + input position, then `wo view` on
the resulting transfer function (napari, backgrounded).
@talonchandler talonchandler changed the title Add waveorder-tutorial Claude skill Add waveorder-tutorial and visualize-otf-from-config Claude skills Jul 16, 2026
For 2D reconstructions, the transfer function is stored as a singular system
(U, S, Vh). `wo view` now reconstructs H = U @ diag(S) @ Vh at each lateral
frequency and displays the resulting transfer function(s) — absorption and phase
for 2D phase, the optical TF for 2D fluorescence — instead of the raw singular
vectors. 3D display is unchanged.
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