numpy.broadcast_to#

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

将数组广播到新形状.

参数:
arrayarray_like

要广播的数组.

shape元组或整数

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

subokbool, 可选

如果为 True,则将传递子类;否则,返回的数组将被强制为基类数组(默认).

返回:
broadcastarray

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

提出:
ValueError

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

示例

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