power, .^

Fixed-point element-wise power

Syntax

C = A.^B

C = power(A, B)

Description

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

C = power(A, B) is an alternative way to compute A.^B.

Examples

Raise Each Element of a Matrix to a Scalar Power

Create a fixed-point matrix and raise it to a scalar power.

A = fi([1, 3; 4, 2])

A = 
     1     3
     4     2

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 16
        FractionLength: 12

C = A.^3

C = 
     1    27
    64     8

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 48
        FractionLength: 36

Input Arguments

A — Base

scalar | vector | matrix | multidimensional array

Base, specified as a scalar, vector, matrix, or multidimensional array. Inputs A and B must either be the same size or have sizes that are compatible (for example, A is an M-by-N matrix and B is a scalar or 1-by-N row vector).

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

B — Exponent

scalar

Exponent, specified as a non-negative, real, integer-valued scalar.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | fi

Output Arguments

C — Power

scalar | vector | matrix | multidimensional array

Power, returned as an array with the same dimensions as the input A. When A has a local fimath object, the output C also has the same local fimath object. The array power operation is always performed using the default fimath settings.

Extended Capabilities

C/C++ Code Generation

Generate C and C++ code using MATLAB® Coder™.

Usage notes and limitations:

• When the exponent B is a variable, the ProductMode property of the governing fimath must be SpecifyPrecision.

HDL Code Generation

Generate Verilog and VHDL code for FPGA and ASIC designs using HDL Coder™.

Both inputs must be scalar, and the exponent input, B, must be a constant integer.

Version History

Introduced in R2010a

R2021a: Improved numerical accuracy and generated code efficiency for fi inputs to power, .^

Fixed-Point Designer™ now has improved numerical accuracy for fixed-point inputs to the power function in simulation and generated code. Additionally, generated code is more efficient.