summaryrefslogtreecommitdiff
path: root/gsl-1.9/doc/specfunc-coupling.texi
blob: 3efd9fe0bd1b2f6dd3a3a9372a45e1c468e83838 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
@cindex coupling coefficients
@cindex 3-j symbols
@cindex 6-j symbols
@cindex 9-j symbols
@cindex Wigner coefficients
@cindex Racah coefficients

The Wigner 3-j, 6-j and 9-j symbols give the coupling coefficients for
combined angular momentum vectors.  Since the arguments of the standard
coupling coefficient functions are integer or half-integer, the
arguments of the following functions are, by convention, integers equal
to twice the actual spin value.  For information on the 3-j coefficients
see Abramowitz & Stegun, Section 27.9.  The functions described in this
section are declared in the header file @file{gsl_sf_coupling.h}.

@menu
* 3-j Symbols::                 
* 6-j Symbols::                 
* 9-j Symbols::                 
@end menu

@node 3-j Symbols
@subsection 3-j Symbols

@deftypefun double gsl_sf_coupling_3j (int @var{two_ja}, int @var{two_jb}, int @var{two_jc}, int @var{two_ma}, int @var{two_mb}, int @var{two_mc})
@deftypefunx int gsl_sf_coupling_3j_e (int @var{two_ja}, int @var{two_jb}, int @var{two_jc}, int @var{two_ma}, int @var{two_mb}, int @var{two_mc}, gsl_sf_result * @var{result})
These routines compute the Wigner 3-j coefficient, 
@tex
\beforedisplay
$$
\pmatrix{ja & jb & jc\cr
         ma & mb & mc\cr}
$$
\afterdisplay
@end tex
@ifinfo

@example
(ja jb jc
 ma mb mc)
@end example

@end ifinfo
@noindent
where the arguments are given in half-integer units, @math{ja} =
@var{two_ja}/2, @math{ma} = @var{two_ma}/2, etc.
@comment Exceptional Return Values: GSL_EDOM, GSL_EOVRFLW
@end deftypefun


@node 6-j Symbols
@subsection 6-j Symbols

@deftypefun double gsl_sf_coupling_6j (int @var{two_ja}, int @var{two_jb}, int @var{two_jc}, int @var{two_jd}, int @var{two_je}, int @var{two_jf})
@deftypefunx int gsl_sf_coupling_6j_e (int @var{two_ja}, int @var{two_jb}, int @var{two_jc}, int @var{two_jd}, int @var{two_je}, int @var{two_jf}, gsl_sf_result * @var{result}) 
These routines compute the Wigner 6-j coefficient, 
@tex
\beforedisplay
$$
\left\{\matrix{ja & jb & jc\cr
               jd & je & jf\cr}\right\}
$$
\afterdisplay
@end tex
@ifinfo

@example
@{ja jb jc
 jd je jf@}
@end example

@end ifinfo
@noindent
where the arguments are given in half-integer units, @math{ja} =
@var{two_ja}/2, @math{ma} = @var{two_ma}/2, etc.
@comment Exceptional Return Values: GSL_EDOM, GSL_EOVRFLW
@end deftypefun


@node 9-j Symbols
@subsection 9-j Symbols

@deftypefun double gsl_sf_coupling_9j (int @var{two_ja}, int @var{two_jb}, int @var{two_jc}, int @var{two_jd}, int @var{two_je}, int @var{two_jf}, int @var{two_jg}, int @var{two_jh}, int @var{two_ji})
@deftypefunx int gsl_sf_coupling_9j_e (int @var{two_ja}, int @var{two_jb}, int @var{two_jc}, int @var{two_jd}, int @var{two_je}, int @var{two_jf}, int @var{two_jg}, int @var{two_jh}, int @var{two_ji}, gsl_sf_result * @var{result}) 
These routines compute the Wigner 9-j coefficient, 
@tex
\beforedisplay
$$
\left\{\matrix{ja & jb & jc\cr
               jd & je & jf\cr
               jg & jh & ji\cr}\right\}
$$
\afterdisplay
@end tex
@ifinfo

@example
@{ja jb jc
 jd je jf
 jg jh ji@}
@end example

@end ifinfo
@noindent
where the arguments are given in half-integer units, @math{ja} =
@var{two_ja}/2, @math{ma} = @var{two_ma}/2, etc.
@comment Exceptional Return Values: GSL_EDOM, GSL_EOVRFLW
@end deftypefun