[353] | 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::ND_UQAM 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 | <!-- |
---|
| 10 | function 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 | } |
---|
| 22 | function 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 | } |
---|
| 46 | window.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 Page</span></a></li> |
---|
| 53 | <li><a href="pages.html"><span>Related 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 List</span></a></li> |
---|
| 62 | <li><a href="classes.html"><span>Class Index</span></a></li> |
---|
| 63 | <li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li> |
---|
| 64 | <li><a href="functions.html"><span>Class Members</span></a></li> |
---|
| 65 | </ul> |
---|
| 66 | </div> |
---|
| 67 | <div class="navpath"><b>itpp</b>::<a class="el" href="classitpp_1_1ND__UQAM.html">ND_UQAM</a> |
---|
| 68 | </div> |
---|
| 69 | </div> |
---|
| 70 | <div class="contents"> |
---|
| 71 | <h1>itpp::ND_UQAM Class Reference<br> |
---|
| 72 | <small> |
---|
| 73 | [<a class="el" href="group__modulators.html">Digital Modulation</a>]</small> |
---|
| 74 | </h1><!-- doxytag: class="itpp::ND_UQAM" --><!-- doxytag: inherits="itpp::Modulator_NCD" -->Complex MIMO channel with uniform <a class="el" href="classitpp_1_1QAM.html" title="M-ary QAM modulator with square lattice.">QAM</a> per dimension. |
---|
| 75 | <a href="#_details">More...</a> |
---|
| 76 | <p> |
---|
| 77 | <code>#include <<a class="el" href="modulator__nd_8h-source.html">modulator_nd.h</a>></code> |
---|
| 78 | <p> |
---|
| 79 | |
---|
| 80 | <p> |
---|
| 81 | <a href="classitpp_1_1ND__UQAM-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 </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"> </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="44b3a101a493535b4f880aae1c70088c"></a><!-- doxytag: member="itpp::ND_UQAM::ND_UQAM" ref="44b3a101a493535b4f880aae1c70088c" args="(int nt=1, int Mary=4)" --> |
---|
| 91 | </td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1ND__UQAM.html#44b3a101a493535b4f880aae1c70088c">ND_UQAM</a> (int <a class="el" href="classitpp_1_1Modulator__ND.html#18f0f81646514aa7210415f83fc62c1b">nt</a>=1, int Mary=4)</td></tr> |
---|
| 92 | |
---|
| 93 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Constructor. <br></td></tr> |
---|
| 94 | <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="5a7f76f5a99d363b2865e406be2877ae"></a><!-- doxytag: member="itpp::ND_UQAM::~ND_UQAM" ref="5a7f76f5a99d363b2865e406be2877ae" args="()" --> |
---|
| 95 | </td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1ND__UQAM.html#5a7f76f5a99d363b2865e406be2877ae">~ND_UQAM</a> ()</td></tr> |
---|
| 96 | |
---|
| 97 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Destructor. <br></td></tr> |
---|
| 98 | <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="e52a188982cb681b069e7d6e985a7d06"></a><!-- doxytag: member="itpp::ND_UQAM::set_M" ref="e52a188982cb681b069e7d6e985a7d06" args="(int nt=1, int Mary=4)" --> |
---|
| 99 | void </td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1ND__UQAM.html#e52a188982cb681b069e7d6e985a7d06">set_M</a> (int <a class="el" href="classitpp_1_1Modulator__ND.html#18f0f81646514aa7210415f83fc62c1b">nt</a>=1, int Mary=4)</td></tr> |
---|
| 100 | |
---|
| 101 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Set component modulators to M-QAM with Gray mapping. <br></td></tr> |
---|
| 102 | <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="ecfee75e187bcdaf37a5fe16aa56554a"></a><!-- doxytag: member="itpp::ND_UQAM::set_M" ref="ecfee75e187bcdaf37a5fe16aa56554a" args="(int nt=1, ivec Mary="4")" --> |
---|
| 103 | void </td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1ND__UQAM.html#ecfee75e187bcdaf37a5fe16aa56554a">set_M</a> (int <a class="el" href="classitpp_1_1Modulator__ND.html#18f0f81646514aa7210415f83fc62c1b">nt</a>=1, ivec Mary="4")</td></tr> |
---|
| 104 | |
---|
| 105 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Set component modulators to M-QAM with Gray mapping, different M per component. <br></td></tr> |
---|
| 106 | <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="41b6b6b9a21039a88a1ba07f358cd43a"></a><!-- doxytag: member="itpp::ND_UQAM::get_symbols" ref="41b6b6b9a21039a88a1ba07f358cd43a" args="() const " --> |
---|
| 107 | <a class="el" href="classitpp_1_1Array.html">Array</a>< cvec > </td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__NCD.html#41b6b6b9a21039a88a1ba07f358cd43a">get_symbols</a> () const </td></tr> |
---|
| 108 | |
---|
| 109 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Get modulation symbols per dimension. <br></td></tr> |
---|
| 110 | <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="6e0475c4f4dc96d08f5f4707a9dfaf17"></a><!-- doxytag: member="itpp::ND_UQAM::modulate_bits" ref="6e0475c4f4dc96d08f5f4707a9dfaf17" args="(const bvec &bits, cvec &symbols) const " --> |
---|
| 111 | void </td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__NCD.html#6e0475c4f4dc96d08f5f4707a9dfaf17">modulate_bits</a> (const bvec &bits, cvec &<a class="el" href="classitpp_1_1Modulator__NCD.html#e6948b64b0a10e47fd0a864ead0516b7">symbols</a>) const </td></tr> |
---|
| 112 | |
---|
| 113 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Modulate <code>bits</code> into <code>symbols</code>. <br></td></tr> |
---|
| 114 | <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="1bee64f0ca29bf8ef1dea72a083ff4ad"></a><!-- doxytag: member="itpp::ND_UQAM::modulate_bits" ref="1bee64f0ca29bf8ef1dea72a083ff4ad" args="(const bvec &bits) const " --> |
---|
| 115 | cvec </td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__NCD.html#1bee64f0ca29bf8ef1dea72a083ff4ad">modulate_bits</a> (const bvec &bits) const </td></tr> |
---|
| 116 | |
---|
| 117 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Modulation of bits. <br></td></tr> |
---|
| 118 | <tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__NCD.html#a25a04d3c20e24c033a1dd152e674f7c">demodulate_soft_bits</a> (const cvec &y, const cmat &H, double sigma2, const QLLRvec &LLR_apriori, QLLRvec &LLR_aposteriori, <a class="el" href="classitpp_1_1Modulator__ND.html#6e3b4c745f904cdb34301aeb4cc03035">Soft_Demod_Method</a> method)</td></tr> |
---|
| 119 | |
---|
| 120 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Soft demodulation wrapper function for various methods. <a href="#a25a04d3c20e24c033a1dd152e674f7c"></a><br></td></tr> |
---|
| 121 | <tr><td class="memItemLeft" nowrap align="right" valign="top">QLLRvec </td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__NCD.html#a45b72fcdc70134a46710d7a5a381976">demodulate_soft_bits</a> (const cvec &y, const cmat &H, double sigma2, const QLLRvec &LLR_apriori, <a class="el" href="classitpp_1_1Modulator__ND.html#6e3b4c745f904cdb34301aeb4cc03035">Soft_Demod_Method</a> method)</td></tr> |
---|
| 122 | |
---|
| 123 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Soft demodulation wrapper function for various methods. <a href="#a45b72fcdc70134a46710d7a5a381976"></a><br></td></tr> |
---|
| 124 | <tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__NCD.html#ca10f18dbcf7542db0c0d8078f7834ae">demodulate_soft_bits</a> (const cvec &y, const cmat &H, double sigma2, const QLLRvec &LLR_apriori, QLLRvec &LLR_aposteriori)</td></tr> |
---|
| 125 | |
---|
| 126 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Soft MAP demodulation for multidimensional channel, by "brute-force" enumeration of all constellation points. <a href="#ca10f18dbcf7542db0c0d8078f7834ae"></a><br></td></tr> |
---|
| 127 | <tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__NCD.html#544faf2c9477cf7b2fa2f69efc7b3abe">demodulate_soft_bits</a> (const cvec &y, const cvec &H, double sigma2, const QLLRvec &LLR_apriori, QLLRvec &LLR_aposteriori)</td></tr> |
---|
| 128 | |
---|
| 129 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Soft MAP demodulation for parallelchannels without crosstalk. <a href="#544faf2c9477cf7b2fa2f69efc7b3abe"></a><br></td></tr> |
---|
| 130 | <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="e5a2e50b1bf055d6db9f56bd4fe83105"></a><!-- doxytag: member="itpp::ND_UQAM::set_llrcalc" ref="e5a2e50b1bf055d6db9f56bd4fe83105" args="(LLR_calc_unit llrcalc_in)" --> |
---|
| 131 | void </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> |
---|
| 132 | |
---|
| 133 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Set LLR calculation unit. <br></td></tr> |
---|
| 134 | <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="b68aa9155f305d9fb4e8d3cab45d5c9d"></a><!-- doxytag: member="itpp::ND_UQAM::get_llrcalc" ref="b68aa9155f305d9fb4e8d3cab45d5c9d" args="() const " --> |
---|
| 135 | <a class="el" href="classitpp_1_1LLR__calc__unit.html">LLR_calc_unit</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__ND.html#b68aa9155f305d9fb4e8d3cab45d5c9d">get_llrcalc</a> () const </td></tr> |
---|
| 136 | |
---|
| 137 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Get LLR calculation unit. <br></td></tr> |
---|
| 138 | <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="64691da50e1a9f604c41bdda141d477a"></a><!-- doxytag: member="itpp::ND_UQAM::get_dim" ref="64691da50e1a9f604c41bdda141d477a" args="() const " --> |
---|
| 139 | int </td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__ND.html#64691da50e1a9f604c41bdda141d477a">get_dim</a> () const </td></tr> |
---|
| 140 | |
---|
| 141 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Get number of dimensions. <br></td></tr> |
---|
| 142 | <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="aa89b07529c5c5bbe75d4c6b45f9264c"></a><!-- doxytag: member="itpp::ND_UQAM::get_k" ref="aa89b07529c5c5bbe75d4c6b45f9264c" args="() const " --> |
---|
| 143 | ivec </td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__ND.html#aa89b07529c5c5bbe75d4c6b45f9264c">get_k</a> () const </td></tr> |
---|
| 144 | |
---|
| 145 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Get number of bits per modulation symbol per dimension. <br></td></tr> |
---|
| 146 | <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="a9f88563e5de7dd446f0c61c86976c76"></a><!-- doxytag: member="itpp::ND_UQAM::get_M" ref="a9f88563e5de7dd446f0c61c86976c76" args="() const " --> |
---|
| 147 | ivec </td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__ND.html#a9f88563e5de7dd446f0c61c86976c76">get_M</a> () const </td></tr> |
---|
| 148 | |
---|
| 149 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Get number of modulation symbols per dimension. <br></td></tr> |
---|
| 150 | <tr><td colspan="2"><br><h2>Protected Member Functions</h2></td></tr> |
---|
| 151 | <tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__NCD.html#27e760213e8c30b93fc338b4a6e3a864">update_norm</a> (double &norm, int <a class="el" href="classitpp_1_1Modulator__ND.html#5545e8651244ffca103252926fb18a1c">k</a>, int sold, int snew, const cvec &ytH, const cmat &HtH, const ivec &s)</td></tr> |
---|
| 152 | |
---|
| 153 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Update residual norm (for internal use). <a href="#27e760213e8c30b93fc338b4a6e3a864"></a><br></td></tr> |
---|
| 154 | <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="a7eaacc702e0564b3388b9fb9413d301"></a><!-- doxytag: member="itpp::ND_UQAM::probabilities" ref="a7eaacc702e0564b3388b9fb9413d301" args="(QLLR l)" --> |
---|
| 155 | QLLRvec </td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__ND.html#a7eaacc702e0564b3388b9fb9413d301">probabilities</a> (QLLR l)</td></tr> |
---|
| 156 | |
---|
| 157 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Convert LLR to log-probabilities. <br></td></tr> |
---|
| 158 | <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="6278bfead2080abfd50998067336eb12"></a><!-- doxytag: member="itpp::ND_UQAM::probabilities" ref="6278bfead2080abfd50998067336eb12" args="(const QLLRvec &l)" --> |
---|
| 159 | <a class="el" href="classitpp_1_1Array.html">Array</a>< QLLRvec > </td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__ND.html#6278bfead2080abfd50998067336eb12">probabilities</a> (const QLLRvec &l)</td></tr> |
---|
| 160 | |
---|
| 161 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Convert LLR to log-probabilities, vector version. <br></td></tr> |
---|
| 162 | <tr><td class="memItemLeft" nowrap align="right" valign="top">void </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>< QLLRvec > &logP_apriori, const ivec &s, QLLR scaled_norm, QLLRvec &num, QLLRvec &denom)</td></tr> |
---|
| 163 | |
---|
| 164 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Update LLR (for internal use). <a href="#48975e0d26dac075e1f448bdca15ca87"></a><br></td></tr> |
---|
| 165 | <tr><td class="memItemLeft" nowrap align="right" valign="top">void </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>< QLLRvec > &logP_apriori, int s, QLLR scaled_norm, int j, QLLRvec &num, QLLRvec &denom)</td></tr> |
---|
| 166 | |
---|
| 167 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Update LLR, for scalar channel (for internal use). <a href="#6bb417318b8105a78db7ad2c618283ce"></a><br></td></tr> |
---|
| 168 | <tr><td colspan="2"><br><h2>Protected Attributes</h2></td></tr> |
---|
| 169 | <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="0964f260688bac5b09cd1a51b49155ff"></a><!-- doxytag: member="itpp::ND_UQAM::L" ref="0964f260688bac5b09cd1a51b49155ff" args="" --> |
---|
| 170 | ivec </td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1ND__UQAM.html#0964f260688bac5b09cd1a51b49155ff">L</a></td></tr> |
---|
| 171 | |
---|
| 172 | <tr><td class="mdescLeft"> </td><td class="mdescRight">the square root of M <br></td></tr> |
---|
| 173 | <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="e6948b64b0a10e47fd0a864ead0516b7"></a><!-- doxytag: member="itpp::ND_UQAM::symbols" ref="e6948b64b0a10e47fd0a864ead0516b7" args="" --> |
---|
| 174 | <a class="el" href="classitpp_1_1Array.html">Array</a>< cvec > </td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__NCD.html#e6948b64b0a10e47fd0a864ead0516b7">symbols</a></td></tr> |
---|
| 175 | |
---|
| 176 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Vectors of modulation symbols (along each dimension). <br></td></tr> |
---|
| 177 | <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="18f0f81646514aa7210415f83fc62c1b"></a><!-- doxytag: member="itpp::ND_UQAM::nt" ref="18f0f81646514aa7210415f83fc62c1b" args="" --> |
---|
| 178 | int </td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__ND.html#18f0f81646514aa7210415f83fc62c1b">nt</a></td></tr> |
---|
| 179 | |
---|
| 180 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Number of dimensions. <br></td></tr> |
---|
| 181 | <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="8690246ff99fd198a5e7d179954ac5a9"></a><!-- doxytag: member="itpp::ND_UQAM::llrcalc" ref="8690246ff99fd198a5e7d179954ac5a9" args="" --> |
---|
| 182 | <a class="el" href="classitpp_1_1LLR__calc__unit.html">LLR_calc_unit</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__ND.html#8690246ff99fd198a5e7d179954ac5a9">llrcalc</a></td></tr> |
---|
| 183 | |
---|
| 184 | <tr><td class="mdescLeft"> </td><td class="mdescRight">LLR calculation unit. <br></td></tr> |
---|
| 185 | <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="5545e8651244ffca103252926fb18a1c"></a><!-- doxytag: member="itpp::ND_UQAM::k" ref="5545e8651244ffca103252926fb18a1c" args="" --> |
---|
| 186 | ivec </td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__ND.html#5545e8651244ffca103252926fb18a1c">k</a></td></tr> |
---|
| 187 | |
---|
| 188 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Number of bits per modulation symbol. <br></td></tr> |
---|
| 189 | <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="45916df32ce60b4c286367501482b441"></a><!-- doxytag: member="itpp::ND_UQAM::M" ref="45916df32ce60b4c286367501482b441" args="" --> |
---|
| 190 | ivec </td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__ND.html#45916df32ce60b4c286367501482b441">M</a></td></tr> |
---|
| 191 | |
---|
| 192 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Number of modulation symbols along each dimension. <br></td></tr> |
---|
| 193 | <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="cf19a4c13454739dfa68d0b9f6a85211"></a><!-- doxytag: member="itpp::ND_UQAM::bitmap" ref="cf19a4c13454739dfa68d0b9f6a85211" args="" --> |
---|
| 194 | <a class="el" href="classitpp_1_1Array.html">Array</a>< <a class="el" href="mat_8h.html#f90acd1af41bf2d1d8a4bb23662fff69">bmat</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__ND.html#cf19a4c13454739dfa68d0b9f6a85211">bitmap</a></td></tr> |
---|
| 195 | |
---|
| 196 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Bit mapping table (one table per dimension). <br></td></tr> |
---|
| 197 | <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="123a047e221467e2f63b4e353963b1a7"></a><!-- doxytag: member="itpp::ND_UQAM::bits2symbols" ref="123a047e221467e2f63b4e353963b1a7" args="" --> |
---|
| 198 | <a class="el" href="classitpp_1_1Array.html">Array</a>< ivec > </td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__ND.html#123a047e221467e2f63b4e353963b1a7">bits2symbols</a></td></tr> |
---|
| 199 | |
---|
| 200 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Bit pattern in decimal form ordered and the corresponding symbols (one pattern per dimension). <br></td></tr> |
---|
| 201 | <tr><td colspan="2"><br><h2>Friends</h2></td></tr> |
---|
| 202 | <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="5934d627a296bb0e22e09c3d9051553b"></a><!-- doxytag: member="itpp::ND_UQAM::operator<<" ref="5934d627a296bb0e22e09c3d9051553b" args="(std::ostream &os, const Modulator_NCD &m)" --> |
---|
| 203 | std::ostream & </td><td class="memItemRight" valign="bottom"><a class="el" href="classitpp_1_1Modulator__NCD.html#5934d627a296bb0e22e09c3d9051553b">operator<<</a> (std::ostream &os, const <a class="el" href="classitpp_1_1Modulator__NCD.html">Modulator_NCD</a> &m)</td></tr> |
---|
| 204 | |
---|
| 205 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Print some properties of the MIMO modulator (mainly to aid debugging). <br></td></tr> |
---|
| 206 | </table> |
---|
| 207 | <hr><a name="_details"></a><h2>Detailed Description</h2> |
---|
| 208 | Complex MIMO channel with uniform <a class="el" href="classitpp_1_1QAM.html" title="M-ary QAM modulator with square lattice.">QAM</a> per dimension. <hr><h2>Member Enumeration Documentation</h2> |
---|
| 209 | <a class="anchor" name="6e3b4c745f904cdb34301aeb4cc03035"></a><!-- doxytag: member="itpp::ND_UQAM::Soft_Demod_Method" ref="6e3b4c745f904cdb34301aeb4cc03035" args="" --> |
---|
| 210 | <div class="memitem"> |
---|
| 211 | <div class="memproto"> |
---|
| 212 | <table class="memname"> |
---|
| 213 | <tr> |
---|
| 214 | <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> |
---|
| 215 | </tr> |
---|
| 216 | </table> |
---|
| 217 | </div> |
---|
| 218 | <div class="memdoc"> |
---|
| 219 | |
---|
| 220 | <p> |
---|
| 221 | Soft demodulation method. |
---|
| 222 | <p> |
---|
| 223 | <dl compact><dt><b>Enumerator: </b></dt><dd> |
---|
| 224 | <table border="0" cellspacing="2" cellpadding="0"> |
---|
| 225 | <tr><td valign="top"><em><a class="anchor" name="6e3b4c745f904cdb34301aeb4cc03035c743f79c2dbf90c34fd03075b7648058"></a><!-- doxytag: member="FULL_ENUM_LOGMAP" ref="6e3b4c745f904cdb34301aeb4cc03035c743f79c2dbf90c34fd03075b7648058" args="" -->FULL_ENUM_LOGMAP</em> </td><td> |
---|
| 226 | Log-MAP demodulation by "brute-force" enumeration of all points. </td></tr> |
---|
| 227 | <tr><td valign="top"><em><a class="anchor" name="6e3b4c745f904cdb34301aeb4cc03035d5798fd18f93f399475392b8aee09cba"></a><!-- doxytag: member="ZF_LOGMAP" ref="6e3b4c745f904cdb34301aeb4cc03035d5798fd18f93f399475392b8aee09cba" args="" -->ZF_LOGMAP</em> </td><td> |
---|
| 228 | Zero-Forcing Log-MAP approximated demodulation. </td></tr> |
---|
| 229 | </table> |
---|
| 230 | </dl> |
---|
| 231 | |
---|
| 232 | </div> |
---|
| 233 | </div><p> |
---|
| 234 | <hr><h2>Member Function Documentation</h2> |
---|
| 235 | <a class="anchor" name="544faf2c9477cf7b2fa2f69efc7b3abe"></a><!-- doxytag: member="itpp::ND_UQAM::demodulate_soft_bits" ref="544faf2c9477cf7b2fa2f69efc7b3abe" args="(const cvec &y, const cvec &H, double sigma2, const QLLRvec &LLR_apriori, QLLRvec &LLR_aposteriori)" --> |
---|
| 236 | <div class="memitem"> |
---|
| 237 | <div class="memproto"> |
---|
| 238 | <table class="memname"> |
---|
| 239 | <tr> |
---|
| 240 | <td class="memname">void itpp::Modulator_NCD::demodulate_soft_bits </td> |
---|
| 241 | <td>(</td> |
---|
| 242 | <td class="paramtype">const cvec & </td> |
---|
| 243 | <td class="paramname"> <em>y</em>, </td> |
---|
| 244 | </tr> |
---|
| 245 | <tr> |
---|
| 246 | <td class="paramkey"></td> |
---|
| 247 | <td></td> |
---|
| 248 | <td class="paramtype">const cvec & </td> |
---|
| 249 | <td class="paramname"> <em>H</em>, </td> |
---|
| 250 | </tr> |
---|
| 251 | <tr> |
---|
| 252 | <td class="paramkey"></td> |
---|
| 253 | <td></td> |
---|
| 254 | <td class="paramtype">double </td> |
---|
| 255 | <td class="paramname"> <em>sigma2</em>, </td> |
---|
| 256 | </tr> |
---|
| 257 | <tr> |
---|
| 258 | <td class="paramkey"></td> |
---|
| 259 | <td></td> |
---|
| 260 | <td class="paramtype">const QLLRvec & </td> |
---|
| 261 | <td class="paramname"> <em>LLR_apriori</em>, </td> |
---|
| 262 | </tr> |
---|
| 263 | <tr> |
---|
| 264 | <td class="paramkey"></td> |
---|
| 265 | <td></td> |
---|
| 266 | <td class="paramtype">QLLRvec & </td> |
---|
| 267 | <td class="paramname"> <em>LLR_aposteriori</em></td><td> </td> |
---|
| 268 | </tr> |
---|
| 269 | <tr> |
---|
| 270 | <td></td> |
---|
| 271 | <td>)</td> |
---|
| 272 | <td></td><td></td><td><code> [inherited]</code></td> |
---|
| 273 | </tr> |
---|
| 274 | </table> |
---|
| 275 | </div> |
---|
| 276 | <div class="memdoc"> |
---|
| 277 | |
---|
| 278 | <p> |
---|
| 279 | Soft MAP demodulation for parallelchannels without crosstalk. |
---|
| 280 | <p> |
---|
| 281 | This 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. |
---|
| 282 | <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#l00448">itpp::Modulator_NCD::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> |
---|
| 283 | |
---|
| 284 | </div> |
---|
| 285 | </div><p> |
---|
| 286 | <a class="anchor" name="ca10f18dbcf7542db0c0d8078f7834ae"></a><!-- doxytag: member="itpp::ND_UQAM::demodulate_soft_bits" ref="ca10f18dbcf7542db0c0d8078f7834ae" args="(const cvec &y, const cmat &H, double sigma2, const QLLRvec &LLR_apriori, QLLRvec &LLR_aposteriori)" --> |
---|
| 287 | <div class="memitem"> |
---|
| 288 | <div class="memproto"> |
---|
| 289 | <table class="memname"> |
---|
| 290 | <tr> |
---|
| 291 | <td class="memname">void itpp::Modulator_NCD::demodulate_soft_bits </td> |
---|
| 292 | <td>(</td> |
---|
| 293 | <td class="paramtype">const cvec & </td> |
---|
| 294 | <td class="paramname"> <em>y</em>, </td> |
---|
| 295 | </tr> |
---|
| 296 | <tr> |
---|
| 297 | <td class="paramkey"></td> |
---|
| 298 | <td></td> |
---|
| 299 | <td class="paramtype">const cmat & </td> |
---|
| 300 | <td class="paramname"> <em>H</em>, </td> |
---|
| 301 | </tr> |
---|
| 302 | <tr> |
---|
| 303 | <td class="paramkey"></td> |
---|
| 304 | <td></td> |
---|
| 305 | <td class="paramtype">double </td> |
---|
| 306 | <td class="paramname"> <em>sigma2</em>, </td> |
---|
| 307 | </tr> |
---|
| 308 | <tr> |
---|
| 309 | <td class="paramkey"></td> |
---|
| 310 | <td></td> |
---|
| 311 | <td class="paramtype">const QLLRvec & </td> |
---|
| 312 | <td class="paramname"> <em>LLR_apriori</em>, </td> |
---|
| 313 | </tr> |
---|
| 314 | <tr> |
---|
| 315 | <td class="paramkey"></td> |
---|
| 316 | <td></td> |
---|
| 317 | <td class="paramtype">QLLRvec & </td> |
---|
| 318 | <td class="paramname"> <em>LLR_aposteriori</em></td><td> </td> |
---|
| 319 | </tr> |
---|
| 320 | <tr> |
---|
| 321 | <td></td> |
---|
| 322 | <td>)</td> |
---|
| 323 | <td></td><td></td><td><code> [inherited]</code></td> |
---|
| 324 | </tr> |
---|
| 325 | </table> |
---|
| 326 | </div> |
---|
| 327 | <div class="memdoc"> |
---|
| 328 | |
---|
| 329 | <p> |
---|
| 330 | Soft MAP demodulation for multidimensional channel, by "brute-force" enumeration of all constellation points. |
---|
| 331 | <p> |
---|
| 332 | This function computes the LLR values <p class="formulaDsp"> |
---|
| 333 | <img class="formulaDsp" alt="\[ LLR(k) = \log \left( \frac {\sum_{s:b_k=0} \exp \left( -\frac{|y - Hs|^2}{\sigma^2} \right) P(s)} {\sum_{s:b_k=1} \exp \left( -\frac{|y - Hs|^2}{\sigma^2} \right) P(s)} \right) \]" src="form_301.png"> |
---|
| 334 | <p> |
---|
| 335 | <p> |
---|
| 336 | without approximations. It is assumed that H, y and s are complex-valued.<p> |
---|
| 337 | <dl compact><dt><b>Parameters:</b></dt><dd> |
---|
| 338 | <table border="0" cellspacing="2" cellpadding="0"> |
---|
| 339 | <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>y</em> </td><td>Received vector </td></tr> |
---|
| 340 | <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>H</em> </td><td>Channel matrix </td></tr> |
---|
| 341 | <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>sigma2</em> </td><td>Noise variance per complex dimension, i.e. the sum of real and imaginary parts (typically <img class="formulaInl" alt="$N_0$" src="form_233.png">) </td></tr> |
---|
| 342 | <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>LLR_apriori</em> </td><td>Vector of a priori LLR values per bit </td></tr> |
---|
| 343 | <tr><td valign="top"><tt>[out]</tt> </td><td valign="top"><em>LLR_aposteriori</em> </td><td>Vector of a posteriori LLR values</td></tr> |
---|
| 344 | </table> |
---|
| 345 | </dl> |
---|
| 346 | The 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. |
---|
| 347 | <p>References <a class="el" href="fix__functions_8cpp-source.html#l00098">itpp::conj()</a>, <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#l00448">itpp::Modulator_NCD::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>, and <a class="el" href="modulator__nd_8cpp-source.html#l00529">itpp::Modulator_NCD::update_norm()</a>.</p> |
---|
| 348 | |
---|
| 349 | </div> |
---|
| 350 | </div><p> |
---|
| 351 | <a class="anchor" name="a45b72fcdc70134a46710d7a5a381976"></a><!-- doxytag: member="itpp::ND_UQAM::demodulate_soft_bits" ref="a45b72fcdc70134a46710d7a5a381976" args="(const cvec &y, const cmat &H, double sigma2, const QLLRvec &LLR_apriori, Soft_Demod_Method method)" --> |
---|
| 352 | <div class="memitem"> |
---|
| 353 | <div class="memproto"> |
---|
| 354 | <table class="memname"> |
---|
| 355 | <tr> |
---|
| 356 | <td class="memname">QLLRvec itpp::Modulator_NCD::demodulate_soft_bits </td> |
---|
| 357 | <td>(</td> |
---|
| 358 | <td class="paramtype">const cvec & </td> |
---|
| 359 | <td class="paramname"> <em>y</em>, </td> |
---|
| 360 | </tr> |
---|
| 361 | <tr> |
---|
| 362 | <td class="paramkey"></td> |
---|
| 363 | <td></td> |
---|
| 364 | <td class="paramtype">const cmat & </td> |
---|
| 365 | <td class="paramname"> <em>H</em>, </td> |
---|
| 366 | </tr> |
---|
| 367 | <tr> |
---|
| 368 | <td class="paramkey"></td> |
---|
| 369 | <td></td> |
---|
| 370 | <td class="paramtype">double </td> |
---|
| 371 | <td class="paramname"> <em>sigma2</em>, </td> |
---|
| 372 | </tr> |
---|
| 373 | <tr> |
---|
| 374 | <td class="paramkey"></td> |
---|
| 375 | <td></td> |
---|
| 376 | <td class="paramtype">const QLLRvec & </td> |
---|
| 377 | <td class="paramname"> <em>LLR_apriori</em>, </td> |
---|
| 378 | </tr> |
---|
| 379 | <tr> |
---|
| 380 | <td class="paramkey"></td> |
---|
| 381 | <td></td> |
---|
| 382 | <td class="paramtype"><a class="el" href="classitpp_1_1Modulator__ND.html#6e3b4c745f904cdb34301aeb4cc03035">Soft_Demod_Method</a> </td> |
---|
| 383 | <td class="paramname"> <em>method</em></td><td> </td> |
---|
| 384 | </tr> |
---|
| 385 | <tr> |
---|
| 386 | <td></td> |
---|
| 387 | <td>)</td> |
---|
| 388 | <td></td><td></td><td><code> [inherited]</code></td> |
---|
| 389 | </tr> |
---|
| 390 | </table> |
---|
| 391 | </div> |
---|
| 392 | <div class="memdoc"> |
---|
| 393 | |
---|
| 394 | <p> |
---|
| 395 | Soft demodulation wrapper function for various methods. |
---|
| 396 | <p> |
---|
| 397 | Currently the following two demodulation methods are supported:<ul> |
---|
| 398 | <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> |
---|
| 399 | <p> |
---|
| 400 | <dl compact><dt><b>Parameters:</b></dt><dd> |
---|
| 401 | <table border="0" cellspacing="2" cellpadding="0"> |
---|
| 402 | <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>y</em> </td><td>Received vector </td></tr> |
---|
| 403 | <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>H</em> </td><td>Channel matrix </td></tr> |
---|
| 404 | <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>sigma2</em> </td><td>Noise variance per complex dimension, i.e. the sum of real and imaginary parts (typically <img class="formulaInl" alt="$N_0$" src="form_233.png">) </td></tr> |
---|
| 405 | <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>LLR_apriori</em> </td><td>Vector of a priori LLR values per bit </td></tr> |
---|
| 406 | <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>method</em> </td><td>Soft demodulation method </td></tr> |
---|
| 407 | </table> |
---|
| 408 | </dl> |
---|
| 409 | <dl class="return" compact><dt><b>Returns:</b></dt><dd>Vector of a posteriori LLR values </dd></dl> |
---|
| 410 | |
---|
| 411 | <p>References <a class="el" href="modulator__nd_8cpp-source.html#l00370">itpp::Modulator_NCD::demodulate_soft_bits()</a>.</p> |
---|
| 412 | |
---|
| 413 | </div> |
---|
| 414 | </div><p> |
---|
| 415 | <a class="anchor" name="a25a04d3c20e24c033a1dd152e674f7c"></a><!-- doxytag: member="itpp::ND_UQAM::demodulate_soft_bits" ref="a25a04d3c20e24c033a1dd152e674f7c" args="(const cvec &y, const cmat &H, double sigma2, const QLLRvec &LLR_apriori, QLLRvec &LLR_aposteriori, Soft_Demod_Method method)" --> |
---|
| 416 | <div class="memitem"> |
---|
| 417 | <div class="memproto"> |
---|
| 418 | <table class="memname"> |
---|
| 419 | <tr> |
---|
| 420 | <td class="memname">void itpp::Modulator_NCD::demodulate_soft_bits </td> |
---|
| 421 | <td>(</td> |
---|
| 422 | <td class="paramtype">const cvec & </td> |
---|
| 423 | <td class="paramname"> <em>y</em>, </td> |
---|
| 424 | </tr> |
---|
| 425 | <tr> |
---|
| 426 | <td class="paramkey"></td> |
---|
| 427 | <td></td> |
---|
| 428 | <td class="paramtype">const cmat & </td> |
---|
| 429 | <td class="paramname"> <em>H</em>, </td> |
---|
| 430 | </tr> |
---|
| 431 | <tr> |
---|
| 432 | <td class="paramkey"></td> |
---|
| 433 | <td></td> |
---|
| 434 | <td class="paramtype">double </td> |
---|
| 435 | <td class="paramname"> <em>sigma2</em>, </td> |
---|
| 436 | </tr> |
---|
| 437 | <tr> |
---|
| 438 | <td class="paramkey"></td> |
---|
| 439 | <td></td> |
---|
| 440 | <td class="paramtype">const QLLRvec & </td> |
---|
| 441 | <td class="paramname"> <em>LLR_apriori</em>, </td> |
---|
| 442 | </tr> |
---|
| 443 | <tr> |
---|
| 444 | <td class="paramkey"></td> |
---|
| 445 | <td></td> |
---|
| 446 | <td class="paramtype">QLLRvec & </td> |
---|
| 447 | <td class="paramname"> <em>LLR_aposteriori</em>, </td> |
---|
| 448 | </tr> |
---|
| 449 | <tr> |
---|
| 450 | <td class="paramkey"></td> |
---|
| 451 | <td></td> |
---|
| 452 | <td class="paramtype"><a class="el" href="classitpp_1_1Modulator__ND.html#6e3b4c745f904cdb34301aeb4cc03035">Soft_Demod_Method</a> </td> |
---|
| 453 | <td class="paramname"> <em>method</em></td><td> </td> |
---|
| 454 | </tr> |
---|
| 455 | <tr> |
---|
| 456 | <td></td> |
---|
| 457 | <td>)</td> |
---|
| 458 | <td></td><td></td><td><code> [inherited]</code></td> |
---|
| 459 | </tr> |
---|
| 460 | </table> |
---|
| 461 | </div> |
---|
| 462 | <div class="memdoc"> |
---|
| 463 | |
---|
| 464 | <p> |
---|
| 465 | Soft demodulation wrapper function for various methods. |
---|
| 466 | <p> |
---|
| 467 | Soft demodulation wrapper function for various methods Currently the following two demodulation methods are supported:<ul> |
---|
| 468 | <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> |
---|
| 469 | <p> |
---|
| 470 | <dl compact><dt><b>Parameters:</b></dt><dd> |
---|
| 471 | <table border="0" cellspacing="2" cellpadding="0"> |
---|
| 472 | <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>y</em> </td><td>Received vector </td></tr> |
---|
| 473 | <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>H</em> </td><td>Channel matrix </td></tr> |
---|
| 474 | <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>sigma2</em> </td><td>Noise variance per complex dimension, i.e. the sum of real and imaginary parts (typically <img class="formulaInl" alt="$N_0$" src="form_233.png">) </td></tr> |
---|
| 475 | <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>LLR_apriori</em> </td><td>Vector of a priori LLR values per bit </td></tr> |
---|
| 476 | <tr><td valign="top"><tt>[out]</tt> </td><td valign="top"><em>LLR_aposteriori</em> </td><td>Vector of a posteriori LLR values </td></tr> |
---|
| 477 | <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>method</em> </td><td>Soft demodulation method </td></tr> |
---|
| 478 | </table> |
---|
| 479 | </dl> |
---|
| 480 | |
---|
| 481 | <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#g593a539551f14bd6241701910a106b16">itpp::ones_c()</a>, <a class="el" href="fix__functions_8cpp-source.html#l00084">itpp::real()</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> |
---|
| 482 | |
---|
| 483 | <p>Referenced by <a class="el" href="modulator__nd_8cpp-source.html#l00402">itpp::Modulator_NCD::demodulate_soft_bits()</a>.</p> |
---|
| 484 | |
---|
| 485 | </div> |
---|
| 486 | </div><p> |
---|
| 487 | <a class="anchor" name="6bb417318b8105a78db7ad2c618283ce"></a><!-- doxytag: member="itpp::ND_UQAM::update_LLR" ref="6bb417318b8105a78db7ad2c618283ce" args="(const Array< QLLRvec > &logP_apriori, int s, QLLR scaled_norm, int j, QLLRvec &num, QLLRvec &denom)" --> |
---|
| 488 | <div class="memitem"> |
---|
| 489 | <div class="memproto"> |
---|
| 490 | <table class="memname"> |
---|
| 491 | <tr> |
---|
| 492 | <td class="memname">void itpp::Modulator_ND::update_LLR </td> |
---|
| 493 | <td>(</td> |
---|
| 494 | <td class="paramtype">const <a class="el" href="classitpp_1_1Array.html">Array</a>< QLLRvec > & </td> |
---|
| 495 | <td class="paramname"> <em>logP_apriori</em>, </td> |
---|
| 496 | </tr> |
---|
| 497 | <tr> |
---|
| 498 | <td class="paramkey"></td> |
---|
| 499 | <td></td> |
---|
| 500 | <td class="paramtype">int </td> |
---|
| 501 | <td class="paramname"> <em>s</em>, </td> |
---|
| 502 | </tr> |
---|
| 503 | <tr> |
---|
| 504 | <td class="paramkey"></td> |
---|
| 505 | <td></td> |
---|
| 506 | <td class="paramtype">QLLR </td> |
---|
| 507 | <td class="paramname"> <em>scaled_norm</em>, </td> |
---|
| 508 | </tr> |
---|
| 509 | <tr> |
---|
| 510 | <td class="paramkey"></td> |
---|
| 511 | <td></td> |
---|
| 512 | <td class="paramtype">int </td> |
---|
| 513 | <td class="paramname"> <em>j</em>, </td> |
---|
| 514 | </tr> |
---|
| 515 | <tr> |
---|
| 516 | <td class="paramkey"></td> |
---|
| 517 | <td></td> |
---|
| 518 | <td class="paramtype">QLLRvec & </td> |
---|
| 519 | <td class="paramname"> <em>num</em>, </td> |
---|
| 520 | </tr> |
---|
| 521 | <tr> |
---|
| 522 | <td class="paramkey"></td> |
---|
| 523 | <td></td> |
---|
| 524 | <td class="paramtype">QLLRvec & </td> |
---|
| 525 | <td class="paramname"> <em>denom</em></td><td> </td> |
---|
| 526 | </tr> |
---|
| 527 | <tr> |
---|
| 528 | <td></td> |
---|
| 529 | <td>)</td> |
---|
| 530 | <td></td><td></td><td><code> [protected, inherited]</code></td> |
---|
| 531 | </tr> |
---|
| 532 | </table> |
---|
| 533 | </div> |
---|
| 534 | <div class="memdoc"> |
---|
| 535 | |
---|
| 536 | <p> |
---|
| 537 | Update LLR, for scalar channel (for internal use). |
---|
| 538 | <p> |
---|
| 539 | This function updates the numerator and denominator in the expression <p class="formulaDsp"> |
---|
| 540 | <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"> |
---|
| 541 | <p> |
---|
| 542 | <p> |
---|
| 543 | <dl compact><dt><b>Parameters:</b></dt><dd> |
---|
| 544 | <table border="0" cellspacing="2" cellpadding="0"> |
---|
| 545 | <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>logP_apriori</em> </td><td>Vector of a priori probabilities per bit </td></tr> |
---|
| 546 | <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>s</em> </td><td>Symbol </td></tr> |
---|
| 547 | <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>scaled_norm</em> </td><td>Argument of the exponents in the above equation </td></tr> |
---|
| 548 | <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>j</em> </td><td>Channel index (dimension) </td></tr> |
---|
| 549 | <tr><td valign="top"><tt>[out]</tt> </td><td valign="top"><em>num</em> </td><td>Logarithm of the numerator in the above expression </td></tr> |
---|
| 550 | <tr><td valign="top"><tt>[out]</tt> </td><td valign="top"><em>denom</em> </td><td>Logarithm of the denominator in the above expression </td></tr> |
---|
| 551 | </table> |
---|
| 552 | </dl> |
---|
| 553 | |
---|
| 554 | <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> |
---|
| 555 | |
---|
| 556 | </div> |
---|
| 557 | </div><p> |
---|
| 558 | <a class="anchor" name="48975e0d26dac075e1f448bdca15ca87"></a><!-- doxytag: member="itpp::ND_UQAM::update_LLR" ref="48975e0d26dac075e1f448bdca15ca87" args="(const Array< QLLRvec > &logP_apriori, const ivec &s, QLLR scaled_norm, QLLRvec &num, QLLRvec &denom)" --> |
---|
| 559 | <div class="memitem"> |
---|
| 560 | <div class="memproto"> |
---|
| 561 | <table class="memname"> |
---|
| 562 | <tr> |
---|
| 563 | <td class="memname">void itpp::Modulator_ND::update_LLR </td> |
---|
| 564 | <td>(</td> |
---|
| 565 | <td class="paramtype">const <a class="el" href="classitpp_1_1Array.html">Array</a>< QLLRvec > & </td> |
---|
| 566 | <td class="paramname"> <em>logP_apriori</em>, </td> |
---|
| 567 | </tr> |
---|
| 568 | <tr> |
---|
| 569 | <td class="paramkey"></td> |
---|
| 570 | <td></td> |
---|
| 571 | <td class="paramtype">const ivec & </td> |
---|
| 572 | <td class="paramname"> <em>s</em>, </td> |
---|
| 573 | </tr> |
---|
| 574 | <tr> |
---|
| 575 | <td class="paramkey"></td> |
---|
| 576 | <td></td> |
---|
| 577 | <td class="paramtype">QLLR </td> |
---|
| 578 | <td class="paramname"> <em>scaled_norm</em>, </td> |
---|
| 579 | </tr> |
---|
| 580 | <tr> |
---|
| 581 | <td class="paramkey"></td> |
---|
| 582 | <td></td> |
---|
| 583 | <td class="paramtype">QLLRvec & </td> |
---|
| 584 | <td class="paramname"> <em>num</em>, </td> |
---|
| 585 | </tr> |
---|
| 586 | <tr> |
---|
| 587 | <td class="paramkey"></td> |
---|
| 588 | <td></td> |
---|
| 589 | <td class="paramtype">QLLRvec & </td> |
---|
| 590 | <td class="paramname"> <em>denom</em></td><td> </td> |
---|
| 591 | </tr> |
---|
| 592 | <tr> |
---|
| 593 | <td></td> |
---|
| 594 | <td>)</td> |
---|
| 595 | <td></td><td></td><td><code> [protected, inherited]</code></td> |
---|
| 596 | </tr> |
---|
| 597 | </table> |
---|
| 598 | </div> |
---|
| 599 | <div class="memdoc"> |
---|
| 600 | |
---|
| 601 | <p> |
---|
| 602 | Update LLR (for internal use). |
---|
| 603 | <p> |
---|
| 604 | This function updates the numerator and denominator in the expression <p class="formulaDsp"> |
---|
| 605 | <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"> |
---|
| 606 | <p> |
---|
| 607 | <p> |
---|
| 608 | <dl compact><dt><b>Parameters:</b></dt><dd> |
---|
| 609 | <table border="0" cellspacing="2" cellpadding="0"> |
---|
| 610 | <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>logP_apriori</em> </td><td>Vector of a priori probabilities per bit </td></tr> |
---|
| 611 | <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>s</em> </td><td>Symbol vector </td></tr> |
---|
| 612 | <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>scaled_norm</em> </td><td>Argument of the exponents in the above equation </td></tr> |
---|
| 613 | <tr><td valign="top"><tt>[out]</tt> </td><td valign="top"><em>num</em> </td><td>Logarithm of the numerator in the above expression </td></tr> |
---|
| 614 | <tr><td valign="top"><tt>[out]</tt> </td><td valign="top"><em>denom</em> </td><td>Logarithm of the denominator in the above expression </td></tr> |
---|
| 615 | </table> |
---|
| 616 | </dl> |
---|
| 617 | |
---|
| 618 | <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> |
---|
| 619 | |
---|
| 620 | <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">itpp::Modulator_NRD::demodulate_soft_bits()</a>.</p> |
---|
| 621 | |
---|
| 622 | </div> |
---|
| 623 | </div><p> |
---|
| 624 | <a class="anchor" name="27e760213e8c30b93fc338b4a6e3a864"></a><!-- doxytag: member="itpp::ND_UQAM::update_norm" ref="27e760213e8c30b93fc338b4a6e3a864" args="(double &norm, int k, int sold, int snew, const cvec &ytH, const cmat &HtH, const ivec &s)" --> |
---|
| 625 | <div class="memitem"> |
---|
| 626 | <div class="memproto"> |
---|
| 627 | <table class="memname"> |
---|
| 628 | <tr> |
---|
| 629 | <td class="memname">void itpp::Modulator_NCD::update_norm </td> |
---|
| 630 | <td>(</td> |
---|
| 631 | <td class="paramtype">double & </td> |
---|
| 632 | <td class="paramname"> <em>norm</em>, </td> |
---|
| 633 | </tr> |
---|
| 634 | <tr> |
---|
| 635 | <td class="paramkey"></td> |
---|
| 636 | <td></td> |
---|
| 637 | <td class="paramtype">int </td> |
---|
| 638 | <td class="paramname"> <em>k</em>, </td> |
---|
| 639 | </tr> |
---|
| 640 | <tr> |
---|
| 641 | <td class="paramkey"></td> |
---|
| 642 | <td></td> |
---|
| 643 | <td class="paramtype">int </td> |
---|
| 644 | <td class="paramname"> <em>sold</em>, </td> |
---|
| 645 | </tr> |
---|
| 646 | <tr> |
---|
| 647 | <td class="paramkey"></td> |
---|
| 648 | <td></td> |
---|
| 649 | <td class="paramtype">int </td> |
---|
| 650 | <td class="paramname"> <em>snew</em>, </td> |
---|
| 651 | </tr> |
---|
| 652 | <tr> |
---|
| 653 | <td class="paramkey"></td> |
---|
| 654 | <td></td> |
---|
| 655 | <td class="paramtype">const cvec & </td> |
---|
| 656 | <td class="paramname"> <em>ytH</em>, </td> |
---|
| 657 | </tr> |
---|
| 658 | <tr> |
---|
| 659 | <td class="paramkey"></td> |
---|
| 660 | <td></td> |
---|
| 661 | <td class="paramtype">const cmat & </td> |
---|
| 662 | <td class="paramname"> <em>HtH</em>, </td> |
---|
| 663 | </tr> |
---|
| 664 | <tr> |
---|
| 665 | <td class="paramkey"></td> |
---|
| 666 | <td></td> |
---|
| 667 | <td class="paramtype">const ivec & </td> |
---|
| 668 | <td class="paramname"> <em>s</em></td><td> </td> |
---|
| 669 | </tr> |
---|
| 670 | <tr> |
---|
| 671 | <td></td> |
---|
| 672 | <td>)</td> |
---|
| 673 | <td></td><td></td><td><code> [protected, inherited]</code></td> |
---|
| 674 | </tr> |
---|
| 675 | </table> |
---|
| 676 | </div> |
---|
| 677 | <div class="memdoc"> |
---|
| 678 | |
---|
| 679 | <p> |
---|
| 680 | Update residual norm (for internal use). |
---|
| 681 | <p> |
---|
| 682 | Update the residual norm <img class="formulaInl" alt="$|y-Hs|$" src="form_300.png"> when moving from one constellation point to an adjacent point.<p> |
---|
| 683 | <dl compact><dt><b>Parameters:</b></dt><dd> |
---|
| 684 | <table border="0" cellspacing="2" cellpadding="0"> |
---|
| 685 | <tr><td valign="top"><tt>[in,out]</tt> </td><td valign="top"><em>norm</em> </td><td>Norm to be updated </td></tr> |
---|
| 686 | <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>k</em> </td><td>Position where s changed </td></tr> |
---|
| 687 | <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>sold</em> </td><td>Old value of s[k] </td></tr> |
---|
| 688 | <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>snew</em> </td><td>New value of s[k] </td></tr> |
---|
| 689 | <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>ytH</em> </td><td>y'H vector </td></tr> |
---|
| 690 | <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>HtH</em> </td><td>Grammian matrix H'H </td></tr> |
---|
| 691 | <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>s</em> </td><td>Symbol vector </td></tr> |
---|
| 692 | </table> |
---|
| 693 | </dl> |
---|
| 694 | |
---|
| 695 | <p>References <a class="el" href="fix__functions_8cpp-source.html#l00098">itpp::conj()</a>, <a class="el" href="matfunc_8h-source.html#l00051">itpp::length()</a>, <a class="el" href="fix__functions_8cpp-source.html#l00084">itpp::real()</a>, <a class="el" href="elem__math_8h-source.html#l00056">itpp::sqr()</a>, and <a class="el" href="modulator__nd_8h-source.html#l00448">itpp::Modulator_NCD::symbols</a>.</p> |
---|
| 696 | |
---|
| 697 | <p>Referenced by <a class="el" href="modulator__nd_8cpp-source.html#l00444">itpp::Modulator_NCD::demodulate_soft_bits()</a>.</p> |
---|
| 698 | |
---|
| 699 | </div> |
---|
| 700 | </div><p> |
---|
| 701 | <hr>The documentation for this class was generated from the following files:<ul> |
---|
| 702 | <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> |
---|
| 703 | </div> |
---|
| 704 | <hr size="1"><address style="text-align: right;"><small>Generated on Tue Jun 2 10:02:19 2009 for mixpp by |
---|
| 705 | <a href="http://www.doxygen.org/index.html"> |
---|
| 706 | <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address> |
---|
| 707 | </body> |
---|
| 708 | </html> |
---|