% -*- texinfo -*-
% @deftypefn {Function File} {@var{A} = } col2im (@var{B}, [@var{m},@var{n}], [@var{mm},@var{nn}], @var{block_type})
% @deftypefnx {Function File} {@var{A} = } col2im (@var{B}, [@var{m},@var{n}], [@var{mm},@var{nn}])
% Rearranges matrix columns into blocks.
%
% @code{A=col2im(B,[m,n],[mm,nn],block_type)} rearranges columns of
% matrix @var{B} intro blocks in a way controlled by @var{block_type}
% param, which can take the following values:
%
% @table @code
% @item distinct
% It uses @var{m}-by-@var{n} distinct blocks (which are not
% overlapped), and are rearranged to form a @var{mm}-by-@var{nn} matrix
% @var{A}. @var{B}'s height must be @var{m}*@var{n} and @code{col2im}
% rearranges each column to a @var{m}-by-@var{n} block and uses them to
% fill the whole matrix in left-to-right and then up-to-down order.
% @item sliding
% Is uses @var{m}-by-@var{n} sliding blocks. It rearranges row vector
% @var{B} to a (@var{mm}-@var{m}+1)-by-(@var{nn}-@var{n}+1) matrix
% @var{A}. @var{B} must be a
% 1-by-(@var{mm}-@var{m}+1)*(@var{nn}-@var{n}+1).
% @end table
%
% @code{A=col2im(B,[m,n],[mm,nn])} takes @code{distinct} as a default
% value for @var{block_type}.
%
% @seealso{im2col}
% @end deftypefn