ind2sub linear index to matrix subscript values

## Syntax

    [i1,i2,..] =ind2sub(dims,I)
                Mi = ind2sub(dims,I)

## Arguments

dims

  vector: the matrix dimensions

I

  vector: the given linear index

i1,i2,..

  the subscript values (same matrix shape as `I`)

Mi

  matrix whose columns contains the subscript values.

## Description

`ind2sub` is used to determine the equivalent subscript values corresponding to a given single index into an array. `[i1,i2,..] = ind2sub(dims,I)` returns the arrays `i1`, `i2`, ... containing the equivalent row, column, ... subscripts corresponding to the index matrix `I` for a matrix of size `dims`. `Mi=ind2sub(dims,I)` returns a matrix `Mi` whose columns are the arrays `i1(:)`, `i2(:)`, ...

## Examples

    ind2sub([2,3,2],1:12)
    [i,j,k]=ind2sub([2,3,2],1:12)

## See also

- sub2ind
- extraction
- insertion