Accelerating the pace of engineering and science

# Documentation Center

• Trials
• Product Updates

# power, .^

Element-wise power

## Description

example

C = A.^B raises each element of A to the corresponding power in B.

C = power(A,B) is an alternate way to execute A.^B, but is rarely used. It enables operator overloading for classes.

## Examples

expand all

### Square Each Element of Vector

Create a vector, A, and square each element.

A = 1:5;
C = A.^2
C =

1     4     9    16    25

### Find Inverse of Each Matrix Element

Create a matrix, A, and take the inverse of each element.

A = [1 2 3; 4 5 6; 7 8 9];
C = A.^-1
C =

1.0000    0.5000    0.3333
0.2500    0.2000    0.1667
0.1429    0.1250    0.1111

An inversion of the elements is not equal to the inverse of the matrix, which is instead written A^-1 or inv(A).

### Find Roots of Number

Calculate the roots of -1 to the 1/3 power.

A = -1;
B = 1/3;
C = A.^B
C =

0.5000 + 0.8660i

For negative base A and noninteger B, if abs(B) is less than 1, the power function returns the complex roots of A.

Use the nthroot function to obtain the real roots.

C = nthroot(A,3)
C =

-1

## Input Arguments

expand all

### A — Basescalar | vector | matrix | multidimensional array

Base, specified as a scalar, vector, matrix, or multidimensional array. Inputs A and B must be the same size unless one is a scalar. A scalar value expands into an array of the same size as the other input.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char
Complex Number Support: Yes

### B — Exponentscalar | vector | matrix | multidimensional array

Exponent, specified as a scalar, vector, matrix, or multidimensional array. Inputs A and B must be the same size unless one is a scalar. A scalar value expands into an array of the same size as the other input.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char
Complex Number Support: Yes

## See Also

Was this topic helpful?