1
<?xml version="1.0" encoding="UTF-8"?>
2
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns4="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" version="5.0-subset Scilab" xml:id="iir" xml:lang="en">
5
<refpurpose>iir digital filter</refpurpose>
8
<title>Calling Sequence</title>
10
hz=iir(n,ftype,fdesign,frq,delta)
11
[p,z,g]=iir(n,ftype,fdesign,frq,delta)
15
<title>Arguments</title>
20
<para>positive number witn inteher value, the filter order.</para>
26
<para>string specifying the filter type, the possible values are:
27
<literal>'lp'</literal> for low-pass,<literal>'hp'</literal> for
28
high pass,<literal>'bp'</literal> for band pass and
29
<literal>'sb'</literal> for stop band.
36
<para>string specifying the analog filter design, the
37
possible values are: <literal>'butt'</literal>,
38
<literal>'cheb1'</literal>, <literal>'cheb2'</literal> and
39
<literal>'ellip'</literal>
46
<para>2-vector of discrete cut-off frequencies (i.e.,
47
<literal>0<frq<.5</literal>). For <literal>'lp'</literal> and
48
<literal>'hp'</literal> filters only <literal>frq(1)</literal> is
49
used. For <literal>'bp'</literal> and <literal>'sb'</literal> filters
50
<literal>frq(1)</literal> is the lower cut-off frequency and
51
<literal>frq(2)</literal> is the upper cut-off frequency
59
2-vector of error values for <literal>cheb1</literal>,
60
<literal>cheb2</literal>, and <literal>ellip</literal> filters where
61
only <literal>delta(1)</literal> is used for
62
<literal>cheb1</literal> case, only <literal>delta(2)</literal> is
63
used for <literal>cheb2</literal> case, and
64
<literal>delta(1)</literal> and <literal>delta(2)</literal> are both
65
used for <literal>ellip</literal> case.
66
<literal>0<delta(1),delta(2)<1</literal>
71
for <literal>cheb1</literal> filters
72
<literal>1-delta(1)<ripple<1</literal> in passband
77
for <literal>cheb2</literal> filters
78
<literal>0<ripple<delta(2)</literal> in stopband
83
for <literal>ellip</literal> filters
84
<literal>1-delta(1)<ripple<1</literal> in passband and
85
<literal>0<ripple<delta(2)</literal> in stopband
94
<para>a single input single output discrete transfer function, the low pass filter</para>
100
<para>vector of transformed filter zeros.</para>
106
<para>vector of transformed filter poles.</para>
112
<para>a scalar: transformed filter gain.</para>
118
<title>Description</title>
120
function which designs an iir digital filter using <link linkend="analpf">analog filter</link> designs and <link linkend="bilt">bilinear transformation</link> .
124
<title>Examples</title>
125
<programlisting role="example"><![CDATA[
126
hz=iir(3,'bp','ellip',[.15 .25],[.08 .03]);
127
[hzm,fr]=frmag(hz,256);
129
xtitle('Discrete IIR filter band pass 0.15 < fr < 0.25 ',' ',' ');
130
q=poly(0,'q'); //to express the result in terms of the delay operator q=z^-1
133
//Poles Zeros Gain filter representation
134
[p,z,g]=iir(3,'bp','ellip',[.15 .25],[.08 .03]);
135
g*poly(z,'z')/poly(p,'z')
138
<refsection role="see also">
139
<title>See Also</title>
140
<simplelist type="inline">
142
<link linkend="eqfir">eqfir</link>
145
<link linkend="eqiir">eqiir</link>
148
<link linkend="analpf">analpf</link>
151
<link linkend="bilt">bilt</link>