root/doc/html/classitpp_1_1Modulator__NRD.html @ 353

Revision 353, 48.9 kB (checked in by smidl, 15 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::Modulator_NRD 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_1Modulator__NRD.html">Modulator_NRD</a>
68  </div>
69</div>
70<div class="contents">
71<h1>itpp::Modulator_NRD Class Reference<br>
72<small>
73[<a class="el" href="group__modulators.html">Digital Modulation</a>]</small>
74</h1><!-- doxytag: class="itpp::Modulator_NRD" --><!-- doxytag: inherits="itpp::Modulator_ND" -->Base class for N-dimensional vector (MIMO) channel modulators/demodulators with real-valued components. 
75<a href="#_details">More...</a>
76<p>
77<code>#include &lt;<a class="el" href="modulator__nd_8h-source.html">modulator_nd.h</a>&gt;</code>
78<p>
79
80<p>
81<a href="classitpp_1_1Modulator__NRD-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 Types</h2></td></tr>
84<tr><td class="memItemLeft" nowrap align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__ND.html#6e3b4c745f904cdb34301aeb4cc03035">Soft_Demod_Method</a> { <a class="el" href="classitpp_1_1Modulator__ND.html#6e3b4c745f904cdb34301aeb4cc03035c743f79c2dbf90c34fd03075b7648058">FULL_ENUM_LOGMAP</a>,
85<a class="el" href="classitpp_1_1Modulator__ND.html#6e3b4c745f904cdb34301aeb4cc03035d5798fd18f93f399475392b8aee09cba">ZF_LOGMAP</a>
86 }</td></tr>
87
88<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Soft demodulation method.  <a href="classitpp_1_1Modulator__ND.html#6e3b4c745f904cdb34301aeb4cc03035">More...</a><br></td></tr>
89<tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr>
90<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="e605e4949369ceb91017ce18fac8fda6"></a><!-- doxytag: member="itpp::Modulator_NRD::Modulator_NRD" ref="e605e4949369ceb91017ce18fac8fda6" args="()" -->
91&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__NRD.html#e605e4949369ceb91017ce18fac8fda6">Modulator_NRD</a> ()</td></tr>
92
93<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Constructor. <br></td></tr>
94<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="5424e615eeaa0a3c8c4d2613540ff786"></a><!-- doxytag: member="itpp::Modulator_NRD::~Modulator_NRD" ref="5424e615eeaa0a3c8c4d2613540ff786" args="()" -->
95&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__NRD.html#5424e615eeaa0a3c8c4d2613540ff786">~Modulator_NRD</a> ()</td></tr>
96
97<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Destructor. <br></td></tr>
98<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="85019d35a647571786af4eedce111544"></a><!-- doxytag: member="itpp::Modulator_NRD::get_symbols" ref="85019d35a647571786af4eedce111544" args="() const " -->
99<a class="el" href="classitpp_1_1Array.html">Array</a>&lt; vec &gt;&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__NRD.html#85019d35a647571786af4eedce111544">get_symbols</a> () const </td></tr>
100
101<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Get modulation symbols per dimension. <br></td></tr>
102<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="f8993b9fc18d5a8ca4564ea3b928f22c"></a><!-- doxytag: member="itpp::Modulator_NRD::modulate_bits" ref="f8993b9fc18d5a8ca4564ea3b928f22c" args="(const bvec &amp;bits, vec &amp;symbols) const " -->
103void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__NRD.html#f8993b9fc18d5a8ca4564ea3b928f22c">modulate_bits</a> (const bvec &amp;bits, vec &amp;<a class="el" href="classitpp_1_1Modulator__NRD.html#a5a276d6745c7a38dd4ae6b5eb70147e">symbols</a>) const </td></tr>
104
105<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Modulate <code>bits</code> into <code>symbols</code>. <br></td></tr>
106<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="e5f4bd15dcb3615845c97bd0c64ffe0b"></a><!-- doxytag: member="itpp::Modulator_NRD::modulate_bits" ref="e5f4bd15dcb3615845c97bd0c64ffe0b" args="(const bvec &amp;bits) const " -->
107vec&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__NRD.html#e5f4bd15dcb3615845c97bd0c64ffe0b">modulate_bits</a> (const bvec &amp;bits) const </td></tr>
108
109<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Modulate <code>bits</code> vector. Symbols are returned. <br></td></tr>
110<tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__NRD.html#42d28853cead832c7e7644366023601b">demodulate_soft_bits</a> (const vec &amp;y, const mat &amp;H, double sigma2, const QLLRvec &amp;LLR_apriori, QLLRvec &amp;LLR_aposteriori, <a class="el" href="classitpp_1_1Modulator__ND.html#6e3b4c745f904cdb34301aeb4cc03035">Soft_Demod_Method</a> method)</td></tr>
111
112<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Soft demodulation wrapper function for various methods.  <a href="#42d28853cead832c7e7644366023601b"></a><br></td></tr>
113<tr><td class="memItemLeft" nowrap align="right" valign="top">QLLRvec&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__NRD.html#e1bdcbd5307ac1ab0e368f33fee5f149">demodulate_soft_bits</a> (const vec &amp;y, const mat &amp;H, double sigma2, const QLLRvec &amp;LLR_apriori, <a class="el" href="classitpp_1_1Modulator__ND.html#6e3b4c745f904cdb34301aeb4cc03035">Soft_Demod_Method</a> method)</td></tr>
114
115<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Soft demodulation wrapper function for various methods.  <a href="#e1bdcbd5307ac1ab0e368f33fee5f149"></a><br></td></tr>
116<tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__NRD.html#5de17b14ee11626e8323b50cf29fd047">demodulate_soft_bits</a> (const vec &amp;y, const mat &amp;H, double sigma2, const QLLRvec &amp;LLR_apriori, QLLRvec &amp;LLR_aposteriori)</td></tr>
117
118<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Soft MAP demodulation for multidimensional channel, by "brute-force" enumeration of all constellation points.  <a href="#5de17b14ee11626e8323b50cf29fd047"></a><br></td></tr>
119<tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__NRD.html#249e4cf64c7106d559e1589f200ccbc7">demodulate_soft_bits</a> (const vec &amp;y, const vec &amp;h, double sigma2, const QLLRvec &amp;LLR_apriori, QLLRvec &amp;LLR_aposteriori)</td></tr>
120
121<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Soft MAP demodulation for parallelchannels without crosstalk.  <a href="#249e4cf64c7106d559e1589f200ccbc7"></a><br></td></tr>
122<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="e5a2e50b1bf055d6db9f56bd4fe83105"></a><!-- doxytag: member="itpp::Modulator_NRD::set_llrcalc" ref="e5a2e50b1bf055d6db9f56bd4fe83105" args="(LLR_calc_unit llrcalc_in)" -->
123void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__ND.html#e5a2e50b1bf055d6db9f56bd4fe83105">set_llrcalc</a> (<a class="el" href="classitpp_1_1LLR__calc__unit.html">LLR_calc_unit</a> llrcalc_in)</td></tr>
124
125<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Set LLR calculation unit. <br></td></tr>
126<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="b68aa9155f305d9fb4e8d3cab45d5c9d"></a><!-- doxytag: member="itpp::Modulator_NRD::get_llrcalc" ref="b68aa9155f305d9fb4e8d3cab45d5c9d" args="() const " -->
127<a class="el" href="classitpp_1_1LLR__calc__unit.html">LLR_calc_unit</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__ND.html#b68aa9155f305d9fb4e8d3cab45d5c9d">get_llrcalc</a> () const </td></tr>
128
129<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Get LLR calculation unit. <br></td></tr>
130<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="64691da50e1a9f604c41bdda141d477a"></a><!-- doxytag: member="itpp::Modulator_NRD::get_dim" ref="64691da50e1a9f604c41bdda141d477a" args="() const " -->
131int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__ND.html#64691da50e1a9f604c41bdda141d477a">get_dim</a> () const </td></tr>
132
133<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Get number of dimensions. <br></td></tr>
134<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="aa89b07529c5c5bbe75d4c6b45f9264c"></a><!-- doxytag: member="itpp::Modulator_NRD::get_k" ref="aa89b07529c5c5bbe75d4c6b45f9264c" args="() const " -->
135ivec&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__ND.html#aa89b07529c5c5bbe75d4c6b45f9264c">get_k</a> () const </td></tr>
136
137<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Get number of bits per modulation symbol per dimension. <br></td></tr>
138<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="a9f88563e5de7dd446f0c61c86976c76"></a><!-- doxytag: member="itpp::Modulator_NRD::get_M" ref="a9f88563e5de7dd446f0c61c86976c76" args="() const " -->
139ivec&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__ND.html#a9f88563e5de7dd446f0c61c86976c76">get_M</a> () const </td></tr>
140
141<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Get number of modulation symbols per dimension. <br></td></tr>
142<tr><td colspan="2"><br><h2>Protected Member Functions</h2></td></tr>
143<tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__NRD.html#37363ba319fa9230cce3b969dbcf6f1a">update_norm</a> (double &amp;norm, int <a class="el" href="classitpp_1_1Modulator__ND.html#5545e8651244ffca103252926fb18a1c">k</a>, int sold, int snew, const vec &amp;ytH, const mat &amp;HtH, const ivec &amp;s)</td></tr>
144
145<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Update residual norm (for internal use).  <a href="#37363ba319fa9230cce3b969dbcf6f1a"></a><br></td></tr>
146<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="a7eaacc702e0564b3388b9fb9413d301"></a><!-- doxytag: member="itpp::Modulator_NRD::probabilities" ref="a7eaacc702e0564b3388b9fb9413d301" args="(QLLR l)" -->
147QLLRvec&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__ND.html#a7eaacc702e0564b3388b9fb9413d301">probabilities</a> (QLLR l)</td></tr>
148
149<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Convert LLR to log-probabilities. <br></td></tr>
150<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="6278bfead2080abfd50998067336eb12"></a><!-- doxytag: member="itpp::Modulator_NRD::probabilities" ref="6278bfead2080abfd50998067336eb12" args="(const QLLRvec &amp;l)" -->
151<a class="el" href="classitpp_1_1Array.html">Array</a>&lt; QLLRvec &gt;&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__ND.html#6278bfead2080abfd50998067336eb12">probabilities</a> (const QLLRvec &amp;l)</td></tr>
152
153<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Convert LLR to log-probabilities, vector version. <br></td></tr>
154<tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__ND.html#48975e0d26dac075e1f448bdca15ca87">update_LLR</a> (const <a class="el" href="classitpp_1_1Array.html">Array</a>&lt; QLLRvec &gt; &amp;logP_apriori, const ivec &amp;s, QLLR scaled_norm, QLLRvec &amp;num, QLLRvec &amp;denom)</td></tr>
155
156<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Update LLR (for internal use).  <a href="#48975e0d26dac075e1f448bdca15ca87"></a><br></td></tr>
157<tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__ND.html#6bb417318b8105a78db7ad2c618283ce">update_LLR</a> (const <a class="el" href="classitpp_1_1Array.html">Array</a>&lt; QLLRvec &gt; &amp;logP_apriori, int s, QLLR scaled_norm, int j, QLLRvec &amp;num, QLLRvec &amp;denom)</td></tr>
158
159<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Update LLR, for scalar channel (for internal use).  <a href="#6bb417318b8105a78db7ad2c618283ce"></a><br></td></tr>
160<tr><td colspan="2"><br><h2>Protected Attributes</h2></td></tr>
161<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="a5a276d6745c7a38dd4ae6b5eb70147e"></a><!-- doxytag: member="itpp::Modulator_NRD::symbols" ref="a5a276d6745c7a38dd4ae6b5eb70147e" args="" -->
162<a class="el" href="classitpp_1_1Array.html">Array</a>&lt; vec &gt;&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__NRD.html#a5a276d6745c7a38dd4ae6b5eb70147e">symbols</a></td></tr>
163
164<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Vectors of modulation symbols (along each dimension). <br></td></tr>
165<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="18f0f81646514aa7210415f83fc62c1b"></a><!-- doxytag: member="itpp::Modulator_NRD::nt" ref="18f0f81646514aa7210415f83fc62c1b" args="" -->
166int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__ND.html#18f0f81646514aa7210415f83fc62c1b">nt</a></td></tr>
167
168<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Number of dimensions. <br></td></tr>
169<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="8690246ff99fd198a5e7d179954ac5a9"></a><!-- doxytag: member="itpp::Modulator_NRD::llrcalc" ref="8690246ff99fd198a5e7d179954ac5a9" args="" -->
170<a class="el" href="classitpp_1_1LLR__calc__unit.html">LLR_calc_unit</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__ND.html#8690246ff99fd198a5e7d179954ac5a9">llrcalc</a></td></tr>
171
172<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">LLR calculation unit. <br></td></tr>
173<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="5545e8651244ffca103252926fb18a1c"></a><!-- doxytag: member="itpp::Modulator_NRD::k" ref="5545e8651244ffca103252926fb18a1c" args="" -->
174ivec&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__ND.html#5545e8651244ffca103252926fb18a1c">k</a></td></tr>
175
176<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Number of bits per modulation symbol. <br></td></tr>
177<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="45916df32ce60b4c286367501482b441"></a><!-- doxytag: member="itpp::Modulator_NRD::M" ref="45916df32ce60b4c286367501482b441" args="" -->
178ivec&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__ND.html#45916df32ce60b4c286367501482b441">M</a></td></tr>
179
180<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Number of modulation symbols along each dimension. <br></td></tr>
181<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="cf19a4c13454739dfa68d0b9f6a85211"></a><!-- doxytag: member="itpp::Modulator_NRD::bitmap" ref="cf19a4c13454739dfa68d0b9f6a85211" args="" -->
182<a class="el" href="classitpp_1_1Array.html">Array</a>&lt; <a class="el" href="mat_8h.html#f90acd1af41bf2d1d8a4bb23662fff69">bmat</a> &gt;&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__ND.html#cf19a4c13454739dfa68d0b9f6a85211">bitmap</a></td></tr>
183
184<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Bit mapping table (one table per dimension). <br></td></tr>
185<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="123a047e221467e2f63b4e353963b1a7"></a><!-- doxytag: member="itpp::Modulator_NRD::bits2symbols" ref="123a047e221467e2f63b4e353963b1a7" args="" -->
186<a class="el" href="classitpp_1_1Array.html">Array</a>&lt; ivec &gt;&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__ND.html#123a047e221467e2f63b4e353963b1a7">bits2symbols</a></td></tr>
187
188<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Bit pattern in decimal form ordered and the corresponding symbols (one pattern per dimension). <br></td></tr>
189<tr><td colspan="2"><br><h2>Friends</h2></td></tr>
190<tr><td class="memItemLeft" nowrap align="right" valign="top">std::ostream &amp;&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__NRD.html#f82a88fab3e6f7a1e6c0a4a7e17fb678">operator&lt;&lt;</a> (std::ostream &amp;os, const <a class="el" href="classitpp_1_1Modulator__NRD.html">Modulator_NRD</a> &amp;m)</td></tr>
191
192<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Output some properties of the MIMO modulator (mainly to aid debugging).  <a href="#f82a88fab3e6f7a1e6c0a4a7e17fb678"></a><br></td></tr>
193</table>
194<hr><a name="_details"></a><h2>Detailed Description</h2>
195Base class for N-dimensional vector (MIMO) channel modulators/demodulators with real-valued components.
196<p>
197This class can be used to perform modulation and demodulation for a matrix (MIMO) channel of the form <p class="formulaDsp">
198<img class="formulaDsp" alt="\[ y = Hx+e \]" src="form_289.png">
199<p>
200, where H is the channel matrix of dimension <img class="formulaInl" alt="$n_r\times n_t$" src="form_290.png">, <img class="formulaInl" alt="$y$" src="form_291.png"> is a received vector of length <img class="formulaInl" alt="$n_r$" src="form_292.png">, <img class="formulaInl" alt="$x$" src="form_0.png"> is a transmitted vector of length <img class="formulaInl" alt="$n_t$" src="form_293.png"> and <img class="formulaInl" alt="$e$" src="form_294.png"> is a noise vector.<p>
201The class supports soft-input soft-output demodulation. It can also be used for scalar modulation to take advantage of this feature.<p>
202Complex MIMO channels can be handled by using the <code><a class="el" href="classitpp_1_1Modulator__NCD.html" title="Base class for vector (MIMO) channel modulator/demodulators with complex valued components...">Modulator_NCD</a></code> class. Alternatively, if the signal constellation is separable in I/Q then the complex channel can be first transformed to a real channel <p class="formulaDsp">
203<img class="formulaDsp" alt="\[ G = \left[ \begin{array}{cc} H_r &amp; -H_i \\ H_i &amp; H_r \end{array} \right] \]" src="form_295.png">
204<p>
205<p>
206See <code><a class="el" href="classitpp_1_1ND__UPAM.html" title="Real-valued MIMO channel with uniform PAM along each dimension.">ND_UPAM</a></code> for examples. <hr><h2>Member Enumeration Documentation</h2>
207<a class="anchor" name="6e3b4c745f904cdb34301aeb4cc03035"></a><!-- doxytag: member="itpp::Modulator_NRD::Soft_Demod_Method" ref="6e3b4c745f904cdb34301aeb4cc03035" args="" -->
208<div class="memitem">
209<div class="memproto">
210      <table class="memname">
211        <tr>
212          <td class="memname">enum <a class="el" href="classitpp_1_1Modulator__ND.html#6e3b4c745f904cdb34301aeb4cc03035">itpp::Modulator_ND::Soft_Demod_Method</a><code> [inherited]</code>          </td>
213        </tr>
214      </table>
215</div>
216<div class="memdoc">
217
218<p>
219Soft demodulation method.
220<p>
221<dl compact><dt><b>Enumerator: </b></dt><dd>
222<table border="0" cellspacing="2" cellpadding="0">
223<tr><td valign="top"><em><a class="anchor" name="6e3b4c745f904cdb34301aeb4cc03035c743f79c2dbf90c34fd03075b7648058"></a><!-- doxytag: member="FULL_ENUM_LOGMAP" ref="6e3b4c745f904cdb34301aeb4cc03035c743f79c2dbf90c34fd03075b7648058" args="" -->FULL_ENUM_LOGMAP</em>&nbsp;</td><td>
224Log-MAP demodulation by "brute-force" enumeration of all points. </td></tr>
225<tr><td valign="top"><em><a class="anchor" name="6e3b4c745f904cdb34301aeb4cc03035d5798fd18f93f399475392b8aee09cba"></a><!-- doxytag: member="ZF_LOGMAP" ref="6e3b4c745f904cdb34301aeb4cc03035d5798fd18f93f399475392b8aee09cba" args="" -->ZF_LOGMAP</em>&nbsp;</td><td>
226Zero-Forcing Log-MAP approximated demodulation. </td></tr>
227</table>
228</dl>
229
230</div>
231</div><p>
232<hr><h2>Member Function Documentation</h2>
233<a class="anchor" name="249e4cf64c7106d559e1589f200ccbc7"></a><!-- doxytag: member="itpp::Modulator_NRD::demodulate_soft_bits" ref="249e4cf64c7106d559e1589f200ccbc7" args="(const vec &amp;y, const vec &amp;h, double sigma2, const QLLRvec &amp;LLR_apriori, QLLRvec &amp;LLR_aposteriori)" -->
234<div class="memitem">
235<div class="memproto">
236      <table class="memname">
237        <tr>
238          <td class="memname">void itpp::Modulator_NRD::demodulate_soft_bits           </td>
239          <td>(</td>
240          <td class="paramtype">const vec &amp;&nbsp;</td>
241          <td class="paramname"> <em>y</em>, </td>
242        </tr>
243        <tr>
244          <td class="paramkey"></td>
245          <td></td>
246          <td class="paramtype">const vec &amp;&nbsp;</td>
247          <td class="paramname"> <em>h</em>, </td>
248        </tr>
249        <tr>
250          <td class="paramkey"></td>
251          <td></td>
252          <td class="paramtype">double&nbsp;</td>
253          <td class="paramname"> <em>sigma2</em>, </td>
254        </tr>
255        <tr>
256          <td class="paramkey"></td>
257          <td></td>
258          <td class="paramtype">const QLLRvec &amp;&nbsp;</td>
259          <td class="paramname"> <em>LLR_apriori</em>, </td>
260        </tr>
261        <tr>
262          <td class="paramkey"></td>
263          <td></td>
264          <td class="paramtype">QLLRvec &amp;&nbsp;</td>
265          <td class="paramname"> <em>LLR_aposteriori</em></td><td>&nbsp;</td>
266        </tr>
267        <tr>
268          <td></td>
269          <td>)</td>
270          <td></td><td></td><td></td>
271        </tr>
272      </table>
273</div>
274<div class="memdoc">
275
276<p>
277Soft MAP demodulation for parallelchannels without crosstalk.
278<p>
279This function is a much faster equivalent to <code>demodulate_soft_bits</code> with <img class="formulaInl" alt="$H = \mbox{diag}(h)$" src="form_299.png">. Its complexity is linear in the number of subchannels.
280<p>References <a class="el" href="itassert_8h-source.html#l00094">it_assert</a>, <a class="el" href="modulator__nd_8h-source.html#l00096">itpp::Modulator_ND::k</a>, <a class="el" href="matfunc_8h-source.html#l00051">itpp::length()</a>, <a class="el" href="modulator__nd_8h-source.html#l00094">itpp::Modulator_ND::llrcalc</a>, <a class="el" href="modulator__nd_8h-source.html#l00098">itpp::Modulator_ND::M</a>, <a class="el" href="modulator__nd_8h-source.html#l00092">itpp::Modulator_ND::nt</a>, <a class="el" href="group__specmat.html#g7c2c02190b4aa222cc692641cc3a73c7">itpp::ones_i()</a>, <a class="el" href="modulator__nd_8cpp-source.html#l00043">itpp::Modulator_ND::probabilities()</a>, <a class="el" href="elem__math_8h-source.html#l00056">itpp::sqr()</a>, <a class="el" href="matfunc_8h-source.html#l00077">itpp::sum()</a>, <a class="el" href="modulator__nd_8h-source.html#l00294">symbols</a>, <a class="el" href="llr_8h-source.html#l00235">itpp::LLR_calc_unit::to_qllr()</a>, and <a class="el" href="modulator__nd_8cpp-source.html#l00093">itpp::Modulator_ND::update_LLR()</a>.</p>
281
282</div>
283</div><p>
284<a class="anchor" name="5de17b14ee11626e8323b50cf29fd047"></a><!-- doxytag: member="itpp::Modulator_NRD::demodulate_soft_bits" ref="5de17b14ee11626e8323b50cf29fd047" args="(const vec &amp;y, const mat &amp;H, double sigma2, const QLLRvec &amp;LLR_apriori, QLLRvec &amp;LLR_aposteriori)" -->
285<div class="memitem">
286<div class="memproto">
287      <table class="memname">
288        <tr>
289          <td class="memname">void itpp::Modulator_NRD::demodulate_soft_bits           </td>
290          <td>(</td>
291          <td class="paramtype">const vec &amp;&nbsp;</td>
292          <td class="paramname"> <em>y</em>, </td>
293        </tr>
294        <tr>
295          <td class="paramkey"></td>
296          <td></td>
297          <td class="paramtype">const mat &amp;&nbsp;</td>
298          <td class="paramname"> <em>H</em>, </td>
299        </tr>
300        <tr>
301          <td class="paramkey"></td>
302          <td></td>
303          <td class="paramtype">double&nbsp;</td>
304          <td class="paramname"> <em>sigma2</em>, </td>
305        </tr>
306        <tr>
307          <td class="paramkey"></td>
308          <td></td>
309          <td class="paramtype">const QLLRvec &amp;&nbsp;</td>
310          <td class="paramname"> <em>LLR_apriori</em>, </td>
311        </tr>
312        <tr>
313          <td class="paramkey"></td>
314          <td></td>
315          <td class="paramtype">QLLRvec &amp;&nbsp;</td>
316          <td class="paramname"> <em>LLR_aposteriori</em></td><td>&nbsp;</td>
317        </tr>
318        <tr>
319          <td></td>
320          <td>)</td>
321          <td></td><td></td><td></td>
322        </tr>
323      </table>
324</div>
325<div class="memdoc">
326
327<p>
328Soft MAP demodulation for multidimensional channel, by "brute-force" enumeration of all constellation points.
329<p>
330This function computes the LLR values <p class="formulaDsp">
331<img class="formulaDsp" alt="\[ LLR(k) = \log \left( \frac {\sum_{s:b_k=0} \exp \left( -\frac{|y - Hs|^2}{2\sigma^2} \right) P(s)} {\sum_{s:b_k=1} \exp \left( -\frac{|y - Hs|^2}{2\sigma^2} \right) P(s)} \right) \]" src="form_298.png">
332<p>
333<p>
334without approximations. It is assumed that H, y and s are real-valued. Complex-valued channels can be handled using the <code><a class="el" href="classitpp_1_1Modulator__NCD.html" title="Base class for vector (MIMO) channel modulator/demodulators with complex valued components...">Modulator_NCD</a></code> class.<p>
335<dl compact><dt><b>Parameters:</b></dt><dd>
336  <table border="0" cellspacing="2" cellpadding="0">
337    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>y</em>&nbsp;</td><td>Received vector </td></tr>
338    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>H</em>&nbsp;</td><td>Channel matrix </td></tr>
339    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>sigma2</em>&nbsp;</td><td>Noise variance per real dimension (typically <img class="formulaInl" alt="$N_0/2$" src="form_232.png">) </td></tr>
340    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>LLR_apriori</em>&nbsp;</td><td>Vector of a priori LLR values per bit </td></tr>
341    <tr><td valign="top"><tt>[out]</tt>&nbsp;</td><td valign="top"><em>LLR_aposteriori</em>&nbsp;</td><td>Vector of a posteriori LLR values</td></tr>
342  </table>
343</dl>
344The function performs an exhaustive search over all possible points <code>s</code> in the n-dimensional constellation. This is only feasible for relatively small constellations. The Jacobian logarithm is used to compute the sum-exp expression.
345<p>References <a class="el" href="itassert_8h-source.html#l00094">it_assert</a>, <a class="el" href="modulator__nd_8h-source.html#l00096">itpp::Modulator_ND::k</a>, <a class="el" href="matfunc_8h-source.html#l00051">itpp::length()</a>, <a class="el" href="modulator__nd_8h-source.html#l00094">itpp::Modulator_ND::llrcalc</a>, <a class="el" href="modulator__nd_8h-source.html#l00098">itpp::Modulator_ND::M</a>, <a class="el" href="misc__stat_8h-source.html#l00193">itpp::norm()</a>, <a class="el" href="modulator__nd_8h-source.html#l00092">itpp::Modulator_ND::nt</a>, <a class="el" href="group__specmat.html#g7c2c02190b4aa222cc692641cc3a73c7">itpp::ones_i()</a>, <a class="el" href="modulator__nd_8cpp-source.html#l00043">itpp::Modulator_ND::probabilities()</a>, <a class="el" href="elem__math_8h-source.html#l00056">itpp::sqr()</a>, <a class="el" href="matfunc_8h-source.html#l00077">itpp::sum()</a>, <a class="el" href="modulator__nd_8h-source.html#l00294">symbols</a>, <a class="el" href="llr_8h-source.html#l00235">itpp::LLR_calc_unit::to_qllr()</a>, <a class="el" href="modulator__nd_8cpp-source.html#l00093">itpp::Modulator_ND::update_LLR()</a>, <a class="el" href="modulator__nd_8cpp-source.html#l00311">update_norm()</a>, and <a class="el" href="group__specmat.html#g9df9aa3553b6a5c07924954b85466cec">itpp::zeros_i()</a>.</p>
346
347</div>
348</div><p>
349<a class="anchor" name="e1bdcbd5307ac1ab0e368f33fee5f149"></a><!-- doxytag: member="itpp::Modulator_NRD::demodulate_soft_bits" ref="e1bdcbd5307ac1ab0e368f33fee5f149" args="(const vec &amp;y, const mat &amp;H, double sigma2, const QLLRvec &amp;LLR_apriori, Soft_Demod_Method method)" -->
350<div class="memitem">
351<div class="memproto">
352      <table class="memname">
353        <tr>
354          <td class="memname">QLLRvec itpp::Modulator_NRD::demodulate_soft_bits           </td>
355          <td>(</td>
356          <td class="paramtype">const vec &amp;&nbsp;</td>
357          <td class="paramname"> <em>y</em>, </td>
358        </tr>
359        <tr>
360          <td class="paramkey"></td>
361          <td></td>
362          <td class="paramtype">const mat &amp;&nbsp;</td>
363          <td class="paramname"> <em>H</em>, </td>
364        </tr>
365        <tr>
366          <td class="paramkey"></td>
367          <td></td>
368          <td class="paramtype">double&nbsp;</td>
369          <td class="paramname"> <em>sigma2</em>, </td>
370        </tr>
371        <tr>
372          <td class="paramkey"></td>
373          <td></td>
374          <td class="paramtype">const QLLRvec &amp;&nbsp;</td>
375          <td class="paramname"> <em>LLR_apriori</em>, </td>
376        </tr>
377        <tr>
378          <td class="paramkey"></td>
379          <td></td>
380          <td class="paramtype"><a class="el" href="classitpp_1_1Modulator__ND.html#6e3b4c745f904cdb34301aeb4cc03035">Soft_Demod_Method</a>&nbsp;</td>
381          <td class="paramname"> <em>method</em></td><td>&nbsp;</td>
382        </tr>
383        <tr>
384          <td></td>
385          <td>)</td>
386          <td></td><td></td><td></td>
387        </tr>
388      </table>
389</div>
390<div class="memdoc">
391
392<p>
393Soft demodulation wrapper function for various methods.
394<p>
395Currently the following two demodulation methods are supported:<ul>
396<li>FULL_ENUM_LOGMAP - exact demodulation, which use "brute-force" enumeration of all constellation points</li><li>ZF_LOGMAP - approximated methods with Zero-Forcing preprocessing, which sometimes tends to perform poorly, especially for poorly conditioned H</li></ul>
397<p>
398<dl compact><dt><b>Parameters:</b></dt><dd>
399  <table border="0" cellspacing="2" cellpadding="0">
400    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>y</em>&nbsp;</td><td>Received vector </td></tr>
401    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>H</em>&nbsp;</td><td>Channel matrix </td></tr>
402    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>sigma2</em>&nbsp;</td><td>Noise variance per real dimension (typically <img class="formulaInl" alt="$N_0/2$" src="form_232.png">) </td></tr>
403    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>LLR_apriori</em>&nbsp;</td><td>Vector of a priori LLR values per bit </td></tr>
404    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>method</em>&nbsp;</td><td>Soft demodulation method </td></tr>
405  </table>
406</dl>
407<dl class="return" compact><dt><b>Returns:</b></dt><dd>Vector of a posteriori LLR values </dd></dl>
408
409<p>References <a class="el" href="modulator__nd_8cpp-source.html#l00150">demodulate_soft_bits()</a>.</p>
410
411</div>
412</div><p>
413<a class="anchor" name="42d28853cead832c7e7644366023601b"></a><!-- doxytag: member="itpp::Modulator_NRD::demodulate_soft_bits" ref="42d28853cead832c7e7644366023601b" args="(const vec &amp;y, const mat &amp;H, double sigma2, const QLLRvec &amp;LLR_apriori, QLLRvec &amp;LLR_aposteriori, Soft_Demod_Method method)" -->
414<div class="memitem">
415<div class="memproto">
416      <table class="memname">
417        <tr>
418          <td class="memname">void itpp::Modulator_NRD::demodulate_soft_bits           </td>
419          <td>(</td>
420          <td class="paramtype">const vec &amp;&nbsp;</td>
421          <td class="paramname"> <em>y</em>, </td>
422        </tr>
423        <tr>
424          <td class="paramkey"></td>
425          <td></td>
426          <td class="paramtype">const mat &amp;&nbsp;</td>
427          <td class="paramname"> <em>H</em>, </td>
428        </tr>
429        <tr>
430          <td class="paramkey"></td>
431          <td></td>
432          <td class="paramtype">double&nbsp;</td>
433          <td class="paramname"> <em>sigma2</em>, </td>
434        </tr>
435        <tr>
436          <td class="paramkey"></td>
437          <td></td>
438          <td class="paramtype">const QLLRvec &amp;&nbsp;</td>
439          <td class="paramname"> <em>LLR_apriori</em>, </td>
440        </tr>
441        <tr>
442          <td class="paramkey"></td>
443          <td></td>
444          <td class="paramtype">QLLRvec &amp;&nbsp;</td>
445          <td class="paramname"> <em>LLR_aposteriori</em>, </td>
446        </tr>
447        <tr>
448          <td class="paramkey"></td>
449          <td></td>
450          <td class="paramtype"><a class="el" href="classitpp_1_1Modulator__ND.html#6e3b4c745f904cdb34301aeb4cc03035">Soft_Demod_Method</a>&nbsp;</td>
451          <td class="paramname"> <em>method</em></td><td>&nbsp;</td>
452        </tr>
453        <tr>
454          <td></td>
455          <td>)</td>
456          <td></td><td></td><td></td>
457        </tr>
458      </table>
459</div>
460<div class="memdoc">
461
462<p>
463Soft demodulation wrapper function for various methods.
464<p>
465Currently the following two demodulation methods are supported:<ul>
466<li>FULL_ENUM_LOGMAP - exact demodulation, which use "brute-force" enumeration of all constellation points</li><li>ZF_LOGMAP - approximated methods with Zero-Forcing preprocessing, which sometimes tends to perform poorly, especially for poorly conditioned H</li></ul>
467<p>
468<dl compact><dt><b>Parameters:</b></dt><dd>
469  <table border="0" cellspacing="2" cellpadding="0">
470    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>y</em>&nbsp;</td><td>Received vector </td></tr>
471    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>H</em>&nbsp;</td><td>Channel matrix </td></tr>
472    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>sigma2</em>&nbsp;</td><td>Noise variance per real dimension (typically <img class="formulaInl" alt="$N_0/2$" src="form_232.png">) </td></tr>
473    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>LLR_apriori</em>&nbsp;</td><td>Vector of a priori LLR values per bit </td></tr>
474    <tr><td valign="top"><tt>[out]</tt>&nbsp;</td><td valign="top"><em>LLR_aposteriori</em>&nbsp;</td><td>Vector of a posteriori LLR values </td></tr>
475    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>method</em>&nbsp;</td><td>Soft demodulation method </td></tr>
476  </table>
477</dl>
478
479<p>References <a class="el" href="modulator__nd_8h-source.html#l00064">itpp::Modulator_ND::FULL_ENUM_LOGMAP</a>, <a class="el" href="inv_8cpp-source.html#l00109">itpp::inv()</a>, <a class="el" href="itassert_8h-source.html#l00094">it_assert</a>, <a class="el" href="itassert_8h-source.html#l00126">it_error</a>, <a class="el" href="modulator__nd_8h-source.html#l00096">itpp::Modulator_ND::k</a>, <a class="el" href="group__specmat.html#gdc0f3edbf58bced9e82d8b260d395cac">itpp::ones()</a>, <a class="el" href="elem__math_8h-source.html#l00126">itpp::sqrt()</a>, <a class="el" href="matfunc_8h-source.html#l00077">itpp::sum()</a>, <a class="el" href="group__specmat.html#g9df9aa3553b6a5c07924954b85466cec">itpp::zeros_i()</a>, and <a class="el" href="modulator__nd_8h-source.html#l00066">itpp::Modulator_ND::ZF_LOGMAP</a>.</p>
480
481<p>Referenced by <a class="el" href="modulator__nd_8cpp-source.html#l00183">demodulate_soft_bits()</a>.</p>
482
483</div>
484</div><p>
485<a class="anchor" name="6bb417318b8105a78db7ad2c618283ce"></a><!-- doxytag: member="itpp::Modulator_NRD::update_LLR" ref="6bb417318b8105a78db7ad2c618283ce" args="(const Array&lt; QLLRvec &gt; &amp;logP_apriori, int s, QLLR scaled_norm, int j, QLLRvec &amp;num, QLLRvec &amp;denom)" -->
486<div class="memitem">
487<div class="memproto">
488      <table class="memname">
489        <tr>
490          <td class="memname">void itpp::Modulator_ND::update_LLR           </td>
491          <td>(</td>
492          <td class="paramtype">const <a class="el" href="classitpp_1_1Array.html">Array</a>&lt; QLLRvec &gt; &amp;&nbsp;</td>
493          <td class="paramname"> <em>logP_apriori</em>, </td>
494        </tr>
495        <tr>
496          <td class="paramkey"></td>
497          <td></td>
498          <td class="paramtype">int&nbsp;</td>
499          <td class="paramname"> <em>s</em>, </td>
500        </tr>
501        <tr>
502          <td class="paramkey"></td>
503          <td></td>
504          <td class="paramtype">QLLR&nbsp;</td>
505          <td class="paramname"> <em>scaled_norm</em>, </td>
506        </tr>
507        <tr>
508          <td class="paramkey"></td>
509          <td></td>
510          <td class="paramtype">int&nbsp;</td>
511          <td class="paramname"> <em>j</em>, </td>
512        </tr>
513        <tr>
514          <td class="paramkey"></td>
515          <td></td>
516          <td class="paramtype">QLLRvec &amp;&nbsp;</td>
517          <td class="paramname"> <em>num</em>, </td>
518        </tr>
519        <tr>
520          <td class="paramkey"></td>
521          <td></td>
522          <td class="paramtype">QLLRvec &amp;&nbsp;</td>
523          <td class="paramname"> <em>denom</em></td><td>&nbsp;</td>
524        </tr>
525        <tr>
526          <td></td>
527          <td>)</td>
528          <td></td><td></td><td><code> [protected, inherited]</code></td>
529        </tr>
530      </table>
531</div>
532<div class="memdoc">
533
534<p>
535Update LLR, for scalar channel (for internal use).
536<p>
537This function updates the numerator and denominator in the expression <p class="formulaDsp">
538<img class="formulaDsp" alt="\[ \log \left( \frac {\sum_{s:b_k=0} \exp (-x^2) P(s)} {\sum_{s:b_k=1} \exp (-x^2) P(s)} \right) \]" src="form_297.png">
539<p>
540<p>
541<dl compact><dt><b>Parameters:</b></dt><dd>
542  <table border="0" cellspacing="2" cellpadding="0">
543    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>logP_apriori</em>&nbsp;</td><td>Vector of a priori probabilities per bit </td></tr>
544    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>s</em>&nbsp;</td><td>Symbol </td></tr>
545    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>scaled_norm</em>&nbsp;</td><td>Argument of the exponents in the above equation </td></tr>
546    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>j</em>&nbsp;</td><td>Channel index (dimension) </td></tr>
547    <tr><td valign="top"><tt>[out]</tt>&nbsp;</td><td valign="top"><em>num</em>&nbsp;</td><td>Logarithm of the numerator in the above expression </td></tr>
548    <tr><td valign="top"><tt>[out]</tt>&nbsp;</td><td valign="top"><em>denom</em>&nbsp;</td><td>Logarithm of the denominator in the above expression </td></tr>
549  </table>
550</dl>
551
552<p>References <a class="el" href="modulator__nd_8h-source.html#l00100">itpp::Modulator_ND::bitmap</a>, <a class="el" href="llr_8h-source.html#l00270">itpp::LLR_calc_unit::jaclog()</a>, <a class="el" href="modulator__nd_8h-source.html#l00096">itpp::Modulator_ND::k</a>, and <a class="el" href="modulator__nd_8h-source.html#l00094">itpp::Modulator_ND::llrcalc</a>.</p>
553
554</div>
555</div><p>
556<a class="anchor" name="48975e0d26dac075e1f448bdca15ca87"></a><!-- doxytag: member="itpp::Modulator_NRD::update_LLR" ref="48975e0d26dac075e1f448bdca15ca87" args="(const Array&lt; QLLRvec &gt; &amp;logP_apriori, const ivec &amp;s, QLLR scaled_norm, QLLRvec &amp;num, QLLRvec &amp;denom)" -->
557<div class="memitem">
558<div class="memproto">
559      <table class="memname">
560        <tr>
561          <td class="memname">void itpp::Modulator_ND::update_LLR           </td>
562          <td>(</td>
563          <td class="paramtype">const <a class="el" href="classitpp_1_1Array.html">Array</a>&lt; QLLRvec &gt; &amp;&nbsp;</td>
564          <td class="paramname"> <em>logP_apriori</em>, </td>
565        </tr>
566        <tr>
567          <td class="paramkey"></td>
568          <td></td>
569          <td class="paramtype">const ivec &amp;&nbsp;</td>
570          <td class="paramname"> <em>s</em>, </td>
571        </tr>
572        <tr>
573          <td class="paramkey"></td>
574          <td></td>
575          <td class="paramtype">QLLR&nbsp;</td>
576          <td class="paramname"> <em>scaled_norm</em>, </td>
577        </tr>
578        <tr>
579          <td class="paramkey"></td>
580          <td></td>
581          <td class="paramtype">QLLRvec &amp;&nbsp;</td>
582          <td class="paramname"> <em>num</em>, </td>
583        </tr>
584        <tr>
585          <td class="paramkey"></td>
586          <td></td>
587          <td class="paramtype">QLLRvec &amp;&nbsp;</td>
588          <td class="paramname"> <em>denom</em></td><td>&nbsp;</td>
589        </tr>
590        <tr>
591          <td></td>
592          <td>)</td>
593          <td></td><td></td><td><code> [protected, inherited]</code></td>
594        </tr>
595      </table>
596</div>
597<div class="memdoc">
598
599<p>
600Update LLR (for internal use).
601<p>
602This function updates the numerator and denominator in the expression <p class="formulaDsp">
603<img class="formulaDsp" alt="\[ \log \left( \frac {\sum_{s:b_k=0} \exp(-x^2) P(s)} {\sum_{s:b_k=1} \exp(-x^2) P(s)} \right) \]" src="form_296.png">
604<p>
605<p>
606<dl compact><dt><b>Parameters:</b></dt><dd>
607  <table border="0" cellspacing="2" cellpadding="0">
608    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>logP_apriori</em>&nbsp;</td><td>Vector of a priori probabilities per bit </td></tr>
609    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>s</em>&nbsp;</td><td>Symbol vector </td></tr>
610    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>scaled_norm</em>&nbsp;</td><td>Argument of the exponents in the above equation </td></tr>
611    <tr><td valign="top"><tt>[out]</tt>&nbsp;</td><td valign="top"><em>num</em>&nbsp;</td><td>Logarithm of the numerator in the above expression </td></tr>
612    <tr><td valign="top"><tt>[out]</tt>&nbsp;</td><td valign="top"><em>denom</em>&nbsp;</td><td>Logarithm of the denominator in the above expression </td></tr>
613  </table>
614</dl>
615
616<p>References <a class="el" href="modulator__nd_8h-source.html#l00100">itpp::Modulator_ND::bitmap</a>, <a class="el" href="llr_8h-source.html#l00270">itpp::LLR_calc_unit::jaclog()</a>, <a class="el" href="modulator__nd_8h-source.html#l00096">itpp::Modulator_ND::k</a>, <a class="el" href="modulator__nd_8h-source.html#l00094">itpp::Modulator_ND::llrcalc</a>, and <a class="el" href="modulator__nd_8h-source.html#l00092">itpp::Modulator_ND::nt</a>.</p>
617
618<p>Referenced by <a class="el" href="modulator__nd_8cpp-source.html#l00413">itpp::Modulator_NCD::demodulate_soft_bits()</a>, and <a class="el" href="modulator__nd_8cpp-source.html#l00193">demodulate_soft_bits()</a>.</p>
619
620</div>
621</div><p>
622<a class="anchor" name="37363ba319fa9230cce3b969dbcf6f1a"></a><!-- doxytag: member="itpp::Modulator_NRD::update_norm" ref="37363ba319fa9230cce3b969dbcf6f1a" args="(double &amp;norm, int k, int sold, int snew, const vec &amp;ytH, const mat &amp;HtH, const ivec &amp;s)" -->
623<div class="memitem">
624<div class="memproto">
625      <table class="memname">
626        <tr>
627          <td class="memname">void itpp::Modulator_NRD::update_norm           </td>
628          <td>(</td>
629          <td class="paramtype">double &amp;&nbsp;</td>
630          <td class="paramname"> <em>norm</em>, </td>
631        </tr>
632        <tr>
633          <td class="paramkey"></td>
634          <td></td>
635          <td class="paramtype">int&nbsp;</td>
636          <td class="paramname"> <em>k</em>, </td>
637        </tr>
638        <tr>
639          <td class="paramkey"></td>
640          <td></td>
641          <td class="paramtype">int&nbsp;</td>
642          <td class="paramname"> <em>sold</em>, </td>
643        </tr>
644        <tr>
645          <td class="paramkey"></td>
646          <td></td>
647          <td class="paramtype">int&nbsp;</td>
648          <td class="paramname"> <em>snew</em>, </td>
649        </tr>
650        <tr>
651          <td class="paramkey"></td>
652          <td></td>
653          <td class="paramtype">const vec &amp;&nbsp;</td>
654          <td class="paramname"> <em>ytH</em>, </td>
655        </tr>
656        <tr>
657          <td class="paramkey"></td>
658          <td></td>
659          <td class="paramtype">const mat &amp;&nbsp;</td>
660          <td class="paramname"> <em>HtH</em>, </td>
661        </tr>
662        <tr>
663          <td class="paramkey"></td>
664          <td></td>
665          <td class="paramtype">const ivec &amp;&nbsp;</td>
666          <td class="paramname"> <em>s</em></td><td>&nbsp;</td>
667        </tr>
668        <tr>
669          <td></td>
670          <td>)</td>
671          <td></td><td></td><td><code> [protected]</code></td>
672        </tr>
673      </table>
674</div>
675<div class="memdoc">
676
677<p>
678Update residual norm (for internal use).
679<p>
680Update the residual norm <img class="formulaInl" alt="$|y-Hs|$" src="form_300.png"> when moving from one constellation point to an adjacent point.<p>
681<dl compact><dt><b>Parameters:</b></dt><dd>
682  <table border="0" cellspacing="2" cellpadding="0">
683    <tr><td valign="top"><tt>[in,out]</tt>&nbsp;</td><td valign="top"><em>norm</em>&nbsp;</td><td>Norm to be updated </td></tr>
684    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>k</em>&nbsp;</td><td>Position where s changed </td></tr>
685    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>sold</em>&nbsp;</td><td>Old value of s[k] </td></tr>
686    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>snew</em>&nbsp;</td><td>New value of s[k] </td></tr>
687    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>ytH</em>&nbsp;</td><td>y'H vector </td></tr>
688    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>HtH</em>&nbsp;</td><td>Grammian matrix H'H </td></tr>
689    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>s</em>&nbsp;</td><td>Symbol vector </td></tr>
690  </table>
691</dl>
692
693<p>References <a class="el" href="matfunc_8h-source.html#l00051">itpp::length()</a>, <a class="el" href="elem__math_8h-source.html#l00056">itpp::sqr()</a>, and <a class="el" href="modulator__nd_8h-source.html#l00294">symbols</a>.</p>
694
695<p>Referenced by <a class="el" href="modulator__nd_8cpp-source.html#l00224">demodulate_soft_bits()</a>.</p>
696
697</div>
698</div><p>
699<hr><h2>Friends And Related Function Documentation</h2>
700<a class="anchor" name="f82a88fab3e6f7a1e6c0a4a7e17fb678"></a><!-- doxytag: member="itpp::Modulator_NRD::operator&lt;&lt;" ref="f82a88fab3e6f7a1e6c0a4a7e17fb678" args="(std::ostream &amp;os, const Modulator_NRD &amp;m)" -->
701<div class="memitem">
702<div class="memproto">
703      <table class="memname">
704        <tr>
705          <td class="memname">std::ostream &amp; operator&lt;&lt;           </td>
706          <td>(</td>
707          <td class="paramtype">std::ostream &amp;&nbsp;</td>
708          <td class="paramname"> <em>os</em>, </td>
709        </tr>
710        <tr>
711          <td class="paramkey"></td>
712          <td></td>
713          <td class="paramtype">const <a class="el" href="classitpp_1_1Modulator__NRD.html">Modulator_NRD</a> &amp;&nbsp;</td>
714          <td class="paramname"> <em>m</em></td><td>&nbsp;</td>
715        </tr>
716        <tr>
717          <td></td>
718          <td>)</td>
719          <td></td><td></td><td><code> [friend]</code></td>
720        </tr>
721      </table>
722</div>
723<div class="memdoc">
724
725<p>
726Output some properties of the MIMO modulator (mainly to aid debugging).
727<p>
728Print some properties of the MIMO modulator (mainly to aid debugging).
729</div>
730</div><p>
731<hr>The documentation for this class was generated from the following files:<ul>
732<li><a class="el" href="modulator__nd_8h-source.html">modulator_nd.h</a><li><a class="el" href="modulator__nd_8cpp.html">modulator_nd.cpp</a></ul>
733</div>
734<hr size="1"><address style="text-align: right;"><small>Generated on Tue Jun 2 10:02:19 2009 for mixpp by&nbsp;
735<a href="http://www.doxygen.org/index.html">
736<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
737</body>
738</html>
Note: See TracBrowser for help on using the browser.