Is there an error in the documentation for the COL2IM function in the Image Processing Toolbox 3.2 (R13)?

The documentation and help for the COL2IM function state the following:

 A = col2im(B,[m n],[mm nn],'distinct') rearranges each column of B 

 into a distinct m-by-n block to create the matrix A of size mm-by-nn. If 

 B = [A11(:) A12(:) A21(:) A22(:)], where each column has length m*n, 

 then A = [A11 A12;A21 A22] where each Aij is m-by-n.

The following example demonstrates that the last sentence is incorrect:

A11 = [1; 2; 3; 4];

A12 = [5; 6; 7; 8];

A21 = [9; 10; 11; 12];

A22 = [13; 14; 15; 16];

B = [A11 A12 A21 A22];

A = col2im(B,[2 2],[4 4],'distinct')

The resulting "A" is:

 A =

      1     3     9    11

      2     4    10    12

      5     7    13    15

      6     8    14    16

which corresponds to A = [A11 A21;A12 A22] instead of A = [A11 A12;A21 A22].

Answer 1

[MathWorks Support Team]

This change has been incorporated into the documentation in Release 14 Service Pack 3 (R14SP3). For previous releases, read below for any additional information:

This has been verified as an error within the documentation for the COL2IM function in the Image Processing Toolbox 3.2 (R13). The documentation should read as follows:

 A = col2im(B,[m n],[mm nn],'distinct') rearranges each column of B into a distinct m-by-n block to create the matrix A of size mm-by-nn.  If B = [A11(:) A21(:) A12(:) A22(:)], where each column has length m*n, then A = [A11 A12;A21 A22] where each Aij is m-by-n.