add FacemapInterface

[bendichter]

relates to #188

[bendichter]

Doing a little more research it looks like this is handling the old MATLAB-based format. This is the format used by the Higley Lab. Here is an explanation of the fields:

MATLAB output:

• nX,nY: cell arrays of number of pixels in X and Y in each video taken simultaneously
• sc: spatial downsampling constant used
• ROI: [# of videos x # of areas] - areas to be included for multivideo SVD (in downsampled reference)
• eROI: [# of videos x # of areas] - areas to be excluded from multivideo SVD (in downsampled reference)
• locROI: location of small ROIs (in order running, ROI1, ROI2, ROI3, pupil1, pupil2); in downsampled reference
• ROIfile: in which movie is the small ROI
• plotROIs: which ROIs are being processed (these are the ones shown on the frame in the GUI)
• files: all the files you processed together
• npix: array of number of pixels from each video used for multivideo SVD
• tpix: array of number of pixels in each view that was used for SVD processing
• wpix: cell array of which pixels were used from each video for multivideo SVD
• avgframe: [sum(tpix) x 1] average frame across videos computed on a subset of frames
• avgmotion: [sum(tpix) x 1] average frame across videos computed on a subset of frames
• motSVD: cell array of motion SVDs [components x time] (in order: multivideo, ROI1, ROI2, ROI3)
• uMotMask: cell array of motion masks [pixels x time]
• runSpeed: 2D running speed computed using phase correlation [time x 2]
• pupil: structure of size 2 (pupil1 and pupil2) with 3 fields: area, area_raw, and com
• thres: pupil sigma used
• saturation: saturation levels (array in order running, ROI1, ROI2, ROI3, pupil1, pupil2); only saturation levels for pupil1 and pupil2 are used in the processing, others are just for viewing ROIs
  an ROI is [1x4]: [y0 x0 Ly Lx]

source

[alessandratrapani]

stub version here

[weiglszonja]

can you add tests here @alessandratrapani ? we have our test data repository here, can you make a small example file or ask for a small example data that we can add to our testing suite?