File formats¶
Spectrum databases¶
.stream files - the default database, subsets, and any database you save - are
BFSpectra's own binary format. Open and save them only with BFSpectra (or PlatAnJr). To
get spectra out in a readable form, use
Export - raw spectra.
Spectrum files¶
New Db and Update DB read every *.txt and *.csv file in the chosen folder. Two
layouts are understood.
Three-column CSV¶
A .csv file with wavelength, excitation and emission on each line:
Wavelength,Excitation,Emission
300,0.012,0
301,0.013,0
...
421,0.04,1.000
- The dye name is the file name up to the first underscore:
BV421_Biolegend.csvbecomes BV421. - Lines that do not start with three numbers - headers, comments - are skipped.
- A zero leaves that wavelength out of that curve, so a file can hold an excitation curve and an emission curve that cover different ranges.
- Fields may be quoted.
This is the format written by Export - Raw Spectra.
Separate excitation and emission files¶
Two files per dye, named <dye> ex.txt and <dye> em.txt (a space before ex / em):
Alexa Fluor 488 ex.txt
Alexa Fluor 488 em.txt
Each line holds a wavelength and a value, separated by a tab or a comma. If a line has more than two columns, the first is the wavelength and the last is the value. Negative values are set to 0 and lines that are not numeric are skipped. Lines do not need to be in wavelength order.
A .csv file that is not in the three-column layout is also tried with this naming rule.
After import¶
Each curve is normalised to a peak of 1. A dye whose excitation or emission curve is missing, or whose wavelengths do not make sense, is flagged with a red name in the dye table.
Instrument files¶
Instruments are .ini files in C:\Users\Public\Documents\BFSpectra\Devices\, one per
cytometer. The file name does not matter; the displayed name comes from DeviceName.
[Header]
DeviceName=Cytek Aurora 3L
Version=1
[405]
V1=428,15
V2=443,15
V3=448,15
[488]
B1=508,20
B2=525,17
[640]
R1=660,17
R8=812,34
[Header]
| Key | Meaning |
|---|---|
DeviceName |
Name shown in the instrument box |
Version |
Write 1. It selects the detector-line layout below |
LongPass |
Upper limit, nm, used for detectors marked LP |
ShortPass |
Lower limit, nm, used for detectors marked SP |
DefaultWidth |
Band width used when a detector line gives only a centre |
One section per laser. The section name must contain the laser wavelength in nm, e.g.
[405] or [Violet 405]; the number in it is used as the laser line.
One line per detector, in the form <name>=<value>:
| Value | Detector band |
|---|---|
508,20 |
Centre 508 nm, width 20 nm (498 - 518) |
500,540 |
If the second number is larger than the first: from 500 to 540 nm |
780,LP |
Long-pass: from 780 nm up to LongPass |
450,SP |
Short-pass: from ShortPass up to 450 nm |
508 |
Centre 508 nm with DefaultWidth |
Detectors are used in the order they are listed.
Files without Version
Older files have no Version key. In those, each line is <centre>=<width> (or
LP / SP) and the detectors have no names. Such files still load.
Check lists¶
Plain text, one dye name per line. See Check List.
Panel CSV¶
Written by Export in the panel editor: the title, then the instrument name followed by the checked lasers, then the table with its header row. Read back with Import.
Synthetic FCS files¶
FCS 3.2, 32-bit float. See Synthetic test data.