root/doc/html/classitpp_1_1BPSK.html @ 353

Revision 353, 45.4 kB (checked in by smidl, 16 years ago)

doc

Line 
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
3<title>mixpp: itpp::BPSK Class Reference</title>
4<link href="tabs.css" rel="stylesheet" type="text/css">
5<link href="doxygen.css" rel="stylesheet" type="text/css">
6</head><body>
7<!-- Generated by Doxygen 1.5.8 -->
8<script type="text/javascript">
9<!--
10function changeDisplayState (e){
11  var num=this.id.replace(/[^[0-9]/g,'');
12  var button=this.firstChild;
13  var sectionDiv=document.getElementById('dynsection'+num);
14  if (sectionDiv.style.display=='none'||sectionDiv.style.display==''){
15    sectionDiv.style.display='block';
16    button.src='open.gif';
17  }else{
18    sectionDiv.style.display='none';
19    button.src='closed.gif';
20  }
21}
22function initDynSections(){
23  var divs=document.getElementsByTagName('div');
24  var sectionCounter=1;
25  for(var i=0;i<divs.length-1;i++){
26    if(divs[i].className=='dynheader'&&divs[i+1].className=='dynsection'){
27      var header=divs[i];
28      var section=divs[i+1];
29      var button=header.firstChild;
30      if (button!='IMG'){
31        divs[i].insertBefore(document.createTextNode(' '),divs[i].firstChild);
32        button=document.createElement('img');
33        divs[i].insertBefore(button,divs[i].firstChild);
34      }
35      header.style.cursor='pointer';
36      header.onclick=changeDisplayState;
37      header.id='dynheader'+sectionCounter;
38      button.src='closed.gif';
39      section.id='dynsection'+sectionCounter;
40      section.style.display='none';
41      section.style.marginLeft='14px';
42      sectionCounter++;
43    }
44  }
45}
46window.onload = initDynSections;
47-->
48</script>
49<div class="navigation" id="top">
50  <div class="tabs">
51    <ul>
52      <li><a href="main.html"><span>Main&nbsp;Page</span></a></li>
53      <li><a href="pages.html"><span>Related&nbsp;Pages</span></a></li>
54      <li><a href="modules.html"><span>Modules</span></a></li>
55      <li class="current"><a href="annotated.html"><span>Classes</span></a></li>
56      <li><a href="files.html"><span>Files</span></a></li>
57    </ul>
58  </div>
59  <div class="tabs">
60    <ul>
61      <li><a href="annotated.html"><span>Class&nbsp;List</span></a></li>
62      <li><a href="classes.html"><span>Class&nbsp;Index</span></a></li>
63      <li><a href="hierarchy.html"><span>Class&nbsp;Hierarchy</span></a></li>
64      <li><a href="functions.html"><span>Class&nbsp;Members</span></a></li>
65    </ul>
66  </div>
67  <div class="navpath"><b>itpp</b>::<a class="el" href="classitpp_1_1BPSK.html">BPSK</a>
68  </div>
69</div>
70<div class="contents">
71<h1>itpp::BPSK Class Reference<br>
72<small>
73[<a class="el" href="group__modulators.html">Digital Modulation</a>]</small>
74</h1><!-- doxytag: class="itpp::BPSK" --><!-- doxytag: inherits="Modulator&lt; double &gt;" --><a class="el" href="classitpp_1_1BPSK.html" title="BPSK modulator with real symbols.">BPSK</a> modulator with real symbols. 
75<a href="#_details">More...</a>
76<p>
77<code>#include &lt;<a class="el" href="modulator_8h-source.html">modulator.h</a>&gt;</code>
78<p>
79
80<p>
81<a href="classitpp_1_1BPSK-members.html">List of all members.</a><table border="0" cellpadding="0" cellspacing="0">
82<tr><td></td></tr>
83<tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr>
84<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="9aaf06588353a953f02b369f10a0bb76"></a><!-- doxytag: member="itpp::BPSK::BPSK" ref="9aaf06588353a953f02b369f10a0bb76" args="()" -->
85&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1BPSK.html#9aaf06588353a953f02b369f10a0bb76">BPSK</a> ()</td></tr>
86
87<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Constructor. <br></td></tr>
88<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="11d99b8c0dfef6e0017ac691507f02cf"></a><!-- doxytag: member="itpp::BPSK::~BPSK" ref="11d99b8c0dfef6e0017ac691507f02cf" args="()" -->
89virtual&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1BPSK.html#11d99b8c0dfef6e0017ac691507f02cf">~BPSK</a> ()</td></tr>
90
91<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Destructor. <br></td></tr>
92<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="ff002bcb92f62a0f01e76ce1b0ab543e"></a><!-- doxytag: member="itpp::BPSK::modulate_bits" ref="ff002bcb92f62a0f01e76ce1b0ab543e" args="(const bvec &amp;bits, vec &amp;output) const " -->
93void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1BPSK.html#ff002bcb92f62a0f01e76ce1b0ab543e">modulate_bits</a> (const bvec &amp;bits, vec &amp;output) const </td></tr>
94
95<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Modulate bits into <a class="el" href="classitpp_1_1BPSK.html" title="BPSK modulator with real symbols.">BPSK</a> symbols in complex domain. <br></td></tr>
96<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="6565fd14cd36ca02192e0b9bf232e99c"></a><!-- doxytag: member="itpp::BPSK::modulate_bits" ref="6565fd14cd36ca02192e0b9bf232e99c" args="(const bvec &amp;bits) const " -->
97vec&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1BPSK.html#6565fd14cd36ca02192e0b9bf232e99c">modulate_bits</a> (const bvec &amp;bits) const </td></tr>
98
99<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Modulate bits into <a class="el" href="classitpp_1_1BPSK.html" title="BPSK modulator with real symbols.">BPSK</a> symbols in complex domain. <br></td></tr>
100<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="86ec97762f354d8020fcab199faa6e5e"></a><!-- doxytag: member="itpp::BPSK::demodulate_bits" ref="86ec97762f354d8020fcab199faa6e5e" args="(const vec &amp;signal, bvec &amp;output) const " -->
101void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1BPSK.html#86ec97762f354d8020fcab199faa6e5e">demodulate_bits</a> (const vec &amp;signal, bvec &amp;output) const </td></tr>
102
103<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Demodulate noisy <a class="el" href="classitpp_1_1BPSK.html" title="BPSK modulator with real symbols.">BPSK</a> symbols in complex domain into bits. <br></td></tr>
104<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="392b793ce0191d3f4078906d95b2f3c2"></a><!-- doxytag: member="itpp::BPSK::demodulate_bits" ref="392b793ce0191d3f4078906d95b2f3c2" args="(const vec &amp;signal) const " -->
105bvec&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1BPSK.html#392b793ce0191d3f4078906d95b2f3c2">demodulate_bits</a> (const vec &amp;signal) const </td></tr>
106
107<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Demodulate noisy <a class="el" href="classitpp_1_1BPSK.html" title="BPSK modulator with real symbols.">BPSK</a> symbols in complex domain into bits. <br></td></tr>
108<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1BPSK.html#384c489595bc85fada37e5138e1e2365">demodulate_soft_bits</a> (const vec &amp;rx_symbols, double N0, vec &amp;soft_bits, <a class="el" href="group__modulators.html#g5128af4688e1a1caa84e1fabf051faa7">Soft_Method</a> method=LOGMAP) const </td></tr>
109
110<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Soft demodulator for AWGN channel.  <a href="#384c489595bc85fada37e5138e1e2365"></a><br></td></tr>
111<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="3bc9f7b983564fbe89e02cf09c67ef67"></a><!-- doxytag: member="itpp::BPSK::demodulate_soft_bits" ref="3bc9f7b983564fbe89e02cf09c67ef67" args="(const vec &amp;rx_symbols, double N0, Soft_Method method=LOGMAP) const " -->
112vec&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1BPSK.html#3bc9f7b983564fbe89e02cf09c67ef67">demodulate_soft_bits</a> (const vec &amp;rx_symbols, double N0, <a class="el" href="group__modulators.html#g5128af4688e1a1caa84e1fabf051faa7">Soft_Method</a> method=LOGMAP) const </td></tr>
113
114<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Soft demodulator for AWGN channel. <br></td></tr>
115<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1BPSK.html#f21c6943f2a7e7f6fd14bd82df3893fe">demodulate_soft_bits</a> (const vec &amp;rx_symbols, const vec &amp;channel, double N0, vec &amp;soft_bits, <a class="el" href="group__modulators.html#g5128af4688e1a1caa84e1fabf051faa7">Soft_Method</a> method=LOGMAP) const </td></tr>
116
117<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Soft demodulator for a known channel in AWGN.  <a href="#f21c6943f2a7e7f6fd14bd82df3893fe"></a><br></td></tr>
118<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="d4ca1ddd90aab607d9951e8ca0e559da"></a><!-- doxytag: member="itpp::BPSK::demodulate_soft_bits" ref="d4ca1ddd90aab607d9951e8ca0e559da" args="(const vec &amp;rx_symbols, const vec &amp;channel, double N0, Soft_Method method=LOGMAP) const " -->
119vec&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1BPSK.html#d4ca1ddd90aab607d9951e8ca0e559da">demodulate_soft_bits</a> (const vec &amp;rx_symbols, const vec &amp;channel, double N0, <a class="el" href="group__modulators.html#g5128af4688e1a1caa84e1fabf051faa7">Soft_Method</a> method=LOGMAP) const </td></tr>
120
121<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Soft demodulator for a known channel in AWGN. <br></td></tr>
122<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="b9722a6826869c6d6e15a9835d76239b"></a><!-- doxytag: member="itpp::BPSK::set" ref="b9722a6826869c6d6e15a9835d76239b" args="(const Vec&lt; double &gt; &amp;symbols, const ivec &amp;bits2symbols)" -->
123virtual void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator.html#b9722a6826869c6d6e15a9835d76239b">set</a> (const <a class="el" href="classitpp_1_1Vec.html">Vec</a>&lt; double &gt; &amp;<a class="el" href="classitpp_1_1Modulator.html#3069840e9e7a44180615fb772cf9ae42">symbols</a>, const ivec &amp;<a class="el" href="classitpp_1_1Modulator.html#3ca26614189cb7a66da369bf0c4b9070">bits2symbols</a>)</td></tr>
124
125<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Set the constellation to use in the modulator. <br></td></tr>
126<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="6e7cfa06570e2a1de515be5222a53a83"></a><!-- doxytag: member="itpp::BPSK::bits_per_symbol" ref="6e7cfa06570e2a1de515be5222a53a83" args="() const" -->
127virtual int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator.html#6e7cfa06570e2a1de515be5222a53a83">bits_per_symbol</a> () const</td></tr>
128
129<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns number of bits per symbol. <br></td></tr>
130<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="28b1c28bf8f4596e4d5149f1f3c8cd76"></a><!-- doxytag: member="itpp::BPSK::get_symbols" ref="28b1c28bf8f4596e4d5149f1f3c8cd76" args="() const" -->
131virtual <a class="el" href="classitpp_1_1Vec.html">Vec</a>&lt; double &gt;&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator.html#28b1c28bf8f4596e4d5149f1f3c8cd76">get_symbols</a> () const</td></tr>
132
133<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Get the symbol values used in the modulator. <br></td></tr>
134<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual ivec&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator.html#a8186f0e837fd3d440a6acb7a0225d35">get_bits2symbols</a> () const</td></tr>
135
136<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Get the bitmap, which maps input bits into symbols.  <a href="#a8186f0e837fd3d440a6acb7a0225d35"></a><br></td></tr>
137<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="4f7bde9d3bfa9e39c06017534e3f6647"></a><!-- doxytag: member="itpp::BPSK::modulate" ref="4f7bde9d3bfa9e39c06017534e3f6647" args="(const ivec &amp;symbolnumbers, Vec&lt; double &gt; &amp;output) const" -->
138virtual void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator.html#4f7bde9d3bfa9e39c06017534e3f6647">modulate</a> (const ivec &amp;symbolnumbers, <a class="el" href="classitpp_1_1Vec.html">Vec</a>&lt; double &gt; &amp;output) const</td></tr>
139
140<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Modulation of symbols. <br></td></tr>
141<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="e0cb2673987e110920b519c139cdebe1"></a><!-- doxytag: member="itpp::BPSK::modulate" ref="e0cb2673987e110920b519c139cdebe1" args="(const ivec &amp;symbolnumbers) const" -->
142virtual <a class="el" href="classitpp_1_1Vec.html">Vec</a>&lt; double &gt;&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator.html#e0cb2673987e110920b519c139cdebe1">modulate</a> (const ivec &amp;symbolnumbers) const</td></tr>
143
144<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Modulation of symbols. <br></td></tr>
145<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="845b5fbf4dad59edd3772627250623a1"></a><!-- doxytag: member="itpp::BPSK::demodulate" ref="845b5fbf4dad59edd3772627250623a1" args="(const Vec&lt; double &gt; &amp;signal, ivec &amp;output) const" -->
146virtual void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator.html#845b5fbf4dad59edd3772627250623a1">demodulate</a> (const <a class="el" href="classitpp_1_1Vec.html">Vec</a>&lt; double &gt; &amp;signal, ivec &amp;output) const</td></tr>
147
148<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Demodulation of symbols. <br></td></tr>
149<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="7f2c15efa18d1cb46b8c97723c11ec9d"></a><!-- doxytag: member="itpp::BPSK::demodulate" ref="7f2c15efa18d1cb46b8c97723c11ec9d" args="(const Vec&lt; double &gt; &amp;signal) const" -->
150virtual ivec&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator.html#7f2c15efa18d1cb46b8c97723c11ec9d">demodulate</a> (const <a class="el" href="classitpp_1_1Vec.html">Vec</a>&lt; double &gt; &amp;signal) const</td></tr>
151
152<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Demodulation of symbols. <br></td></tr>
153<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="53826bf7e0ec83b99592235b0c2f6235"></a><!-- doxytag: member="itpp::BPSK::modulate_bits" ref="53826bf7e0ec83b99592235b0c2f6235" args="(const bvec &amp;bits, Vec&lt; double &gt; &amp;output) const" -->
154virtual void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator.html#53826bf7e0ec83b99592235b0c2f6235">modulate_bits</a> (const bvec &amp;bits, <a class="el" href="classitpp_1_1Vec.html">Vec</a>&lt; double &gt; &amp;output) const</td></tr>
155
156<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Modulation of bits. <br></td></tr>
157<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="4d03bbe8bd467898f149d5f134f6f120"></a><!-- doxytag: member="itpp::BPSK::demodulate_bits" ref="4d03bbe8bd467898f149d5f134f6f120" args="(const Vec&lt; double &gt; &amp;signal, bvec &amp;bits) const" -->
158virtual void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator.html#4d03bbe8bd467898f149d5f134f6f120">demodulate_bits</a> (const <a class="el" href="classitpp_1_1Vec.html">Vec</a>&lt; double &gt; &amp;signal, bvec &amp;bits) const</td></tr>
159
160<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Hard demodulation of bits. <br></td></tr>
161<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="9e3432dad687ac0ee102c208e34920f8"></a><!-- doxytag: member="itpp::BPSK::demodulate_bits" ref="9e3432dad687ac0ee102c208e34920f8" args="(const Vec&lt; double &gt; &amp;signal) const" -->
162virtual bvec&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator.html#9e3432dad687ac0ee102c208e34920f8">demodulate_bits</a> (const <a class="el" href="classitpp_1_1Vec.html">Vec</a>&lt; double &gt; &amp;signal) const</td></tr>
163
164<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Hard demodulation of bits. <br></td></tr>
165<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator.html#9beffaf8f69378f9c20a85f3023bd9af">demodulate_soft_bits</a> (const <a class="el" href="classitpp_1_1Vec.html">Vec</a>&lt; double &gt; &amp;rx_symbols, double N0, vec &amp;soft_bits, <a class="el" href="group__modulators.html#g5128af4688e1a1caa84e1fabf051faa7">Soft_Method</a> method=LOGMAP) const</td></tr>
166
167<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Soft demodulator for AWGN channels.  <a href="#9beffaf8f69378f9c20a85f3023bd9af"></a><br></td></tr>
168<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="a9cba88e460e11775fb72d21b543c375"></a><!-- doxytag: member="itpp::BPSK::demodulate_soft_bits" ref="a9cba88e460e11775fb72d21b543c375" args="(const Vec&lt; double &gt; &amp;rx_symbols, double N0, Soft_Method method=LOGMAP) const" -->
169virtual vec&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator.html#a9cba88e460e11775fb72d21b543c375">demodulate_soft_bits</a> (const <a class="el" href="classitpp_1_1Vec.html">Vec</a>&lt; double &gt; &amp;rx_symbols, double N0, <a class="el" href="group__modulators.html#g5128af4688e1a1caa84e1fabf051faa7">Soft_Method</a> method=LOGMAP) const</td></tr>
170
171<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Soft demodulator for AWGN channels. <br></td></tr>
172<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator.html#bd014d868b4f883712f92a7130401714">demodulate_soft_bits</a> (const <a class="el" href="classitpp_1_1Vec.html">Vec</a>&lt; double &gt; &amp;rx_symbols, const <a class="el" href="classitpp_1_1Vec.html">Vec</a>&lt; double &gt; &amp;channel, double N0, vec &amp;soft_bits, <a class="el" href="group__modulators.html#g5128af4688e1a1caa84e1fabf051faa7">Soft_Method</a> method=LOGMAP) const</td></tr>
173
174<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Soft demodulator for fading channels.  <a href="#bd014d868b4f883712f92a7130401714"></a><br></td></tr>
175<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="e40b7afd0d38d2d86b561b9dff6f55fd"></a><!-- doxytag: member="itpp::BPSK::demodulate_soft_bits" ref="e40b7afd0d38d2d86b561b9dff6f55fd" args="(const Vec&lt; double &gt; &amp;rx_symbols, const Vec&lt; double &gt; &amp;channel, double N0, Soft_Method method=LOGMAP) const" -->
176virtual vec&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator.html#e40b7afd0d38d2d86b561b9dff6f55fd">demodulate_soft_bits</a> (const <a class="el" href="classitpp_1_1Vec.html">Vec</a>&lt; double &gt; &amp;rx_symbols, const <a class="el" href="classitpp_1_1Vec.html">Vec</a>&lt; double &gt; &amp;channel, double N0, <a class="el" href="group__modulators.html#g5128af4688e1a1caa84e1fabf051faa7">Soft_Method</a> method=LOGMAP) const</td></tr>
177
178<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Soft demodulator for fading channels. <br></td></tr>
179<tr><td colspan="2"><br><h2>Protected Member Functions</h2></td></tr>
180<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="bb3e654a3fb6d127ee8d266677689233"></a><!-- doxytag: member="itpp::BPSK::calculate_softbit_matrices" ref="bb3e654a3fb6d127ee8d266677689233" args="()" -->
181void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator.html#bb3e654a3fb6d127ee8d266677689233">calculate_softbit_matrices</a> ()</td></tr>
182
183<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">This function calculates the soft bit mapping matrices S0 and S1. <br></td></tr>
184<tr><td colspan="2"><br><h2>Protected Attributes</h2></td></tr>
185<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="552cd7add3e998eca485d0ea39808e0d"></a><!-- doxytag: member="itpp::BPSK::setup_done" ref="552cd7add3e998eca485d0ea39808e0d" args="" -->
186bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator.html#552cd7add3e998eca485d0ea39808e0d">setup_done</a></td></tr>
187
188<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Setup indicator. <br></td></tr>
189<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="3656edc52486e0551b734b32ab67d3b6"></a><!-- doxytag: member="itpp::BPSK::k" ref="3656edc52486e0551b734b32ab67d3b6" args="" -->
190int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator.html#3656edc52486e0551b734b32ab67d3b6">k</a></td></tr>
191
192<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Number of bits per modulation symbol. <br></td></tr>
193<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="a434960c7ff9e5356d832aa53b46930b"></a><!-- doxytag: member="itpp::BPSK::M" ref="a434960c7ff9e5356d832aa53b46930b" args="" -->
194int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator.html#a434960c7ff9e5356d832aa53b46930b">M</a></td></tr>
195
196<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Number of modulation symbols. <br></td></tr>
197<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="1b1a9a706c0736c51966703bea58cf48"></a><!-- doxytag: member="itpp::BPSK::bitmap" ref="1b1a9a706c0736c51966703bea58cf48" args="" -->
198<a class="el" href="mat_8h.html#f90acd1af41bf2d1d8a4bb23662fff69">bmat</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator.html#1b1a9a706c0736c51966703bea58cf48">bitmap</a></td></tr>
199
200<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Bit to symbol mapping table (size: M x k). <br></td></tr>
201<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="3ca26614189cb7a66da369bf0c4b9070"></a><!-- doxytag: member="itpp::BPSK::bits2symbols" ref="3ca26614189cb7a66da369bf0c4b9070" args="" -->
202ivec&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator.html#3ca26614189cb7a66da369bf0c4b9070">bits2symbols</a></td></tr>
203
204<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Bit to symbol mapping in decimal form (size: M). <br></td></tr>
205<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="3069840e9e7a44180615fb772cf9ae42"></a><!-- doxytag: member="itpp::BPSK::symbols" ref="3069840e9e7a44180615fb772cf9ae42" args="" -->
206<a class="el" href="classitpp_1_1Vec.html">Vec</a>&lt; double &gt;&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator.html#3069840e9e7a44180615fb772cf9ae42">symbols</a></td></tr>
207
208<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Corresponding modulation symbols (size: M). <br></td></tr>
209<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="c19c8fe07e95e4eb80e832a633b7c422"></a><!-- doxytag: member="itpp::BPSK::S0" ref="c19c8fe07e95e4eb80e832a633b7c422" args="" -->
210imat&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator.html#c19c8fe07e95e4eb80e832a633b7c422">S0</a></td></tr>
211
212<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Matrix where row k contains the constellation points with '0' in bit position k. <br></td></tr>
213<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="9d4c223ffd96fdc5b26ba5c44956998b"></a><!-- doxytag: member="itpp::BPSK::S1" ref="9d4c223ffd96fdc5b26ba5c44956998b" args="" -->
214imat&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator.html#9d4c223ffd96fdc5b26ba5c44956998b">S1</a></td></tr>
215
216<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Matrix where row k contains the constellation points with '1' in bit position k. <br></td></tr>
217<tr><td colspan="2"><br><h2>Related Functions</h2></td></tr>
218<tr><td colspan="2">(Note that these are not member functions.) <br><br></td></tr>
219<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="d47d1377dffb2aed9f21f8f976e80a0a"></a><!-- doxytag: member="itpp::BPSK::Modulator_1D" ref="d47d1377dffb2aed9f21f8f976e80a0a" args="" -->
220typedef <a class="el" href="classitpp_1_1Modulator.html">Modulator</a>&lt; double &gt;&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator.html#d47d1377dffb2aed9f21f8f976e80a0a">Modulator_1D</a></td></tr>
221
222<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Definition of 1D Modulator (with real symbols). <br></td></tr>
223<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="97dc4e87ae4fa63c4e7dbbeac0ab00b0"></a><!-- doxytag: member="itpp::BPSK::Modulator_2D" ref="97dc4e87ae4fa63c4e7dbbeac0ab00b0" args="" -->
224typedef <a class="el" href="classitpp_1_1Modulator.html">Modulator</a><br class="typebreak">
225&lt; std::complex&lt; double &gt; &gt;&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator.html#97dc4e87ae4fa63c4e7dbbeac0ab00b0">Modulator_2D</a></td></tr>
226
227<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Definition of 2D Modulator (with complex symbols). <br></td></tr>
228</table>
229<hr><a name="_details"></a><h2>Detailed Description</h2>
230<a class="el" href="classitpp_1_1BPSK.html" title="BPSK modulator with real symbols.">BPSK</a> modulator with real symbols.
231<p>
232This is a special version of the <a class="el" href="classitpp_1_1PSK.html" title="M-ary PSK modulator.">PSK</a> modulator with <img class="formulaInl" alt="$M = 2$" src="form_262.png"> constellation points. The following bit to symbol mapping is used:<ul>
233<li><img class="formulaInl" alt="$0 \rightarrow 1$" src="form_265.png"></li><li><img class="formulaInl" alt="$1 \rightarrow -1$" src="form_266.png">.</li></ul>
234<p>
235Beside hard demapping, this class can also perform soft demodulation, calculating the log-MAP estimate of the individual bits. To use it properly the received symbols should be equal to: <p class="formulaDsp">
236<img class="formulaDsp" alt="\[r_k = c_k s_k + n_k,\]" src="form_252.png">
237<p>
238 where <img class="formulaInl" alt="$c_k$" src="form_253.png"> is the real or complex channel gain, <img class="formulaInl" alt="$s_k$" src="form_254.png"> is the transmitted constellation symbol, and <img class="formulaInl" alt="$n_k$" src="form_255.png"> is the AWGN of the channel (with variance <img class="formulaInl" alt="$N_0$" src="form_233.png">).<p>
239It is also assumed that the channel estimates are perfect when calculating the soft bits.<p>
240<dl class="note" compact><dt><b>Note:</b></dt><dd>This class uses real values for representing symbols. There is a similar class named <a class="el" href="classitpp_1_1BPSK__c.html" title="BPSK modulator with complex symbols.">BPSK_c</a>, which uses complex values for symbols and therefore is compatible with other <a class="el" href="classitpp_1_1PSK.html" title="M-ary PSK modulator.">PSK</a> and <a class="el" href="classitpp_1_1QAM.html" title="M-ary QAM modulator with square lattice.">QAM</a> based modulators. </dd></dl>
241<hr><h2>Member Function Documentation</h2>
242<a class="anchor" name="bd014d868b4f883712f92a7130401714"></a><!-- doxytag: member="itpp::BPSK::demodulate_soft_bits" ref="bd014d868b4f883712f92a7130401714" args="(const Vec&lt; double &gt; &amp;rx_symbols, const Vec&lt; double &gt; &amp;channel, double N0, vec &amp;soft_bits, Soft_Method method=LOGMAP) const" -->
243<div class="memitem">
244<div class="memproto">
245      <table class="memname">
246        <tr>
247          <td class="memname">virtual void <a class="el" href="classitpp_1_1Modulator.html">itpp::Modulator</a>&lt; double  &gt;::demodulate_soft_bits           </td>
248          <td>(</td>
249          <td class="paramtype">const <a class="el" href="classitpp_1_1Vec.html">Vec</a>&lt; double  &gt; &amp;&nbsp;</td>
250          <td class="paramname"> <em>rx_symbols</em>, </td>
251        </tr>
252        <tr>
253          <td class="paramkey"></td>
254          <td></td>
255          <td class="paramtype">const <a class="el" href="classitpp_1_1Vec.html">Vec</a>&lt; double  &gt; &amp;&nbsp;</td>
256          <td class="paramname"> <em>channel</em>, </td>
257        </tr>
258        <tr>
259          <td class="paramkey"></td>
260          <td></td>
261          <td class="paramtype">double&nbsp;</td>
262          <td class="paramname"> <em>N0</em>, </td>
263        </tr>
264        <tr>
265          <td class="paramkey"></td>
266          <td></td>
267          <td class="paramtype">vec &amp;&nbsp;</td>
268          <td class="paramname"> <em>soft_bits</em>, </td>
269        </tr>
270        <tr>
271          <td class="paramkey"></td>
272          <td></td>
273          <td class="paramtype"><a class="el" href="group__modulators.html#g5128af4688e1a1caa84e1fabf051faa7">Soft_Method</a>&nbsp;</td>
274          <td class="paramname"> <em>method</em> = <code>LOGMAP</code></td><td>&nbsp;</td>
275        </tr>
276        <tr>
277          <td></td>
278          <td>)</td>
279          <td></td><td></td><td> const<code> [virtual, inherited]</code></td>
280        </tr>
281      </table>
282</div>
283<div class="memdoc">
284
285<p>
286Soft demodulator for fading channels.
287<p>
288This function calculates the log-likelihood ratio (LLR) of the received signal from fading channels. Depending on the soft demodulation method chosen, either full log-MAP calculation is performed (default method), according to the following equation: <p class="formulaDsp">
289<img class="formulaDsp" alt="\[\log \left( \frac{P(b_i=0|r)}{P(b_i=1|r)} \right) = \log \left( \frac{\sum_{s_i \in S_0} \exp \left( -\frac{|r_k - c_k s_i|^2}{N_0} \right)} {\sum_{s_i \in S_1} \exp \left( -\frac{|r_k - c_k s_i|^2}{N_0} \right)} \right) \]" src="form_275.png">
290<p>
291 or approximate, but faster calculation is performed.<p>
292The approximate method finds for each bit the closest constellation points that have zero and one in the corresponding position. Let <img class="formulaInl" alt="$d_0 = |r_k - c_k s_0|$" src="form_276.png"> denote the distance to the closest zero point and <img class="formulaInl" alt="$d_1 = |r_k - c_k s_1|$" src="form_277.png"> denote the distance to the closest one point for the corresponding bit respectively. The approximate algorithm then computes <p class="formulaDsp">
293<img class="formulaDsp" alt="\[\frac{d_1^2 - d_0^2}{N_0}\]" src="form_272.png">
294<p>
295<p>
296When this function is to be used together with MAP-based turbo decoding algorithms then the channel reliability factor <img class="formulaInl" alt="$L_c$" src="form_274.png"> 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.<p>
297<dl compact><dt><b>Parameters:</b></dt><dd>
298  <table border="0" cellspacing="2" cellpadding="0">
299    <tr><td valign="top"></td><td valign="top"><em>rx_symbols</em>&nbsp;</td><td>The received noisy constellation symbols <img class="formulaInl" alt="$r_k$" src="form_278.png"> </td></tr>
300    <tr><td valign="top"></td><td valign="top"><em>channel</em>&nbsp;</td><td>The channel values <img class="formulaInl" alt="$c_k$" src="form_253.png"> </td></tr>
301    <tr><td valign="top"></td><td valign="top"><em>N0</em>&nbsp;</td><td>The spectral density of the AWGN noise </td></tr>
302    <tr><td valign="top"></td><td valign="top"><em>soft_bits</em>&nbsp;</td><td>The soft bits calculated using the expression above </td></tr>
303    <tr><td valign="top"></td><td valign="top"><em>method</em>&nbsp;</td><td>The method used for demodulation (LOGMAP or APPROX)</td></tr>
304  </table>
305</dl>
306<dl class="note" compact><dt><b>Note:</b></dt><dd>For soft demodulation it is suggested to use the N-dimensional modulator (Modulator_ND) instead, which is based on the QLLR (quantized) arithmetic and therefore is faster. Please note, however, that mixed use of <code>Modulator_1D/<code>Modulator_2D</code> and</code> <code>Modulator_ND</code> is not advised. </dd></dl>
307
308</div>
309</div><p>
310<a class="anchor" name="9beffaf8f69378f9c20a85f3023bd9af"></a><!-- doxytag: member="itpp::BPSK::demodulate_soft_bits" ref="9beffaf8f69378f9c20a85f3023bd9af" args="(const Vec&lt; double &gt; &amp;rx_symbols, double N0, vec &amp;soft_bits, Soft_Method method=LOGMAP) const" -->
311<div class="memitem">
312<div class="memproto">
313      <table class="memname">
314        <tr>
315          <td class="memname">virtual void <a class="el" href="classitpp_1_1Modulator.html">itpp::Modulator</a>&lt; double  &gt;::demodulate_soft_bits           </td>
316          <td>(</td>
317          <td class="paramtype">const <a class="el" href="classitpp_1_1Vec.html">Vec</a>&lt; double  &gt; &amp;&nbsp;</td>
318          <td class="paramname"> <em>rx_symbols</em>, </td>
319        </tr>
320        <tr>
321          <td class="paramkey"></td>
322          <td></td>
323          <td class="paramtype">double&nbsp;</td>
324          <td class="paramname"> <em>N0</em>, </td>
325        </tr>
326        <tr>
327          <td class="paramkey"></td>
328          <td></td>
329          <td class="paramtype">vec &amp;&nbsp;</td>
330          <td class="paramname"> <em>soft_bits</em>, </td>
331        </tr>
332        <tr>
333          <td class="paramkey"></td>
334          <td></td>
335          <td class="paramtype"><a class="el" href="group__modulators.html#g5128af4688e1a1caa84e1fabf051faa7">Soft_Method</a>&nbsp;</td>
336          <td class="paramname"> <em>method</em> = <code>LOGMAP</code></td><td>&nbsp;</td>
337        </tr>
338        <tr>
339          <td></td>
340          <td>)</td>
341          <td></td><td></td><td> const<code> [virtual, inherited]</code></td>
342        </tr>
343      </table>
344</div>
345<div class="memdoc">
346
347<p>
348Soft demodulator for AWGN channels.
349<p>
350This function calculates the log-likelihood ratio (LLR) of the received signal from AWGN channels. Depending on the soft demodulation method chosen, either full log-MAP calculation is performed (default method), according to the following equation: <p class="formulaDsp">
351<img class="formulaDsp" alt="\[\log \left( \frac{P(b_i=0|r)}{P(b_i=1|r)} \right) = \log \left( \frac{\sum_{s_i \in S_0} \exp \left( -\frac{|r_k - s_i|^2}{N_0} \right)} {\sum_{s_i \in S_1} \exp \left( -\frac{|r_k - s_i|^2}{N_0} \right)} \right) \]" src="form_269.png">
352<p>
353 or approximate, but faster calculation is performed.<p>
354The approximate method finds for each bit the closest constellation points that have zero and one in the corresponding position. Let <img class="formulaInl" alt="$d_0 = |r_k - s_0|$" src="form_270.png"> denote the distance to the closest zero point and <img class="formulaInl" alt="$d_1 = |r_k - s_1|$" src="form_271.png"> denote the distance to the closest one point for the corresponding bit respectively. The approximate algorithm then computes <p class="formulaDsp">
355<img class="formulaDsp" alt="\[\frac{d_1^2 - d_0^2}{N_0}\]" src="form_272.png">
356<p>
357<p>
358This function can be used on channels where the channel gain <img class="formulaInl" alt="$c_k = 1$" src="form_273.png">.<p>
359When this function is to be used together with MAP-based turbo decoding algorithms then the channel reliability factor <img class="formulaInl" alt="$L_c$" src="form_274.png"> 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.<p>
360<dl compact><dt><b>Parameters:</b></dt><dd>
361  <table border="0" cellspacing="2" cellpadding="0">
362    <tr><td valign="top"></td><td valign="top"><em>rx_symbols</em>&nbsp;</td><td>The received noisy constellation symbols </td></tr>
363    <tr><td valign="top"></td><td valign="top"><em>N0</em>&nbsp;</td><td>The spectral density of the AWGN noise </td></tr>
364    <tr><td valign="top"></td><td valign="top"><em>soft_bits</em>&nbsp;</td><td>The soft bits calculated using the expression above </td></tr>
365    <tr><td valign="top"></td><td valign="top"><em>method</em>&nbsp;</td><td>The method used for demodulation (LOGMAP or APPROX)</td></tr>
366  </table>
367</dl>
368<dl class="note" compact><dt><b>Note:</b></dt><dd>For soft demodulation it is suggested to use the N-dimensional modulator (<code>Modulator_ND</code>) instead, which is based on the QLLR (quantized) arithmetic and therefore is faster. Please note, however, that mixed use of <code>Modulator_1D/<code>Modulator_2D</code> and</code> <code>Modulator_ND</code> is not advised. </dd></dl>
369
370</div>
371</div><p>
372<a class="anchor" name="f21c6943f2a7e7f6fd14bd82df3893fe"></a><!-- doxytag: member="itpp::BPSK::demodulate_soft_bits" ref="f21c6943f2a7e7f6fd14bd82df3893fe" args="(const vec &amp;rx_symbols, const vec &amp;channel, double N0, vec &amp;soft_bits, Soft_Method method=LOGMAP) const " -->
373<div class="memitem">
374<div class="memproto">
375      <table class="memname">
376        <tr>
377          <td class="memname">void itpp::BPSK::demodulate_soft_bits           </td>
378          <td>(</td>
379          <td class="paramtype">const vec &amp;&nbsp;</td>
380          <td class="paramname"> <em>rx_symbols</em>, </td>
381        </tr>
382        <tr>
383          <td class="paramkey"></td>
384          <td></td>
385          <td class="paramtype">const vec &amp;&nbsp;</td>
386          <td class="paramname"> <em>channel</em>, </td>
387        </tr>
388        <tr>
389          <td class="paramkey"></td>
390          <td></td>
391          <td class="paramtype">double&nbsp;</td>
392          <td class="paramname"> <em>N0</em>, </td>
393        </tr>
394        <tr>
395          <td class="paramkey"></td>
396          <td></td>
397          <td class="paramtype">vec &amp;&nbsp;</td>
398          <td class="paramname"> <em>soft_bits</em>, </td>
399        </tr>
400        <tr>
401          <td class="paramkey"></td>
402          <td></td>
403          <td class="paramtype"><a class="el" href="group__modulators.html#g5128af4688e1a1caa84e1fabf051faa7">Soft_Method</a>&nbsp;</td>
404          <td class="paramname"> <em>method</em> = <code>LOGMAP</code></td><td>&nbsp;</td>
405        </tr>
406        <tr>
407          <td></td>
408          <td>)</td>
409          <td></td><td></td><td> const<code> [virtual]</code></td>
410        </tr>
411      </table>
412</div>
413<div class="memdoc">
414
415<p>
416Soft demodulator for a known channel in AWGN.
417<p>
418This function calculates the log-MAP estimate assuming equally likely bits transmitted: <p class="formulaDsp">
419<img class="formulaDsp" alt="\[\log \left( \frac{P(b=0|r)}{P(b=1|r)} \right) = \frac{4 \Re\{r c^{*}\}}{N_0}\]" src="form_286.png">
420<p>
421<p>
422<dl compact><dt><b>Parameters:</b></dt><dd>
423  <table border="0" cellspacing="2" cellpadding="0">
424    <tr><td valign="top"></td><td valign="top"><em>rx_symbols</em>&nbsp;</td><td>The received noisy constellation symbols, <img class="formulaInl" alt="$r$" src="form_281.png"> (complex but symbols in real part) </td></tr>
425    <tr><td valign="top"></td><td valign="top"><em>channel</em>&nbsp;</td><td>The channel coefficients, <img class="formulaInl" alt="$c$" src="form_284.png"> (complex) </td></tr>
426    <tr><td valign="top"></td><td valign="top"><em>N0</em>&nbsp;</td><td>The spectral density of the AWGN noise, <img class="formulaInl" alt="$n$" src="form_61.png"> </td></tr>
427    <tr><td valign="top"></td><td valign="top"><em>soft_bits</em>&nbsp;</td><td>The soft bits calculated using the expression above </td></tr>
428    <tr><td valign="top"></td><td valign="top"><em>method</em>&nbsp;</td><td>The method used for demodulation (LOGMAP or APPROX)</td></tr>
429  </table>
430</dl>
431<dl class="note" compact><dt><b>Note:</b></dt><dd>For soft demodulation it is suggested to use the N-dimensional modulator (<a class="el" href="classitpp_1_1Modulator__ND.html" title="Base class for an N-dimensional (ND) vector (MIMO) modulator.">Modulator_ND</a>) instead, which is based on the QLLR (quantized) arithmetic and therefore is faster. Please note, however, that mixed use of <code>Modulator_1D/<code>Modulator_2D</code> and</code> <code><a class="el" href="classitpp_1_1Modulator__ND.html" title="Base class for an N-dimensional (ND) vector (MIMO) modulator.">Modulator_ND</a></code> is not advised. </dd></dl>
432
433</div>
434</div><p>
435<a class="anchor" name="384c489595bc85fada37e5138e1e2365"></a><!-- doxytag: member="itpp::BPSK::demodulate_soft_bits" ref="384c489595bc85fada37e5138e1e2365" args="(const vec &amp;rx_symbols, double N0, vec &amp;soft_bits, Soft_Method method=LOGMAP) const " -->
436<div class="memitem">
437<div class="memproto">
438      <table class="memname">
439        <tr>
440          <td class="memname">void itpp::BPSK::demodulate_soft_bits           </td>
441          <td>(</td>
442          <td class="paramtype">const vec &amp;&nbsp;</td>
443          <td class="paramname"> <em>rx_symbols</em>, </td>
444        </tr>
445        <tr>
446          <td class="paramkey"></td>
447          <td></td>
448          <td class="paramtype">double&nbsp;</td>
449          <td class="paramname"> <em>N0</em>, </td>
450        </tr>
451        <tr>
452          <td class="paramkey"></td>
453          <td></td>
454          <td class="paramtype">vec &amp;&nbsp;</td>
455          <td class="paramname"> <em>soft_bits</em>, </td>
456        </tr>
457        <tr>
458          <td class="paramkey"></td>
459          <td></td>
460          <td class="paramtype"><a class="el" href="group__modulators.html#g5128af4688e1a1caa84e1fabf051faa7">Soft_Method</a>&nbsp;</td>
461          <td class="paramname"> <em>method</em> = <code>LOGMAP</code></td><td>&nbsp;</td>
462        </tr>
463        <tr>
464          <td></td>
465          <td>)</td>
466          <td></td><td></td><td> const<code> [virtual]</code></td>
467        </tr>
468      </table>
469</div>
470<div class="memdoc">
471
472<p>
473Soft demodulator for AWGN channel.
474<p>
475This function calculates the log-MAP estimate assuming equally likely bits transmitted: <p class="formulaDsp">
476<img class="formulaDsp" alt="\[\log \left( \frac{P(b=0|r)}{P(b=1|r)} \right) = \frac{4 r}{N_0}\]" src="form_287.png">
477<p>
478<p>
479<dl compact><dt><b>Parameters:</b></dt><dd>
480  <table border="0" cellspacing="2" cellpadding="0">
481    <tr><td valign="top"></td><td valign="top"><em>rx_symbols</em>&nbsp;</td><td>The received noisy constellation symbols, <img class="formulaInl" alt="$r$" src="form_281.png"> </td></tr>
482    <tr><td valign="top"></td><td valign="top"><em>N0</em>&nbsp;</td><td>The spectral density of the AWGN noise, <img class="formulaInl" alt="$n$" src="form_61.png"> </td></tr>
483    <tr><td valign="top"></td><td valign="top"><em>soft_bits</em>&nbsp;</td><td>The soft bits calculated using the expression above </td></tr>
484    <tr><td valign="top"></td><td valign="top"><em>method</em>&nbsp;</td><td>The method used for demodulation (LOGMAP or APPROX)</td></tr>
485  </table>
486</dl>
487<dl class="note" compact><dt><b>Note:</b></dt><dd>For soft demodulation it is suggested to use the N-dimensional modulator (<a class="el" href="classitpp_1_1Modulator__ND.html" title="Base class for an N-dimensional (ND) vector (MIMO) modulator.">Modulator_ND</a>) instead, which is based on the QLLR (quantized) arithmetic and therefore is faster. Please note, however, that mixed use of <code>Modulator_1D/<code>Modulator_2D</code> and</code> <code><a class="el" href="classitpp_1_1Modulator__ND.html" title="Base class for an N-dimensional (ND) vector (MIMO) modulator.">Modulator_ND</a></code> is not advised. </dd></dl>
488
489<p>Referenced by <a class="el" href="modulator_8cpp-source.html#l00348">demodulate_soft_bits()</a>.</p>
490
491</div>
492</div><p>
493<a class="anchor" name="a8186f0e837fd3d440a6acb7a0225d35"></a><!-- doxytag: member="itpp::BPSK::get_bits2symbols" ref="a8186f0e837fd3d440a6acb7a0225d35" args="() const" -->
494<div class="memitem">
495<div class="memproto">
496      <table class="memname">
497        <tr>
498          <td class="memname">virtual ivec <a class="el" href="classitpp_1_1Modulator.html">itpp::Modulator</a>&lt; double  &gt;::get_bits2symbols           </td>
499          <td>(</td>
500          <td class="paramname">          </td>
501          <td>&nbsp;)&nbsp;</td>
502          <td> const<code> [inline, virtual, inherited]</code></td>
503        </tr>
504      </table>
505</div>
506<div class="memdoc">
507
508<p>
509Get the bitmap, which maps input bits into symbols.
510<p>
511The mapping is done as follows. An input bit sequence in decimal notation is used for indexing the <code>bits2symbols</code> table. The indexing result denotes the symbol to be used from the <code>symbols</code> table, e.g.:<p>
512<div class="fragment"><pre class="fragment"> PSK <a class="code" href="group__miscfunc.html#g441f466a2b056fe5f2b05fcd894c472f" title="Calculates the modulus, i.e. the signed reminder after division.">mod</a>(8); <span class="comment">// assume 8-PSK modulator</span>
513 cvec sym =  <a class="code" href="group__miscfunc.html#g441f466a2b056fe5f2b05fcd894c472f" title="Calculates the modulus, i.e. the signed reminder after division.">mod</a>.get_symbols();
514 ivec bits2sym = <a class="code" href="group__miscfunc.html#g441f466a2b056fe5f2b05fcd894c472f" title="Calculates the modulus, i.e. the signed reminder after division.">mod</a>.get_bits2symbols();
515 bvec in_bits = <span class="stringliteral">"100"</span> <span class="comment">// input bits</span>
516 <span class="keywordtype">int</span> d = <a class="code" href="group__convertfunc.html#g698adf78bc0f9d36fd5987bc87d543fa" title="Convert a bvec to decimal int with the first bit as MSB if msb_first == true.">bin2dec</a>(in_bits); <span class="comment">// decimal representation of in_bits = 4</span>
517 <span class="comment">// mapping of d into PSK symbol using bits2sym and sym tables</span>
518 std::complex&lt;double&gt; out_symbol = sym(bits2sym(d));
519</pre></div> 
520</div>
521</div><p>
522<hr>The documentation for this class was generated from the following files:<ul>
523<li><a class="el" href="modulator_8h-source.html">modulator.h</a><li><a class="el" href="modulator_8cpp.html">modulator.cpp</a></ul>
524</div>
525<hr size="1"><address style="text-align: right;"><small>Generated on Tue Jun 2 10:02:19 2009 for mixpp by&nbsp;
526<a href="http://www.doxygen.org/index.html">
527<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
528</body>
529</html>
Note: See TracBrowser for help on using the browser.