Rodrigues to Quaternions

R2026b

Convert Euler-Rodrigues vector to quaternion

• 

Rodrigues to Quaternions block

To add a block to a model, double-click the canvas and start typing the block name. Then, select the block from the list.

Libraries:
Aerospace Blockset / Utilities / Axes Transformations

Description

The Rodrigues to Quaternions block determines the 4-by-1 quaternion from a three-element Euler-Rodrigues vector. Aerospace Blockset™ uses quaternions that are defined using the scalar-first convention. The Euler-Rodrigues vector input and the resulting quaternion represent a right-hand passive transformation from frame A to frame B. The resulting quaternion represents a series of right-hand intrinsic passive rotations from frame A to frame B. For more information on Euler-Rodrigues vectors, see Algorithms.

Ports

Input

rod — Euler-Rodrigues vector

three-element vector

Euler-Rodrigues vector from which to determine the quaternion.

Data Types: double

Output

q — Quaternion

4-by-1 matrix

Quaternion determined from the Euler-Rodrigues vector.

Data Types: double

Programmatic Use: Add Block

To add the block programmatically, use the add_block function with one of these library block paths as the source.

"aerolibtransform2/Rodrigues to Quaternions"

Example: add_block("aerolibtransform2/Rodrigues to Quaternions","myModel/myBlock",MakeNameUnique="on")

Algorithms

A Euler-Rodrigues vector $$\stackrel{\rightharpoonup }{b}$$ represents a rotation by integrating a direction cosine of a rotation axis with the tangent of half the rotation angle as follows:

$$\overrightarrow{b}=\left[\begin{array}{ccc}{b}_x& b_y& b_z\end{array}\right]$$

where:

$$\begin{array}{l}{b}_x=\tan \left(\frac{1}{2}\theta \right)s_x,\\ b_y=\tan \left(\frac{1}{2}\theta \right)s_y,\\ b_z=\tan \left(\frac{1}{2}\theta \right)s_z\end{array}$$

are the Rodrigues parameters. Vector $$\stackrel{\rightharpoonup }{s}$$ represents a unit vector around which the rotation is performed. Due to the tangent, the rotation vector is indeterminate when the rotation angle equals ±pi radians or ±180 deg. Values can be negative or positive.

References

[1] Dai, J.S. "Euler-Rodrigues formula variations, quaternion conjugation and intrinsic connections." Mechanism and Machine Theory, 92, 144-152. Elsevier, 2015.

Extended Capabilities

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

Version History

Introduced in R2017a