slices

%SLICES return a cell array of slices of a tensor along the specied dimension
%
% This function is useful for slicing high-dimensional images (e.g. fMRI
% images) into lower-dimensional pieces. The output can then be either
% processed directly, or passed into cellfun or arrayfun for further
% processing.
%
% USAGE:
% x = slices(m,[d])
%
% INPUTS:
%
% m: a tensor (i.e. multi-dimensional matrix) that you wish to slice
%
% d: the dimnsion along which you wish to make the slices. default:
% d = ndims(m).
%
% OUTPUTS:
%
% x: a 1 by size(m,d) cell array of slices of m. each element of the
% cell array is an (ndims(m) - 1)-dimensional tensor.
%
% EXAMPLE:
%
% %create a tensor to slice
% m = reshape(1:100,10,10);
%
% %slice along first dimension: returns rows of m
% s1 = slices(m,1);
%
% %slice along second dimension: returns columns of m
% s2 = slices(m,2);
%
% %slice along third (or greater) dimension: returns m as a cell array
% s3 = slices(m,3);
%
% SEE ALSO: REPMAT, CELLFUN, ARRAYFUN, JOIN
%
% AUTHOR: JEREMY R. MANNING
% CONTACT: manning3@princeton.edu