Accelerating the pace of engineering and science

# Documentation Center

• Trial Software

# ndims

Number of array dimensions

## Description

example

N = ndims(A) returns the number of dimensions in the array A. The number of dimensions is always greater than or equal to 2. The function ignores trailing singleton dimensions, for which size(A,dim) = 1.

## Examples

expand all

### Find Dimensions of Vector

Create a row vector.

`A = 1:5;`

Find the number of dimensions in the vector.

```ndims(A)
```
```ans =

2```

The result is 2 because the vector has a size of 1-by-5.

### Find Dimensions of Cell Array

Create a cell array of strings.

```C{1,1,1} = 'cell_1';
C{1,1,2} = 'cell_2';
C{1,1,3} = 'cell_3'```
```C(:,:,1) =

'cell_1'

C(:,:,2) =

'cell_2'

C(:,:,3) =

'cell_3'```

Find the number of dimensions of the cell array.

`ndims(A)`
```ans =

3```

The result is 3 because the cell array has a size of 1-by-1-by-3.

## Input Arguments

expand all

### A — Input arrayscalar | vector | matrix | multidimensional array

Input array, specified as a scalar, vector, matrix, or multidimensional array. This includes numeric arrays, logical arrays, character arrays, categorical arrays, tables, structure arrays, cell arrays, and object arrays.

expand all

### Algorithms

The number of dimensions in an array is the same as the length of the size vector of the array. In other words, ndims(A) = length(size(A)).