arrayview 0.8.0__tar.gz → 0.10.0__tar.gz

{arrayview-0.8.0 → arrayview-0.10.0}/.gitignore

@@ -31,4 +31,6 @@ benchmarks/data
 .superpowers/brainstorm
 site/
 van_gogh/
-docs/superpowers
+cig_presentation/
+docs/superpowers
+.playwright-mcp/

{arrayview-0.8.0 → arrayview-0.10.0}/AGENTS.md

@@ -1,19 +1,6 @@
-# ArrayView
-
-Interactive viewer for multi-dimensional arrays and medical/scientific volumes. FastAPI server + single-file HTML/JS frontend (`_viewer.html`), displayed via native window, browser, VS Code Simple Browser, or Jupyter iframe.
+Read `src/arrayview/ARCHITECTURE.md` for codebase orientation.
 
-## Core Files
-
-| File | Role |
-|------|------|
-| `_launcher.py` | Entry points, process management, display routing |
-| `_server.py` | FastAPI app, REST/WebSocket, HTML templates |
-| `_session.py` | Sessions, state, caches, render thread |
-| `_render.py` | Colormaps, LUTs, slice extraction, RGBA |
-| `_viewer.html` | All frontend (JS/CSS embedded, single file) |
-| `_vscode.py` | Extension management, signal-file IPC |
-| `_stdio_server.py` | Stdio transport for direct webview mode |
-| `_segmentation.py` | nnInteractive segmentation client |
+# ArrayView
 
 ## Skills
 
@@ -36,6 +23,7 @@ Load the relevant skill before touching the corresponding area.
 - Do not regress working display paths when fixing another
 - For visual/animation features, propose 2-3 options BEFORE implementing
 - UI visibility changes go through reconcilers (`_reconcileUI`/`_reconcileLayout`/`_reconcileCompareState`/`_reconcileCbVisibility`), not inline `style.display` or `classList` toggles in mode functions
+- All colorbar state (animation, window/level, hover, drag) flows through `primaryCb` ColorBar instance — never read/write legacy globals. Multiview colorbars sync via `primaryCb`.
 
 ## Execution
 

{arrayview-0.8.0 → arrayview-0.10.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: arrayview
-Version: 0.8.0
+Version: 0.10.0
 Summary: Fast multi-dimensional array viewer
 Project-URL: Home, https://github.com/oscarvanderheide/arrayview
 Project-URL: Source, https://github.com/oscarvanderheide/arrayview
@@ -103,7 +103,10 @@ for epoch in range(100):
 
 ## Once open
 
-`c` colormaps · `d` dynamic range · `v` 3-plane · `z` mosaic · `Shift+O` overlay toggle · `?` help · colorbar dblclick histogram
+**Navigation:** scroll slices · `h`/`l` cycle dims · `j`/`k` slices · `=`/`-` zoom · drag pan
+**Views:** `v` 3-plane · `z` mosaic · `q` qMRI · `n` compare · `=` immersive
+**Display:** `c`/`C` colormaps · `d`/`D` dynamic range · `f` FFT · `m` complex · `p` projections · `L` log
+**Tools:** `S` segmentation · `u` ruler · `s` screenshot · `?` help
 
 
 ## nnInteractive Segmentation

{arrayview-0.8.0 → arrayview-0.10.0}/README.md

@@ -68,7 +68,10 @@ for epoch in range(100):
 
 ## Once open
 
-`c` colormaps · `d` dynamic range · `v` 3-plane · `z` mosaic · `Shift+O` overlay toggle · `?` help · colorbar dblclick histogram
+**Navigation:** scroll slices · `h`/`l` cycle dims · `j`/`k` slices · `=`/`-` zoom · drag pan
+**Views:** `v` 3-plane · `z` mosaic · `q` qMRI · `n` compare · `=` immersive
+**Display:** `c`/`C` colormaps · `d`/`D` dynamic range · `f` FFT · `m` complex · `p` projections · `L` log
+**Tools:** `S` segmentation · `u` ruler · `s` screenshot · `?` help
 
 
 ## nnInteractive Segmentation

{arrayview-0.8.0 → arrayview-0.10.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "arrayview"
-version = "0.8.0"
+version = "0.10.0"
 description = "Fast multi-dimensional array viewer"
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.12"

arrayview-0.10.0/scripts/release.sh

@@ -0,0 +1,78 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# ---------------------------------------------------------------------------
+# release.sh — bump version, commit, tag, push, create GitHub release
+# ---------------------------------------------------------------------------
+
+BUMP="minor"
+DRY_RUN=true
+
+usage() {
+    cat <<EOF
+Usage: $(basename "$0") [OPTIONS]
+
+Options:
+  --bump {major,minor,patch}   Version bump type (default: minor)
+  --execute                    Actually run (default is dry-run)
+  -h, --help                   Show this help
+EOF
+}
+
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --bump)   BUMP="$2"; shift 2 ;;
+        --execute) DRY_RUN=false; shift ;;
+        -h|--help) usage; exit 0 ;;
+        *) echo "Unknown option: $1"; usage; exit 1 ;;
+    esac
+done
+
+if [[ ! "$BUMP" =~ ^(major|minor|patch)$ ]]; then
+    echo "Error: --bump must be major, minor, or patch (got '$BUMP')"
+    exit 1
+fi
+
+# --- Guard: clean working tree on main ---
+branch=$(git rev-parse --abbrev-ref HEAD)
+if [[ "$branch" != "main" ]]; then
+    echo "Error: must be on main (currently on '$branch')"
+    exit 1
+fi
+
+if ! git diff --quiet || ! git diff --cached --quiet; then
+    echo "Error: working tree is dirty — commit or stash first"
+    exit 1
+fi
+
+# --- Bump version ---
+uv version --bump "$BUMP"
+VERSION=$(uv version --short)
+TAG="v${VERSION}"
+
+echo "Version bumped to $VERSION (tag: $TAG)"
+
+run() {
+    echo "+ $*"
+    if [[ "$DRY_RUN" == true ]]; then
+        return
+    fi
+    "$@"
+}
+
+# --- Commit, tag, push, release ---
+run git add pyproject.toml
+run git commit -m "release: $TAG"
+run git push origin main
+run git tag "$TAG"
+run git push origin "$TAG"
+run gh release create "$TAG" \
+    --title "[Pre-release] $TAG" \
+    --generate-notes \
+    --prerelease
+
+if [[ "$DRY_RUN" == true ]]; then
+    echo ""
+    echo "(dry-run — re-run with --execute to apply)"
+    git checkout pyproject.toml
+fi

arrayview-0.10.0/src/arrayview/ARCHITECTURE.md

@@ -0,0 +1,197 @@
+# Architecture
+
+## System Overview
+
+```
+CLI / Python API
+   ├─ view() / _launcher.py → FastAPI server (_server.py)       [network mode]
+   │     /ws/{sid} WebSocket, /load register arrays, /seg/* segmentation
+   └─ Stdio server (_stdio_server.py)                           [direct webview mode]
+         stdin/stdout JSON+binary, no network — VS Code extension spawns subprocess
+
+Server (either mode)
+   ├─ _session.py    Session objects, caches, render thread
+   ├─ _render.py     Slice extraction → RGBA → PNG pipeline
+   └─ _io.py         File loading (numpy, nifti, zarr, DICOM, …)
+
+Frontend (_viewer.html — single self-contained HTML file)
+   ├─ CSS            Dark theme, mode-specific layouts
+   ├─ Canvas         2D rendering via ImageBitmap / putImageData
+   ├─ WebSocket      Binary slice transport, JSON metadata
+   └─ UI             Colorbars, eggs, dynamic islands, overlays
+```
+
+## Display Routing
+
+| Environment        | Default display                    | Server mode |
+|--------------------|------------------------------------|-------------|
+| Jupyter            | Inline iframe                      | network     |
+| VS Code local      | Simple Browser (network)           | network     |
+| VS Code tunnel     | Direct webview (stdio)             | stdio       |
+| Julia              | System browser                     | network     |
+| CLI / Python script | Native pywebview                   | network     |
+| SSH terminal (ni)  | VS Code ext via TCP relay (prints URL on relay failure) | network |
+
+Detection logic lives in `_platform.py`. Display opening logic lives in `_launcher.py` (section: ViewHandle and view() API) and `_vscode.py`.
+
+## File Map
+
+| File | Lines | Owns |
+|------|------:|------|
+| `__init__.py` | 5 | Public API re-exports: `view`, `arrayview`, `ViewHandle`, `TrainingMonitor`, `view_batch`, `zarr_chunk_preset` |
+| `__main__.py` | 4 | `python -m arrayview` entry point |
+| `_app.py` | 179 | Backward-compat shim — re-exports everything from the split modules |
+| `_config.py` | 121 | `~/.arrayview/config.toml` read/write, valid window modes/env keys |
+| `_io.py` | 253 | Data loading: numpy, NIfTI (lazy nibabel), zarr, DICOM, raw files |
+| `_launcher.py` | 2817 | **Main entry.** CLI parser, `view()` API, `ViewHandle`, server lifecycle, SSH relay, demo arrays, file watching |
+| `_platform.py` | 396 | Environment detection: Jupyter, VS Code, SSH, tunnel, Julia, native-window capability |
+| `_render.py` | 834 | Rendering pipeline: colormap LUTs, slice extraction, RGBA/RGB/mosaic rendering, overlay compositing, preload |
+| `_segmentation.py` | 227 | nnInteractive segmentation client (pure HTTP, no nnInteractive dependency) |
+| `_server.py` | 3258 | FastAPI app, all REST + WebSocket routes, HTML template serving |
+| `_session.py` | 344 | `Session` class, global state (sockets, loops), render thread, prefetch, cache budgets, constants |
+| `_stdio_server.py` | 791 | Stdio transport for VS Code direct webview — JSON stdin, binary stdout |
+| `_torch.py` | 217 | PyTorch integration: `view_batch()`, `TrainingMonitor` (lazy torch import) |
+| `_vscode.py` | 1014 | VS Code extension install/management, signal-file IPC, shared-memory IPC, browser opening |
+| `_viewer.html` | 14480 | **The entire frontend** — CSS + JS in a single file, all viewing modes |
+| `_shell.html` | 174 | Tab-bar shell for native pywebview — wraps viewer iframes, manages multi-tab sessions |
+
+## Frontend (_viewer.html)
+
+The frontend is a single self-contained HTML file (~15k lines). No build step, no external dependencies. Organized by section separators (`/* ── Section Name ── */` for CSS, `// ── Section Name ──` for JS).
+
+### Major Sections
+
+**CSS (lines ~7–1500)**
+| Section | What it covers |
+|---------|----------------|
+| Theme Variables and Base Layout | CSS custom properties, dark theme palette, root layout grid |
+| ColorBar and Dynamic Islands | Colorbar positioning, egg badges, info bar, dimension sliders |
+| Generic ColorBar class styles | Shared `.av-colorbar` styles used by the ColorBar JS class |
+| Compare, Overlay, and Prompt Styles | Side-by-side panes, overlay blend, prompt dialogs |
+| Help and Info Overlays | Help shortcut overlay, array-info panel |
+| Immersive, Fullscreen, and Compact Mode | Zen mode hide rules, fullscreen layout, compact overrides |
+
+**JavaScript (lines ~1500–14750)**
+| Section | What it covers |
+|---------|----------------|
+| Constants and Transport Setup | WS URL construction, stdio/postMessage transport abstraction |
+| Viewer State Variables | All mutable state: current slice indices, zoom, mode flags |
+| Mode Registry | Mode name → enter/exit function mapping |
+| PanManager | Canvas panning state machine (normal + compare modes) |
+| Canvas Scaling and Layout | `scaleCanvas()`, `mvScaleAllCanvases()`, `compareScaleCanvases()`, `qvScaleAllCanvases()` |
+| Compare Mode | Multi-pane compare infrastructure, drag-to-reorder, sub-modes |
+| Colorbar Rendering and Histogram | Colorbar draw routines, histogram morph, fullscreen overlay colorbar |
+| ColorBar class | Reusable `ColorBar` class (~900 lines) — draw, histogram, window/level, hover |
+| WebSocket and Data Transport | Binary slice receive, request queueing, reconnect |
+| Initialization and Metadata Fetch | `/meta` fetch, loading screen, initial render |
+| Info Bar and Pixel Display | Bottom info bar, hover pixel readout, coordinate display |
+| State Persistence and Restore | URL hash state, `sessionStorage` save/restore |
+| Rendering Pipeline | `updateView()`, play/animate, screenshot capture |
+| ROI and Selection Modes | Rectangle/ellipse ROI drawing, statistics computation |
+| nnInteractive Segmentation | Click-to-segment UI, mask overlay, undo stack |
+| Keyboard Shortcuts | All hotkey bindings — single master switch/case block |
+| Mode Transitions | Compare/multiview/qMRI enter/exit, crosshair animation |
+| Scroll, Zoom, and Pan | Mouse wheel slice scroll, pinch zoom, scroll-to-zoom |
+| Immersive Mode, Cross-Fade, and Visual Effects | Zen mode, fullscreen (K), animated transitions |
+| UI Validation and Reconciliation | Reconcilers that enforce consistent UI state across modes |
+| Colormap Strip and Wipe/Flicker Compare Tools | Colormap preview strip, A/B wipe, flicker, checkerboard |
+| Ruler, Line Profile, and Mini-Map | Distance measurement, 1D intensity profile, overview mini-map |
+| Compact Mode and Touch Input | Compact layout (K), touch gesture handling |
+| File Picker and Session Management | File browser, drag-and-drop, session switching |
+
+### Mode Matrix
+
+Each viewing mode uses a specific scale function and reconciler set:
+
+| Mode | Scale function | Layout | Reconciler notes |
+|------|---------------|--------|------------------|
+| Normal | `scaleCanvas()` | Single canvas, colorbar below | Base reconciler |
+| Immersive (Zen) | `scaleCanvas()` | Canvas fills viewport, UI hidden | Animated enter/exit, dimbar+colorbar drag |
+| Compact | `scaleCanvas()` | Reduced chrome | K-key toggle |
+| Multiview (3-pane oblique) | `mvScaleAllCanvases()` | 3 canvases (axial/coronal/sagittal) | Layout container visibility reconciler |
+| Compare | `compareScaleCanvases()` | 2+ side-by-side panes | Compare sub-mode reconciler (diff/overlay/wipe/flicker/checkerboard) |
+| Diff | `compareScaleCanvases()` | Compare variant — center pane shows A-B | Diff colorbar instances |
+| Registration | `compareScaleCanvases()` | Compare variant — overlay blend | Cross-fade overlay |
+| qMRI | `qvScaleAllCanvases()` | Multi-map quantitative display | Separate scale pipeline |
+
+### CSS Architecture
+
+- **Dark theme only.** Background `#0c0c0c`, text `#d8d8d8`, accents in yellow (`#f5c842`).
+- **Monospace UI.** Font: system monospace for data, system sans-serif for labels.
+- **No CSS framework.** All custom properties defined in `:root`.
+- **Mode-specific overrides** use `.immersive-mode`, `.compact-mode`, `.multiview-mode` classes on `body`.
+- **`av-loading` class** on `body` during initial load — hides UI until data arrives. Removal triggers layout.
+- **Hard UI invariants** block at line ~157 — structural rules that must never be overridden.
+
+## Key Concepts
+
+### Sessions
+A `Session` object (`_session.py`) holds one array's data, metadata, and three LRU caches (raw slices, RGBA tiles, mosaics). Sessions are stored in the global `SESSIONS` dict keyed by `sid` (hex UUID). Multiple sessions enable compare mode and the file picker.
+
+### Eggs (Mode Badges)
+Pill-shaped badges below the canvas showing active visualization transforms. **Composable** — they stack: `FFT` `LOG` `MAGNITUDE` `PHASE` `REAL` `IMAG` `RGB` `ALPHA` `PROJECTION`. Each egg toggles a transform in the rendering pipeline.
+
+**ROI and SEGMENT are NOT eggs.** They are interaction modes that take over canvas input, are mutually incompatible, and each has its own dynamic island UI.
+
+### Dynamic Islands
+Floating UI panels that appear/disappear based on context: ROI statistics, segmentation controls, colorbar hover, dimension sliders. Must be tested across all viewing modes (normal, immersive, multiview, compare).
+
+### Reconcilers
+Functions in the "UI Validation and Reconciliation" section (~line 13666) that enforce consistent UI state. When mode changes happen, reconcilers update visibility of containers, colorbars, dynamic islands, and compare sub-mode UI. There are four:
+1. **Unified UI reconciler** — master state enforcer
+2. **Layout container visibility reconciler** — show/hide mode-specific containers
+3. **Compare sub-mode state reconciler** — diff/overlay/wipe/flicker/checkerboard state
+4. **CB / island visibility reconciler** — colorbar and dynamic island show/hide
+
+### Render Thread
+A dedicated daemon thread (`_session.py`) runs all CPU-heavy rendering off the async event loop. `_render()` posts work to `_RENDER_QUEUE` and returns an awaitable `Future`. The prefetch pool (separate 1-thread executor) warms caches for neighboring slices.
+
+## High-Risk Areas
+
+### CSS Pitfalls
+- **Canvas buffer vs CSS resolution mismatches.** The canvas element size (CSS pixels) and its buffer size (device pixels) must stay in sync. `scaleCanvas()` handles this — never set canvas dimensions outside a scale function.
+- **Selector targeting wrong wrappers.** Normal mode has one `#canvas-wrapper`; compare mode has per-pane wrappers. CSS rules must scope correctly.
+- **`av-loading` class interactions.** Many elements are hidden while `av-loading` is on `body`. Removing it too early causes layout flash; too late causes blank screen.
+
+### Dynamic Islands
+Must verify island positioning and visibility across normal, immersive, multiview, and compare modes. Islands use absolute/fixed positioning that breaks if parent containers change.
+
+### Layout Debugging
+When debugging layout issues: identify the root cause (which scale function, which reconciler, which CSS rule) before applying fixes. Symptoms in one mode often originate from shared code affecting all modes.
+
+### WebSocket Binary Protocol
+Slice data arrives as raw binary (RGBA bytes). The header format and byte offsets are tightly coupled between `_server.py` (Python) and the WebSocket handler in `_viewer.html` (JS). Changes to one must match the other.
+
+### Lazy Imports
+`_launcher.py` deliberately avoids importing numpy, _session, _render, and _io at module level. This saves ~300-350ms on CLI fast paths (when the server is already running). Breaking this lazy-loading pattern degrades startup time for every invocation.
+
+## Data Flow
+
+### Request Lifecycle: `view()` to Pixels
+
+```
+1. view(array)                          # _launcher.py
+   ├─ Create Session(data)              # _session.py — assigns sid, inits caches
+   ├─ Start server if not running       # _launcher.py → _server.py (uvicorn)
+   ├─ Register session via /load        # HTTP POST to FastAPI
+   └─ Open display                      # _launcher.py → _vscode.py / pywebview / browser
+
+2. Browser loads _viewer.html           # _server.py serves from package resources
+   ├─ Establish WebSocket /ws/{sid}     # or stdio transport for VS Code direct
+   └─ Fetch /meta/{sid}                 # Session metadata: shape, dtype, colormaps
+
+3. User scrolls / interacts
+   ├─ JS sends slice request            # WebSocket binary or JSON
+   ├─ Server dispatches to render thread
+   │   ├─ extract_slice()               # _render.py — pull 2D slice from ND array
+   │   ├─ apply_complex_mode()          # _render.py — FFT, magnitude, phase, etc.
+   │   ├─ render_rgba() / render_rgb()  # _render.py — apply colormap LUT → RGBA
+   │   └─ PNG encode                    # sent as binary WebSocket frame
+   └─ JS receives binary
+       ├─ Decode PNG → ImageBitmap
+       ├─ drawImage() to canvas
+       └─ Update info bar, colorbar, eggs
+```
+
+### Stdio Transport Variant (VS Code Direct Webview)
+Same pipeline, but `_stdio_server.py` replaces the FastAPI+WebSocket layer. Messages are JSON on stdin, binary responses are length-prefixed on stdout. The VS Code extension bridges between the webview's `postMessage` and the subprocess stdio.

{arrayview-0.8.0 → arrayview-0.10.0}/src/arrayview/_app.py

@@ -33,8 +33,7 @@ from arrayview._session import (  # noqa: F401
     Session,
     SESSIONS,
     COLORMAPS,
-    DR_PERCENTILES,
-    DR_LABELS,
+
     ZARR_LARGE_XY_TILE,
     ZARR_T_DEPTH,
     PREFETCH_NEIGHBORS,

{arrayview-0.8.0 → arrayview-0.10.0}/src/arrayview/_launcher.py

@@ -3,6 +3,8 @@
 This module was extracted from _app.py during the modular refactor.
 """
 
+# ── Imports and Lazy Loading ─────────────────────────────────────
+
 import argparse
 import asyncio
 import io
@@ -125,9 +127,8 @@ def _vprint(*args, **kwargs) -> None:
     _session_mod._vprint(*args, **kwargs)
 
 
-# ---------------------------------------------------------------------------
-# Subprocess GUI Launcher
-# ---------------------------------------------------------------------------
+# ── Subprocess GUI Launcher ───────────────────────────────────────
+
 _ICON_PNG_PATH: str | None = None
 
 
@@ -380,9 +381,7 @@ def _open_webview_cli(
     return True
 
 
-# ---------------------------------------------------------------------------
-# Server port utilities
-# ---------------------------------------------------------------------------
+# ── Server Port Utilities ─────────────────────────────────────────
 
 
 def _server_alive(port: int, timeout: float = 0.5) -> bool:
@@ -479,9 +478,7 @@ def _relay_array_to_server(
     )
 
 
-# ---------------------------------------------------------------------------
-# Zero-config SSH relay: send array to VS Code extension on SSH client machine
-# ---------------------------------------------------------------------------
+# ── Zero-Config SSH Relay ─────────────────────────────────────────
 
 _RELAY_MAGIC = b"AVRELAY1"
 _RELAY_DEFAULT_PORT = 17789
@@ -633,6 +630,9 @@ async def _serve_background(port: int, stop_when_closed: bool = False):
 _OVERLAY_PALETTE = ["ff4444", "44cc44", "4488ff", "ffcc00", "ff44ff", "44ffff"]
 
 
+# ── ViewHandle and view() API ────────────────────────────────────
+
+
 class ViewHandle(str):
     """Returned by :func:`view`.  Behaves as a URL string for backward compatibility
     and additionally exposes ``.update(arr)`` to push a new array into the viewer
@@ -1256,7 +1256,9 @@ def view(
     if inline:
         from IPython.display import IFrame, display as _ipy_display
 
-        iframe = IFrame(src=url_viewer, width="100%", height=height)
+        # Add inline=1 param so the viewer starts in immersive mode
+        _inline_url = url_viewer + "&inline=1"
+        iframe = IFrame(src=_inline_url, width="100%", height=height)
         if n_arrays == 1:
             return iframe
         # Multi-array inline: display the IFrame and return a uniform tuple of handles.
@@ -1317,6 +1319,9 @@ def view(
     return tuple(ViewHandle(url_viewer, s, port) for s in [session.sid] + _compare_sids)
 
 
+# ── Server Lifecycle ──────────────────────────────────────────────
+
+
 def _is_script_mode() -> bool:
     """True when running as a plain Python script (not interactive REPL, not Jupyter, not Julia)."""
     if _in_jupyter() or _is_julia_env():
@@ -1531,8 +1536,9 @@ def _view_subprocess(
     _print_viewer_location(url_viewer)
 
     if inline:
+        _inline_url = url_viewer + "&inline=1"
         iframe_html = (
-            f"<iframe src='{url_viewer}' width='100%'"
+            f"<iframe src='{_inline_url}' width='100%'"
             f" height='{height}' frameborder='0'></iframe>"
         )
         # IJulia kernel: push HTML through Julia's display stack (routes to Jupyter
@@ -1727,6 +1733,9 @@ def _serve_daemon(
     os._exit(0)
 
 
+# ── Demo Array and File Watching ──────────────────────────────────
+
+
 def _make_demo_array() -> "np.ndarray":
     """Return a (128, 128, 32, 3) float32 RGB plasma animation.
 
@@ -1809,6 +1818,9 @@ def _start_watch_thread(filepath: str, sid: str, port: int) -> None:
     t.start()
 
 
+# ── Config Subcommand ─────────────────────────────────────────────
+
+
 def _handle_config_command(args: list[str]) -> None:
     """Handle 'arrayview config' subcommands."""
     from arrayview._config import (
@@ -1894,6 +1906,9 @@ def _handle_config_command(args: list[str]) -> None:
     sys.exit(1)
 
 
+# ── CLI Entry Point (arrayview command) ───────────────────────────
+
+
 def arrayview():
     """Command Line Interface Entry Point."""
     # Handle "arrayview config ..." subcommand before argparse

{arrayview-0.8.0 → arrayview-0.10.0}/src/arrayview/_render.py

@@ -6,7 +6,6 @@ import numpy as np
 
 from arrayview._session import (
     COLORMAPS,
-    DR_PERCENTILES,
     SESSIONS,
 )
 
@@ -105,15 +104,10 @@ def mosaic_shape(batch):
 # ---------------------------------------------------------------------------
 
 
-def _compute_vmin_vmax(session, data, dr, complex_mode=0):
+def _compute_vmin_vmax(session, data, dr=0, complex_mode=0):
     if complex_mode == 1 and np.iscomplexobj(session.data):
         return (-float(np.pi), float(np.pi))
-    if complex_mode == 0 and len(session.shape) <= 3 and dr in session.global_stats:
-        vmin, vmax = session.global_stats[dr]
-        if vmin != vmax:
-            return vmin, vmax
-    pct_lo, pct_hi = DR_PERCENTILES[dr % len(DR_PERCENTILES)]
-    return float(np.percentile(data, pct_lo)), float(np.percentile(data, pct_hi))
+    return float(np.percentile(data, 1)), float(np.percentile(data, 99))
 
 
 def extract_slice(session, dim_x, dim_y, idx_list):
@@ -237,18 +231,8 @@ def _prepare_display(
         return data, vmin_override, vmax_override
     if log_scale:
         data = np.log1p(np.abs(data)).astype(np.float32)
-        if complex_mode == 0 and len(session.shape) <= 3 and dr in session.global_stats:
-            raw_vmin, raw_vmax = session.global_stats[dr]
-            vmin = float(np.log1p(abs(raw_vmin)))
-            vmax = float(np.log1p(abs(raw_vmax)))
-            if vmin == vmax:
-                pct_lo, pct_hi = DR_PERCENTILES[dr % len(DR_PERCENTILES)]
-                vmin = float(np.percentile(data, pct_lo))
-                vmax = float(np.percentile(data, pct_hi))
-        else:
-            pct_lo, pct_hi = DR_PERCENTILES[dr % len(DR_PERCENTILES)]
-            vmin = float(np.percentile(data, pct_lo))
-            vmax = float(np.percentile(data, pct_hi))
+        vmin = float(np.percentile(data, 1))
+        vmax = float(np.percentile(data, 99))
     else:
         vmin, vmax = _compute_vmin_vmax(session, data, dr, complex_mode)
     return data, vmin, vmax
@@ -698,12 +682,11 @@ def render_mosaic(
         frames = [np.log1p(np.abs(f)).astype(np.float32) for f in frames]
     all_data = np.stack(frames)
 
-    if log_scale:
-        pct_lo, pct_hi = DR_PERCENTILES[dr % len(DR_PERCENTILES)]
-        vmin = float(np.percentile(all_data, pct_lo))
-        vmax = float(np.percentile(all_data, pct_hi))
+    if complex_mode == 1 and np.iscomplexobj(session.data):
+        vmin, vmax = -float(np.pi), float(np.pi)
     else:
-        vmin, vmax = _compute_vmin_vmax(session, all_data, dr, complex_mode)
+        vmin = float(np.percentile(all_data, 1))
+        vmax = float(np.percentile(all_data, 99))
 
     if mosaic_cols is not None:
         cols = mosaic_cols