### Navigation

- index
- modules |
- next |
- previous |
- SciPy v0.7 Reference Guide (DRAFT) »
- Image Array Manipulation and Convolution (`scipy.stsci`) »

# scipy.stsci.image.minimum

`scipy.stsci.image.``minimum`(arrays, output=None, outtype=None, nlow=0, nhigh=0, badmasks=None)

  minimum() nominally computes the minimum 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 minimum
    on the low end of the pixel stack.
  nhigh specifies the number of pixels to be excluded from minimum
    on the high end of the pixel stack.
  badmasks specifies boolean arrays corresponding to ‘arrays’, where true
    indicates that a particular pixel is not to be included in the minimum calculation.

      >>> a = np.arange(4)
      >>> a = a.reshape((2,2))
      >>> arrays = [a*16, a*4, a*2, a*8]
      >>> minimum(arrays)
      array([[0, 2],
             [4, 6]])
      >>> minimum(arrays, nhigh=1)
      array([[0, 2],
             [4, 6]])
      >>> minimum(arrays, nlow=1)
      array([[ 0,  4],
             [ 8, 12]])
      >>> minimum(arrays, outtype=np.float32)
      array([[ 0.,  2.],
             [ 4.,  6.]], dtype=float32)
      >>> bm = np.zeros((4,2,2), dtype=np.bool8)
      >>> bm[2,...] = 1
      >>> minimum(arrays, badmasks=bm)
      array([[ 0,  4],
             [ 8, 12]])
      >>> minimum(arrays, badmasks=threshhold(arrays, low=10))
      array([[ 0, 16],
             [16, 12]])

### Navigation

- index
- modules |
- next |
- previous |
- SciPy v0.7 Reference Guide (DRAFT) »
- Image Array Manipulation and Convolution (`scipy.stsci`) »