Skip to content

Your first analysis

This walkthrough takes a folder of FCS files from disk to a gated population with per-well statistics. It should take about ten minutes. Nothing here is destructive: the only files PlatAnJr writes are inside an INFO folder next to your data.

1. Open the plate

Click Open data on the toolbar. The Plate dialog appears.

  1. Pick the folder holding your FCS files in the directory tree on the left. The file list fills, and the plate grid on the right is filled in automatically if PlatAnJr can work out well positions from the file names.
  2. If the grid is empty or wrong, click Auto to drop the checked files into the first free wells in order, or drag entries into place by hand. Delete, Delete All and Insert edit the grid.
  3. Click Select Parameters and check only the channels you actually need. Fewer parameters means a much smaller dataset in memory.
  4. Click OK.

Leave the Preview mode toolbar button pressed for now - it loads a fraction of each file so everything responds instantly while you set the analysis up.

The plate appears in the Heat Map tab and the event count appears next to the folder name in the toolbar.

Tip

PlatAnJr writes the layout you approved to INFO\PlateMap.csv in the data folder. Next time you open the same folder, that map is used and you do not have to lay it out again.

2. Make the first plot

Click Scatter Plot on the project panel toolbar. A chart node appears in the project panel showing a density plot of the first two parameters.

  • Click the X axis to choose a different X parameter; click the Y axis for Y.
  • Click the corner between the two axes to swap them.
  • Drag a rectangle on the plot to zoom; drag from the bottom-right to the top-left to zoom back out.

Set X and Y to your scatter parameters (for example FSC and SSC).

3. Draw a gate

Shift +click on the plot to start a polygon, then click once per vertex. Close the polygon by clicking the first vertex again, or right-click anywhere to finish.

The gate appears on the plot with a caption - a name PlatAnJr makes from where the gate lies, such as Cells on FSC against SSC - a row is added to the grid under the chart, and a coloured output pin appears on the right-hand edge of the node.

You can now:

  • Drag a vertex to reshape the gate.
  • Drag the middle of the gate to move it.
  • Right-drag inside the gate to rotate it.
  • Click the colour swatch in the grid row to recolour it.
  • Click the delete cell in the grid row to remove it.

Every change re-runs the gate over all the events immediately.

4. Gate on the gate

Create a second Scatter Plot node. Now drag from the output pin of your first gate onto the body of the new node. A link is drawn between them.

The second node now plots only the events that passed the first gate. Set its axes to the markers you care about, and draw a gate on it the same way.

Repeat as many times as your gating strategy needs. To combine two gates instead of nesting them, create a Boolean AND node and drag both output pins onto it - see Well and logic nodes.

5. Read the numbers

Three places show you the result:

  • The grid under each chart node - cell count, percent of total, percent of parent, and CV for every gate on that node.
  • The Gates tab in the side panel - every gate in the project in one table, with Export as CSV.
  • The Heat Map tab - click a node's body to select it, and the plate colours each well by how many of its events reached that node. Toggle between percentages and raw counts with the value selector above the plate.

6. Turn preview off

Release the Preview mode toolbar button and re-open the plate. PlatAnJr reloads every event of every file; your project, its nodes and its gates are unaffected, and all the statistics recompute against the full data.

7. Save the project

Click Save project. The save dialog opens in the INFO folder of your data by default, which is where projects belong: keeping the .ppj next to the data means anyone who opens that folder finds the analysis with it.

Next time, open the plate first and then load the project - or pass both on the command line.

Where to go next