GNU Radio 3.5.1 C++ API
gri_agc_ff.h
Go to the documentation of this file.
00001 /* -*- c++ -*- */
00002 /*
00003  * Copyright 2002,2006 Free Software Foundation, Inc.
00004  * 
00005  * This file is part of GNU Radio
00006  * 
00007  * GNU Radio is free software; you can redistribute it and/or modify
00008  * it under the terms of the GNU General Public License as published by
00009  * the Free Software Foundation; either version 3, or (at your option)
00010  * any later version.
00011  * 
00012  * GNU Radio is distributed in the hope that it will be useful,
00013  * but WITHOUT ANY WARRANTY; without even the implied warranty of
00014  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
00015  * GNU General Public License for more details.
00016  * 
00017  * You should have received a copy of the GNU General Public License
00018  * along with GNU Radio; see the file COPYING.  If not, write to
00019  * the Free Software Foundation, Inc., 51 Franklin Street,
00020  * Boston, MA 02110-1301, USA.
00021  */
00022 
00023 #ifndef INCLUDED_GRI_AGC_FF_H
00024 #define INCLUDED_GRI_AGC_FF_H
00025 
00026 #include <gr_core_api.h>
00027 #include <math.h>
00028 
00029 /*!
00030  * \brief high performance Automatic Gain Control class
00031  *
00032  * Power is approximated by absolute value
00033  */
00034 class GR_CORE_API gri_agc_ff {
00035 
00036  public:
00037   gri_agc_ff (float rate = 1e-4, float reference = 1.0,
00038               float gain = 1.0, float max_gain = 0.0)
00039     : _rate(rate), _reference(reference), _gain(gain), _max_gain(max_gain) {};
00040 
00041   float rate () const      { return _rate; }
00042   float reference () const { return _reference; }
00043   float gain () const      { return _gain;  }
00044   float max_gain () const  { return _max_gain; }
00045   
00046   void set_rate (float rate) { _rate = rate; }
00047   void set_reference (float reference) { _reference = reference; }
00048   void set_gain (float gain) { _gain = gain; }
00049   void set_max_gain (float max_gain) { _max_gain = max_gain; }
00050   
00051   float scale (float input){
00052     float output = input * _gain;
00053     _gain += (_reference - fabsf (output)) * _rate;
00054     if (_max_gain > 0.0 && _gain > _max_gain)
00055       _gain = _max_gain;
00056     return output;
00057   }
00058 
00059   void scaleN (float output[], const float input[], unsigned n){
00060     for (unsigned i = 0; i < n; i++)
00061       output[i] = scale (input[i]);
00062   }
00063   
00064  protected:
00065   float _rate;                  // adjustment rate
00066   float _reference;             // reference value
00067   float _gain;                  // current gain
00068   float _max_gain;              // maximum gain
00069 };
00070 
00071 #endif /* INCLUDED_GRI_AGC_FF_H */
00072