/
makegridpointc.doc
44 lines (40 loc) · 1.94 KB
/
makegridpointc.doc
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
Evaluate a complex function expressed in complex spherical harmonics at a set of
points.
Usage
-----
value = MakeGridPointC (cilm, lat, lon, [lmax, norm, csphase, dealloc])
Returns
-------
value : complex, ndarray
Value of the function at (lat, lon).
Parameters
----------
cilm : complex, dimension (2, lmaxin+1, lmaxin+1)
The complex spherical harmonic coefficients of the function. The
coefficients C0lm and C1lm refer to the positive and negative angular
orders, respectively, with Clm=cilm[0,1,m] and Cl-m=cilm[1,l,m].
lat : float, array_like
The latitude of the point in degrees.
lon : float, array_like
The longitude of the point in degrees.
lmax : integer, array_like, optional, default = lmaxin
The maximum spherical harmonic degree used in evaluating the function.
norm : integer, array_like, optional, default = 1
1 (default) = Geodesy 4-pi normalized harmonics; 2 = Schmidt semi-normalized
harmonics; 3 = unnormalized harmonics; 4 = orthonormal harmonics.
csphase : integer, array_like, optional, 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)^m to the associated Legendre functions.
dealloc : integer, array_like, optional, default = 0
0 (default) = Save variables used in the external Legendre function calls.
(1) Deallocate this memory at the end of the funcion call.
Description
-----------
MakeGridPointC will expand a complex function expressed in complex spherical
harmonics at a set of points. The input latitudes and longitudes are in degrees,
and the maximum degree used in evaluating the function is the smaller of lmaxin
and lmax. The employed spherical harmonic normalization and Condon-Shortley
phase convention can be set by the optional arguments norm and csphase; if not
set, the default is to use geodesy 4-pi normalized harmonics that exclude the
Condon-Shortley phase of (-1)^m.