Worked examples

Seven short tours of TissuePlex on the data that ships with it

Each example takes a few minutes, uses one of the demo datasets, and names every control exactly as it appears in the sidebar. They are written so that someone who has never used a spatial transcriptomics viewer can follow them and see what the tool is for. The user manual explains each control in full; this page shows why you would reach for it.

Every screenshot on this page was taken from the viewer itself, on the dataset the example names, with the settings the example gives. Nothing was drawn afterwards.

The demo datasets

Four small datasets come with the repository and appear in the Dataset menu as soon as the viewer opens. Three larger, real datasets are published as release assets; one command fetches them:

python3 sample_data/fetch_samples.py
Menu entryPlatformWhat it isUsed in
mouse_ileum_tinyXeniumThree 640-px patches of mouse ileum (36 cells) from 10x's tiny example run, with generated edges and example metadata: a test fixture. In the clone.—
visium_hd_tinyVisium HDA corner of 10x's "Tiny Mouse Brain" Space Ranger output, 8 µm and 16 µm bins. In the clone.4
visium_tinyVisiumSynthetic classic Visium slide, 252 spots, a test fixture. In the clone.—
seqfish_syntheticseqFISHSynthetic Spatial Genomics GenePS region, 36 cells, a test fixture. In the clone.—
xenium_human_breast_2fovXenium10x's human breast example, two fields of view, 7,275 cells, DAPI image, a NICHESv2 run and 10x's own graph clusters. Fetched.1, 3, 5, 7
visium_mouse_kidneyVisium10x's mouse kidney coronal section, 1,438 spots on tissue, NICHESv2 spot–spot edges. Fetched.4
cosmx-mousebrainCosMxBruker/NanoString 1000-plex mouse brain, coronal section, 38,996 cells, no image. Fetched; non-commercial licence.1, 2, 6
Three layers start switched off

When the viewer opens, Morphology, Transcripts and Edges are unticked, so you see cell outlines on a dark canvas. Every example below starts by ticking what it needs.

1Where is the signalling?

Dataset cosmx-mousebrain (fetched) · 5 minutes · the core use case

NICHESv2 scores every neighbouring pair of cells for every ligand–receptor mechanism it can see in the panel. TissuePlex draws that as a graph on the tissue: first the tissue graph, every pair of cells close enough to be scored, then the scores as colour on those same lines. Start with the structure, then ask where the signalling is. A coronal mouse brain section is a good first dataset because you already know its anatomy, so you can judge the answer.

  1. Choose cosmx-mousebrain in the Dataset menu. This dataset ships no image, so the cells are drawn on a frame sized from the data.
  2. Under Cell Segments, drag sample to 100% and fill down to about 12%, so the 38,996 cells sit as a faint ghost under the lines.
  3. Under Edge Data, drag sample to 100% and set the Tissue Graph opacity to about 60%. This is figure 1a.
  4. Tick Edges, raise its opacity to 100%, lower width to 1, and drop the tissue graph back to 15% so it reads as a faint scaffold under the coloured lines.
  5. In the legend under edge color, switch auto to robust 5–95%. This is figure 1b.
The tissue graph of a coronal mouse brain section: every pair of neighbouring cells joined by a thin grey line, with the hippocampus, cortex and midline visible as denser regions
1a · The tissue graph. 38,996 cells, 164,550 neighbouring pairs, every one drawn. This layer never changes with the mechanism selection or the filters: it is the set of pairs NICHESv2 scored, and everything else in the viewer is a subset of it. Dense cell layers, the hippocampal pyramidal layer and the dentate gyrus among them, read as bright bands because they have more pairs per unit area.
The same graph coloured by summed ligand-receptor score: mostly purple, with the hippocampal cell layers and midline structures in teal and yellow
1b · The same graph, scored. Each line is coloured by the summed score of all mechanisms on that pair (viridis: purple low, yellow high). Range auto, robust 5–95%: the window is 5–976, the 5th to 95th percentile of the scores drawn, while the full span is 1–17,383 with a median of 137. On the full range every line would be purple; the robust window lets the structure in the bulk of the pairs show while the extreme tail saturates to yellow. The legend states which window is in use.

What to notice

The same two steps on a different platform

Nothing above is specific to CosMx. The pair below is the Xenium human breast example (two fields of view, 7,275 cells, 181,523 directed pairs scored over 32 mechanisms) drawn with the same settings and the same robust 5–95% range.

The tissue graph of a two-field Xenium breast section drawn as thin grey lines, dense in the tumour and open in the stroma The same breast graph scored with viridis: purple through the stroma, with yellow concentrated in the tumour nests
Xenium breast, tissue graph and scored graph, every pair drawn. Window 0–33 (robust 5–95% of the scores in view, whose full span is 0–693). The yellow sits in the tumour nests, where epithelial cells pack tightly and homotypic pairs such as CDH1–CDH1 and DSC2–DSC2 score highly; the stroma between them is purple.
The EDGE panel for one cell pair: sending and receiving cell ids, an Annotations block with interaction_class, score_tier and score_percentile, and seven mechanisms with their scores and shares, led by CXCL12 to CD4 and CXCL12 to CXCR4
Shift-click on an edge (breast dataset). The EDGE panel names the sending and receiving cell, shows the pair's annotations from edge-metadata/, then every mechanism NICHESv2 scored on it with its share of the total: here seven, led by CXCL12 → CD4 and CXCL12 → CXCR4.
Try next

On the breast dataset, open Edge Filter and set Sending cell to graphclust, then keep one cluster. Only edges leaving that cluster remain; the tissue graph underneath is untouched, so you can still see the neighbourhood structure the filter removed.

2One cell's neighbourhood

Dataset cosmx-mousebrain · 3 minutes · continues from example 1

The scored graph answers "where"; the neighbourhood view answers "who, and through what". Zoom into the hippocampus first: at this scale the dentate gyrus and the CA pyramidal layer resolve into individual cells, and the graph becomes readable as a graph. Then click any cell and TissuePlex will show every cell it exchanges signal with, how far they reach, and which mechanisms dominate across those edges.

  1. With the settings from example 1, zoom into the hippocampus with the mouse wheel until single cells are clear.
  2. Click a cell in the pyramidal layer (a plain click, no Shift). The Cell Info block at the foot of the sidebar fills with its id, position and metadata.
  3. Click show local neighbourhood at the bottom of that block.
  4. Zoom in once more, until the cell and its neighbours fill the view. Untick Tissue Graph, raise offset to 3 and choose Harpoon, so each pair of cells shows its two directions as separate half-arrows.
Zoomed view of the mouse hippocampus: the dentate gyrus and CA pyramidal layer drawn as dense bands of scored edges, with sparse edges elsewhere
2a · The hippocampus at cell resolution. Same settings as figure 1b. The two bands are the dentate gyrus granule layer (upper) and the CA pyramidal layer (lower); the midline structure at left is the third ventricle region. At this zoom the summed-score colouring separates the cell layers from the neuropil around them.
Close view of one selected cell in white, ten connected neighbours in amber inside an amber circle, and the surrounding edges drawn as paired offset lines with harpoon arrowheads
2b · One cell's local neighbourhood. The selected cell in white; its ten connected neighbours in amber; the enclosing radius, 19.5 µm, as a circle. Every edge is drawn twice, once per direction, offset to its own left with a harpoon head, so A→B and B→A read like a chemistry equilibrium arrow and can carry different colours. The amber points are the honest answer: connectivity is not isotropic, and the circle contains cells this one is not connected to.
The Cell Info block: cell id 21_213, neighbourhood of 10 neighbours, 21 local edges, radius 19.5 µm, autocrine yes, and mechanisms ranked by score led by Ptprs|Ntrk3 at 1431 The same neighbourhood with only four mechanisms ticked: most edges are gone, and the few that remain show where Bdnf-Ntrk2 and three neuropeptide pairs act
2c · The neighbourhood summary, and the same view with four mechanisms. Left: the Cell Info block for this cell. The neighbourhood is 10 cells and 21 directed edges within 19.5 µm; the mechanism list is ranked over those 21 edges only, and receptor tyrosine phosphatase–Trk (Ptprs–Ntrk3), cell adhesion (Ncam1, Nfasc/Nrcam, Cntn1) and neurotrophin (Bdnf→Ntrk2) pairs lead, as one would expect of a pyramidal neuron and its neighbours. Right: the same view after clicking none in LRM Mechanisms and ticking only Bdnf→Ntrk2, Npy→Npy1r, Sst→Sstr2 and Pdyn→Oprk1. Edges that carry none of the four vanish; the colour scale re-ranges to the four that remain.
Why the numbers do not change when you pan

The neighbourhood is computed from the whole edge file on the server, not from the lines currently drawn. So the count is complete even when the edge sample slider is below 100%, and it is the same wherever you have scrolled to. Colour cells by a metadata column first and the block also reports the neighbourhood's composition by that column.

3Your own annotations, without touching the data

Dataset xenium_human_breast_2fov (fetched) · 3 minutes

Most analysis happens in R or Python after the instrument has finished. TissuePlex reads that work from two plain folders dropped beside the dataset, so clusters, scores or review flags appear in the viewer without regenerating anything:

The breast dataset ships both. cell-metadata/graphclust_10x.csv is 10x's own graph-based clustering of this run, copied from the analysis/ folder Xenium Onboard Analysis writes, with nine integer levels: integers are the common case for cluster ids and the awkward one for a viewer. edge-metadata/example_annotations.csv holds three per-pair summaries computed from the NICHESv2 file (whether the pair is autocrine or paracrine, a score tercile, and a score percentile), standing in for the columns a lab would write about its own pairs.

  1. Choose xenium_human_breast_2fov and zoom into the edge of the tumour, where the stroma runs through it as a dark band. Set Cell Segments → fill to 55% and outline to 40%, Morphology to 40%.
  2. Under Cell Color, tick Color cells, choose Cell metadata, then graphclust.
  3. The legend lists clusters 1 to 9 in numeric order with a swatch each; click a swatch to change its colour, or import palette to load a category,#hex file.
  4. Tick Edges at about 55% with width 2 so the signalling graph sits over the clusters, then hold Shift and click a line: the EDGE panel opens with an Annotations block from edge-metadata/ above the mechanisms.
Several hundred cells filled by cluster colour: red, green and blue tumour clusters packed together, a band of purple stromal cells running diagonally through them, blue outlines, and NICHESv2 edges drawn over everything in viridis
3a · Cells filled by graphclust from a CSV in cell-metadata/, 437 cells in a 258 × 185 µm field at the tumour edge, with every NICHESv2 pair drawn over them at 55%. The viewer recognised nine integer levels as categories rather than a 1–9 gradient; treat as categorical is there to override that call either way. The clusters follow the tissue: the three tumour clusters (red 4, green 3, blue 1) fill the nests, and the purple cluster 5, whose enriched genes are VWF, PDGFRB, POSTN and LRRC15, is the stromal band between them.
The Cell Color section: Color cells ticked, Cell metadata, graphclust, treat as categorical ticked, nine colour swatches labelled 1 to 9, and import and export palette buttons The EDGE panel for one pair: sending and receiving cell ids, an Annotations block with interaction_class paracrine, score_tier high and score_percentile 99.920, then seven mechanisms with scores and shares, led by CXCL12 to CD4 and CXCL12 to CXCR4
3b · The two places annotations surface. Left: the Cell Color section with the categorical legend; the labels read 1 to 9, not 1.0, even though two cells in the file have no cluster. Right: the EDGE panel for one pair in the stroma; the Annotations block is the row for this pair from edge-metadata/, and below it the seven mechanisms NICHESv2 scored on it.

What to notice

Try next

Open Edge Filter, set Sending cell to graphclust and keep only cluster 5. The edges that remain all leave the stroma; the tissue graph underneath is untouched, so the neighbourhood structure the filter removed is still visible.

4Spots and bins: the array platforms

Datasets visium_mouse_kidney (fetched) and visium_hd_tiny (in the clone) · 4 minutes

Classic Visium measures 55 µm spots on a 100 µm hexagonal lattice, each covering one to ten cells; Visium HD tiles the capture area with 2, 8 or 16 µm square bins. Neither has per-molecule coordinates. TissuePlex draws a polygon per unit, a 16-sided circle for a spot and a square for a bin, so colouring, clicking, filtering and NICHESv2 edges all work exactly as they do for cells. The sidebar relabels itself: Spot Segments and Spot Info on Visium, Bin Segments on HD.

  1. Choose visium_mouse_kidney. Tick Morphology and raise it to about 85%: this one is a brightfield H&E, so it wants to be bright. Set spot fill to 0 and outline to 50% so the stain shows through the rings.
  2. Tick Edges (100%, width 1), leave the Tissue Graph at 15%, and set both sample sliders to 100%. Keep the colour range on robust 5–95%: spot-level scores are summed over many cells and have a long tail.
A coronal mouse kidney section on a Visium slide: H&E in grey, every capture spot as a light-blue ring, and NICHESv2 spot-to-spot edges in viridis with yellow concentrated in the cortex and medulla
4a · Mouse kidney, classic Visium, whole capture area. 1,438 spots on tissue, each a ring; the fiducial frame of the slide is visible at the edges of the H&E. Lines are spot–spot NICHESv2 edges coloured by summed score. The top mechanisms in this dataset include Apoe→Lrp2 and Cst3→Lrp2, megalin-mediated uptake in the proximal tubule, which is why the cortex lights up.
  1. Zoom into the cortex until the lattice resolves and raise offset to 2. Each spot now shows its six neighbours' edges as paired half-arrows converging on its centre.
  2. Use ⟷ Measure between two adjacent spot centres: the label reads 100 µm, the lattice pitch, which is how the pixel size of this platform is derived (Space Ranger does not record one).
Close view of the Visium lattice: rings on a hexagonal grid over H&E, with paired directed edges and small arrowheads between every neighbouring pair
4b · The lattice at spot resolution. Spots are drawn at their detected ~65 µm footprint, as Loupe and scanpy draw them, not the 55 µm nominal capture diameter. Every spot has up to six neighbours, each connected in both directions; the yellow cluster at upper left is a group of spots whose summed scores sit in the top 5%.
  1. Choose visium_hd_tiny. The tissue sits in one corner of the frame, because 10x's "tiny" dataset is a corner crop; zoom into it.
  2. Untick Edges and Tissue Graph, tick Color bins and choose Gene set (selected species). With every gene selected that is total UMI per bin, on an auto range.
A grid of 16 µm Visium HD bins coloured by total expression with viridis: mostly purple with teal and yellow bins tracing tissue structures, over a grey CytAssist image
4c · Visium HD, 16 µm bins coloured by total expression. The bins follow the edge file: this dataset was scored at 16 µm, so 16 µm bins are shown (barcodes are bin-size specific, and 8 µm bins under 16 µm edges would leave nothing to click). The expression here is very shallow, 32,000 UMIs over the whole corner, so NICHESv2 scored only a handful of pairs and the edge layer is left off; the bins themselves still trace the tissue.
A spot is a neighbourhood, not a cell

Edges on classic Visium connect spots, each a mix of one to ten cells. Say so in a figure legend. The HD bins are closer to single cells but still a grid, not a segmentation.

5Transcripts inside their cells

Dataset xenium_human_breast_2fov (fetched) · 4 minutes

Imaging platforms record every transcript as a point with a gene name. TissuePlex draws those points where they were detected, over the nuclear stain and inside the cell outlines they were assigned to, coloured by gene, and filters them by gene in the browser without a round trip to the server. The question this answers is the one a histologist asks of an in-situ stain: which cells, exactly, express this?

  1. Choose xenium_human_breast_2fov. Tick Transcripts and drag its sample to 100%; leave dot at 3 px. Under Cell Segments, drag sample to 100%, fill to 0 and outline to 60%. Tick Morphology at 70% for the DAPI.
  2. Zoom into the stroma, the darker tissue to the left of the tumour, until single cells are clear, about 200 µm across. Hover a dot: the tooltip names its gene and, on Xenium, its Q-Score. This is figure 5a.
  3. Under Transcript Species, click select ▼, then none, and tick LUM, ACTA2, CD68 and PECAM1; or click import and choose sample_data/example_lists/breast_stroma_markers.csv. The dots update at once. import palette with breast_marker_palette.csv gives them the colours used here. This is figure 5b.
  4. Pan right to the edge of the tumour and import breast_tumour_markers.csv (EPCAM, LUM, MKI67). This is figure 5c.
Breast stroma at cell resolution: elongated DAPI nuclei inside blue cell outlines, with transcripts of all 280 genes drawn as small coloured dots inside and between the cells
5a · Every transcript, every cell. A 203 µm field of breast stroma: 162 cells and all 20,924 of their transcripts, 280 genes, each dot coloured by gene. Both sample sliders are at 100%, so nothing is thinned. Dots fall inside the outlines of the cells they were assigned to; the scattered ones between cells were detected outside any segmented cell and belong to no cell.
The same stroma field with four genes: LUM in amber filling the fibroblasts, ACTA2 in pink along vessel-like profiles, CD68 in green in a few scattered cells, PECAM1 in white
5b · Four genes, four cell types. The same field with LUM (amber, fibroblasts), ACTA2 (pink, smooth muscle and myofibroblasts), CD68 (green, macrophages) and PECAM1 (white, endothelium): 3,529 of the 20,924 transcripts. The filter runs on the dots already in the browser, so the change is immediate, and the counter reads 3.5k/3.5k because the sample is exact. Cell outlines still come from the segmentation, so a cell with no dots is a cell expressing none of the four.
The edge of the tumour: tightly packed cells with EPCAM in amber in every one, a band of stroma at right where only LUM in pink is found, and a few green MKI67 dots in the tumour
5c · The tumour edge. 305 cells and 3,640 transcripts of three genes. EPCAM (amber) marks every tumour cell and stops at the stromal band, where LUM (pink) takes over; MKI67 (green) picks out the cells in cycle. Nothing here was drawn by hand: this is the gene filter and three colours.

Every layer at once: one mechanism, its transcripts, and the cells

The layers above were introduced one at a time. On real data the point is to stack them: pick one ligand–receptor mechanism, draw its edges, draw the transcripts of its ligand and its receptor, and colour the cells by an independent clustering. Five layers, each from a different file, in one field 115 µm across.

  1. Keep the settings of 5a, with Morphology down to 40%, Cell Segments → fill up to 35% and the transcript dot at 4 px.
  2. Under Cell Color, tick Color cells, choose Cell metadata, then graphclust. That column is 10x's own graph-based clustering of this run, read from cell-metadata/graphclust_10x.csv beside the dataset; the viewer recognises its nine integer levels as categories and gives each a colour.
  3. Under Transcript Species, select only CXCL12 and CXCR4; give them white and red with the swatches, or import palette with breast_cxcl12_palette.csv.
  4. Tick Edges, drag its sample to 100%, set width 2.5, offset 2 and Harpoon, and under LRM Mechanisms click none and tick only CXCL12 → CXCR4. Set the edge legend to robust 5–95%. Zoom in until about 80 cells fill the view.
About eighty cells filled in cluster colours, mostly tan with some purple, green and pink, outlined in blue over faint DAPI; white CXCL12 and red CXCR4 transcript dots inside them; and CXCL12 to CXCR4 edges drawn as offset lines with harpoon heads, coloured purple to yellow by score, converging on receiving cells
5d · One mechanism, every layer. A 115 × 83 µm field of breast stroma: 84 cells, 252 CXCL12 and 107 CXCR4 transcripts, and the 754 directed CXCL12 → CXCR4 edges that touch the field, out of 1,707 scored pairs there. Both sample sliders at 100%, so nothing is thinned. Edge colour: viridis, window 1–30 (robust 5–95% of the drawn edges, whose full span is 1–130).

Reading it from the bottom up:

Every number in the caption can be checked against the files: the cells and transcripts against the platform's own output, the clusters against 10x's analysis/ folder, the edges against edges/niches_rad30.parquet. Nothing was drawn by hand.

Quality filter

Xenium scores each transcript's decoding quality. Like Xenium Explorer, TissuePlex hides transcripts below Q 20 by default; tick show low-quality (Q < 20) in gray to draw them in gray. The counter counts only what is drawn.

6Side by side

Dataset cosmx-mousebrain · 5 minutes · continues from example 1

Split mode shows two panels driven by one sidebar, and there are two different questions it answers. Which one you are asking decides what you hold fixed:

In both cases the pair is only readable because of one setting: shared colour scale across panels, on by default. The two panels are coloured through a single window, the union of what each would have chosen on its own, and the legend says shared. Two panels that each auto-range to their own data look comparable and are not.

  1. Start from the settings of example 1: both sample sliders at 100%, cell fill 12%, Tissue Graph 15%, Edges 100% at width 1, and the edge legend on robust 5–95%. Click ⊞ Split in the left panel's toolbar. The right panel opens on the same dataset with the same settings, and the sidebar gains Panel 1 / Panel 2 tabs above a ticked settings linked — edits apply to both panels box.
  2. Zoom the left panel into the midline, where the third ventricle holds its choroid plexus between two dense cell layers, and the right panel into the lateral ventricle at the edge of the section. Click ⇔ Match on the left panel so the right one shows the same number of microns across. This is figure 6a.
  3. Untick settings linked. The sidebar now edits whichever tab is selected. With Panel 1 selected, click none in LRM Mechanisms and tick the 31 neuropeptide mechanisms, or click import and choose sample_data/example_lists/mouse_brain_neuropeptides.csv. Select Panel 2, click none, and tick the 22 glial support mechanisms, or import mouse_brain_glial_support.csv. Bring both panels to the midline view and ⇔ Match them. This is figure 6b.
Two panels at the same scale and with the same 228 mechanisms: left, the third ventricle with the choroid plexus inside it and dense yellow-scored cell layers on either side; right, the elongated lateral ventricle lined by a wall of cells scored mostly purple and blue
6a · The same mechanisms in two places. All 228 mechanisms, settings linked, both panels 843 µm across after ⇔ Match. Left: the third ventricle, with the choroid plexus inside it and the cell layers that flank it. Right: the lateral ventricle at the edge of the section and its wall. One window for both, 2–769, the union of the two panels' own robust windows (2–769 on the left, 4–660 on the right), so a yellow line is the same summed score on either side. The flanking layers on the left reach scores the ventricle wall on the right rarely does; the choroid plexus, drawn in purple, is low on every mechanism at once. Every cell and every pair is drawn: both sample sliders are at 100%.
The same midline view twice: left, with 31 neuropeptide mechanisms, the choroid plexus is drawn only as white tissue-graph lines and the layers are purple; right, with 22 glial lipid-transport, complement and microglial mechanisms, the choroid plexus and the ventricle lining are the brightest yellow in view
6b · Two sets of mechanisms in the same place. The left panel keeps 31 neuropeptide mechanisms (Npy, Sst, Vip, Cck, Penk, Pdyn, Pomc, Tac1, Gal, Crh, Avp and Calca, each to its receptors); the right keeps 22 glial support mechanisms (Apoe, Clu, Cst3, Apod and Lpl to Lrp2, Sorl1, Trem2, Lsr and Lepr; the C1q and C3 complement pairs; Csf1 and Trem2 to Csf1r; Psap to Gpr37; Pros1 to Axl and Mertk). Shared window 0–169, the union of 0–20 on the left and 0–169 on the right. On the left the choroid plexus and the ventricle lining are white: those are tissue-graph lines with no neuropeptide pair scored on them. On the right the same lining is the brightest signal in view. Had each panel ranged to its own data, the left would have been drawn over 0–20 and looked as bright as the right; that is the comparison the shared scale refuses to draw.
Two links, two jobs

settings linked decides what is drawn: untick it to give one panel its own mechanism list, filter or opacity, and use copy panel 1 → panel 2 to push one side's settings onto the other in one step. shared colour scale across panels decides how it is coloured. Leave the second one on for any figure; untick it only when one panel's range is so much narrower that sharing flattens it, and say so in the legend.

7A figure for the paper

Dataset xenium_human_breast_2fov · 3 minutes · continues from example 5

A screenshot is limited to the pixels on your screen. Export… redraws the data layers at whatever size you ask for, because they are geometry rather than pixels, and writes the DPI you choose into the file so a journal's resolution check reads it. Here the view is the one from figure 5d: CXCL12 → CXCR4 edges, the two genes' transcripts, cell outlines and 10x's clusters.

  1. Choose ▭ Rectangle and drag over the region you want. The rectangle stays on the tissue while you pan; it is stored in image coordinates, not screen ones.
  2. Click Export…. Pick a preset, 3.5in @500 for a single column or 7in @500 for a double, or type a width in pixels. Choose a background, tick scale bar, and click Export PNG.
  3. For a quick slide, Save PNG saves the panel as shown, image included, at screen resolution.
The viewer with a white framing rectangle drawn over the middle of the field from figure 5d
7a · Framing. The ▭ Rectangle frames 89 × 60 µm of the field in figure 5d, 420 × 280 image pixels. Everything else about the view is unchanged.
The Export figure dialog: region 89.2 by 59.5 micrometres, width 3500 px, DPI 500, the three presets, an output readout of 3500 by 2333 px equal to 7.00 by 4.67 inches at 500 DPI and 8.3 times the region's 420 source pixels, background black, scale bar ticked with a 20 micrometre bar, and a Saved 3500 by 2496 px line A 1000 by 700 pixel crop of the exported PNG at its native size: crisp cell outlines, transcript dots and offset harpoon edges on black
7b · The dialog, and 1,000 × 700 px of the result at 1:1. Left: 7in @500 gives 3,500 px for 420 source pixels, 8.3 pixels of output per pixel of the microscope image, and the readout says so. Right: a crop of the exported file at its native size. The outlines, dots and harpoons are redrawn as geometry at 3,500 px, which is why they stay sharp where a screenshot enlarged 8× would not.
The exported figure: the framed field on black with cell fills by cluster, white and red transcript dots, CXCL12 to CXCR4 edges with harpoon heads, and a 20 micrometre scale bar in a margin band at the bottom
7c · The exported PNG, 3,500 × 2,496 px, tagged 500 DPI, here reduced for the page. The 20 µm scale bar sits in its own band below the plot rather than over the data. There is no DAPI: the export draws the data layers only, so nothing in it is limited by the source image's resolution.
Two things to know before exporting a multi-panel figure
  • Line weight is fixed in output pixels, so export every panel of one figure at the same pixel width or their lines will not match.
  • The morphology image is not included in Export…; it cannot be sharper than the source TIFF. Use Save PNG when you need the image, and the vector export for the data layers.

Where to go from here

User manual

Every control, the install steps, and the R commands that produce edges.parquet with NICHESv2.

Edge file format

The column specification for edges.parquet, so any pipeline can produce one.

Datasets and licences

Where each demo dataset comes from, what was trimmed, and further public data to try.