numpy.broadcast_to
numpy.broadcast_to(array, shape, subok=False)
Функция 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)) # Привведет к ошибке
