Releases: ParrishLab/Swell
Releases · ParrishLab/Swell
Release list
v0.2.0
[0.2.0] - 2026-06-12
Host project persistence
- Added
.sdprojcontainer schema 3 with optional embedded source images (images_embedded.jsonplusimages/) so projects can remain usable when the original stack folder moves. - Embedded fallback loads now preserve the original recorded stack folder in
stack.json; extracted temp directories are used only as live read sources and are not persisted as source folders. - Saving with embedding enabled now fails clearly if no source image files can be embedded, instead of silently producing a project without its image payload.
- Saving a project from embedded fallback with embedding disabled is blocked until the user re-enables embedding or rebinds to a real source folder.
- Embedded extraction cleanup now runs after successful close saves or successful context replacement, and live extraction dirs are protected by an active marker.
Export metrics
- Added the intensity export metric, including per-frame mean ROI intensity, baseline intensity, relative
delta_i_over_baseline_i, plots, summaries, and workbook output.
Model/checkpoint compatibility
- No checkpoint format or model selection change in this release; existing managed and local SAM2 model selections remain compatible.
Platform/backend limitations
- Embedding source images can substantially increase
.sdprojsize; save-time confirmation reports the source stack size before copying frames into the project.
.sdproj/migration notes
- Host
.sdprojwriters now emit schema 3. Schema 2 projects remain loadable. - SDApp 0.1.9 may open schema 3 projects but does not understand embedded source images; if a 0.1.9 build re-saves such a project, the embedded image payload can be dropped. Use 0.2.0 or later for projects that rely on embedded source images.
Known segmentation caveats/regressions
- No new release-blocking segmentation regressions are known from the automated suite.
- SAM2 post-processing/native extension availability may still vary by environment.
- Auto-update behavior still depends on platform packaging/signing state; validate against final signed release artifacts.
v0.1.8
[0.1.8] - 2026-05-14
Auto-detect and ROI improvements
- Fixed dialog sizing on Windows: replaced hardcoded
geometry()calls withminsize()across the ROI dialog, scale dialog, auto-detect window, and mark popup so windows open at the correct size without overriding the window manager's placement. center_window_on_screennow uses the window's actual size rather than a hardcoded override, fixing off-center placement on Windows.
Model/checkpoint compatibility
- No checkpoint format or project schema bump in this release; existing managed and local SAM2 model selections remain compatible.
Platform/backend limitations
- Visual sizing and centering fixes are Windows-specific; no behavioral changes on macOS.
.sdproj/migration notes
- No
.sdprojschema version bump is required; existing projects remain loadable.
Known segmentation caveats/regressions
- No new release-blocking segmentation regressions are known from the automated suite.
- SAM2 post-processing/native extension availability may still vary by environment.
- Auto-update behavior still depends on platform packaging/signing state; validate against final signed release artifacts.
v0.1.7
[0.1.7] - 2026-05-14
Auto-detect and ROI improvements
- Overhauled the auto-detect window with a dual-pane overview/detail timeline, interactive ROI selection, grid opacity control, and per-cell border rendering for clearer event visualization.
- Added incremental algorithm rerun scheduling so parameter changes (scale, opacity, ROI) trigger a debounced re-evaluation without blocking the UI.
- Active-cell overlay and cell-border rendering are now cached by pipeline generation, avoiding redundant recomputation across frame scrubs.
- Exporter now selects ROI-scoped speed metrics when an ROI is defined, falling back to full-frame metrics otherwise.
Performance
- Added
DownsampledFrameSource(sdapp/shared/frame_source/downsampled.py) andcompute_visualization_stats_for_previewto compute visualization stats at 0.25× resolution during the analysis-launch preview, then upsample the baseline back to full resolution — significantly reducing preview wait time on large stacks. - Added
sdapp/shared/diagnostics/withOpenPerfTrace: a lightweight wall-clock stage/mark tracer for the analysis-window open path. Traces are dumped to the app log on completion and silently discarded on failure. - Analysis launch flow now wraps the full open sequence in a perf trace, attributing time to import, preview preparation, frame rendering, and options-dialog interactions.
Model/checkpoint compatibility
- No checkpoint format or project schema bump in this release; existing managed and local SAM2 model selections remain compatible.
Platform/backend limitations
- No platform-specific regressions are known from the automated suite.
- DC trace controller and host window controller received minor fixes to align with the updated auto-detect and analysis launch flows.
.sdproj/migration notes
- No
.sdprojschema version bump is required; existing projects remain loadable. _save_project_after_metrics_applynow persists project state immediately after metrics are applied from the host window, reducing the chance of unsaved metric changes.
Known segmentation caveats/regressions
- No new release-blocking segmentation regressions are known from the automated suite (708 tests pass).
- SAM2 post-processing/native extension availability may still vary by environment.
- Auto-update behavior still depends on platform packaging/signing state; validate against final signed release artifacts.