Nutzung der Python numpy.append() Funktion

Die Python numpy.append() Funktion wird verwendet, um zwei Arrays zusammenzuführen. Diese Funktion gibt ein neues Array zurück und das ursprüngliche Array bleibt unverändert.

Syntax von numpy.append()

Die Funktionssyntax ist:

numpy.append(arr, values, axis=None)

Das arr kann ein array-ähnliches Objekt oder ein NumPy-Array sein. Die Werte werden an eine Kopie dieses Arrays angehängt.
Die Werte sind array-ähnliche Objekte und werden am Ende der „arr“-Elemente angehängt.
Das axis gibt die Achse an, entlang derer Werte angehängt werden. Wenn das axis nicht angegeben wird, werden beide Arrays abgeflacht.

Beispiele für Python numpy.append()

1. Abflachen von zwei Arrays

import numpy as np

arr1 = np.array([[1, 2], [3, 4]])
arr2 = np.array([[10, 20], [30, 40]])

# no axis provided, array elements will be flattened
arr_flat = np.append(arr1, arr2)

print(arr_flat)  # [ 1  2  3  4 10 20 30 40]

2. Zusammenführen entlang der Achse

import numpy as np

arr_merged = np.append([[1, 2], [3, 4]], [[10, 20], [30, 40]], axis=0)
print(f'Merged 2x2 Arrays along Axis-0:\n{arr_merged}')

arr_merged = np.append([[1, 2], [3, 4]], [[10, 20], [30, 40]], axis=1)
print(f'Merged 2x2 Arrays along Axis-1:\n{arr_merged}')

Output:

Merged 2x2 Arrays along Axis-0:
[[ 1  2]
 [ 3  4]
 [10 20]
 [30 40]]
Merged 2x2 Arrays along Axis-1:
[[ 1  2 10 20]
 [ 3  4 30 40]]

Wenn die 2×2 Arrays entlang der x-Achse zusammengeführt werden, ist die Größe des Ausgabe-Arrays 4×2.
Wenn die 2×2 Arrays entlang der y-Achse zusammengeführt werden, ist die Größe des Ausgabe-Arrays 2×4.

3. Zusammenführen von Arrays unterschiedlicher Form – numpy.append()

Die append()-Funktion löst einen ValueError aus, wenn beide Arrays unterschiedliche Formen haben, ausgenommen die Achse. Verstehen wir dieses Szenario anhand eines einfachen Beispiels.

arr3 = np.append([[1, 2]], [[1, 2, 3], [1, 2, 3]])
print(arr3)

arr3 = np.append([[1, 2]], [[1, 2], [3, 4]], axis=0)
print(arr3)

Im ersten Beispiel werden die Array-Elemente abgeflacht. Selbst wenn sie völlig unterschiedliche Größen haben – 1×2 und 2×3, funktioniert das Anhängen einwandfrei.
Im zweiten Beispiel sind die Array-Formen 1×2 und 2×2. Da wir entlang der 0-Achse anhängen, kann die Form der 0-Achse unterschiedlich sein. Die anderen Formen sollten gleich sein, daher funktioniert dieses Anhängen ebenfalls einwandfrei.

Output:

[1 2 1 2 3 1 2 3]

[[1 2]
 [1 2]
 [3 4]]

Lassen Sie uns ein weiteres Beispiel ansehen, bei dem ein ValueError ausgelöst wird.

import numpy as np

arr3 = np.append([[1, 2]], [[1, 2, 3]], axis=0)
Traceback (most recent call last):
  File "", line 1, in 
  File "/Library/Frameworks/Python.framework/Versions/3.7/lib/python3.7/site-packages/numpy/lib/function_base.py", line 4528, in append
    return concatenate((arr, values), axis=axis)
ValueError: all the input array dimensions except for the concatenation axis must match exactly

Nutzung der Python numpy.append() Funktion