Synthetic test data¶
Test generates a set of FCS files that look like single-stain controls and mixtures acquired on a chosen instrument. It is intended for testing unmixing software - including PlatAnJr's own unmixer - against data where the right answer is known.
Setting it up¶
- Check the dyes that should be in the data set.
- Press Test. A dialog opens with one row per checked dye.
- Choose the instrument in the dialog. The parameters of the files are all detectors of all its lasers.
- Fill in the grid and the options below, then press Save and choose an output folder.
The grid¶
| Column | Meaning |
|---|---|
| Dye | The checked dye |
| C (%) | Relative concentration of this dye in every file it appears in; 100 by default |
| Mix1, Mix2, ... | One column per mixture. Each cell is that dye's weight in the mixture; 1 by default |
Add Mixture adds another mixture column. Weights within a mixture are rescaled so the largest is 1.
Options¶
| Option | Meaning |
|---|---|
| Number of Events | Events per file |
| Noise Level (%) | Used when Poisson Noise is off. Adds a non-negative Gaussian background to every detector, at this level relative to full scale |
| Poisson Noise | Instead of Gaussian background, draw every detector value from a Poisson distribution - realistic photon-counting noise |
| Number of photons | With Poisson noise: the photon count at a normalised signal of 1. The label beside it shows the resulting relative standard deviation, 100 / sqrt(photons) % |
What is written¶
All files go into the chosen folder, as FCS 3.2 with 32-bit floating-point parameters named
after the detectors (<laser>nm - <centre>/<width>). Files are named after wells of a
96-well plate, in order, so the folder can be opened directly as a plate in PlatAnJr:
| Well | File | Content |
|---|---|---|
| A1 | Well_A1_NoDye.fcs |
Unstained control: background noise only |
| A2 onwards | Well_A2_<dye>.fcs, ... |
One single-stain control per dye, in grid order |
| After the controls | one file per mixture column | The weighted sum of the dyes' signatures, with noise. The weights, in percent, are written to the file's $FIL keyword |
Every event in a file carries the same underlying signal; only the noise differs between events.