From 229781a06af99de7e32016b02149ba53a9b6fa14 Mon Sep 17 00:00:00 2001 From: Christian Tabedzki <35670232+tabedzki@users.noreply.github.com> Date: Wed, 8 Jul 2026 10:41:51 -0400 Subject: [PATCH 01/17] chore: point pyright at the project .venv Add [tool.pyright] venvPath/venv so pyright resolves imports against the project's .venv, matching the installed dependencies instead of a global environment. Assisted-by: ClaudeCode:claude-opus-4.8 --- pyproject.toml | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/pyproject.toml b/pyproject.toml index 041e7fc..6bc57d8 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -68,6 +68,10 @@ docs = [ "sphinx-design", ] +[tool.pyright] +venvPath = "." +venv = ".venv" + [dependency-groups] dev = [ "furo>=2025.12.19", From 081d146ddf8503b08c719c24fa717cd02611e405 Mon Sep 17 00:00:00 2001 From: m-beau Date: Fri, 18 Sep 2026 09:05:24 -0400 Subject: [PATCH 02/17] paper typo fix --- paper/paper.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/paper/paper.md b/paper/paper.md index 6a67072..047428f 100644 --- a/paper/paper.md +++ b/paper/paper.md @@ -52,7 +52,7 @@ Beyond satisfying hardware constraints, channelmaps must be tailored to the expe 1. **Being available on any machine installation-free** at [https://pixelmap.pni.princeton.edu](https://pixelmap.pni.princeton.edu). 2. **Visualising wiring constraints in real time**: When users select electrodes (red), the interface immediately shows which become unavailable (black) due to shared lines or ADCs, preventing invalid configurations. 3. **Supporting arbitrary electrode geometries** through 1) common preset geometries, 2) entering electrode ranges as text for reproducibility, 3) directly clicking or dragging on the probe visualisation, or 4) loading pre-existing `.imro` files. These four selection methods are compatible with one another and meant to be combined. -4. **Guiding channelmap design with anatomy and activity overlays**: Users can overlay anatomical region boundaries from any brain atlas available through BrainGlobe [@claudi2020] to plan recordings around specific brain regions of interest, and **simultaneously** a SpikeGLX activity survey heatmap to identify the most active channels and confirm anatomical predictions after probe implantation. +4. **Guiding channelmap design with anatomy and activity overlays**: Users can overlay anatomical region boundaries from any brain atlas available through BrainGlobe [@claudi2020] to plan recordings around specific brain regions of interest. They can also **simultaneously** overlay a SpikeGLX activity survey heatmap to identify the most active channels and confirm anatomical predictions after probe implantation. | Probe Version | Physical Electrodes | Readout Channels | |---------------|---------------------|------------------| From 3568638100a1743f21752fedbb70ca09d03f758a Mon Sep 17 00:00:00 2001 From: m-beau Date: Fri, 18 Sep 2026 13:06:24 +0000 Subject: [PATCH 03/17] (auto) Paper PDF Draft --- paper/paper.pdf | Bin 815164 -> 815168 bytes 1 file changed, 0 insertions(+), 0 deletions(-) diff --git a/paper/paper.pdf b/paper/paper.pdf index 658d3c4802f5bdf7e72e505a97dd022d1153da26..33fd1d3c77d217fd4e8fd4286befa471079815a1 100644 GIT binary patch delta 6899 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 Date: Fri, 18 Sep 2026 17:34:43 -0400 Subject: [PATCH 04/17] fix: memory leak across atlases for each user --- pixelmap/anatomy/atlas.py | 178 +++++++++++++++++++++++++--- pixelmap/anatomy/schematic.py | 13 +- pixelmap/gui/gui.py | 17 +++ tests/README.md | 2 +- tests/test_anatomy_atlas.py | 126 ++++++++++++++++++++ tests/test_anatomy_schematic.py | 78 +++++++++++- tests/test_anatomy_surface_depth.py | 2 + tests/test_anatomy_visualization.py | 2 + tests/test_gui_overlays.py | 42 +++++++ 9 files changed, 435 insertions(+), 25 deletions(-) diff --git a/pixelmap/anatomy/atlas.py b/pixelmap/anatomy/atlas.py index 7fc1090..9de0858 100644 --- a/pixelmap/anatomy/atlas.py +++ b/pixelmap/anatomy/atlas.py @@ -26,6 +26,19 @@ ~9 MB of compressed chunks, against ~1.3 GB of tiffs under v2. That is what makes baking them into the Docker image cheap and reliable. +Only one annotation volume is ever resident +------------------------------------------- +The decompressed annotation is by far the largest thing PixelMap holds: 308 MB +for allen_mouse_25um, 1.07 GB for whs_sd_rat_39um, 4.8 GB for allen_mouse_10um +(mean across the registry: ~700 MB). Caching more than one of those is what +took the server to 3 GB RSS with a single user simply trying atlases. + +So exactly one atlas's annotation is kept in RAM at a time, and switching +atlases *releases the old one before loading the new* — see +:func:`_make_resident`. The atlas *objects* are a separate, cheap cache +(:func:`get_atlas`, ~5 MB each, metadata only): keeping several of those costs +almost nothing and is what lets metadata queries stay lock-free. + Why the network never runs inline --------------------------------- The deployed app is a single-process Panel/Bokeh server: a blocking call on @@ -39,7 +52,10 @@ from __future__ import annotations +import ctypes +import ctypes.util import functools +import gc import threading from dataclasses import dataclass from pathlib import Path @@ -67,37 +83,154 @@ class RegionInfo: rgb: tuple[int, int, int] # 0-255 color as defined by the atlas -@functools.lru_cache(maxsize=4) +@functools.lru_cache(maxsize=8) def get_atlas(name: str = _DEFAULT_ATLAS): - """Return a cached :class:`BrainGlobeAtlas` instance. + """Return a cached, **metadata-only** :class:`BrainGlobeAtlas` instance. We delegate the download/caching to brainglobe — its on-disk cache is shared across processes. ``check_latest=False`` skips the remote version check so the app doesn't hang when the atlas host is unreachable. - Construction fetches only the manifest and metadata (a few hundred KB); - the annotation array is pulled from S3 later, when something first reads - ``atlas.annotation``. Either step is free once the data is local, but - neither is free on a cold cache — see :func:`ensure_downloaded` for - getting that cost off the event loop. - - The cache is bounded so a server that sees many atlases doesn't hold every - annotation volume it has ever decoded. Nothing else may keep a strong - reference to an atlas object, or that bound stops meaning anything (see - :func:`_region_info_from_id`). + Construction fetches only the manifest and metadata (a few hundred KB, ~5 MB + resident, ~65 ms); the annotation array is pulled from S3 later, when + something first reads ``atlas.annotation``. **Nothing may read that + attribute except** :func:`_make_resident`, which is what keeps the + one-annotation-at-a-time invariant true — every other function here is a + metadata query and must stay that way. + + Because the objects this returns are small, the bound is generous and this + function takes no lock: metadata queries (:func:`is_downloaded`, + :func:`volume_center_um`, :func:`origin_corner`, region lookups) stay cheap + and never block, even while another thread is mid-download. The annotation + is bounded separately, and far more tightly, by :func:`_make_resident`. """ return BrainGlobeAtlas(name, check_latest=False) +#: Serialises atlas *switches*. Held across a download, so a second session +#: asking for a different atlas waits rather than putting two annotation +#: volumes in RAM at once — the whole point of this module. Deliberately not +#: taken by :func:`get_atlas`, so metadata queries never block on a download. +_resident_lock = threading.RLock() + +#: The single atlas whose annotation is currently in RAM, held by a *strong* +#: reference so it survives eviction from :func:`get_atlas`'s cache and stays +#: releasable. ``None`` when no annotation is loaded. +_resident = None +_resident_name: str | None = None + + +def _malloc_trim() -> None: + """Hand glibc's freed heap back to the OS. No-op where unavailable. + + Freeing the array is not enough: the annotation is decoded from thousands + of small OME-Zarr chunks, and those land on the heap, where glibc keeps + them after ``free()``. Measured on one 1.07 GB atlas: dropping every + reference returned the array itself but left ~585 MB of high-water behind, + and that is what made RSS ratchet up across atlas switches instead of + returning to baseline. ``MALLOC_ARENA_MAX=2`` (see the Dockerfile) bounds + how many arenas can hoard it; this returns what they are already holding. + + Absent on macOS/musl, where there is no ``malloc_trim`` — the caller has + still dropped its references either way. + """ + trim = _malloc_trim_fn() + if trim is None: + return + try: + trim(0) + except Exception: # noqa: BLE001 - best-effort reclaim, never fatal + pass + + +@functools.lru_cache(maxsize=1) +def _malloc_trim_fn(): + """Resolve glibc's ``malloc_trim`` once, or ``None`` where there isn't one. + + ``libc.so.6`` by name first: it is the glibc soname on every platform that + has this function, including the Ubuntu base image, and it avoids + ``find_library``, which shells out to ``ldconfig``/``gcc`` and returns + ``None`` in slim containers that have neither. Resolved once per process + because that fallback is far too expensive to run on every atlas switch. + """ + candidates = ("libc.so.6", ctypes.util.find_library("c")) + for name in candidates: + if not name: + continue + try: + return ctypes.CDLL(name).malloc_trim + except (OSError, AttributeError): + continue + return None + + +def _release_resident() -> None: + """Drop the resident annotation volume and return its pages to the OS. + + Order matters. ``canonical_annotation`` memoises a *view* onto the array, + which keeps the whole buffer alive, so its memo has to go first or clearing + ``_annotation`` frees nothing. Callers hold :data:`_resident_lock`. + """ + global _resident, _resident_name + + if _resident is None: + return + canonical_annotation.cache_clear() + # brainglobe has no public "unload" hook; ``_annotation`` is the attribute + # its ``annotation`` property memoises into, and clearing it makes the next + # read re-fetch from the (already local) on-disk cache in ~130 ms. Guarded + # because test doubles expose ``annotation`` as a plain attribute instead. + try: + _resident._annotation = None + except AttributeError: + pass + _resident = None + _resident_name = None + gc.collect() + _malloc_trim() + + +def _make_resident(name: str): + """Return ``name``'s atlas with its annotation loaded, and no other's. + + The single place in PixelMap that reads ``atlas.annotation``, so that the + "one annotation volume in RAM" invariant holds by construction rather than + by everyone remembering it. Switching releases the previous atlas *before* + loading the new one, which keeps the peak at whichever of the two is larger + instead of their sum — the difference between fitting in a 3.5 GB container + and being OOM-killed while swapping a 1 GB atlas for a 5 GB one. + """ + global _resident, _resident_name + + with _resident_lock: + if _resident is not None and _resident_name == name: + return _resident + _release_resident() + atlas = get_atlas(name) + _ = atlas.annotation # the download / decode this module exists to bound + _resident, _resident_name = atlas, name + return atlas + + +def release_atlas_memory() -> None: + """Drop the resident annotation volume, freeing its RAM. + + For callers that know no atlas is needed for a while. The next lookup + reloads from the local on-disk cache. + """ + with _resident_lock: + _release_resident() + + def ensure_downloaded(name: str = _DEFAULT_ATLAS) -> None: """Materialise ``name``'s annotation, downloading it if necessary. The one call in this module that can block for seconds on a cold cache, in a single place so callers can push it onto a worker thread — which the GUI does, because on the server the calling thread also serves every other - session. A no-op once the atlas is local. + session. A no-op once the atlas is local *and* already resident. """ - _ = get_atlas(name).annotation + _make_resident(name) @functools.lru_cache(maxsize=1) @@ -398,8 +531,9 @@ def _atlas_shape(atlas) -> tuple[int, ...]: brainglobe publishes ``shape`` from the atlas manifest, which is the cheap way to ask: reading ``annotation.shape`` instead would pull the entire - array from S3. Test doubles only carry ``annotation``, so fall back to - that. + array from S3 — outside :func:`_make_resident`, and so outside the + one-volume-at-a-time bound. Every real v3 atlas carries ``shape``; only + test doubles reach the fallback. """ shape = getattr(atlas, "shape", None) if shape is not None: @@ -434,7 +568,7 @@ def anatomical_axes(atlas) -> dict[str, _AnatAxis]: return axes -@functools.lru_cache(maxsize=4) +@functools.lru_cache(maxsize=1) def canonical_annotation(atlas_name: str): """Return ``(annotation, resolution)`` reoriented to canonical ``(AP, DV, ML)``. @@ -444,8 +578,16 @@ def canonical_annotation(atlas_name: str): assumes this layout, so funnelling every atlas through here is what lets non-Allen orientations work. For an already-``asr`` atlas this is a no-op (identity transpose, no flips), so Allen behavior is unchanged. + + Transpose and flip both return *views*, so a memoised entry here keeps the + whole annotation buffer alive — dropping the owning atlas's reference is not + enough to free it. That is why :func:`_release_resident` clears this memo + first, and that clear, not the ``maxsize``, is what enforces the + one-volume-at-a-time bound. ``maxsize=1`` is defence in depth: it keeps the + memo from outliving the atlas it describes even if some future caller + reaches this function without going through a release. """ - atlas = get_atlas(atlas_name) + atlas = _make_resident(atlas_name) axes = anatomical_axes(atlas) order = (axes["AP"].array_axis, axes["DV"].array_axis, axes["ML"].array_axis) arr = np.transpose(atlas.annotation, order) diff --git a/pixelmap/anatomy/schematic.py b/pixelmap/anatomy/schematic.py index 141d915..a8c293f 100644 --- a/pixelmap/anatomy/schematic.py +++ b/pixelmap/anatomy/schematic.py @@ -14,8 +14,6 @@ from __future__ import annotations -import functools - import numpy as np from matplotlib.figure import Figure from matplotlib.lines import Line2D @@ -31,12 +29,19 @@ _OUTLINE_RGBA = (0.2, 0.2, 0.25, 0.8) -@functools.lru_cache(maxsize=4) def _atlas_data(atlas_name: str): - """Cached ``(atlas, annotation, resolution)`` in canonical ``(AP, DV, ML)``. + """``(atlas, annotation, resolution)`` in canonical ``(AP, DV, ML)``. Going through :func:`~pixelmap.anatomy.atlas.canonical_annotation` means the slicing/projection below works for any atlas orientation, not just Allen's. + + Deliberately **not** memoised. It used to be an ``lru_cache(maxsize=4)``, + which made it a third independent cache holding atlas objects and their + annotation volumes — keyed and evicted independently of the two in + :mod:`pixelmap.anatomy.atlas`, so between them they could pin a dozen + volumes (~700 MB each) while each looked individually well-bounded. That + was the server's monotonic RSS climb. Both calls below are already cached + upstream, so there is nothing to memoise here anyway. """ atlas = get_atlas(atlas_name) annotation, resolution = canonical_annotation(atlas_name) diff --git a/pixelmap/gui/gui.py b/pixelmap/gui/gui.py index b6b3d9d..be7044e 100644 --- a/pixelmap/gui/gui.py +++ b/pixelmap/gui/gui.py @@ -11,6 +11,7 @@ import json import logging import re +import threading from dataclasses import dataclass, field from io import BytesIO, StringIO from pathlib import Path @@ -1415,6 +1416,22 @@ def clear_anatomy_overlay(self): self.anatomy_locator_section.visible = False self._update_tip_depth_readout() # back to a blank readout + # Hand back the atlas's RAM: nothing on screen needs it any more, and an + # annotation volume is 308 MB for allen_mouse_25um and up to 4.8 GB for + # a 10 µm atlas. Recomputing reloads it from the local on-disk cache in + # ~130 ms, which is a fair price for not sitting on gigabytes. + # + # Off-thread on purpose: the release takes the atlas lock, which a + # concurrent download can hold for seconds, and this method runs on the + # Bokeh event loop that serves every other session. Fire-and-forget — + # if it loses a race with someone else loading an atlas, that atlas is + # simply the resident one and the memory is reclaimed on the next switch. + threading.Thread( + target=anatomy_atlas.release_atlas_memory, + name="pixelmap-atlas-release", + daemon=True, + ).start() + def _fig_to_locator_html(self, fig) -> str: """Convert a matplotlib figure to an HTML img with click-to-lightbox.""" buf = BytesIO() diff --git a/tests/README.md b/tests/README.md index fcf40fd..91bfaa0 100644 --- a/tests/README.md +++ b/tests/README.md @@ -182,7 +182,7 @@ Tests run automatically via GitHub Actions on: - Every pull request to `main` - Manual workflow dispatch -The workflow tests across multiple Python versions (3.10, 3.11, 3.12) to ensure compatibility. +The workflow tests across multiple Python versions (3.11, 3.12) to ensure compatibility. ## Adding New Tests diff --git a/tests/test_anatomy_atlas.py b/tests/test_anatomy_atlas.py index 504763d..e54d52d 100644 --- a/tests/test_anatomy_atlas.py +++ b/tests/test_anatomy_atlas.py @@ -43,11 +43,13 @@ def _must_not_be_called(*args, **kwargs): @pytest.fixture(autouse=True) def _reset_atlas_cache(): """Make sure no real atlas leaks across tests via the lru_cache.""" + atlas_module.release_atlas_memory() atlas_module.get_atlas.cache_clear() atlas_module.canonical_annotation.cache_clear() atlas_module.derive_origin_from_ac.cache_clear() atlas_module._region_info_from_id.cache_clear() yield + atlas_module.release_atlas_memory() atlas_module.get_atlas.cache_clear() atlas_module.canonical_annotation.cache_clear() atlas_module.derive_origin_from_ac.cache_clear() @@ -89,6 +91,7 @@ def __init__(self, name, **kwargs): self.annotation = np.zeros((4, 4, 4), dtype=np.int32) monkeypatch.setattr(atlas_module, "BrainGlobeAtlas", Zeros) + atlas_module.release_atlas_memory() atlas_module.get_atlas.cache_clear() atlas_module.canonical_annotation.cache_clear() @@ -149,6 +152,7 @@ def test_canonical_annotation_reorients_to_asr(self, monkeypatch): # Native "sla" volume is indexed (DV, ML, AP); canonical must be (AP, DV, ML). native = np.arange(2 * 3 * 4, dtype=np.int32).reshape(2, 3, 4) monkeypatch.setattr(atlas_module, "BrainGlobeAtlas", _atlas_cls("sla", native)) + atlas_module.release_atlas_memory() atlas_module.get_atlas.cache_clear() atlas_module.canonical_annotation.cache_clear() arr, _ = atlas_module.canonical_annotation("x") @@ -163,6 +167,7 @@ def test_derive_origin_from_ac_finds_midline_crossing(self, monkeypatch): structs = {5: {"id": 5, "acronym": "ac", "name": "anterior commissure", "rgb_triplet": [1, 2, 3]}} monkeypatch.setattr(atlas_module, "BrainGlobeAtlas", _atlas_cls("asr", ann, structs)) + atlas_module.release_atlas_memory() atlas_module.get_atlas.cache_clear() atlas_module.canonical_annotation.cache_clear() atlas_module.derive_origin_from_ac.cache_clear() @@ -175,6 +180,7 @@ def test_derive_origin_from_ac_none_without_ac(self, monkeypatch): structs = {9: {"id": 9, "acronym": "x", "name": "some nucleus", "rgb_triplet": [0, 0, 0]}} monkeypatch.setattr(atlas_module, "BrainGlobeAtlas", _atlas_cls("asr", ann, structs)) + atlas_module.release_atlas_memory() atlas_module.get_atlas.cache_clear() atlas_module.canonical_annotation.cache_clear() atlas_module.derive_origin_from_ac.cache_clear() @@ -187,6 +193,7 @@ def test_lookup_resolves_through_ap_flip(self, monkeypatch): native[0, :, :] = 2 # native index 0 = posterior native[1:, :, :] = 1 monkeypatch.setattr(atlas_module, "BrainGlobeAtlas", _atlas_cls("psr", native)) + atlas_module.release_atlas_memory() atlas_module.get_atlas.cache_clear() atlas_module.canonical_annotation.cache_clear() anterior = atlas_module.lookup_regions("x", np.array([[0.0, 0.0, 0.0]])) @@ -454,3 +461,122 @@ def test_rotating_past_the_bound_does_not_accumulate(self, monkeypatch): # Rebuilding on eviction is expected; *retaining* the rebuilds is not. assert len(built) > bound, "expected evictions to force rebuilds" assert self._live(built) <= bound + + + +class TestOnlyOneAnnotationIsResident: + """At most one annotation volume may be in RAM at any moment. + + Regression test for the production leak that took RSS from 86 MB to 3 GB + while a single user tried out atlases. Three independent ``lru_cache``es + (``get_atlas``, ``canonical_annotation`` and ``schematic._atlas_data``, + ``maxsize=4`` apiece) each pinned atlases and their annotation volumes, and + because they were keyed and evicted independently they could hold a dozen + between them — ~700 MB each on average across the registry, 5.2 GB at the + top end. Each cache looked individually well-bounded; the total was not. + + Liveness is asserted on the annotation *arrays*, via weakrefs, not on the + atlas objects that own them: ``canonical_annotation`` memoises a transposed + *view*, which keeps the whole buffer alive on its own, so counting atlas + objects would miss precisely the leak that matters. + """ + + @staticmethod + def _atlas_cls(alive: list, peak: list[int]): + """A fake that weak-references every annotation array it materialises.""" + + class _LoadTrackingAtlas: + def __init__(self, name: str, **_kwargs): + self.name = name + self.orientation = "asr" + self.resolution = (25.0, 25.0, 25.0) + self.shape = (4, 4, 4) + self.structures = { + 1: {"acronym": "R", "name": "Region", "rgb_triplet": [1, 2, 3]} + } + self._annotation = None + + @property + def annotation(self): + if self._annotation is None: + ann = np.ones((4, 4, 4), dtype=np.int32) + alive.append(weakref.ref(ann)) + self._annotation = ann + gc.collect() + peak[0] = max(peak[0], sum(r() is not None for r in alive)) + return self._annotation + + return _LoadTrackingAtlas + + @staticmethod + def _live(alive: list) -> int: + gc.collect() + return sum(ref() is not None for ref in alive) + + def test_switching_atlases_never_holds_two_volumes(self, monkeypatch): + alive: list = [] + peak = [0] + monkeypatch.setattr( + atlas_module, "BrainGlobeAtlas", self._atlas_cls(alive, peak) + ) + coords = np.array([[0.0, 0.0, 0.0]]) + + # Many more distinct atlases than any of the old caches could hold. + for i in range(24): + name = f"atlas_{i}" + atlas_module.ensure_downloaded(name) + atlas_module.lookup_regions(name, coords) + atlas_module.canonical_annotation(name) + live = self._live(alive) + assert live == 1, ( + f"{live} annotation volumes in RAM after {name}; 1 is allowed" + ) + + assert peak[0] == 1, ( + f"peak of {peak[0]} concurrently-live annotations: the previous " + "atlas must be released *before* the next is read, or a switch " + "transiently costs the sum of the two" + ) + + def test_revisiting_the_resident_atlas_does_not_reload(self, monkeypatch): + alive: list = [] + peak = [0] + monkeypatch.setattr( + atlas_module, "BrainGlobeAtlas", self._atlas_cls(alive, peak) + ) + coords = np.array([[0.0, 0.0, 0.0]]) + + atlas_module.ensure_downloaded("a") + for _ in range(5): + atlas_module.ensure_downloaded("a") + atlas_module.lookup_regions("a", coords) + assert len(alive) == 1, "resident atlas was needlessly reloaded" + assert self._live(alive) == 1 + + def test_release_atlas_memory_frees_everything(self, monkeypatch): + alive: list = [] + monkeypatch.setattr( + atlas_module, "BrainGlobeAtlas", self._atlas_cls(alive, [0]) + ) + atlas_module.ensure_downloaded("a") + atlas_module.canonical_annotation("a") + assert self._live(alive) == 1 + atlas_module.release_atlas_memory() + assert self._live(alive) == 0, "release_atlas_memory left a volume in RAM" + + def test_metadata_queries_do_not_load_annotations(self, monkeypatch): + """The cheap path must stay cheap — and must not evict the resident.""" + alive: list = [] + monkeypatch.setattr( + atlas_module, "BrainGlobeAtlas", self._atlas_cls(alive, [0]) + ) + + atlas_module.ensure_downloaded("resident") + assert len(alive) == 1 + + for i in range(12): # more than get_atlas's own bound + atlas_module.volume_center_um(f"other_{i}") + atlas_module.orientation_code(f"other_{i}") + + assert len(alive) == 1, "a metadata query materialised an annotation" + assert self._live(alive) == 1, "a metadata query evicted the resident atlas" diff --git a/tests/test_anatomy_schematic.py b/tests/test_anatomy_schematic.py index a9c23e0..ad1577b 100644 --- a/tests/test_anatomy_schematic.py +++ b/tests/test_anatomy_schematic.py @@ -6,6 +6,9 @@ from __future__ import annotations +import gc +import weakref + import numpy as np import pytest @@ -33,13 +36,15 @@ def __init__(self, name: str, **_kwargs): @pytest.fixture(autouse=True) def _reset_caches(): + # ``schematic._atlas_data`` is deliberately uncached now (it used to pin a + # fourth set of annotation volumes), so there is nothing to clear for it. + atlas_module.release_atlas_memory() atlas_module.get_atlas.cache_clear() atlas_module.canonical_annotation.cache_clear() - schematic_module._atlas_data.cache_clear() yield + atlas_module.release_atlas_memory() atlas_module.get_atlas.cache_clear() atlas_module.canonical_annotation.cache_clear() - schematic_module._atlas_data.cache_clear() @pytest.fixture @@ -106,3 +111,72 @@ def test_falls_back_to_silhouette_when_tip_outside_volume(fake_brainglobe): y_range=(0.0, 80.0), ) assert len(fig.axes) == 4 # 3 slices + legend; renders without crashing + + + +class _LoadTrackingAtlas: + """Fake atlas whose annotation arrays are individually weak-referenced. + + Liveness is tracked on the *array*, not on the atlas object: a cache that + stores the array directly keeps it alive even after the owning atlas has + dropped its own reference, and that is exactly the failure mode being + guarded against. + """ + + alive: list = [] # weakrefs to every annotation array ever materialised + + def __init__(self, name: str, **_kwargs): + self.name = name + self.orientation = "asr" + self.resolution = (25.0, 25.0, 25.0) + self.shape = (8, 6, 10) + self.structures = { + 1: {"acronym": "L", "name": "Left", "rgb_triplet": [200, 0, 0]}, + 2: {"acronym": "R", "name": "Right", "rgb_triplet": [0, 0, 200]}, + } + self._annotation = None + + @property + def annotation(self): + if self._annotation is None: + ann = np.zeros((8, 6, 10), dtype=np.int32) + ann[1:7, 1:5, 1:5] = 1 + ann[1:7, 1:5, 5:9] = 2 + type(self).alive.append(weakref.ref(ann)) + self._annotation = ann + return self._annotation + + @classmethod + def live_annotations(cls) -> int: + gc.collect() + return sum(ref() is not None for ref in cls.alive) + + +def test_rendering_many_atlases_keeps_one_annotation_resident(monkeypatch): + """The locator must not build an atlas cache of its own. + + ``_atlas_data`` used to be an ``lru_cache(maxsize=4)`` holding + ``(atlas, annotation, resolution)``. Keyed and evicted independently of the + caches in :mod:`pixelmap.anatomy.atlas`, it pinned up to four more + annotation volumes — hundreds of MB apiece — which is part of why the + server's RSS climbed monotonically as a user browsed atlases. Note it held + the *array*, so releasing the atlas object would not have freed it. + """ + monkeypatch.setattr(atlas_module, "BrainGlobeAtlas", _LoadTrackingAtlas) + monkeypatch.setattr(_LoadTrackingAtlas, "alive", []) + + for i in range(12): # three times the old cache bound + render_locator( + f"atlas_{i}", + tip_atlas=(100.0, 100.0, 75.0), + pitch_deg=0.0, + yaw_deg=0.0, + shank_orientation_deg=0.0, + shank_positions={0: 0.0}, + y_range=(0.0, 80.0), + ) + live = _LoadTrackingAtlas.live_annotations() + assert live == 1, ( + f"{live} annotation volumes still in RAM after rendering atlas_{i}; " + "exactly 1 is allowed" + ) diff --git a/tests/test_anatomy_surface_depth.py b/tests/test_anatomy_surface_depth.py index 7011393..fe5ce8d 100644 --- a/tests/test_anatomy_surface_depth.py +++ b/tests/test_anatomy_surface_depth.py @@ -35,10 +35,12 @@ def __init__(self, name, **_kwargs): @pytest.fixture(autouse=True) def _reset_cache(): + atlas_module.release_atlas_memory() atlas_module.get_atlas.cache_clear() atlas_module.canonical_annotation.cache_clear() atlas_module._region_info_from_id.cache_clear() yield + atlas_module.release_atlas_memory() atlas_module.get_atlas.cache_clear() atlas_module.canonical_annotation.cache_clear() atlas_module._region_info_from_id.cache_clear() diff --git a/tests/test_anatomy_visualization.py b/tests/test_anatomy_visualization.py index 4fc66b4..c40b0e2 100644 --- a/tests/test_anatomy_visualization.py +++ b/tests/test_anatomy_visualization.py @@ -29,10 +29,12 @@ def __init__(self, name: str, **_kwargs): @pytest.fixture(autouse=True) def _reset_cache(): + atlas_module.release_atlas_memory() atlas_module.get_atlas.cache_clear() atlas_module.canonical_annotation.cache_clear() atlas_module._region_info_from_id.cache_clear() yield + atlas_module.release_atlas_memory() atlas_module.get_atlas.cache_clear() atlas_module.canonical_annotation.cache_clear() atlas_module._region_info_from_id.cache_clear() diff --git a/tests/test_gui_overlays.py b/tests/test_gui_overlays.py index 1324ec7..5091f01 100644 --- a/tests/test_gui_overlays.py +++ b/tests/test_gui_overlays.py @@ -14,6 +14,7 @@ import asyncio import inspect import threading +import time import numpy as np import pandas as pd @@ -85,6 +86,7 @@ def __init__(self, name, **_kwargs): 2: {"acronym": "SUP", "name": "Superficial region", "rgb_triplet": [200, 100, 50]}, } + atlas_module.release_atlas_memory() atlas_module.get_atlas.cache_clear() atlas_module.canonical_annotation.cache_clear() atlas_module._region_info_from_id.cache_clear() @@ -92,6 +94,7 @@ def __init__(self, name, **_kwargs): # Pretend it's cached so the GUI treats it as a local atlas throughout. monkeypatch.setattr(atlas_module, "is_downloaded", lambda name=FAKE_ATLAS: True) yield ann + atlas_module.release_atlas_memory() atlas_module.get_atlas.cache_clear() atlas_module.canonical_annotation.cache_clear() atlas_module._region_info_from_id.cache_clear() @@ -696,3 +699,42 @@ def test_no_unlocked_async_gui_callbacks(): f"async GUI callbacks missing @pn.io.with_lock: {unlocked}. Panel " "schedules these nolock, so any Bokeh model write inside them raises." ) + + +class TestClearOverlayReleasesAtlasMemory: + """"Clear overlay" must hand the annotation volume back, not just blank the plot. + + Blanking the Bokeh sources left the atlas resident — 308 MB for + allen_mouse_25um, up to 4.8 GB for a 10 µm atlas — so a user who cleared the + overlay saw RSS stay exactly where it was. + """ + + @staticmethod + def _wait_for_release(timeout: float = 5.0) -> bool: + """The release runs on a daemon thread; give it a moment to land.""" + deadline = time.monotonic() + timeout + while time.monotonic() < deadline: + if atlas_module._resident is None: + return True + time.sleep(0.01) + return atlas_module._resident is None + + def test_clearing_the_overlay_releases_the_atlas(self, posed_gui): + posed_gui.compute_anatomy_overlay() + assert atlas_module._resident is not None, "overlay should have loaded an atlas" + + posed_gui.clear_anatomy_overlay() + + assert self._wait_for_release(), "clear overlay left the atlas resident in RAM" + + def test_recomputing_after_a_clear_still_works(self, posed_gui): + """Releasing must be transparent — the next compute reloads from disk.""" + posed_gui.compute_anatomy_overlay() + posed_gui.clear_anatomy_overlay() + assert self._wait_for_release() + + posed_gui.compute_anatomy_overlay() + assert atlas_module._resident is not None + assert len(posed_gui.region_band_source.data["acronym"]) > 0, ( + "overlay did not come back after a release" + ) From c1fdd06c4c2a8d3cb868b087fbf741aaeb748c19 Mon Sep 17 00:00:00 2001 From: m-beau Date: Fri, 18 Sep 2026 19:15:29 -0400 Subject: [PATCH 05/17] fix: matplotlib memory leak + efficient atlas slice read to prevent full atlases from filling the RAM --- pixelmap/anatomy/atlas.py | 171 +++++++++++++++++++------- pixelmap/anatomy/regions.py | 12 +- pixelmap/anatomy/schematic.py | 45 +++++-- pixelmap/anatomy/volume.py | 211 ++++++++++++++++++++++++++++++++ pixelmap/gui/gui.py | 17 ++- scripts/prefetch_atlases.py | 33 +++-- tests/test_anatomy_atlas.py | 38 +++++- tests/test_anatomy_schematic.py | 89 ++++++++++++++ tests/test_anatomy_volume.py | 210 +++++++++++++++++++++++++++++++ tests/test_gui_overlays.py | 25 ++++ 10 files changed, 782 insertions(+), 69 deletions(-) create mode 100644 pixelmap/anatomy/volume.py create mode 100644 tests/test_anatomy_volume.py diff --git a/pixelmap/anatomy/atlas.py b/pixelmap/anatomy/atlas.py index 9de0858..92f6154 100644 --- a/pixelmap/anatomy/atlas.py +++ b/pixelmap/anatomy/atlas.py @@ -62,13 +62,18 @@ import numpy as np from brainglobe_atlasapi import BrainGlobeAtlas -from brainglobe_atlasapi.descriptors import V3_ANNOTATION_NAME, V3_ATLAS_ROOTDIR +from brainglobe_atlasapi.descriptors import ( + V3_ANNOTATION_NAME, + V3_ATLAS_ROOTDIR, + remote_url_s3, +) from brainglobe_atlasapi.list_atlases import ( get_all_atlases_lastversions, get_downloaded_atlases, ) from pixelmap.anatomy._registry_snapshot import REGISTRY_SNAPSHOT +from pixelmap.anatomy.volume import CanonicalVolume _DEFAULT_ATLAS = "allen_mouse_25um" @@ -113,11 +118,15 @@ def get_atlas(name: str = _DEFAULT_ATLAS): #: taken by :func:`get_atlas`, so metadata queries never block on a download. _resident_lock = threading.RLock() -#: The single atlas whose annotation is currently in RAM, held by a *strong* +#: The single atlas whose annotation is currently open, held by a *strong* #: reference so it survives eviction from :func:`get_atlas`'s cache and stays -#: releasable. ``None`` when no annotation is loaded. +#: releasable. ``None`` when nothing is open. _resident = None _resident_name: str | None = None +#: Its :class:`~pixelmap.anatomy.volume.CanonicalVolume`. Normally a handle on +#: the zarr store plus a few hundred KB of cached projections; only the +#: fallback path (test doubles, unresolvable layouts) makes it a full array. +_resident_volume: CanonicalVolume | None = None def _malloc_trim() -> None: @@ -171,11 +180,12 @@ def _release_resident() -> None: which keeps the whole buffer alive, so its memo has to go first or clearing ``_annotation`` frees nothing. Callers hold :data:`_resident_lock`. """ - global _resident, _resident_name + global _resident, _resident_name, _resident_volume if _resident is None: return canonical_annotation.cache_clear() + _resident_volume = None # brainglobe has no public "unload" hook; ``_annotation`` is the attribute # its ``annotation`` property memoises into, and clearing it makes the next # read re-fetch from the (already local) on-disk cache in ~130 ms. Guarded @@ -193,23 +203,96 @@ def _release_resident() -> None: def _make_resident(name: str): """Return ``name``'s atlas with its annotation loaded, and no other's. - The single place in PixelMap that reads ``atlas.annotation``, so that the - "one annotation volume in RAM" invariant holds by construction rather than - by everyone remembering it. Switching releases the previous atlas *before* - loading the new one, which keeps the peak at whichever of the two is larger - instead of their sum — the difference between fitting in a 3.5 GB container - and being OOM-killed while swapping a 1 GB atlas for a 5 GB one. + The single place that opens annotation data, so the "one volume at a time" + invariant holds by construction rather than by everyone remembering it. + Switching releases the previous atlas *before* opening the new one, which + keeps the peak at whichever of the two is larger instead of their sum. + + Normally "opening" is just a zarr handle — reads happen per query, through + :class:`~pixelmap.anatomy.volume.CanonicalVolume`. The eager fallback in + :func:`_open_volume` is the exception, and it is the only case where this + costs the whole array. """ - global _resident, _resident_name + global _resident, _resident_name, _resident_volume with _resident_lock: - if _resident is not None and _resident_name == name: - return _resident + if _resident_volume is not None and _resident_name == name: + return _resident_volume _release_resident() atlas = get_atlas(name) - _ = atlas.annotation # the download / decode this module exists to bound - _resident, _resident_name = atlas, name - return atlas + volume = _open_volume(atlas) # downloads the chunks if they aren't local + _resident, _resident_name, _resident_volume = atlas, name, volume + return volume + + +def _open_volume(atlas) -> CanonicalVolume: + """Open ``atlas``'s annotation for lazy reads, fetching the data if needed. + + Prefers the OME-Zarr store on disk, so reads decompress only the chunks they + touch. Falls back to brainglobe's ``atlas.annotation`` — which materialises + the whole array — when the store cannot be resolved: test doubles, and any + future layout this does not understand. The fallback is correct, just + expensive, so it must never raise on the happy path. + """ + axes = anatomical_axes(atlas) + resolution = (axes["AP"].res_um, axes["DV"].res_um, axes["ML"].res_um) + try: + store = _open_annotation_store(atlas) + except Exception: # noqa: BLE001 - any failure falls back to the eager read + store = atlas.annotation + return CanonicalVolume(store, axes, resolution) + + +def _annotation_level_dir(atlas) -> Path: + """Directory of the OME-Zarr pyramid level matching the atlas's resolution. + + brainglobe picks the level at construction (``_annotation_pyramid_level``); + we only have to turn that index into its on-disk name, which the multiscale + metadata beside the levels spells out. + """ + import json + + location = atlas.metadata["annotation_set"]["location"][1:] + root = Path(atlas.root_dir) / location / V3_ANNOTATION_NAME + meta = json.loads((root / "zarr.json").read_text()) + attrs = meta.get("attributes", meta) + ome = attrs.get("ome", attrs) + multiscales = ome["multiscales"] + datasets = (multiscales[0] if isinstance(multiscales, list) else multiscales)["datasets"] + return root / datasets[atlas._annotation_pyramid_level]["path"] + + +def _open_annotation_store(atlas): + """A ``zarr.Array`` over the atlas's annotation, downloading it if absent. + + Mirrors what ``brainglobe_atlasapi.core.Atlas.annotation`` does to fetch a + level, minus the ``.compute()`` that turns it into an in-memory array — the + whole point being to leave the data on disk. Coupled to brainglobe's v3 + layout, as :func:`_annotation_is_cached` already is. + """ + import zarr + + level_dir = _annotation_level_dir(atlas) + if not (level_dir / "c").exists(): + location = atlas.metadata["annotation_set"]["location"][1:] + remote = remote_url_s3.format( + f"{location}/{V3_ANNOTATION_NAME}/{level_dir.name}/" + ) + atlas.fs.get(remote, str(level_dir), recursive=True) + return zarr.open_array(str(level_dir), mode="r") + + +def reclaim_free_memory() -> None: + """Return already-freed heap to the OS, without dropping the open atlas. + + Reading a slice allocates and frees a burst of chunk buffers, and the C + allocator keeps that space for reuse rather than unmapping it. Nothing is + leaking in Python — object counts are flat across hundreds of renders — but + RSS is what a container limit measures, so the space has to be handed back + explicitly. Cheap (a few ms) and safe to call after any read-heavy + operation; a no-op where the platform offers no way to do it (macOS). + """ + _malloc_trim() def release_atlas_memory() -> None: @@ -499,7 +582,9 @@ def derive_origin_from_ac(name: str) -> tuple[float, float, float] | None: if not ac_ids: return None ann, res = canonical_annotation(name) # (AP, DV, ML) - ap, dv, ml = np.where(np.isin(ann, ac_ids)) + # Slab-wise: ``np.isin`` over a whole volume would allocate a bool array the + # size of the voxel count on top of the volume itself. + ap, dv, ml = ann.find_label_voxels(ac_ids) if ap.size == 0: return None midline = float(ml.mean()) # AC ~symmetric → centroid ML = midline @@ -579,25 +664,18 @@ def canonical_annotation(atlas_name: str): non-Allen orientations work. For an already-``asr`` atlas this is a no-op (identity transpose, no flips), so Allen behavior is unchanged. - Transpose and flip both return *views*, so a memoised entry here keeps the - whole annotation buffer alive — dropping the owning atlas's reference is not - enough to free it. That is why :func:`_release_resident` clears this memo - first, and that clear, not the ``maxsize``, is what enforces the - one-volume-at-a-time bound. ``maxsize=1`` is defence in depth: it keeps the - memo from outliving the atlas it describes even if some future caller - reaches this function without going through a release. + The first element is a :class:`~pixelmap.anatomy.volume.CanonicalVolume`, + not an ``ndarray``: it indexes like one for the ints and step-1 slices this + package uses, but each read pulls only the chunks it touches instead of + materialising hundreds of MB. Use ``.gather()`` for scattered points and + ``.projections()`` for a whole-brain silhouette — both are far cheaper than + the equivalent numpy expression, and neither needs the full array. + + Memoised at ``maxsize=1`` to match the one-atlas-at-a-time bound; + :func:`_release_resident` clears it, which is what actually enforces that. """ - atlas = _make_resident(atlas_name) - axes = anatomical_axes(atlas) - order = (axes["AP"].array_axis, axes["DV"].array_axis, axes["ML"].array_axis) - arr = np.transpose(atlas.annotation, order) - flip_axes = tuple(i for i, kind in enumerate(("AP", "DV", "ML")) if axes[kind].flip) - if flip_axes: - arr = np.flip(arr, axis=flip_axes) - res = np.array( - [axes["AP"].res_um, axes["DV"].res_um, axes["ML"].res_um], dtype=float - ) - return arr, res + volume = _make_resident(atlas_name) + return volume, np.array(volume.resolution, dtype=float) def volume_center_um(name: str = _DEFAULT_ATLAS) -> tuple[float, float, float]: @@ -644,17 +722,26 @@ def lookup_regions( ml_idx = np.round(coords[:, 1] / voxel_size[2]).astype(int) shape = annotation.shape + inside = ( + (ap_idx >= 0) & (ap_idx < shape[0]) + & (dv_idx >= 0) & (dv_idx < shape[1]) + & (ml_idx >= 0) & (ml_idx < shape[2]) + ) + + # One read of the trajectory's bounding box, rather than a chunk + # decompression per voxel — see :meth:`CanonicalVolume.gather`. + ids = np.zeros(len(coords), dtype=np.int64) + if inside.any(): + ids[inside] = annotation.gather( + ap_idx[inside], dv_idx[inside], ml_idx[inside] + ) results: list[RegionInfo | None] = [] - for ap, dv, ml in zip(ap_idx, dv_idx, ml_idx): - if not (0 <= ap < shape[0] and 0 <= dv < shape[1] and 0 <= ml < shape[2]): - results.append(None) - continue - region_id = int(annotation[ap, dv, ml]) - if region_id == 0: # outside-brain or undefined + for is_inside, region_id in zip(inside, ids): + if not is_inside or region_id == 0: # outside the volume, or undefined results.append(None) continue - results.append(_region_info_from_id(atlas_name, region_id)) + results.append(_region_info_from_id(atlas_name, int(region_id))) return results diff --git a/pixelmap/anatomy/regions.py b/pixelmap/anatomy/regions.py index d7f33ff..90f7ccd 100644 --- a/pixelmap/anatomy/regions.py +++ b/pixelmap/anatomy/regions.py @@ -96,9 +96,15 @@ def tip_depth_below_surface_um( & (ml_idx >= 0) & (ml_idx < n_ml) ) inside = np.zeros(distances.shape, dtype=bool) - inside[in_volume] = ( - annotation[ap_idx[in_volume], dv_idx[in_volume], ml_idx[in_volume]] != 0 - ) + if in_volume.any(): + # One bounding-box read for the whole search line: the samples are + # collinear, so the box is thin even when the line is 30 mm long. + inside[in_volume] = ( + annotation.gather( + ap_idx[in_volume], dv_idx[in_volume], ml_idx[in_volume] + ) + != 0 + ) if not inside[0]: return None # tip is not in the brain — "depth below surface" is meaningless diff --git a/pixelmap/anatomy/schematic.py b/pixelmap/anatomy/schematic.py index a8c293f..b5c0f4c 100644 --- a/pixelmap/anatomy/schematic.py +++ b/pixelmap/anatomy/schematic.py @@ -80,13 +80,20 @@ def _outline_rgba(label_img: np.ndarray) -> np.ndarray: return rgba -def _draw_view(ax, label_img, x_um, y_um, atlas, fallback_mask, title, warp=None): +def _draw_view(ax, label_img, x_um, y_um, atlas, silhouette, title, warp=None): """Draw one slice (colored regions + outlines), or a silhouette fallback. - ``label_img`` and ``fallback_mask`` are shaped ``(len(y_um), len(x_um))``; - y is DV in both views. The y-axis is oriented dorsal-up. ``warp``, if given, - is ``(scale_x, scale_y, rotate_deg, pivot_x, pivot_y)`` applied to the *brain - image only* (not the probe) so the atlas visibly squashes/tilts about bregma. + ``label_img`` and the mask ``silhouette`` returns are shaped + ``(len(y_um), len(x_um))``; y is DV in both views. The y-axis is oriented + dorsal-up. ``warp``, if given, is ``(scale_x, scale_y, rotate_deg, pivot_x, + pivot_y)`` applied to the *brain image only* (not the probe) so the atlas + visibly squashes/tilts about bregma. + + ``silhouette`` is a *callable*, not a mask: building it is the one operation + here that has to read every voxel, and it is only needed when the tip falls + outside the volume and there is no slice to draw. Passing the array instead + meant paying for it on every render, including the overwhelmingly common + case where it goes unused. """ # extent=(left, right, bottom, top); top = y_um[0] (DV 0) puts dorsal up. extent = (float(x_um[0]), float(x_um[-1]), float(y_um[-1]), float(y_um[0])) @@ -100,8 +107,9 @@ def _draw_view(ax, label_img, x_um, y_um, atlas, fallback_mask, title, warp=None ax.set_ylim(extent[2], extent[3]) else: # Tip is outside the volume here — show the whole-brain silhouette. - artists.append(ax.contourf(x_um, y_um, fallback_mask, levels=[0.5, 1.5], colors=[_FILL])) - artists.append(ax.contour(x_um, y_um, fallback_mask, levels=[0.5], colors=[_EDGE], linewidths=0.6)) + mask = silhouette() + artists.append(ax.contourf(x_um, y_um, mask, levels=[0.5, 1.5], colors=[_FILL])) + artists.append(ax.contour(x_um, y_um, mask, levels=[0.5], colors=[_EDGE], linewidths=0.6)) ax.invert_yaxis() if warp is not None: @@ -128,6 +136,7 @@ def render_locator( ml_squish: float = 1.0, dv_squish: float = 1.0, tilt_deg: float = 0.0, + fig: Figure | None = None, ) -> Figure: """Render the locator figure for the current insertion pose. @@ -141,6 +150,13 @@ def render_locator( shape with the probe straight. Returns a bare matplotlib :class:`~matplotlib.figure.Figure` for a Panel ``Matplotlib`` pane (no pyplot global state). + + Pass ``fig`` to draw into an existing figure instead of building one. The + overlay re-renders on every pose edit, and constructing a figure per render + — with its Agg canvas and renderer — was measured at 3.1 MB of unreturned + RSS per call inside the container, more than everything the atlas itself + costs. Reusing one figure per session removes that; the caller owns it and + must not keep references to artists across renders, since this clears it. """ atlas, ann, res = _atlas_data(atlas_name) n_ap, n_dv, n_ml = ann.shape @@ -163,11 +179,13 @@ def render_locator( ap_idx = int(np.clip(round(tip_ap / res[0]), 0, n_ap - 1)) dv_idx = int(np.clip(round(tip_dv / res[1]), 0, n_dv - 1)) ml_idx = int(np.clip(round(tip_ml / res[2]), 0, n_ml - 1)) - inside = ann > 0 # 2×2 grid (4th cell empty) so the figure stays narrow enough to fit the # side panel without overflowing the page; a 1×3 row would be too wide. - fig = Figure(figsize=(3.7, 3.3), dpi=110) + if fig is None: + fig = Figure(figsize=(3.7, 3.3), dpi=110) + else: + fig.clear() # reuse the canvas and renderer; drop the previous render fig.subplots_adjust(left=0.02, right=0.98, top=0.92, bottom=0.02, wspace=0.08, hspace=0.20) ax_sag = fig.add_subplot(2, 2, 1) @@ -186,14 +204,17 @@ def render_locator( # Labels report the coordinate along each panel's visible horizontal axis: # AP on the sagittal view, ML on the coronal view. + # ``projections()`` returns the silhouette reduced over ML, AP and DV + # respectively, and caches, so at most one whole-volume scan happens — and + # only if some view actually has no slice to draw. _draw_view(ax_sag, ann[:, :, ml_idx].T, ap_um, dv_um, atlas, - fallback_mask=inside.any(axis=2).T, + silhouette=lambda: ann.projections()[0].T, title=f"Sagittal · AP {ap_um[ap_idx]:.0f} µm", warp=warp_sag) _draw_view(ax_cor, ann[ap_idx, :, :], ml_um, dv_um, atlas, - fallback_mask=inside.any(axis=0), + silhouette=lambda: ann.projections()[1], title=f"Coronal · ML {ml_um[ml_idx]:.0f} µm", warp=warp_cor) _draw_view(ax_hor, ann[:, dv_idx, :], ml_um, ap_um, atlas, - fallback_mask=inside.any(axis=1), + silhouette=lambda: ann.projections()[2], title=f"Horizontal · DV {dv_um[dv_idx]:.0f} µm", warp=warp_hor) # Probe (red) + bregma estimate (black) per view: (axis, x-col, y-col) diff --git a/pixelmap/anatomy/volume.py b/pixelmap/anatomy/volume.py new file mode 100644 index 0000000..41eae4c --- /dev/null +++ b/pixelmap/anatomy/volume.py @@ -0,0 +1,211 @@ +"""Lazy, canonically-oriented access to a brainglobe annotation volume. + +PixelMap never needs a whole annotation. It reads a few hundred voxels along a +probe, three 2D slices for the locator, and — only when the tip falls outside +the brain — a whole-brain silhouette. brainglobe's ``atlas.annotation`` +nevertheless materialises the entire array, which is the single largest cost in +the app: 308 MB for allen_mouse_25um, 692 MB for danionella_cerebrum_mixed_2.5um, +4.8 GB for allen_mouse_10um. + +Worse, materialising costs far more than the array itself. The data is stored +as chunked OME-Zarr, and assembling it decompresses every chunk: measured 3.4x +the array size through brainglobe's dask path, 2.4x through a plain zarr read. +danionella's chunks are 322**3 — 134 MB decompressed apiece, sixteen of them for +a 692 MB array — so simply opening it peaked at 2.3 GB. + +:class:`CanonicalVolume` reads from the zarr store instead, so only the chunks +covering the requested region are ever decompressed. It also hides the +orientation remap: every atlas is presented as canonical ``(AP, DV, ML)`` +(brainglobe ``"asr"``) regardless of its native axis order, which is what the +rest of :mod:`pixelmap.anatomy` assumes. + +The backing store is anything supporting numpy basic indexing and ``.shape`` — +a ``zarr.Array`` in production, a plain ``ndarray`` for test doubles and for +atlases whose on-disk layout cannot be resolved. +""" + +from __future__ import annotations + +import numpy as np + +#: Target bytes per slab for the whole-volume scans (silhouette, label search). +#: These are the only operations that must touch every voxel, and this is what +#: keeps them O(slab) in RAM instead of O(volume). +_SLAB_BYTES = 64 * 1024 * 1024 + + +class CanonicalVolume: + """An annotation volume indexed as canonical ``(AP, DV, ML)``, read lazily. + + Supports ``vol[i, j, k]`` with ints and step-1 slices, which is everything + PixelMap asks for. Each read is translated into the store's native axis + order, fetched, then transposed and flipped back into canonical order — so + only the requested region is ever decompressed and held. + """ + + def __init__(self, store, axes, resolution): + self._store = store + self._axes = axes # {"AP"|"DV"|"ML": _AnatAxis} + self._order = ("AP", "DV", "ML") + self.resolution = tuple(float(r) for r in resolution) + self.shape = tuple(int(axes[k].n) for k in self._order) + self.dtype = np.dtype(getattr(store, "dtype", np.int32)) + self._projections = None + + # -- indexing ---------------------------------------------------------- + + def __getitem__(self, key) -> np.ndarray: + if not isinstance(key, tuple): + key = (key,) + if len(key) != 3: + raise IndexError( + f"CanonicalVolume needs a 3-axis index (AP, DV, ML); got {len(key)}" + ) + + native: list = [slice(None)] * 3 + kept: list[tuple[str, bool]] = [] # canonical axes that survive, + flip + for kind, item in zip(self._order, key): + axis = self._axes[kind] + if isinstance(item, (int, np.integer)): + native[axis.array_axis] = _native_index(int(item), axis.n, axis.flip) + elif isinstance(item, slice): + native[axis.array_axis] = _native_slice(item, axis.n, axis.flip) + kept.append((kind, axis.flip)) + else: + raise TypeError( + "CanonicalVolume supports ints and step-1 slices only; " + f"got {type(item).__name__} on the {kind} axis" + ) + + out = np.asarray(self._store[tuple(native)]) + if not kept: + return out + + # The read came back in *native* axis order; put the surviving axes + # back into canonical (AP, DV, ML) order, then undo any flipped reads. + by_native = sorted(kept, key=lambda kf: self._axes[kf[0]].array_axis) + out = np.transpose(out, [by_native.index(kf) for kf in kept]) + flipped = tuple(i for i, (_, flip) in enumerate(kept) if flip) + return np.flip(out, axis=flipped) if flipped else out + + def __array__(self, dtype=None, copy=None): + """Materialise the whole volume — the thing this class exists to avoid. + + Present so ``np.asarray(vol)`` and ``np.testing.assert_array_equal`` + work on small test volumes. Never call it on a real atlas. + """ + out = self[:, :, :] + return out.astype(dtype) if dtype is not None else out + + def gather(self, ap, dv, ml) -> np.ndarray: + """Values at N canonical voxel indices, via a single bounding-box read. + + Reading the points one at a time would be far worse than reading the + whole volume: every scalar access decompresses the entire chunk holding + it, so 380 lookups cost 289 MB and 475 ms against 340 MB and 78 ms for + the full array. One read of their bounding box costs 15 MB and 5 ms — + a probe trajectory is a thin box, which is the case that matters. + + Indices must already be inside the volume. + """ + ap = np.asarray(ap, dtype=int) + dv = np.asarray(dv, dtype=int) + ml = np.asarray(ml, dtype=int) + if ap.size == 0: + return np.zeros(0, dtype=self.dtype) + + lo = (int(ap.min()), int(dv.min()), int(ml.min())) + hi = (int(ap.max()) + 1, int(dv.max()) + 1, int(ml.max()) + 1) + box = self[lo[0]:hi[0], lo[1]:hi[1], lo[2]:hi[2]] + return box[ap - lo[0], dv - lo[1], ml - lo[2]] + + # -- whole-volume scans, done a slab at a time -------------------------- + + def _slabs(self): + """Yield ``(start, stop, block)`` over canonical AP, bounded in RAM. + + Slabs are aligned to the store's native chunking along whichever axis + AP maps to, so a chunk is decompressed once rather than once per slab. + """ + n_ap = self.shape[0] + plane = int(np.prod(self.shape[1:])) * self.dtype.itemsize + thickness = max(1, _SLAB_BYTES // max(plane, 1)) + + chunks = getattr(self._store, "chunks", None) + if chunks: + native_chunk = int(chunks[self._axes["AP"].array_axis]) + if native_chunk > 0: + thickness = max(native_chunk, thickness - thickness % native_chunk) + + for start in range(0, n_ap, thickness): + stop = min(start + thickness, n_ap) + yield start, stop, self[start:stop, :, :] + + def projections(self) -> tuple[np.ndarray, np.ndarray, np.ndarray]: + """Whole-brain silhouette, as the three orthogonal max-projections. + + Returns ``(over_ML, over_AP, over_DV)`` with shapes ``(AP, DV)``, + ``(DV, ML)`` and ``(AP, ML)`` — the masks the locator falls back to when + the tip lies outside the volume. Computed slab-wise, so peak RAM is one + slab rather than the volume plus a full-size bool array, and cached + because the result is a few hundred KB and the scan is the expensive + part. + """ + if self._projections is not None: + return self._projections + + n_ap, n_dv, n_ml = self.shape + over_ml = np.zeros((n_ap, n_dv), dtype=bool) + over_ap = np.zeros((n_dv, n_ml), dtype=bool) + over_dv = np.zeros((n_ap, n_ml), dtype=bool) + for start, stop, block in self._slabs(): + inside = block > 0 + over_ml[start:stop] = inside.any(axis=2) + over_ap |= inside.any(axis=0) + over_dv[start:stop] = inside.any(axis=1) + + self._projections = (over_ml, over_ap, over_dv) + return self._projections + + def find_label_voxels(self, ids) -> tuple[np.ndarray, np.ndarray, np.ndarray]: + """Canonical ``(AP, DV, ML)`` indices of every voxel labelled in ``ids``. + + Slab-wise for the same reason as :meth:`projections`: ``np.isin`` over a + whole volume allocates a bool array the size of the voxel count on top + of the volume itself — 1.2 GB for a 10 µm atlas. + """ + ids = np.asarray(list(ids)) + ap_out: list = [] + dv_out: list = [] + ml_out: list = [] + for start, _stop, block in self._slabs(): + ap, dv, ml = np.where(np.isin(block, ids)) + if ap.size: + ap_out.append(ap + start) + dv_out.append(dv) + ml_out.append(ml) + if not ap_out: + empty = np.zeros(0, dtype=int) + return empty, empty.copy(), empty.copy() + return ( + np.concatenate(ap_out), + np.concatenate(dv_out), + np.concatenate(ml_out), + ) + + +def _native_index(i: int, n: int, flip: bool) -> int: + """Canonical position ``i`` as an index into a possibly-reversed native axis.""" + return n - 1 - i if flip else i + + +def _native_slice(item: slice, n: int, flip: bool) -> slice: + """Canonical slice as a *forward* native slice (the caller re-flips the read). + + Zarr has no negative-step indexing, so a flipped axis is read forward over + the mirrored range and the resulting block reversed afterwards. + """ + start, stop, step = item.indices(n) + if step != 1: + raise TypeError("CanonicalVolume supports step-1 slices only") + return slice(n - stop, n - start) if flip else slice(start, stop) diff --git a/pixelmap/gui/gui.py b/pixelmap/gui/gui.py index be7044e..14c3a21 100644 --- a/pixelmap/gui/gui.py +++ b/pixelmap/gui/gui.py @@ -1374,6 +1374,9 @@ def compute_anatomy_overlay(self): tilt_deg = float(self.tilt_input.value) try: + # Reuse this session's figure: building one per render cost 3.1 MB + # of RSS per overlay compute, and the overlay recomputes on every + # pose edit. _fig = render_locator( atlas_name, tip_atlas=tip, @@ -1387,12 +1390,18 @@ def compute_anatomy_overlay(self): ml_squish=ml_squish, dv_squish=dv_squish, tilt_deg=tilt_deg, + fig=self._locator_fig, ) + self._locator_fig = _fig self.anatomy_locator.object = self._fig_to_locator_html(_fig) - plt.close(_fig) except Exception as exc: # a failed locator shouldn't sink the overlay print(f"Locator render failed: {exc}") + # Hand back the chunk buffers this render churned through. They are + # already freed; this is what unmaps them, so repeated overlay computes + # don't ratchet RSS upward for the life of the process. + anatomy_atlas.reclaim_free_memory() + # Overlay now exists → later input edits live-update it. self._anatomy_overlay_active = True self.anatomy_locator_section.visible = True @@ -1415,6 +1424,9 @@ def clear_anatomy_overlay(self): self.anatomy_locator.object = "" self.anatomy_locator_section.visible = False self._update_tip_depth_readout() # back to a blank readout + if self._locator_fig is not None: + plt.close(self._locator_fig) + self._locator_fig = None # Hand back the atlas's RAM: nothing on screen needs it any more, and an # annotation volume is 308 MB for allen_mouse_25um and up to 4.8 GB for @@ -2678,6 +2690,9 @@ def create_widgets(self): self.clear_anatomy_button.on_click(lambda event: self.clear_anatomy_overlay()) self.anatomy_legend = pn.pane.HTML(self._empty_legend_html(), sizing_mode="stretch_width") self.anatomy_locator = pn.pane.HTML("", sizing_mode="stretch_width") + # Reused across renders (see compute_anatomy_overlay); dropped when the + # overlay is cleared so an idle session doesn't sit on a canvas. + self._locator_fig = None # Hidden until the first overlay is computed; cleared by "Clear overlay". self.anatomy_locator_section = pn.Column( self.anatomy_locator, diff --git a/scripts/prefetch_atlases.py b/scripts/prefetch_atlases.py index 86924b9..b951334 100755 --- a/scripts/prefetch_atlases.py +++ b/scripts/prefetch_atlases.py @@ -21,13 +21,20 @@ Set ``PREFETCH_ALLOW_PARTIAL=1`` to downgrade the failure to a warning. That is for local experimentation only — never for a release build. -Why reading ``.annotation`` matters ------------------------------------ +Why this goes through PixelMap's own loader +------------------------------------------- ``BrainGlobeAtlas(...)`` only fetches the manifest and metadata — a few -hundred KB — and pulls the annotation array from S3 lazily, the first time -something reads ``atlas.annotation``. Constructing the atlas would therefore -"succeed" while leaving the expensive part for the first user to hit at -runtime, which is exactly what this script exists to prevent. +hundred KB — and pulls the annotation from S3 lazily. Constructing the atlas +would therefore "succeed" while leaving the expensive part for the first user +to hit at runtime, which is exactly what this script exists to prevent. + +So it calls ``pixelmap.anatomy.atlas.ensure_downloaded`` and then asserts +``is_downloaded``: the same two functions the GUI uses to decide whether +opening an atlas is free. Going through the app's loader rather than +brainglobe's means "the build warmed the cache" and "the app considers the +atlas local" cannot drift apart — and it puts the chunks on disk without +materialising the array, which brainglobe's ``.annotation`` would (3.4x the +array size in peak RAM, for data we only want cached). """ import os @@ -61,13 +68,19 @@ def warm_registry() -> bool: def fetch(atlas_name: str) -> bool: """Download one atlas, retrying transient failures. True if it landed.""" - from brainglobe_atlasapi import BrainGlobeAtlas + from pixelmap.anatomy.atlas import ( + ensure_downloaded, + is_downloaded, + release_atlas_memory, + ) for attempt, delay in enumerate((*RETRY_DELAYS, None), start=1): try: - atlas = BrainGlobeAtlas(atlas_name, check_latest=False) - # Force the annotation onto disk (see the module docstring). - _ = atlas.annotation + ensure_downloaded(atlas_name) + # Ask the same question the GUI asks before calling an atlas free. + if not is_downloaded(atlas_name): + raise RuntimeError("annotation chunks are still missing") + release_atlas_memory() print(f"[prefetch] {atlas_name}: ok", flush=True) return True except Exception as exc: # noqa: BLE001 - retried, then reported below diff --git a/tests/test_anatomy_atlas.py b/tests/test_anatomy_atlas.py index e54d52d..05bd59a 100644 --- a/tests/test_anatomy_atlas.py +++ b/tests/test_anatomy_atlas.py @@ -378,12 +378,26 @@ def test_unreadable_cache_falls_back_instead_of_raising(self, monkeypatch, tmp_p class TestEnsureDownloaded: - def test_materialises_the_annotation(self, monkeypatch): + """``ensure_downloaded`` must actually fetch the data, not just construct. + + Constructing a ``BrainGlobeAtlas`` pulls only the manifest and metadata — + a few hundred KB — and leaves the annotation on S3. An ``ensure_downloaded`` + that stopped there would shift the real download onto the first user to open + the anatomy panel, on the Bokeh event loop, which is what it exists to + prevent. (It no longer *materialises* the array: with the lazy volume it + only guarantees the data is on disk. For a double with no zarr store to + resolve, that falls back to reading ``annotation``.) + """ + + def test_fetches_the_annotation_data(self, monkeypatch): reads = [] class _A: def __init__(self, name, **_kwargs): self.name = name + self.orientation = "asr" + self.resolution = (25.0, 25.0, 25.0) + self.shape = (2, 2, 2) @property def annotation(self): @@ -394,6 +408,28 @@ def annotation(self): atlas_module.ensure_downloaded("some_atlas") assert reads == ["some_atlas"] + def test_constructing_alone_is_not_enough(self, monkeypatch): + """Guards the failure that shipped three cold images: a build that + 'succeeded' because the atlas object existed, while the data never + left S3.""" + reads = [] + + class _A: + def __init__(self, name, **_kwargs): + self.name = name + self.orientation = "asr" + self.resolution = (25.0, 25.0, 25.0) + self.shape = (2, 2, 2) + + @property + def annotation(self): + reads.append(self.name) + return np.zeros((2, 2, 2), np.int32) + + monkeypatch.setattr(atlas_module, "BrainGlobeAtlas", _A) + atlas_module.get_atlas("some_atlas") + assert reads == [], "constructing an atlas must not fetch the annotation" + class TestAtlasesAreReleased: """Atlas objects must not outlive ``get_atlas``'s cache. diff --git a/tests/test_anatomy_schematic.py b/tests/test_anatomy_schematic.py index ad1577b..c73ce03 100644 --- a/tests/test_anatomy_schematic.py +++ b/tests/test_anatomy_schematic.py @@ -180,3 +180,92 @@ def test_rendering_many_atlases_keeps_one_annotation_resident(monkeypatch): f"{live} annotation volumes still in RAM after rendering atlas_{i}; " "exactly 1 is allowed" ) + + +class TestSilhouetteIsOnlyBuiltWhenNeeded: + """The whole-brain silhouette is the one thing here that reads every voxel. + + It is the fallback for a tip outside the volume, so on the normal path — + tip in the brain, three real slices to draw — it must never be built. It + used to be computed unconditionally (``inside = ann > 0``), which cost a + full-size bool array on every single render: 1.2 GB for a 10 µm atlas. + """ + + @staticmethod + def _count_projections(monkeypatch) -> list[int]: + from pixelmap.anatomy.volume import CanonicalVolume + + calls = [0] + original = CanonicalVolume.projections + + def counted(self): + calls[0] += 1 + return original(self) + + monkeypatch.setattr(CanonicalVolume, "projections", counted) + return calls + + def test_tip_inside_the_volume_never_builds_it(self, fake_brainglobe, monkeypatch): + calls = self._count_projections(monkeypatch) + _render() + assert calls[0] == 0, "silhouette was built even though every view had a slice" + + def test_tip_outside_the_volume_falls_back_to_it(self, fake_brainglobe, monkeypatch): + calls = self._count_projections(monkeypatch) + # Far outside the 8x6x10-voxel fake brain. + render_locator( + "fake", + tip_atlas=(50_000.0, 50_000.0, 50_000.0), + pitch_deg=0.0, + yaw_deg=0.0, + shank_orientation_deg=0.0, + shank_positions={0: 0.0}, + y_range=(0.0, 80.0), + ) + assert calls[0] > 0, "no slice to draw, but the silhouette was never built" + + +class TestFigureReuse: + """``render_locator`` must be able to draw into a caller-owned figure. + + Building a ``Figure`` per render — with its Agg canvas and renderer — cost + 3.1 MB of unreturned RSS per call in the container, more than the atlas read + it wraps, and the overlay re-renders on every pose edit. + """ + + def test_passing_a_figure_draws_into_it(self, fake_brainglobe): + first = _render() + second = render_locator( + "fake", + tip_atlas=(100.0, 100.0, 75.0), + pitch_deg=0.0, + yaw_deg=0.0, + shank_orientation_deg=0.0, + shank_positions={0: 0.0, 1: 50.0}, + y_range=(0.0, 80.0), + fig=first, + ) + assert second is first, "render_locator built a new figure instead of reusing" + + def test_reuse_does_not_accumulate_axes(self, fake_brainglobe): + """Without a clear, every render would stack another set of axes on.""" + fig = _render() + n_axes = len(fig.axes) + for _ in range(5): + fig = render_locator( + "fake", + tip_atlas=(100.0, 100.0, 75.0), + pitch_deg=0.0, + yaw_deg=0.0, + shank_orientation_deg=0.0, + shank_positions={0: 0.0, 1: 50.0}, + y_range=(0.0, 80.0), + fig=fig, + ) + assert len(fig.axes) == n_axes, ( + f"{len(fig.axes)} axes after 6 renders, expected {n_axes} — the " + "figure is not being cleared between renders" + ) + + def test_omitting_the_figure_still_builds_a_fresh_one(self, fake_brainglobe): + assert _render() is not _render() diff --git a/tests/test_anatomy_volume.py b/tests/test_anatomy_volume.py new file mode 100644 index 0000000..01d5d10 --- /dev/null +++ b/tests/test_anatomy_volume.py @@ -0,0 +1,210 @@ +"""Tests for the lazy, canonically-oriented annotation reader. + +Two things have to hold, and they pull in opposite directions: + +* **Correctness** — a ``CanonicalVolume`` must be indistinguishable from the + eagerly reoriented array it replaces, for every atlas orientation. The + reference here is literally the expression the old ``canonical_annotation`` + used, so any divergence in the transpose/flip logic shows up immediately. +* **Laziness** — it must not read more of the store than the caller asked for. + Correctness alone would be satisfied by materialising everything, which is + precisely the behaviour being removed, so the reads are spied on. +""" + +from __future__ import annotations + +import itertools + +import numpy as np +import pytest + +from pixelmap.anatomy.atlas import anatomical_axes +from pixelmap.anatomy.volume import CanonicalVolume + +# Every orientation brainglobe can express: one letter per anatomical axis, +# in any axis order — 3! orderings x 2^3 directions. +ALL_ORIENTATIONS = [ + "".join(p) + for axes in itertools.permutations("ASL") + for p in itertools.product(*[{"A": "ap", "S": "si", "L": "lr"}[c] for c in axes]) +] + + +class _FakeAtlas: + def __init__(self, orientation, arr): + self.orientation = orientation + self.annotation = arr + self.shape = arr.shape + self.resolution = (25.0, 25.0, 25.0) + + +class _SpyStore: + """Wraps an ndarray and records every index tuple asked of it.""" + + def __init__(self, arr): + self._arr = arr + self.shape = arr.shape + self.dtype = arr.dtype + self.chunks = (2, 2, 2) + self.reads: list = [] + + def __getitem__(self, key): + self.reads.append(key) + return self._arr[key] + + def read_volume(self) -> int: + """Total voxels pulled out of the store across all reads.""" + total = 0 + for key in self.reads: + shape = self._arr[key].shape + total += int(np.prod(shape)) if shape else 1 + return total + + +def _build(orientation, arr): + """A CanonicalVolume plus the eagerly-reoriented reference array.""" + atlas = _FakeAtlas(orientation, arr) + axes = anatomical_axes(atlas) + vol = CanonicalVolume(arr, axes, (25.0, 25.0, 25.0)) + + order = (axes["AP"].array_axis, axes["DV"].array_axis, axes["ML"].array_axis) + ref = np.transpose(arr, order) + flips = tuple(i for i, k in enumerate(("AP", "DV", "ML")) if axes[k].flip) + if flips: + ref = np.flip(ref, axis=flips) + return vol, ref + + +@pytest.mark.parametrize("orientation", ALL_ORIENTATIONS) +class TestMatchesTheEagerReorientation: + """The lazy reader must agree with transpose+flip on the full array.""" + + ARR = np.arange(4 * 5 * 6, dtype=np.int32).reshape(4, 5, 6) + + def test_shape_and_full_materialisation(self, orientation): + vol, ref = _build(orientation, self.ARR) + assert vol.shape == ref.shape + np.testing.assert_array_equal(np.asarray(vol), ref) + + def test_every_orthogonal_slice(self, orientation): + vol, ref = _build(orientation, self.ARR) + n_ap, n_dv, n_ml = ref.shape + for i in range(n_ap): + np.testing.assert_array_equal(vol[i, :, :], ref[i, :, :]) + for j in range(n_dv): + np.testing.assert_array_equal(vol[:, j, :], ref[:, j, :]) + for k in range(n_ml): + np.testing.assert_array_equal(vol[:, :, k], ref[:, :, k]) + + def test_sub_boxes_and_scalars(self, orientation): + vol, ref = _build(orientation, self.ARR) + rng = np.random.default_rng(0) + n_ap, n_dv, n_ml = ref.shape + for _ in range(15): + a0, a1 = sorted(rng.integers(0, n_ap + 1, 2)) + d0, d1 = sorted(rng.integers(0, n_dv + 1, 2)) + m0, m1 = sorted(rng.integers(0, n_ml + 1, 2)) + np.testing.assert_array_equal( + vol[a0:a1, d0:d1, m0:m1], ref[a0:a1, d0:d1, m0:m1] + ) + for a, d, m in itertools.product(range(n_ap), range(n_dv), range(n_ml)): + assert vol[a, d, m] == ref[a, d, m] + + def test_gather_matches_fancy_indexing(self, orientation): + vol, ref = _build(orientation, self.ARR) + rng = np.random.default_rng(1) + ap = rng.integers(0, ref.shape[0], 50) + dv = rng.integers(0, ref.shape[1], 50) + ml = rng.integers(0, ref.shape[2], 50) + np.testing.assert_array_equal(vol.gather(ap, dv, ml), ref[ap, dv, ml]) + + def test_projections_match_the_eager_silhouette(self, orientation): + arr = self.ARR.copy() + arr[arr % 3 == 0] = 0 # carve holes so the projections aren't all-True + vol, ref = _build(orientation, arr) + inside = ref > 0 + over_ml, over_ap, over_dv = vol.projections() + np.testing.assert_array_equal(over_ml, inside.any(axis=2)) + np.testing.assert_array_equal(over_ap, inside.any(axis=0)) + np.testing.assert_array_equal(over_dv, inside.any(axis=1)) + + def test_find_label_voxels_matches_isin(self, orientation): + vol, ref = _build(orientation, self.ARR) + ids = [int(v) for v in np.unique(ref)[3:7]] + got = vol.find_label_voxels(ids) + expected = np.where(np.isin(ref, ids)) + for g, e in zip(got, expected): + np.testing.assert_array_equal(np.sort(g), np.sort(e)) + + +class TestReadsAreBounded: + """The whole point: never pull more out of the store than was asked for.""" + + ARR = np.arange(8 * 8 * 8, dtype=np.int32).reshape(8, 8, 8) % 5 + + def test_a_2d_slice_does_not_read_the_volume(self): + atlas = _FakeAtlas("asr", self.ARR) + spy = _SpyStore(self.ARR) + vol = CanonicalVolume(spy, anatomical_axes(atlas), (25.0, 25.0, 25.0)) + + vol[4, :, :] + + assert spy.read_volume() == 8 * 8, ( + f"read {spy.read_volume()} voxels for a 64-voxel slice — the " + "whole volume is being materialised" + ) + + def test_gather_reads_only_the_bounding_box(self): + atlas = _FakeAtlas("asr", self.ARR) + spy = _SpyStore(self.ARR) + vol = CanonicalVolume(spy, anatomical_axes(atlas), (25.0, 25.0, 25.0)) + + ap = np.array([1, 2, 1]) + dv = np.array([0, 1, 1]) + ml = np.array([5, 6, 5]) + out = vol.gather(ap, dv, ml) + + np.testing.assert_array_equal(out, self.ARR[ap, dv, ml]) + assert len(spy.reads) == 1, "gather must issue exactly one read" + assert spy.read_volume() == 2 * 2 * 2, ( + f"read {spy.read_volume()} voxels for a 2x2x2 bounding box" + ) + + def test_whole_volume_scans_are_slabbed_not_materialised(self, monkeypatch): + import pixelmap.anatomy.volume as volume_module + + # One slab per 2 AP planes, so a full scan needs several reads. + monkeypatch.setattr(volume_module, "_SLAB_BYTES", 2 * 8 * 8 * 4) + atlas = _FakeAtlas("asr", self.ARR) + spy = _SpyStore(self.ARR) + vol = CanonicalVolume(spy, anatomical_axes(atlas), (25.0, 25.0, 25.0)) + + vol.projections() + + assert len(spy.reads) > 1, "a full scan must be slabbed, not one big read" + biggest = max(int(np.prod(self.ARR[k].shape)) for k in spy.reads) + assert biggest < self.ARR.size, ( + "a single slab pulled the whole volume — peak RAM is unbounded" + ) + + +class TestRejectsUnsupportedIndexing: + """Fail loudly rather than silently returning the wrong voxels.""" + + ARR = np.zeros((4, 4, 4), dtype=np.int32) + + def _vol(self): + atlas = _FakeAtlas("asr", self.ARR) + return CanonicalVolume(self.ARR, anatomical_axes(atlas), (25.0, 25.0, 25.0)) + + def test_wrong_number_of_axes(self): + with pytest.raises(IndexError): + self._vol()[1, 2] + + def test_strided_slice(self): + with pytest.raises(TypeError): + self._vol()[::2, :, :] + + def test_fancy_indexing_points_at_gather(self): + with pytest.raises(TypeError): + self._vol()[np.array([0, 1]), :, :] diff --git a/tests/test_gui_overlays.py b/tests/test_gui_overlays.py index 5091f01..eae78dc 100644 --- a/tests/test_gui_overlays.py +++ b/tests/test_gui_overlays.py @@ -738,3 +738,28 @@ def test_recomputing_after_a_clear_still_works(self, posed_gui): assert len(posed_gui.region_band_source.data["acronym"]) > 0, ( "overlay did not come back after a release" ) + + +class TestLocatorFigureIsReusedAcrossRenders: + """The GUI must keep one locator figure per session, not one per render.""" + + def test_recomputing_reuses_the_same_figure(self, posed_gui): + posed_gui.compute_anatomy_overlay() + first = posed_gui._locator_fig + assert first is not None, "no locator figure was retained" + + for _ in range(4): + posed_gui.compute_anatomy_overlay() + + assert posed_gui._locator_fig is first, ( + "a new figure was built per overlay compute — 3.1 MB of RSS each, " + "on a path that re-runs for every pose edit" + ) + + def test_clearing_the_overlay_drops_the_figure(self, posed_gui): + posed_gui.compute_anatomy_overlay() + assert posed_gui._locator_fig is not None + posed_gui.clear_anatomy_overlay() + assert posed_gui._locator_fig is None, ( + "an idle session is still holding a matplotlib canvas" + ) From 4b49107adfbffd5fcd23a4aa13d2fb09e042243c Mon Sep 17 00:00:00 2001 From: m-beau Date: Fri, 18 Sep 2026 19:16:07 -0400 Subject: [PATCH 06/17] minor version bump: 1.4.0 --- pixelmap/__init__.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pixelmap/__init__.py b/pixelmap/__init__.py index 330d4c3..42aaeb3 100644 --- a/pixelmap/__init__.py +++ b/pixelmap/__init__.py @@ -7,6 +7,6 @@ from .backend import * -__version__ = "1.3.1" +__version__ = "1.4.0" __author__ = "Maxime Beau" __email__ = "maxime@princeton.edu" From 4b86fd466613dc1397d1ca54132051321cf1e736 Mon Sep 17 00:00:00 2001 From: m-beau Date: Mon, 21 Sep 2026 09:36:39 -0400 Subject: [PATCH 07/17] PNI abbreviation --- paper/paper.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/paper/paper.md b/paper/paper.md index 047428f..53b0d92 100644 --- a/paper/paper.md +++ b/paper/paper.md @@ -111,7 +111,7 @@ PixelMap addresses a practical bottleneck in Neuropixels experimental workflows. PixelMap is released under an open-source licence (GPLv3), provides comprehensive documentation including a [contributor guide](https://pixelmap-neuropixels.readthedocs.io/en/latest/development.html), and is accessible via web application, Python package, Docker container, or programmatic API. It builds on the authors' track record using Neuropixels probes [@steinmetz2021; @bondy2024; @beau2025; @fabre2026basal] and developing Neuropixels software [@beau2021]. -Adoption is evidenced by deployment on PNI's public server, 59 GitHub stars, and web traffic of roughly 400 unique visitors between March and May 2026 (~45/week; see the [analytics](https://github.com/m-beau/pixelmap/tree/main/analytics) folder of the repository). The package has been under active development for over ten months, with external contributors implementing new features (anatomical and activity overlays). +Adoption is evidenced by deployment on Princeton Neuroscience Institute's (PNI) public server, 59 GitHub stars, and web traffic of roughly 400 unique visitors between March and May 2026 (~45/week; see the [analytics](https://github.com/m-beau/pixelmap/tree/main/analytics) folder of the repository). The package has been under active development for over ten months, with external contributors implementing new features (anatomical and activity overlays). # AI Usage Disclosure From cb76a5b10a10a7ba29227a27ac88fa1d6fbf6af7 Mon Sep 17 00:00:00 2001 From: m-beau Date: Mon, 21 Sep 2026 13:37:52 +0000 Subject: [PATCH 08/17] (auto) Paper PDF Draft --- paper/paper.pdf | Bin 815168 -> 815243 bytes 1 file changed, 0 insertions(+), 0 deletions(-) diff --git a/paper/paper.pdf b/paper/paper.pdf index 33fd1d3c77d217fd4e8fd4286befa471079815a1..eaa411a5d7e9da4270c85774e117cb792a35b1dc 100644 GIT binary patch delta 11595 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 UgwE&`sPC^cR9adIB}vr(2TDl#9RL6T delta 11556 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 From 108eb35b7eb1857c7e986237e6dcd0dddd2eb03b Mon Sep 17 00:00:00 2001 From: m-beau Date: Mon, 21 Sep 2026 10:47:01 -0400 Subject: [PATCH 09/17] make figure 1 fit in white space --- paper/paper.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/paper/paper.md b/paper/paper.md index 53b0d92..26c7912 100644 --- a/paper/paper.md +++ b/paper/paper.md @@ -35,6 +35,10 @@ affiliations: index: 2 date: 29 May 2026 bibliography: paper.bib +header-includes: + # Let the figure caption use the (otherwise empty) left margin, so that + # Figure 1 and its caption fit on the same page as the preceding text. + - \captionsetup{margin={-\dimexpr\marginparwidth+\marginparsep\relax,0pt}} --- # Summary @@ -95,9 +99,9 @@ PixelMap's architecture is designed to easily support future hardware and atlase **Contributor extensibility.** The codebase is written as comprehensively as possible with contributions in mind. New selection presets can be added to `backend.py`, new overlay types can follow the pattern established by the activity-survey and anatomy overlays, and the GUI layer can be extended or replaced without modifying the core constraint logic. This modular design, together with comprehensive tests and a [contributor guide](https://pixelmap-neuropixels.readthedocs.io/en/latest/development.html), is intended to make contribution straightforward. These design choices have already enabled two new contributors to add significant features in 2026, warranting authorship on this paper: the anatomical overlay (J.M.J.F.) and the activity survey overlay (J.Y.). ![PixelMap's browser-based graphical user interface, shown here for a four-shank Neuropixels 2.0 probe.\ -**Left:** *Probe and recording metadata* panel (these metadata are also written into `.imro` files), followed by three of the four methods of electrode selection: *Preset Selection* (preset geometries), *Textual Selection* (manual input of electrode ranges), and *Selection from IMRO file* (pre-loading an existing `.imro` file). These three methods can be mixed with each other and with the five interactive click-and-drag box tools, whose toolbar sits along the right edge of the central panel. Controls for the activity survey and anatomical overlays are further down this panel, below the cropped view.\ -**Centre:** main panel featuring the probe's physical layout with one or four shanks that exhibit the 960 (Neuropixels 1.0) or 1,280 (Neuropixels 2.0, Quad Base) physical electrodes per shank to be selected from. Electrodes available for selection are light grey, selected electrodes turn red, and electrodes that become unavailable due to hardware wiring constraints turn black. In this example, 384 electrodes have been selected (matching the maximum simultaneous recording capacity of this probe), with a pattern distributed across multiple banks and shanks, illustrating that PixelMap allows selection of arbitrary channelmap geometries. The optional anatomical overlay, which guides channelmap design, is rendered beside the shanks as coloured depth bands with region labels.\ -**Right:** electrode status indicator that turns green to confirm the selection is complete and is ready for IMRO file generation, above undo, redo and clear-selection controls. Under *Export IMRO table*, users name their file and export their configuration with the "IMRO" button for direct use in SpikeGLX, optionally alongside a "PDF" visualisation to easily remember the geometry of the corresponding `.imro` file in the future, and a "Kilosort" channelmap for subsequent spike sorting. *Share this layout* encodes the current selection into a shareable link, and *Anatomical overlay* displays the insertion trajectory on sagittal, coronal and horizontal atlas sections together with a legend of the traversed regions. PixelMap's instructions continue below the cropped view.](Figure1.png) +**Left:** *Probe and recording metadata* panel (these metadata are also written into `.imro` files), followed by three of the four methods of electrode selection: *Preset Selection* (preset geometries), *Textual Selection* (manual input of electrode ranges), and *Selection from IMRO file* (pre-loading an existing `.imro` file). These three methods can be mixed with each other and with the five interactive click-and-drag box tools, whose toolbar sits along the right edge of the central panel. Activity survey and anatomical overlay controls are further down this panel, below the cropped view.\ +**Centre:** main panel featuring the probe's physical layout: one or four shanks bearing the 960 (Neuropixels 1.0) or 1,280 (Neuropixels 2.0, Quad Base) physical electrodes to be selected from. Electrodes available for selection are light grey, selected ones red, and those made unavailable by hardware wiring constraints black. Here, 384 electrodes have been selected, matching this probe's maximum simultaneous recording capacity, in a pattern distributed across multiple banks and shanks, illustrating that PixelMap allows arbitrary channelmap geometries. The optional anatomical overlay, which guides channelmap design, is rendered beside the shanks as coloured depth bands with region labels.\ +**Right:** electrode status indicator, which turns green once the selection is complete and ready for IMRO file generation, above undo, redo and clear-selection controls. Under *Export IMRO table*, users name their file and export their configuration with the "IMRO" button for direct use in SpikeGLX, optionally alongside a "PDF" visualisation of the corresponding geometry and a "Kilosort" channelmap for subsequent spike sorting. *Share this layout* encodes the current selection into a shareable link, and *Anatomical overlay* displays the insertion trajectory on sagittal, coronal and horizontal atlas sections with a legend of the traversed regions. PixelMap's instructions continue below the cropped view.](Figure1.png) # Installation and Usage From 52fafae02d0d6fbc613763a213eac78c56f2c96f Mon Sep 17 00:00:00 2001 From: m-beau Date: Mon, 21 Sep 2026 14:48:28 +0000 Subject: [PATCH 10/17] (auto) Paper PDF Draft --- paper/paper.pdf | Bin 815243 -> 812803 bytes 1 file changed, 0 insertions(+), 0 deletions(-) diff --git a/paper/paper.pdf b/paper/paper.pdf index eaa411a5d7e9da4270c85774e117cb792a35b1dc..40875f0cb8f0fd73aa7149322c1b6eda90194bb2 100644 GIT binary patch delta 20457 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 WLj2qaK(vYq1`Y>GN*Y)g0{;&W72DMS delta 21667 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 E59RbxdH?_b From eb850b2fef18aef3370f53e24f7c7c6f5519f16d Mon Sep 17 00:00:00 2001 From: m-beau Date: Wed, 23 Sep 2026 14:31:20 -0400 Subject: [PATCH 11/17] make figure 1 fit in white space --- paper/paper.md | 32 +++++++++++++++++++++++++------- 1 file changed, 25 insertions(+), 7 deletions(-) diff --git a/paper/paper.md b/paper/paper.md index 26c7912..62010bc 100644 --- a/paper/paper.md +++ b/paper/paper.md @@ -35,10 +35,6 @@ affiliations: index: 2 date: 29 May 2026 bibliography: paper.bib -header-includes: - # Let the figure caption use the (otherwise empty) left margin, so that - # Figure 1 and its caption fit on the same page as the preceding text. - - \captionsetup{margin={-\dimexpr\marginparwidth+\marginparsep\relax,0pt}} --- # Summary @@ -98,10 +94,32 @@ PixelMap's architecture is designed to easily support future hardware and atlase **Contributor extensibility.** The codebase is written as comprehensively as possible with contributions in mind. New selection presets can be added to `backend.py`, new overlay types can follow the pattern established by the activity-survey and anatomy overlays, and the GUI layer can be extended or replaced without modifying the core constraint logic. This modular design, together with comprehensive tests and a [contributor guide](https://pixelmap-neuropixels.readthedocs.io/en/latest/development.html), is intended to make contribution straightforward. These design choices have already enabled two new contributors to add significant features in 2026, warranting authorship on this paper: the anatomical overlay (J.M.J.F.) and the activity survey overlay (J.Y.). +```{=latex} +\makeatletter +% JOSS's template forces every figure to [H] (float package), which wraps the +% figure in a single unbreakable box. Figure 1's caption is long, so that box +% does not fit in the space left on the page and LaTeX pushes the whole figure +% to the next page, leaving a large gap. Contribute the figure to the main +% vertical list instead, and typeset the caption as an ordinary paragraph, so +% the caption can break across pages. PDF only: the markdown is untouched, so +% the JATS/HTML outputs are unaffected. +\renewenvironment{figure}[1][]{% + \par\addvspace{\intextsep}% + \def\@captype{figure}% +}{% + \par\addvspace{\intextsep}% +} +\long\def\@makecaption#1#2{% + \vskip\abovecaptionskip\nobreak + \begingroup\captionfont\noindent{\captionlabelfont #1:} #2\par\endgroup + \vskip\belowcaptionskip} +\makeatother +``` + ![PixelMap's browser-based graphical user interface, shown here for a four-shank Neuropixels 2.0 probe.\ -**Left:** *Probe and recording metadata* panel (these metadata are also written into `.imro` files), followed by three of the four methods of electrode selection: *Preset Selection* (preset geometries), *Textual Selection* (manual input of electrode ranges), and *Selection from IMRO file* (pre-loading an existing `.imro` file). These three methods can be mixed with each other and with the five interactive click-and-drag box tools, whose toolbar sits along the right edge of the central panel. Activity survey and anatomical overlay controls are further down this panel, below the cropped view.\ -**Centre:** main panel featuring the probe's physical layout: one or four shanks bearing the 960 (Neuropixels 1.0) or 1,280 (Neuropixels 2.0, Quad Base) physical electrodes to be selected from. Electrodes available for selection are light grey, selected ones red, and those made unavailable by hardware wiring constraints black. Here, 384 electrodes have been selected, matching this probe's maximum simultaneous recording capacity, in a pattern distributed across multiple banks and shanks, illustrating that PixelMap allows arbitrary channelmap geometries. The optional anatomical overlay, which guides channelmap design, is rendered beside the shanks as coloured depth bands with region labels.\ -**Right:** electrode status indicator, which turns green once the selection is complete and ready for IMRO file generation, above undo, redo and clear-selection controls. Under *Export IMRO table*, users name their file and export their configuration with the "IMRO" button for direct use in SpikeGLX, optionally alongside a "PDF" visualisation of the corresponding geometry and a "Kilosort" channelmap for subsequent spike sorting. *Share this layout* encodes the current selection into a shareable link, and *Anatomical overlay* displays the insertion trajectory on sagittal, coronal and horizontal atlas sections with a legend of the traversed regions. PixelMap's instructions continue below the cropped view.](Figure1.png) +**Left:** *Probe and recording metadata* panel (these metadata are also written into `.imro` files), followed by three of the four methods of electrode selection: *Preset Selection* (preset geometries), *Textual Selection* (manual input of electrode ranges), and *Selection from IMRO file* (pre-loading an existing `.imro` file). These three methods can be mixed with each other and with the five interactive click-and-drag box tools, whose toolbar sits along the right edge of the central panel. Controls for the activity survey and anatomical overlays are further down this panel, below the cropped view.\ +**Centre:** main panel featuring the probe's physical layout with one or four shanks that exhibit the 960 (Neuropixels 1.0) or 1,280 (Neuropixels 2.0, Quad Base) physical electrodes per shank to be selected from. Electrodes available for selection are light grey, selected electrodes turn red, and electrodes that become unavailable due to hardware wiring constraints turn black. In this example, 384 electrodes have been selected (matching the maximum simultaneous recording capacity of this probe), with a pattern distributed across multiple banks and shanks, illustrating that PixelMap allows selection of arbitrary channelmap geometries. The optional anatomical overlay, which guides channelmap design, is rendered beside the shanks as coloured depth bands with region labels.\ +**Right:** electrode status indicator that turns green to confirm the selection is complete and is ready for IMRO file generation, above undo, redo and clear-selection controls. Under *Export IMRO table*, users name their file and export their configuration with the "IMRO" button for direct use in SpikeGLX, optionally alongside a "PDF" visualisation to easily remember the geometry of the corresponding `.imro` file in the future, and a "Kilosort" channelmap for subsequent spike sorting. *Share this layout* encodes the current selection into a shareable link, and *Anatomical overlay* displays the insertion trajectory on sagittal, coronal and horizontal atlas sections together with a legend of the traversed regions. PixelMap's instructions continue below the cropped view.](Figure1.png) # Installation and Usage From 412e217bb708438fa497f8fb7ee9c0586f365ddf Mon Sep 17 00:00:00 2001 From: m-beau Date: Wed, 23 Sep 2026 18:32:11 +0000 Subject: [PATCH 12/17] (auto) Paper PDF Draft --- paper/paper.pdf | Bin 812803 -> 813383 bytes 1 file changed, 0 insertions(+), 0 deletions(-) diff --git a/paper/paper.pdf b/paper/paper.pdf index 40875f0cb8f0fd73aa7149322c1b6eda90194bb2..9001cedf78eb53b0630738607424065a52d421c5 100644 GIT binary patch delta 21007 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 JucoI?{U044p>F^H From 1663adab222286a44a0a52f133a226e7e836c611 Mon Sep 17 00:00:00 2001 From: Christian Tabedzki <35670232+tabedzki@users.noreply.github.com> Date: Wed, 23 Sep 2026 14:55:02 -0400 Subject: [PATCH 13/17] docs: add CITATION.cff referencing the JOSS paper and v1.4.0 release Add machine-readable citation metadata so GitHub shows a "Cite this repository" button. The preferred citation is the JOSS paper (10.21105/joss.11008); the software entry points to the v1.4.0 JOSS release archived on Zenodo (10.5281/zenodo.22850328), with the concept DOI listed for all versions. Builds on #45. Assisted-by: ClaudeCode:claude-opus-5-5 --- CITATION.cff | 64 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 64 insertions(+) create mode 100644 CITATION.cff diff --git a/CITATION.cff b/CITATION.cff new file mode 100644 index 0000000..24f7b69 --- /dev/null +++ b/CITATION.cff @@ -0,0 +1,64 @@ +cff-version: 1.2.0 +message: If you use this software, please cite the JOSS paper below. +title: 'PixelMap: A Browser-Based Tool for Wiring-Aware, Anatomy- and Activity-Guided Design of Neuropixels + Channelmaps' +type: software +authors: +- given-names: Maxime + family-names: Beau + orcid: https://orcid.org/0000-0002-8907-6612 +- given-names: Julie M. J. + family-names: Fabre + orcid: https://orcid.org/0000-0003-0550-0410 +- given-names: Christian + family-names: Tabedzki + orcid: https://orcid.org/0000-0001-8409-6094 +- given-names: Jorge + family-names: Yanar + orcid: https://orcid.org/0000-0003-1416-3567 +- given-names: Carlos D. + family-names: Brody + orcid: https://orcid.org/0000-0002-4201-561X +version: 1.4.0 +date-released: '2026-09-19' +doi: 10.5281/zenodo.22850328 +identifiers: +- type: doi + value: 10.5281/zenodo.22850327 + description: Zenodo concept DOI (all versions) +- type: doi + value: 10.5281/zenodo.22850328 + description: Zenodo archive of the v1.4.0 JOSS release +- type: doi + value: 10.21105/joss.11008 + description: JOSS paper +repository-code: https://github.com/m-beau/pixelmap +url: https://pixelmap.pni.princeton.edu +license: GPL-3.0-only +preferred-citation: + type: article + title: 'PixelMap: A Browser-Based Tool for Wiring-Aware, Anatomy- and Activity-Guided Design of + Neuropixels Channelmaps' + authors: + - given-names: Maxime + family-names: Beau + orcid: https://orcid.org/0000-0002-8907-6612 + - given-names: Julie M. J. + family-names: Fabre + orcid: https://orcid.org/0000-0003-0550-0410 + - given-names: Christian + family-names: Tabedzki + orcid: https://orcid.org/0000-0001-8409-6094 + - given-names: Jorge + family-names: Yanar + orcid: https://orcid.org/0000-0003-1416-3567 + - given-names: Carlos D. + family-names: Brody + orcid: https://orcid.org/0000-0002-4201-561X + journal: Journal of Open Source Software + publisher: + name: Open Journals + year: 2026 + start: 11008 + doi: 10.21105/joss.11008 + url: https://doi.org/10.21105/joss.11008 From e1a36f910e65201c8651caa8548113ea1df7c8e0 Mon Sep 17 00:00:00 2001 From: m-beau Date: Wed, 7 Oct 2026 16:54:10 -0400 Subject: [PATCH 14/17] fixed USA acronym in JOSS paper --- paper/paper.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/paper/paper.md b/paper/paper.md index 62010bc..13c8af1 100644 --- a/paper/paper.md +++ b/paper/paper.md @@ -29,9 +29,9 @@ authors: orcid: 0000-0002-4201-561X affiliation: "1, 2" affiliations: - - name: Princeton Neuroscience Institute, Princeton University, USA + - name: Princeton Neuroscience Institute, Princeton University, United States of America index: 1 - - name: Howard Hughes Medical Institute, USA + - name: Howard Hughes Medical Institute, United States of America index: 2 date: 29 May 2026 bibliography: paper.bib From cd1a07b0ea32428c2cf2fd2cf1ac59bc0465dcf6 Mon Sep 17 00:00:00 2001 From: m-beau Date: Wed, 7 Oct 2026 20:55:25 +0000 Subject: [PATCH 15/17] (auto) Paper PDF Draft --- paper/paper.pdf | Bin 813383 -> 813361 bytes 1 file changed, 0 insertions(+), 0 deletions(-) diff --git a/paper/paper.pdf b/paper/paper.pdf index 9001cedf78eb53b0630738607424065a52d421c5..1c6be07ad6953c6d3b263c87e9d3259f257be39e 100644 GIT binary patch delta 38034 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 From 0caf99862b2a0b5df737341d3f131c682d88b8b9 Mon Sep 17 00:00:00 2001 From: Christian Tabedzki <35670232+tabedzki@users.noreply.github.com> Date: Wed, 14 Oct 2026 14:35:45 -0400 Subject: [PATCH 16/17] fix: release Panel views left behind by destroyed sessions Every closed session leaked in production: Panel registers the per-session NotificationArea in pn.state._views and only removes it via state._notifications[doc], which Panel's own Document.destroy override deletes before Bokeh runs session-destroyed callbacks. The orphaned entry pins the dead Document and often the whole ChannelmapGUI (~90k Electrode objects), so RSS climbed to ~3.4 GB until the container was OOM-killed. Register _release_dead_session_views on session destroy to drop every _views entry still pointing at the dead document. Under the same load idle RSS after cleanup falls from ~1.3-1.4 GB to ~660 MB. Tests: an end-to-end Panel server test (fails before, passes after), unit tests for the hook's edge cases, and a strict-xfail canary that starts failing once Panel fixes the bug so the workaround can go. Refs #6 Assisted-by: ClaudeCode:claude-opus-5-5 --- pixelmap/gui/gui.py | 32 ++++++ tests/test_session_leak.py | 203 +++++++++++++++++++++++++++++++++++++ 2 files changed, 235 insertions(+) create mode 100644 tests/test_session_leak.py diff --git a/pixelmap/gui/gui.py b/pixelmap/gui/gui.py index 14c3a21..5f496f5 100644 --- a/pixelmap/gui/gui.py +++ b/pixelmap/gui/gui.py @@ -3166,6 +3166,37 @@ def _extract_cfg_from_session_args() -> str | None: return value or None +def _release_dead_session_views(session_context): + """Drop every ``pn.state._views`` entry still pointing at a dead session. + + Works around a Panel bug (1.7.5 through at least 1.9.4) that leaked every + closed session in production. Panel registers the per-session + ``NotificationArea`` in ``state._views``, a plain dict holding + ``(view, root, doc, comm)``, and only removes it from the notification + area's ``_server_destroy`` -- which Panel reaches through + ``state._notifications[doc]``. But Panel's ``Document.destroy`` override + deletes ``state._notifications[doc]`` first, and Bokeh destroys the + document *before* running session-destroyed callbacks, so that hook never + fires. The orphaned entry pins the dead Document and, through its models' + callbacks, this session's whole ``ChannelmapGUI`` (~90k ``Electrode`` + objects of wiring maps). RSS climbed to ~3.4 GB and the container was + OOM-killed. + + Order-independent with Panel's own hooks: they skip refs already gone. + """ + doc = getattr(session_context, "_document", None) + if doc is None: + return + for ref, (view, root, view_doc, _comm) in list(pn.state._views.items()): + if view_doc is not doc: + continue + try: + view._cleanup(root) + except Exception as exc: # noqa: BLE001 - a failed cleanup must not keep the session pinned + print(f"View cleanup failed for {type(view).__name__}: {exc}") + pn.state._views.pop(ref, None) + + def create_app(): """Create and configure the Panel app""" # Re-arm the extensions for *this* session. Panel keys `config` on the @@ -3194,6 +3225,7 @@ def create_app(): if pn.state.curdoc: pn.state.curdoc.on_session_destroyed(analytics_tracker.handle_session_destroyed) + pn.state.curdoc.on_session_destroyed(_release_dead_session_views) app_layout = pn.Column(analytics_tracker.cookie_bridge, layout, margin=0) app_layout._analytics_tracker = analytics_tracker diff --git a/tests/test_session_leak.py b/tests/test_session_leak.py new file mode 100644 index 0000000..d8e48c6 --- /dev/null +++ b/tests/test_session_leak.py @@ -0,0 +1,203 @@ +"""Regression tests: a closed browser tab must not keep its session in memory. + +Production RSS grew without bound (~3.4 GB) and the container was OOM-killed. +A load test against the production image showed every closed session leaving +its whole ``ChannelmapGUI`` (plus ~90k ``Electrode`` objects of wiring maps) +alive. The anchor was ``panel.state._views``: Panel registers the per-session +``NotificationArea`` there, and its teardown hook is only reached through +``state._notifications[doc]`` -- which Panel's own ``Document.destroy`` +override deletes *before* Bokeh runs the session-destroyed callbacks. So the +view entry, and through it the dead Document and everything on it, is never +released (Panel 1.7.5 through at least 1.9.4). +""" + +from __future__ import annotations + +import gc +import socket +import time +import types + +import panel as pn +import pytest +from bokeh.client import pull_session +from bokeh.document import Document +from panel.io.state import state + +from pixelmap.gui import gui as gui_module +from pixelmap.gui.gui import _release_dead_session_views + + +def _free_port() -> int: + with socket.socket() as s: + s.bind(("127.0.0.1", 0)) + return s.getsockname()[1] + + +def _wait_for(cond, timeout: float, what: str) -> None: + deadline = time.monotonic() + timeout + while time.monotonic() < deadline: + if cond(): + return + time.sleep(0.1) + raise AssertionError(f"timed out waiting for {what}") + + +def _live_guis() -> int: + gc.collect() + return sum(isinstance(o, gui_module.ChannelmapGUI) for o in gc.get_objects()) + + +def _dead_doc_views() -> list: + """``state._views`` entries whose Document has already been destroyed.""" + return [ref for ref, (_v, _r, doc, _c) in state._views.items() + if doc is not None and not hasattr(doc, "_roots")] + + +# -------------------------------------------------------------------------- +# End to end: real Panel server, real session, real teardown +# -------------------------------------------------------------------------- + +@pytest.fixture +def server(): + port = _free_port() + srv = pn.serve( + {"app": gui_module.create_app}, + port=port, + address="127.0.0.1", + show=False, + threaded=True, + check_unused_sessions_milliseconds=100, + unused_session_lifetime_milliseconds=100, + allow_websocket_origin=[f"127.0.0.1:{port}"], + ) + _wait_for(lambda: srv.server_id in state._servers, 30, "server start") + yield f"http://127.0.0.1:{port}/app", state._servers[srv.server_id][0] + srv.stop() + + +def _sessions(bokeh_server): + return [s for ctx in bokeh_server._tornado._applications.values() + for s in ctx.sessions] + + +@pytest.mark.parametrize("n_sessions", [1, 3]) +def test_closed_sessions_release_their_gui(server, n_sessions): + url, bokeh_server = server + baseline = _live_guis() + + for _ in range(n_sessions): + session = pull_session(url=url) + session.close() + + _wait_for(lambda: not _sessions(bokeh_server), 30, "server sessions to be discarded") + # Teardown runs on the server's loop thread; give it a moment to finish. + _wait_for(lambda: _live_guis() <= baseline, 15, "dead sessions' GUIs to be collected") + + assert _dead_doc_views() == [] + + +# -------------------------------------------------------------------------- +# The hook itself +# -------------------------------------------------------------------------- + +class _FakeView: + def __init__(self): + self.cleaned = [] + + def _cleanup(self, root): + self.cleaned.append(root) + + +class _ExplodingView: + def _cleanup(self, root): + raise RuntimeError("boom") + + +@pytest.fixture +def views(monkeypatch): + monkeypatch.setattr(state, "_views", {}) + return state._views + + +def _ctx(doc): + return types.SimpleNamespace(_document=doc, id="test-session") + + +def test_hook_drops_only_the_dead_documents_views(views): + dead, alive = Document(), Document() + v1, v2, v3 = _FakeView(), _FakeView(), _FakeView() + views["a"] = (v1, "root-a", dead, None) + views["b"] = (v2, "root-b", dead, None) + views["c"] = (v3, "root-c", alive, None) + + _release_dead_session_views(_ctx(dead)) + + assert set(views) == {"c"} + assert v1.cleaned == ["root-a"] and v2.cleaned == ["root-b"] + assert v3.cleaned == [] + + +def test_hook_with_no_views_for_doc_is_noop(views): + other = Document() + views["c"] = (_FakeView(), "root-c", other, None) + _release_dead_session_views(_ctx(Document())) + assert set(views) == {"c"} + + +def test_hook_with_empty_views(views): + _release_dead_session_views(_ctx(Document())) + assert views == {} + + +@pytest.mark.parametrize("ctx", [None, types.SimpleNamespace(_document=None, id="x")]) +def test_hook_tolerates_missing_document(views, ctx): + views["c"] = (_FakeView(), "root-c", Document(), None) + _release_dead_session_views(ctx) + assert set(views) == {"c"} + + +def test_hook_still_drops_view_when_cleanup_raises(views): + """A failing ``_cleanup`` must not keep the session pinned.""" + doc = Document() + views["a"] = (_ExplodingView(), "root-a", doc, None) + _release_dead_session_views(_ctx(doc)) + assert views == {} + + +# -------------------------------------------------------------------------- +# Canary: is the Panel bug still there? +# -------------------------------------------------------------------------- + +def _plain_notifications_app(): + pn.extension(notifications=True) + return pn.Column(pn.widgets.Button(name="x")) + + +@pytest.mark.xfail( + strict=True, + reason="Panel bug (1.7.5..1.9.4): NotificationArea views outlive destroyed " + "sessions. When this XPASSes, Panel is fixed and " + "_release_dead_session_views can be removed.", +) +def test_panel_still_leaks_notification_views_without_workaround(): + port = _free_port() + srv = pn.serve( + {"app": _plain_notifications_app}, + port=port, + address="127.0.0.1", + show=False, + threaded=True, + check_unused_sessions_milliseconds=100, + unused_session_lifetime_milliseconds=100, + allow_websocket_origin=[f"127.0.0.1:{port}"], + ) + try: + _wait_for(lambda: srv.server_id in state._servers, 30, "server start") + bokeh_server = state._servers[srv.server_id][0] + pull_session(url=f"http://127.0.0.1:{port}/app").close() + _wait_for(lambda: not _sessions(bokeh_server), 30, "session discard") + time.sleep(0.5) + assert _dead_doc_views() == [] + finally: + srv.stop() From 06137cc47d8a74e190e6f3ff3e57ee597ad6d7cf Mon Sep 17 00:00:00 2001 From: Christian Tabedzki <35670232+tabedzki@users.noreply.github.com> Date: Wed, 14 Oct 2026 14:35:45 -0400 Subject: [PATCH 17/17] fix: pin the image's Python to 3.14 uv downloads the newest CPython when unpinned; with 3.15 released, `uv sync` fails because dracopy 2.0.0 has no cp315 wheel or sdist, so the next tagged image build would fail. Refs #6 Assisted-by: ClaudeCode:claude-opus-5-5 --- Dockerfile | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/Dockerfile b/Dockerfile index c3c897f..72c6350 100644 --- a/Dockerfile +++ b/Dockerfile @@ -10,6 +10,11 @@ WORKDIR /app ENV UV_COMPILE_BYTECODE=1 ENV UV_LINK_MODE=copy ENV UV_CACHE_DIR=/root/.cache/uv +# Pin the interpreter. Unpinned, uv downloads the newest CPython, so the image +# silently changes Python whenever one is released -- and a release can break +# the build outright (CPython 3.15: dracopy 2.0.0 ships no cp315 wheel and no +# sdist, so `uv sync` fails). Bump deliberately once dependencies support it. +ENV UV_PYTHON=3.14 COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/