numpy.broadcast_to#

numpy.broadcast_to(array, shape, subok=False)[source]#

将数组广播到新形状。

参数:

array类数组: 要广播的数组。
shape元组或整数: 所需数组的形状。单个整数 i 将被解释为 (i,)。
subok布尔值，可选: 如果为 True，则子类将直接通过；否则，返回的数组将被强制转换为基类数组（默认）。

返回:

broadcast数组: 一个具有给定形状的原始数组的只读视图。它通常不是连续的。此外，广播数组的多个元素可能指向同一个内存位置。

抛出:

ValueError: 如果数组根据 NumPy 的广播规则与新形状不兼容。

另请参阅

broadcast
broadcast_arrays
broadcast_shapes

示例

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