# mat2cell2

## PURPOSE

Break matrix up into a cell array of same sized matrices.

## SYNOPSIS

function C = mat2cell2( X, parts )

## DESCRIPTION

     Break matrix up into a cell array of same sized matrices.

     Useful wrapper for matlab function mat2cell.  Instead of specifying
     locations along each dimension at which to split the matrix, this
     function takes the number of parts along each dimension to break X into.
     That is if X is d1xd2x...xdk and parts=[p1 p2 ... pk]; then X is split
     into p1*p2*...*pk matricies of dimension d1/p1 x d2/p2 x ... x dk/pk. If
     di/pi is not an integer, floor(di/pi) is used.  Leftover chunks of X are
     discarded. Using a scalar p for parts is equivalent to using [p p ... p].

     So for example if X is 10*16, mat2cell2( X, [2 3] ) breaks X into 2*3
     parts, each of size 5x5, and the last column of X is discarded.

     USAGE
      C = mat2cell2( X, parts )

     INPUTS
      X       - matrix to split
      parts   - see above

     OUTPUTS
      C       - cell array adjacent submatrices of X

     EXAMPLE
      A=rand(6,10); B = mat2cell2(A,[3 3]),

     See also MAT2CELL, CELL2ARRAY, CELL2MAT

     Piotr's Image&Video Toolbox      Version 2.0
     Copyright 2008 Piotr Dollar.  [pdollar-at-caltech.edu]
     Please email me if you find bugs, or have suggestions or questions!
     Licensed under the Lesser GPL [see external/lgpl.txt]

## CROSS-REFERENCE INFORMATION

This function calls:

- arrayCrop Used to crop a rectangular region from an n dimensional array.
- checkNumArgs Helper utility for checking numeric vector arguments.

This function is called by:

- montage2 Used to display collections of images and videos.