# scipy.stsci.image.average¶

average() nominally computes the average pixel value for a stack of identically shaped images.

arrays specifies a sequence of inputs arrays, which are nominally a
stack of identically shaped images.
output may be used to specify the output array. If none is specified,
either arrays[0] is copied or a new array of type ‘outtype’ is created.
outtype specifies the type of the output array when no ‘output’ is
specified.
nlow specifies the number of pixels to be excluded from average
on the low end of the pixel stack.
nhigh specifies the number of pixels to be excluded from average
on the high end of the pixel stack.
indicates that a particular pixel is not to be included in the average calculation.
```>>> a = np.arange(4)
>>> a = a.reshape((2,2))
>>> arrays = [a*16, a*4, a*2, a*8]
>>> average(arrays)
array([[ 0,  7],
[15, 22]])
>>> average(arrays, nhigh=1)
array([[ 0,  4],
[ 9, 14]])
>>> average(arrays, nlow=1)
array([[ 0,  9],
[18, 28]])
>>> average(arrays, outtype=np.float32)
array([[  0. ,   7.5],
[ 15. ,  22.5]], dtype=float32)
>>> bm = np.zeros((4,2,2), dtype=np.bool8)
>>> bm[2,...] = 1
array([[ 0,  9],
[18, 28]])
array([[ 0,  7],
[ 9, 14]])
```

#### Previous topic

Image Array Manipulation and Convolution (scipy.stsci)

#### Next topic

scipy.stsci.image.combine