Highlights
- Memory guard. AnnZarro now predicts what a plot, table or export needs against the browser's JavaScript memory and disables actions that would crash the tab, with a message saying what it needs and what to close. The budget is shared across panels. Settings:
ui.memory(enforceoff, warn or block;heap_gb,total_gb,margin). - Large datasets. Plots above 1 million points (
ui.defaults.large_plot_points) switch to large-plot mode. In testing within 16 GiB of browser memory, a plot drew every cell up to 150 million cells; above that the memory guard declines the first plot instead of the tab crashing. With the default subset, datasets of 1 billion cells open with under 2 GB of browser memory (the server then needs about 25 GB). - Deep links. Demo panel sets are "start here" links in the docs and tutorials, and a link survives a login: after signing in you return to the view the link described.
- Interface. Controls layout, slider scales, unified notices and subset presets. A 3D plot keeps its camera when you click a cell to focus it, and 3D plots default to opacity 1.
Fixes
- Memory leak (present since v0.2.0). Each time a plot loaded an embedding, for example on every subset or part change, the tab kept the x and y coordinates (about 8 bytes per cell each) for good, so long sessions on large datasets could run out of memory. On a 5-million-cell store, each switch between a 4M- and a 100k-cell subset left 66 MB behind (131 MB in v0.2.0); memory now stays flat.
- Large-plot redraws release the old plot. A recolour, part step or setting change in large-plot mode kept the previous plot alongside the new one. It is now released first, halving the memory of such a plot (50 million cells: 1.82 GB to 1.02 GB, including after a deep-link restore). Such redraws now show a brief blank frame.
- Faster first draw of large plots. The plot's status strip is drawn before the plot, removing a second full render (0.8 s at 95.6 million points).
- Leaner server name index. At 95.6 million cells the server's peak memory while building the cell-name index falls from 12.3 to 5.2 GB; search results are unchanged.
- Tables. A closed table's filter is kept by cell names, so other plots can still use it, and reopened tables keep their search text.
- Session expiry. When a login session ends mid-session, AnnZarro returns to the current view after you sign in again.
- Names race. Pinned tables and dataset switches no longer draw before the cell names arrive.
Docs
- Desktop app: first launch on macOS 15 and later (Privacy & Security > Open Anyway).
- Which path schemes count as remote (
s3,gs,gcs,http,https); any otherscheme://path is treated as local and refused on a shared server. - Release steps updated for 0.3.0.
Known issue
- Rare tab crash while recolouring every cell of a very large dataset. In testing, the tab crashed once while recolouring by gene a plot showing all 95.6 million cells of the Tahoe-100M store (1 of 44 such recolours). Memory stayed within the browser's limit and the memory guard's estimate. The cause is not yet known; 40 further recolours at this size did not crash. If it happens, reload the page (the panel set is restored) and colour by a category, or use a subset.
Full changes: v0.2.0...v0.3.0
Desktop apps
Desktop apps for Windows, macOS and Linux. The builds are not signed with a developer identity (the macOS app is ad-hoc signed, not notarized), so the first launch needs one extra step. macOS 15 and 26: macOS says "AnnZarro" Not Opened; click Done, then System Settings > Privacy & Security > Security > Open Anyway, and confirm (once). macOS 14 and earlier: right-click the app > Open. Windows: More info > Run anyway. Details: https://annzarro.readthedocs.io/en/latest/getting-started/desktop-app.html (First launch). Verify downloads against SHA256SUMS.txt.