Documentation

Files

Open File

Floreada.io supports the FCS2.0, FCS3.0 and FCS 3.1 file formats. To open a file, click "File" then "Open File(s)". This opens a menu where you can select one or more FCS files from your computer to analyze. When selected, files are parsed and displayed in your browser as dot plots.

In general, files with under 1 million events and less than 15 parameters, should load instantaneously. When opening larger files it may take a moment. We are working on making this faster. When files are loaded in the browser, they remain entirely on your computer. No data are sent to our servers.

If you try to open a file and you receive an error message, that particular file is not currently supported. Please contact us if you encounter any problems. Although there is an official standard way in which FCS files are supposed to be internally organized, cytometers are notorious for breaking the rules when exporting their FCS files. If you are able to send us a file from your specific cytometer, when can usually add support for it within a day or two.

The "Projects" sidebar lists all open files grouped by project and highlights the name of the file you are currently viewing. Each file is grouped into a project using the "$PROJ" keyword in its FCS file. There is no way to change this behavior at this time.

Close File

To close a file, right click on the file in the "Projects" sidebar and click "Delete". When closed, the file and all associated gates are removed. Alternatively you can delete a file by selecting it and pressing the "delete" key on your keyboard.

Renaming a File

The default name for an FCS file in the population tree is the value of the $FIL keyword of the file. You can rename it to whatever you want by opening up the "details" menu for the file, either by right clicking the file and clicking "details", or by double clicking the file. In the Details popup menu, you can change the display name of the file. Note that renaming a file in Floreada does not change the name of the actual file on your computer.

Cycle Files

If you have multiple files open, you can switch to a different file by clicking its name in the population tree.

You can use the Up/Down arrow keys to cycle through the files in a project to compare their dot plots. You can use the Left/Right arrow keys to step in and out of different levels in the file tree.

Additionally, the ◀ | ▶ icons next to the file name label cycle through files.

Keywords

FCS files contain a "TEXT" section in the file format which contain key-value pairs. Many of these are used to interpret the data in the file correctly. Others contain information such as the number of events in the file, of the project name. You can view all the keywords in the currently displayed file by selecting "Keyword" button in the gating panel.

Keywords can not be added or edited at this time.