11.1.6.8.4.1. numpy.broadcast

class numpy.broadcast

Produce an object that mimics broadcasting.

Parameters:

in1, in2, ... : array_like

Input parameters.

Returns:

b : broadcast object

Broadcast the input parameters against one another, and return an object that encapsulates the result. Amongst others, it has shape and nd properties, and may be used as an iterator.

Examples

Manually adding two vectors, using broadcasting:

>>> x = np.array([[1], [2], [3]])
>>> y = np.array([4, 5, 6])
>>> b = np.broadcast(x, y)
>>> out = np.empty(b.shape)
>>> out.flat = [u+v for (u,v) in b]
>>> out
array([[ 5.,  6.,  7.],
       [ 6.,  7.,  8.],
       [ 7.,  8.,  9.]])

Compare against built-in broadcasting:

>>> x + y
array([[5, 6, 7],
       [6, 7, 8],
       [7, 8, 9]])
__init__()

x.__init__(...) initializes x; see help(type(x)) for signature

Methods

reset() Reset the broadcasted result’s iterator(s).

Attributes

index current index in broadcasted result
iters tuple of iterators along self‘s “components.”
nd Number of dimensions of broadcasted result.
next
numiter Number of iterators possessed by the broadcasted result.
shape Shape of broadcasted result.
size Total size of broadcasted result.