numpy.broadcast_to

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

將陣列廣播到新形狀。

參數:

arrayarray_like

要廣播的陣列。

shapetuple 或 int

所需陣列的形狀。單一整數 i 解釋為 (i,)。

subokbool，可選

若為 True，則子類別將會被傳遞，否則回傳的陣列將強制為基底類別陣列（預設）。

回傳:

broadcastarray

具有給定形狀之原始陣列的唯讀視圖。它通常不是連續的。此外，廣播陣列的多個元素可能指向單一記憶體位置。

引發:

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