mxnet.np.power

power(x1, x2, out=None, **kwargs)

First array elements raised to powers from second array, element-wise.

Parameters

  • x1 (ndarray or scalar) – The bases.

  • x2 (ndarray or scalar) – The exponent.

  • out (ndarray) – A location into which the result is stored. If provided, it must have a shape that the inputs broadcast to. If not provided or None, a freshly-allocated array is returned.

Returns

out – The bases in x1 raised to the exponents in x2. This is a scalar if both x1 and x2 are scalars.

Return type

ndarray or scalar

Examples

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

Raise the bases to different exponents.

>>> x2 = np.array([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.]])