uminus

R2026b

Unary minus for Laurent polynomial or Laurent matrix

Syntax

Q = uminus(P)

Q = -P

Description

Q = uminus(P) negates the Laurent polynomial or the Laurent matrix specified by P. If P is a Laurent matrix, uminus negates the matrix elements.

Note

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

Q = -P is equivalent to Q = uminus(P).

Examples

Unary Minus of Laurent Polynomial

Create a Laurent polynomial

a = laurentPolynomial(Coefficients=[-2 6 -7 -2 1],MaxOrder=3);

Confirm the sum of $$a(z)$$ and its unary minus is 0.

au = uminus(a);
a+au

ans = 
  laurentPolynomial with properties:

    Coefficients: 0
        MaxOrder: 0

Unary Negative of Laurent Matrix

Create the Laurent polynomials

• $$a(z)=z+1$$

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

• $$c(z)=z$$

• $$d(z)=z^2+z^{-1}$$

lpA = laurentPolynomial(Coefficients=[1 1],MaxOrder=1);
lpB = laurentPolynomial(Coefficients=[1 1 0 1],MaxOrder=2);
lpC = laurentPolynomial(Coefficients=[1],MaxOrder=1);
lpD = laurentPolynomial(Coefficients=[1 0 0 1],MaxOrder=2);

Create the matrix lmat = $\left[\begin{array}{cc}a\left(z\right)& b\left(z\right)\\ c\left(z\right)& d\left(z\right)\end{array}\right]$.

lmat = laurentMatrix(Elements={lpA,lpB;lpC,lpD});

Confirm the sum of lmat and its unary negative is 0.

lmatu = uminus(lmat);
xmat = lmat+lmatu;
dispMat(xmat)

| 0.00e+00   0.00e+00 |
|                     | 
| 0.00e+00   0.00e+00 |

Input Arguments

P — 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 — Negated Laurent polynomial or Laurent matrix

laurentPolynomial object | laurentMatrix object

Negated Laurent polynomial or Laurent matrix, returned as a laurentPolynomial object or a laurentMatrix object. If P is a Laurent polynomial, the coefficients are negated.

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