numpy.broadcast_to

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

广播一个数组到一个新的形状.

参数:

arrayarray_like

要广播的数组.

shapetuple 或 int

所需数组的形状.单个整数 i 被解释为 (i,).

subok布尔值, 可选

如果为真,则子类将被传递,否则返回的数组将被强制为基类数组（默认）.

返回:

broadcast数组

给定形状的原始数组的只读视图.它通常是不连续的.此外,广播数组的多个元素可能引用同一个内存位置.

引发:

ValueError

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

参见

broadcast

broadcast_arrays

broadcast_shapes

备注

在 1.10.0 版本加入.

示例

>>> 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]])