Skip to content

Chart nodes

A chart node is the workhorse of PlatAnJr: a plot of one or two parameters, the gates drawn on it, and a table of what those gates contain.

Create one with Scatter Plot, Contour or Histogram on the project panel toolbar. All three make the same kind of node - they differ only in how they start out.

Anatomy

   +-- input pins          floating toolbar --+
   |                                          |
  [|]  +----------------------------------+  [|] <-- output pins
  [|]  |                        [][][][][]|  [|]
       |                                  |
       |          the plot                |
       |                                  |
       +----------------------------------+
       | name | n | % | %par | CV | c | x |   <-- gate grid
       +----------------------------------+

The floating toolbar appears in the top-right corner of the plot when the mouse is over it, and fades when it leaves:

Button Effect
Switch Auto/Manual scaling Freeze the axes where they are, or let them follow the data
Create Quadrant Gate Quadrants on a 2-D plot, automatic bands on a histogram
Autogate Find the largest ungated population and draw a gate around it - one gate per click, with at most Autogate vertices vertices (Options ▸ Data, 8 by default)
Mini/Maximize Shrink the node to an icon, or restore it
Hide This Toolbar Dismiss the toolbar until the mouse leaves and returns

The gate grid below the plot has one row per gate on this node:

Column Meaning
Name The gate's caption - click to edit. A new gate is named from where it lies, CD3+ CD4- - see Gate names
Count Events in the gate
% Percent of all events
% parent Percent of the population feeding this node
CV Coefficient of variation
Colour Click to pick a colour
✕ Click to delete the gate

Clicking any other cell in a row switches the plot to that gate's parameters, which is the fastest way to navigate a node carrying gates on several parameter pairs.

Drag the splitter between plot and grid, or use the small button on it, to give one more room.

Choosing what to plot

Action Result
Click the X axis Parameter picker for X
Click the Y axis Parameter picker for Y, including a None entry
Click the corner between the axes Swap X and Y

Choosing None for Y turns the node into a histogram: the X parameter is binned and the Y axis counts events. Choosing a parameter for Y turns it back into a 2-D plot.

The parameter picker is a searchable list - start typing to filter it.

Zooming and panning

Action Result
Drag a rectangle Zoom to it, and switch that axis to manual scaling
Drag from bottom-right to top-left Zoom back out to autoscale
Double-click Open the chart editor

The Switch Auto/Manual scaling button on the floating toolbar is the deliberate way to pin the axes: with autoscale off, the window stays where you put it even as gates upstream change the population.

For plots that jump around as you gate, turn on X SuperMax / Y SuperMax in the chart editor instead: autoscale then only ever widens the window, never shrinks it.

Density, contours and dot size

A 2-D chart node draws a density map by default: a colour-coded 2-D histogram. The chart editor's Density Plot Style switches it to Contour, which draws iso-density lines instead - much clearer for showing two overlapping populations in a figure.

Other display settings:

  • Dot Size in the chart editor, and MoreOptions ▸ Default Scatter Plot Dot Size for new nodes.
  • Equalize spreads the density map over the whole colour range so faint populations become visible. Excellent for looking; misleading for judging relative abundance, because it flattens the peaks along with everything else.
  • Gamma for Color Scales and Gamma Shape on the MoreOptions page shape the colour ramp.

Equalize and autogating

Autogating deliberately turns equalization off for the duration of the search, because a flattened map reads two separate populations as one. You do not need to do anything - the picture is put back as it was afterwards.

Feeding a node

Drag an output pin from another node onto this node's plot. A link appears and the plot redraws showing only the gated events.

You can also drag the gate shape itself off the plot it lives on and drop it on another node - same result, without hunting for the pin. A histogram's band gate drags out the same way: take the band by its middle and leave the node with it. Dropped on empty canvas, a gate becomes a new chart node fed by it - for a band, a histogram of its parameter.

PlatAnJr refuses a link that would create a loop: a node cannot, directly or indirectly, feed itself.

Histogram nodes

With Y set to None:

  • Shift +drag across the plot creates a band gate between the two X values.
  • Create Gates on the node menu (or the quadrant button) finds the peaks in the histogram automatically and lays a band over each one.
  • Histogram as line on the node menu draws an outline instead of filled bars.
  • Smooth on the node menu applies a smoothing pass to the plotted curve.
  • The bin count comes from Options ▸ Number of Bins; changing it there re-bins every histogram in the project.

Making a node smaller

Mini/Maximize collapses a node to a small icon that keeps its links. On a large gating strategy, iconify the nodes you are not actively working on - the graph stays readable and everything keeps updating.

To see one node larger, click the maximize box in its title bar: the node fills the panel's view until you click it again - see Filling the view with one node.