minus

R2026b

Laurent polynomial or Laurent matrix subtraction

Syntax

Q = minus(A,B)

Q = A - B

Description

Q = minus(A,B) subtracts B from A, where A and B are a pair of Laurent polynomials or Laurent matrices.

Note

The laurentPolynomial and laurentMatrix objects have their own versions of minus. The input data type determines which version is executed.

Q = A - B is equivalent to Q = minus(A,B).

Examples

Laurent Polynomial Subtraction

Create two Laurent polynomials:

• $$a(z)=2z$$

• $$b(z)=8z^3+4z^2+2z+1$$

a = laurentPolynomial(Coefficients=[2],MaxOrder=1);
b = laurentPolynomial(Coefficients=[8 4 2 1],MaxOrder=3);

Subtract $$a(z)$$ from $$b(z)$$.

c = minus(b,a)

c = 
  laurentPolynomial with properties:

    Coefficients: [8 4 0 1]
        MaxOrder: 3

Subtract $$a^3(z)+a^2(z)$$ from $$b(z)$$.

d = b-(mpower(a,3)+mpower(a,2))

d = 
  laurentPolynomial with properties:

    Coefficients: [2 1]
        MaxOrder: 1

Laurent Matrix Subtraction

Create the Laurent polynomials:

• $$a(z)=5z^2+8z+3$$

• $$b(z)=8z+3+2z^{-1}$$

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

Create the Laurent matrices:

• lmatA = $\left[\begin{array}{cc}a\left(z\right)& 2\\ 4& 6\end{array}\right]$

• lmatB = $\left[\begin{array}{cc}b\left(z\right)& 1\\ 3& 5\end{array}\right]$

lmatA = laurentMatrix(Elements={lpA,2;4,6});
lmatB = laurentMatrix(Elements={lpB,1;3,5});

Subtract lmatB from lmatA.

lmatC = lmatA-lmatB;
lmatC.Elements{1,1}

ans = 
  laurentPolynomial with properties:

    Coefficients: [5 0 0 -2]
        MaxOrder: 2

lmatC.Elements{1,2}

ans = 
  laurentPolynomial with properties:

    Coefficients: 1
        MaxOrder: 0

lmatC.Elements{2,1}

ans = 
  laurentPolynomial with properties:

    Coefficients: 1
        MaxOrder: 0

lmatC.Elements{2,2}

ans = 
  laurentPolynomial with properties:

    Coefficients: 1
        MaxOrder: 0

Input Arguments

A — Laurent polynomial or Laurent matrix

laurentPolynomial object | laurentMatrix object

Laurent polynomial or Laurent matrix, specified as a laurentPolynomial object or a laurentMatrix object, respectively.

B — Laurent polynomial or Laurent matrix

laurentPolynomial object | laurentMatrix object

Laurent polynomial or Laurent matrix, specified as a laurentPolynomial object or a laurentMatrix object, respectively.

Output Arguments

Q — Difference

laurentPolynomial object

Difference of two Laurent polynomials or two Laurent matrices, returned as a laurentPolynomial object or a laurentMatrix object.

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

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

Thread-Based Environment

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

The minus function 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 minus in thread-based environments. For more information, see Run MATLAB Functions in Thread-Based Environment.