numpy.broadcast_to

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

将数组广播到新形状。

参数
arrayarray_like

要广播的数组。

shape元组

所需数组的形状。

subok可选的布尔

如果为true,则将通过子类,否则返回的数组将强制为基类数组(默认)。

返回
broadcast数组

具有给定形状的原始数组的只读视图。它通常不相邻。此外,广播数组的多个元素可以引用单个内存位置。

加薪
ValueError

如果根据numpy的广播规则,数组与新形状不兼容。

笔记

1.10.0 新版功能.

实例

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