% DIMEXP Dimension Expansion Toolbox.
%
% OPDIM : Operating dimension of an N-D array, supports the usage
% of the first non singleton diemnsion as default dimension.
% NDOP : Extends any function operating with 1-D array inputs in an
% easy way to the usage of N-D array inputs for multiple
% argument operations (i.e. unitary, binary, ...).
%
% @author Ingo Lhken, ingo.loehken@gmx.de
% @rev 27/10/2005
% @toolbox DIMEXP, ver 0.1
% ********
% Description for MATHWORKS
% ********
%
% Dimension Expansion Toolbox
%
% operating, dimension, 1d array, abstraction, function, expansion
%
% Expands functions to usage of N dimensional inputs.
%
% Listed below are some examples to demonstrate the power of the toolbox. For detailed usage please refer to the NDOP function in the toolbox.
%
% (1) Expansion of SUM : Concept Study.
%
% Y = ndop(@sum,X,DIM)
%
% is equal to the usage of the common SUM function, but constitutes the concept the simplest way.
%
% (2) Expansion of the DCT : First Usage.
%
% Y = ndop(@dct,X,DIM,N)
%
% expands the DCT to N dimensions, where DIM is the operating dimension, N the padding/truncating length and X the N-D array input.
%
% (3) Exp. of INTERSECT : Binary Usage.
%
% [C,AI,BI] = ndop(inf,@intersect,A,B,DIM)
%
% is the INTERSECT function expanded for the usage of N-D arrays A,B, where DIM is the operating dimension.
%
% (4) Demonstrating Trimlength Usage T,
% by expanding the UNIQUE function
%
% B = ndop(T,@unique,1,A,DIM);
% A = [1,1,1;1,2,3]
%
% (a) Maximum Trimlength T = inf
% B = [1,NaN,NaN;1,2,3]
%
% (b) Minimum Trimlength T = -inf
% B = [1;1]
%
% (c) Fixed Trimlength T = 2
% B = [1,NaN;1,2]