summaryrefslogtreecommitdiff
path: root/help/en_US/scilab_en_US_help/sos2zp.html
blob: 49ca108cb3ee94cc5b6eee85531c1be14ccbd477 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
<html><head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
    <title>sos2zp</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="sos2tf.html">&lt;&lt; sos2tf</a></span>

      </td>
      <td width="40%" class="center">
      	<span class="top"><a href="section_e54aa8aac34aa55341e8b4b782fe1a74.html">FOSSEE Signal Processing Toolbox</a></span>

      </td>
      <td width="30%" class="next">
      	<span class="next"><a href="sosbreak.html">sosbreak &gt;&gt;</a></span>

      </td>
    </tr></table>
      <hr />
    </div>



    <span class="path"><a href="index.html">FOSSEE Signal Processing Toolbox</a> &gt;&gt; <a href="section_e54aa8aac34aa55341e8b4b782fe1a74.html">FOSSEE Signal Processing Toolbox</a> &gt; sos2zp</span>

    <br /><br />
    <div class="refnamediv"><h1 class="refname">sos2zp</h1>
    <p class="refpurpose">This function converts series second-order sections to zeros, poles, and gains (pole residues).</p></div>


<div class="refsynopsisdiv"><h3 class="title">Calling Sequence</h3>
   <div class="synopsis"><pre><span class="default">z</span><span class="default"> = </span><span class="functionid">sos2zp</span><span class="default"> (</span><span class="default">sos</span><span class="default">)</span>
<span class="default">z</span><span class="default"> = </span><span class="functionid">sos2zp</span><span class="default"> (</span><span class="default">sos</span><span class="default">, </span><span class="default">g</span><span class="default">)</span>
<span class="default">[</span><span class="default">z</span><span class="default">, </span><span class="default">p</span><span class="default">] = </span><span class="functionid">sos2zp</span><span class="default"> (...)</span>
<span class="default">[</span><span class="default">z</span><span class="default">, </span><span class="default">p</span><span class="default">, </span><span class="default">k</span><span class="default">] = </span><span class="functionid">sos2zp</span><span class="default"> (...)</span></pre></div></div>

<div class="refsection"><h3 class="title">Parameters</h3>
   <dl><dt><span class="term">sos:</span>
      <dd><p class="para">matrix of real or complex numbers</p></dd></dt>
   <dt><span class="term">g:</span>
      <dd><p class="para">real or complex value, default value is 1</p></dd></dt>
   <dt><span class="term">z:</span>
      <dd><p class="para">column vector</p></dd></dt>
   <dt><span class="term">p:</span>
      <dd><p class="para">column vector</p></dd></dt></dl></div>

<div class="refsection"><h3 class="title">Description</h3>
   <p class="para">This is an Octave function.
This function converts series second-order sections to zeros, poles, and gains (pole residues).
The input is the sos matrix and the second parameter is the overall gain, default value of which is 1.
The outputs are z, p, k. z and p are column vectors containing zeros and poles respectively, and k is the overall gain.</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="scilabdefault">,</span><span class="scilabid">c</span><span class="scilabopenclose">]</span><span class="scilaboperator">=</span><span class="scilabid">sos2zp</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="scilabdefault">,</span><span class="scilabnumber">4</span><span class="scilabdefault">,</span><span class="scilabnumber">5</span><span class="scilabdefault">,</span><span class="scilabnumber">6</span><span class="scilabopenclose">]</span><span class="scilabopenclose">)</span>
<span class="scilabid">a</span> <span class="scilaboperator">=</span>
<span class="scilaboperator">-</span><span class="scilabnumber">1.0000</span> <span class="scilaboperator">+</span> <span class="scilabnumber">1.4142</span><span class="scilabid">i</span>
<span class="scilaboperator">-</span><span class="scilabnumber">1.0000</span> <span class="scilaboperator">-</span> <span class="scilabnumber">1.4142</span><span class="scilabid">i</span>
<span class="scilabid">b</span> <span class="scilaboperator">=</span>
<span class="scilaboperator">-</span><span class="scilabnumber">0.6250</span> <span class="scilaboperator">+</span> <span class="scilabnumber">1.0533</span><span class="scilabid">i</span>
<span class="scilaboperator">-</span><span class="scilabnumber">0.6250</span> <span class="scilaboperator">-</span> <span class="scilabnumber">1.0533</span><span class="scilabid">i</span>
<span class="scilabid">c</span> <span class="scilaboperator">=</span>  <span class="scilabnumber">1</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="sos2tf.html">&lt;&lt; sos2tf</a></span>

      </td>
      <td width="40%" class="center">
      	<span class="top"><a href="section_e54aa8aac34aa55341e8b4b782fe1a74.html">FOSSEE Signal Processing Toolbox</a></span>

      </td>
      <td width="30%" class="next">
      	<span class="next"><a href="sosbreak.html">sosbreak &gt;&gt;</a></span>

      </td>
    </tr></table>
      <hr />
    </div>
  </body>
</html>