Função Python NumPy numpy.concatenate()

  2. Api
  3. Funções do Python Numpy
  4. Função Python NumPy numpy.concatenate()
Minahil Noor 30 janeiro 2023
NumPy
  1. Sintaxe da função numpy.concatenate()
  2. Códigos de exemplo: numpy.concatenate()
  3. Códigos de exemplo: numpy.concatenate() para passar um array multidimensional
  4. Códigos de exemplo: numpy.concatenate() para passar um array multi-dimensional com o parâmetro axis
Função Python NumPy numpy.concatenate()

A função Python NumPy numpy.concatenate() concatena múltiplas arrays sobre um eixo especificado. Aceita uma sequência de arrays como parâmetro e junta-os num único array.

Sintaxe da função numpy.concatenate()

numpy.concatenate((a1, a2, ...), axis=0, out=None)

Parâmetros
a1, a2,... É uma sequência de uma estrutura tipo arraial. É a sequência de arrays de entrada a concatenar. As arrays de entrada devem ter a mesma forma.
axis É um inteiro. Representa o eixo sobre o qual a função irá concatenar as arrays. O seu valor por defeito é zero, o que significa que a concatenação das arrays será feita em fila. Se for 1, a concatenação será em função da coluna.
out É um array N-dimensional. Mostra a forma final das arrays concatenadas. Se for fornecida, a sua forma deve corresponder à matriz concatenada de saída.

Devolver

Devolve um array N-dimensional. Esta matriz mostra a concatenação das array de entrada.

Códigos de exemplo: numpy.concatenate()

Iremos concatenar um array unidimensional utilizando primeiro a função numpy.concatenate.

import numpy as np

a1 = np.array([45, 12, 65, 78, 9, 34, 12, 11, 2, 65, 78, 82, 28, 78])
print("First array:")
print(a1)
a2 = np.array([89, 34, 56, 87, 90])
print("Second array:")
print(a2)
outarray = np.concatenate([a1, a2])
print("Concatenated array:")
print(outarray)

Resultado:

First array:
[45 12 65 78  9 34 12 11  2 65 78 82 28 78]
Second array:
[89 34 56 87 90]
Concatenated array:
[45 12 65 78  9 34 12 11  2 65 78 82 28 78 89 34 56 87 90]

A função retornou um array concatenada. Se quiser que a matriz de saída comece com a segundo array, basta passar a segundo array primeiro como um parâmetro.

Códigos de exemplo: numpy.concatenate() para passar um array multidimensional

Vamos agora passar um array multidimensional.

import numpy as np

a1 = np.array([[11, 12], [15, 10]])
print("First array:")
print(a1)
a2 = np.array([[10, 13], [15, 8]])
print("Second array:")
print(a2)
a3 = np.array([[11, 5], [34, 78]])
print("Third array:")
print(a3)
outarray = np.concatenate((a1, a2, a3))
print("Concatenated array:")
print(outarray)

Resultado:

First array:
[[11 12]
 [15 10]]
Second array:
[[10 13]
 [15  8]]
Third array:
[[11  5]
 [34 78]]
Concatenated array:
[[11 12]
 [15 10]
 [10 13]
 [15  8]
 [11  5]
 [34 78]]

A saída mostra que as arrays de entrada estão agora unidas para formar um array única.

Códigos de exemplo: numpy.concatenate() para passar um array multi-dimensional com o parâmetro axis

Agora, vamos passar uma sequência de arrays multidimensionais como parâmetro com axis como 0. A matriz resultante mostrará a concatenação em termos de linhas.

import numpy as np

a1 = np.array([[11, 12, 5], [15, 6, 10]])
print("First array:")
print(a1)
a2 = np.array([[10, 8, 13], [12, 15, 8]])
print("Second array:")
print(a2)
a3 = np.array([[11, 12, 5], [34, 78, 90]])
print("Third array:")
print(a3)
outarray = np.concatenate((a1, a2, a3))
print("Concatenated array:")
print(outarray)

Resultado:

First array:
[[11 12  5]
 [15  6 10]]
Second array:
[[10  8 13]
 [12 15  8]]
Third array:
[[11 12  5]
 [34 78 90]]
Concatenated array:
[[11 12  5]
 [15  6 10]
 [10  8 13]
 [12 15  8]
 [11 12  5]
 [34 78 90]]

Note-se que a matriz de saída mostra a concatenação de arrays de uma forma crescente em filas, uma vez que o valor padrão para o axis é 0.

Agora vamos definir o valor de axis como sendo 1.

import numpy as np

a1 = np.array([[11, 12, 5], [15, 6, 10]])
print("First array:")
print(a1)
a2 = np.array([[10, 8, 13], [12, 15, 8]])
print("Second array:")
print(a2)
a3 = np.array([[11, 12, 5], [34, 78, 90]])
print("Third array:")
print(a3)
outarray = np.concatenate((a1, a2, a3), axis=1)
print("Concatenated array:")
print(outarray)

Resultado:

First array:
[[11 12  5]
 [15  6 10]]
Second array:
[[10  8 13]
 [12 15  8]]
Third array:
[[11 12  5]
 [34 78 90]]
Concatenated array:
[[11 12  5 10  8 13 11 12  5]
 [15  6 10 12 15  8 34 78 90]]

O output array mostra a concatenação de arrays de uma forma crescente de colunas.