Free cats script

C = INSERTROWS(A,B,IND) inserts the rows of matrix B into the matrix A at the positions IND. Row k of matrix B will be inserted after position IND(k)in the matrix A. If A is a N-by-X matrix and B is a M-by-X matrix, C will be a (N M)-by-X matrix. IND can contain non-integers.

If B is a 1-by-N matrix, B will be inserted for each insertion position specified by IND. If IND is a single value, the whole matrix B will be inserted at that position. If B is a single value, B is expanded to a row vector. In all other cases, the number of elements in IND should be equal to the number of rows in B, and the number of columns, planes etc should be the same for both matrices A and B. If any of the inputs are empty, C will return A.

Examples:
% the size of A,B, and IND all match
C = insertrows(rand(5,2),zeros(2,2),[1.5 3])
% the row vector B is inserted twice
C = insertrows(ones(4,3),1:3,[1 Inf])
% matrix B is expanded to a row vector and inserted twice (as in 2)
C = insertrows(ones(5,3),999,[2 4])
% the whole matrix B is inserted once
C = insertrows(ones(5,3),zeros(2,3),2)
[C, RA, RB] = INSERTROWS(...) will return the row indices RA and RB for which C
corresponds to the rows of either A and B.
[c,ra,rb] = insertrows([1:4].,99,[0 3]) ;
c. % -> [99 1 2 3 99 4] ;
c(ra). % -> [1 2 3 4] ;
c(rb). % -> [99 99] ;
To insert columns, planes, etc., you can permute the inputs and ipermute the result.
A = ones(4,3) ; B = zeros(4,1) ;
C = insertrows(permute(A,[2 1]), permute(B,[2 1]),1) ;
C = ipermute(C,[2 1]) ;
See also PERMUTE, IPERMUTE, RESHAPE, CAT

Requirements:

• MATLAB Release: R13