Gate types¶
Every gate in PlatAnJr belongs to a node, has a name and a colour, produces an output pin, and can be linked to downstream nodes. What differs is how the selection is defined.
Gate names¶
A new gate is named after where it lies on its plot, the way you would name it yourself:
| The gate | Its name |
|---|---|
| High on CD3, low on CD4 | CD3+ CD4- - the X axis first |
| Forward against side scatter | Cells |
| A channel's area against its height or width | Singlets |
| On a viability dye | Live or Dead, in front of the rest |
| A marker against side scatter | The marker alone, CD45+ |
| On time | Time |
| On a histogram | Its X axis alone, CD19+ |
High and low are the halves of the plot as it is shown, and a gate across most of an axis
says nothing about that axis. The marker is read from the axis title without its
fluorochrome or detector - B1-A_CD3 FITC and CD3_BV421 are both CD3. The four
quadrants are named the same way, CD4- CD8+ and so on. When neither axis says anything,
the gate keeps a plain letter. Rename it like any other.
Polygon gates¶
The standard 2-D gate.
To draw one: Shift +click on a 2-D chart to place the first vertex, then click once per additional vertex. Finish by clicking the first vertex again (available once you have more than three) or by right-clicking anywhere.
To edit one:
| Action | Result |
|---|---|
| Drag a vertex | Reshape |
| Drag inside the gate | Move it |
| Right-drag inside the gate | Rotate it |
| Drag the caption | Move the label without moving the gate |
| Drag the gate off the plot onto another node | Link that node to this gate |
Every edit re-runs the gate over all events immediately, so the statistics and every downstream node follow the gate as you drag it.
A polygon gate is defined on two named parameters. If you change the chart's axes, the gate stops being drawn - it still exists and still works, it is just not being shown. Click its row in the gate grid to bring its parameters back onto the axes.
Band gates¶
The standard 1-D gate: a range on one parameter.
To draw one: Shift +drag horizontally across a histogram node. A shaded band appears between the two X positions.
To edit one: drag either edge to change a limit, or drag the middle to move the whole band. Drag the middle out of the node to link the band to another node, as a polygon gate is dragged off its plot.
Band gates are what Create Gates produces on a histogram: PlatAnJr finds the peaks in the distribution, works out where one population stops and the next begins, and lays a band over each. Existing gates on the node are cleared first.
Quadrant gates¶
Create Quadrant Gate on a 2-D chart node's floating toolbar - or Create Gates on the node menu - divides the plot into four and creates four linked gates: top-left, top-right, bottom-left, bottom-right.
The four are siblings: move the boundary on one and the other three follow, so the quadrants always partition the same area with no gap and no overlap.
Zoom first
The quadrants are built to span the currently visible window, not the full data range. Set the zoom the way you want the quadrants to sit before you create them.
Automatic gating¶
The autogate button on a 2-D chart node's floating toolbar draws one gate per click around the most populated region that is not already gated.
How it works: PlatAnJr builds a density map, smooths it, cuts out the area of the gates that already exist, and finds the peaks together with the saddles between them. Each peak's territory reaches down to the highest saddle at which it meets another population - the saddle, not the shape, is what decides where one population stops and the next begins. The gate is then the largest contour layer around that peak whose region is still convex, taken as its convex hull and reduced to at most Autogate vertices vertices - Options ▸ Data, 8 by default.
Practical consequences:
- Click repeatedly. Each click finds the next population. When nothing sizeable is left, nothing happens.
- Gates never overlap, and never grow into an existing gate.
- A dense population with a diffuse one leaning against it comes out as two gates, even though their union is a single convex blob. That is what the saddle test is for.
- Anything holding less than about 1% of the events is treated as a tail, not a population - which is what stops the sequence rather than producing gates of four events.
The result is an ordinary polygon gate. Reshape it, rename it and recolour it like any other.
Threshold gates¶
A gate on one side of a value in one parameter, rather than between two values. Thresholds are set with the cursor tools on the main-window histogram; Set Marker and Reset Cursors on the chart's context menu place and clear them.
Logic gates¶
Boolean combinations of other gates. Create a Boolean AND, OR, XOR or NOT node and drag the gates you want combined onto it; its output pin carries the result.
See Well and logic nodes.
Well gates and list gates¶
Selections by well rather than by measurement:
- A well gate holds a set of plate positions - everything acquired in those wells.
- A list gate holds a list of wells chosen from a checklist.
These are how you separate treatment groups, timepoints or replicates on a plate. Select wells on the heat map and press Gate to make one, or use a well node - see Well and logic nodes.
Embedding gates¶
A polygon drawn on the Embedding tab's tSNE, UMAP, PCA or autoencoder plot only marks a
region of that plot - it is not a gate and defines no population. Each method adds its
coordinates to the dataset (PC1/PC2, and name-1/name-2 for tSNE, UMAP and
a model - tSNE-1/tSNE-2 and UMAP-1/UMAP-2 by default), so to gate a region
of an embedding, plot the pair on a chart node and use an ordinary polygon gate there. An
embedding node plots its pair on its own chart, so gate there
directly.
See Dimensionality reduction.
Ctrl +click on an embedding-plot polygon deletes it.
Gate properties¶
Double-click a gate's row in the Gates side-panel tab to open its properties: name and colour. Press Enter to accept.
You can also rename a gate by clicking its name cell in a chart node's gate grid, and recolour it by clicking the colour cell.
Saving and reusing gates¶
From the node menu:
| Item | Effect |
|---|---|
| Save | Write this node - its gates and its settings - to a .gat file. The dialog opens in the plate's INFO folder - with no plate open, where you last saved or loaded one - and offers the gates' names as the file name (Monos+Lymps.gat) |
| Load as New Gate | Read a .gat file back in as a new node on the canvas. The dialog opens in the same folder as Save's |
| Clone | Add a copy of this node - its gates and its settings - as a new node, a little below and right of it. The copy has no input links, so it sees every event until you connect it |
A .gat file carries the gate geometry together with the parameter names the gates are
defined on, so it transfers between datasets that share parameter names - a standard gating
template applied across experiments.
Gate names stay unique: a gate that comes in through Load as New Gate or Clone under
a name another gate already has gets a number, as a gate renamed to a name in use does -
Monos becomes Monos_1, or Monos_2 when Monos_1 is taken too. The gates of a clone are
always numbered, since the original keeps their names.