uminus, -

Quaternion unary minus

Since R2023b

Syntax

mQuat = -quat

Description

mQuat = -quat negates the elements of quat and stores the result in mQuat.

Examples

Negate Elements of Quaternion Matrix

Unary minus negates each part of a the quaternion. Create a 2-by-2 matrix, Q.

Q = quaternion(randn(2),randn(2),randn(2),randn(2))

Q = 2×2 quaternion array
      0.53767 +  0.31877i +   3.5784j +   0.7254k      -2.2588 -  0.43359i -   1.3499j +  0.71474k
       1.8339 -   1.3077i +   2.7694j - 0.063055k      0.86217 +  0.34262i +   3.0349j -  0.20497k

Negate the parts of each quaternion in Q.

R = -Q

R = 2×2 quaternion array
     -0.53767 -  0.31877i -   3.5784j -   0.7254k       2.2588 +  0.43359i +   1.3499j -  0.71474k
      -1.8339 +   1.3077i -   2.7694j + 0.063055k     -0.86217 -  0.34262i -   3.0349j +  0.20497k

Input Arguments

quat — Input quaternion

quaternion object | array of quaternion objects

Input quaternion, specified as a quaternion object, an array of quaternion objects of any dimensionality.

Output Arguments

mQuat — Negated quaternion

quaternion object | array of quaternion objects

Negated quaternion, returned as a quaternion object or an array of quaternion objects of the same size as quat.

Extended Capabilities

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

Version History

Introduced in R2023b