Skip to content

AnnZarro v0.3.0

Choose a tag to compare

@github-actions github-actions released this 05 Oct 10:01
· 806 commits to main since this release
3fb6826

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 (enforce off, 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 other scheme:// 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.