fcsreadwell.m

function [data,meta] = fcsreadwell(datadir, platename, wellid)
% FCSREADWELL loads fcs data from a file whose name begins with the string
% PLATENAME and whose header identifies it as being from well WELLID. The
% function relies on the metadata contained in the FCS header to determine
% the well corresponding to a certain file.
% 
% This function used to be called LOADWELLDATA but was renamed to be
% consistent with other functions.
% 
% Example:
% 
%   fcsreadwell('../data/','plate1','A01')
% 
% loads data for well A01 from a file such as 'plate1_001_001.fcs'
% 
% 20130310


% load filename cache
global wellfilenameindex;
try
    load([datadir 'wellfilenameindex.mat']);
catch
    disp('No filename cache found. Generating...');
    makewellfilenameindex(datadir);
end

% standardize wellid string
[r,c] = well2coord(wellid);
wellid = coord2well(r,c);

platename = genvarname(platename);

if isfield(wellfilenameindex,platename) && ...
        isfield(wellfilenameindex.(platename),wellid)
    fn = wellfilenameindex.(platename).(wellid);
    [data meta] = fcsparse([datadir fn],'rename');
else
    disp(['File not found or not in cache: ' platename ' ' wellid]);
    data=[];
    meta=[];
end