summaryrefslogtreecommitdiff
path: root/help/en_US/residuez.xml
blob: b004feac595f2cf40b66e59ac34096660db4d8b2 (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
<?xml version="1.0" encoding="UTF-8"?>

<!--
 *
 * This help file was generated from residuez.sci using help_from_sci().
 *
 -->

<refentry version="5.0-subset Scilab" xml:id="residuez" xml:lang="en"
          xmlns="http://docbook.org/ns/docbook"
          xmlns:xlink="http://www.w3.org/1999/xlink"
          xmlns:svg="http://www.w3.org/2000/svg"
          xmlns:ns3="http://www.w3.org/1999/xhtml"
          xmlns:mml="http://www.w3.org/1998/Math/MathML"
          xmlns:scilab="http://www.scilab.org"
          xmlns:db="http://docbook.org/ns/docbook">

  <refnamediv>
    <refname>residuez</refname>
    <refpurpose></refpurpose>
  </refnamediv>


<refsynopsisdiv>
   <title>Calling Sequence</title>
   <synopsis>
   [r,p,f,m]=residuez(b,a)
   </synopsis>
</refsynopsisdiv>

<refsection>
   <title>Parameters</title>
   <variablelist>
   <varlistentry><term>b:</term>
      <listitem><para> Real or complex valued vector or matrix</para></listitem></varlistentry>
   <varlistentry><term>a:</term>
      <listitem><para> Real or complex valued vector or matrix</para></listitem></varlistentry>
   </variablelist>
</refsection>

<refsection>
   <title>Description</title>
   <para>
It computes the partial fraction expansion of filter H(z)= B(z)/A(z) where inputs b and a are vectors specifying the digital filter.NOTE that the polynomials 'b' and 'a' should have real coefficients(because of the function 'filter' used in polyval). This function works for transfer functions which are proper fractions.
</para>
<para>
<latex>
\begin{eqnarray}
H(z)=\frac{r(1)}{[1-\frac{p(1)}{z}]^{m(1)}}+..........+\frac{r(N)}{[1-\frac{p(N)}{z}]^{m(N)}}
\end{eqnarray}
</latex>
</para>

</refsection>

<refsection>
   <title>Examples</title>
   <programlisting role="example"><![CDATA[
1.B=[1 1 1]; A=[1 -2 1];
  [r,p,f,m] = residuez(B,A)
  //OUTPUT:
  //r=[0;3]
  //p=[1;1]
  //f=1
  //e=[1;2]
   ]]></programlisting>
</refsection>
</refentry>