Difference between revisions of "Spsk2mat.m"

From Spinach Documentation Wiki
Jump to: navigation, search
m (Correct function page syntax from current Spinach source)
(Update function See also links and function index membership)
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{DISPLAYTITLE:spsk2mat.m}}
+
{{DISPLAYTITLE:spsk2mat.m}} __NOTOC__
Converts span and skew representation of a 3x3 interaction tensor into the corresponding matrix.
+
Converts the isotropic part, span, skew, and Euler angles of a 3x3 interaction tensor, in the Herzfeld-Berger convention, into the corresponding matrix; although this representation is still common in the literature, reporting the original matrix is usually clearer.
  
 
==Syntax==
 
==Syntax==
Line 7: Line 7:
 
     M=spsk2mat(iso,sp,sk,alp,bet,gam)
 
     M=spsk2mat(iso,sp,sk,alp,bet,gam)
  
==Description==
+
==Parameters==
Isotropic part, span, and skew are often seen in the literature. It is not a good way of reporting an interaction tensor (the original matrix is best), but it is still being used.
 
 
 
==Arguments==
 
  
 
         iso  - isotropic part of the interaction, defined as
 
         iso  - isotropic part of the interaction, defined as
Line 35: Line 32:
  
 
==See also==
 
==See also==
[[eeqq2nqi.m]], [[castep2nqi.m]], [[euler2dcm.m]], [[xyz2dd.m]], [[axrh2mat.m]]
+
[[eeqq2nqi.m]], [[castep2nqi.m]], [[euler2dcm.m]], [[xyz2dd.m]], [[axrh2mat.m]], [[anas2mat.m]], [[ang2cgsppm.m]], [[cgsppm2ang.m]], [[conmat.m]], [[dictum.m]], [[dihedral.m]], [[frac2cart.m]], [[g2freq.m]], [[gauss2mhz.m]], [[ham2nqi.m]], [[hartree2joule.m]], [[hz2icm.m]], [[hz2ppm.m]], [[ias2mat.m]], [[mat2axrh.m]], [[mat2ias.m]], [[mhz2gauss.m]], [[mt2hz.m]], [[offsetof.m]], [[ppm2hz.m]], [[tsm2param.m]], [[zfs2mat.m]], [[Kernel_utilities]]
  
 
''Version 2.1, authors: [[Ilya Kuprov]]''
 
''Version 2.1, authors: [[Ilya Kuprov]]''

Latest revision as of 19:41, 6 June 2026

Converts the isotropic part, span, skew, and Euler angles of a 3x3 interaction tensor, in the Herzfeld-Berger convention, into the corresponding matrix; although this representation is still common in the literature, reporting the original matrix is usually clearer.

Syntax

    M=spsk2mat(iso,sp,sk,alp,bet,gam)

Parameters

       iso  - isotropic part of the interaction, defined as
              (xx+yy+zz)/3 in terms of eigenvaues

        sp  - interaction span, defined as the difference 
              between the largest and the smallest eigenvalue

        sk  - interaction skew, defined as 3*(yy-iso)/sp
              where yy is the middle eigenvalue

       alp  - alpha Euler angle in radians

       bet  - beta Euler angle in radians

       gam  - gamma Euler angle in radians

Outputs

    M  - 3x3 matrix

Notes

The reverse transformation (from matrix into span, skew, and angles) is ill-defined.

See also

eeqq2nqi.m, castep2nqi.m, euler2dcm.m, xyz2dd.m, axrh2mat.m, anas2mat.m, ang2cgsppm.m, cgsppm2ang.m, conmat.m, dictum.m, dihedral.m, frac2cart.m, g2freq.m, gauss2mhz.m, ham2nqi.m, hartree2joule.m, hz2icm.m, hz2ppm.m, ias2mat.m, mat2axrh.m, mat2ias.m, mhz2gauss.m, mt2hz.m, offsetof.m, ppm2hz.m, tsm2param.m, zfs2mat.m, Kernel_utilities

Version 2.1, authors: Ilya Kuprov