Difference between revisions of "Dcm2euler.m"

From Spinach Documentation Wiki
Jump to: navigation, search
(→‎Notes)
(Sync syntax/arguments/outputs with current Spinach source)
Line 1: Line 1:
 
{{DISPLAYTITLE:dcm2euler.m}} __NOTOC__
 
{{DISPLAYTITLE:dcm2euler.m}} __NOTOC__
 +
 
Converts directional cosine matrix into Euler angles, ZYZ active convention (rotating the object rather than the axes).
 
Converts directional cosine matrix into Euler angles, ZYZ active convention (rotating the object rather than the axes).
  
 
==Syntax==
 
==Syntax==
  
−
                [alpha,beta,gamma]=dcm2euler(dcm)
+
[arg1,arg2,arg3]=dcm2euler(dcm)
−
 
−
                              OR
 
−
 
−
                      angles=dcm2euler(dcm)
 
  
 
==Arguments==
 
==Arguments==
  
−
    dcm                - directional cosine matrix
+
dcm                - directional cosine matrix
  
 
==Outputs==
 
==Outputs==
  
−
    alpha, beta, gamma - Euler angles in ZYZ active con-
+
alpha, beta, gamma - Euler angles in ZYZ active con-
 
                           vention, radians
 
                           vention, radians
−
+
 
 
     angles            - a row vector of Euler angles in
 
     angles            - a row vector of Euler angles in
−
                           ZYZ active convention, ordered  
+
                           ZYZ active convention, ordered
 
                           as alpha, beta, gamma, in radians
 
                           as alpha, beta, gamma, in radians
 +
 +
Note: the problem of recovering Euler angles from a DCM is, in
 +
      general, ill-posed. This function is a product of consi-
 +
      derable work, it has passed rigorous testing: it either
 +
      returns a correct answer or gives an informative error.
 +
 +
ilya.kuprov@weizmann.ac.il
  
 
==Notes==
 
==Notes==
 +
 
The problem of recovering Euler angles from a DCM is, in general, ill-posed. This function is a product of considerable work, it has passed rigorous testing: it either returns a correct answer or gives an informative error. See the notes on [[rotation conventions]] for the basic definitions of rotations in ''Spinach''.
 
The problem of recovering Euler angles from a DCM is, in general, ill-posed. This function is a product of considerable work, it has passed rigorous testing: it either returns a correct answer or gives an informative error. See the notes on [[rotation conventions]] for the basic definitions of rotations in ''Spinach''.
  
 
==See also==
 
==See also==
 +
 
[[euler2dcm.m]], [[euler2wigner.m]], [[dcm2wigner.m]]
 
[[euler2dcm.m]], [[euler2wigner.m]], [[dcm2wigner.m]]
  
  
 
''Version 2.3, authors: [[Ilya Kuprov]]''
 
''Version 2.3, authors: [[Ilya Kuprov]]''

Revision as of 15:02, 5 April 2026


Converts directional cosine matrix into Euler angles, ZYZ active convention (rotating the object rather than the axes).

Syntax

[arg1,arg2,arg3]=dcm2euler(dcm)

Arguments

dcm - directional cosine matrix

Outputs

alpha, beta, gamma - Euler angles in ZYZ active con-

                         vention, radians
    angles             - a row vector of Euler angles in
                         ZYZ active convention, ordered
                         as alpha, beta, gamma, in radians
Note: the problem of recovering Euler angles from a DCM is, in
      general, ill-posed. This function is a product of consi-
      derable work, it has passed rigorous testing: it either
      returns a correct answer or gives an informative error.
ilya.kuprov@weizmann.ac.il

Notes

The problem of recovering Euler angles from a DCM is, in general, ill-posed. This function is a product of considerable work, it has passed rigorous testing: it either returns a correct answer or gives an informative error. See the notes on rotation conventions for the basic definitions of rotations in Spinach.

See also

euler2dcm.m, euler2wigner.m, dcm2wigner.m


Version 2.3, authors: Ilya Kuprov