arrayview 0.6.0__tar.gz → 0.7.0__tar.gz

arrayview-0.7.0/.github/workflows/docs.yml

@@ -0,0 +1,20 @@
+name: Deploy docs
+
+on:
+  push:
+    branches: [main]
+    paths: [docs/**, mkdocs.yml]
+
+permissions:
+  contents: write
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.x"
+      - run: pip install mkdocs-material
+      - run: mkdocs gh-deploy --force

{arrayview-0.6.0 → arrayview-0.7.0}/.gitignore

@@ -11,6 +11,7 @@ wheels/
 
 *.npy
 .claude/
+.worktrees/
 !.claude/skills/
 !.claude/skills/**
 CLAUDE.md
@@ -24,6 +25,7 @@ tests/smoke_output/
 dev/
 *.png
 !src/arrayview/_icon.png
+!docs/logo.png
 
 benchmarks/data
 .superpowers/brainstorm

{arrayview-0.6.0 → arrayview-0.7.0}/AGENTS.md

@@ -44,6 +44,7 @@ CLI / Python API
 | `_vscode.py` | Extension management, signal-file IPC, browser opening |
 | `_platform.py` | Platform/environment detection |
 | `_io.py` | Array I/O, format detection |
+| `_torch.py` | PyTorch DL integration: `view_batch()`, `TrainingMonitor` |
 | `_app.py` | **Compat shim only** — re-exports; add no logic here |
 
 ### Frontend
@@ -74,6 +75,10 @@ Load the relevant skill before touching the corresponding area.
 | `docs-style` | Updating README, in-app help overlay, or docstrings |
 | `task-workflow` | Feature or fix tasks |
 
+## Execution Preferences
+
+When implementing plans, always use **subagent-driven development** (`superpowers:subagent-driven-development`) — not inline execution.
+
 ## Non-Negotiables
 
 - Always use `localhost` (not `127.0.0.1`) — required for VS Code port forwarding
@@ -95,8 +100,6 @@ uv run pytest tests/                     # all
 uv run python tests/visual_smoke.py      # screenshots → tests/smoke_output/
 ```
 
-Visual baselines: `tests/snapshots/` — delete a file to reset.
-
 | What changed | Run |
 |---|---|
 | Server / API | `test_api.py` |
@@ -104,6 +107,8 @@ Visual baselines: `tests/snapshots/` — delete a file to reset.
 | Viewer UI | `test_browser.py` + `visual_smoke.py` |
 | VS Code / platform | manual: VS Code local terminal, VS Code tunnel |
 
+**Visual consistency:** After any UI change, use the `/ui-consistency-audit` skill to verify the feature works consistently across all viewing modes (normal, multi-view, compare, immersive, inline). This replaces reference screenshot comparisons — the UI changes frequently, so consistency across modes matters more than pixel-matching baselines.
+
 ## VS Code Integration
 
 All key functions live in `_vscode.py`:

{arrayview-0.6.0 → arrayview-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: arrayview
-Version: 0.6.0
+Version: 0.7.0
 Summary: Fast multi-dimensional array viewer
 Project-URL: Home, https://github.com/oscarvanderheide/arrayview
 Project-URL: Source, https://github.com/oscarvanderheide/arrayview
@@ -57,12 +57,64 @@ from arrayview import view
 view(arr)
 ```
 
+## MATLAB
+
+Add the `matlab/` directory to your MATLAB path, then:
+
+```matlab
+addpath('/path/to/arrayview/matlab')
+
+A = rand(100, 200, 10);
+arrayview(A)
+```
+
+Requires arrayview installed in [MATLAB's Python environment](https://www.mathworks.com/help/matlab/matlab_external/install-supported-python-implementation.html):
+
+```bash
+pip install arrayview
+```
+
+Arrays are passed zero-copy via the buffer protocol (in-process Python). `arrayview()` enables this automatically — just call it before any other `py.*` call in your MATLAB session.
+
+## PyTorch / Deep Learning
+
+```python
+from arrayview import view_batch, TrainingMonitor
+
+# Browse a DataLoader batch
+view_batch(train_loader)
+view_batch(train_loader, overlay='label')
+
+# Live training monitor — updates every N epochs
+monitor = TrainingMonitor(every=5, samples=3)
+for epoch in range(100):
+    for batch in val_loader:
+        pred = model(batch['image'])
+        monitor.step(input=batch['image'], target=batch['label'],
+                     prediction=pred, epoch=epoch)
+```
+
+`view_batch()` accepts DataLoaders, Datasets, dicts, tuples, or raw tensors. `TrainingMonitor` opens a compare window and calls `handle.update()` automatically. PyTorch is not required at import time.
+
+
 ## Formats
 
 `.npy` `.npz` `.nii` `.nii.gz` `.zarr` `.pt` `.h5` `.tif` `.mat`
 
 ## Once open
 
-`c` colormaps · `d` histogram · `v` 3-plane · `z` mosaic · `?` help
+`c` colormaps · `d` dynamic range · `v` 3-plane · `z` mosaic · `Shift+O` overlay toggle · `?` help · colorbar dblclick histogram
+
+## Config
+
+`~/.arrayview/config.toml`:
+
+```toml
+[viewer]
+colormaps = ["gray", "viridis", "plasma"]   # colormaps cycled by 'c'
+
+[window]
+default = "browser"                         # browser | native | vscode | inline
+```
 
 [Full documentation →](https://oscarvanderheide.github.io/arrayview/)

arrayview-0.7.0/README.md

@@ -0,0 +1,85 @@
+# arrayview
+
+A viewer for multi-dimensional arrays.
+
+- CLI and Python
+- Jupyter / VS Code
+- Browser / native
+- SSH / tunnels
+
+## CLI
+
+```bash
+uvx arrayview scan.nii.gz
+uvx arrayview --window browser scan.npy
+uvx arrayview                            # demo
+```
+
+## Python
+
+```python
+from arrayview import view
+view(arr)
+```
+
+## MATLAB
+
+Add the `matlab/` directory to your MATLAB path, then:
+
+```matlab
+addpath('/path/to/arrayview/matlab')
+
+A = rand(100, 200, 10);
+arrayview(A)
+```
+
+Requires arrayview installed in [MATLAB's Python environment](https://www.mathworks.com/help/matlab/matlab_external/install-supported-python-implementation.html):
+
+```bash
+pip install arrayview
+```
+
+Arrays are passed zero-copy via the buffer protocol (in-process Python). `arrayview()` enables this automatically — just call it before any other `py.*` call in your MATLAB session.
+
+## PyTorch / Deep Learning
+
+```python
+from arrayview import view_batch, TrainingMonitor
+
+# Browse a DataLoader batch
+view_batch(train_loader)
+view_batch(train_loader, overlay='label')
+
+# Live training monitor — updates every N epochs
+monitor = TrainingMonitor(every=5, samples=3)
+for epoch in range(100):
+    for batch in val_loader:
+        pred = model(batch['image'])
+        monitor.step(input=batch['image'], target=batch['label'],
+                     prediction=pred, epoch=epoch)
+```
+
+`view_batch()` accepts DataLoaders, Datasets, dicts, tuples, or raw tensors. `TrainingMonitor` opens a compare window and calls `handle.update()` automatically. PyTorch is not required at import time.
+
+
+## Formats
+
+`.npy` `.npz` `.nii` `.nii.gz` `.zarr` `.pt` `.h5` `.tif` `.mat`
+
+## Once open
+
+`c` colormaps · `d` dynamic range · `v` 3-plane · `z` mosaic · `Shift+O` overlay toggle · `?` help · colorbar dblclick histogram
+
+## Config
+
+`~/.arrayview/config.toml`:
+
+```toml
+[viewer]
+colormaps = ["gray", "viridis", "plasma"]   # colormaps cycled by 'c'
+
+[window]
+default = "browser"                         # browser | native | vscode | inline
+```
+
+[Full documentation →](https://oscarvanderheide.github.io/arrayview/)