Ribbon plot¶
A ribbon plot shows one histogram per parameter, side by side, for the population feeding the node. Each parameter gets a vertical strip whose width at every height reflects how many events are there - a violin-like profile.
It answers "what does this population look like across all my channels?" in a single picture, which is exactly the question a gating strategy leaves open.
Create one with Ribbon Plot on the project panel toolbar.
Choosing the parameters¶
Click the X axis to open the parameter checklist. Check the channels you want as ribbons, in the order you want them.
The selection is remembered in the data folder's INFO folder, so a new ribbon node on
the same plate starts from the same list.
Reading it¶
- All the ribbons share one scale, so heights are directly comparable between channels. The scale has its own bar along the axis - see Parameters and scales.
- A wide bulge is a dense population; two bulges are two populations in that channel.
- Positive channels stand out immediately against the ones sitting on the negative.
Display settings¶
Ribbon plots follow the global display settings on the MoreOptions page:
| Setting | Effect |
|---|---|
| Histogram Bins | Resolution of every ribbon |
| Equalize | Spread the density over the whole colour range so faint parts show |
| Gamma for Color Scales and Gamma Shape | Shape the colour ramp |
| Butterfly Ribbon Plot | Mirror each profile about its axis |
| Log Butterfly Profile | Use a logarithmic profile width |
| Color map for Bars and Spectra Plots | The palette |
| Sort Ribbon Plot | Order the ribbons rather than leaving them in selection order |
Feeding it¶
Drag a gate's output pin onto the node, exactly as for a chart node. The ribbons then describe only the gated events.
A ribbon node is often the right thing to hang off the last gate of a strategy: one node that summarises the final population across every marker.
Comparing populations¶
To compare two populations, make two ribbon nodes with the same parameter list and feed each from a different gate. Put them side by side on the canvas and the differences are immediate.
For comparison across wells instead - a titration or a dose series - use a well ribbon plot instead.