Mercurial > hg > ltpda
diff m-toolbox/html_help/help/ug/constructor_examples_specwin.html @ 0:f0afece42f48
Import.
author | Daniele Nicolodi <nicolodi@science.unitn.it> |
---|---|
date | Wed, 23 Nov 2011 19:22:13 +0100 |
parents | |
children |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/m-toolbox/html_help/help/ug/constructor_examples_specwin.html Wed Nov 23 19:22:13 2011 +0100 @@ -0,0 +1,261 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" + "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd"> + +<html lang="en"> +<head> + <meta name="generator" content= + "HTML Tidy for Mac OS X (vers 1st December 2004), see www.w3.org"> + <meta http-equiv="Content-Type" content= + "text/html; charset=us-ascii"> + + <title>Constructor examples of the SPECWIN class (LTPDA Toolbox)</title> + <link rel="stylesheet" href="docstyle.css" type="text/css"> + <meta name="generator" content="DocBook XSL Stylesheets V1.52.2"> + <meta name="description" content= + "Presents an overview of the features, system requirements, and starting the toolbox."> + </head> + +<body> + <a name="top_of_page" id="top_of_page"></a> + + <p style="font-size:1px;"> </p> + + <table class="nav" summary="Navigation aid" border="0" width= + "100%" cellpadding="0" cellspacing="0"> + <tr> + <td valign="baseline"><b>LTPDA Toolbox</b></td><td><a href="../helptoc.html">contents</a></td> + + <td valign="baseline" align="right"><a href= + "constructor_examples_plist.html"><img src="b_prev.gif" border="0" align= + "bottom" alt="Constructor examples of the PLIST class"></a> <a href= + "bycategory.html"><img src="b_next.gif" border="0" align= + "bottom" alt="Functions - By Category"></a></td> + </tr> + </table> + + <h1 class="title"><a name="f3-12899" id="f3-12899"></a>Constructor examples of the SPECWIN class</h1> + <hr> + + <p> + +<!-- -------------------------------------------------- --> +<!-- --------------- BEGIN CONTENT FILE --------------- --> +<!-- -------------------------------------------------- --> + +<table border="0" summary="Simple list" class="simplelist_nottable_last"> + <tr> + <td> + <a href="constructor_examples_specwin.html#empty">Construct empty SPECWIN object</a> + </td> + </tr> + <tr> + <td> + <a href="constructor_examples_specwin.html#xml_file">Construct a SPECWIN object by loading the object from a file</a> + </td> + </tr> + <tr> + <td> + <a href="constructor_examples_specwin.html#particular">Construct a SPECWIN of a particular window type an length</a> + </td> + </tr> + <tr> + <td> + <a href="constructor_examples_specwin.html#kaiser">Construct a SPECWIN Kaiser window with the prescribed psll</a> + </td> + </tr> + <tr> + <td> + <a href="constructor_examples_specwin.html#plist">Construct a SPECWIN object from a parameter list (PLIST) object</a> + </td> + </tr> +</table> + +<!-- --------------- NEXT EXAMPLE --------------- --> + +<hr> +<h2 class="title"><a href="gui_specwin.html">For help in designing a SPECWIN object, see also the Spectral Window GUI documentation</a></h2> +<hr /> +<h2 class="title"></h2> +<h2 class="title"><a name="empty"></a>Construct empty SPECWIN object</h2> +<p>The following example creates an empty specwin object</p> +<div class="fragment"><pre class="programlisting"> +w = specwin() +-------- None ------------ + + alpha: -1 + psll: -1 + rov: -1 + nenbw: -1 + w3db: -1 +flatness: -1 + ws: -1 + ws2: -1 + win: 1 + +-------------------------- +</pre></div> + +<!-- --------------- NEXT EXAMPLE --------------- --> + +<hr> +<h2 class="title"><a name="xml_file"></a>Construct a SPECWIN object by loading the object from a file</h2> +<p>The following example creates a new specwin object by loading the specwin object from disk.</p> +<div class="fragment"><pre class="programlisting"> +p = specwin(<span class="string">'specwin.mat'</span>) +p = specwin(<span class="string">'specwin.xml'</span>) +</pre></div> + +<!-- --------------- NEXT EXAMPLE --------------- --> + +<hr> +<h2 class="title"><a name="particular"></a>Construct a SPECWIN of a particular window type an length</h2> + <p>To create a spectral window object, you call the <tt>specwin</tt> class constructor. The following + code fragment creates a 100-point Hanning window: + </p> + <div class="fragment"><pre> + >> w = specwin(<span class="string">'Hanning'</span>, 100) + -------- Hanning ------------ + + alpha: 0 + psll: 31.5 + rov: 50 + nenbw: 1.5 + w3db: 1.4382 + flatness: -1.4236 + ws: 50 + ws2: 37.5 + win: 100 + + ----------------------------- + </pre></div> + <p><a href="specwin_description.html">List of available window functions</a></p> + +<!-- --------------- NEXT EXAMPLE --------------- --> + +<hr> +<h2 class="title"><a name="kaiser"></a>Construct a SPECWIN Kaiser window with the prescribed psll</h2> + <p>In the special case of creating a Kaiser window, the additional input parameter, PSLL, must be supplied. For example, the following code creates a 100-point Kaiser window with -150dB peak side-lobe level:</p> + <div class="fragment"><pre> + >> w = specwin(<span class="string">'Kaiser'</span>, 100, 150) + -------- Kaiser ------------ + + alpha: 6.18029 + psll: 150 + rov: 73.3738 + nenbw: 2.52989 + w3db: 2.38506 + flatness: -0.52279 + ws: 28.2558 + ws2: 20.1819 + win: 100 + + ---------------------------- + </pre></div> + +<!-- --------------- NEXT EXAMPLE --------------- --> + +<hr> +<h2 class="title"><a name="plist"></a>Construct a SPECWIN object from a parameter list (PLIST) object</h2> +<p>Construct a SPECWIN from its definion. + <table border="0" summary="Simple list" class="simplelist_nottable_last" width="50%"> + <tr valign="top"> + <td width="25%"> + <p>'Name'</p> + </td> + <td width="75%"> + <p>Spectral window name [default: 'Kaiser']</p> + </td> + </tr> + <tr valign="top"> + <td width="25%"> + <p>'N'</p> + </td> + <td width="75%"> + <p>Spectral window length [default: 10]</p> + </td> + </tr> + <tr valign="top"> + <td width="25%"> + <p>'PSLL'</p> + </td> + <td width="75%"> + <p>Peak sidelobe length (only for Kaiser type)<br />[default: 150]</p> + </td> + </tr> + </table> +</p> +<div class="fragment"><pre class="programlisting"> +pl = plist(<span class="string">'Name'</span>, <span class="string">'Kaiser'</span>, <span class="string">'N'</span>, 1000, <span class="string">'PSLL'</span>, 75); + +w = specwin(pl) +-------- Kaiser ------------ + + alpha: 3.21394 + psll: 75 + rov: 63.4095 + nenbw: 1.85055 + w3db: 1.75392 +flatness: -0.963765 + ws: 389.305 + ws2: 280.892 + win: 1000 + +---------------------------- +</pre></div> +<div class="fragment"><pre class="programlisting"> +pl = plist(<span class="string">'Name'</span>, <span class="string">'Hanning'</span>, <span class="string">'N'</span>, 1000); + +w =specwin(pl) +-------- Hanning ------------ + + alpha: 0 + psll: 31.5 + rov: 50 + nenbw: 1.5 + w3db: 1.4382 +flatness: -1.4236 + ws: 500 + ws2: 375 + win: 1000 + +----------------------------- +</pre></div> + + + + + + + + + + + + + + </p> + + <br> + <br> + <table class="nav" summary="Navigation aid" border="0" width= + "100%" cellpadding="0" cellspacing="0"> + <tr valign="top"> + <td align="left" width="20"><a href="constructor_examples_plist.html"><img src= + "b_prev.gif" border="0" align="bottom" alt= + "Constructor examples of the PLIST class"></a> </td> + + <td align="left">Constructor examples of the PLIST class</td> + + <td> </td> + + <td align="right">Functions - By Category</td> + + <td align="right" width="20"><a href= + "bycategory.html"><img src="b_next.gif" border="0" align= + "bottom" alt="Functions - By Category"></a></td> + </tr> + </table><br> + + <p class="copy">©LTP Team</p> +</body> +</html>