Previous topic

numpy.ma.concatenate

Next topic

numpy.ma.dstack

numpy.ma.append

numpy.ma.append(a, b, axis=None)[source]

Append values to the end of an array.

New in version 1.9.0.

Parameters:

a : array_like

Values are appended to a copy of this array.

b : array_like

These values are appended to a copy of a. It must be of the correct shape (the same shape as a, excluding axis). If axis is not specified, b can be any shape and will be flattened before use.

axis : int, optional

The axis along which v are appended. If axis is not given, both a and b are flattened before use.

Returns:

append : MaskedArray

A copy of a with b appended to axis. Note that append does not occur in-place: a new array is allocated and filled. If axis is None, the result is a flattened array.

See also

numpy.append
Equivalent function in the top-level NumPy module.

Examples

>>> import numpy.ma as ma
>>> a = ma.masked_values([1, 2, 3], 2)
>>> b = ma.masked_values([[4, 5, 6], [7, 8, 9]], 7)
>>> print(ma.append(a, b))
[1 -- 3 4 5 6 -- 8 9]