# gather

Collect tall array into memory after executing queued operations

## Description

executes all queued operations required to calculate unevaluated tall array
`Y`

= gather(`X`

)`X`

and collects the results into memory as
`Y`

.

MATLAB^{®} can run out of memory if the result of the `gather`

calculation is too large. If you are unsure whether the result can fit in memory,
use `gather(head(X))`

or `gather(tail(X))`

to
perform the full calculation, but bring only a small portion of the result into
memory.

Use `gather`

sparingly to ensure that extra passes through the
data are combined during the calculations whenever possible. For more information,
see Deferred Evaluation of Tall Arrays.

## Examples

## Input Arguments

## Output Arguments

## Tips

Functions that return multiple output arguments must use variables to provide all of the outputs to

`gather`

. For example,[a,b] = bounds(X); [a,b] = gather(a,b);

If you have Parallel Computing Toolbox™, see

`gather`

(Parallel Computing Toolbox) for information about gathering`distributed`

and`gpuArray`

computations.

## Extended Capabilities

## Version History

**Introduced in R2016b**