mpower

Fixed-point matrix power (^)

Syntax

c = mpower(a,k)
c = a^k


Description

c = mpower(a,k) and c = a^k compute matrix power. The exponent k requires a positive, real-valued integer value.

The fixed-point output array c has the same local fimath as the input a. If a has no local fimath, the output c also has no local fimath. The matrix power operation is performed using default fimath settings.

Examples

Compute the power of a 2-dimensional square matrix for exponent values 0, 1, 2, and 3.

x = fi([0 1; 2 4], 1, 32);

px0 = x^0 
px1 = x^1 
px2 = x^2
px3 = x^3

Tips

For more information about the mpower function, see the MATLAB^® mpower reference page.

Extended Capabilities

C/C++ Code Generation

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

Usage notes and limitations:

• When the exponent k is a variable and the input is a scalar, the ProductMode property of the governing fimath must be SpecifyPrecision.

• When the exponent k is a variable and the input is not scalar, the SumMode property of the governing fimath must be SpecifyPrecision.

• Variable-sized inputs are only supported when the SumMode property of the governing fimath is set to SpecifyPrecision or Keep LSB.

• For variable-sized signals, you may see different results between the generated code and MATLAB.

  • In the generated code, the output for variable-sized signals is computed using the SumMode property of the governing fimath.

  • In MATLAB, the output for variable-sized signals is computed using the SumMode property of the governing fimath when the first input, a, is nonscalar. However, when a is a scalar, MATLAB computes the output using the ProductMode of the governing fimath.

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, k, must be a constant integer.