SignalProcessing
LSSpectrum
compute the Lomb-Scargle power spectrum of irregularly spaced data
Calling Sequence
Parameters
Options
Description
Examples
References
Compatibility
LSSpectrum(t, f, options)
t
-
rtable ; the time
f
rtable ; the signal
outputdata : posint : specify the number of the output data points
errors : rtable or realcons
precise : truefalse : indicates the methods to use
minimumfrequency : float : indicates minimum frequency
maximumfrequency : float : indicates maximum frequency
normalization : identical('standard', 'model', 'log', 'psd') ; indicates the type of normalization
oversamplingfactor : numeric : indicates the oversampling factor
nyquistfactor : numeric : indicates the multiple of the average Nyquist frequency
centerdata : truefalse : indicates whether the data needs to subtract the weighted mean
generalized : truefalse : indicates the methods to use for the Lomb Scargle Fast Approximation
The LSSpectrum(t, f) command computes the frequencies and power spectrum based on provided time and signal using Lomb Scargle Periodogram Method, and returns the result in an Array of datatype float[8].
f and t can only be Vectors or one-dimensional Arrays.
There are two ways to compute the Lomb Scargle Periodogram: one can compute the exact values, or an approximation. Computing the approximation is generally much faster. If the precise option is set to true, then the actual formula is used for computation, otherwise the fast approximation is used. The default value is false.
The errors option specifies the expected magnitude of the errors, which is used to get the normalized weight for generalized Lomb Scargle periodogram. It can only be a real number or an one-dimensional array. The default value is NULL.
The outputdata option specifies the number of output data points. These output data points correspond to equally spaced frequencies.
The minimumfrequency option specifies the minimum frequency.
The maximumfrequency option specifies the maximum frequency.
If one of maximumfrequency, minimumfrequency and outputdata is specified, then all of them must be provided. If all of them are not provided, then the frequencies used run from 1T⁢oversamplingfactor to nyquistfactor⁢Nf, where T=max⁡t−min⁡t and Nf=n2⁢T where n is the number of elements in t. Output frequencies are equally spaced.
The nyquistfactor option has a default value 1.
The normalization option controls the normalization used on the power and can be one of standard, model, log or psd. The default value is standard. Standard Normalization : Pstandard⁡f=χref2−χ⁡f2χref2. Model Normalization : Pmodel⁡f=χref2−χ⁡f2χ⁡f2. Logarithmic Normalization: Plog⁡f=log⁡χref2χ⁡f2. PSD Normalization : Ppsd⁡f=χref22−χ⁡f22. In all normalization methods, let fi be the measurement in time ti with errors σi, then χ⁡f2=∑i=1n⁡fi−f⁡ti2σi2 where n is the number of elements in f, and χref2 is the non-varying reference model which is the χ⁡f2 for weighted mean.
The oversamplingfactor option specifies the oversampling factor. The default value is 5.
If the centerdata=false option is provided, then the weighted mean will not be subtracted from signal data. The default value is true.
If the generalized=false option is provided, then the generalized Lomb Scargle Periodogram will not be used. The default value is true.
with⁡SignalProcessing:
Generate a time vector
t≔sort⁡LinearAlgebra:-RandomVector⁡200,generator=0..12⁢π,datatype=float8
Generate a signal using frequencies of 1 Hz and 2 Hz:
f1≔1.0:
f2≔2.0:
s≔Vector⁡200,i↦sin⁡2⋅f1⋅π⋅ti+1.5⋅sin⁡2⋅f2⋅π⋅ti,datatype=float8
frequency,power≔LSSpectrum⁡t,s
plot⁡frequency,power
Lomb, Nicholas R. "Least-Squares Frequency Analysis of Unequally Spaced Data." Astrophysics and Space Science. Vol. 39, 1976, pp. 447–462.
Press, William H., and Rybicki, George B. "Fast Algorithm for Spectral Analysis of Unevenly Sampled Data." Astrophysical Journal. Vol. 338, 1989, pp. 277–280.
Zechmeister, M., and Kürster, M. "The generalised Lomb-Scargle periodogram. A new formalism for the floating-mean and Keplerian periodograms." Astronomy & Astrophysics. Vol. 496, 2009, pp. 577-584
The SignalProcessing[LSSpectrum] command was introduced in Maple 2019.
For more information on Maple 2019 changes, see Updates in Maple 2019.
See Also
Download Help Document