Auto params
Subtracts a fraction of each spot's neighbour mean before interpolation, correcting for Visium RNA diffusion leakage (SpotClean method). 0 = off. Typical range: 0.10 β 0.20. SELECT A GENE FIRST!
Auto-detect sweeps Ξ± values and finds the elbow of the architecture-coupling curve.
Visium has substantial dropout: a zero count at a single spot whose neighbours are positive is more likely a sampling artefact than true biological absence. This slider sets the fraction of 6 nearest-neighbour spots that must also be zero for a zero to count as a true zero . Below this threshold, the zero is treated as dropout and imputed from the mean of non-zero neighbours before the signature is gated.
Ο = 0 β impute every zero (permissive; signature covers maximal area, risks false positives). Ο = 1 β never impute (strict AND; robust to halos but loses real positives to dropout). Ο = 0.5 (default) β impute only isolated zeros whose neighbours clearly disagree. Applied only when 2+ genes are selected.
Move the sliders to preview the blend live. When satisfied, press Acquire to save it as a new channel.
Select a metadata column to render it as a NaVis channel. Categorical columns are rainbow-coded; numeric columns can be super-resolved via AD-EBIDW using the current Acquire parameters.
Re-render the column with AD-EBIDW using the current Acquire parameters. Active only for numeric columns.
Spatial analysis runs on a 400-pixel downsample. Similar genes use spot-level expression.
Observed / expected signal per tissue compartment. β p<0.05, β β p<0.01 (permutation).
Edge gradient map. Bright = sharp expression boundary.
Cross-correlation with each tissue prior at multiple lag distances (Β΅m).
Connected expression domains above threshold: size, circularity, count.
Fraction of spatial variance NOT explained by tissue architecture (1βRΒ²). High = novel spatial pattern independent of H&E.
Top 10 genes with the most similar spatial expression profile (Pearson r, spot-level).
NaVis is an image-based framework for Visium spatial transcriptomics. Rather than treating expression as a table with coordinates as metadata, NaVis reconstructs each gene as a continuous spatial image and exposes five quantitative image-analytic operations unavailable in matrix-based tools: tissue-compartment enrichment, expression boundary detection, spatial cross-correlation at lag distances, expression island morphology, and histology decoupling scoring.
Click π Data β Load Demo to start. Results described below were obtained on the bundled FFPE DCIS dataset.
Open π Data β Load Demo . A brief modal describes the dataset; loading runs in the background. Close the modal when you are ready. Five tissue-architecture channels appear in π Channels β H&E Image, Nuclei, Fibrillar ECM, Soft Tissue, and Entropy. Click each to inspect them. Use mouse-wheel to zoom, click-drag to pan, β to reset.
Open
⬑ Acquire
. Type
ERBB2
and select it from the dropdown β it closes automatically on selection.
Choose red as the colour. Leave
Auto
on.
Expand
π§Ή Leakage correction
β the slider is at Ξ± = 0.10 by
default. Click
β‘ Auto-detect Ξ±
to let NaVis sweep Ξ± values
and find the architecture-coupling elbow for this gene
(typically 0.05β0.15 on FFPE Visium). Then click
⬑ Acquire Channel Image
.
The map appears in Channels and is selected automatically.
The newly acquired ERBB2 channel still carries some halo from low-confidence spots β the AD-EBIDW interpolation extends each spot's signal a few hundred microns beyond its physical footprint, and the lowest-intensity tail of that extension is where most spurious-looking signal lives. Open π Image Controls to clean it up live.
Three buttons under Tools expose secondary readouts:
Image Controls operate on the rendered image, not on the raw expression data β Insights and Find-Similar-Genes always re-read the underlying channel. Adjustments here are for visualisation; the analytical readouts are unaffected. Each channel keeps its own slider settings, so switching channels restores their independent values.
Open π Insights β click βΆ Run Spatial Analysis . Observed results on this dataset (ERBB2, auto Ξ± = 0.15, auto mode):
With ERBB2 still selected, click π Find Similar Genes . Correlation runs over all spots (including zeros), so a gene expressed everywhere scores near zero β only genes with matching spatial ON/OFF patterns rank high.
Observed top 10 for ERBB2 (Pearson r, spot-level):
| # | Gene | r | Role |
|---|---|---|---|
| 1 |
AZGP1
|
0.813 | apocrine/luminal |
| 2 |
PPDPF
|
0.774 | epithelial-enriched |
| 3 |
CD24
|
0.773 | luminal marker |
| 4 |
MAL2
|
0.746 | apical / trafficking |
| 5 |
MUCL1
|
0.742 | mammary luminal |
| 6 |
KRT7
|
0.739 | luminal keratin |
| 7 |
SPINT2
|
0.731 | epithelial protease inh. |
| 8 |
ATG5
|
0.722 | autophagy (co-localised) |
| 9 |
KRT8
|
0.706 | luminal keratin |
| 10 |
FOXA1
|
0.694 | luminal TF |
Nine of ten hits are canonical luminal/ductal epithelial markers
(
AZGP1
,
CD24
,
MUCL1
,
KRT7
,
KRT8
,
FOXA1
, etc.) β this is strong biological validation: the spatial correlation
recovered the HER2+ ductal-epithelial compartment from scratch without
any prior knowledge. Click any gene name in the results to load it
into
⬑ Acquire
and visualise its spatial pattern.
Acquire
ACTA2
in green β a microenvironmental marker that highlights
Ξ±-smooth-muscle-actin-expressing cells surrounding the ductal
compartment (cancer-associated fibroblasts, myofibroblasts and
myoepithelial cells all contribute). The resulting pattern is
typically ductal-adjacent rather than a sharp perimeter ring β
use it to visualise the tumourβmicroenvironment interface.
Open
β Merge & Interface
, set Channel A to ERBB2 and
Channel B to ACTA2, optionally adjust the reach (ΞΌm) slider, then click
Compute
. Three new channels appear in
π Channels
: the
composite
(blended A+B colors), the
agreement map
(bright where A and B overlap), and the new
interface map
(bright at the boundary between A's and B's
territories, in each channel's color). The
Last computation
section of the Merge panel reports interface area, A-vs-B asymmetry,
and mean interface strength. Open
π Image Controls
to adjust per-layer noise gate and contrast independently.
Open π H&E Overlay . Select ERBB2 from the dropdown. Move the opacity and brightness sliders β the preview updates live in the panel. When satisfied, click π Acquire this Overlay to commit it as a permanent channel that can be used in further merges and analysis.
Click π¬ Analyze in the toolbar to enter Analyze mode. The Analyze panel hosts three distinct interactions, each tied to a different mouse action. Press Escape to exit at any time.
Click any tissue location to open the spot drawer. It shows: the H&E crop centred on that point, an RGB histogram of the local histology, a tissue composition breakdown (Nuclei / Fibrillar ECM / Soft tissue summing to 100%), the active channel's interpolated intensity at the clicked pixel, and Pearson correlations of the channel image with each tissue prior.
Right-click anywhere to store region A (a blue numbered marker appears). Right-click a second location to store region B (orange marker) β the drawer flips to a side-by-side comparison: paired H&E crops, paired tissue composition with logβ(B/A) fold-changes, and channel-intensity fold-changes. Positive logβ means the readout is higher in B than in A; negative means the reverse. Changes within Β±0.1 are shown as a gray dash (no meaningful difference). Useful for quick contrasts: duct vs stroma, tumor vs adjacent normal, lesion vs background. Switching channels auto-clears the comparison.
Hold Shift and drag a rectangle on the tissue. The drawer opens with: an
H&E crop of the boxed region, tissue composition averaged inside the
ROI, and the top 20 genes by enrichment ratio (mean inside / mean outside).
Each gene row has a β button that pre-populates
⬑ Acquire
with that gene β click Acquire to load it as a channel.
Try drawing an ROI on a clear DCIS duct: top genes typically include
luminal markers (
KRT8
,
CD24
,
EPCAM
). The ROI persists across channel switches β
use it to browse multiple genes through the same regional lens.
Click
β Clear ROI
to dismiss it.
After running Insights, click πΎ Save all as ZIP to download all five analysis tables (compartment enrichment CSV, boundary alignment CSV, cross-correlation CSV, island morphology CSV, summary TXT with decoupling score) plus the boundary gradient PNG. Individual sections also have per-section πΎ download links. Zoom any panel with π for a larger, print-quality view of each result.
| Mouse wheel | Zoom in / out on the stage |
| Click + drag | Pan the tissue canvas |
| β button | Reset zoom to fit |
| Panel header | Drag any floating panel to reposition it |
| β | Close a floating panel |
| Escape | Exit Analyze / crosshair mode |
NaVis does not store, log, or transmit your data. All processing is session-only and discarded on close.
The app is hosted on ShinyApps.io. For unpublished or patient-derived datasets, use local deployment.
To deploy locally: clone from
github.com/Izzilab
and run shiny::runApp().