root/doc/html/modulator__nd_8h-source.html @ 353

Revision 353, 38.2 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: modulator_nd.h Source File</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><a href="annotated.html"><span>Classes</span></a></li>
56      <li class="current"><a href="files.html"><span>Files</span></a></li>
57    </ul>
58  </div>
59  <div class="tabs">
60    <ul>
61      <li><a href="files.html"><span>File&nbsp;List</span></a></li>
62      <li><a href="globals.html"><span>File&nbsp;Members</span></a></li>
63    </ul>
64  </div>
65<h1>modulator_nd.h</h1><a href="modulator__nd_8h.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001
66<a name="l00029"></a>00029 <span class="preprocessor">#ifndef MODULATOR_ND_H</span>
67<a name="l00030"></a>00030 <span class="preprocessor"></span><span class="preprocessor">#define MODULATOR_ND_H</span>
68<a name="l00031"></a>00031 <span class="preprocessor"></span>
69<a name="l00032"></a>00032 <span class="preprocessor">#include &lt;<a class="code" href="vec_8h.html" title="Templated Vector Class Definitions.">itpp/base/vec.h</a>&gt;</span>
70<a name="l00033"></a>00033 <span class="preprocessor">#include &lt;<a class="code" href="array_8h.html" title="Definition of Array class (container).">itpp/base/array.h</a>&gt;</span>
71<a name="l00034"></a>00034 <span class="preprocessor">#include &lt;<a class="code" href="llr_8h.html" title="Class for numerically efficient log-likelihood algebra.">itpp/comm/llr.h</a>&gt;</span>
72<a name="l00035"></a>00035
73<a name="l00036"></a>00036 <span class="keyword">namespace </span>itpp
74<a name="l00037"></a>00037 {
75<a name="l00038"></a>00038
76<a name="l00043"></a>00043 <span class="comment">// ----------------------------------------------------------------------</span>
77<a name="l00044"></a>00044 <span class="comment">// Modulator_ND</span>
78<a name="l00045"></a>00045 <span class="comment">// ----------------------------------------------------------------------</span>
79<a name="l00046"></a>00046
80<a name="l00058"></a><a class="code" href="classitpp_1_1Modulator__ND.html">00058</a> <span class="keyword">class </span><a class="code" href="classitpp_1_1Modulator__ND.html" title="Base class for an N-dimensional (ND) vector (MIMO) modulator.">Modulator_ND</a>
81<a name="l00059"></a>00059 {
82<a name="l00060"></a>00060 <span class="keyword">public</span>:
83<a name="l00062"></a><a class="code" href="classitpp_1_1Modulator__ND.html#6e3b4c745f904cdb34301aeb4cc03035">00062</a>   <span class="keyword">enum</span> <a class="code" href="classitpp_1_1Modulator__ND.html#6e3b4c745f904cdb34301aeb4cc03035" title="Soft demodulation method.">Soft_Demod_Method</a> {
84<a name="l00064"></a><a class="code" href="classitpp_1_1Modulator__ND.html#6e3b4c745f904cdb34301aeb4cc03035c743f79c2dbf90c34fd03075b7648058">00064</a>     <a class="code" href="classitpp_1_1Modulator__ND.html#6e3b4c745f904cdb34301aeb4cc03035c743f79c2dbf90c34fd03075b7648058" title="Log-MAP demodulation by &amp;quot;brute-force&amp;quot; enumeration of all points.">FULL_ENUM_LOGMAP</a>,
85<a name="l00066"></a><a class="code" href="classitpp_1_1Modulator__ND.html#6e3b4c745f904cdb34301aeb4cc03035d5798fd18f93f399475392b8aee09cba">00066</a>     <a class="code" href="classitpp_1_1Modulator__ND.html#6e3b4c745f904cdb34301aeb4cc03035d5798fd18f93f399475392b8aee09cba" title="Zero-Forcing Log-MAP approximated demodulation.">ZF_LOGMAP</a>
86<a name="l00067"></a>00067   };
87<a name="l00068"></a>00068
88<a name="l00070"></a><a class="code" href="classitpp_1_1Modulator__ND.html#bccded6493ae83d65a5e9dd44c2f1861">00070</a>   <a class="code" href="classitpp_1_1Modulator__ND.html#bccded6493ae83d65a5e9dd44c2f1861" title="Default constructor.">Modulator_ND</a>(<a class="code" href="classitpp_1_1LLR__calc__unit.html" title="Log-likelihood algebra calculation unit.">LLR_calc_unit</a> llrcalc_in = <a class="code" href="classitpp_1_1LLR__calc__unit.html" title="Log-likelihood algebra calculation unit.">LLR_calc_unit</a>()):
89<a name="l00071"></a>00071       <a class="code" href="classitpp_1_1Modulator__ND.html#8690246ff99fd198a5e7d179954ac5a9" title="LLR calculation unit.">llrcalc</a>(llrcalc_in) {}
90<a name="l00073"></a><a class="code" href="classitpp_1_1Modulator__ND.html#acd9f3d099c05b0298a31032db3f7f7e">00073</a>   <a class="code" href="classitpp_1_1Modulator__ND.html#acd9f3d099c05b0298a31032db3f7f7e" title="Destructor.">~Modulator_ND</a>() {}
91<a name="l00074"></a>00074
92<a name="l00076"></a><a class="code" href="classitpp_1_1Modulator__ND.html#e5a2e50b1bf055d6db9f56bd4fe83105">00076</a>   <span class="keywordtype">void</span> <a class="code" href="classitpp_1_1Modulator__ND.html#e5a2e50b1bf055d6db9f56bd4fe83105" title="Set LLR calculation unit.">set_llrcalc</a>(<a class="code" href="classitpp_1_1LLR__calc__unit.html" title="Log-likelihood algebra calculation unit.">LLR_calc_unit</a> llrcalc_in) { <a class="code" href="classitpp_1_1Modulator__ND.html#8690246ff99fd198a5e7d179954ac5a9" title="LLR calculation unit.">llrcalc</a> = llrcalc_in; };
93<a name="l00077"></a>00077
94<a name="l00079"></a><a class="code" href="classitpp_1_1Modulator__ND.html#b68aa9155f305d9fb4e8d3cab45d5c9d">00079</a>   <a class="code" href="classitpp_1_1LLR__calc__unit.html" title="Log-likelihood algebra calculation unit.">LLR_calc_unit</a> <a class="code" href="classitpp_1_1Modulator__ND.html#b68aa9155f305d9fb4e8d3cab45d5c9d" title="Get LLR calculation unit.">get_llrcalc</a>()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> <a class="code" href="classitpp_1_1Modulator__ND.html#8690246ff99fd198a5e7d179954ac5a9" title="LLR calculation unit.">llrcalc</a>; }
95<a name="l00080"></a>00080
96<a name="l00082"></a><a class="code" href="classitpp_1_1Modulator__ND.html#64691da50e1a9f604c41bdda141d477a">00082</a>   <span class="keywordtype">int</span> <a class="code" href="classitpp_1_1Modulator__ND.html#64691da50e1a9f604c41bdda141d477a" title="Get number of dimensions.">get_dim</a>()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> <a class="code" href="classitpp_1_1Modulator__ND.html#18f0f81646514aa7210415f83fc62c1b" title="Number of dimensions.">nt</a>; }
97<a name="l00083"></a>00083
98<a name="l00085"></a><a class="code" href="classitpp_1_1Modulator__ND.html#aa89b07529c5c5bbe75d4c6b45f9264c">00085</a>   ivec <a class="code" href="classitpp_1_1Modulator__ND.html#aa89b07529c5c5bbe75d4c6b45f9264c" title="Get number of bits per modulation symbol per dimension.">get_k</a>()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> <a class="code" href="classitpp_1_1Modulator__ND.html#5545e8651244ffca103252926fb18a1c" title="Number of bits per modulation symbol.">k</a>; }
99<a name="l00086"></a>00086
100<a name="l00088"></a><a class="code" href="classitpp_1_1Modulator__ND.html#a9f88563e5de7dd446f0c61c86976c76">00088</a>   ivec <a class="code" href="classitpp_1_1Modulator__ND.html#a9f88563e5de7dd446f0c61c86976c76" title="Get number of modulation symbols per dimension.">get_M</a>()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> <a class="code" href="classitpp_1_1Modulator__ND.html#45916df32ce60b4c286367501482b441" title="Number of modulation symbols along each dimension.">M</a>; }
101<a name="l00089"></a>00089
102<a name="l00090"></a>00090 <span class="keyword">protected</span>:
103<a name="l00092"></a><a class="code" href="classitpp_1_1Modulator__ND.html#18f0f81646514aa7210415f83fc62c1b">00092</a>   <span class="keywordtype">int</span> <a class="code" href="classitpp_1_1Modulator__ND.html#18f0f81646514aa7210415f83fc62c1b" title="Number of dimensions.">nt</a>;
104<a name="l00094"></a><a class="code" href="classitpp_1_1Modulator__ND.html#8690246ff99fd198a5e7d179954ac5a9">00094</a>   <a class="code" href="classitpp_1_1LLR__calc__unit.html" title="Log-likelihood algebra calculation unit.">LLR_calc_unit</a> <a class="code" href="classitpp_1_1Modulator__ND.html#8690246ff99fd198a5e7d179954ac5a9" title="LLR calculation unit.">llrcalc</a>;
105<a name="l00096"></a><a class="code" href="classitpp_1_1Modulator__ND.html#5545e8651244ffca103252926fb18a1c">00096</a>   ivec <a class="code" href="classitpp_1_1Modulator__ND.html#5545e8651244ffca103252926fb18a1c" title="Number of bits per modulation symbol.">k</a>;
106<a name="l00098"></a><a class="code" href="classitpp_1_1Modulator__ND.html#45916df32ce60b4c286367501482b441">00098</a>   ivec <a class="code" href="classitpp_1_1Modulator__ND.html#45916df32ce60b4c286367501482b441" title="Number of modulation symbols along each dimension.">M</a>;
107<a name="l00100"></a><a class="code" href="classitpp_1_1Modulator__ND.html#cf19a4c13454739dfa68d0b9f6a85211">00100</a>   <a class="code" href="classitpp_1_1Array.html">Array&lt;bmat&gt;</a> <a class="code" href="classitpp_1_1Modulator__ND.html#cf19a4c13454739dfa68d0b9f6a85211" title="Bit mapping table (one table per dimension).">bitmap</a>;
108<a name="l00102"></a><a class="code" href="classitpp_1_1Modulator__ND.html#123a047e221467e2f63b4e353963b1a7">00102</a>   <a class="code" href="classitpp_1_1Array.html">Array&lt;ivec&gt;</a> <a class="code" href="classitpp_1_1Modulator__ND.html#123a047e221467e2f63b4e353963b1a7" title="Bit pattern in decimal form ordered and the corresponding symbols (one pattern per...">bits2symbols</a>;
109<a name="l00103"></a>00103
110<a name="l00105"></a>00105   QLLRvec <a class="code" href="classitpp_1_1Modulator__ND.html#a7eaacc702e0564b3388b9fb9413d301" title="Convert LLR to log-probabilities.">probabilities</a>(QLLR l); <span class="comment">// some abuse of what QLLR stands for...</span>
111<a name="l00106"></a>00106
112<a name="l00108"></a>00108   <a class="code" href="classitpp_1_1Array.html" title="General array class.">Array&lt;QLLRvec&gt;</a> <a class="code" href="classitpp_1_1Modulator__ND.html#a7eaacc702e0564b3388b9fb9413d301" title="Convert LLR to log-probabilities.">probabilities</a>(<span class="keyword">const</span> QLLRvec &amp;l);
113<a name="l00109"></a>00109
114<a name="l00128"></a>00128   <span class="keywordtype">void</span> <a class="code" href="classitpp_1_1Modulator__ND.html#48975e0d26dac075e1f448bdca15ca87" title="Update LLR (for internal use).">update_LLR</a>(<span class="keyword">const</span> <a class="code" href="classitpp_1_1Array.html" title="General array class.">Array&lt;QLLRvec&gt;</a> &amp;logP_apriori, <span class="keyword">const</span> ivec &amp;s,
115<a name="l00129"></a>00129                   QLLR scaled_norm, QLLRvec &amp;num, QLLRvec &amp;denom);
116<a name="l00130"></a>00130
117<a name="l00150"></a>00150   <span class="keywordtype">void</span> <a class="code" href="classitpp_1_1Modulator__ND.html#48975e0d26dac075e1f448bdca15ca87" title="Update LLR (for internal use).">update_LLR</a>(<span class="keyword">const</span> <a class="code" href="classitpp_1_1Array.html" title="General array class.">Array&lt;QLLRvec&gt;</a> &amp;logP_apriori, <span class="keywordtype">int</span> s,
118<a name="l00151"></a>00151                   QLLR scaled_norm, <span class="keywordtype">int</span> j, QLLRvec &amp;num, QLLRvec &amp;denom);
119<a name="l00152"></a>00152 };
120<a name="l00153"></a>00153
121<a name="l00154"></a>00154
122<a name="l00155"></a>00155 <span class="comment">// ----------------------------------------------------------------------</span>
123<a name="l00156"></a>00156 <span class="comment">// Modulator_NRD</span>
124<a name="l00157"></a>00157 <span class="comment">// ----------------------------------------------------------------------</span>
125<a name="l00158"></a>00158
126<a name="l00183"></a><a class="code" href="classitpp_1_1Modulator__NRD.html">00183</a> <span class="keyword">class </span><a class="code" href="classitpp_1_1Modulator__NRD.html" title="Base class for N-dimensional vector (MIMO) channel modulators/demodulators with real-valued...">Modulator_NRD</a> : <span class="keyword">public</span> <a class="code" href="classitpp_1_1Modulator__ND.html" title="Base class for an N-dimensional (ND) vector (MIMO) modulator.">Modulator_ND</a>
127<a name="l00184"></a>00184 {
128<a name="l00185"></a>00185 <span class="keyword">public</span>:
129<a name="l00187"></a><a class="code" href="classitpp_1_1Modulator__NRD.html#e605e4949369ceb91017ce18fac8fda6">00187</a>   <a class="code" href="classitpp_1_1Modulator__NRD.html#e605e4949369ceb91017ce18fac8fda6" title="Constructor.">Modulator_NRD</a>() {}
130<a name="l00189"></a><a class="code" href="classitpp_1_1Modulator__NRD.html#5424e615eeaa0a3c8c4d2613540ff786">00189</a>   <a class="code" href="classitpp_1_1Modulator__NRD.html#5424e615eeaa0a3c8c4d2613540ff786" title="Destructor.">~Modulator_NRD</a>() {}
131<a name="l00190"></a>00190
132<a name="l00192"></a><a class="code" href="classitpp_1_1Modulator__NRD.html#85019d35a647571786af4eedce111544">00192</a>   <a class="code" href="classitpp_1_1Array.html">Array&lt;vec&gt;</a> <a class="code" href="classitpp_1_1Modulator__NRD.html#85019d35a647571786af4eedce111544" title="Get modulation symbols per dimension.">get_symbols</a>()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> <a class="code" href="classitpp_1_1Modulator__NRD.html#a5a276d6745c7a38dd4ae6b5eb70147e" title="Vectors of modulation symbols (along each dimension).">symbols</a>; }
133<a name="l00193"></a>00193
134<a name="l00195"></a>00195   <span class="keywordtype">void</span> <a class="code" href="classitpp_1_1Modulator__NRD.html#f8993b9fc18d5a8ca4564ea3b928f22c" title="Modulate bits into symbols.">modulate_bits</a>(<span class="keyword">const</span> bvec &amp;bits, vec &amp;<a class="code" href="classitpp_1_1Modulator__NRD.html#a5a276d6745c7a38dd4ae6b5eb70147e" title="Vectors of modulation symbols (along each dimension).">symbols</a>) <span class="keyword">const</span>;
135<a name="l00196"></a>00196
136<a name="l00198"></a>00198   vec <a class="code" href="classitpp_1_1Modulator__NRD.html#f8993b9fc18d5a8ca4564ea3b928f22c" title="Modulate bits into symbols.">modulate_bits</a>(<span class="keyword">const</span> bvec &amp;bits) <span class="keyword">const</span>;
137<a name="l00199"></a>00199
138<a name="l00218"></a>00218   <span class="keywordtype">void</span> <a class="code" href="classitpp_1_1Modulator__NRD.html#42d28853cead832c7e7644366023601b" title="Soft demodulation wrapper function for various methods.">demodulate_soft_bits</a>(<span class="keyword">const</span> vec &amp;y, <span class="keyword">const</span> mat &amp;H, <span class="keywordtype">double</span> sigma2,
139<a name="l00219"></a>00219                             <span class="keyword">const</span> QLLRvec &amp;LLR_apriori,
140<a name="l00220"></a>00220                             QLLRvec &amp;LLR_aposteriori,
141<a name="l00221"></a>00221                             <a class="code" href="classitpp_1_1Modulator__ND.html#6e3b4c745f904cdb34301aeb4cc03035" title="Soft demodulation method.">Soft_Demod_Method</a> method);
142<a name="l00222"></a>00222
143<a name="l00241"></a>00241   QLLRvec <a class="code" href="classitpp_1_1Modulator__NRD.html#42d28853cead832c7e7644366023601b" title="Soft demodulation wrapper function for various methods.">demodulate_soft_bits</a>(<span class="keyword">const</span> vec &amp;y, <span class="keyword">const</span> mat &amp;H, <span class="keywordtype">double</span> sigma2,
144<a name="l00242"></a>00242                                <span class="keyword">const</span> QLLRvec &amp;LLR_apriori,
145<a name="l00243"></a>00243                                <a class="code" href="classitpp_1_1Modulator__ND.html#6e3b4c745f904cdb34301aeb4cc03035" title="Soft demodulation method.">Soft_Demod_Method</a> method);
146<a name="l00244"></a>00244
147<a name="l00273"></a>00273   <span class="keywordtype">void</span> <a class="code" href="classitpp_1_1Modulator__NRD.html#42d28853cead832c7e7644366023601b" title="Soft demodulation wrapper function for various methods.">demodulate_soft_bits</a>(<span class="keyword">const</span> vec &amp;y, <span class="keyword">const</span> mat &amp;H, <span class="keywordtype">double</span> sigma2,
148<a name="l00274"></a>00274                             <span class="keyword">const</span> QLLRvec &amp;LLR_apriori,
149<a name="l00275"></a>00275                             QLLRvec &amp;LLR_aposteriori);
150<a name="l00276"></a>00276
151<a name="l00284"></a>00284   <span class="keywordtype">void</span> <a class="code" href="classitpp_1_1Modulator__NRD.html#42d28853cead832c7e7644366023601b" title="Soft demodulation wrapper function for various methods.">demodulate_soft_bits</a>(<span class="keyword">const</span> vec &amp;y, <span class="keyword">const</span> vec &amp;h, <span class="keywordtype">double</span> sigma2,
152<a name="l00285"></a>00285                             <span class="keyword">const</span> QLLRvec &amp;LLR_apriori,
153<a name="l00286"></a>00286                             QLLRvec &amp;LLR_aposteriori);
154<a name="l00287"></a>00287
155<a name="l00288"></a>00288
156<a name="l00290"></a>00290   <span class="keyword">friend</span> std::ostream &amp;<a class="code" href="classitpp_1_1Modulator__NRD.html#f82a88fab3e6f7a1e6c0a4a7e17fb678" title="Output some properties of the MIMO modulator (mainly to aid debugging).">operator&lt;&lt;</a>(std::ostream &amp;os, <span class="keyword">const</span> <a class="code" href="classitpp_1_1Modulator__NRD.html" title="Base class for N-dimensional vector (MIMO) channel modulators/demodulators with real-valued...">Modulator_NRD</a> &amp;m);
157<a name="l00291"></a>00291
158<a name="l00292"></a>00292 <span class="keyword">protected</span>:
159<a name="l00294"></a><a class="code" href="classitpp_1_1Modulator__NRD.html#a5a276d6745c7a38dd4ae6b5eb70147e">00294</a>   <a class="code" href="classitpp_1_1Array.html">Array&lt;vec&gt;</a> <a class="code" href="classitpp_1_1Modulator__NRD.html#a5a276d6745c7a38dd4ae6b5eb70147e" title="Vectors of modulation symbols (along each dimension).">symbols</a>;
160<a name="l00295"></a>00295
161<a name="l00310"></a>00310   <span class="keywordtype">void</span> <a class="code" href="classitpp_1_1Modulator__NRD.html#37363ba319fa9230cce3b969dbcf6f1a" title="Update residual norm (for internal use).">update_norm</a>(<span class="keywordtype">double</span> &amp;<a class="code" href="group__statistics.html#gc2a8340331beb29e8f97baa00b2e31b8" title="Calculate the Frobenius norm for s = &amp;quot;fro&amp;quot; (equal to 2-norm).">norm</a>, <span class="keywordtype">int</span> <a class="code" href="classitpp_1_1Modulator__ND.html#5545e8651244ffca103252926fb18a1c" title="Number of bits per modulation symbol.">k</a>, <span class="keywordtype">int</span> sold, <span class="keywordtype">int</span> snew, <span class="keyword">const</span> vec &amp;ytH,
162<a name="l00311"></a>00311                    <span class="keyword">const</span> mat &amp;HtH, <span class="keyword">const</span> ivec &amp;s);
163<a name="l00312"></a>00312 };
164<a name="l00313"></a>00313
165<a name="l00318"></a>00318 std::ostream &amp;<a class="code" href="group__fixed.html#g46e967850e616363aeabd2cda5bcc159" title="Set output mode.">operator&lt;&lt;</a>(std::ostream &amp;os, <span class="keyword">const</span> <a class="code" href="classitpp_1_1Modulator__NRD.html" title="Base class for N-dimensional vector (MIMO) channel modulators/demodulators with real-valued...">Modulator_NRD</a> &amp;m);
166<a name="l00319"></a>00319
167<a name="l00320"></a>00320
168<a name="l00321"></a>00321 <span class="comment">// ----------------------------------------------------------------------</span>
169<a name="l00322"></a>00322 <span class="comment">// Modulator_NCD</span>
170<a name="l00323"></a>00323 <span class="comment">// ----------------------------------------------------------------------</span>
171<a name="l00324"></a>00324
172<a name="l00335"></a><a class="code" href="classitpp_1_1Modulator__NCD.html">00335</a> <span class="keyword">class </span><a class="code" href="classitpp_1_1Modulator__NCD.html" title="Base class for vector (MIMO) channel modulator/demodulators with complex valued components...">Modulator_NCD</a> : <span class="keyword">public</span> <a class="code" href="classitpp_1_1Modulator__ND.html" title="Base class for an N-dimensional (ND) vector (MIMO) modulator.">Modulator_ND</a>
173<a name="l00336"></a>00336 {
174<a name="l00337"></a>00337 <span class="keyword">public</span>:
175<a name="l00339"></a><a class="code" href="classitpp_1_1Modulator__NCD.html#11407bf656e5d3f2c2ecdc5109414078">00339</a>   <a class="code" href="classitpp_1_1Modulator__NCD.html#11407bf656e5d3f2c2ecdc5109414078" title="Constructor.">Modulator_NCD</a>() {}
176<a name="l00341"></a><a class="code" href="classitpp_1_1Modulator__NCD.html#6ddf4836ce64d08181002e708f4f6091">00341</a>   <a class="code" href="classitpp_1_1Modulator__NCD.html#6ddf4836ce64d08181002e708f4f6091" title="Destructor.">~Modulator_NCD</a>() {}
177<a name="l00342"></a>00342
178<a name="l00344"></a><a class="code" href="classitpp_1_1Modulator__NCD.html#41b6b6b9a21039a88a1ba07f358cd43a">00344</a>   <a class="code" href="classitpp_1_1Array.html">Array&lt;cvec&gt;</a> <a class="code" href="classitpp_1_1Modulator__NCD.html#41b6b6b9a21039a88a1ba07f358cd43a" title="Get modulation symbols per dimension.">get_symbols</a>()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> <a class="code" href="classitpp_1_1Modulator__NCD.html#e6948b64b0a10e47fd0a864ead0516b7" title="Vectors of modulation symbols (along each dimension).">symbols</a>; }
179<a name="l00345"></a>00345
180<a name="l00347"></a>00347   <span class="keywordtype">void</span> <a class="code" href="classitpp_1_1Modulator__NCD.html#6e0475c4f4dc96d08f5f4707a9dfaf17" title="Modulate bits into symbols.">modulate_bits</a>(<span class="keyword">const</span> bvec &amp;bits, cvec &amp;<a class="code" href="classitpp_1_1Modulator__NCD.html#e6948b64b0a10e47fd0a864ead0516b7" title="Vectors of modulation symbols (along each dimension).">symbols</a>) <span class="keyword">const</span>;
181<a name="l00348"></a>00348
182<a name="l00350"></a>00350   cvec <a class="code" href="classitpp_1_1Modulator__NCD.html#6e0475c4f4dc96d08f5f4707a9dfaf17" title="Modulate bits into symbols.">modulate_bits</a>(<span class="keyword">const</span> bvec &amp;bits) <span class="keyword">const</span>;
183<a name="l00351"></a>00351
184<a name="l00353"></a>00353
185<a name="l00372"></a>00372   <span class="keywordtype">void</span> <a class="code" href="classitpp_1_1Modulator__NCD.html#a25a04d3c20e24c033a1dd152e674f7c" title="Soft demodulation wrapper function for various methods.">demodulate_soft_bits</a>(<span class="keyword">const</span> cvec &amp;y, <span class="keyword">const</span> cmat &amp;H, <span class="keywordtype">double</span> sigma2,
186<a name="l00373"></a>00373                             <span class="keyword">const</span> QLLRvec &amp;LLR_apriori,
187<a name="l00374"></a>00374                             QLLRvec &amp;LLR_aposteriori,
188<a name="l00375"></a>00375                             <a class="code" href="classitpp_1_1Modulator__ND.html#6e3b4c745f904cdb34301aeb4cc03035" title="Soft demodulation method.">Soft_Demod_Method</a> method);
189<a name="l00376"></a>00376
190<a name="l00396"></a>00396   QLLRvec <a class="code" href="classitpp_1_1Modulator__NCD.html#a25a04d3c20e24c033a1dd152e674f7c" title="Soft demodulation wrapper function for various methods.">demodulate_soft_bits</a>(<span class="keyword">const</span> cvec &amp;y, <span class="keyword">const</span> cmat &amp;H, <span class="keywordtype">double</span> sigma2,
191<a name="l00397"></a>00397                                <span class="keyword">const</span> QLLRvec &amp;LLR_apriori,
192<a name="l00398"></a>00398                                <a class="code" href="classitpp_1_1Modulator__ND.html#6e3b4c745f904cdb34301aeb4cc03035" title="Soft demodulation method.">Soft_Demod_Method</a> method);
193<a name="l00399"></a>00399
194<a name="l00428"></a>00428   <span class="keywordtype">void</span> <a class="code" href="classitpp_1_1Modulator__NCD.html#a25a04d3c20e24c033a1dd152e674f7c" title="Soft demodulation wrapper function for various methods.">demodulate_soft_bits</a>(<span class="keyword">const</span> cvec &amp;y, <span class="keyword">const</span> cmat &amp;H, <span class="keywordtype">double</span> sigma2,
195<a name="l00429"></a>00429                             <span class="keyword">const</span> QLLRvec &amp;LLR_apriori,
196<a name="l00430"></a>00430                             QLLRvec &amp;LLR_aposteriori);
197<a name="l00431"></a>00431
198<a name="l00439"></a>00439   <span class="keywordtype">void</span> <a class="code" href="classitpp_1_1Modulator__NCD.html#a25a04d3c20e24c033a1dd152e674f7c" title="Soft demodulation wrapper function for various methods.">demodulate_soft_bits</a>(<span class="keyword">const</span> cvec &amp;y, <span class="keyword">const</span> cvec &amp;H, <span class="keywordtype">double</span> sigma2,
199<a name="l00440"></a>00440                             <span class="keyword">const</span> QLLRvec &amp;LLR_apriori,
200<a name="l00441"></a>00441                             QLLRvec &amp;LLR_aposteriori);
201<a name="l00442"></a>00442
202<a name="l00444"></a>00444   <span class="keyword">friend</span> std::ostream &amp;<a class="code" href="classitpp_1_1Modulator__NCD.html#5934d627a296bb0e22e09c3d9051553b" title="Print some properties of the MIMO modulator (mainly to aid debugging).">operator&lt;&lt;</a>(std::ostream &amp;os, <span class="keyword">const</span> <a class="code" href="classitpp_1_1Modulator__NCD.html" title="Base class for vector (MIMO) channel modulator/demodulators with complex valued components...">Modulator_NCD</a> &amp;m);
203<a name="l00445"></a>00445
204<a name="l00446"></a>00446 <span class="keyword">protected</span>:
205<a name="l00448"></a><a class="code" href="classitpp_1_1Modulator__NCD.html#e6948b64b0a10e47fd0a864ead0516b7">00448</a>   <a class="code" href="classitpp_1_1Array.html">Array&lt;cvec&gt;</a> <a class="code" href="classitpp_1_1Modulator__NCD.html#e6948b64b0a10e47fd0a864ead0516b7" title="Vectors of modulation symbols (along each dimension).">symbols</a>;
206<a name="l00449"></a>00449
207<a name="l00464"></a>00464   <span class="keywordtype">void</span> <a class="code" href="classitpp_1_1Modulator__NCD.html#27e760213e8c30b93fc338b4a6e3a864" title="Update residual norm (for internal use).">update_norm</a>(<span class="keywordtype">double</span> &amp;<a class="code" href="group__statistics.html#gc2a8340331beb29e8f97baa00b2e31b8" title="Calculate the Frobenius norm for s = &amp;quot;fro&amp;quot; (equal to 2-norm).">norm</a>, <span class="keywordtype">int</span> <a class="code" href="classitpp_1_1Modulator__ND.html#5545e8651244ffca103252926fb18a1c" title="Number of bits per modulation symbol.">k</a>, <span class="keywordtype">int</span> sold, <span class="keywordtype">int</span> snew, <span class="keyword">const</span> cvec &amp;ytH,
208<a name="l00465"></a>00465                    <span class="keyword">const</span> cmat &amp;HtH, <span class="keyword">const</span> ivec &amp;s);
209<a name="l00466"></a>00466 };
210<a name="l00467"></a>00467
211<a name="l00472"></a>00472 std::ostream &amp;<a class="code" href="group__fixed.html#g46e967850e616363aeabd2cda5bcc159" title="Set output mode.">operator&lt;&lt;</a>(std::ostream &amp;os, <span class="keyword">const</span> <a class="code" href="classitpp_1_1Modulator__NCD.html" title="Base class for vector (MIMO) channel modulator/demodulators with complex valued components...">Modulator_NCD</a> &amp;m);
212<a name="l00473"></a>00473
213<a name="l00474"></a>00474
214<a name="l00475"></a>00475 <span class="comment">// ----------------------------------------------------------------------</span>
215<a name="l00476"></a>00476 <span class="comment">// ND_UPAM</span>
216<a name="l00477"></a>00477 <span class="comment">// ----------------------------------------------------------------------</span>
217<a name="l00478"></a>00478
218<a name="l00517"></a><a class="code" href="classitpp_1_1ND__UPAM.html">00517</a> <span class="keyword">class </span><a class="code" href="classitpp_1_1ND__UPAM.html" title="Real-valued MIMO channel with uniform PAM along each dimension.">ND_UPAM</a> : <span class="keyword">public</span> <a class="code" href="classitpp_1_1Modulator__NRD.html" title="Base class for N-dimensional vector (MIMO) channel modulators/demodulators with real-valued...">Modulator_NRD</a>
219<a name="l00518"></a>00518 {
220<a name="l00519"></a>00519 <span class="keyword">public</span>:
221<a name="l00521"></a>00521   <a class="code" href="classitpp_1_1ND__UPAM.html#5b440db5066286247a0177272c1176be" title="Constructor.">ND_UPAM</a>(<span class="keywordtype">int</span> <a class="code" href="classitpp_1_1Modulator__ND.html#18f0f81646514aa7210415f83fc62c1b" title="Number of dimensions.">nt</a> = 1, <span class="keywordtype">int</span> Mary = 2);
222<a name="l00523"></a><a class="code" href="classitpp_1_1ND__UPAM.html#b26eff798737d05ee27b45b904385cf8">00523</a>   <a class="code" href="classitpp_1_1ND__UPAM.html#b26eff798737d05ee27b45b904385cf8" title="Destructor.">~ND_UPAM</a>() {}
223<a name="l00524"></a>00524
224<a name="l00526"></a>00526   <span class="keywordtype">void</span> <a class="code" href="classitpp_1_1ND__UPAM.html#83dd565c60cd49a332eb780a7a9b21a3" title="Set component modulators to M-PAM with Gray mapping.">set_M</a>(<span class="keywordtype">int</span> <a class="code" href="classitpp_1_1Modulator__ND.html#18f0f81646514aa7210415f83fc62c1b" title="Number of dimensions.">nt</a> = 1, <span class="keywordtype">int</span> Mary = 2);
225<a name="l00527"></a>00527
226<a name="l00529"></a>00529   <span class="keywordtype">void</span> <a class="code" href="classitpp_1_1ND__UPAM.html#83dd565c60cd49a332eb780a7a9b21a3" title="Set component modulators to M-PAM with Gray mapping.">set_M</a>(<span class="keywordtype">int</span> <a class="code" href="classitpp_1_1Modulator__ND.html#18f0f81646514aa7210415f83fc62c1b" title="Number of dimensions.">nt</a> = 1, ivec Mary = <span class="stringliteral">"2"</span>);
227<a name="l00530"></a>00530
228<a name="l00554"></a>00554   <span class="keywordtype">int</span> <a class="code" href="classitpp_1_1ND__UPAM.html#7f53ad7f4de6b0e7f6260905ed522cd2" title="Sphere decoding.">sphere_decoding</a>(<span class="keyword">const</span> vec &amp;y, <span class="keyword">const</span> mat &amp;H, <span class="keywordtype">double</span> rmin, <span class="keywordtype">double</span> rmax,
229<a name="l00555"></a>00555                       <span class="keywordtype">double</span> stepup, QLLRvec &amp;detected_bits);
230<a name="l00556"></a>00556
231<a name="l00557"></a>00557 <span class="keyword">private</span>:
232<a name="l00558"></a>00558   <span class="comment">// Sphere decoding search with Schnorr Eucner strategy.</span>
233<a name="l00559"></a>00559   <span class="keywordtype">int</span> sphere_search_SE(<span class="keyword">const</span> vec &amp;y, <span class="keyword">const</span> mat &amp;H, <span class="keyword">const</span> imat &amp;zrange,
234<a name="l00560"></a>00560                        <span class="keywordtype">double</span> r, ivec &amp;zhat);
235<a name="l00561"></a>00561
236<a name="l00562"></a>00562   vec spacing;  <span class="comment">// spacing between the constellation points</span>
237<a name="l00563"></a>00563
238<a name="l00564"></a>00564   <span class="keyword">inline</span> <span class="keywordtype">int</span> sign_nozero_i(<span class="keywordtype">int</span> a) { <span class="keywordflow">return</span> (a &gt; 0 ? 1 : -1); }
239<a name="l00565"></a>00565   <span class="keyword">inline</span> <span class="keywordtype">int</span> sign_nozero_i(<span class="keywordtype">double</span> a) { <span class="keywordflow">return</span> (a &gt; 0.0 ? 1 : -1); }
240<a name="l00566"></a>00566 };
241<a name="l00567"></a>00567
242<a name="l00568"></a>00568 <span class="comment">// ----------------------------------------------------------------------</span>
243<a name="l00569"></a>00569 <span class="comment">// ND_UQAM</span>
244<a name="l00570"></a>00570 <span class="comment">// ----------------------------------------------------------------------</span>
245<a name="l00571"></a>00571
246<a name="l00576"></a><a class="code" href="classitpp_1_1ND__UQAM.html">00576</a> <span class="keyword">class </span><a class="code" href="classitpp_1_1ND__UQAM.html" title="Complex MIMO channel with uniform QAM per dimension.">ND_UQAM</a> : <span class="keyword">public</span> <a class="code" href="classitpp_1_1Modulator__NCD.html" title="Base class for vector (MIMO) channel modulator/demodulators with complex valued components...">Modulator_NCD</a>
247<a name="l00577"></a>00577 {
248<a name="l00578"></a>00578 <span class="keyword">public</span>:
249<a name="l00580"></a>00580   <a class="code" href="classitpp_1_1ND__UQAM.html#44b3a101a493535b4f880aae1c70088c" title="Constructor.">ND_UQAM</a>(<span class="keywordtype">int</span> <a class="code" href="classitpp_1_1Modulator__ND.html#18f0f81646514aa7210415f83fc62c1b" title="Number of dimensions.">nt</a> = 1, <span class="keywordtype">int</span> Mary = 4);
250<a name="l00582"></a><a class="code" href="classitpp_1_1ND__UQAM.html#5a7f76f5a99d363b2865e406be2877ae">00582</a>   <a class="code" href="classitpp_1_1ND__UQAM.html#5a7f76f5a99d363b2865e406be2877ae" title="Destructor.">~ND_UQAM</a>() {}
251<a name="l00583"></a>00583
252<a name="l00585"></a>00585   <span class="keywordtype">void</span> <a class="code" href="classitpp_1_1ND__UQAM.html#e52a188982cb681b069e7d6e985a7d06" title="Set component modulators to M-QAM with Gray mapping.">set_M</a>(<span class="keywordtype">int</span> <a class="code" href="classitpp_1_1Modulator__ND.html#18f0f81646514aa7210415f83fc62c1b" title="Number of dimensions.">nt</a> = 1, <span class="keywordtype">int</span> Mary = 4);
253<a name="l00586"></a>00586
254<a name="l00588"></a>00588   <span class="keywordtype">void</span> <a class="code" href="classitpp_1_1ND__UQAM.html#e52a188982cb681b069e7d6e985a7d06" title="Set component modulators to M-QAM with Gray mapping.">set_M</a>(<span class="keywordtype">int</span> <a class="code" href="classitpp_1_1Modulator__ND.html#18f0f81646514aa7210415f83fc62c1b" title="Number of dimensions.">nt</a> = 1, ivec Mary = <span class="stringliteral">"4"</span>);
255<a name="l00589"></a>00589
256<a name="l00590"></a>00590 <span class="keyword">protected</span>:
257<a name="l00591"></a><a class="code" href="classitpp_1_1ND__UQAM.html#0964f260688bac5b09cd1a51b49155ff">00591</a>   ivec <a class="code" href="classitpp_1_1ND__UQAM.html#0964f260688bac5b09cd1a51b49155ff" title="the square root of M">L</a>; 
258<a name="l00592"></a>00592 };
259<a name="l00593"></a>00593
260<a name="l00594"></a>00594 <span class="comment">// ----------------------------------------------------------------------</span>
261<a name="l00595"></a>00595 <span class="comment">// ND_UPSK</span>
262<a name="l00596"></a>00596 <span class="comment">// ----------------------------------------------------------------------</span>
263<a name="l00597"></a>00597
264<a name="l00602"></a><a class="code" href="classitpp_1_1ND__UPSK.html">00602</a> <span class="keyword">class </span><a class="code" href="classitpp_1_1ND__UPSK.html">ND_UPSK</a> : <span class="keyword">public</span> <a class="code" href="classitpp_1_1Modulator__NCD.html" title="Base class for vector (MIMO) channel modulator/demodulators with complex valued components...">Modulator_NCD</a>
265<a name="l00603"></a>00603 {
266<a name="l00604"></a>00604 <span class="keyword">public</span>:
267<a name="l00606"></a>00606   <a class="code" href="classitpp_1_1ND__UPSK.html#d95ce3ccb3e6c8dc40a77cf5bc7e81ac" title="Constructor.">ND_UPSK</a>(<span class="keywordtype">int</span> <a class="code" href="classitpp_1_1Modulator__ND.html#18f0f81646514aa7210415f83fc62c1b" title="Number of dimensions.">nt</a> = 1, <span class="keywordtype">int</span> Mary = 4);
268<a name="l00608"></a><a class="code" href="classitpp_1_1ND__UPSK.html#6cb9cf0924ee337173ec95b9187ce302">00608</a>   <a class="code" href="classitpp_1_1ND__UPSK.html#6cb9cf0924ee337173ec95b9187ce302" title="Destructor.">~ND_UPSK</a>() {}
269<a name="l00609"></a>00609
270<a name="l00611"></a>00611   <span class="keywordtype">void</span> <a class="code" href="classitpp_1_1ND__UPSK.html#00e4f0aa17f66d3487bcf04b4dc1816c" title="Set component modulators to M-QAM with Gray mapping.">set_M</a>(<span class="keywordtype">int</span> <a class="code" href="classitpp_1_1Modulator__ND.html#18f0f81646514aa7210415f83fc62c1b" title="Number of dimensions.">nt</a> = 1, <span class="keywordtype">int</span> Mary = 4);
271<a name="l00612"></a>00612
272<a name="l00614"></a>00614   <span class="keywordtype">void</span> <a class="code" href="classitpp_1_1ND__UPSK.html#00e4f0aa17f66d3487bcf04b4dc1816c" title="Set component modulators to M-QAM with Gray mapping.">set_M</a>(<span class="keywordtype">int</span> <a class="code" href="classitpp_1_1Modulator__ND.html#18f0f81646514aa7210415f83fc62c1b" title="Number of dimensions.">nt</a> = 1, ivec Mary = <span class="stringliteral">"4"</span>);
273<a name="l00615"></a>00615 };
274<a name="l00616"></a>00616
275<a name="l00617"></a>00617
276<a name="l00618"></a>00618 } <span class="comment">// namespace itpp</span>
277<a name="l00619"></a>00619
278<a name="l00620"></a>00620 <span class="preprocessor">#endif // #ifndef MODULATOR_ND_H</span>
279<a name="l00621"></a>00621 <span class="preprocessor"></span>
280</pre></div></div>
281<hr size="1"><address style="text-align: right;"><small>Generated on Tue Jun 2 10:02:12 2009 for mixpp by&nbsp;
282<a href="http://www.doxygen.org/index.html">
283<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
284</body>
285</html>
Note: See TracBrowser for help on using the browser.