Statistics and export¶
PlatAnJr reports gate statistics in three places, each answering a different question.
Per node: the gate grid¶
The table under every chart node covers the gates on that node:
| Column | Meaning |
|---|---|
| Name | The gate's caption |
| Count | Events in the gate |
| % | Percent of all events in the dataset |
| % parent | Percent of the population feeding this node |
| CV | Coefficient of variation |
This is the number you want while you are drawing gates: % parent is the frequency within the parent population, which is what a gating strategy is usually reporting.
Per project: the Gates side panel¶
The Gates tab in the left side panel lists every gate in the project, colour-coded by gate colour:
| Column | Meaning |
|---|---|
| Gate | Caption |
| Count | Events in the gate |
| Parent % | Percent of the parent population |
| % | Percent of the whole dataset |
| Mean | Mean value. For a 2-D gate, shown as X=... Y=... |
| Median | Median value, same convention |
| rSD | Robust standard deviation - the median absolute deviation scaled to a normal's SD (× 1.4826) - of each axis, same convention |
| CV | Coefficient of variation |
| MedianCV | The robust equivalent, from the median and rSD |
For a 2-D gate the spread is combined across both axes, so a single CV describes the population rather than one of its projections; rSD gives each axis its own. MedianCV is built from the median and rSD instead of the mean and SD, which makes it far less sensitive to a handful of outliers - prefer it on skewed or dirty populations.
Double-click a row to open that gate's properties (name and colour).
Export as CSV writes the whole table to a file.
Across gates: the Gate Stats window¶
Click Gate Stats on the project panel toolbar. The window has two tabs.
Hierarchy¶
Every population under the one it is gated from, the way the links define it, starting from All Events:
| Column | Meaning |
|---|---|
| Gating Hierarchy | The gate's caption. A folder icon marks a population with others gated from it, a page icon one with none; the icon takes the gate's colour |
| % of Parent | Percent of the population it is gated from. For a gate fed by more than one, the share of each parent that is also in the gate |
| % of Total | Percent of all events in the dataset |
| Event Count | Events in the gate |
| MFI (Marker) | The median of each marker the gate is drawn on, in linear units. Scatter and time are left out, so a gate on FSC/SSC shows a dash |
A gate fed by several others (an AND or OR gate, say) appears under each of them. Links switched off on a node's input do not count. The table follows the gates as they change.
- Export to CSV...
- Writes the table to a file:
Population, Depth, Parent, % of Parent, % of Total, Event Count, thenMarker 1, MFI 1, Marker 2, MFI 2. Numbers have a decimal point whatever the Windows locale, so the file reads the same everywhere. - Copy to Clipboard
- The same columns, tab-separated, with the population names indented by level and the numbers in your locale's format - paste into Excel or a report.
- Print...
- Prints the table as you see it, shrunk to the page width if it is wider, with the file name on top and page numbers below; long hierarchies continue on further pages, each with its own header.
Gate Matrix¶
- Gate list
- Every gate with a checkbox. Unchecking one removes it from the matrix - useful for cutting a large project down to the gates you actually want to compare.
- Cross-tabulation matrix
- One row and one column per included gate. Off the diagonal, each cell gives the count and percentage of events that are in both gates. On the diagonal, the count and percentage of the total.
This answers the question a gating tree cannot: how much do two populations that are not parent and child actually overlap? It crosses every gate with every other, so it is worked out only while this tab is showing.
Per well: the heat map¶
To see how a population varies across the plate rather than in aggregate, click a node to make it active and read the heat map. Each well is coloured by the fraction - or count - of its events that reached that node, and Export writes the per-well numbers as CSV.
This is the export to use for a screen: one row per well, one value per well, ready to join to a plate layout.
Exports at a glance¶
| What | Where |
|---|---|
| Every gate with its statistics | Gates side panel ▸ Export as CSV |
| The gating hierarchy | Gate Stats window ▸ Export to CSV / Copy to Clipboard / Print |
| Per-well values for the active node | Heat Map tab ▸ Export |
| The numbers behind one chart | Double-click the chart ▸ Export as CSV |
| A chart as a picture | Double-click the chart ▸ Copy To Clipboard |
| The plate picture | Heat Map tab ▸ Copy |
| Each gate's events as CSV | Node menu ▸ Export - one file per gate on the node |
| Gated events as FCS files | Node menu ▸ Save Gated Community |
| A node and its gates, for reuse | Node menu ▸ Save (.gat) |
A note on preview mode¶
Counts and CVs computed while Preview mode is on are computed from the fraction of events that was loaded. Percentages are usually close; absolute counts are not, and rare populations may not be represented at all. Turn preview off and re-open the plate before exporting anything you intend to report.