Definitions: Real 4π-normalized harmonics
Any real square-integrable function can be expressed as a series of spherical harmonic functions
f(θ,ϕ)=∞∑l=0l∑m=−lflmYlm(θ,ϕ),
where flm is the spherical harmonic coefficient, Ylm is the corresponding spherical harmonic function, θ is co-latitude, ϕ is longitude, and l and m are the spherical harmonic degree and order, respectively. The real spherical harmonics are defined as
Ylm(θ,ϕ)={ˉPlm(cosθ)cosmϕif m≥0ˉPl|m|(cosθ)sin|m|ϕif m<0,where the normalized associated Legendre functions for use with the 4π-normalized spherical harmonic functions are given by
ˉPlm(μ)=√(2−δm0)(2l+1)(l−m)!(l+m)!Plm(μ)and where δij is the Kronecker delta function. The unnormalized associated Legendre functions are derived from the standard Legendre polynomials using the relations Plm(μ)=(1−μ2)m/2dmdμmPl(μ) and
Pl(μ)=12ll!dldμl(μ2−1)l.
The normalized associated Legendre functions are orthogonal for a given value of m,
∫1−1ˉPlm(μ)ˉPl′m(μ)=2(2−δ0m)δll′,and the spherical harmonic functions are orthogonal for all degrees l and orders m
∫ΩYlm(θ,ϕ)Yl′m′(θ,ϕ)dΩ=4πδll′δmm′, where dΩ is the differential surface area on the unit sphere, sinθdθdϕ. By multiplying equation (1) by Yl′m′ and integrating over all space, it is straightforward to show that the spherical harmonic coefficients of a function can be calculated by the integral flm=14π∫Ωf(θ,ϕ)Ylm(θ,ϕ)dΩ.
Power spectrum
Parseval’s theorem in Cartesian geometry relates the integral of a function squared to the sum of the squares of the function’s Fourier coefficients. This relation is easily extended to spherical geometry using the orthogonality properties of the spherical harmonic functions. Defining power to be the integral of the function squared divided by the area it spans, the total power of a function is equal to a sum over its power spectrum 14π∫Ωf2(θ,ϕ)dΩ=∞∑l=0Sff(l), where the power spectrum S is related to the spherical harmonic coefficients by
Sff(l)=l∑m=−lf2lm.Similarly, the cross power of two functions f and g is given by 14π∫Ωf(θ,ϕ)g(θ,ϕ)dΩ=∞∑l=0Sfg(l), with
Sfg(l)=l∑m=−lflmglm.The power spectrum is unmodified by a rotation of the coordinate system. Furthermore, the numerical values of the power spectrum are independent of the normalization convention used for the spherical harmonic functions (though the mathematical formulae will be different, as given below). If the functions f and g have a zero mean, Sff and Sfg represent the contribution to the variance and covariance, respectively, as a function of degree l.
S is the total power of the function at spherical harmonic degree l, which in pyshtools is called the power per degree l. Alternatively, one can calculate the average power per coefficient at spherical harmonic degree l, which in pyshtools is referred to as the power per lm. Since there are (2l+1) spherical harmonic coefficients at degree l, this is power per lm=S(l)(2l+1). One can also calculate the power from all angular orders over an infinitesimal logarithmic spherical harmonic degree band dlogal, where a is the logarithmic base. In pyshtools, this is referred to as the power per dlogal, which is given by power per dlogal=S(l)llna. Finally, pyshtools defines the energy of a function as the integral of its square. The energy spectrum is thus equal to the power spectrum multiplied by 4π.
Condon-Shortley phase factor
The above definitions of the Legendre functions and spherical harmonic functions do not include the Condon-Shortley phase factor of (−1)m that is often employed in the physics and seismology communities [Varshalovich et al. 1988, Dahlen and Tromp 1998]. Nevertheless, this phase can be included in most pyshtools routines by specifying the optional parameter
csphase=0
: exclude the Condon-Shortley phase factor (default)csphase=1
: append the Condon-Shortley phase factor to the Legendre functions.
The choice of the Condon-Shortley phase factor does not affect the numerical value of the power spectrum.
Supported normalizations
pyshtools supports the use of 4π-normalized, Schmidt semi-normalized, orthonormalized, and unnormalized spherical harmonic functions. To specify which normalization should be used, it is only necessary to specify the optional parameter normalization
in the Python routines:
normalization = '4pi'
: 4π normalized (default, unless stated otherwise)normalization = 'schmidt'
: Schmidt semi-normalizednormalization = 'unnorm'
: Unnormalizednormalization = 'ortho'
: Orthonormalized.
Each of these normalizations has slightly different definitions for the normalized Legendre functions, the orthogonality conditions of the Legendre functions and spherical harmonic functions, and the power spectrum. These equations are provided below.
4π normalized
ˉPlm(μ)=√(2−δm0)(2l+1)(l−m)!(l+m)!Plm(μ) |
∫1−1ˉPlm(μ)ˉPl′m(μ)=2(2−δ0m)δll′ |
∫ΩYlm(θ,ϕ)Yl′m′(θ,ϕ)dΩ=4πδll′δmm′ |
Sfg(l)=l∑m=−lflmglm |
Schmidt semi-normalized
ˉPlm(μ)=√(2−δm0)(l−m)!(l+m)!Plm(μ) |
∫1−1ˉPlm(μ)ˉPl′m(μ)=2(2−δ0m)(2l+1)δll′ |
∫ΩYlm(θ,ϕ)Yl′m′(θ,ϕ)dΩ=4π(2l+1)δll′δmm′ |
Sfg(l)=1(2l+1)l∑m=−lflmglm |
Orthonormalized
ˉPlm(μ)=√(2−δ0m)(2l+1)4π(l−m)!(l+m)!Plm(μ) |
∫1−1ˉPlm(μ)ˉPl′m(μ)=(2−δ0m)2πδll′ |
∫ΩYlm(θ,ϕ)Yl′m′(θ,ϕ)dΩ=δll′δmm′ |
Sfg(l)=14πl∑m=−lflmglm |
Unnormalized
ˉPlm(μ)=Plm(μ) |
∫1−1ˉPlm(μ)ˉPl′m(μ)=2(2l+1)(l+m)!(l−m)!δll′ |
∫ΩYlm(θ,ϕ)Yl′m′(θ,ϕ)dΩ=4π(l+m)!(2−δ0m)(2l+1)(l−m)!δll′δmm′ |
Sfg(l)=l∑m=−l(l+m)!(2−δ0m)(2l+1)(l−m)!flmglm |
References
-
Dahlen, F. A. and J. Tromp, “Theoretical Global Seismology,” Princeton University Press, Princeton, New Jersey, 1025 pp., 1998.
-
Varshalovich, D. A., A. N. Moskalev, and V. K. Khersonskii, “Quantum theory of angular momentum,” World Scientific, Singapore, 1988.