{ } Raw JSON

bundles / numpy 2.4.4 / numpy / append

_ArrayFunctionDispatcher

numpy:append

source: /numpy/lib/_function_base_impl.py :5577

Signature

def   append ( arr values axis = None )

Summary

Append values to the end of an array.

Parameters

arr : array_like

Values are appended to a copy of this array.

values : array_like

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

axis : int, optional

The axis along which values are appended. If axis is not given, both arr and values are flattened before use.

Returns

append : ndarray

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

Examples

import numpy as np
np.append([1, 2, 3], [[4, 5, 6], [7, 8, 9]])
When `axis` is specified, `values` must have the correct shape.
np.append([[1, 2, 3], [4, 5, 6]], [[7, 8, 9]], axis=0)
np.append([[1, 2, 3], [4, 5, 6]], [7, 8, 9], axis=0)
a = np.array([1, 2], dtype=int)
c = np.append(a, [])
c
c.dtype
Default dtype for empty ndarrays is `float64` thus making the output of dtype `float64` when appended with dtype `int64`

See also

delete

Delete elements from an array.

insert

Insert elements into an array.

Aliases

  • numpy.append