GNU Radio Manual and C++ API Reference  3.7.9.2
The Free & Open Software Radio Ecosystem
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Modules Pages
repetition_encoder.h
Go to the documentation of this file.
1 /* -*- c++ -*- */
2 /*
3  * Copyright 2014 Free Software Foundation, Inc.
4  *
5  * This file is part of GNU Radio
6  *
7  * GNU Radio is free software; you can redistribute it and/or modify
8  * it under the terms of the GNU General Public License as published by
9  * the Free Software Foundation; either version 3, or (at your option)
10  * any later version.
11  *
12  * GNU Radio is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15  * GNU General Public License for more details.
16  *
17  * You should have received a copy of the GNU General Public License
18  * along with GNU Radio; see the file COPYING. If not, write to
19  * the Free Software Foundation, Inc., 51 Franklin Street,
20  * Boston, MA 02110-1301, USA.
21  */
22 
23 #ifndef INCLUDED_FEC_REPETITION_ENCODER_H
24 #define INCLUDED_FEC_REPETITION_ENCODER_H
25 
26 #include <gnuradio/fec/api.h>
27 #include <gnuradio/fec/encoder.h>
28 #include <map>
29 #include <string>
30 
31 namespace gr {
32  namespace fec {
33  namespace code {
34 
35  /*!
36  * \brief Repetition Encoding class.
37  * \ingroup error_coding_blk
38  *
39  * \details
40  * A repetition encoder class that repeats each input bit \p rep
41  * times. To decode, take a majority vote over the number of
42  * repetitions.
43  */
45  {
46  public:
47 
48  /*!
49  * Build a repetition encoding FEC API object.
50  *
51  * \param frame_size Number of bits per frame. If using in the
52  * tagged stream style, this is the maximum allowable
53  * number of bits per frame.
54  * \param rep Repetition rate; encoder rate is rep bits out
55  * for each input bit.
56  */
57  static generic_encoder::sptr make(int frame_size, int rep);
58 
59  /*!
60  * Sets the uncoded frame size to \p frame_size. If \p
61  * frame_size is greater than the value given to the
62  * constructor, the frame size will be capped by that initial
63  * value and this function will return false. Otherwise, it
64  * returns true.
65  */
66  virtual bool set_frame_size(unsigned int frame_size) = 0;
67 
68  /*!
69  * Returns the coding rate of this encoder.
70  */
71  virtual double rate() = 0;
72  };
73 
74  } /* namespace code */
75  } /* namespace fec */
76 } /* namespace gr */
77 
78 #endif /* INCLUDED_FEC_REPETITION_ENCODER_H */
Repetition Encoding class.
Definition: repetition_encoder.h:44
Include this header to use the message passing features.
Definition: logger.h:131
Definition: generic_encoder.h:34
boost::shared_ptr< generic_encoder > sptr
Definition: generic_encoder.h:49
#define FEC_API
Definition: gr-fec/include/gnuradio/fec/api.h:30