Opening a plate¶
PlatAnJr treats a folder of FCS files as one dataset. Each file becomes a well; all wells share one event array, one parameter list and one set of scales. This is what makes a gate drawn once apply to the whole plate.
A "plate" of one file is perfectly normal - open a folder containing a single FCS file and you get a single-well dataset.
The Plate dialog¶
Click Open data on the toolbar, drag a folder onto the plate image, or use History to return to a folder you have opened before.
The dialog has four working areas:
- Directory tree (left)
- Navigate to the folder holding your FCS files. Recent drops down the folders you have opened before.
- File list
- Every FCS file found in the folder, each with a checkbox. Show All Files widens the
list beyond
.fcs; (Un)Check toggles all the checkboxes at once. - Plate grid (right)
- Rows A, B, C... and numbered columns. Each cell holds the name of the file loaded into that well. Drag a file from the list onto a well, or drag a well onto another well to move it.
- Parameter selection
- Select Parameters opens a checklist of the channels in the files. Only the checked channels are read.
Laying out the plate¶
| Control | Effect |
|---|---|
| Auto | Places every checked file that is not already on the grid into the first free well, in list order |
| 96 / 384 - well plate | Switches the grid size. PlatAnJr switches to 384 by itself if the files need it |
| <<< / >>> | Rotates the whole grid one well left or right - use it to shift a whole plate over by one position |
| Insert | Inserts a blank well, pushing the rest along |
| Delete | Clears the selected well |
| Delete All | Clears the grid |
| Allow Duplicates | When off, dropping a file into a well removes it from any other well. When on, one file can occupy several wells |
| Save Map / Load Map | Writes or reads the layout as a CSV file so it can be reused on another folder |
How well positions are guessed¶
When you select a folder, PlatAnJr tries to fill the grid for you:
- If the folder already has an
INFO\PlateMap.csvfrom a previous session, that layout is used and file names are not re-interpreted. - Otherwise PlatAnJr looks at the file names and recognises several instrument
conventions, among them:
- HyperCyt -
Sample_A01... - FACSCalibur - the three-digit numeric extension scheme
- CytoSpectrum and similar - names containing a well token such as
A1..H12or a tube token such asTube7
- HyperCyt -
- If nothing matches, the grid stays empty and you lay it out yourself with Auto or by dragging.
When you click OK, the approved layout is written to INFO\PlateMap.csv in the data
folder, so the next open reuses it.
Preview mode¶
The Preview mode toolbar button (pressed by default) loads only part of each file. Which part is set on the Options page:
- Preview Downsizer
- Keeps a fraction of the events - 1/2, 1/3, ... 1/10, 1/50 or 1/100. Events are taken at regular intervals through the file, so the sample is spread across the whole acquisition.
- Preview Max Cells/Well
- Caps each well at a fixed number of events, reading from the start of the file.
Exactly one of the two is active; ticking one unticks the other.
Preview numbers are preview numbers
Percentages hold up well under preview, but absolute counts, rare-population statistics and CVs do not. Release the Preview mode button and re-open the plate before you report results.
Preview affects loading only. Turning it on or off has no effect until you re-open the plate; the project, its nodes and its gates survive the reload untouched.
Reducing the parameter list¶
Select Parameters in the Plate dialog is the other lever on memory, and a bigger one than preview on a spectral instrument. A 64-detector file reduced to the 12 channels you are actually going to plot is five times smaller and noticeably faster to gate on.
The selection is remembered per data folder in INFO\selectedpars.ini.
Time¶
The parameter named Time is read in seconds. An FCS file counts time in ticks of
its $TIMESTEP - 0.01 s on many instruments - and PlatAnJr multiplies by it as it loads,
so a ten-minute acquisition runs from 0 to 600 whatever the instrument. A file with no
$TIMESTEP has only ticks, and they are left as they are.
Time is always linear. Some instruments mark it logarithmic ($PnD, $PnDISPLAY,
BD's PnDISPLAY); that is ignored for Time, and the scales remembered with the data folder
or saved in a project are not put on it either - it gets a fresh linear scale from its data
every time the plate opens. You can still change it for the session.
Files PlatAnJr saves - Save Plate, Save Gated Community, the unmixer's Save -
keep the instrument's $TIMESTEP and get Time back in its ticks, marked linear, so they
read the same here and in any other FCS software.
Projects from before
Earlier versions read Time in ticks. A gate on Time in a project saved then is off by the same factor - a hundredfold at 0.01 s a tick - and wants redrawing.
What PlatAnJr writes next to your data¶
Opening a plate creates an INFO subfolder inside the data folder if there is not one
already. That folder is where the plate map, parameter selection, scale defaults, unmixing
panels and (by default) your saved projects live. See
Files and folders for the full list.
Your FCS files are never modified.
Opening without the dialog¶
Pass the folder on the command line and PlatAnJr opens it silently, using the plate map already stored in that folder:
PlatAnJr.exe "D:\Experiments\Plate 17"
This is the form to use from scripts and scheduled jobs.
The History window¶
The History toolbar button lists the data folders and the project files you have opened before, in two columns. Pick a data folder to load it, then a project to load on top of it.
Loading a project before its data is legal - the project holds on to its scales until a dataset arrives and applies them then.