Javascript / node.js code to read FCS flow cytometry data. Will read all of the HEADER, TEXT, and ANALYSIS segments into key/value pairs. Reads raw (likely uncompensated) data as well, either into numeric arrays for further analysis, or as Strings for quickly scanning the data.

1. Get the FCS file into a Buffer
2. Create a new FCS(theBuffer, options)

e.g. to read from a file asynchronously

    var FCS = require('fcs');
    FS.readFile(filename, function(err, databuf) {
        if (err) {
            console.error(err);
            }
            else {
           var fcs = new FCS(options, databuf);
           // do something with fcs
            }
   });

• dataFormat: 'asNumber', 'asString', 'asBoth', or 'asNone'
• groupBy: 'byEvent', 'byParameter'
• decimalsToPrint: 2
• eventsToRead: 1000 // an integer, -1 means "all events"
• maxPerLine: 10
• eventSkip: 0 if eventsToRead is less than the events in the file, this allows you to more randomly sample. A value of 'true' has them equally distributed. 0 means read the first events from the file.

Any additional options are ignored, but will be printed under a "meta" segment in the JSON. For example, you might want to include a date, your laboratory, etc...

Constructor. Both arguments are optional. If buffer is present it will be read, otherwise you need to call readBuffer() or readStreamAsync() later

Set or add options.

Read data from buffer. moreOptions are optional. Hopefully by now you've set them all! :-)

Reads data asynchronously from a readStream. moreOptions is optional. When complete, calls callback(err, fcs).

The readableStream arg is optional. Creates a writeableStream ready to parse an FCS format file. e.g.

var fws = fcs.prepareWriteableStream(callback, readableStream);
readableStream.pipe(fws);

When piping is complete, will call callback(err, fcs).

segment should be one of ('text', 'analysis', or, more rarely, 'header', 'meta'). If no keywords are provided, returns that entire segment otherwise, returns a single value, stopping at the first match to the keyword. Returns null if none were found.

Equivalent to get('text', keywords) e.g. `text('$P3N') might return 'FL1-H'

Return an array of all N keywords for that P.X combination. The 0th value will be empty. e.g. `get$PnX('N') might return ['', 'FSC, 'SSC', 'FL1-H', ...]

Equivalent to get('analysis', keywords)

Returns an array of Numbers for the respective event or parameter, iff you requested numeric data.

Returns an array of Strings for the respective event or parameter, iff you requested string data.

Returns a subset of the JSON, based upon onlys, an array of dot delimited Strings e.g. getOnlys(['meta','text.$P1N') would return all of meta, plus parameter 1 name

Holds the HEADER segment (first 256 bytes). The version is header.FCSVersion

Holds all the TEXT segment

Holds all the ANALYSIS segment. If none, is an empty object {}

Holds all the options, plus a bit more

• doesn't handle $BEGINSTEXT, $ENDSTEXT
• could do more with Millipore's XML ANALYSIS

• v0.1.0 17 Nov 2018 partly converted to use ES6 features