### Navigation

- index
- modules |
- next |
- previous |
- NumPy v1.3 Manual (DRAFT) »
- NumPy Reference »
- Routines »
- Mathematical functions »

# numpy.subtract

`numpy.``subtract`(x1, x2[, out])

  Subtract arguments element-wise.

  Parameters: | x1, x2 : array_like The arrays to be subtracted from each other. If type is ‘array_like’ the x1 and x2 shapes must be identical.
  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.]])

### Navigation

- index
- modules |
- next |
- previous |
- NumPy v1.3 Manual (DRAFT) »
- NumPy Reference »
- Routines »
- Mathematical functions »