Skip to content

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.csv becomes 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.