Skip to content

Well and logic nodes

Not every node is a plot. Two kinds exist purely to define populations: well nodes, which select by plate position, and logic nodes, which combine other gates.

Well nodes

A well node holds a list of wells. Its output pin carries every event acquired in those wells - no measurement is involved, so it is the natural way to express "the treated samples", "the day 7 timepoint" or "replicate B".

Creating one

  1. Select the wells on the plate in the Heat Map tab - click, drag, or Ctrl +click to add to the selection.
  2. Click Gate above the plate.

A well node appears in the project panel containing a checklist of the wells you selected, each with a thumbnail of its position on the plate. A selected well with no file in it is left out.

Using one

Control Effect
Checkbox beside a well Include or exclude that well
All Check every well in the list
Single Keep only the first checked well and clear the rest

Single is more useful than it sounds: with the node feeding a chart, ticking wells one at a time walks you through the plate well by well while everything downstream follows.

The node's output updates the moment you change a checkbox.

Wells follow their files

A well node remembers its wells by the files in them, not by their positions. Open another plate holding the same files, or the same plate under a different plate map, and the node takes those files in whatever wells they sit in now - a well you unchecked staying unchecked. A file with no events on the plate that is open is not listed until a plate has it.

A well node from a project saved before this behaviour takes the files the first plate it is opened on has in its wells, and follows them from then on.

Combining wells with measurements

A well node on its own selects samples. To select cells within samples, feed a chart node from it and gate there - or combine the two with a logic node:

[Well node: treated wells] ---+
                              +--> [AND] --> [Ribbon plot]
[FSC/SSC node: live gate] ----+

That reads "live cells in the treated wells", and the ribbon plot describes exactly that population.

Logic nodes

Four buttons on the project panel toolbar create boolean nodes:

Node Output
Boolean AND Events in every input gate
Boolean OR Events in any input gate
Boolean XOR Events in an odd number of the input gates - for two inputs, in one but not both
Boolean NOT Events not in the input gate

Create the node, then drag the output pins of the gates you want combined onto it. The node's own output pin carries the result and can feed anything else.

Why not just nest gates?

Nesting is a chain: A, then B within A, then C within B. That is an AND, and for a simple hierarchy it is the clearest way to write it.

Logic nodes earn their place when the relationship is not a chain:

  • Either/or - CD4 OR CD8 as one T-cell population needs an OR; nesting cannot say it.
  • Exclusion - "live cells that are not in any of my defined subsets" is a NOT over an OR, and it is the honest way to see what your panel is missing.
  • Sharing - one gate feeding two different combinations, without drawing it twice.
  • Order-independence - an AND of three gates is symmetric; three nested gates imply a hierarchy the biology may not have.

Loops are refused

PlatAnJr will not let you create a link that makes a node feed itself, directly or through any chain of other nodes. If a drop is refused, follow the wires - somewhere downstream, that node is already an ancestor of the one you are dragging from.

List gates and well gates

Two related gate types exist behind the scenes:

  • A list gate is what a well node created from a heat-map selection carries: an explicit list of plate positions.
  • A well gate holds a rectangular well selection.

Both behave like any other gate - they have a name, a colour, an output pin, and appear in the statistics tables.