MATHEMATICA IMPORT/EXPORT FORMAT

FCS (.fcs, .lmd)

FCS molecular biology format.
Standard format for storing and exchanging flow cytometry data.
Mixed ASCII/binary format.
Stores signal intensities for cell events as an array.
Meta-information about the data acquisition is stored in the file.

Import supports most popular variants of the FCS file format, including Versions 2.0, 3.0, and 3.1 with events stored as 8-, 16-, 24-, 32-, 64-, and 128-bit integers or 32- and 64-bit reals.
Export generates FCS3.1 files.

Import and Export Import and Export

Import["file.fcs"] returns an array representing the cellular events stored in the file.
Export["file.fcs", {paramnames, events}] exports a list of parameter names and an array of events to the FCS format.
Export["file.fcs", {paramnames, paramreagents, events}] exports a list of parameter names, a list of parameter reagents, and an array of events to the FCS format.
Import["file.fcs", elem] imports the specified element from an FCS file.
Import["file.fcs", {{elem₁, elem₂, ...}}] imports multiple elements.
The import format can be specified with Import["file", "FCS"] or Import["file", {"FCS", elem, ...}].
Export["file.fcs", {expr₁, expr₂, ...}, {{elem₁, elem₂, ...}}] treats each as specifying the corresponding .
Export["file.fcs", expr, opt₁->val₁, ...] exports expr with the specified option elements taken to have the specified values.
Export["file.fcs", {elem₁->expr₁, elem₂->expr₂, ...}, "Rules"] uses rules to specify the elements to be exported.
See the reference pages for full general information on Import and Export.
ImportString and ExportString support the FCS format.

Elements Elements

General Import elements:

	"Elements"	list of elements and options available in this file
	"Rules"	full list of rules for each element and option
	"Options"	list of rules for options, properties, and settings

File metadata:
"Header" raw file header given as a list of rules
Data representation elements:

	"Events"	cellular events as an array
	"ParameterName"	parameter names as a list of rules (import) or a list (export)
	"ParameterReagent"	parameter reagents as a list of rules (import) or a list (export)

Additional data elements:
"Data" cellular events as an array

"LabeledData" list of rules for data stored in the file
Import uses the element by default for the FCS format.
Export requires at least a list of parameter names and an array of events.
Export can optionally take a list of parameter reagents. All other optional keys must be specified via the option.

Options Options

Advanced Export options:
"DataType" Automatic data type used to encode events

"OptionalKeys" {} optional keys to include in the header, as a list of rules
Mathematica attempts to identify the most compact format in which the events can be encoded. Automatic data type identification may be overridden via the option.
Valid settings for are:

	"UnsignedInteger8"	8-bit unsigned integer
	"UnsignedInteger16"	16-bit unsigned integer
	"UnsignedInteger24"	24-bit unsigned integer
	"UnsignedInteger32"	32-bit unsigned integer
	"Real32"	IEEE single-precision real number
	"Real64"	IEEE double-precision real number

Mathematica will automatically overwrite certain protected keys (such as "$BEGINDATA" and "$BYTEORD") that are specified in . Thus, if you are re-exporting an imported FCS file, you may directly set to the value of the element from the imported FCS file. Parameter reagents ($PnS keys) will be removed from only if parameter reagents are provided in the main Export expression.