Show3DSlices Storyboard

Show3DSlices Storyboard#

Use with Storyboard.

Stories#

S3S-01: Open A Multislice Or Volume Dataset Quickly#

User story: As a microscopist opening multislice, ptychography, or volume data, I want a useful orthogonal-slice preview in about a second for normal working sizes so I can orient myself before fine inspection.

Primary widgets: Show3DSlices.

Data to use: real or real-derived multislice microscopy volume and a larger stress volume.

Acceptance checks:

  • Load the volume from Jupyter and exported HTML when supported.

  • Measure first visible paint, volume shape, dtype, native bytes, and display downsampling if any.

  • Verify XY/XZ/YZ or equivalent slice panels render with labels and scale bars.

  • Verify the widget remains usable after first paint without blocking the kernel for frontend-only interactions.

S3S-02: Navigate Orthogonal Slices#

User story: As a user exploring a 3D volume, I want slice sliders and crosshair/position markers to stay synchronized across orthogonal views.

Primary widgets: Show3DSlices.

Data to use: volume with recognizable features across depth.

Acceptance checks:

  • Scrub each slice axis slowly and quickly.

  • Click in each slice panel and verify the other views jump to the correct corresponding position.

  • Drag the oblique line endpoints in the top slice and verify the side cut rotates/resizes immediately.

  • Drag the oblique line body in the top slice and verify the whole side cut translates in row and col, including diagonal movement, without resetting zoom, contrast, or playback settings.

  • Open Advanced, enable Slice alignment, and verify the first enable estimates one global row/col shift-per-slice slope without a second action. Toggle it off/on repeatedly and confirm the cached raw/aligned views switch immediately without changing the source volume. Reset must invalidate the cache; the row/col sliders should refine the cached display and set manual mode.

  • With FFT enabled, verify the oblique FFT panel follows endpoint and line-body drags continuously instead of updating only after release.

  • With FFT enabled, scrub a slice or oblique slider away and then back. The return position should hit the browser-local FFT cache instead of recomputing.

  • Verify labels, crosshairs, and position readouts update together.

  • Record FPS for slider scrub, click-to-position updates, and oblique line endpoint/body drags with FFT enabled.

S3S-03: Inspect Anisotropic Multislice Data#

User story: As a multislice user, I want depth-axis stretch and scale bars to make anisotropic voxels readable without changing the underlying data.

Primary widgets: Show3DSlices.

Data to use: multislice or volume data where Z sampling differs from XY.

Acceptance checks:

  • Change depth stretch or equivalent display scaling.

  • Verify scale bars and labels remain scientifically meaningful.

  • Verify changing display stretch does not alter exported raw data semantics.

  • Resize panels and verify aspect/position stays stable.

S3S-04: Compare Contrast And FFT Across Slices#

User story: As a user checking periodicity or artifacts through depth, I want contrast, colormap, smoothing, and FFT controls to work consistently across slices.

Primary widgets: Show3DSlices.

Data to use: volume with visible periodic structure or simulated lattice features.

Acceptance checks:

  • Change colormap, contrast, auto/manual range, smoothing, and log scale.

  • Toggle FFT/log FFT when supported and verify FFT panels align with slices.

  • Compare a suspicious FFT slice against NumPy or a known reference.

  • Verify histogram and FFT interactions stay responsive.

S3S-05: Save, Export, And Reopen Volume Views#

User story: As a notebook or sharing user, I want saved notebooks and HTML exports to reopen with visible slice views and without huge hidden buffers when lightweight save is requested.

Primary widgets: Show3DSlices.

Data to use: real or real-derived volume in a Jupyter notebook.

Acceptance checks:

  • Press Cmd+S in JupyterLab and reload/reopen the notebook.

  • Verify the static fallback remains visible and compact.

  • Export HTML where supported and reopen it.

  • Verify slice sliders, contrast, FFT, and reset controls still work.

  • Check saved widget state for heavy-buffer leaks when save_state=False.

S3S-06: Use Slices On A Phone Or Narrow View#

User story: As a user checking a volume on a phone or narrow screen, I want slice panels and controls to remain reachable and readable.

Primary widgets: Show3DSlices.

Data to use: representative volume with multiple slice panels visible.

Acceptance checks:

  • Test a narrow mobile viewport.

  • Verify panels stack or wrap intentionally and labels do not overlap.

  • Test touch-style slider scrub, panel click, pan/zoom, and menu controls.

  • For iPhone-specific claims, serve the page to physical iPhone Safari.