Difference between revisions of "Dcm2euler.m"

From Spinach Documentation Wiki
Jump to: navigation, search
(Sync syntax/arguments/outputs with current Spinach source)
(Restore pre-bulk-edit wiki content)
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==
  
[arg1,arg2,arg3]=dcm2euler(dcm)
+
                [alpha,beta,gamma]=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:48, 5 April 2026

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

Syntax

               [alpha,beta,gamma]=dcm2euler(dcm)

                              OR

                     angles=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

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