numpy.broadcast_to#

numpy.broadcast_to(array, shape, subok=False)[源代码]#

将数组广播到新形状。

参数:

arrayarray_like: 要广播的数组。
shape元组或整数: 所需数组的形状。单个整数 i 被解释为 (i,)。
subokbool, optional: 如果为 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]])