Sophie

Sophie

distrib > Fedora > 14 > x86_64 > media > updates > by-pkgid > 6e7a2755bd78c9deedab199b86e675f3 > files > 5575

gnuradio-doc-3.2.2-9.fc14.x86_64.rpm

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>GNU Radio 3.2.2 C++ API: gri_agc2_cc.h Source File</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript">
$(document).ready(initResizable);
</script>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.3 -->
<div id="top">
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
 <tbody>
 <tr style="height: 56px;">
  <td style="padding-left: 0.5em;">
   <div id="projectname">GNU Radio 3.2.2 C++ API</div>
  </td>
 </tr>
 </tbody>
</table>
</div>
</div>
<div id="side-nav" class="ui-resizable side-nav-resizable">
  <div id="nav-tree">
    <div id="nav-tree-contents">
    </div>
  </div>
  <div id="splitbar" style="-moz-user-select:none;" 
       class="ui-resizable-handle">
  </div>
</div>
<script type="text/javascript">
  initNavTree('gri__agc2__cc_8h.html','');
</script>
<div id="doc-content">
<div class="header">
  <div class="headertitle">
<h1>gri_agc2_cc.h</h1>  </div>
</div>
<div class="contents">
<a href="gri__agc2__cc_8h.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/* -*- c++ -*- */</span>
<a name="l00002"></a>00002 <span class="comment">/*</span>
<a name="l00003"></a>00003 <span class="comment"> * Copyright 2006 Free Software Foundation, Inc.</span>
<a name="l00004"></a>00004 <span class="comment"> * </span>
<a name="l00005"></a>00005 <span class="comment"> * This file is part of GNU Radio</span>
<a name="l00006"></a>00006 <span class="comment"> * </span>
<a name="l00007"></a>00007 <span class="comment"> * GNU Radio is free software; you can redistribute it and/or modify</span>
<a name="l00008"></a>00008 <span class="comment"> * it under the terms of the GNU General Public License as published by</span>
<a name="l00009"></a>00009 <span class="comment"> * the Free Software Foundation; either version 3, or (at your option)</span>
<a name="l00010"></a>00010 <span class="comment"> * any later version.</span>
<a name="l00011"></a>00011 <span class="comment"> * </span>
<a name="l00012"></a>00012 <span class="comment"> * GNU Radio is distributed in the hope that it will be useful,</span>
<a name="l00013"></a>00013 <span class="comment"> * but WITHOUT ANY WARRANTY; without even the implied warranty of</span>
<a name="l00014"></a>00014 <span class="comment"> * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the</span>
<a name="l00015"></a>00015 <span class="comment"> * GNU General Public License for more details.</span>
<a name="l00016"></a>00016 <span class="comment"> * </span>
<a name="l00017"></a>00017 <span class="comment"> * You should have received a copy of the GNU General Public License</span>
<a name="l00018"></a>00018 <span class="comment"> * along with GNU Radio; see the file COPYING.  If not, write to</span>
<a name="l00019"></a>00019 <span class="comment"> * the Free Software Foundation, Inc., 51 Franklin Street,</span>
<a name="l00020"></a>00020 <span class="comment"> * Boston, MA 02110-1301, USA.</span>
<a name="l00021"></a>00021 <span class="comment"> */</span>
<a name="l00022"></a>00022 
<a name="l00023"></a>00023 <span class="preprocessor">#ifndef _GRI_AGC2_CC_H_</span>
<a name="l00024"></a>00024 <span class="preprocessor"></span><span class="preprocessor">#define _GRI_AGC2_CC_H_</span>
<a name="l00025"></a>00025 <span class="preprocessor"></span>
<a name="l00026"></a>00026 <span class="preprocessor">#include &lt;math.h&gt;</span>
<a name="l00027"></a>00027 <span class="comment"></span>
<a name="l00028"></a>00028 <span class="comment">/*!</span>
<a name="l00029"></a>00029 <span class="comment"> * \brief high performance Automatic Gain Control class</span>
<a name="l00030"></a>00030 <span class="comment"> *</span>
<a name="l00031"></a>00031 <span class="comment"> * For Power the absolute value of the complex number is used.</span>
<a name="l00032"></a>00032 <span class="comment"> */</span>
<a name="l00033"></a><a class="code" href="classgri__agc2__cc.html">00033</a> <span class="keyword">class </span><a class="code" href="classgri__agc2__cc.html" title="high performance Automatic Gain Control class">gri_agc2_cc</a> {
<a name="l00034"></a>00034 
<a name="l00035"></a>00035  <span class="keyword">public</span>:
<a name="l00036"></a><a class="code" href="classgri__agc2__cc.html#aa9b3989197681d146b32ff1a4bc995ba">00036</a>   <a class="code" href="classgri__agc2__cc.html#aa9b3989197681d146b32ff1a4bc995ba">gri_agc2_cc</a> (<span class="keywordtype">float</span> <a class="code" href="classgri__agc2__cc.html#a4996c777b5d4f7df997046e48228710c">attack_rate</a> = 1e-1, <span class="keywordtype">float</span> <a class="code" href="classgri__agc2__cc.html#a9779995f8b978301f3d8b3de3be52049">decay_rate</a> = 1e-2, <span class="keywordtype">float</span> <a class="code" href="classgri__agc2__cc.html#ad7b129a57fff9b8f2974bbb9ec5c9ee4">reference</a> = 1.0, 
<a name="l00037"></a>00037                <span class="keywordtype">float</span> <a class="code" href="classgri__agc2__cc.html#a72006985b1547b093173035c4072e4ff">gain</a> = 1.0, <span class="keywordtype">float</span> <a class="code" href="classgri__agc2__cc.html#a36d3140ac98f030cca50b74bc218111e">max_gain</a> = 0.0)
<a name="l00038"></a>00038     : <a class="code" href="classgri__agc2__cc.html#a788fb3f95c84611e63612d23d568ef12">_attack_rate</a>(<a class="code" href="classgri__agc2__cc.html#a4996c777b5d4f7df997046e48228710c">attack_rate</a>), <a class="code" href="classgri__agc2__cc.html#a7e9bc91e5b7139147f5e3cf05514bb8a">_decay_rate</a>(<a class="code" href="classgri__agc2__cc.html#a9779995f8b978301f3d8b3de3be52049">decay_rate</a>), <a class="code" href="classgri__agc2__cc.html#afedbdaaae8b0398a5bce7c826ee971bc">_reference</a>(<a class="code" href="classgri__agc2__cc.html#ad7b129a57fff9b8f2974bbb9ec5c9ee4">reference</a>),
<a name="l00039"></a>00039       <a class="code" href="classgri__agc2__cc.html#a458e0f3624fada7de409285bc4a16ba9">_gain</a>(<a class="code" href="classgri__agc2__cc.html#a72006985b1547b093173035c4072e4ff">gain</a>), <a class="code" href="classgri__agc2__cc.html#a4e8a334937f39a7844f49d13d7b7c7ce">_max_gain</a>(<a class="code" href="classgri__agc2__cc.html#a36d3140ac98f030cca50b74bc218111e">max_gain</a>) {};
<a name="l00040"></a>00040 
<a name="l00041"></a><a class="code" href="classgri__agc2__cc.html#a9779995f8b978301f3d8b3de3be52049">00041</a>   <span class="keywordtype">float</span> <a class="code" href="classgri__agc2__cc.html#a9779995f8b978301f3d8b3de3be52049">decay_rate</a> ()<span class="keyword"> const  </span>{ <span class="keywordflow">return</span> <a class="code" href="classgri__agc2__cc.html#a7e9bc91e5b7139147f5e3cf05514bb8a">_decay_rate</a>; }
<a name="l00042"></a><a class="code" href="classgri__agc2__cc.html#a4996c777b5d4f7df997046e48228710c">00042</a>   <span class="keywordtype">float</span> <a class="code" href="classgri__agc2__cc.html#a4996c777b5d4f7df997046e48228710c">attack_rate</a> ()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> <a class="code" href="classgri__agc2__cc.html#a788fb3f95c84611e63612d23d568ef12">_attack_rate</a>; }
<a name="l00043"></a><a class="code" href="classgri__agc2__cc.html#ad7b129a57fff9b8f2974bbb9ec5c9ee4">00043</a>   <span class="keywordtype">float</span> <a class="code" href="classgri__agc2__cc.html#ad7b129a57fff9b8f2974bbb9ec5c9ee4">reference</a> ()<span class="keyword"> const   </span>{ <span class="keywordflow">return</span> <a class="code" href="classgri__agc2__cc.html#afedbdaaae8b0398a5bce7c826ee971bc">_reference</a>; }
<a name="l00044"></a><a class="code" href="classgri__agc2__cc.html#a72006985b1547b093173035c4072e4ff">00044</a>   <span class="keywordtype">float</span> <a class="code" href="classgri__agc2__cc.html#a72006985b1547b093173035c4072e4ff">gain</a> ()<span class="keyword"> const        </span>{ <span class="keywordflow">return</span> <a class="code" href="classgri__agc2__cc.html#a458e0f3624fada7de409285bc4a16ba9">_gain</a>;  }
<a name="l00045"></a><a class="code" href="classgri__agc2__cc.html#a36d3140ac98f030cca50b74bc218111e">00045</a>   <span class="keywordtype">float</span> <a class="code" href="classgri__agc2__cc.html#a36d3140ac98f030cca50b74bc218111e">max_gain</a>()<span class="keyword"> const     </span>{ <span class="keywordflow">return</span> <a class="code" href="classgri__agc2__cc.html#a4e8a334937f39a7844f49d13d7b7c7ce">_max_gain</a>; }
<a name="l00046"></a>00046 
<a name="l00047"></a><a class="code" href="classgri__agc2__cc.html#a3bf819a9eb77d2c5ab825c0f5605bcad">00047</a>   <span class="keywordtype">void</span> <a class="code" href="classgri__agc2__cc.html#a3bf819a9eb77d2c5ab825c0f5605bcad">set_decay_rate</a> (<span class="keywordtype">float</span> rate) { <a class="code" href="classgri__agc2__cc.html#a7e9bc91e5b7139147f5e3cf05514bb8a">_decay_rate</a> = rate; }
<a name="l00048"></a><a class="code" href="classgri__agc2__cc.html#a0cfe25f7e50db7a1b84c97600eda4059">00048</a>   <span class="keywordtype">void</span> <a class="code" href="classgri__agc2__cc.html#a0cfe25f7e50db7a1b84c97600eda4059">set_attack_rate</a> (<span class="keywordtype">float</span> rate) { <a class="code" href="classgri__agc2__cc.html#a788fb3f95c84611e63612d23d568ef12">_attack_rate</a> = rate; }
<a name="l00049"></a><a class="code" href="classgri__agc2__cc.html#af55399565c7f0ae9eb65db1ffd456d32">00049</a>   <span class="keywordtype">void</span> <a class="code" href="classgri__agc2__cc.html#af55399565c7f0ae9eb65db1ffd456d32">set_reference</a> (<span class="keywordtype">float</span> <a class="code" href="classgri__agc2__cc.html#ad7b129a57fff9b8f2974bbb9ec5c9ee4">reference</a>) { <a class="code" href="classgri__agc2__cc.html#afedbdaaae8b0398a5bce7c826ee971bc">_reference</a> = <a class="code" href="classgri__agc2__cc.html#ad7b129a57fff9b8f2974bbb9ec5c9ee4">reference</a>; }
<a name="l00050"></a><a class="code" href="classgri__agc2__cc.html#abad4ab13d1cd016f3d298947ef137fea">00050</a>   <span class="keywordtype">void</span> <a class="code" href="classgri__agc2__cc.html#abad4ab13d1cd016f3d298947ef137fea">set_gain</a> (<span class="keywordtype">float</span> <a class="code" href="classgri__agc2__cc.html#a72006985b1547b093173035c4072e4ff">gain</a>) { <a class="code" href="classgri__agc2__cc.html#a458e0f3624fada7de409285bc4a16ba9">_gain</a> = <a class="code" href="classgri__agc2__cc.html#a72006985b1547b093173035c4072e4ff">gain</a>; }
<a name="l00051"></a><a class="code" href="classgri__agc2__cc.html#ade06ca7a97d859668f51c10449b0b727">00051</a>   <span class="keywordtype">void</span> <a class="code" href="classgri__agc2__cc.html#ade06ca7a97d859668f51c10449b0b727">set_max_gain</a>(<span class="keywordtype">float</span> <a class="code" href="classgri__agc2__cc.html#a36d3140ac98f030cca50b74bc218111e">max_gain</a>) { <a class="code" href="classgri__agc2__cc.html#a4e8a334937f39a7844f49d13d7b7c7ce">_max_gain</a> = <a class="code" href="classgri__agc2__cc.html#a36d3140ac98f030cca50b74bc218111e">max_gain</a>; }
<a name="l00052"></a>00052 
<a name="l00053"></a><a class="code" href="classgri__agc2__cc.html#ad2fda74489ea47d76a13743ac8eb62fc">00053</a>   <a class="code" href="gr__complex_8h.html#aec4bfe41433369afae9327f1b0bc9109">gr_complex</a> <a class="code" href="classgri__agc2__cc.html#ad2fda74489ea47d76a13743ac8eb62fc">scale</a> (<a class="code" href="gr__complex_8h.html#aec4bfe41433369afae9327f1b0bc9109">gr_complex</a> input){
<a name="l00054"></a>00054     <a class="code" href="gr__complex_8h.html#aec4bfe41433369afae9327f1b0bc9109">gr_complex</a> output = input * <a class="code" href="classgri__agc2__cc.html#a458e0f3624fada7de409285bc4a16ba9">_gain</a>;
<a name="l00055"></a>00055     
<a name="l00056"></a>00056     <span class="keywordtype">float</span> tmp = -<a class="code" href="classgri__agc2__cc.html#afedbdaaae8b0398a5bce7c826ee971bc">_reference</a> + sqrt(output.real()*output.real() + 
<a name="l00057"></a>00057                                    output.imag()*output.imag());
<a name="l00058"></a>00058     <span class="keywordtype">float</span> rate = <a class="code" href="classgri__agc2__cc.html#a7e9bc91e5b7139147f5e3cf05514bb8a">_decay_rate</a>;
<a name="l00059"></a>00059     <span class="keywordflow">if</span>((tmp) &gt; <a class="code" href="classgri__agc2__cc.html#a458e0f3624fada7de409285bc4a16ba9">_gain</a>)
<a name="l00060"></a>00060         rate = <a class="code" href="classgri__agc2__cc.html#a788fb3f95c84611e63612d23d568ef12">_attack_rate</a>;
<a name="l00061"></a>00061     _gain -= tmp*rate;
<a name="l00062"></a>00062     
<a name="l00063"></a>00063 <span class="preprocessor">#if 0</span>
<a name="l00064"></a>00064 <span class="preprocessor"></span>    fprintf(stdout, <span class="stringliteral">&quot;rate = %f\ttmp = %f\t gain = %f\n&quot;</span>, rate, tmp, _gain);
<a name="l00065"></a>00065 <span class="preprocessor">#endif</span>
<a name="l00066"></a>00066 <span class="preprocessor"></span>
<a name="l00067"></a>00067     <span class="comment">// Not sure about this; will blow up if _gain &lt; 0 (happens when rates are too high),</span>
<a name="l00068"></a>00068     <span class="comment">// but is this the solution?</span>
<a name="l00069"></a>00069     <span class="keywordflow">if</span> (_gain &lt; 0.0)
<a name="l00070"></a>00070         _gain = 10e-5;
<a name="l00071"></a>00071 
<a name="l00072"></a>00072     <span class="keywordflow">if</span> (<a class="code" href="classgri__agc2__cc.html#a4e8a334937f39a7844f49d13d7b7c7ce">_max_gain</a> &gt; 0.0 &amp;&amp; _gain &gt; <a class="code" href="classgri__agc2__cc.html#a4e8a334937f39a7844f49d13d7b7c7ce">_max_gain</a>)
<a name="l00073"></a>00073        _gain = <a class="code" href="classgri__agc2__cc.html#a4e8a334937f39a7844f49d13d7b7c7ce">_max_gain</a>;                                                    
<a name="l00074"></a>00074     <span class="keywordflow">return</span> output;
<a name="l00075"></a>00075   }
<a name="l00076"></a>00076 
<a name="l00077"></a><a class="code" href="classgri__agc2__cc.html#a5bbf86a6d29d43aa163599048ef3ab96">00077</a>   <span class="keywordtype">void</span> <a class="code" href="classgri__agc2__cc.html#a5bbf86a6d29d43aa163599048ef3ab96">scaleN</a> (<a class="code" href="gr__complex_8h.html#aec4bfe41433369afae9327f1b0bc9109">gr_complex</a> output[], <span class="keyword">const</span> <a class="code" href="gr__complex_8h.html#aec4bfe41433369afae9327f1b0bc9109">gr_complex</a> input[], <span class="keywordtype">unsigned</span> n){
<a name="l00078"></a>00078     <span class="keywordflow">for</span> (<span class="keywordtype">unsigned</span> i = 0; i &lt; n; i++)
<a name="l00079"></a>00079       output[i] = <a class="code" href="classgri__agc2__cc.html#ad2fda74489ea47d76a13743ac8eb62fc">scale</a> (input[i]);
<a name="l00080"></a>00080   }
<a name="l00081"></a>00081   
<a name="l00082"></a>00082  <span class="keyword">protected</span>:
<a name="l00083"></a><a class="code" href="classgri__agc2__cc.html#a788fb3f95c84611e63612d23d568ef12">00083</a>   <span class="keywordtype">float</span> <a class="code" href="classgri__agc2__cc.html#a788fb3f95c84611e63612d23d568ef12">_attack_rate</a>;           <span class="comment">// attack rate for fast changing signals</span>
<a name="l00084"></a><a class="code" href="classgri__agc2__cc.html#a7e9bc91e5b7139147f5e3cf05514bb8a">00084</a>   <span class="keywordtype">float</span> <a class="code" href="classgri__agc2__cc.html#a7e9bc91e5b7139147f5e3cf05514bb8a">_decay_rate</a>;            <span class="comment">// decay rate for slow changing signals</span>
<a name="l00085"></a><a class="code" href="classgri__agc2__cc.html#afedbdaaae8b0398a5bce7c826ee971bc">00085</a>   <span class="keywordtype">float</span> <a class="code" href="classgri__agc2__cc.html#afedbdaaae8b0398a5bce7c826ee971bc">_reference</a>;             <span class="comment">// reference value</span>
<a name="l00086"></a><a class="code" href="classgri__agc2__cc.html#a458e0f3624fada7de409285bc4a16ba9">00086</a>   <span class="keywordtype">float</span> <a class="code" href="classgri__agc2__cc.html#a458e0f3624fada7de409285bc4a16ba9">_gain</a>;                  <span class="comment">// current gain</span>
<a name="l00087"></a><a class="code" href="classgri__agc2__cc.html#a4e8a334937f39a7844f49d13d7b7c7ce">00087</a>   <span class="keywordtype">float</span> <a class="code" href="classgri__agc2__cc.html#a4e8a334937f39a7844f49d13d7b7c7ce">_max_gain</a>;              <span class="comment">// max allowable gain</span>
<a name="l00088"></a>00088 };
<a name="l00089"></a>00089 
<a name="l00090"></a>00090 <span class="preprocessor">#endif </span><span class="comment">/* _GRI_AGC2_CC_H_ */</span>
</pre></div></div>
</div>
  <div id="nav-path" class="navpath">
    <ul>
      <li class="navelem"><a class="el" href="gri__agc2__cc_8h.html">gri_agc2_cc.h</a>      </li>
      <li class="footer">Generated on Thu Feb 17 2011 for GNU Radio 3.2.2 C++ API by&#160;
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.3 </li>
    </ul>
  </div>

</body>
</html>