GNU Radio 3.5.1 C++ API
gri_mmse_fir_interpolator_cc.h
Go to the documentation of this file.
00001 /* -*- c++ -*- */
00002 /*
00003  * Copyright 2002,2007 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 #ifndef _GRI_MMSE_FIR_INTERPOLATOR_CC_H_
00023 #define _GRI_MMSE_FIR_INTERPOLATOR_CC_H_
00024 
00025 #include <gr_core_api.h>
00026 #include <gr_complex.h>
00027 #include <vector>
00028 
00029 class gr_fir_ccf;
00030 
00031 /*!
00032  * \brief Compute intermediate samples between signal samples x(k*Ts)
00033  * \ingroup filter_primitive
00034  *
00035  * This implements a Mininum Mean Squared Error interpolator with 8 taps.
00036  * It is suitable for signals where the bandwidth of interest B = 1/(4*Ts)
00037  * Where Ts is the time between samples.
00038  *
00039  * Although mu, the fractional delay, is specified as a float, it is actually
00040  * quantized.  0.0 <= mu <= 1.0.  That is, mu is quantized in the interpolate 
00041  * method to 32nd's of a sample.
00042  */
00043 
00044 class GR_CORE_API gri_mmse_fir_interpolator_cc {
00045 public:
00046   gri_mmse_fir_interpolator_cc ();
00047   ~gri_mmse_fir_interpolator_cc ();
00048 
00049   unsigned ntaps () const;
00050   unsigned nsteps () const;
00051 
00052   /*!
00053    * \brief compute a single interpolated output value.
00054    *
00055    * \p input must have ntaps() valid entries and be 8-byte aligned.
00056    * input[0] .. input[ntaps() - 1] are referenced to compute the output value.
00057    * \throws std::invalid_argument if input is not 8-byte aligned.
00058    *
00059    * \p mu must be in the range [0, 1] and specifies the fractional delay.
00060    *
00061    * \returns the interpolated input value.
00062    */
00063   gr_complex interpolate (const gr_complex input[], float mu);
00064 
00065 protected:
00066   std::vector<gr_fir_ccf *>     filters;
00067 };
00068 
00069 
00070 #endif /* _GRI_MMSE_FIR_INTERPOLATOR_CC_H_ */