Derived parameters¶
PlatAnJr can add new parameters to a loaded dataset. A derived parameter behaves exactly like one read from the file: it appears in every parameter picker, gets its own scale, and can be gated on.
Derived parameters live in memory and in the project. Your FCS files are not touched.
Ratios, sums and differences¶
Click Create New Parameter on the toolbar.
One parameter at a time¶
- Pick a parameter in the left combo.
- Pick the operation:
:(divide),*,+,-, ordel. - Pick a parameter in the right combo.
- Type a name for the result.
- Click Ok.
The operation is applied event by event on the compensated values. Division by zero yields zero rather than an error.
del is the odd one out: it produces the difference between each event and the next one,
with the mean absolute difference in the last position. It is a stability measure - a
clean acquisition gives small differences, a drifting or clogging one does not. To find
the disturbed stretches of each well and gate them out, use a
PeacoQC node.
Many at once¶
The dialog also has two checklists of parameters. Check a set in each, choose the
operation, and click the second Ok: PlatAnJr pairs them in order - first checked
on the left with first checked on the right, second with second, and so on - and creates
one new parameter per pair. Names are built from the two source names joined by the
operator, so you get CD3:CD19-style names without typing any of them.
Use Check All, Uncheck All and Find to work the lists; Find opens an incremental search over the parameter names.
If one list has more checked entries than the other, the extras are ignored.
Phasor parameters¶
The Phasor button on the project panel toolbar computes a phasor decomposition across a set of channels.
- Click Phasor. A parameter selector opens; check the channels that make up the spectrum (for a spectral instrument, all the detectors).
- Optionally type a Prefix; it is prepended to every name created.
- Click OK.
Five parameters are added:
| Name | Meaning |
|---|---|
INTh1 |
Total intensity |
G-Harmonic1, S-Harmonic1 |
The first-harmonic phasor coordinates |
G-Harmonic2, S-Harmonic2 |
The second-harmonic phasor coordinates |
PlatAnJr then creates two chart nodes for you - G vs S at the first harmonic and at the second - so the phasor plots appear immediately.
Phasor coordinates are unaffected by intensity, so populations separate by spectral shape. It is a fast way to see how many distinct spectra a sample contains before committing to an unmixing panel.
Unmixed parameters¶
Spectral unmixing adds one parameter per dye. See Spectral unmixing - the Add Unmixed Parameters button, with its own Prefix field, is what puts the abundances into the dataset so you can gate on them.
Embedding coordinates¶
PCA adds PC1 and PC2. tSNE and UMAP ask for a name before they run and add
name-1 and name-2 - tSNE-1/tSNE-2 and UMAP-1/UMAP-2 with the names
they offer. A model - an autoencoder, or a map of a tSNE or UMAP result - adds two
parameters named after it, model name-1 and model name-2, whenever it is trained
or applied. An embedding node adds its pair the same way, and
FlowSOM adds name-node and name-meta. Gating on these on a chart node is how you gate a region of an embedding and
carry that gate into the rest of the analysis. Running the method or the model again
replaces the values. See Dimensionality reduction.
Managing derived parameters¶
- New parameters are appended to the end of the parameter list.
- They take a default scale derived from their own data range - check it on Options ▸ Parameter Scales and change the type if the default does not suit.
- Re-opening the plate discards them, since they are computed from the data that was loaded. Loading a project that contains nodes plotting them will not bring them back; recreate them, or keep the parameter-creation step at the front of your workflow.
Tip
If you find yourself creating the same derived parameters on every plate, make them the first thing you do after opening the data, before you build any nodes. Then a single saved project works unchanged across plates.