def isub(arrays, axis = -1, dtype = None):
"""
Subtract elements in a reduction fashion. Equivalent to ``numpy.subtract.reduce`` on a dense array.
Parameters
----------
arrays : iterable
Arrays to be multiplied.
axis : int, optional
Reduction axis. Since subtraction is not reorderable (unlike a sum, for example),
`axis` must be specified as an int; full reduction (``axis = None``) will raise an exception.
Default is to subtract the arrays in the stream as if they had been stacked along a new axis,
then subtract along this new axis. If None, arrays are flattened before subtraction.
If `axis` is an int larger that the number of dimensions in the arrays of the stream,
arrays are subtracted along the new axis.
dtype : numpy.dtype, optional
The type of the yielded array and of the accumulator in which the elements
are combined. The dtype of a is used by default unless a has an integer dtype
of less precision than the default platform integer. In that case, if a is
signed then the platform integer is used while if a is unsigned then an
unsigned integer of the same precision as the platform integer is used.
Yields
------
online_sub : ndarray
Raises
------
ValueError
If `axis` is None. Since subtraction is not reorderable (unlike a sum, for example),
`axis` must be specified as an int.
"""
if axis is None:
raise ValueError('Subtraction is not a reorderable operation, and \
therefore a specific axis must be give.')
yield from ireduce_ufunc(arrays, ufunc = np.subtract, axis = axis, dtype = dtype)
评论列表
文章目录
