summaryrefslogtreecommitdiff
path: root/help/en_US/scilab_en_US_help/cheby1.html
blob: 07681577e1456871a4c44fda4e9145ebc5b57079 (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
93
94
95
<html><head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
    <title>cheby1</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="chebwin.html">&lt;&lt; chebwin</a></span>

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

      </td>
      <td width="30%" class="next">
      	<span class="next"><a href="cheby2.html">cheby2 &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_be19baaac84b122b8ad501d34462f5bf.html">FOSSEE Signal Processing Toolbox</a> &gt; cheby1</span>

    <br /><br />
    <div class="refnamediv"><h1 class="refname">cheby1</h1>
    <p class="refpurpose">This function generates a Chebyshev type I filter with rp dB of passband ripple.</p></div>


<div class="refsynopsisdiv"><h3 class="title">Calling Sequence</h3>
   <div class="synopsis"><pre><span class="default">[</span><span class="default">a</span><span class="default">, </span><span class="default">b</span><span class="default">] = </span><span class="functionid">cheby1</span><span class="default"> (</span><span class="default">n</span><span class="default">, </span><span class="default">rp</span><span class="default">, </span><span class="default">w</span><span class="default">)</span>
<span class="default">[</span><span class="default">a</span><span class="default">, </span><span class="default">b</span><span class="default">] = </span><span class="functionid">cheby1</span><span class="default"> (</span><span class="default">n</span><span class="default">, </span><span class="default">rp</span><span class="default">, </span><span class="default">w</span><span class="default">, </span>&#0034;<span class="default">high</span>&#0034;<span class="default">)</span>
<span class="default">[</span><span class="default">a</span><span class="default">, </span><span class="default">b</span><span class="default">] = </span><span class="functionid">cheby1</span><span class="default"> (</span><span class="default">n</span><span class="default">, </span><span class="default">rp</span><span class="default">, [</span><span class="default">wl</span><span class="default">, </span><span class="default">wh</span><span class="default">])</span>
<span class="default">[</span><span class="default">a</span><span class="default">, </span><span class="default">b</span><span class="default">] = </span><span class="functionid">cheby1</span><span class="default"> (</span><span class="default">n</span><span class="default">, </span><span class="default">rp</span><span class="default">, [</span><span class="default">wl</span><span class="default">, </span><span class="default">wh</span><span class="default">], </span>&#0034;<span class="default">stop</span>&#0034;<span class="default">)</span>
<span class="default">[</span><span class="default">a</span><span class="default">, </span><span class="default">b</span><span class="default">, </span><span class="default">c</span><span class="default">] = </span><span class="functionid">cheby1</span><span class="default"> (…)</span>
<span class="default">[</span><span class="default">a</span><span class="default">, </span><span class="default">b</span><span class="default">, </span><span class="default">c</span><span class="default">, </span><span class="default">d</span><span class="default">] = </span><span class="functionid">cheby1</span><span class="default"> (…)</span>
<span class="default">[…] = </span><span class="functionid">cheby1</span><span class="default"> (…, </span>&#0034;<span class="default">s</span>&#0034;<span class="default">)</span></pre></div></div>

<div class="refsection"><h3 class="title">Parameters</h3>
   <dl><dt><span class="term">n:</span>
      <dd><p class="para">positive integer value</p></dd></dt>
   <dt><span class="term">rp:</span>
      <dd><p class="para">non negative scalar value</p></dd></dt>
   <dt><span class="term">w:</span>
      <dd><p class="para">vector, all elements must be in the range [0,1]</p></dd></dt></dl></div>

<div class="refsection"><h3 class="title">Description</h3>
   <p class="para">This is an Octave function.
This function generates a Chebyshev type I filter with rp dB of passband ripple.
The fourth parameter takes in high or low, default value is low. The cutoff is pi*Wc radians.
[b, a] = cheby1(n, Rp, [Wl, Wh]) indicates a band pass filter with edges pi*Wl and pi*Wh radians.
[b, a] = cheby1(n, Rp, [Wl, Wh], ’stop’) indicates a band reject filter with edges pi*Wl and pi*Wh radians.
[z, p, g] = cheby1(...) returns filter as zero-pole-gain rather than coefficients of the numerator and denominator polynomials.
[...] = cheby1(...,’s’) returns a Laplace space filter, w can be larger than 1.
[a,b,c,d] = cheby1(...) returns state-space matrices.</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">cheby1</span><span class="scilabopenclose">(</span><span class="scilabnumber">2</span><span class="scilabdefault">,</span><span class="scilabnumber">6</span><span class="scilabdefault">,</span><span class="scilabnumber">0.7</span><span class="scilabdefault">,</span><span class="scilabstring">&#0034;</span><span class="scilabstring">high</span><span class="scilabstring">&#0034;</span><span class="scilabopenclose">)</span>
<span class="scilabid">a</span> <span class="scilaboperator">=</span>
<span class="scilabnumber">1</span>   <span class="scilabnumber">1</span>
<span class="scilabid">b</span> <span class="scilaboperator">=</span>
<span class="scilaboperator">-</span><span class="scilabnumber">0.62915</span> <span class="scilaboperator">+</span> <span class="scilabnumber">0.55372</span><span class="scilabid">i</span>  <span class="scilaboperator">-</span><span class="scilabnumber">0.62915</span> <span class="scilaboperator">-</span> <span class="scilabnumber">0.55372</span><span class="scilabid">i</span>
<span class="scilabid">c</span> <span class="scilaboperator">=</span>  <span class="scilabnumber">0.055649</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="chebwin.html">&lt;&lt; chebwin</a></span>

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

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

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