BPSK modulator with real symbols. More...
#include <itpp/comm/modulator.h>
Public Member Functions  
BPSK ()  
Constructor.  
virtual  ~BPSK () 
Destructor.  
void  modulate_bits (const bvec &bits, vec &output) const 
Modulate bits into BPSK symbols in complex domain.  
vec  modulate_bits (const bvec &bits) const 
Modulate bits into BPSK symbols in complex domain.  
void  demodulate_bits (const vec &signal, bvec &output) const 
Demodulate noisy BPSK symbols in complex domain into bits.  
bvec  demodulate_bits (const vec &signal) const 
Demodulate noisy BPSK symbols in complex domain into bits.  
virtual void  demodulate_soft_bits (const vec &rx_symbols, double N0, vec &soft_bits, Soft_Method method=LOGMAP) const 
Soft demodulator for AWGN channel.  
vec  demodulate_soft_bits (const vec &rx_symbols, double N0, Soft_Method method=LOGMAP) const 
Soft demodulator for AWGN channel.  
virtual void  demodulate_soft_bits (const vec &rx_symbols, const vec &channel, double N0, vec &soft_bits, Soft_Method method=LOGMAP) const 
Soft demodulator for a known channel in AWGN.  
vec  demodulate_soft_bits (const vec &rx_symbols, const vec &channel, double N0, Soft_Method method=LOGMAP) const 
Soft demodulator for a known channel in AWGN.  
virtual void  set (const Vec< double > &symbols, const ivec &bits2symbols) 
Set the constellation to use in the modulator.  
virtual int  bits_per_symbol () const 
Returns number of bits per symbol.  
virtual int  get_k () const 
Returns number of bits per symbol.  
virtual int  get_M () const 
Returns number of modulation symbols.  
virtual Vec< double >  get_symbols () const 
Get the symbol values used in the modulator.  
virtual ivec  get_bits2symbols () const 
Get the bitmap, which maps input bits into symbols.  
virtual void  modulate (const ivec &symbolnumbers, Vec< double > &output) const 
Modulation of symbols.  
virtual Vec< double >  modulate (const ivec &symbolnumbers) const 
Modulation of symbols.  
virtual void  demodulate (const Vec< double > &signal, ivec &output) const 
Demodulation of symbols.  
virtual ivec  demodulate (const Vec< double > &signal) const 
Demodulation of symbols.  
virtual void  modulate_bits (const bvec &bits, Vec< double > &output) const 
Modulation of bits.  
virtual void  demodulate_bits (const Vec< double > &signal, bvec &bits) const 
Hard demodulation of bits.  
virtual bvec  demodulate_bits (const Vec< double > &signal) const 
Hard demodulation of bits.  
virtual void  demodulate_soft_bits (const Vec< double > &rx_symbols, double N0, vec &soft_bits, Soft_Method method=LOGMAP) const 
Soft demodulator for AWGN channels.  
virtual vec  demodulate_soft_bits (const Vec< double > &rx_symbols, double N0, Soft_Method method=LOGMAP) const 
Soft demodulator for AWGN channels.  
virtual void  demodulate_soft_bits (const Vec< double > &rx_symbols, const Vec< double > &channel, double N0, vec &soft_bits, Soft_Method method=LOGMAP) const 
Soft demodulator for fading channels.  
virtual vec  demodulate_soft_bits (const Vec< double > &rx_symbols, const Vec< double > &channel, double N0, Soft_Method method=LOGMAP) const 
Soft demodulator for fading channels.  
Protected Member Functions  
void  calculate_softbit_matrices () 
This function calculates the soft bit mapping matrices S0 and S1.  
Protected Attributes  
bool  setup_done 
Setup indicator.  
int  k 
Number of bits per modulation symbol.  
int  M 
Number of modulation symbols.  
bmat  bitmap 
Bit to symbol mapping table (size: M x k)  
ivec  bits2symbols 
Bit to symbol mapping in decimal form (size: M)  
Vec< double >  symbols 
Corresponding modulation symbols (size: M)  
imat  S0 
Matrix where row k contains the constellation points with '0' in bit position k.  
imat  S1 
Matrix where row k contains the constellation points with '1' in bit position k.  
Related Functions  
(Note that these are not member functions.)  
typedef Modulator< double >  Modulator_1D 
Definition of 1D Modulator (with real symbols)  
typedef Modulator < std::complex< double > >  Modulator_2D 
Definition of 2D Modulator (with complex symbols)  
BPSK modulator with real symbols.
This is a special version of the PSK modulator with constellation points. The following bit to symbol mapping is used:
Beside hard demapping, this class can also perform soft demodulation, calculating the logMAP estimate of the individual bits. To use it properly the received symbols should be equal to:
where is the real or complex channel gain, is the transmitted constellation symbol, and is the AWGN of the channel (with variance ).
It is also assumed that the channel estimates are perfect when calculating the soft bits.
Definition at line 876 of file modulator.h.

virtual 
Soft demodulator for AWGN channel.
This function calculates the logMAP estimate assuming equally likely bits transmitted:
rx_symbols  The received noisy constellation symbols, 
N0  The spectral density of the AWGN noise, 
soft_bits  The soft bits calculated using the expression above 
method  The method used for demodulation (LOGMAP or APPROX) 
Modulator_1D/Modulator_2D
and
Modulator_ND
is not advised. Definition at line 342 of file modulator.cpp.
Referenced by demodulate_soft_bits().

virtual 
Soft demodulator for a known channel in AWGN.
This function calculates the logMAP estimate assuming equally likely bits transmitted:
rx_symbols  The received noisy constellation symbols, (complex but symbols in real part) 
channel  The channel coefficients, (complex) 
N0  The spectral density of the AWGN noise, 
soft_bits  The soft bits calculated using the expression above 
method  The method used for demodulation (LOGMAP or APPROX) 
Modulator_1D/Modulator_2D
and
Modulator_ND
is not advised. Definition at line 362 of file modulator.cpp.

inlinevirtualinherited 
Get the bitmap, which maps input bits into symbols.
The mapping is done as follows. An input bit sequence in decimal notation is used for indexing the bits2symbols
table. The indexing result denotes the symbol to be used from the symbols
table, e.g.:
Definition at line 117 of file modulator.h.

virtualinherited 
Soft demodulator for AWGN channels.
This function calculates the loglikelihood ratio (LLR) of the received signal from AWGN channels. Depending on the soft demodulation method chosen, either full logMAP calculation is performed (default method), according to the following equation:
or approximate, but faster calculation is performed.
The approximate method finds for each bit the closest constellation points that have zero and one in the corresponding position. Let denote the distance to the closest zero point and denote the distance to the closest one point for the corresponding bit respectively. The approximate algorithm then computes
This function can be used on channels where the channel gain .
When this function is to be used together with MAPbased turbo decoding algorithms then the channel reliability factor of the turbo decoder shall be set to 1. The output from this function can also be used by a Viterbi decoder using an AWGN based metric calculation function.
rx_symbols  The received noisy constellation symbols 
N0  The spectral density of the AWGN noise 
soft_bits  The soft bits calculated using the expression above 
method  The method used for demodulation (LOGMAP or APPROX) 
Modulator_ND
) instead, which is based on the QLLR (quantized) arithmetic and therefore is faster. Please note, however, that mixed use of Modulator_1D/Modulator_2D
and
Modulator_ND
is not advised.

virtualinherited 
Soft demodulator for fading channels.
This function calculates the loglikelihood ratio (LLR) of the received signal from fading channels. Depending on the soft demodulation method chosen, either full logMAP calculation is performed (default method), according to the following equation:
or approximate, but faster calculation is performed.
The approximate method finds for each bit the closest constellation points that have zero and one in the corresponding position. Let denote the distance to the closest zero point and denote the distance to the closest one point for the corresponding bit respectively. The approximate algorithm then computes
When this function is to be used together with MAPbased turbo decoding algorithms then the channel reliability factor of the turbo decoder shall be set to 1. The output from this function can also be used by a Viterbi decoder using an AWGN based metric calculation function.
rx_symbols  The received noisy constellation symbols 
channel  The channel values 
N0  The spectral density of the AWGN noise 
soft_bits  The soft bits calculated using the expression above 
method  The method used for demodulation (LOGMAP or APPROX) 
Modulator_1D/Modulator_2D
and
Modulator_ND
is not advised. Generated on Sat Jul 6 2013 10:54:32 for IT++ by Doxygen 1.8.2