mpower, ^

Fixed-point matrix power (^)

Syntax

Y = A^k

Y = mpower(A,k)

Description

Y = A^k computes A to the k power for fi inputs and returns the result in Y.

The matrix power operation is performed using default fimath settings.

The fixed-point output array Y has the same local fimath as the input A. If A has no local fimath, the output Y also has no local fimath.

Y = mpower(A,k) is an alternate way to execute A^k.

Examples

Square a Matrix

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 

px0 = 
     1     0
     0     1

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Unsigned
            WordLength: 1
        FractionLength: 0

px1 = x^1 

px1 = 
     0     1
     2     4

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 32
        FractionLength: 28

px2 = x^2

px2 = 
     2     4
     8    18

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 65
        FractionLength: 56

px3 = x^3

px3 = 
     8    18
    36    80

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 98
        FractionLength: 84

Input Arguments

A — Base

scalar | matrix

Base, specified as a scalar or matrix.

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

Data Types: fi
Complex Number Support: Yes

k — Exponent

positive real-valued integer

Exponent, specified as a real-valued integer.

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

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.

Version History

Introduced in R2010a