dpss {multitaper}R Documentation

Compute Discrete Prolate Spheroidal Sequences

Description

Compute Discrete Prolate Spheroidal (Slepian) Sequences for use as tapers or other applications. This function uses the tridiagonal method and exploits symmetry. Note the odd order tapers are normalized so that the slope at the centre is positive in accordance with Slepian (1978) and Thomson (1982). This differs from Percival and Walden (1993). This code follows section (8.3) of Percival and Walden (1993) using LAPACK function calls Anderson (1999).

Usage

dpss(n,k,nw, returnEigenvalues=TRUE)

Arguments

n

A positive integer, typically the non-zero-padded length of the time series.

k

A positive integer, the number of tapers, often 2*nw for spectrum estimation purposes.

nw

A positive double-precision number, the time-bandwidth parameter.

returnEigenvalues

If true the appropriate eigenvalues are calculated and returned using the function dpssToEigenvalues. If FALSE, the eigenvalues returned are from the LAPACK function DSTEBZ using the tridiagonal. See section 8.3 of Percival and Walden (1993), or equation (13) in Slepian (1978).

Value

v

A n by k matrix of Slepian Sequences. Each column represents the Slepian sequence of order k-1.

eigen

A length k vector of eigenvalues corresponding to equation (13) in Slepian (1978), or the eigenvalues of the input tridiagonal matrix returned from the internal call to the LAPACK function DSTEBZ.

References

Anderson, E. (1999). LAPACK Users' guide (Vol. 9). Siam.

Percival, D.B. and Walden, A.T. (1993) Spectral analysis for physical applications. Cambridge University Press.

Slepian, D. (1978) Prolate spheroidal wave functions, Fourier analysis, and uncertainty. V–The discrete case. Bell System Technical Journal Volume 57, pp. 1371–1430

Thomson, D.J (1982) Spectrum estimation and harmonic analysis. Proceedings of the IEEE Volume 70, number 9, pp. 1055–1096.

Examples

dpss(10,4,4.0)
dpss(100,8,5.0)

[Package multitaper version 1.0-17 Index]