Difference between revisions of "Cg fast.m"

From Spinach Documentation Wiki
Jump to: navigation, search
(Created page with "Fast Clebsch-Gordan coefficient function with limited accuracy. Use clebsch_gordan.m for machine-precision results. Inputs: indices - CG coefficient indices, or...")
 
Line 1: Line 1:
Fast Clebsch-Gordan coefficient function with limited accuracy.
+
{{DISPLAYTITLE:cg_fast.m}} __NOTOC__
Use [[clebsch_gordan.m]] for machine-precision results. Inputs:
+
Clebsch-Gordan coefficient: the coefficient in front of Y(L,M) spherical harmonic in the expansion of the product of Y(L1,M1) and Y(L2,M2) spherical harmonics. In the more general sense, the coefficient refers to the expansion coefficient of |L,M> angular momentum or spin state in the product basis of |L1,M1>|L2,M2> states.
  
      indices  -  CG coefficient indices, ordered
+
==Syntax==
                    as follows: [L M L1 M1 L2 M2]
+
 
                               
+
    cg=clebsch_gordan(L,M,L1,M1,L2,M2)
Log-factorials are used to avoid numerical precision issues; the
+
 
function works reliably to about L=100. If physically inadmissible indices are supplied, a zero is returned.
+
==Arguments==
 +
 
 +
    L,M,L1,M1,L2,M2 - integer or half-integer indices of
 +
                        the angular momentum or spin states
 +
 
 +
==Outputs==
 +
 
 +
    cg              - floating-point (double precision)
 +
                        Clebsch-Gordan coefficient
 +
 
 +
==Notes==
 +
# Only some combinations of L,M,L1,M1,L2,M2 are allowed by the properties of spherical harmonics and spin states. If inadmissible indices are supplied, zero is returned.
 +
# CG coefficient calculation in double-precision arithmetic is not a trivial matter for high ranks. This function produces fast answers with an accuracy of about 1e-3 up to about L=20. A slower machine precision implementation for higher ranks is available in [[clebsch_gordan.m]] function.
 +
 
 +
==See also==
 +
[[clebsch_gordan.m]], [[wigner.m]], [[wigner_3j.m]], [[wigner_6j.m]]
 +
 
 +
 
 +
''Version 2.3, authors: [[Ilya Kuprov]]''

Revision as of 12:35, 27 December 2018

Clebsch-Gordan coefficient: the coefficient in front of Y(L,M) spherical harmonic in the expansion of the product of Y(L1,M1) and Y(L2,M2) spherical harmonics. In the more general sense, the coefficient refers to the expansion coefficient of |L,M> angular momentum or spin state in the product basis of |L1,M1>|L2,M2> states.

Syntax

    cg=clebsch_gordan(L,M,L1,M1,L2,M2)

Arguments

    L,M,L1,M1,L2,M2  - integer or half-integer indices of 
                       the angular momentum or spin states

Outputs

    cg               - floating-point (double precision) 
                       Clebsch-Gordan coefficient

Notes

  1. Only some combinations of L,M,L1,M1,L2,M2 are allowed by the properties of spherical harmonics and spin states. If inadmissible indices are supplied, zero is returned.
  2. CG coefficient calculation in double-precision arithmetic is not a trivial matter for high ranks. This function produces fast answers with an accuracy of about 1e-3 up to about L=20. A slower machine precision implementation for higher ranks is available in clebsch_gordan.m function.

See also

clebsch_gordan.m, wigner.m, wigner_3j.m, wigner_6j.m


Version 2.3, authors: Ilya Kuprov