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

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

<refentry version="5.0-subset Scilab" xml:id="buttord" 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>buttord</refname>
    <refpurpose>/This function computes the minimum filter order of a Butterworth filter with the desired response characteristics.</refpurpose>
  </refnamediv>


<refsynopsisdiv>
   <title>Calling Sequence</title>
   <synopsis>
   n = buttord(Wp, Ws, Rp, Rs)
   [n, Wc] = buttord(Wp, Ws, Rp, Rs)
   </synopsis>
</refsynopsisdiv>

<refsection>
   <title>Parameters</title>
   <variablelist>
   <varlistentry><term>Wp:</term>
      <listitem><para> scalar or vector of length 2</para></listitem></varlistentry>
   <varlistentry><term>Ws:</term>
      <listitem><para> scalar or vector of length 2, elements must be in the range [0,1]</para></listitem></varlistentry>
   <varlistentry><term>Rp:</term>
      <listitem><para> real or complex value</para></listitem></varlistentry>
   <varlistentry><term>Rs:</term>
      <listitem><para> real or complex value</para></listitem></varlistentry>
   </variablelist>
</refsection>

<refsection>
   <title>Description</title>
   <para>
This is an Octave function.
This function computes the minimum filter order of a Butterworth filter with the desired response characteristics.
The filter frequency band edges are specified by the passband frequency wp and stopband frequency ws.
Frequencies are normalized to the Nyquist frequency in the range [0,1].
Rp is measured in decibels and is the allowable passband ripple, and Rs is also in decibels and is the minimum attenuation in the stop band.
If ws>wp, the filter is a low pass filter. If wp>ws, the filter is a high pass filter.
If wp and ws are vectors of length 2, then the passband interval is defined by wp the stopband interval is defined by ws.
If wp is contained within the lower and upper limits of ws, the filter is a band-pass filter. If ws is contained within the lower and upper limits of wp the filter is a band-stop or band-reject filter.
</para>
</refsection>

<refsection>
   <title>Examples</title>
   <programlisting role="example"><![CDATA[
Wp = 40/500
Ws = 150/500
[n, Wn] = buttord(Wp, Ws, 3, 60)
n =  5
Wn =  0.080038
   ]]></programlisting>
</refsection>
</refentry>