-
Notifications
You must be signed in to change notification settings - Fork 104
/
shmultiply.3
86 lines (86 loc) · 3.28 KB
/
shmultiply.3
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
.\" Automatically generated by Pandoc 3.1.3
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "shmultiply" "1" "2021-02-15" "Fortran 95" "SHTOOLS 4.11"
.hy
.SH SHMultiply
.PP
Multiply two functions and determine the spherical harmonic coefficients
of the resulting function.
.SH Usage
.PP
call SHMultiply (\f[V]cilmout\f[R], \f[V]cilm1\f[R], \f[V]lmax1\f[R],
\f[V]cilm2\f[R], \f[V]lmax2\f[R], \f[V]precomp\f[R], \f[V]norm\f[R],
\f[V]csphase\f[R], \f[V]exitstatus\f[R])
.SH Parameters
.TP
\f[V]cilmout\f[R] : output, real(dp), dimension (2, \f[V]lmax1\f[R]+\f[V]lmax2\f[R]+1, \f[V]lmax1\f[R]+\f[V]lmax2\f[R]+1)
The real spherical harmonic coefficients corresponding to the
multiplication of \f[V]cilm1\f[R] and \f[V]cilm2\f[R] in the space
domain.
.TP
\f[V]cilm1\f[R] : input, real(dp), dimension (2, \f[V]lmax1\f[R]+1, \f[V]lmax1\f[R]+1)
The spherical harmonic coefficients of the first function.
.TP
\f[V]lmax1\f[R] : input, integer(int32)
The maximum spherical harmonic degree used in evaluting \f[V]cilm1\f[R].
.TP
\f[V]cilm2\f[R] : input, real(dp), dimension (2, \f[V]lmax2\f[R]+1, \f[V]lmax2\f[R]+1)
The spherical harmonic coefficients of the second function.
.TP
\f[V]lmax2\f[R] : input, integer(int32)
The maximum spherical harmonic degree used in evaluting \f[V]cilm2\f[R].
.TP
\f[V]precomp\f[R] : input, optional, integer(int32), default = 0
If 1, the array of Legendre functions \f[V]plx\f[R] will be precomputed
on the Gauss-Legendre quadrature nodes.
.TP
\f[V]norm\f[R] : input, optional, integer(int32), default = 1
1 (default) = Geodesy 4-pi normalized harmonics; 2 = Schmidt
semi-normalized harmonics; 3 = unnormalized harmonics; 4 = orthonormal
harmonics.
.TP
\f[V]csphase\f[R] : input, optional, integer(int32), default = 1
1 (default) = do not apply the Condon-Shortley phase factor to the
associated Legendre functions; -1 = append the Condon-Shortley phase
factor of (-1)\[ha]m to the associated Legendre functions.
.TP
\f[V]exitstatus\f[R] : output, optional, integer(int32)
If present, instead of executing a STOP when an error is encountered,
the variable exitstatus will be returned describing the error.
0 = No errors; 1 = Improper dimensions of input array; 2 = Improper
bounds for input variable; 3 = Error allocating memory; 4 = File IO
error.
.SH Description
.PP
\f[V]SHMultiply\f[R] will take two sets of spherical harmonic
coefficients, multiply the functions in the space domain, and expand the
resulting field in spherical harmonics using \f[V]SHExpandGLQ\f[R].
The spherical harmonic bandwidth of the resulting field is
\f[V]lmax1+lmax2\f[R], where \f[V]lmax1\f[R] and \f[V]lmax2\f[R] are the
bandwidths of the input fields.
If the optional parameter \f[V]precomp\f[R] is set, then the array of
Legendre functions \f[V]plx\f[R] will be precomputed on the
Gauss-Legendre quadrature nodes.
.PP
The employed spherical harmonic normalization and Condon-Shortley phase
convention can be set by the optional arguments \f[V]norm\f[R] and
\f[V]csphase\f[R]; if not set, the default is to use geodesy 4-pi
normalized harmonics that exclude the Condon-Shortley phase of
(-1)\[ha]m.
.SH See also
.PP
shexpandglq, makegridglq, shglq