pyshtools uses by default 4π-normalized spherical harmonic functions that exclude the Condon-Shortley phase factor. Schmidt semi-normalized, orthonormalized, and unnormalized harmonics can be employed in most routines by specifying optional parameters.

Definitions: Real 4π-normalized harmonics

Any real square-integrable function can be expressed as a series of spherical harmonic functions

f(θ,ϕ)=l=0lm=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 m0ˉ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)(lm)!(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(μ21)l.

The normalized associated Legendre functions are orthogonal for a given value of m,

11ˉPlm(μ)ˉPlm(μ)=2(2δ0m)δll,

and the spherical harmonic functions are orthogonal for all degrees l and orders m

ΩYlm(θ,ϕ)Ylm(θ,ϕ)dΩ=4πδllδmm, where dΩ is the differential surface area on the unit sphere, sinθdθdϕ. By multiplying equation (1) by Ylm 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)=lm=lf2lm.

Similarly, the cross power of two functions f and g is given by 14πΩf(θ,ϕ)g(θ,ϕ)dΩ=l=0Sfg(l), with

Sfg(l)=lm=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-normalized
  • normalization = 'unnorm': Unnormalized
  • normalization = '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)(lm)!(l+m)!Plm(μ)
11ˉPlm(μ)ˉPlm(μ)=2(2δ0m)δll
ΩYlm(θ,ϕ)Ylm(θ,ϕ)dΩ=4πδllδmm
Sfg(l)=lm=lflmglm

Schmidt semi-normalized

ˉPlm(μ)=(2δm0)(lm)!(l+m)!Plm(μ)
11ˉPlm(μ)ˉPlm(μ)=2(2δ0m)(2l+1)δll
ΩYlm(θ,ϕ)Ylm(θ,ϕ)dΩ=4π(2l+1)δllδmm
Sfg(l)=1(2l+1)lm=lflmglm

Orthonormalized

ˉPlm(μ)=(2δ0m)(2l+1)4π(lm)!(l+m)!Plm(μ)
11ˉPlm(μ)ˉPlm(μ)=(2δ0m)2πδll
ΩYlm(θ,ϕ)Ylm(θ,ϕ)dΩ=δllδmm
Sfg(l)=14πlm=lflmglm

Unnormalized

ˉPlm(μ)=Plm(μ)
11ˉPlm(μ)ˉPlm(μ)=2(2l+1)(l+m)!(lm)!δll
ΩYlm(θ,ϕ)Ylm(θ,ϕ)dΩ=4π(l+m)!(2δ0m)(2l+1)(lm)!δllδmm
Sfg(l)=lm=l(l+m)!(2δ0m)(2l+1)(lm)!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.

Edit me