### Navigation

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

# numpy.power

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

  Returns element-wise base array raised to power from second array.

  Raise each base in x1 to the power of the exponents in x2. This requires that x1 and x2 must be broadcastable to the same shape.

  Parameters: | x1 : array_like The bases. x2 : array_like The exponents.
  Returns: | y : ndarray The bases in x1 raised to the exponents in x2.

  Examples

  Cube each element in a list.

      >>> x1 = range(6)
      >>> x1
      [0, 1, 2, 3, 4, 5]
      >>> np.power(x1, 3)
      array([  0,   1,   8,  27,  64, 125])

  Raise the bases to different exponents.

      >>> x2 = [1.0, 2.0, 3.0, 3.0, 2.0, 1.0]
      >>> np.power(x1, x2)
      array([  0.,   1.,   8.,  27.,  16.,   5.])

  The effect of broadcasting.

      >>> x2 = np.array([[1, 2, 3, 3, 2, 1], [1, 2, 3, 3, 2, 1]])
      >>> x2
      array([[1, 2, 3, 3, 2, 1],
             [1, 2, 3, 3, 2, 1]])
      >>> np.power(x1, x2)
      array([[ 0,  1,  8, 27, 16,  5],
             [ 0,  1,  8, 27, 16,  5]])

### Navigation

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