# getscalar3D#

## Purpose#

Gets a scalar from a 3-dimensional array.

## Format#

y = getscalar3D(a, i1, i2, i3)#
Parameters:
• a (3-dimensional array) – Data

• i1 (scalar) – index into the slowest moving dimension of the array.

• i2 (scalar) – index into the second slowest moving dimension of the array.

• i3 (scalar) – index into the fastest moving dimension of the array.

Returns:

y (scalar) – the element of the array indicated by the indices.

## Examples#

// Create a column vector 1, 2, 3,...24
a = seqa(1, 1, 24);

// Reshape the column vector into a 2x3x4 dimensional array
a = areshape(a, 2|3|4);

y = getscalar3D(a, 1, 3, 2);


A 2x3x4 dimensional array can be thought of as two 3x4 dimensional matrices. The call to getScalar3D() above, returns the $$[3,2]$$ element of the first of these matrices. The value of which is:

y = 10


## Remarks#

getscalar3D() returns the scalar that is located in the $$[i1, i2, i3]$$ position of array a.

A call to getscalar3D() is faster than using the more general getmatrix() function to get a scalar from a 3-dimensional array.