npstreams.isub

npstreams.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.