gr::channels::dynamic_channel_model Class Reference

dynamic channel simulator More...

#include <gnuradio/channels/dynamic_channel_model.h>

Public Types
typedef boost::shared_ptr < dynamic_channel_model >	sptr
Public Types inherited from gr::hier_block2
typedef basic_block_sptr	opaque_self
	typedef for object returned from self(). More...

Public Member Functions
virtual double	samp_rate () const =0
virtual double	sro_dev_std () const =0
virtual double	sro_dev_max () const =0
virtual double	cfo_dev_std () const =0
virtual double	cfo_dev_max () const =0
virtual double	noise_amp () const =0
virtual double	doppler_freq () const =0
virtual double	K () const =0
virtual void	set_samp_rate (double)=0
virtual void	set_sro_dev_std (double)=0
virtual void	set_sro_dev_max (double)=0
virtual void	set_cfo_dev_std (double)=0
virtual void	set_cfo_dev_max (double)=0
virtual void	set_noise_amp (double)=0
virtual void	set_doppler_freq (double)=0
virtual void	set_K (double)=0
Public Member Functions inherited from gr::hier_block2
virtual	~hier_block2 ()
opaque_self	self ()
	Return an object, representing the current block, which can be passed to connect. More...
void	connect (basic_block_sptr block)
	Add a stand-alone (possibly hierarchical) block to internal graph. More...
void	connect (basic_block_sptr src, int src_port, basic_block_sptr dst, int dst_port)
	Add gr-blocks or hierarchical blocks to internal graph and wire together. More...
void	msg_connect (basic_block_sptr src, pmt::pmt_t srcport, basic_block_sptr dst, pmt::pmt_t dstport)
	Add gr-blocks or hierarchical blocks to internal graph and wire together. More...
void	msg_connect (basic_block_sptr src, std::string srcport, basic_block_sptr dst, std::string dstport)
void	msg_disconnect (basic_block_sptr src, pmt::pmt_t srcport, basic_block_sptr dst, pmt::pmt_t dstport)
void	msg_disconnect (basic_block_sptr src, std::string srcport, basic_block_sptr dst, std::string dstport)
void	disconnect (basic_block_sptr block)
	Remove a gr-block or hierarchical block from the internal flowgraph. More...
void	disconnect (basic_block_sptr src, int src_port, basic_block_sptr dst, int dst_port)
	Disconnect a pair of gr-blocks or hierarchical blocks in internal flowgraph. More...
void	disconnect_all ()
	Disconnect all connections in the internal flowgraph. More...
virtual void	lock ()
virtual void	unlock ()
int	max_output_buffer (size_t port=0)
	Returns max buffer size (itemcount) on output port i. More...
void	set_max_output_buffer (int max_output_buffer)
	Sets max buffer size (itemcount) on all output ports. More...
void	set_max_output_buffer (size_t port, int max_output_buffer)
	Sets max buffer size (itemcount) on output port port. More...
int	min_output_buffer (size_t port=0)
	Returns min buffer size (itemcount) on output port i. More...
void	set_min_output_buffer (int min_output_buffer)
	Sets min buffer size (itemcount) on all output ports. More...
void	set_min_output_buffer (size_t port, int min_output_buffer)
	Sets min buffer size (itemcount) on output port port. More...
flat_flowgraph_sptr	flatten () const
hier_block2_sptr	to_hier_block2 ()
bool	has_msg_port (pmt::pmt_t which_port)
bool	message_port_is_hier (pmt::pmt_t port_id)
bool	message_port_is_hier_in (pmt::pmt_t port_id)
bool	message_port_is_hier_out (pmt::pmt_t port_id)
void	message_port_register_hier_in (pmt::pmt_t port_id)
void	message_port_register_hier_out (pmt::pmt_t port_id)
void	set_processor_affinity (const std::vector< int > &mask)
	Set the affinity of all blocks in hier_block2 to processor core n. More...
void	unset_processor_affinity ()
	Remove processor affinity for all blocks in hier_block2. More...
std::vector< int >	processor_affinity ()
	Get the current processor affinity. More...
bool	all_min_output_buffer_p (void)
	Get if all block min buffers should be set. More...
bool	all_max_output_buffer_p (void)
	Get if all block max buffers should be set. More...
Public Member Functions inherited from gr::basic_block
pmt::pmt_t	message_subscribers (pmt::pmt_t port)
virtual	~basic_block ()
long	unique_id () const
long	symbolic_id () const
std::string	name () const
std::string	symbol_name () const
gr::io_signature::sptr	input_signature () const
gr::io_signature::sptr	output_signature () const
basic_block_sptr	to_basic_block ()
bool	alias_set ()
std::string	alias ()
pmt::pmt_t	alias_pmt ()
void	set_block_alias (std::string name)
void	message_port_register_in (pmt::pmt_t port_id)
void	message_port_register_out (pmt::pmt_t port_id)
void	message_port_pub (pmt::pmt_t port_id, pmt::pmt_t msg)
void	message_port_sub (pmt::pmt_t port_id, pmt::pmt_t target)
void	message_port_unsub (pmt::pmt_t port_id, pmt::pmt_t target)
pmt::pmt_t	message_ports_in ()
	Get input message port names. More...
pmt::pmt_t	message_ports_out ()
	Get output message port names. More...
void	_post (pmt::pmt_t which_port, pmt::pmt_t msg)
bool	empty_p (pmt::pmt_t which_port)
	is the queue empty? More...
bool	empty_p ()
bool	empty_handled_p (pmt::pmt_t which_port)
	are all msg ports with handlers empty? More...
bool	empty_handled_p ()
size_t	nmsgs (pmt::pmt_t which_port)
	How many messages in the queue? More...
void	insert_tail (pmt::pmt_t which_port, pmt::pmt_t msg)
pmt::pmt_t	delete_head_nowait (pmt::pmt_t which_port)
pmt::pmt_t	delete_head_blocking (pmt::pmt_t which_port, unsigned int millisec=0)
msg_queue_t::iterator	get_iterator (pmt::pmt_t which_port)
void	erase_msg (pmt::pmt_t which_port, msg_queue_t::iterator it)
const msg_queue_map_t &	get_msg_map (void) const
virtual void	setup_rpc ()
	Set up the RPC registered variables. More...
bool	is_rpc_set ()
	Ask if this block has been registered to the RPC. More...
void	rpc_set ()
	When the block is registered with the RPC, set this. More...
virtual bool	check_topology (int ninputs, int noutputs)
	Confirm that ninputs and noutputs is an acceptable combination. More...
template<typename T >
void	set_msg_handler (pmt::pmt_t which_port, T msg_handler)
	Set the callback that is fired when messages are available. More...
Public Member Functions inherited from gr::msg_accepter
	msg_accepter ()
	~msg_accepter ()
void	post (pmt::pmt_t which_port, pmt::pmt_t msg)
	send msg to msg_accepter on port which_port More...
Public Member Functions inherited from gr::messages::msg_accepter
	msg_accepter ()

Static Public Member Functions
static sptr	make (double samp_rate, double sro_std_dev, double sro_max_dev, double cfo_std_dev, double cfo_max_dev, unsigned int N, double doppler_freq, bool LOS_model, float K, std::vector< float > delays, std::vector< float > mags, int ntaps_mpath, double noise_amp, double noise_seed)
	Build the dynamic channel simulator. More...

Additional Inherited Members
Public Attributes inherited from gr::hier_block2
pmt::pmt_t	hier_message_ports_in
pmt::pmt_t	hier_message_ports_out
Protected Types inherited from gr::basic_block
enum	vcolor { WHITE, GREY, BLACK }
Protected Member Functions inherited from gr::hier_block2
	hier_block2 (void)
	hier_block2 (const std::string &name, gr::io_signature::sptr input_signature, gr::io_signature::sptr output_signature)
Protected Member Functions inherited from gr::basic_block
	basic_block (void)
	basic_block (const std::string &name, gr::io_signature::sptr input_signature, gr::io_signature::sptr output_signature)
	Protected constructor prevents instantiation by non-derived classes. More...
void	set_input_signature (gr::io_signature::sptr iosig)
	may only be called during constructor More...
void	set_output_signature (gr::io_signature::sptr iosig)
	may only be called during constructor More...
void	set_color (vcolor color)
	Allow the flowgraph to set for sorting and partitioning. More...
vcolor	color () const
virtual bool	has_msg_handler (pmt::pmt_t which_port)
	Tests if there is a handler attached to port which_port. More...
virtual void	dispatch_msg (pmt::pmt_t which_port, pmt::pmt_t msg)
Protected Attributes inherited from gr::basic_block
std::string	d_name
gr::io_signature::sptr	d_input_signature
gr::io_signature::sptr	d_output_signature
long	d_unique_id
long	d_symbolic_id
std::string	d_symbol_name
std::string	d_symbol_alias
vcolor	d_color
bool	d_rpc_set
msg_queue_map_t	msg_queue
std::vector< boost::any >	d_rpc_vars
pmt::pmt_t	d_message_subscribers

Detailed Description

dynamic channel simulator

This block implements a dynamic channel model simulator that can be used to help evaluate, design, and test various signals, waveforms, and algorithms.

This model allows the user to set up an AWGN noise cource, a random walk process to simulate carrier frequency drift, a random walk process to simulate sample rate offset drive, and a frequency selective fading channel response that is either Rayleigh or Ricean for a user specified power delay profile.

Member Typedef Documentation

typedef boost::shared_ptr<dynamic_channel_model> gr::channels::dynamic_channel_model::sptr

Member Function Documentation

virtual double gr::channels::dynamic_channel_model::cfo_dev_max ( ) const

pure virtual

virtual double gr::channels::dynamic_channel_model::cfo_dev_std ( ) const

pure virtual

virtual double gr::channels::dynamic_channel_model::doppler_freq ( ) const

pure virtual

virtual double gr::channels::dynamic_channel_model::K ( ) const

pure virtual

static sptr gr::channels::dynamic_channel_model::make ( double  samp_rate, double  sro_std_dev, double  sro_max_dev, double  cfo_std_dev, double  cfo_max_dev, unsigned int  N, double  doppler_freq, bool  LOS_model, float  K, std::vector< float >  delays, std::vector< float >  mags, int  ntaps_mpath, double  noise_amp, double  noise_seed  )

static

Build the dynamic channel simulator.

Parameters

samp_rate	Input sample rate in Hz
sro_std_dev	sample rate drift process standard deviation per sample in Hz
sro_max_dev	maximum sample rate offset in Hz
cfo_std_dev	carrier frequnecy drift process standard deviation per sample in Hz
cfo_max_dev	maximum carrier frequency offset in Hz
N	number of sinusoids used in frequency selective fading simulation
doppler_freq	maximum doppler frequency used in fading simulation in Hz
LOS_model	defines whether the fading model should include a line of site component. LOS->Rician, NLOS->Rayleigh
K	Rician K-factor, the ratio of specular to diffuse power in the model
delays	A list of fractional sample delays making up the power delay profile
mags	A list of magnitudes corresponding to each delay time in the power delay profile
ntaps_mpath	The length of the filter to interpolate the power delay profile over. Delays in the PDP must lie between 0 and ntaps_mpath, fractional delays will be sinc-interpolated only to the width of this filter.
noise_amp	Specifies the standard deviation of the AWGN process
noise_seed	A random number generator seed for the noise source.

virtual double gr::channels::dynamic_channel_model::noise_amp ( ) const

pure virtual

virtual double gr::channels::dynamic_channel_model::samp_rate ( ) const

pure virtual

virtual void gr::channels::dynamic_channel_model::set_cfo_dev_max ( double  )

pure virtual

virtual void gr::channels::dynamic_channel_model::set_cfo_dev_std ( double  )

pure virtual

virtual void gr::channels::dynamic_channel_model::set_doppler_freq ( double  )

pure virtual

virtual void gr::channels::dynamic_channel_model::set_K ( double  )

pure virtual

virtual void gr::channels::dynamic_channel_model::set_noise_amp ( double  )

pure virtual

virtual void gr::channels::dynamic_channel_model::set_samp_rate ( double  )

pure virtual

virtual void gr::channels::dynamic_channel_model::set_sro_dev_max ( double  )

pure virtual

virtual void gr::channels::dynamic_channel_model::set_sro_dev_std ( double  )

pure virtual

virtual double gr::channels::dynamic_channel_model::sro_dev_max ( ) const

pure virtual

virtual double gr::channels::dynamic_channel_model::sro_dev_std ( ) const

pure virtual

---

The documentation for this class was generated from the following file:

• dynamic_channel_model.h