Skip to content

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

  1. Check the dyes that should be in the data set.
  2. Press Test. A dialog opens with one row per checked dye.
  3. Choose the instrument in the dialog. The parameters of the files are all detectors of all its lasers.
  4. 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.