0
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 1 <h2>Description</h2>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 2 <p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 3 The LTPDA method <a href="matlab:doc('ao/psd')">ao/psd</a> estimates the power spectral density of time-series
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 4 signals, included in the input <tt>ao</tt>s following the Welch's averaged, modified periodogram method <a href="#references">[1]</a>.
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 5 Data are windowed prior to the estimation of the spectrum, by multiplying
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 6 it with a <a href="specwin.html">spectral window object</a>, and can be detrended by a polinomial of time in order to reduce the impact
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 7 of the border discontinuities. The window length is adjustable to shorter lenghts to reduce the spectral
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 8 density uncertainties, and the percentage of subsequent window overlap can be adjusted as well. The detrending is
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 9 performed on the individual windows. The user can choose the quantity being given in output among
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 10 ASD (amplitude spectral density), PSD (power spectral density), AS (amplitude spectrum), and PS (power spectrum).
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 11 <br>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 12 <br>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 13 <h2>Syntax</h2>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 14 </p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 15 <div class="fragment"><pre>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 16 <br> bs = psd(a1, a2, a3, ..., pl)
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 17 bs = psd(as, pl)
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 18 bs = as.psd(pl)
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 19 </pre> </div>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 20 <p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 21 <tt>a1</tt>, <tt>a2</tt>, <tt>a3</tt>, ... are <tt>ao</tt>(s) containing the input time series to be evaluated. <tt>bs</tt> includes
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 22 the output object(s) and <tt>pl</tt> is an optional parameter list.
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 23 </p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 24 <h2>Parameters</h2>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 25 <p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 26 The parameter list <tt>pl</tt> includes the following parameters:
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 27 </p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 28 <ul>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 29 <li> <tt>'Nfft'</tt> - number of samples in each fft [default: length of input data]
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 30 A string value containing the variable 'fs' can
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 31 also be used, e.g., plist('Nfft', '2*fs') </li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 32 <li> <tt>'Win'</tt> - the window to be applied to the data to remove the
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 33 discontinuities at edges of segments. [default: taken from user prefs].<br>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 34 The window is described by a string with its name and, only in the case of Kaiser window,
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 35 the additional parameter <tt>'psll'</tt>. <br>For instance: plist('Win', 'Kaiser', 'psll', 200). </li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 36 </li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 37 <li> <tt>'Olap'</tt> - segment percent overlap [default: -1, (taken from window function)] </li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 38 <li> <tt>'Scale'</tt> - scaling of output. Choose from: <ul>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 39 <li> 'ASD' - amplitude spectral density </li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 40 <li> 'PSD' - power spectral density [default] </li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 41 <li> 'AS' - amplitude spectrum </li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 42 <li> 'PS' - power spectrum </li> </ul> </li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 43 <li> <tt>'Order'</tt> - order of segment detrending <ul>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 44 <li> -1 - no detrending </li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 45 <li> 0 - subtract mean [default] </li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 46 <li> 1 - subtract linear fit </li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 47 <li> N - subtract fit of polynomial, order N </li> </ul> </li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 48 <li><tt>'Navs'</tt> - number of averages. If set, and if Nfft was set to 0 or -1, the number of points for each window will be calculated to match the request. [default: -1, not set] </li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 49 <li><tt>'Times'</tt> - interval of time to evaluate the calculation on. If empty [default], it will take the whole section.</li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 50 </ul>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 51 <p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 52 The length of the window is set by the value of the parameter <tt>'Nfft'</tt>, so that the window
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 53 is actually built using only the key features of the window: the name and, for Kaiser windows, the psll.
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 54 </p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 55 <p>As an alternative to setting the number of points <tt>'Nfft'</tt> in each window, it's possible to ask for a given number of PSD estimates by setting the <tt>'Navs'</tt> parameter, and the algorithm takes care of calculating the correct window length, according to the amount of overlap between subsequent segments.</p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 56 <p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 57 <table cellspacing="0" class="note" summary="Note" cellpadding="5" border="1">
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 58 <tr width="90%">
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 59 <td>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 60 If the user doesn't specify the value of a given parameter, the default value is used.
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 61 </td>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 62 </tr>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 63 </table>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 64 </p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 65 <h2>Algorithm</h2>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 66 <p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 67 The algorithm is based in standard MATLAB's tools, as the ones used by <a href="matlab:doc('pwelch')">pwelch</a>. However, in order to
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 68 compute the standard deviation of the mean for each frequency bin, the averaging of the different segments is performed using Welford's
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 69 algorithm <a href="#references">[2]</a> which allows to compute mean and variance in one loop.
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 70 </p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 71 <h2>Examples</h2>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 72 <p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 73 1. Evaluation of the PSD of a time-series represented by a low frequency sinewave signal, superimposed to
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 74 white noise. Comparison of the effect of windowing on the estimate of the white noise level and
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 75 on resolving the signal.
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 76 </p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 77 <div class="fragment"><pre>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 78 <br> <span class="comment">% create two AOs</span>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 79 x1 = ao(plist(<span class="string">'waveform'</span>,<span class="string">'sine wave'</span>,<span class="string">'f'</span>,0.1,<span class="string">'A'</span>,1,<span class="string">'nsecs'</span>,1000,<span class="string">'fs'</span>,10));
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 80 x2 = ao(plist(<span class="string">'waveform'</span>,<span class="string">'noise'</span>,<span class="string">'type'</span>,<span class="string">'normal'</span>,<span class="string">'nsecs'</span>,1000,<span class="string">'fs'</span>,10));
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 81 <span class="comment">% add both AOs</span>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 82 x = x1 + x2;
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 83 <span class="comment">% compute the psd changing the 'nfft'</span>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 84 y_lf = psd(x);
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 85 y_hf = psd(x,plist(<span class="string">'nfft'</span>,1000));
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 86 <span class="comment">% compare </span>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 87 iplot(y_lf, y_hf)
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 88 </pre></div>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 89
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 90 <img src="images/psd_1.png" alt="" border="3">
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 91
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 92 <p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 93 2. Evaluation of the PSD of a time-series represented by a low frequency sinewave signal, superimposed to
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 94 white noise and to a low frequency linear drift. In the example, the same spectrum is computed with different
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 95 spectral windows.
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 96 </p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 97 <div class="fragment"><pre>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 98 <br> <span class="comment">% create three AOs</span>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 99 x1 = ao(plist(<span class="string">'waveform'</span>,<span class="string">'sine wave'</span>,<span class="string">'f'</span>,0.1,<span class="string">'A'</span>,1,<span class="string">'nsecs'</span>,1000,<span class="string">'fs'</span>,10,<span class="string">'yunits'</span>,<span class="string">'m'</span>));
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 100 x2 = ao(plist(<span class="string">'waveform'</span>,<span class="string">'noise'</span>,<span class="string">'type'</span>,<span class="string">'normal'</span>,<span class="string">'nsecs'</span>,1000,<span class="string">'fs'</span>,10,<span class="string">'yunits'</span>,<span class="string">'m'</span>));
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 101 x3 = ao(plist(<span class="string">'tsfcn'</span>, <span class="string">'t.^2 + t'</span>,<span class="string">'nsecs'</span>,1000,<span class="string">'fs'</span>,10,<span class="string">'yunits'</span>,<span class="string">'m'</span>));
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 102 <span class="comment">% add them</span>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 103 x = x1 + x2 + x3;
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 104 <span class="comment">% compute psd with different windows</span>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 105 y_1 = psd(x,plist(<span class="string">'scale'</span>,<span class="string">'ASD'</span>,<span class="string">'order'</span>,1,<span class="string">'win'</span>,<span class="string">'BH92'</span>));
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 106 y_2 = psd(x,plist(<span class="string">'scale'</span>,<span class="string">'ASD'</span>,<span class="string">'order'</span>,2,<span class="string">'win'</span>,<span class="string">'Hamming'</span>));
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 107 y_3 = psd(x,plist(<span class="string">'scale'</span>,<span class="string">'ASD'</span>,<span class="string">'order'</span>,2,<span class="string">'win'</span>,<span class="string">'Kaiser'</span>,<span class="string">'psll'</span>,200));
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 108 <span class="comment">% compare</span>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 109 iplot(y_1, y_2, y_3);
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 110 </pre></div>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 111 <p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 112 <img src="images/psd_2.png" alt="" border="3">
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 113 </p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 114 <h2><a name="references">References</a></h2>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 115
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 116 <ol>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 117 <li> P.D. Welch, The Use of Fast Fourier Transform for the Estimation of Power Spectra: A Method Based on Time Averaging Over Short,
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 118 Modified Periodograms, <i>IEEE Trans. on Audio and Electroacoustics</i>, Vol. 15, No. 2 (1967), pp. 70 - 73.</a></li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 119 <li> B. P. Weldford, Note on a Method for Calculating Corrected Sums of Squares and Products,
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 120 <i>Technometrics<i>, Vol. 4, No. 3 (1962), pp 419 - 420.</li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 121 </ol>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 122