diff options
Diffstat (limited to 'help/en_US/scilab_en_US_help/ar_psd.html')
| -rw-r--r-- | help/en_US/scilab_en_US_help/ar_psd.html | 94 |
1 files changed, 94 insertions, 0 deletions
diff --git a/help/en_US/scilab_en_US_help/ar_psd.html b/help/en_US/scilab_en_US_help/ar_psd.html new file mode 100644 index 0000000..a3eab93 --- /dev/null +++ b/help/en_US/scilab_en_US_help/ar_psd.html @@ -0,0 +1,94 @@ +<html><head> + <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> + <title>ar_psd</title> + <style type="text/css" media="all"> + @import url("scilab_code.css"); + @import url("xml_code.css"); + @import url("c_code.css"); + @import url("style.css"); + </style> + </head> + <body> + <div class="manualnavbar"> + <table width="100%"><tr> + <td width="30%"> + <span class="previous"><a href="arParEst.html"><< arParEst</a></span> + + </td> + <td width="40%" class="center"> + <span class="top"><a href="section_cc2bc01c47967d47fcf3507a91d572ba.html">FOSSEE Signal Processing Toolbox</a></span> + + </td> + <td width="30%" class="next"> + <span class="next"><a href="arburg.html">arburg >></a></span> + + </td> + </tr></table> + <hr /> + </div> + + + + <span class="path"><a href="index.html">FOSSEE Signal Processing Toolbox</a> >> <a href="section_cc2bc01c47967d47fcf3507a91d572ba.html">FOSSEE Signal Processing Toolbox</a> > ar_psd</span> + + <br /><br /> + <div class="refnamediv"><h1 class="refname">ar_psd</h1> + <p class="refpurpose">Calculate the power spectrum of the autoregressive model</p></div> + + +<div class="refsynopsisdiv"><h3 class="title">Calling Sequence</h3> + <div class="synopsis"><pre><span class="default">[</span><span class="default">PSD</span><span class="default">,</span><span class="default">F_OUT</span><span class="default">]=</span><span class="functionid">ar_psd</span><span class="default"> (</span><span class="default">A</span><span class="default">, </span><span class="default">V</span><span class="default">)</span> +<span class="default">[</span><span class="default">PSD</span><span class="default">,</span><span class="default">F_OUT</span><span class="default">]=</span><span class="functionid">ar_psd</span><span class="default"> (</span><span class="default">A</span><span class="default">, </span><span class="default">V</span><span class="default">, </span><span class="default">FREQ</span><span class="default">)</span> +<span class="default">[</span><span class="default">PSD</span><span class="default">,</span><span class="default">F_OUT</span><span class="default">]=</span><span class="functionid">ar_psd</span><span class="default"> (</span><span class="default">A</span><span class="default">, </span><span class="default">V</span><span class="default">, </span><span class="default">FREQ</span><span class="default">, </span><span class="default">FS</span><span class="default">)</span> +<span class="default">[</span><span class="default">PSD</span><span class="default">,</span><span class="default">F_OUT</span><span class="default">]=</span><span class="functionid">ar_psd</span><span class="default"> (..., </span><span class="default">RANGE</span><span class="default">)</span> +<span class="default">[</span><span class="default">PSD</span><span class="default">,</span><span class="default">F_OUT</span><span class="default">]=</span><span class="functionid">ar_psd</span><span class="default"> (..., </span><span class="default">METHOD</span><span class="default">)</span> +<span class="default">[</span><span class="default">PSD</span><span class="default">,</span><span class="default">F_OUT</span><span class="default">]=</span><span class="functionid">ar_psd</span><span class="default"> (..., </span><span class="default">PLOTTYPE</span><span class="default">)</span></pre></div></div> + +<div class="refsection"><h3 class="title">Parameters</h3> + <dl><dt><span class="term">A:</span> + <dd><p class="para">List of M=(order+1) autoregressive model coefficients. The first element of "ar_coeffs" is the zero-lag coefficient, which always has a value of 1.</p></dd></dt> + <dt><span class="term">V:</span> + <dd><p class="para">Square of the moving-average coefficient of the AR model.</p></dd></dt> + <dt><span class="term">FREQ:</span> + <dd><p class="para">Frequencies at which power spectral density is calculated, or a scalar indicating the number of uniformly distributed frequency values at which spectral density is calculated. (default = 256)</p></dd></dt> + <dt><span class="term">FS:</span> + <dd><p class="para">Sampling frequency (Hertz) (default=1)</p></dd></dt> + <dt><span class="term">Range:</span> + <dd><p class="para">'half', 'onesided' : frequency range of the spectrum is from zero up to but not including sample_f/2. Power from negative frequencies is added to the positive side of the spectrum.'whole', 'twosided' : frequency range of the spectrum is-sample_f/2 to sample_f/2, with negative frequencies stored in "wrap around" order after the positive frequencies; e.g. frequencies for a 10-point 'twosided' spectrum are 0 0.1 0.2 0.3 0.4 0.5 -0.4 -0.3 -0.2 -0.1 'shift', 'centerdc' : same as 'whole' but with the first half of the spectrum swapped with second half to put the zero-frequency value in the middle. (See "help fftshift". If "freq" is vector, 'shift' is ignored. If model coefficients "ar_coeffs" are real, the default range is 'half', otherwise default range is 'whole'.</p></dd></dt> + <dt><span class="term">Method:</span> + <dd><p class="para">'fft': use FFT to calculate power spectrum. 'poly': calculate power spectrum as a polynomial of 1/z N.B. this argument is ignored if the "freq" argument is a vector. The default is 'poly' unless the "freq" argument is an integer power of 2.</p></dd></dt> + <dt><span class="term">Plot type:</span> + <dd><p class="para">'plot', 'semilogx', 'semilogy', 'loglog', 'squared' or 'db':specifies the type of plot. The default is 'plot', which means linear-linear axes. 'squared' is the same as 'plot'. 'dB' plots "10*log10(psd)". This argument is ignored and a spectrum is not plotted if the caller requires a returned value.</p></dd></dt> + <dt><span class="term">PSD:</span> + <dd><p class="para">estimate of power-spectral density</p></dd></dt> + <dt><span class="term">F_OUT:</span> + <dd><p class="para">frequency values</p></dd></dt></dl></div> + +<div class="refsection"><h3 class="title">Description</h3> + <p class="para">If the FREQ argument is a vector (of frequencies) the spectrum is calculated using the polynomial method and the METHOD argument is ignored. For scalar FREQ, an integer power of 2, or METHOD = "FFT", causes the spectrum to be calculated by FFT. Otherwise, the spectrum is calculated as a polynomial. It may be computationally more efficient to use the FFT method if length of the model is not much smaller than the number of frequency values. The spectrum is scaled so that spectral energy (area under spectrum) is the same as the time-domain energy (mean square of the signal).</p></div> + +<div class="refsection"><h3 class="title">Examples</h3> + <div class="programlisting"><table border="0" width="100%"><tr><td width="98%"><pre class="scilabcode"><span class="scilabopenclose">[</span><span class="scilabid">a</span><span class="scilabdefault">,</span><span class="scilabid">b</span><span class="scilabopenclose">]</span><span class="scilaboperator">=</span> <span class="scilabid">ar_psd</span><span class="scilabopenclose">(</span><span class="scilabopenclose">[</span><span class="scilabnumber">1</span><span class="scilabdefault">,</span><span class="scilabnumber">2</span><span class="scilabdefault">,</span><span class="scilabnumber">3</span><span class="scilabopenclose">]</span><span class="scilabdefault">,</span><span class="scilabnumber">2</span><span class="scilabopenclose">)</span></pre></td><td valign="top"><a href="scilab://scilab.execexample/"><img src="ScilabExecute.png" border="0"/></a></td><td valign="top"><a href="scilab://scilab.editexample/"><img src="ScilabEdit.png" border="0"/></a></td><td></td></tr></table></div></div> + <br /> + + <div class="manualnavbar"> + <table width="100%"> + <tr><td colspan="3" class="next"><a href="http://bugzilla.scilab.org/enter_bug.cgi?product=Scilab%20software&component=Documentation%20pages" class="ulink">Report an issue</a></td></tr> +<tr> + <td width="30%"> + <span class="previous"><a href="arParEst.html"><< arParEst</a></span> + + </td> + <td width="40%" class="center"> + <span class="top"><a href="section_cc2bc01c47967d47fcf3507a91d572ba.html">FOSSEE Signal Processing Toolbox</a></span> + + </td> + <td width="30%" class="next"> + <span class="next"><a href="arburg.html">arburg >></a></span> + + </td> + </tr></table> + <hr /> + </div> + </body> +</html> |