GNU Radio Manual and C++ API Reference  3.10.9.1
The Free & Open Software Radio Ecosystem
fading_model.h
Go to the documentation of this file.
1 /* -*- c++ -*- */
2 /*
3  * Copyright 2013 Free Software Foundation, Inc.
4  *
5  * This file is part of GNU Radio
6  *
7  * SPDX-License-Identifier: GPL-3.0-or-later
8  *
9  */
10 
11 #ifndef INCLUDED_CHANNELS_FADING_MODEL_H
12 #define INCLUDED_CHANNELS_FADING_MODEL_H
13 
14 #include <gnuradio/channels/api.h>
15 #include <gnuradio/sync_block.h>
16 #include <gnuradio/types.h>
17 
18 namespace gr {
19 namespace channels {
20 
21 /*!
22  * \brief fading simulator
23  * \ingroup channel_models_blk
24  *
25  * \details
26  * This block implements a basic fading model simulator that can
27  * be used to help evaluate, design, and test various signals,
28  * waveforms, and algorithms.
29  */
30 class CHANNELS_API fading_model : virtual public sync_block
31 {
32 public:
33  // gr::channels::channel_model::sptr
34  typedef std::shared_ptr<fading_model> sptr;
35 
36  /*! \brief Build the channel simulator.
37  *
38  * \param N the number of sinusoids to use in simulating the channel; 8 is a good
39  * value
40  * \param fDTs normalized maximum Doppler frequency, fD * Ts
41  * \param LOS include Line-of-Site path? selects between Rayleigh (NLOS) and Rician
42  * (LOS) models \param K Rician factor (ratio of the specular power to the
43  * scattered power) \param seed a random number to seed the noise generators
44  */
45  static sptr make(unsigned int N,
46  float fDTs = 0.01f,
47  bool LOS = true,
48  float K = 4,
49  uint32_t seed = 0);
50 
51  virtual float fDTs() = 0;
52  virtual float K() = 0;
53  virtual float step() = 0;
54 
55  virtual void set_fDTs(float fDTs) = 0;
56  virtual void set_K(float K) = 0;
57  virtual void set_step(float step) = 0;
58 };
59 
60 } /* namespace channels */
61 } /* namespace gr */
62 
63 #endif /* INCLUDED_CHANNELS_FADING_MODEL_H */
fading simulator
Definition: fading_model.h:31
virtual void set_step(float step)=0
static sptr make(unsigned int N, float fDTs=0.01f, bool LOS=true, float K=4, uint32_t seed=0)
Build the channel simulator.
virtual float fDTs()=0
std::shared_ptr< fading_model > sptr
Definition: fading_model.h:34
virtual void set_K(float K)=0
virtual float step()=0
virtual void set_fDTs(float fDTs)=0
synchronous 1:1 input to output with history
Definition: sync_block.h:26
#define CHANNELS_API
Definition: gr-channels/include/gnuradio/channels/api.h:18
GNU Radio logging wrapper.
Definition: basic_block.h:29