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]])