#### Previous topic

numpy.power

#### Next topic

numpy.true_divide

# numpy.subtract

`numpy.``subtract`(x1, x2[, out]) = <ufunc 'subtract'>

  Subtract arguments, element-wise.

  Parameters : | x1, x2 : array_like The arrays to be subtracted from each other.
  Returns : | y : ndarray The difference of x1 and x2, element-wise. Returns a scalar if both x1 and x2 are scalars.

  Notes

  Equivalent to `x1 - x2` in terms of array broadcasting.

  Examples

      >>> np.subtract(1.0, 4.0)
      -3.0

      >>> x1 = np.arange(9.0).reshape((3, 3))
      >>> x2 = np.arange(3.0)
      >>> np.subtract(x1, x2)
      array([[ 0.,  0.,  0.],
             [ 3.,  3.,  3.],
             [ 6.,  6.,  6.]])