Invert for the global power spectrum given a multitaper spectrum estimate formed with spherical cap localization windows.
Usage
call SHMTDebias (mtdebias
, mtspectra
, lmax
, tapers
, lwin
, k
, nl
, lmid
, n
, taper_wt
, exitstatus
)
Parameters
mtdebias
: output, real(dp), dimension (2, ceiling((lmax
+1)/nl
))- The global power spectrum (column 1) and uncertainty (column 2). The midpoints of the N spherical harmonic bins are given in
lmid
. mtspectra
: input, real(dp), dimension (2,lmax
+1)- The localized multitaper spectrum estimate and uncertainty, obtained from a routine such as
SHMultitaperCSE
orSHMultitaperSE
. lmax
: input, integer(int32)- The spherical harmonic bandwidth of the localized multitaper spectrum estimates.
tapers
: input, real(dp), dimension (lmaxt
+1,k
)- An array of the K windowing functions, arranged in columns, obtained from a call to
SHReturnTapers
. lwin
: input, integer(int32)- The spherical harmonic bandwidth of the windowing functions in the array
tapers
. k
: input, integer(int32)- The number of tapers utilized in the multitaper spectral analysis.
nl
: input, integer(int32)- The global power spectrum is assumed to be constant within bins of spherical harmonic wdith
nl
. In addition, the global power spectrum will be assumed to be constant beyondlmax
. lmid
: output, real(dp), dimension ((lmax
+1)/nl
+1)- The midpoints of the spherical harmonic bins for which the global power spectrum is constant.
n
: output, integer(int32)- The number of bins used in
mtdebias
andlmid
. taper_wt
: input, optional, real(dp), dimension (k
)- The weights used in calculating the multitaper spectral estimates. Optimal values of the weights (for a known global power spectrum) can be obtained from the routine
SHMTVarOpt
. exitstatus
: 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.
Description
SHMTDebias
will invert for the global power spectrum given a localized multitaper spectrum estimate formed from spherical cap localization windows. This linear inverse problem is inherently underdetermined, and in order to achive a unique solution it is assumed that the global spectrum is constant in bins of width nl
, and that the global power spectrum is constant for degrees greater than lmax
. In practice nl
should be increased until the global power spectrum is everywhere positive (negative values would be unphysical) and the variances are reasonable. Further details can be found in Wieczorek and Simons (2007).
This set of linear equations is solved using the method of singular value decomposition as outlined in Press et al. (1992, pp. 670-672). Each value of the multitaper spectrum estimate mtspectra(1,:)
, as well as the corresponding rows of the transformation matrix, is divided by the uncertainties of the estimate mtspectra(2,:)
. The solution and uncertainty are given by eqs 15.4.17 and 15.4.19 of Press et al. (1992, p. 671), respectively.
If taper_wt
is not specified, the weights will all be assumed to be equal to 1/K
.
References
Press, W.H., S.A. Teukolsky, W.T. Vetterling, and B.P. Flannery, Numerical Recipes in FORTRAN: The Art of Scientific Computing, 2nd ed., Cambridge Univ. Press, Cambridge, UK, 1992.
Wieczorek, M. A. and F. J. Simons, Minimum-variance multitaper spectral estimation on the sphere, J. Fourier Anal. Appl., 13, 665-692, doi:10.1007/s00041-006-6904-1, 2007.
See also
shmultitaperse, shmultitapercse, shreturntapers, shmtvaropt, shmtcouplingmatrix
Edit me