numpy.broadcast_to
- numpy. broadcast_to ( array, shape, subok=False ) [source]
-
Broadcast an array to a new shape.
- Parameters
-
- array array_like
-
The array to broadcast.
- shape tuple or int
-
The shape of the desired array. A single integer
i
is interpreted as(i,)
. - subok bool, optional
-
If True, then sub-classes will be passed-through, otherwise the returned array will be forced to be a base-class array (default).
- Returns
-
- broadcast array
-
A readonly view on the original array with the given shape. It is typically not contiguous. Furthermore, more than one element of a broadcasted array may refer to a single memory location.
- Raises
-
- ValueError
-
If the array is not compatible with the new shape according to NumPy’s broadcasting rules.
See also
Notes
New in version 1.10.0.
Examples
>>> x = np.array([1, 2, 3]) >>> np.broadcast_to(x, (3, 3)) array([[1, 2, 3], [1, 2, 3], [1, 2, 3]])
© 2005–2021 NumPy Developers
Licensed under the 3-clause BSD License.
https://numpy.org/doc/1.22/reference/generated/numpy.broadcast_to.html