laurentMatrix

R2026b

Create Laurent matrix

Description

Use the laurentMatrix object to create a matrix with laurentPolynomial elements. You can perform mathematical operations on the matrices.

Creation

Syntax

lmat = laurentMatrix

lmat = laurentMatrix(Elements=entries)

Description

lmat = laurentMatrix creates a Laurent matrix that is a 2-by-2 identity matrix.

lmat = laurentMatrix(Elements=entries) creates a Laurent matrix with elements specified by the value of the Elements property.

Properties

Elements — Laurent matrix elements

2-by-2 identity matrix (default) | cell array

Laurent matrix elements, specified as a cell array that has at most two rows and two columns. You can specify an element as a real-valued scalar or laurentPolynomial object. laurentMatrix converts all real-valued scalars into laurentPolynomial objects internally.

Example: lmat = laurentMatrix(Elements={2,4;lpA,lpB}) creates a 2-by-2 Laurent matrix, where lpA and lpB are both laurentPolynomial objects.

Object Functions

Specific to laurentMatrix

ctranspose	Laurent matrix transpose
det	Laurent matrix determinant
dispMat	Display Laurent matrix
inverse	Laurent matrix inverse

Common to laurentMatrix and laurentPolynomial

dyaddown	Dyadic downsampling of Laurent polynomial or Laurent matrix
dyadup	Dyadic upsampling of Laurent polynomial or Laurent matrix
eq	Laurent polynomials or Laurent matrices equality test
plus	Laurent polynomial or Laurent matrix addition
minus	Laurent polynomial or Laurent matrix subtraction
mtimes	Laurent polynomial or Laurent matrix multiplication
reflect	Laurent polynomial or Laurent matrix reflection
uminus	Unary minus for Laurent polynomial or Laurent matrix

Examples

Create Laurent Matrix

Create two Laurent polynomials:

• $$a(z)=2+4z^{-1}+6z^{-2}$$

• $$b(z)=z^2+3z+5$$

lpA = laurentPolynomial(Coefficients=[2 4 6]);
lpB = laurentPolynomial(Coefficients=[1 3 5],MaxOrder=2);

Create the Laurent matrix $\left[\begin{array}{cc}-1& a\left(z\right)\\ b\left(z\right)& 7\end{array}\right].$

lmat = laurentMatrix(Elements={-1 lpA; lpB 7});

Display the elements of the matrix.

for j=1:2
    for k=1:2
        fprintf("===================\nlmat(%d,%d):\n",j,k);
        element = lmat.Elements{j,k}
    end
end

===================
lmat(1,1):

element = 
  laurentPolynomial with properties:

    Coefficients: -1
        MaxOrder: 0

===================
lmat(1,2):

element = 
  laurentPolynomial with properties:

    Coefficients: [2 4 6]
        MaxOrder: 0

===================
lmat(2,1):

element = 
  laurentPolynomial with properties:

    Coefficients: [1 3 5]
        MaxOrder: 2

===================
lmat(2,2):

element = 
  laurentPolynomial with properties:

    Coefficients: 7
        MaxOrder: 0

Extended Capabilities

C/C++ Code Generation

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

Usage notes and limitations:

• The dispMat object function is not supported.

GPU Code Generation

Generate CUDA® code for NVIDIA® GPUs using GPU Coder™.

Refer to the usage notes and limitations in the C/C++ Code Generation section. The same usage notes and limitations apply to GPU code generation.

Thread-Based Environment

Run code in the background using MATLAB® backgroundPool or accelerate code with Parallel Computing Toolbox™ ThreadPool.

The laurentMatrix object fully supports thread-based environments. For more information, see Run MATLAB Functions in Thread-Based Environment.

Version History

Introduced in R2021b

R2026b: Use thread-based environments

You can use laurentMatrix in thread-based environments. For more information, see Run MATLAB Functions in Thread-Based Environment.