numpy.broadcast_to

numpy.broadcast_to(array, shape, subok=False)

Функция numpy.broadcast_to() транслирует массив по указанной форме.

Параметры:
array - подобный массиву объект
Любые объекты которые могут быть преобразованы в массивы NumPy.
shape - целое число, список или кортеж целых чисел
Задает размеры необходимого массива.
subok - False или True (необязательный)
Если этот параметр установлен в True, то подкласс объекта сохраняется. В противном случае (False по умолчанию) массив будет объектом базового класса.
Возвращает:
ndarray - массив NumPy
Транслированный по указанной форме массив, который является представлением для исходного массива.
Смотрите так же: broadcast_arrays, broadcast

Замечание

Если массив несовместим с указанной формой в соответствии с правилами транслирования NumPy то это приведет к ошибке ValueError. Так же следует помнить, что несколько элементов транслированного массива могут относиться к одной и той же ячейке памяти.

Примеры

>>> import numpy as np
>>> 
>>> a = np.array([0, 1, 2, 3])
>>> 
>>> np.broadcast_to(a, (4, 4))
array([[0, 1, 2, 3],
       [0, 1, 2, 3],
       [0, 1, 2, 3],
       [0, 1, 2, 3]])
>>>
>>> np.broadcast_to(a, (1, 1, 4))
array([[[0, 1, 2, 3]]])
>>>
>>> np.broadcast_to(a, (4, 1, 4))
array([[[0, 1, 2, 3]],

       [[0, 1, 2, 3]],

       [[0, 1, 2, 3]],

       [[0, 1, 2, 3]]])
>>> np.broadcast_to(a, (1, 4, 1))    #  Привведет к ошибке