npstreams.istd

npstreams.istd(arrays, axis=-1, ddof=0, weights=None, ignore_nan=False)

Streaming standard deviation of arrays. Weights are also supported. This is equivalent to calling numpy.std(axis = 2) on a stack of images.

Parameters
  • arrays (iterable of ndarrays) – Arrays to be combined. This iterable can also a generator.

  • axis (int, optional) – Reduction axis. Default is to combine the arrays in the stream as if they had been stacked along a new axis, then compute the standard deviation along this new axis. If None, arrays are flattened. If axis is an int larger that the number of dimensions in the arrays of the stream, standard deviation is computed along the new axis.

  • ddof (int, optional) – Means Delta Degrees of Freedom. The divisor used in calculations is N - ddof, where N represents the number of elements.

  • weights (iterable of ndarray, iterable of floats, or None, optional) – Iterable of weights associated with the values in each item of arrays. Each value in an element of arrays contributes to the standard deviation according to its associated weight. The weights array can either be a float or an array of the same shape as any element of arrays. If weights=None, then all data in each element of arrays are assumed to have a weight equal to one.

  • ignore_nan (bool, optional) – If True, NaNs are set to zero weight. Default is propagation of NaNs.

Yields

std (~numpy.ndarray) – Standard deviation

See also

std

total standard deviation.

numpy.std

standard deviation calculation of dense arrays. Weights are not supported.