Heat map¶
The Heat Map tab shows the plate as a grid of coloured wells. Each well is coloured by how many of its events reach the active node - so as you build a gating strategy, the heat map answers "and how does that vary across the plate?" without any extra work.
Choosing what is shown¶
Click a node's body in the project panel to make it active. The heat map immediately recolours to show that node's input population per well. Click the same node again to deactivate it; the map then shows every event.
Two controls above the plate:
- Value type
-
Percent - each well coloured by the fraction of its events that reached the node. Count - coloured by the absolute number.
Percent is the right default: it corrects for wells that happened to collect more events. Switch to counts when the number itself is the readout, as in a cell-count or proliferation assay.
- Map source
- Which population the colouring is derived from.
The colour bar beside the plate shows the range in use. Click the colour bar to toggle autoscaling: on, the colour range is stretched to the spread actually present, which brings out small differences; off, it runs over the full range, which makes plates comparable with each other.
Show Text prints the value inside every well.
Reading the status bar¶
Below the plate:
- Selected = n / total - the gated and total event counts over the wells you have selected.
- Total = n / total - the same over the whole plate.
With Percent chosen, these read as percentages. This is the quickest way to get the frequency of a population across an arbitrary subset of wells: select them and read the number.
Selecting wells¶
| Action | Result |
|---|---|
| Click a well | Select just that well (clicking an already-selected well deselects it) |
| Drag | Select a rectangle of wells |
| Ctrl +click or Alt +click | Add or remove a single well without clearing the rest |
| Ctrl +drag or Alt +drag | Add a run of wells to the selection |
| Shift +click | Extend the selection as a rectangle from the anchor well |
Hovering a well shows its identity and counts in a tooltip.
Selections drive several things elsewhere:
- Gate above the plate turns the selection into a well node.
- Well vs Parameter plot and SSM nodes take the selected wells as their ribbon list.
Exporting¶
| Button | Effect |
|---|---|
| Export | Write the heat map as a CSV file - one value per well, laid out as the plate |
| Copy | Copy the picture to the clipboard |
| Save Layout | Write the plate layout to INFO\Layout.pap in the data folder |
Open Layout beside it, and the Autoload Layout option, are present but not
implemented in this build. The layout actually reused between sessions is
INFO\PlateMap.csv, written when you approve the Plate dialog.
The CSV export is the deliverable for a screen: a plate-shaped table you can join to a compound map or a treatment list.
The 3-D view¶
The 3-D info tab shows the same numbers as a three-dimensional bar chart, one bar per well. It is a better picture for a presentation than the flat map, and worse for reading values off - use the heat map for the latter.
Loading data by drag and drop¶
Dragging a folder from Explorer and dropping it on the plate image opens it as a plate. This is the fastest way to move between datasets.
What each well is¶
The Legend tab beside the heat map is the Plate Editor: there you say which wells are controls and which are samples, and what each stains for.
Empty and disabled wells¶
- Wells with no file are drawn in the empty-well colour and take no part in any statistic.
- Wells can be disabled, which removes their events from the analysis without removing the file from the layout.