<!-- HTML header for doxygen 1.8.8-->
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<!-- For Mobile Devices -->
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta name="generator" content="Doxygen 1.8.17"/>
<script type="text/javascript" src="https://code.jquery.com/jquery-2.1.1.min.js"></script>
<title>QuEST: test_operators.cpp Source File</title>
<!--<link href="tabs.css" rel="stylesheet" type="text/css"/>-->
<script type="text/javascript" src="dynsections.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
<link href="style.css" rel="stylesheet" type="text/css"/>
<link href='https://fonts.googleapis.com/css?family=Roboto+Slab' rel='stylesheet' type='text/css'>
<link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.6/css/bootstrap.min.css">
<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.6/js/bootstrap.min.js"></script>
<link href="jquery.smartmenus.bootstrap.css" rel="stylesheet">
<script type="text/javascript" src="jquery.smartmenus.js"></script>
<!-- SmartMenus jQuery Bootstrap Addon -->
<script type="text/javascript" src="jquery.smartmenus.bootstrap.js"></script>
<!-- SmartMenus jQuery plugin -->
</head>
<body>
<nav class="navbar navbar-default" role="navigation">
<div class="container">
<div class="navbar-header">
<a class="navbar-brand"><img alt="Logo" src="logo.png"/></a>
<a class="navbar-brand"><b>QuEST</b> v3.4.0<br>The Quantum Exact Simulation Toolkit</a>
</div>
</div>
</nav>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div class="content" id="content">
<div class="container">
<div class="row">
<div class="col-sm-12 panel " style="padding-bottom: 15px;">
<div style="margin-bottom: 15px;">
<!-- end header part -->
<!-- Generated by Doxygen 1.8.17 -->
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */
$(function() {
initMenu('',false,false,'search.php','Search');
});
/* @license-end */</script>
<div id="main-nav"></div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="dir_e145b6391efe0b6e575fd5bb5f76dbf8.html">QuEST</a></li><li class="navelem"><a class="el" href="dir_126ffd7f5d49d0bf631a939d5b00372b.html">tests</a></li> </ul>
</div>
</div><!-- top -->
<div class="header">
<div class="headertitle">
<div class="title">test_operators.cpp</div> </div>
</div><!--header-->
<div class="contents">
<a href="test__operators_8cpp.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span>  </div>
<div class="line"><a name="l00002"></a><span class="lineno"> 2</span> <span class="preprocessor">#include "catch.hpp"</span></div>
<div class="line"><a name="l00003"></a><span class="lineno"> 3</span> <span class="preprocessor">#include "<a class="code" href="QuEST_8h.html">QuEST.h</a>"</span></div>
<div class="line"><a name="l00004"></a><span class="lineno"> 4</span> <span class="preprocessor">#include "<a class="code" href="utilities_8hpp.html">utilities.hpp</a>"</span></div>
<div class="line"><a name="l00005"></a><span class="lineno"> 5</span>  </div>
<div class="line"><a name="l00010"></a><span class="lineno"><a class="line" href="test__operators_8cpp.html#ae34496c47ef565b741782f01e710ea2c"> 10</a></span> <span class="preprocessor">#define PREPARE_TEST(quregVec, quregMatr, refVec, refMatr) \</span></div>
<div class="line"><a name="l00011"></a><span class="lineno"> 11</span> <span class="preprocessor"> Qureg quregVec = createQureg(NUM_QUBITS, QUEST_ENV); \</span></div>
<div class="line"><a name="l00012"></a><span class="lineno"> 12</span> <span class="preprocessor"> Qureg quregMatr = createDensityQureg(NUM_QUBITS, QUEST_ENV); \</span></div>
<div class="line"><a name="l00013"></a><span class="lineno"> 13</span> <span class="preprocessor"> initDebugState(quregVec); \</span></div>
<div class="line"><a name="l00014"></a><span class="lineno"> 14</span> <span class="preprocessor"> initDebugState(quregMatr); \</span></div>
<div class="line"><a name="l00015"></a><span class="lineno"> 15</span> <span class="preprocessor"> QVector refVec = toQVector(quregVec); \</span></div>
<div class="line"><a name="l00016"></a><span class="lineno"> 16</span> <span class="preprocessor"> QMatrix refMatr = toQMatrix(quregMatr);</span></div>
<div class="line"><a name="l00017"></a><span class="lineno"> 17</span>  </div>
<div class="line"><a name="l00019"></a><span class="lineno"><a class="line" href="test__operators_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4"> 19</a></span> <span class="preprocessor">#define CLEANUP_TEST(quregVec, quregMatr) \</span></div>
<div class="line"><a name="l00020"></a><span class="lineno"> 20</span> <span class="preprocessor"> destroyQureg(quregVec, QUEST_ENV); \</span></div>
<div class="line"><a name="l00021"></a><span class="lineno"> 21</span> <span class="preprocessor"> destroyQureg(quregMatr, QUEST_ENV);</span></div>
<div class="line"><a name="l00022"></a><span class="lineno"> 22</span>  </div>
<div class="line"><a name="l00023"></a><span class="lineno"> 23</span> <span class="comment">/* allows concise use of Contains in catch's REQUIRE_THROWS_WITH */</span></div>
<div class="line"><a name="l00024"></a><span class="lineno"> 24</span> <span class="keyword">using</span> Catch::Matchers::Contains;</div>
<div class="line"><a name="l00025"></a><span class="lineno"> 25</span>  </div>
<div class="line"><a name="l00026"></a><span class="lineno"> 26</span>  </div>
<div class="line"><a name="l00027"></a><span class="lineno"> 27</span>  </div>
<div class="line"><a name="l00032"></a><span class="lineno"><a class="line" href="group__unittest.html#gaff6822e79b947a9e3b791572c674c08c"> 32</a></span> <a class="code" href="group__unittest.html#gaff6822e79b947a9e3b791572c674c08c">TEST_CASE</a>( <span class="stringliteral">"applyDiagonalOp"</span>, <span class="stringliteral">"[operators]"</span> ) {</div>
<div class="line"><a name="l00033"></a><span class="lineno"> 33</span>  </div>
<div class="line"><a name="l00034"></a><span class="lineno"> 34</span>  <a class="code" href="test__operators_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l00035"></a><span class="lineno"> 35</span>  </div>
<div class="line"><a name="l00036"></a><span class="lineno"> 36</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00037"></a><span class="lineno"> 37</span>  </div>
<div class="line"><a name="l00038"></a><span class="lineno"> 38</span>  <span class="comment">// try 10 random operators </span></div>
<div class="line"><a name="l00039"></a><span class="lineno"> 39</span>  GENERATE( range(0,10) );</div>
<div class="line"><a name="l00040"></a><span class="lineno"> 40</span>  </div>
<div class="line"><a name="l00041"></a><span class="lineno"> 41</span>  <span class="comment">// make a totally random (non-Hermitian) diagonal oeprator</span></div>
<div class="line"><a name="l00042"></a><span class="lineno"> 42</span>  <a class="code" href="structDiagonalOp.html">DiagonalOp</a> op = <a class="code" href="group__type.html#gaebf896dd8d5eeaf9fd896f6cc8e334fe">createDiagonalOp</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00043"></a><span class="lineno"> 43</span>  <span class="keywordflow">for</span> (<span class="keywordtype">long</span> <span class="keywordtype">long</span> <span class="keywordtype">int</span> i=0; i<op.<a class="code" href="structDiagonalOp.html#a2c6eab631ef48b4978db026c98180eee">numElemsPerChunk</a>; i++) {</div>
<div class="line"><a name="l00044"></a><span class="lineno"> 44</span>  op.<a class="code" href="structDiagonalOp.html#a1d66088bed235d524cd452b107694d5c">real</a>[i] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5, 5);</div>
<div class="line"><a name="l00045"></a><span class="lineno"> 45</span>  op.<a class="code" href="structDiagonalOp.html#a85c3f52533efe831bbe40b9a48602388">imag</a>[i] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5, 5);</div>
<div class="line"><a name="l00046"></a><span class="lineno"> 46</span>  }</div>
<div class="line"><a name="l00047"></a><span class="lineno"> 47</span>  <a class="code" href="group__type.html#gab75d5cdc622d2778bad24e3a8130aab9">syncDiagonalOp</a>(op);</div>
<div class="line"><a name="l00048"></a><span class="lineno"> 48</span>  </div>
<div class="line"><a name="l00049"></a><span class="lineno"> 49</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00050"></a><span class="lineno"> 50</span>  </div>
<div class="line"><a name="l00051"></a><span class="lineno"> 51</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> ref = <a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(op) * refVec;</div>
<div class="line"><a name="l00052"></a><span class="lineno"> 52</span>  <a class="code" href="group__operator.html#gad2e953390342cd361cfb4064d47715e6">applyDiagonalOp</a>(quregVec, op);</div>
<div class="line"><a name="l00053"></a><span class="lineno"> 53</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, ref) );</div>
<div class="line"><a name="l00054"></a><span class="lineno"> 54</span>  }</div>
<div class="line"><a name="l00055"></a><span class="lineno"> 55</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00056"></a><span class="lineno"> 56</span>  </div>
<div class="line"><a name="l00057"></a><span class="lineno"> 57</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> ref = <a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(op) * refMatr;</div>
<div class="line"><a name="l00058"></a><span class="lineno"> 58</span>  <a class="code" href="group__operator.html#gad2e953390342cd361cfb4064d47715e6">applyDiagonalOp</a>(quregMatr, op);</div>
<div class="line"><a name="l00059"></a><span class="lineno"> 59</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, ref, 100*REAL_EPS) );</div>
<div class="line"><a name="l00060"></a><span class="lineno"> 60</span>  }</div>
<div class="line"><a name="l00061"></a><span class="lineno"> 61</span>  </div>
<div class="line"><a name="l00062"></a><span class="lineno"> 62</span>  <a class="code" href="group__type.html#ga2c59f45fab56708f687b4104ee99bcd1">destroyDiagonalOp</a>(op, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00063"></a><span class="lineno"> 63</span>  }</div>
<div class="line"><a name="l00064"></a><span class="lineno"> 64</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00065"></a><span class="lineno"> 65</span>  </div>
<div class="line"><a name="l00066"></a><span class="lineno"> 66</span>  SECTION( <span class="stringliteral">"mismatching size"</span> ) {</div>
<div class="line"><a name="l00067"></a><span class="lineno"> 67</span>  </div>
<div class="line"><a name="l00068"></a><span class="lineno"> 68</span>  <a class="code" href="structDiagonalOp.html">DiagonalOp</a> op = <a class="code" href="group__type.html#gaebf896dd8d5eeaf9fd896f6cc8e334fe">createDiagonalOp</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> + 1, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00069"></a><span class="lineno"> 69</span>  </div>
<div class="line"><a name="l00070"></a><span class="lineno"> 70</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gad2e953390342cd361cfb4064d47715e6">applyDiagonalOp</a>(quregVec, op), Contains(<span class="stringliteral">"equal number of qubits"</span>));</div>
<div class="line"><a name="l00071"></a><span class="lineno"> 71</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gad2e953390342cd361cfb4064d47715e6">applyDiagonalOp</a>(quregMatr, op), Contains(<span class="stringliteral">"equal number of qubits"</span>));</div>
<div class="line"><a name="l00072"></a><span class="lineno"> 72</span>  </div>
<div class="line"><a name="l00073"></a><span class="lineno"> 73</span>  <a class="code" href="group__type.html#ga2c59f45fab56708f687b4104ee99bcd1">destroyDiagonalOp</a>(op, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00074"></a><span class="lineno"> 74</span>  }</div>
<div class="line"><a name="l00075"></a><span class="lineno"> 75</span>  }</div>
<div class="line"><a name="l00076"></a><span class="lineno"> 76</span>  <a class="code" href="test__operators_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l00077"></a><span class="lineno"> 77</span> }</div>
<div class="line"><a name="l00078"></a><span class="lineno"> 78</span>  </div>
<div class="line"><a name="l00083"></a><span class="lineno"><a class="line" href="group__unittest.html#gaaa80d67f0d860f26067987bcf3970ec1"> 83</a></span> <a class="code" href="group__unittest.html#gaff6822e79b947a9e3b791572c674c08c">TEST_CASE</a>( <span class="stringliteral">"applyFullQFT"</span>, <span class="stringliteral">"[operators]"</span> ) {</div>
<div class="line"><a name="l00084"></a><span class="lineno"> 84</span>  </div>
<div class="line"><a name="l00085"></a><span class="lineno"> 85</span>  <a class="code" href="test__operators_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l00086"></a><span class="lineno"> 86</span>  </div>
<div class="line"><a name="l00087"></a><span class="lineno"> 87</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00088"></a><span class="lineno"> 88</span>  </div>
<div class="line"><a name="l00089"></a><span class="lineno"> 89</span>  <span class="comment">// try 10 times for each kind of input</span></div>
<div class="line"><a name="l00090"></a><span class="lineno"> 90</span>  GENERATE( range(0,10) );</div>
<div class="line"><a name="l00091"></a><span class="lineno"> 91</span>  </div>
<div class="line"><a name="l00092"></a><span class="lineno"> 92</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00093"></a><span class="lineno"> 93</span>  </div>
<div class="line"><a name="l00094"></a><span class="lineno"> 94</span>  SECTION( <span class="stringliteral">"normalised"</span> ) {</div>
<div class="line"><a name="l00095"></a><span class="lineno"> 95</span>  </div>
<div class="line"><a name="l00096"></a><span class="lineno"> 96</span>  refVec = <a class="code" href="group__testutilities.html#gae1d2eb70b50267f8186cbd53e300d94f">getRandomStateVector</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>);</div>
<div class="line"><a name="l00097"></a><span class="lineno"> 97</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(quregVec, refVec);</div>
<div class="line"><a name="l00098"></a><span class="lineno"> 98</span>  refVec = <a class="code" href="group__testutilities.html#ga7ed0c22ff6b671eecccef4dac54bd6c1">getDFT</a>(refVec);</div>
<div class="line"><a name="l00099"></a><span class="lineno"> 99</span>  </div>
<div class="line"><a name="l00100"></a><span class="lineno"> 100</span>  <a class="code" href="group__operator.html#gaf26f32c25db760065486188497c1da8b">applyFullQFT</a>(quregVec);</div>
<div class="line"><a name="l00101"></a><span class="lineno"> 101</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l00102"></a><span class="lineno"> 102</span>  }</div>
<div class="line"><a name="l00103"></a><span class="lineno"> 103</span>  SECTION( <span class="stringliteral">"unnormalised"</span> ) {</div>
<div class="line"><a name="l00104"></a><span class="lineno"> 104</span>  </div>
<div class="line"><a name="l00105"></a><span class="lineno"> 105</span>  refVec = <a class="code" href="group__testutilities.html#ga27dc818709394cb31247e26850215f8a">getRandomQVector</a>(1 << <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>);</div>
<div class="line"><a name="l00106"></a><span class="lineno"> 106</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(quregVec, refVec);</div>
<div class="line"><a name="l00107"></a><span class="lineno"> 107</span>  refVec = <a class="code" href="group__testutilities.html#ga7ed0c22ff6b671eecccef4dac54bd6c1">getDFT</a>(refVec);</div>
<div class="line"><a name="l00108"></a><span class="lineno"> 108</span>  </div>
<div class="line"><a name="l00109"></a><span class="lineno"> 109</span>  <a class="code" href="group__operator.html#gaf26f32c25db760065486188497c1da8b">applyFullQFT</a>(quregVec);</div>
<div class="line"><a name="l00110"></a><span class="lineno"> 110</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l00111"></a><span class="lineno"> 111</span>  }</div>
<div class="line"><a name="l00112"></a><span class="lineno"> 112</span>  }</div>
<div class="line"><a name="l00113"></a><span class="lineno"> 113</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00114"></a><span class="lineno"> 114</span>  </div>
<div class="line"><a name="l00115"></a><span class="lineno"> 115</span>  SECTION( <span class="stringliteral">"pure"</span> ) {</div>
<div class="line"><a name="l00116"></a><span class="lineno"> 116</span>  </div>
<div class="line"><a name="l00117"></a><span class="lineno"> 117</span>  <span class="comment">/* a pure density matrix should be mapped to a pure state </span></div>
<div class="line"><a name="l00118"></a><span class="lineno"> 118</span> <span class="comment"> * corresponding to the state-vector DFT</span></div>
<div class="line"><a name="l00119"></a><span class="lineno"> 119</span> <span class="comment"> */</span></div>
<div class="line"><a name="l00120"></a><span class="lineno"> 120</span>  </div>
<div class="line"><a name="l00121"></a><span class="lineno"> 121</span>  refVec = <a class="code" href="group__testutilities.html#gae1d2eb70b50267f8186cbd53e300d94f">getRandomStateVector</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>);</div>
<div class="line"><a name="l00122"></a><span class="lineno"> 122</span>  refMatr = <a class="code" href="group__testutilities.html#gaecd1e4149d03d358fc4e64c335e823ef">getPureDensityMatrix</a>(refVec);</div>
<div class="line"><a name="l00123"></a><span class="lineno"> 123</span>  </div>
<div class="line"><a name="l00124"></a><span class="lineno"> 124</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(quregMatr, refMatr);</div>
<div class="line"><a name="l00125"></a><span class="lineno"> 125</span>  <a class="code" href="group__operator.html#gaf26f32c25db760065486188497c1da8b">applyFullQFT</a>(quregMatr);</div>
<div class="line"><a name="l00126"></a><span class="lineno"> 126</span>  </div>
<div class="line"><a name="l00127"></a><span class="lineno"> 127</span>  refVec = <a class="code" href="group__testutilities.html#ga7ed0c22ff6b671eecccef4dac54bd6c1">getDFT</a>(refVec);</div>
<div class="line"><a name="l00128"></a><span class="lineno"> 128</span>  refMatr = <a class="code" href="group__testutilities.html#gaecd1e4149d03d358fc4e64c335e823ef">getPureDensityMatrix</a>(refVec);</div>
<div class="line"><a name="l00129"></a><span class="lineno"> 129</span>  </div>
<div class="line"><a name="l00130"></a><span class="lineno"> 130</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</div>
<div class="line"><a name="l00131"></a><span class="lineno"> 131</span>  }</div>
<div class="line"><a name="l00132"></a><span class="lineno"> 132</span>  SECTION( <span class="stringliteral">"mixed"</span> ) {</div>
<div class="line"><a name="l00133"></a><span class="lineno"> 133</span>  </div>
<div class="line"><a name="l00134"></a><span class="lineno"> 134</span>  <span class="comment">/* a mixed density matrix, conceptualised as a mixture of orthogonal</span></div>
<div class="line"><a name="l00135"></a><span class="lineno"> 135</span> <span class="comment"> * state-vectors, should be mapped to an equally weighted mixture </span></div>
<div class="line"><a name="l00136"></a><span class="lineno"> 136</span> <span class="comment"> * of DFTs of each state-vector (because QFT is unitary and hence </span></div>
<div class="line"><a name="l00137"></a><span class="lineno"> 137</span> <span class="comment"> * maintains state orthogonality)</span></div>
<div class="line"><a name="l00138"></a><span class="lineno"> 138</span> <span class="comment"> */</span></div>
<div class="line"><a name="l00139"></a><span class="lineno"> 139</span>  </div>
<div class="line"><a name="l00140"></a><span class="lineno"> 140</span>  <span class="keywordtype">int</span> numStates = (1 << <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>)/4; <span class="comment">// quarter as many states as possible</span></div>
<div class="line"><a name="l00141"></a><span class="lineno"> 141</span>  std::vector<QVector> states = <a class="code" href="group__testutilities.html#ga2ce759464ecc923710890d633c03bcca">getRandomOrthonormalVectors</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, numStates);</div>
<div class="line"><a name="l00142"></a><span class="lineno"> 142</span>  std::vector<qreal> probs = <a class="code" href="group__testutilities.html#gaa6a22a9144876cee28d54b70ea556527">getRandomProbabilities</a>(numStates);</div>
<div class="line"><a name="l00143"></a><span class="lineno"> 143</span>  </div>
<div class="line"><a name="l00144"></a><span class="lineno"> 144</span>  <span class="comment">// set qureg to random mixture </span></div>
<div class="line"><a name="l00145"></a><span class="lineno"> 145</span>  refMatr = <a class="code" href="group__testutilities.html#gad6435da46323045d81e4ba9d9fe5a109">getMixedDensityMatrix</a>(probs, states);</div>
<div class="line"><a name="l00146"></a><span class="lineno"> 146</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(quregMatr, refMatr);</div>
<div class="line"><a name="l00147"></a><span class="lineno"> 147</span>  </div>
<div class="line"><a name="l00148"></a><span class="lineno"> 148</span>  <span class="comment">// apply QFT to mixture</span></div>
<div class="line"><a name="l00149"></a><span class="lineno"> 149</span>  <a class="code" href="group__operator.html#gaf26f32c25db760065486188497c1da8b">applyFullQFT</a>(quregMatr);</div>
<div class="line"><a name="l00150"></a><span class="lineno"> 150</span>  </div>
<div class="line"><a name="l00151"></a><span class="lineno"> 151</span>  <span class="comment">// compute dft of mixture, via dft of each state</span></div>
<div class="line"><a name="l00152"></a><span class="lineno"> 152</span>  refMatr = <a class="code" href="group__testutilities.html#ga6ccbb15b0f234e926be96a153181b63a">getZeroMatrix</a>(1 << <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>);</div>
<div class="line"><a name="l00153"></a><span class="lineno"> 153</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numStates; i++)</div>
<div class="line"><a name="l00154"></a><span class="lineno"> 154</span>  refMatr += probs[i] * <a class="code" href="group__testutilities.html#gaecd1e4149d03d358fc4e64c335e823ef">getPureDensityMatrix</a>(<a class="code" href="group__testutilities.html#ga7ed0c22ff6b671eecccef4dac54bd6c1">getDFT</a>(states[i]));</div>
<div class="line"><a name="l00155"></a><span class="lineno"> 155</span>  </div>
<div class="line"><a name="l00156"></a><span class="lineno"> 156</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</div>
<div class="line"><a name="l00157"></a><span class="lineno"> 157</span>  }</div>
<div class="line"><a name="l00158"></a><span class="lineno"> 158</span>  SECTION( <span class="stringliteral">"unnormalised"</span> ) {</div>
<div class="line"><a name="l00159"></a><span class="lineno"> 159</span>  </div>
<div class="line"><a name="l00160"></a><span class="lineno"> 160</span>  <span class="comment">/* repeat method above, except that we use unnormalised vectors, </span></div>
<div class="line"><a name="l00161"></a><span class="lineno"> 161</span> <span class="comment"> * and mix them with arbitrary complex numbers instead of probabilities,</span></div>
<div class="line"><a name="l00162"></a><span class="lineno"> 162</span> <span class="comment"> * yielding an unnormalised density matrix </span></div>
<div class="line"><a name="l00163"></a><span class="lineno"> 163</span> <span class="comment"> */</span></div>
<div class="line"><a name="l00164"></a><span class="lineno"> 164</span>  </div>
<div class="line"><a name="l00165"></a><span class="lineno"> 165</span>  <span class="keywordtype">int</span> numVecs = (1 << <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>)/4; <span class="comment">// quarter as many states as possible</span></div>
<div class="line"><a name="l00166"></a><span class="lineno"> 166</span>  std::vector<QVector> vecs;</div>
<div class="line"><a name="l00167"></a><span class="lineno"> 167</span>  std::vector<qcomp> coeffs;</div>
<div class="line"><a name="l00168"></a><span class="lineno"> 168</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numVecs; i++) {</div>
<div class="line"><a name="l00169"></a><span class="lineno"> 169</span>  vecs.push_back(<a class="code" href="group__testutilities.html#ga27dc818709394cb31247e26850215f8a">getRandomQVector</a>(1 << <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>));</div>
<div class="line"><a name="l00170"></a><span class="lineno"> 170</span>  coeffs.push_back(<a class="code" href="group__testutilities.html#ga723de136e368b9de0ac391f850d409ac">getRandomComplex</a>());</div>
<div class="line"><a name="l00171"></a><span class="lineno"> 171</span>  }</div>
<div class="line"><a name="l00172"></a><span class="lineno"> 172</span>  </div>
<div class="line"><a name="l00173"></a><span class="lineno"> 173</span>  <span class="comment">// produce unnormalised matrix</span></div>
<div class="line"><a name="l00174"></a><span class="lineno"> 174</span>  refMatr = <a class="code" href="group__testutilities.html#ga6ccbb15b0f234e926be96a153181b63a">getZeroMatrix</a>(1 << <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>);</div>
<div class="line"><a name="l00175"></a><span class="lineno"> 175</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numVecs; i++)</div>
<div class="line"><a name="l00176"></a><span class="lineno"> 176</span>  refMatr += coeffs[i] * <a class="code" href="group__testutilities.html#gaecd1e4149d03d358fc4e64c335e823ef">getPureDensityMatrix</a>(vecs[i]);</div>
<div class="line"><a name="l00177"></a><span class="lineno"> 177</span>  </div>
<div class="line"><a name="l00178"></a><span class="lineno"> 178</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(quregMatr, refMatr);</div>
<div class="line"><a name="l00179"></a><span class="lineno"> 179</span>  <a class="code" href="group__operator.html#gaf26f32c25db760065486188497c1da8b">applyFullQFT</a>(quregMatr);</div>
<div class="line"><a name="l00180"></a><span class="lineno"> 180</span>  </div>
<div class="line"><a name="l00181"></a><span class="lineno"> 181</span>  <span class="comment">// compute target matrix via dft of each unnormalised vector </span></div>
<div class="line"><a name="l00182"></a><span class="lineno"> 182</span>  refMatr = <a class="code" href="group__testutilities.html#ga6ccbb15b0f234e926be96a153181b63a">getZeroMatrix</a>(1 << <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>);</div>
<div class="line"><a name="l00183"></a><span class="lineno"> 183</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numVecs; i++)</div>
<div class="line"><a name="l00184"></a><span class="lineno"> 184</span>  refMatr += coeffs[i] * <a class="code" href="group__testutilities.html#gaecd1e4149d03d358fc4e64c335e823ef">getPureDensityMatrix</a>(<a class="code" href="group__testutilities.html#ga7ed0c22ff6b671eecccef4dac54bd6c1">getDFT</a>(vecs[i]));</div>
<div class="line"><a name="l00185"></a><span class="lineno"> 185</span>  </div>
<div class="line"><a name="l00186"></a><span class="lineno"> 186</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</div>
<div class="line"><a name="l00187"></a><span class="lineno"> 187</span>  }</div>
<div class="line"><a name="l00188"></a><span class="lineno"> 188</span>  }</div>
<div class="line"><a name="l00189"></a><span class="lineno"> 189</span>  }</div>
<div class="line"><a name="l00190"></a><span class="lineno"> 190</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00191"></a><span class="lineno"> 191</span>  </div>
<div class="line"><a name="l00192"></a><span class="lineno"> 192</span>  SUCCEED( );</div>
<div class="line"><a name="l00193"></a><span class="lineno"> 193</span>  }</div>
<div class="line"><a name="l00194"></a><span class="lineno"> 194</span>  <a class="code" href="test__operators_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l00195"></a><span class="lineno"> 195</span> }</div>
<div class="line"><a name="l00196"></a><span class="lineno"> 196</span>  </div>
<div class="line"><a name="l00197"></a><span class="lineno"> 197</span>  </div>
<div class="line"><a name="l00198"></a><span class="lineno"> 198</span>  </div>
<div class="line"><a name="l00203"></a><span class="lineno"><a class="line" href="group__unittest.html#ga8e5f825652d097b2f9aa3bac8250c755"> 203</a></span> <a class="code" href="group__unittest.html#gaff6822e79b947a9e3b791572c674c08c">TEST_CASE</a>( <span class="stringliteral">"applyMatrix2"</span>, <span class="stringliteral">"[operators]"</span> ) {</div>
<div class="line"><a name="l00204"></a><span class="lineno"> 204</span>  </div>
<div class="line"><a name="l00205"></a><span class="lineno"> 205</span>  <a class="code" href="test__operators_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l00206"></a><span class="lineno"> 206</span>  </div>
<div class="line"><a name="l00207"></a><span class="lineno"> 207</span>  <span class="comment">// every test will use a unique random matrix</span></div>
<div class="line"><a name="l00208"></a><span class="lineno"> 208</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op = <a class="code" href="group__testutilities.html#gaa2e8b958e0cba07e01de9f91a5ce3c9c">getRandomQMatrix</a>(2); <span class="comment">// 2-by-2</span></div>
<div class="line"><a name="l00209"></a><span class="lineno"> 209</span>  <a class="code" href="structComplexMatrix2.html">ComplexMatrix2</a> matr = <a class="code" href="group__testutilities.html#ga731a7a71755c25ebe96e742e3fbe5812">toComplexMatrix2</a>(op); </div>
<div class="line"><a name="l00210"></a><span class="lineno"> 210</span>  </div>
<div class="line"><a name="l00211"></a><span class="lineno"> 211</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00212"></a><span class="lineno"> 212</span>  </div>
<div class="line"><a name="l00213"></a><span class="lineno"> 213</span>  <span class="keywordtype">int</span> target = GENERATE( range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) );</div>
<div class="line"><a name="l00214"></a><span class="lineno"> 214</span>  </div>
<div class="line"><a name="l00215"></a><span class="lineno"> 215</span>  <span class="comment">// reference boilerplate</span></div>
<div class="line"><a name="l00216"></a><span class="lineno"> 216</span>  <span class="keywordtype">int</span>* ctrls = NULL;</div>
<div class="line"><a name="l00217"></a><span class="lineno"> 217</span>  <span class="keywordtype">int</span> numCtrls = 0;</div>
<div class="line"><a name="l00218"></a><span class="lineno"> 218</span>  <span class="keywordtype">int</span> targs[] = {target};</div>
<div class="line"><a name="l00219"></a><span class="lineno"> 219</span>  <span class="keywordtype">int</span> numTargs = 1;</div>
<div class="line"><a name="l00220"></a><span class="lineno"> 220</span>  </div>
<div class="line"><a name="l00221"></a><span class="lineno"> 221</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00222"></a><span class="lineno"> 222</span>  </div>
<div class="line"><a name="l00223"></a><span class="lineno"> 223</span>  <a class="code" href="group__operator.html#gadfb5c1d99a22ce666fc715a8da2e0950">applyMatrix2</a>(quregVec, target, matr);</div>
<div class="line"><a name="l00224"></a><span class="lineno"> 224</span>  <a class="code" href="group__testutilities.html#ga059fea2ee0415bf25929601ba0788164">applyReferenceMatrix</a>(refVec, ctrls, numCtrls, targs, numTargs, op);</div>
<div class="line"><a name="l00225"></a><span class="lineno"> 225</span>  </div>
<div class="line"><a name="l00226"></a><span class="lineno"> 226</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l00227"></a><span class="lineno"> 227</span>  }</div>
<div class="line"><a name="l00228"></a><span class="lineno"> 228</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00229"></a><span class="lineno"> 229</span>  </div>
<div class="line"><a name="l00230"></a><span class="lineno"> 230</span>  <a class="code" href="group__operator.html#gadfb5c1d99a22ce666fc715a8da2e0950">applyMatrix2</a>(quregMatr, target, matr);</div>
<div class="line"><a name="l00231"></a><span class="lineno"> 231</span>  <a class="code" href="group__testutilities.html#ga059fea2ee0415bf25929601ba0788164">applyReferenceMatrix</a>(refMatr, ctrls, numCtrls, targs, numTargs, op);</div>
<div class="line"><a name="l00232"></a><span class="lineno"> 232</span>  </div>
<div class="line"><a name="l00233"></a><span class="lineno"> 233</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 10*REAL_EPS) );</div>
<div class="line"><a name="l00234"></a><span class="lineno"> 234</span>  }</div>
<div class="line"><a name="l00235"></a><span class="lineno"> 235</span>  }</div>
<div class="line"><a name="l00236"></a><span class="lineno"> 236</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00237"></a><span class="lineno"> 237</span>  </div>
<div class="line"><a name="l00238"></a><span class="lineno"> 238</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l00239"></a><span class="lineno"> 239</span>  </div>
<div class="line"><a name="l00240"></a><span class="lineno"> 240</span>  <span class="keywordtype">int</span> target = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l00241"></a><span class="lineno"> 241</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gadfb5c1d99a22ce666fc715a8da2e0950">applyMatrix2</a>(quregVec, target, matr), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l00242"></a><span class="lineno"> 242</span>  }</div>
<div class="line"><a name="l00243"></a><span class="lineno"> 243</span>  }</div>
<div class="line"><a name="l00244"></a><span class="lineno"> 244</span>  <a class="code" href="test__operators_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l00245"></a><span class="lineno"> 245</span> }</div>
<div class="line"><a name="l00246"></a><span class="lineno"> 246</span>  </div>
<div class="line"><a name="l00247"></a><span class="lineno"> 247</span>  </div>
<div class="line"><a name="l00248"></a><span class="lineno"> 248</span>  </div>
<div class="line"><a name="l00253"></a><span class="lineno"><a class="line" href="group__unittest.html#gaaf9a656af9b7f24e10768a2408287396"> 253</a></span> <a class="code" href="group__unittest.html#gaff6822e79b947a9e3b791572c674c08c">TEST_CASE</a>( <span class="stringliteral">"applyMatrix4"</span>, <span class="stringliteral">"[operators]"</span> ) {</div>
<div class="line"><a name="l00254"></a><span class="lineno"> 254</span>  </div>
<div class="line"><a name="l00255"></a><span class="lineno"> 255</span>  <a class="code" href="test__operators_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l00256"></a><span class="lineno"> 256</span>  </div>
<div class="line"><a name="l00257"></a><span class="lineno"> 257</span>  <span class="comment">// in distributed mode, each node must be able to fit all amps modified by matrix </span></div>
<div class="line"><a name="l00258"></a><span class="lineno"> 258</span>  REQUIRE( quregVec.numAmpsPerChunk >= 4 );</div>
<div class="line"><a name="l00259"></a><span class="lineno"> 259</span>  </div>
<div class="line"><a name="l00260"></a><span class="lineno"> 260</span>  <span class="comment">// every test will use a unique random matrix</span></div>
<div class="line"><a name="l00261"></a><span class="lineno"> 261</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op = <a class="code" href="group__testutilities.html#gaa2e8b958e0cba07e01de9f91a5ce3c9c">getRandomQMatrix</a>(4); <span class="comment">// 4-by-4</span></div>
<div class="line"><a name="l00262"></a><span class="lineno"> 262</span>  <a class="code" href="structComplexMatrix4.html">ComplexMatrix4</a> matr = <a class="code" href="group__testutilities.html#ga216f7c25bbb0cf752d1b6fff5ea8197b">toComplexMatrix4</a>(op); </div>
<div class="line"><a name="l00263"></a><span class="lineno"> 263</span>  </div>
<div class="line"><a name="l00264"></a><span class="lineno"> 264</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00265"></a><span class="lineno"> 265</span>  </div>
<div class="line"><a name="l00266"></a><span class="lineno"> 266</span>  <span class="keywordtype">int</span> targ1 = GENERATE( range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) );</div>
<div class="line"><a name="l00267"></a><span class="lineno"> 267</span>  <span class="keywordtype">int</span> targ2 = GENERATE_COPY( filter([=](<span class="keywordtype">int</span> t){ <span class="keywordflow">return</span> t!=targ1; }, range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>)) );</div>
<div class="line"><a name="l00268"></a><span class="lineno"> 268</span>  </div>
<div class="line"><a name="l00269"></a><span class="lineno"> 269</span>  <span class="comment">// reference boilerplate</span></div>
<div class="line"><a name="l00270"></a><span class="lineno"> 270</span>  <span class="keywordtype">int</span>* ctrls = NULL;</div>
<div class="line"><a name="l00271"></a><span class="lineno"> 271</span>  <span class="keywordtype">int</span> numCtrls = 0;</div>
<div class="line"><a name="l00272"></a><span class="lineno"> 272</span>  <span class="keywordtype">int</span> targs[] = {targ1, targ2};</div>
<div class="line"><a name="l00273"></a><span class="lineno"> 273</span>  <span class="keywordtype">int</span> numTargs = 2;</div>
<div class="line"><a name="l00274"></a><span class="lineno"> 274</span>  </div>
<div class="line"><a name="l00275"></a><span class="lineno"> 275</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00276"></a><span class="lineno"> 276</span>  </div>
<div class="line"><a name="l00277"></a><span class="lineno"> 277</span>  <a class="code" href="group__operator.html#ga74a955ec4bce606d89317bcfc528387f">applyMatrix4</a>(quregVec, targ1, targ2, matr);</div>
<div class="line"><a name="l00278"></a><span class="lineno"> 278</span>  <a class="code" href="group__testutilities.html#ga059fea2ee0415bf25929601ba0788164">applyReferenceMatrix</a>(refVec, ctrls, numCtrls, targs, numTargs, op);</div>
<div class="line"><a name="l00279"></a><span class="lineno"> 279</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l00280"></a><span class="lineno"> 280</span>  }</div>
<div class="line"><a name="l00281"></a><span class="lineno"> 281</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00282"></a><span class="lineno"> 282</span>  </div>
<div class="line"><a name="l00283"></a><span class="lineno"> 283</span>  <a class="code" href="group__operator.html#ga74a955ec4bce606d89317bcfc528387f">applyMatrix4</a>(quregMatr, targ1, targ2, matr);</div>
<div class="line"><a name="l00284"></a><span class="lineno"> 284</span>  <a class="code" href="group__testutilities.html#ga059fea2ee0415bf25929601ba0788164">applyReferenceMatrix</a>(refMatr, ctrls, numCtrls, targs, numTargs, op);</div>
<div class="line"><a name="l00285"></a><span class="lineno"> 285</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 10*REAL_EPS) );</div>
<div class="line"><a name="l00286"></a><span class="lineno"> 286</span>  }</div>
<div class="line"><a name="l00287"></a><span class="lineno"> 287</span>  }</div>
<div class="line"><a name="l00288"></a><span class="lineno"> 288</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00289"></a><span class="lineno"> 289</span>  </div>
<div class="line"><a name="l00290"></a><span class="lineno"> 290</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l00291"></a><span class="lineno"> 291</span>  </div>
<div class="line"><a name="l00292"></a><span class="lineno"> 292</span>  <span class="keywordtype">int</span> targ1 = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l00293"></a><span class="lineno"> 293</span>  <span class="keywordtype">int</span> targ2 = 0;</div>
<div class="line"><a name="l00294"></a><span class="lineno"> 294</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga74a955ec4bce606d89317bcfc528387f">applyMatrix4</a>(quregVec, targ1, targ2, matr), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l00295"></a><span class="lineno"> 295</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga74a955ec4bce606d89317bcfc528387f">applyMatrix4</a>(quregVec, targ2, targ1, matr), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l00296"></a><span class="lineno"> 296</span>  }</div>
<div class="line"><a name="l00297"></a><span class="lineno"> 297</span>  SECTION( <span class="stringliteral">"repetition of targets"</span> ) {</div>
<div class="line"><a name="l00298"></a><span class="lineno"> 298</span>  </div>
<div class="line"><a name="l00299"></a><span class="lineno"> 299</span>  <span class="keywordtype">int</span> qb = 0;</div>
<div class="line"><a name="l00300"></a><span class="lineno"> 300</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga74a955ec4bce606d89317bcfc528387f">applyMatrix4</a>(quregVec, qb, qb, matr), Contains(<span class="stringliteral">"target"</span>) && Contains(<span class="stringliteral">"unique"</span>) );</div>
<div class="line"><a name="l00301"></a><span class="lineno"> 301</span>  }</div>
<div class="line"><a name="l00302"></a><span class="lineno"> 302</span>  SECTION( <span class="stringliteral">"matrix fits in node"</span> ) {</div>
<div class="line"><a name="l00303"></a><span class="lineno"> 303</span>  </div>
<div class="line"><a name="l00304"></a><span class="lineno"> 304</span>  <span class="comment">// pretend we have a very limited distributed memory</span></div>
<div class="line"><a name="l00305"></a><span class="lineno"> 305</span>  quregVec.numAmpsPerChunk = 1;</div>
<div class="line"><a name="l00306"></a><span class="lineno"> 306</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga74a955ec4bce606d89317bcfc528387f">applyMatrix4</a>(quregVec, 0, 1, matr), Contains(<span class="stringliteral">"targets too many qubits"</span>));</div>
<div class="line"><a name="l00307"></a><span class="lineno"> 307</span>  }</div>
<div class="line"><a name="l00308"></a><span class="lineno"> 308</span>  }</div>
<div class="line"><a name="l00309"></a><span class="lineno"> 309</span>  <a class="code" href="test__operators_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l00310"></a><span class="lineno"> 310</span> }</div>
<div class="line"><a name="l00311"></a><span class="lineno"> 311</span>  </div>
<div class="line"><a name="l00312"></a><span class="lineno"> 312</span>  </div>
<div class="line"><a name="l00313"></a><span class="lineno"> 313</span>  </div>
<div class="line"><a name="l00318"></a><span class="lineno"><a class="line" href="group__unittest.html#gaeefabb147eca8dfffe23ca34195b395f"> 318</a></span> <a class="code" href="group__unittest.html#gaff6822e79b947a9e3b791572c674c08c">TEST_CASE</a>( <span class="stringliteral">"applyMatrixN"</span>, <span class="stringliteral">"[operators]"</span> ) {</div>
<div class="line"><a name="l00319"></a><span class="lineno"> 319</span>  </div>
<div class="line"><a name="l00320"></a><span class="lineno"> 320</span>  <a class="code" href="test__operators_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l00321"></a><span class="lineno"> 321</span>  </div>
<div class="line"><a name="l00322"></a><span class="lineno"> 322</span>  <span class="comment">// figure out max-num (inclusive) targs allowed by hardware backend</span></div>
<div class="line"><a name="l00323"></a><span class="lineno"> 323</span>  <span class="keywordtype">int</span> maxNumTargs = <a class="code" href="group__testutilities.html#ga267884197cf7f1d428021cb12a57360c">calcLog2</a>(quregVec.numAmpsPerChunk);</div>
<div class="line"><a name="l00324"></a><span class="lineno"> 324</span>  </div>
<div class="line"><a name="l00325"></a><span class="lineno"> 325</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00326"></a><span class="lineno"> 326</span>  </div>
<div class="line"><a name="l00327"></a><span class="lineno"> 327</span>  <span class="comment">// generate all possible qubit arrangements</span></div>
<div class="line"><a name="l00328"></a><span class="lineno"> 328</span>  <span class="keywordtype">int</span> numTargs = GENERATE_COPY( range(1,maxNumTargs+1) ); <span class="comment">// inclusive upper bound</span></div>
<div class="line"><a name="l00329"></a><span class="lineno"> 329</span>  <span class="keywordtype">int</span>* targs = GENERATE_COPY( <a class="code" href="group__testutilities.html#ga35add15146aa606b256df79334b867d5">sublists</a>(range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>), numTargs) );</div>
<div class="line"><a name="l00330"></a><span class="lineno"> 330</span>  </div>
<div class="line"><a name="l00331"></a><span class="lineno"> 331</span>  <span class="comment">// for each qubit arrangement, use a new random matrix</span></div>
<div class="line"><a name="l00332"></a><span class="lineno"> 332</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op = <a class="code" href="group__testutilities.html#gaa2e8b958e0cba07e01de9f91a5ce3c9c">getRandomQMatrix</a>(1 << numTargs);</div>
<div class="line"><a name="l00333"></a><span class="lineno"> 333</span>  <a class="code" href="structComplexMatrixN.html">ComplexMatrixN</a> matr = <a class="code" href="group__type.html#ga815103261fb22ea9690e1427571df00e">createComplexMatrixN</a>(numTargs);</div>
<div class="line"><a name="l00334"></a><span class="lineno"> 334</span>  <a class="code" href="group__testutilities.html#ga7f83695bea7d0332a577bca017dbb03c">toComplexMatrixN</a>(op, matr);</div>
<div class="line"><a name="l00335"></a><span class="lineno"> 335</span>  </div>
<div class="line"><a name="l00336"></a><span class="lineno"> 336</span>  <span class="comment">// reference boilerplate</span></div>
<div class="line"><a name="l00337"></a><span class="lineno"> 337</span>  <span class="keywordtype">int</span>* ctrls = NULL;</div>
<div class="line"><a name="l00338"></a><span class="lineno"> 338</span>  <span class="keywordtype">int</span> numCtrls = 0;</div>
<div class="line"><a name="l00339"></a><span class="lineno"> 339</span>  </div>
<div class="line"><a name="l00340"></a><span class="lineno"> 340</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00341"></a><span class="lineno"> 341</span>  </div>
<div class="line"><a name="l00342"></a><span class="lineno"> 342</span>  <a class="code" href="group__operator.html#ga358e7094a98851afa86d27f0147e32a1">applyMatrixN</a>(quregVec, targs, numTargs, matr);</div>
<div class="line"><a name="l00343"></a><span class="lineno"> 343</span>  <a class="code" href="group__testutilities.html#ga059fea2ee0415bf25929601ba0788164">applyReferenceMatrix</a>(refVec, ctrls, numCtrls, targs, numTargs, op);</div>
<div class="line"><a name="l00344"></a><span class="lineno"> 344</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l00345"></a><span class="lineno"> 345</span>  }</div>
<div class="line"><a name="l00346"></a><span class="lineno"> 346</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00347"></a><span class="lineno"> 347</span>  </div>
<div class="line"><a name="l00348"></a><span class="lineno"> 348</span>  <a class="code" href="group__operator.html#ga358e7094a98851afa86d27f0147e32a1">applyMatrixN</a>(quregMatr, targs, numTargs, matr);</div>
<div class="line"><a name="l00349"></a><span class="lineno"> 349</span>  <a class="code" href="group__testutilities.html#ga059fea2ee0415bf25929601ba0788164">applyReferenceMatrix</a>(refMatr, ctrls, numCtrls, targs, numTargs, op);</div>
<div class="line"><a name="l00350"></a><span class="lineno"> 350</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 100*REAL_EPS) );</div>
<div class="line"><a name="l00351"></a><span class="lineno"> 351</span>  }</div>
<div class="line"><a name="l00352"></a><span class="lineno"> 352</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l00353"></a><span class="lineno"> 353</span>  }</div>
<div class="line"><a name="l00354"></a><span class="lineno"> 354</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00355"></a><span class="lineno"> 355</span>  </div>
<div class="line"><a name="l00356"></a><span class="lineno"> 356</span>  SECTION( <span class="stringliteral">"number of targets"</span> ) {</div>
<div class="line"><a name="l00357"></a><span class="lineno"> 357</span>  </div>
<div class="line"><a name="l00358"></a><span class="lineno"> 358</span>  <span class="comment">// there cannot be more targets than qubits in register</span></div>
<div class="line"><a name="l00359"></a><span class="lineno"> 359</span>  <span class="keywordtype">int</span> numTargs = GENERATE( -1, 0, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1 );</div>
<div class="line"><a name="l00360"></a><span class="lineno"> 360</span>  <span class="keywordtype">int</span> targs[<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1]; <span class="comment">// prevents seg-fault if validation doesn't trigger</span></div>
<div class="line"><a name="l00361"></a><span class="lineno"> 361</span>  <a class="code" href="structComplexMatrixN.html">ComplexMatrixN</a> matr = <a class="code" href="group__type.html#ga815103261fb22ea9690e1427571df00e">createComplexMatrixN</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1); <span class="comment">// prevent seg-fault</span></div>
<div class="line"><a name="l00362"></a><span class="lineno"> 362</span>  </div>
<div class="line"><a name="l00363"></a><span class="lineno"> 363</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga358e7094a98851afa86d27f0147e32a1">applyMatrixN</a>(quregVec, targs, numTargs, matr), Contains(<span class="stringliteral">"Invalid number of target"</span>));</div>
<div class="line"><a name="l00364"></a><span class="lineno"> 364</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l00365"></a><span class="lineno"> 365</span>  }</div>
<div class="line"><a name="l00366"></a><span class="lineno"> 366</span>  SECTION( <span class="stringliteral">"repetition in targets"</span> ) {</div>
<div class="line"><a name="l00367"></a><span class="lineno"> 367</span>  </div>
<div class="line"><a name="l00368"></a><span class="lineno"> 368</span>  <span class="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l00369"></a><span class="lineno"> 369</span>  <span class="keywordtype">int</span> targs[] = {1,2,2};</div>
<div class="line"><a name="l00370"></a><span class="lineno"> 370</span>  <a class="code" href="structComplexMatrixN.html">ComplexMatrixN</a> matr = <a class="code" href="group__type.html#ga815103261fb22ea9690e1427571df00e">createComplexMatrixN</a>(numTargs); <span class="comment">// prevents seg-fault if validation doesn't trigger</span></div>
<div class="line"><a name="l00371"></a><span class="lineno"> 371</span>  </div>
<div class="line"><a name="l00372"></a><span class="lineno"> 372</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga358e7094a98851afa86d27f0147e32a1">applyMatrixN</a>(quregVec, targs, numTargs, matr), Contains(<span class="stringliteral">"target"</span>) && Contains(<span class="stringliteral">"unique"</span>));</div>
<div class="line"><a name="l00373"></a><span class="lineno"> 373</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l00374"></a><span class="lineno"> 374</span>  }</div>
<div class="line"><a name="l00375"></a><span class="lineno"> 375</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l00376"></a><span class="lineno"> 376</span>  </div>
<div class="line"><a name="l00377"></a><span class="lineno"> 377</span>  <span class="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l00378"></a><span class="lineno"> 378</span>  <span class="keywordtype">int</span> targs[] = {1,2,3};</div>
<div class="line"><a name="l00379"></a><span class="lineno"> 379</span>  <a class="code" href="structComplexMatrixN.html">ComplexMatrixN</a> matr = <a class="code" href="group__type.html#ga815103261fb22ea9690e1427571df00e">createComplexMatrixN</a>(numTargs); <span class="comment">// prevents seg-fault if validation doesn't trigger</span></div>
<div class="line"><a name="l00380"></a><span class="lineno"> 380</span>  </div>
<div class="line"><a name="l00381"></a><span class="lineno"> 381</span>  <span class="keywordtype">int</span> inv = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l00382"></a><span class="lineno"> 382</span>  targs[GENERATE_COPY( range(0,numTargs) )] = inv; <span class="comment">// make invalid target</span></div>
<div class="line"><a name="l00383"></a><span class="lineno"> 383</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga358e7094a98851afa86d27f0147e32a1">applyMatrixN</a>(quregVec, targs, numTargs, matr), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l00384"></a><span class="lineno"> 384</span>  </div>
<div class="line"><a name="l00385"></a><span class="lineno"> 385</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l00386"></a><span class="lineno"> 386</span>  }</div>
<div class="line"><a name="l00387"></a><span class="lineno"> 387</span>  SECTION( <span class="stringliteral">"matrix creation"</span> ) {</div>
<div class="line"><a name="l00388"></a><span class="lineno"> 388</span>  </div>
<div class="line"><a name="l00389"></a><span class="lineno"> 389</span>  <span class="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l00390"></a><span class="lineno"> 390</span>  <span class="keywordtype">int</span> targs[] = {1,2,3};</div>
<div class="line"><a name="l00391"></a><span class="lineno"> 391</span>  </div>
<div class="line"><a name="l00392"></a><span class="lineno"> 392</span>  <span class="comment">/* compilers don't auto-initialise to NULL; the below circumstance </span></div>
<div class="line"><a name="l00393"></a><span class="lineno"> 393</span> <span class="comment"> * only really occurs when 'malloc' returns NULL in createComplexMatrixN, </span></div>
<div class="line"><a name="l00394"></a><span class="lineno"> 394</span> <span class="comment"> * which actually triggers its own validation. Hence this test is useless </span></div>
<div class="line"><a name="l00395"></a><span class="lineno"> 395</span> <span class="comment"> * currently.</span></div>
<div class="line"><a name="l00396"></a><span class="lineno"> 396</span> <span class="comment"> */</span></div>
<div class="line"><a name="l00397"></a><span class="lineno"> 397</span>  <a class="code" href="structComplexMatrixN.html">ComplexMatrixN</a> matr;</div>
<div class="line"><a name="l00398"></a><span class="lineno"> 398</span>  matr.<a class="code" href="structComplexMatrixN.html#a446e8a077597e4f76049d547df0c9738">real</a> = NULL;</div>
<div class="line"><a name="l00399"></a><span class="lineno"> 399</span>  matr.<a class="code" href="structComplexMatrixN.html#afde13e469a3b4f179f45e53d1ec0a7cf">imag</a> = NULL; </div>
<div class="line"><a name="l00400"></a><span class="lineno"> 400</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga358e7094a98851afa86d27f0147e32a1">applyMatrixN</a>(quregVec, targs, numTargs, matr), Contains(<span class="stringliteral">"created"</span>) );</div>
<div class="line"><a name="l00401"></a><span class="lineno"> 401</span>  }</div>
<div class="line"><a name="l00402"></a><span class="lineno"> 402</span>  SECTION( <span class="stringliteral">"matrix dimensions"</span> ) {</div>
<div class="line"><a name="l00403"></a><span class="lineno"> 403</span>  </div>
<div class="line"><a name="l00404"></a><span class="lineno"> 404</span>  <span class="keywordtype">int</span> targs[2] = {1,2};</div>
<div class="line"><a name="l00405"></a><span class="lineno"> 405</span>  <a class="code" href="structComplexMatrixN.html">ComplexMatrixN</a> matr = <a class="code" href="group__type.html#ga815103261fb22ea9690e1427571df00e">createComplexMatrixN</a>(3); <span class="comment">// intentionally wrong size</span></div>
<div class="line"><a name="l00406"></a><span class="lineno"> 406</span>  </div>
<div class="line"><a name="l00407"></a><span class="lineno"> 407</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga358e7094a98851afa86d27f0147e32a1">applyMatrixN</a>(quregVec, targs, 2, matr), Contains(<span class="stringliteral">"matrix size"</span>));</div>
<div class="line"><a name="l00408"></a><span class="lineno"> 408</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l00409"></a><span class="lineno"> 409</span>  }</div>
<div class="line"><a name="l00410"></a><span class="lineno"> 410</span>  SECTION( <span class="stringliteral">"matrix fits in node"</span> ) {</div>
<div class="line"><a name="l00411"></a><span class="lineno"> 411</span>  </div>
<div class="line"><a name="l00412"></a><span class="lineno"> 412</span>  <span class="comment">// pretend we have a very limited distributed memory (judged by matr size)</span></div>
<div class="line"><a name="l00413"></a><span class="lineno"> 413</span>  quregVec.numAmpsPerChunk = 1;</div>
<div class="line"><a name="l00414"></a><span class="lineno"> 414</span>  <span class="keywordtype">int</span> qb[] = {1,2};</div>
<div class="line"><a name="l00415"></a><span class="lineno"> 415</span>  <a class="code" href="structComplexMatrixN.html">ComplexMatrixN</a> matr = <a class="code" href="group__type.html#ga815103261fb22ea9690e1427571df00e">createComplexMatrixN</a>(2); <span class="comment">// prevents seg-fault if validation doesn't trigger</span></div>
<div class="line"><a name="l00416"></a><span class="lineno"> 416</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga358e7094a98851afa86d27f0147e32a1">applyMatrixN</a>(quregVec, qb, 2, matr), Contains(<span class="stringliteral">"targets too many qubits"</span>));</div>
<div class="line"><a name="l00417"></a><span class="lineno"> 417</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l00418"></a><span class="lineno"> 418</span>  }</div>
<div class="line"><a name="l00419"></a><span class="lineno"> 419</span>  }</div>
<div class="line"><a name="l00420"></a><span class="lineno"> 420</span>  <a class="code" href="test__operators_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l00421"></a><span class="lineno"> 421</span> }</div>
<div class="line"><a name="l00422"></a><span class="lineno"> 422</span>  </div>
<div class="line"><a name="l00423"></a><span class="lineno"> 423</span>  </div>
<div class="line"><a name="l00424"></a><span class="lineno"> 424</span>  </div>
<div class="line"><a name="l00429"></a><span class="lineno"><a class="line" href="group__unittest.html#gaa5fbe07e8ee18a944dfa88b00aef1803"> 429</a></span> <a class="code" href="group__unittest.html#gaff6822e79b947a9e3b791572c674c08c">TEST_CASE</a>( <span class="stringliteral">"applyMultiControlledMatrixN"</span>, <span class="stringliteral">"[operators]"</span> ) {</div>
<div class="line"><a name="l00430"></a><span class="lineno"> 430</span>  </div>
<div class="line"><a name="l00431"></a><span class="lineno"> 431</span>  <a class="code" href="test__operators_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l00432"></a><span class="lineno"> 432</span>  </div>
<div class="line"><a name="l00433"></a><span class="lineno"> 433</span>  <span class="comment">// figure out max-num targs (inclusive) allowed by hardware backend</span></div>
<div class="line"><a name="l00434"></a><span class="lineno"> 434</span>  <span class="keywordtype">int</span> maxNumTargs = <a class="code" href="group__testutilities.html#ga267884197cf7f1d428021cb12a57360c">calcLog2</a>(quregVec.numAmpsPerChunk);</div>
<div class="line"><a name="l00435"></a><span class="lineno"> 435</span>  <span class="keywordflow">if</span> (maxNumTargs >= <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>)</div>
<div class="line"><a name="l00436"></a><span class="lineno"> 436</span>  maxNumTargs = <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> - 1; <span class="comment">// leave room for min-number of control qubits</span></div>
<div class="line"><a name="l00437"></a><span class="lineno"> 437</span>  </div>
<div class="line"><a name="l00438"></a><span class="lineno"> 438</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00439"></a><span class="lineno"> 439</span>  </div>
<div class="line"><a name="l00440"></a><span class="lineno"> 440</span>  <span class="comment">// try all possible numbers of targets and controls</span></div>
<div class="line"><a name="l00441"></a><span class="lineno"> 441</span>  <span class="keywordtype">int</span> numTargs = GENERATE_COPY( range(1,maxNumTargs+1) );</div>
<div class="line"><a name="l00442"></a><span class="lineno"> 442</span>  <span class="keywordtype">int</span> maxNumCtrls = <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> - numTargs;</div>
<div class="line"><a name="l00443"></a><span class="lineno"> 443</span>  <span class="keywordtype">int</span> numCtrls = GENERATE_COPY( range(1,maxNumCtrls+1) );</div>
<div class="line"><a name="l00444"></a><span class="lineno"> 444</span>  </div>
<div class="line"><a name="l00445"></a><span class="lineno"> 445</span>  <span class="comment">// generate all possible valid qubit arrangements</span></div>
<div class="line"><a name="l00446"></a><span class="lineno"> 446</span>  <span class="keywordtype">int</span>* targs = GENERATE_COPY( <a class="code" href="group__testutilities.html#ga35add15146aa606b256df79334b867d5">sublists</a>(range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>), numTargs) );</div>
<div class="line"><a name="l00447"></a><span class="lineno"> 447</span>  <span class="keywordtype">int</span>* ctrls = GENERATE_COPY( <a class="code" href="group__testutilities.html#ga35add15146aa606b256df79334b867d5">sublists</a>(range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>), numCtrls, targs, numTargs) );</div>
<div class="line"><a name="l00448"></a><span class="lineno"> 448</span>  </div>
<div class="line"><a name="l00449"></a><span class="lineno"> 449</span>  <span class="comment">// for each qubit arrangement, use a new random unitary</span></div>
<div class="line"><a name="l00450"></a><span class="lineno"> 450</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op = <a class="code" href="group__testutilities.html#gaa2e8b958e0cba07e01de9f91a5ce3c9c">getRandomQMatrix</a>(1 << numTargs);</div>
<div class="line"><a name="l00451"></a><span class="lineno"> 451</span>  <a class="code" href="structComplexMatrixN.html">ComplexMatrixN</a> matr = <a class="code" href="group__type.html#ga815103261fb22ea9690e1427571df00e">createComplexMatrixN</a>(numTargs);</div>
<div class="line"><a name="l00452"></a><span class="lineno"> 452</span>  <a class="code" href="group__testutilities.html#ga7f83695bea7d0332a577bca017dbb03c">toComplexMatrixN</a>(op, matr);</div>
<div class="line"><a name="l00453"></a><span class="lineno"> 453</span>  </div>
<div class="line"><a name="l00454"></a><span class="lineno"> 454</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00455"></a><span class="lineno"> 455</span>  </div>
<div class="line"><a name="l00456"></a><span class="lineno"> 456</span>  <a class="code" href="group__operator.html#gab52b6315c5520b7d311b0458785eed8e">applyMultiControlledMatrixN</a>(quregVec, ctrls, numCtrls, targs, numTargs, matr);</div>
<div class="line"><a name="l00457"></a><span class="lineno"> 457</span>  <a class="code" href="group__testutilities.html#ga059fea2ee0415bf25929601ba0788164">applyReferenceMatrix</a>(refVec, ctrls, numCtrls, targs, numTargs, op);</div>
<div class="line"><a name="l00458"></a><span class="lineno"> 458</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l00459"></a><span class="lineno"> 459</span>  }</div>
<div class="line"><a name="l00460"></a><span class="lineno"> 460</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00461"></a><span class="lineno"> 461</span>  </div>
<div class="line"><a name="l00462"></a><span class="lineno"> 462</span>  <a class="code" href="group__operator.html#gab52b6315c5520b7d311b0458785eed8e">applyMultiControlledMatrixN</a>(quregMatr, ctrls, numCtrls, targs, numTargs, matr);</div>
<div class="line"><a name="l00463"></a><span class="lineno"> 463</span>  <a class="code" href="group__testutilities.html#ga059fea2ee0415bf25929601ba0788164">applyReferenceMatrix</a>(refMatr, ctrls, numCtrls, targs, numTargs, op);</div>
<div class="line"><a name="l00464"></a><span class="lineno"> 464</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 100*REAL_EPS) );</div>
<div class="line"><a name="l00465"></a><span class="lineno"> 465</span>  }</div>
<div class="line"><a name="l00466"></a><span class="lineno"> 466</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l00467"></a><span class="lineno"> 467</span>  }</div>
<div class="line"><a name="l00468"></a><span class="lineno"> 468</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00469"></a><span class="lineno"> 469</span>  </div>
<div class="line"><a name="l00470"></a><span class="lineno"> 470</span>  SECTION( <span class="stringliteral">"number of targets"</span> ) {</div>
<div class="line"><a name="l00471"></a><span class="lineno"> 471</span>  </div>
<div class="line"><a name="l00472"></a><span class="lineno"> 472</span>  <span class="comment">// there cannot be more targets than qubits in register</span></div>
<div class="line"><a name="l00473"></a><span class="lineno"> 473</span>  <span class="comment">// (numTargs=NUM_QUBITS is caught elsewhere, because that implies ctrls are invalid)</span></div>
<div class="line"><a name="l00474"></a><span class="lineno"> 474</span>  <span class="keywordtype">int</span> numTargs = GENERATE( -1, 0, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1 );</div>
<div class="line"><a name="l00475"></a><span class="lineno"> 475</span>  <span class="keywordtype">int</span> targs[<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1]; <span class="comment">// prevents seg-fault if validation doesn't trigger</span></div>
<div class="line"><a name="l00476"></a><span class="lineno"> 476</span>  <span class="keywordtype">int</span> ctrls[] = {0};</div>
<div class="line"><a name="l00477"></a><span class="lineno"> 477</span>  <a class="code" href="structComplexMatrixN.html">ComplexMatrixN</a> matr = <a class="code" href="group__type.html#ga815103261fb22ea9690e1427571df00e">createComplexMatrixN</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1); <span class="comment">// prevent seg-fault</span></div>
<div class="line"><a name="l00478"></a><span class="lineno"> 478</span>  <a class="code" href="group__testutilities.html#ga7f83695bea7d0332a577bca017dbb03c">toComplexMatrixN</a>(<a class="code" href="group__testutilities.html#gaa2e8b958e0cba07e01de9f91a5ce3c9c">getRandomQMatrix</a>( 1 << (<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1)), matr);</div>
<div class="line"><a name="l00479"></a><span class="lineno"> 479</span>  </div>
<div class="line"><a name="l00480"></a><span class="lineno"> 480</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gab52b6315c5520b7d311b0458785eed8e">applyMultiControlledMatrixN</a>(quregVec, ctrls, 1, targs, numTargs, matr), Contains(<span class="stringliteral">"Invalid number of target"</span>));</div>
<div class="line"><a name="l00481"></a><span class="lineno"> 481</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l00482"></a><span class="lineno"> 482</span>  }</div>
<div class="line"><a name="l00483"></a><span class="lineno"> 483</span>  SECTION( <span class="stringliteral">"repetition in targets"</span> ) {</div>
<div class="line"><a name="l00484"></a><span class="lineno"> 484</span>  </div>
<div class="line"><a name="l00485"></a><span class="lineno"> 485</span>  <span class="keywordtype">int</span> ctrls[] = {0};</div>
<div class="line"><a name="l00486"></a><span class="lineno"> 486</span>  <span class="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l00487"></a><span class="lineno"> 487</span>  <span class="keywordtype">int</span> targs[] = {1,2,2};</div>
<div class="line"><a name="l00488"></a><span class="lineno"> 488</span>  <a class="code" href="structComplexMatrixN.html">ComplexMatrixN</a> matr = <a class="code" href="group__type.html#ga815103261fb22ea9690e1427571df00e">createComplexMatrixN</a>(numTargs); <span class="comment">// prevents seg-fault if validation doesn't trigger</span></div>
<div class="line"><a name="l00489"></a><span class="lineno"> 489</span>  <a class="code" href="group__testutilities.html#ga7f83695bea7d0332a577bca017dbb03c">toComplexMatrixN</a>(<a class="code" href="group__testutilities.html#gaa2e8b958e0cba07e01de9f91a5ce3c9c">getRandomQMatrix</a>(1 << numTargs), matr);</div>
<div class="line"><a name="l00490"></a><span class="lineno"> 490</span>  </div>
<div class="line"><a name="l00491"></a><span class="lineno"> 491</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gab52b6315c5520b7d311b0458785eed8e">applyMultiControlledMatrixN</a>(quregVec, ctrls, 1, targs, numTargs, matr), Contains(<span class="stringliteral">"target"</span>) && Contains(<span class="stringliteral">"unique"</span>));</div>
<div class="line"><a name="l00492"></a><span class="lineno"> 492</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l00493"></a><span class="lineno"> 493</span>  }</div>
<div class="line"><a name="l00494"></a><span class="lineno"> 494</span>  SECTION( <span class="stringliteral">"number of controls"</span> ) {</div>
<div class="line"><a name="l00495"></a><span class="lineno"> 495</span>  </div>
<div class="line"><a name="l00496"></a><span class="lineno"> 496</span>  <span class="keywordtype">int</span> numCtrls = GENERATE( -1, 0, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1 );</div>
<div class="line"><a name="l00497"></a><span class="lineno"> 497</span>  <span class="keywordtype">int</span> ctrls[<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1]; <span class="comment">// avoids seg-fault if validation not triggered</span></div>
<div class="line"><a name="l00498"></a><span class="lineno"> 498</span>  <span class="keywordtype">int</span> targs[1] = {0};</div>
<div class="line"><a name="l00499"></a><span class="lineno"> 499</span>  <a class="code" href="structComplexMatrixN.html">ComplexMatrixN</a> matr = <a class="code" href="group__type.html#ga815103261fb22ea9690e1427571df00e">createComplexMatrixN</a>(1);</div>
<div class="line"><a name="l00500"></a><span class="lineno"> 500</span>  <a class="code" href="group__testutilities.html#ga7f83695bea7d0332a577bca017dbb03c">toComplexMatrixN</a>(<a class="code" href="group__testutilities.html#gaa2e8b958e0cba07e01de9f91a5ce3c9c">getRandomQMatrix</a>(1 << 1), matr);</div>
<div class="line"><a name="l00501"></a><span class="lineno"> 501</span>  </div>
<div class="line"><a name="l00502"></a><span class="lineno"> 502</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gab52b6315c5520b7d311b0458785eed8e">applyMultiControlledMatrixN</a>(quregVec, ctrls, numCtrls, targs, 1, matr), Contains(<span class="stringliteral">"Invalid number of control"</span>));</div>
<div class="line"><a name="l00503"></a><span class="lineno"> 503</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l00504"></a><span class="lineno"> 504</span>  }</div>
<div class="line"><a name="l00505"></a><span class="lineno"> 505</span>  SECTION( <span class="stringliteral">"repetition in controls"</span> ) {</div>
<div class="line"><a name="l00506"></a><span class="lineno"> 506</span>  </div>
<div class="line"><a name="l00507"></a><span class="lineno"> 507</span>  <span class="keywordtype">int</span> ctrls[] = {0,1,1};</div>
<div class="line"><a name="l00508"></a><span class="lineno"> 508</span>  <span class="keywordtype">int</span> targs[] = {3};</div>
<div class="line"><a name="l00509"></a><span class="lineno"> 509</span>  <a class="code" href="structComplexMatrixN.html">ComplexMatrixN</a> matr = <a class="code" href="group__type.html#ga815103261fb22ea9690e1427571df00e">createComplexMatrixN</a>(1);</div>
<div class="line"><a name="l00510"></a><span class="lineno"> 510</span>  <a class="code" href="group__testutilities.html#ga7f83695bea7d0332a577bca017dbb03c">toComplexMatrixN</a>(<a class="code" href="group__testutilities.html#gaa2e8b958e0cba07e01de9f91a5ce3c9c">getRandomQMatrix</a>(1 << 1), matr);</div>
<div class="line"><a name="l00511"></a><span class="lineno"> 511</span>  </div>
<div class="line"><a name="l00512"></a><span class="lineno"> 512</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gab52b6315c5520b7d311b0458785eed8e">applyMultiControlledMatrixN</a>(quregVec, ctrls, 3, targs, 1, matr), Contains(<span class="stringliteral">"control"</span>) && Contains(<span class="stringliteral">"unique"</span>));</div>
<div class="line"><a name="l00513"></a><span class="lineno"> 513</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l00514"></a><span class="lineno"> 514</span>  }</div>
<div class="line"><a name="l00515"></a><span class="lineno"> 515</span>  SECTION( <span class="stringliteral">"control and target collision"</span> ) {</div>
<div class="line"><a name="l00516"></a><span class="lineno"> 516</span>  </div>
<div class="line"><a name="l00517"></a><span class="lineno"> 517</span>  <span class="keywordtype">int</span> ctrls[] = {0,1,2};</div>
<div class="line"><a name="l00518"></a><span class="lineno"> 518</span>  <span class="keywordtype">int</span> targs[] = {3,1,4};</div>
<div class="line"><a name="l00519"></a><span class="lineno"> 519</span>  <a class="code" href="structComplexMatrixN.html">ComplexMatrixN</a> matr = <a class="code" href="group__type.html#ga815103261fb22ea9690e1427571df00e">createComplexMatrixN</a>(3);</div>
<div class="line"><a name="l00520"></a><span class="lineno"> 520</span>  <a class="code" href="group__testutilities.html#ga7f83695bea7d0332a577bca017dbb03c">toComplexMatrixN</a>(<a class="code" href="group__testutilities.html#gaa2e8b958e0cba07e01de9f91a5ce3c9c">getRandomQMatrix</a>(1 << 3), matr);</div>
<div class="line"><a name="l00521"></a><span class="lineno"> 521</span>  </div>
<div class="line"><a name="l00522"></a><span class="lineno"> 522</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gab52b6315c5520b7d311b0458785eed8e">applyMultiControlledMatrixN</a>(quregVec, ctrls, 3, targs, 3, matr), Contains(<span class="stringliteral">"Control"</span>) && Contains(<span class="stringliteral">"target"</span>) && Contains(<span class="stringliteral">"disjoint"</span>));</div>
<div class="line"><a name="l00523"></a><span class="lineno"> 523</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l00524"></a><span class="lineno"> 524</span>  }</div>
<div class="line"><a name="l00525"></a><span class="lineno"> 525</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l00526"></a><span class="lineno"> 526</span>  </div>
<div class="line"><a name="l00527"></a><span class="lineno"> 527</span>  <span class="comment">// valid inds</span></div>
<div class="line"><a name="l00528"></a><span class="lineno"> 528</span>  <span class="keywordtype">int</span> numQb = 2;</div>
<div class="line"><a name="l00529"></a><span class="lineno"> 529</span>  <span class="keywordtype">int</span> qb1[2] = {0,1};</div>
<div class="line"><a name="l00530"></a><span class="lineno"> 530</span>  <span class="keywordtype">int</span> qb2[2] = {2,3};</div>
<div class="line"><a name="l00531"></a><span class="lineno"> 531</span>  <a class="code" href="structComplexMatrixN.html">ComplexMatrixN</a> matr = <a class="code" href="group__type.html#ga815103261fb22ea9690e1427571df00e">createComplexMatrixN</a>(numQb);</div>
<div class="line"><a name="l00532"></a><span class="lineno"> 532</span>  <a class="code" href="group__testutilities.html#ga7f83695bea7d0332a577bca017dbb03c">toComplexMatrixN</a>(<a class="code" href="group__testutilities.html#gaa2e8b958e0cba07e01de9f91a5ce3c9c">getRandomQMatrix</a>(1 << numQb), matr);</div>
<div class="line"><a name="l00533"></a><span class="lineno"> 533</span>  </div>
<div class="line"><a name="l00534"></a><span class="lineno"> 534</span>  <span class="comment">// make qb1 invalid</span></div>
<div class="line"><a name="l00535"></a><span class="lineno"> 535</span>  <span class="keywordtype">int</span> inv = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l00536"></a><span class="lineno"> 536</span>  qb1[GENERATE_COPY(range(0,numQb))] = inv;</div>
<div class="line"><a name="l00537"></a><span class="lineno"> 537</span>  </div>
<div class="line"><a name="l00538"></a><span class="lineno"> 538</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gab52b6315c5520b7d311b0458785eed8e">applyMultiControlledMatrixN</a>(quregVec, qb1, numQb, qb2, numQb, matr), Contains(<span class="stringliteral">"Invalid control"</span>) );</div>
<div class="line"><a name="l00539"></a><span class="lineno"> 539</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gab52b6315c5520b7d311b0458785eed8e">applyMultiControlledMatrixN</a>(quregVec, qb2, numQb, qb1, numQb, matr), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l00540"></a><span class="lineno"> 540</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l00541"></a><span class="lineno"> 541</span>  }</div>
<div class="line"><a name="l00542"></a><span class="lineno"> 542</span>  SECTION( <span class="stringliteral">"matrix creation"</span> ) {</div>
<div class="line"><a name="l00543"></a><span class="lineno"> 543</span>  </div>
<div class="line"><a name="l00544"></a><span class="lineno"> 544</span>  <span class="keywordtype">int</span> ctrls[1] = {0};</div>
<div class="line"><a name="l00545"></a><span class="lineno"> 545</span>  <span class="keywordtype">int</span> targs[3] = {1,2,3};</div>
<div class="line"><a name="l00546"></a><span class="lineno"> 546</span>  </div>
<div class="line"><a name="l00547"></a><span class="lineno"> 547</span>  <span class="comment">/* compilers don't auto-initialise to NULL; the below circumstance </span></div>
<div class="line"><a name="l00548"></a><span class="lineno"> 548</span> <span class="comment"> * only really occurs when 'malloc' returns NULL in createComplexMatrixN, </span></div>
<div class="line"><a name="l00549"></a><span class="lineno"> 549</span> <span class="comment"> * which actually triggers its own validation. Hence this test is useless </span></div>
<div class="line"><a name="l00550"></a><span class="lineno"> 550</span> <span class="comment"> * currently.</span></div>
<div class="line"><a name="l00551"></a><span class="lineno"> 551</span> <span class="comment"> */</span></div>
<div class="line"><a name="l00552"></a><span class="lineno"> 552</span>  <a class="code" href="structComplexMatrixN.html">ComplexMatrixN</a> matr;</div>
<div class="line"><a name="l00553"></a><span class="lineno"> 553</span>  matr.<a class="code" href="structComplexMatrixN.html#a446e8a077597e4f76049d547df0c9738">real</a> = NULL;</div>
<div class="line"><a name="l00554"></a><span class="lineno"> 554</span>  matr.<a class="code" href="structComplexMatrixN.html#afde13e469a3b4f179f45e53d1ec0a7cf">imag</a> = NULL; </div>
<div class="line"><a name="l00555"></a><span class="lineno"> 555</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gab52b6315c5520b7d311b0458785eed8e">applyMultiControlledMatrixN</a>(quregVec, ctrls, 1, targs, 3, matr), Contains(<span class="stringliteral">"created"</span>) );</div>
<div class="line"><a name="l00556"></a><span class="lineno"> 556</span>  }</div>
<div class="line"><a name="l00557"></a><span class="lineno"> 557</span>  SECTION( <span class="stringliteral">"matrix dimensions"</span> ) {</div>
<div class="line"><a name="l00558"></a><span class="lineno"> 558</span>  </div>
<div class="line"><a name="l00559"></a><span class="lineno"> 559</span>  <span class="keywordtype">int</span> ctrls[1] = {0};</div>
<div class="line"><a name="l00560"></a><span class="lineno"> 560</span>  <span class="keywordtype">int</span> targs[2] = {1,2};</div>
<div class="line"><a name="l00561"></a><span class="lineno"> 561</span>  <a class="code" href="structComplexMatrixN.html">ComplexMatrixN</a> matr = <a class="code" href="group__type.html#ga815103261fb22ea9690e1427571df00e">createComplexMatrixN</a>(3); <span class="comment">// intentionally wrong size</span></div>
<div class="line"><a name="l00562"></a><span class="lineno"> 562</span>  <a class="code" href="group__testutilities.html#ga7f83695bea7d0332a577bca017dbb03c">toComplexMatrixN</a>(<a class="code" href="group__testutilities.html#gaa2e8b958e0cba07e01de9f91a5ce3c9c">getRandomQMatrix</a>(1 << 3), matr);</div>
<div class="line"><a name="l00563"></a><span class="lineno"> 563</span>  </div>
<div class="line"><a name="l00564"></a><span class="lineno"> 564</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gab52b6315c5520b7d311b0458785eed8e">applyMultiControlledMatrixN</a>(quregVec, ctrls, 1, targs, 2, matr), Contains(<span class="stringliteral">"matrix size"</span>));</div>
<div class="line"><a name="l00565"></a><span class="lineno"> 565</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l00566"></a><span class="lineno"> 566</span>  }</div>
<div class="line"><a name="l00567"></a><span class="lineno"> 567</span>  SECTION( <span class="stringliteral">"matrix fits in node"</span> ) {</div>
<div class="line"><a name="l00568"></a><span class="lineno"> 568</span>  </div>
<div class="line"><a name="l00569"></a><span class="lineno"> 569</span>  <span class="comment">// pretend we have a very limited distributed memory (judged by matr size)</span></div>
<div class="line"><a name="l00570"></a><span class="lineno"> 570</span>  quregVec.numAmpsPerChunk = 1;</div>
<div class="line"><a name="l00571"></a><span class="lineno"> 571</span>  <span class="keywordtype">int</span> ctrls[1] = {0};</div>
<div class="line"><a name="l00572"></a><span class="lineno"> 572</span>  <span class="keywordtype">int</span> targs[2] = {1,2};</div>
<div class="line"><a name="l00573"></a><span class="lineno"> 573</span>  <a class="code" href="structComplexMatrixN.html">ComplexMatrixN</a> matr = <a class="code" href="group__type.html#ga815103261fb22ea9690e1427571df00e">createComplexMatrixN</a>(2);</div>
<div class="line"><a name="l00574"></a><span class="lineno"> 574</span>  <a class="code" href="group__testutilities.html#ga7f83695bea7d0332a577bca017dbb03c">toComplexMatrixN</a>(<a class="code" href="group__testutilities.html#gaa2e8b958e0cba07e01de9f91a5ce3c9c">getRandomQMatrix</a>(1 << 2), matr);</div>
<div class="line"><a name="l00575"></a><span class="lineno"> 575</span>  </div>
<div class="line"><a name="l00576"></a><span class="lineno"> 576</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gab52b6315c5520b7d311b0458785eed8e">applyMultiControlledMatrixN</a>(quregVec, ctrls, 1, targs, 2, matr), Contains(<span class="stringliteral">"targets too many qubits"</span>));</div>
<div class="line"><a name="l00577"></a><span class="lineno"> 577</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l00578"></a><span class="lineno"> 578</span>  }</div>
<div class="line"><a name="l00579"></a><span class="lineno"> 579</span>  }</div>
<div class="line"><a name="l00580"></a><span class="lineno"> 580</span>  <a class="code" href="test__operators_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l00581"></a><span class="lineno"> 581</span> }</div>
<div class="line"><a name="l00582"></a><span class="lineno"> 582</span>  </div>
<div class="line"><a name="l00583"></a><span class="lineno"> 583</span>  </div>
<div class="line"><a name="l00584"></a><span class="lineno"> 584</span>  </div>
<div class="line"><a name="l00589"></a><span class="lineno"><a class="line" href="group__unittest.html#ga271aeb53a90bef51ccb1a21bae0f184c"> 589</a></span> <a class="code" href="group__unittest.html#gaff6822e79b947a9e3b791572c674c08c">TEST_CASE</a>( <span class="stringliteral">"applyMultiVarPhaseFunc"</span>, <span class="stringliteral">"[operators]"</span> ) {</div>
<div class="line"><a name="l00590"></a><span class="lineno"> 590</span>  </div>
<div class="line"><a name="l00591"></a><span class="lineno"> 591</span>  <a class="code" href="test__operators_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l00592"></a><span class="lineno"> 592</span>  </div>
<div class="line"><a name="l00593"></a><span class="lineno"> 593</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00594"></a><span class="lineno"> 594</span>  </div>
<div class="line"><a name="l00595"></a><span class="lineno"> 595</span>  <span class="comment">// try every kind of binary encodings</span></div>
<div class="line"><a name="l00596"></a><span class="lineno"> 596</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#ga9c91c41aa42ae537995e89ffc616afe1">bitEncoding</a> encoding = GENERATE( <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>,<a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a> );</div>
<div class="line"><a name="l00597"></a><span class="lineno"> 597</span>  </div>
<div class="line"><a name="l00598"></a><span class="lineno"> 598</span>  <span class="comment">// try every possible number of registers </span></div>
<div class="line"><a name="l00599"></a><span class="lineno"> 599</span>  <span class="comment">// (between #qubits containing 1, and 1 containing #qubits)</span></div>
<div class="line"><a name="l00600"></a><span class="lineno"> 600</span>  <span class="keywordtype">int</span> numRegs;</div>
<div class="line"><a name="l00601"></a><span class="lineno"> 601</span>  <span class="keywordtype">int</span> maxNumRegs = 0;</div>
<div class="line"><a name="l00602"></a><span class="lineno"> 602</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>)</div>
<div class="line"><a name="l00603"></a><span class="lineno"> 603</span>  maxNumRegs = <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>;</div>
<div class="line"><a name="l00604"></a><span class="lineno"> 604</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>)</div>
<div class="line"><a name="l00605"></a><span class="lineno"> 605</span>  maxNumRegs = <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>/2; <span class="comment">// floors</span></div>
<div class="line"><a name="l00606"></a><span class="lineno"> 606</span>  numRegs = GENERATE_COPY( range(1, maxNumRegs+1) );</div>
<div class="line"><a name="l00607"></a><span class="lineno"> 607</span>  </div>
<div class="line"><a name="l00608"></a><span class="lineno"> 608</span>  <span class="comment">// try every possible total number of involed qubits</span></div>
<div class="line"><a name="l00609"></a><span class="lineno"> 609</span>  <span class="keywordtype">int</span> totalNumQubits;</div>
<div class="line"><a name="l00610"></a><span class="lineno"> 610</span>  <span class="keywordtype">int</span> minTotalQubits = 0;</div>
<div class="line"><a name="l00611"></a><span class="lineno"> 611</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>)</div>
<div class="line"><a name="l00612"></a><span class="lineno"> 612</span>  <span class="comment">// each register must contain at least 1 qubit</span></div>
<div class="line"><a name="l00613"></a><span class="lineno"> 613</span>  minTotalQubits = numRegs;</div>
<div class="line"><a name="l00614"></a><span class="lineno"> 614</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>)</div>
<div class="line"><a name="l00615"></a><span class="lineno"> 615</span>  <span class="comment">// each register must contain at least 2 qubits</span></div>
<div class="line"><a name="l00616"></a><span class="lineno"> 616</span>  minTotalQubits = 2*numRegs;</div>
<div class="line"><a name="l00617"></a><span class="lineno"> 617</span>  totalNumQubits = GENERATE_COPY( range(minTotalQubits,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1) );</div>
<div class="line"><a name="l00618"></a><span class="lineno"> 618</span>  </div>
<div class="line"><a name="l00619"></a><span class="lineno"> 619</span>  <span class="comment">// try every qubits subset and ordering </span></div>
<div class="line"><a name="l00620"></a><span class="lineno"> 620</span>  <span class="keywordtype">int</span>* regs = GENERATE_COPY( <a class="code" href="group__testutilities.html#ga35add15146aa606b256df79334b867d5">sublists</a>(range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>), totalNumQubits) );</div>
<div class="line"><a name="l00621"></a><span class="lineno"> 621</span>  </div>
<div class="line"><a name="l00622"></a><span class="lineno"> 622</span>  <span class="comment">// assign each sub-reg its minimum length</span></div>
<div class="line"><a name="l00623"></a><span class="lineno"> 623</span>  <span class="keywordtype">int</span> unallocQubits = totalNumQubits;</div>
<div class="line"><a name="l00624"></a><span class="lineno"> 624</span>  <span class="keywordtype">int</span> numQubitsPerReg[numRegs];</div>
<div class="line"><a name="l00625"></a><span class="lineno"> 625</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numRegs; i++) </div>
<div class="line"><a name="l00626"></a><span class="lineno"> 626</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>) {</div>
<div class="line"><a name="l00627"></a><span class="lineno"> 627</span>  numQubitsPerReg[i] = 1;</div>
<div class="line"><a name="l00628"></a><span class="lineno"> 628</span>  unallocQubits -= 1;</div>
<div class="line"><a name="l00629"></a><span class="lineno"> 629</span>  }</div>
<div class="line"><a name="l00630"></a><span class="lineno"> 630</span>  <span class="keywordflow">else</span> <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>) {</div>
<div class="line"><a name="l00631"></a><span class="lineno"> 631</span>  numQubitsPerReg[i] = 2;</div>
<div class="line"><a name="l00632"></a><span class="lineno"> 632</span>  unallocQubits -= 2;</div>
<div class="line"><a name="l00633"></a><span class="lineno"> 633</span>  }</div>
<div class="line"><a name="l00634"></a><span class="lineno"> 634</span>  <span class="comment">// and randomly allocate the remaining qubits between the registers</span></div>
<div class="line"><a name="l00635"></a><span class="lineno"> 635</span>  <span class="keywordflow">while</span> (unallocQubits > 0) {</div>
<div class="line"><a name="l00636"></a><span class="lineno"> 636</span>  numQubitsPerReg[<a class="code" href="group__testutilities.html#ga7125d0747a44db58115899727ac5f6be">getRandomInt</a>(0,numRegs)] += 1;</div>
<div class="line"><a name="l00637"></a><span class="lineno"> 637</span>  unallocQubits--;</div>
<div class="line"><a name="l00638"></a><span class="lineno"> 638</span>  }</div>
<div class="line"><a name="l00639"></a><span class="lineno"> 639</span>  </div>
<div class="line"><a name="l00640"></a><span class="lineno"> 640</span>  </div>
<div class="line"><a name="l00641"></a><span class="lineno"> 641</span>  <span class="comment">// each register gets a random number of terms in the full phase function</span></div>
<div class="line"><a name="l00642"></a><span class="lineno"> 642</span>  <span class="keywordtype">int</span> numTermsPerReg[numRegs];</div>
<div class="line"><a name="l00643"></a><span class="lineno"> 643</span>  <span class="keywordtype">int</span> numTermsTotal = 0;</div>
<div class="line"><a name="l00644"></a><span class="lineno"> 644</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r++) {</div>
<div class="line"><a name="l00645"></a><span class="lineno"> 645</span>  <span class="keywordtype">int</span> numTerms = <a class="code" href="group__testutilities.html#ga7125d0747a44db58115899727ac5f6be">getRandomInt</a>(1,5);</div>
<div class="line"><a name="l00646"></a><span class="lineno"> 646</span>  numTermsPerReg[r] = numTerms;</div>
<div class="line"><a name="l00647"></a><span class="lineno"> 647</span>  numTermsTotal += numTerms;</div>
<div class="line"><a name="l00648"></a><span class="lineno"> 648</span>  }</div>
<div class="line"><a name="l00649"></a><span class="lineno"> 649</span>  </div>
<div class="line"><a name="l00650"></a><span class="lineno"> 650</span>  <span class="comment">// populate the multi-var phase function with random but POSITIVE-power terms,</span></div>
<div class="line"><a name="l00651"></a><span class="lineno"> 651</span>  <span class="comment">// which must further be integers in two's complement</span></div>
<div class="line"><a name="l00652"></a><span class="lineno"> 652</span>  <span class="keywordtype">int</span> flatInd = 0;</div>
<div class="line"><a name="l00653"></a><span class="lineno"> 653</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeffs[numTermsTotal];</div>
<div class="line"><a name="l00654"></a><span class="lineno"> 654</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> expons[numTermsTotal];</div>
<div class="line"><a name="l00655"></a><span class="lineno"> 655</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r++) {</div>
<div class="line"><a name="l00656"></a><span class="lineno"> 656</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> t=0; t<numTermsPerReg[r]; t++) {</div>
<div class="line"><a name="l00657"></a><span class="lineno"> 657</span>  coeffs[flatInd] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-10,10);</div>
<div class="line"><a name="l00658"></a><span class="lineno"> 658</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>)</div>
<div class="line"><a name="l00659"></a><span class="lineno"> 659</span>  expons[flatInd] = <a class="code" href="group__testutilities.html#ga7125d0747a44db58115899727ac5f6be">getRandomInt</a>(0, 3+1);</div>
<div class="line"><a name="l00660"></a><span class="lineno"> 660</span>  <span class="keywordflow">else</span> <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>)</div>
<div class="line"><a name="l00661"></a><span class="lineno"> 661</span>  expons[flatInd] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(0, 3);</div>
<div class="line"><a name="l00662"></a><span class="lineno"> 662</span>  </div>
<div class="line"><a name="l00663"></a><span class="lineno"> 663</span>  flatInd++;</div>
<div class="line"><a name="l00664"></a><span class="lineno"> 664</span>  }</div>
<div class="line"><a name="l00665"></a><span class="lineno"> 665</span>  }</div>
<div class="line"><a name="l00666"></a><span class="lineno"> 666</span>  </div>
<div class="line"><a name="l00667"></a><span class="lineno"> 667</span>  <span class="comment">/* To perform this calculation more distinctly from the QuEST </span></div>
<div class="line"><a name="l00668"></a><span class="lineno"> 668</span> <span class="comment"> * core method, we can exploit that </span></div>
<div class="line"><a name="l00669"></a><span class="lineno"> 669</span> <span class="comment"> * exp(i (f1[x1] + f2[x2]))|x2>|x1> = exp(i f2[x2])|x2> (x) exp(i f1[x1])|x1> </span></div>
<div class="line"><a name="l00670"></a><span class="lineno"> 670</span> <span class="comment"> * and so compute a separate diagonal matrix for each sub-register with </span></div>
<div class="line"><a name="l00671"></a><span class="lineno"> 671</span> <span class="comment"> * phases determined only by its own variable, and Kronecker multiply </span></div>
<div class="line"><a name="l00672"></a><span class="lineno"> 672</span> <span class="comment"> * them together. The target qubits of the Kronecker product is then </span></div>
<div class="line"><a name="l00673"></a><span class="lineno"> 673</span> <span class="comment"> * just the full register, stored in *regs. </span></div>
<div class="line"><a name="l00674"></a><span class="lineno"> 674</span> <span class="comment"> */</span></div>
<div class="line"><a name="l00675"></a><span class="lineno"> 675</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> allRegMatr{{1}};</div>
<div class="line"><a name="l00676"></a><span class="lineno"> 676</span>  <span class="keywordtype">int</span> startInd = 0;</div>
<div class="line"><a name="l00677"></a><span class="lineno"> 677</span>  </div>
<div class="line"><a name="l00678"></a><span class="lineno"> 678</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r++) {</div>
<div class="line"><a name="l00679"></a><span class="lineno"> 679</span>  </div>
<div class="line"><a name="l00680"></a><span class="lineno"> 680</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> singleRegMatr = <a class="code" href="group__testutilities.html#ga6ccbb15b0f234e926be96a153181b63a">getZeroMatrix</a>( 1 << numQubitsPerReg[r] );</div>
<div class="line"><a name="l00681"></a><span class="lineno"> 681</span>  </div>
<div class="line"><a name="l00682"></a><span class="lineno"> 682</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<singleRegMatr.size(); i++) {</div>
<div class="line"><a name="l00683"></a><span class="lineno"> 683</span>  </div>
<div class="line"><a name="l00684"></a><span class="lineno"> 684</span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <span class="keywordtype">int</span> ind = 0;</div>
<div class="line"><a name="l00685"></a><span class="lineno"> 685</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>)</div>
<div class="line"><a name="l00686"></a><span class="lineno"> 686</span>  ind = i;</div>
<div class="line"><a name="l00687"></a><span class="lineno"> 687</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>)</div>
<div class="line"><a name="l00688"></a><span class="lineno"> 688</span>  ind = <a class="code" href="group__testutilities.html#ga49be3b32f7b7a274fc5ecb209fde1189">getTwosComplement</a>(i, numQubitsPerReg[r]);</div>
<div class="line"><a name="l00689"></a><span class="lineno"> 689</span>  </div>
<div class="line"><a name="l00690"></a><span class="lineno"> 690</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> phase = 0;</div>
<div class="line"><a name="l00691"></a><span class="lineno"> 691</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> t=0; t<numTermsPerReg[r]; t++)</div>
<div class="line"><a name="l00692"></a><span class="lineno"> 692</span>  phase += coeffs[t+startInd] * pow(ind, expons[t+startInd]);</div>
<div class="line"><a name="l00693"></a><span class="lineno"> 693</span>  </div>
<div class="line"><a name="l00694"></a><span class="lineno"> 694</span>  singleRegMatr[i][i] = <a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(phase);</div>
<div class="line"><a name="l00695"></a><span class="lineno"> 695</span>  } </div>
<div class="line"><a name="l00696"></a><span class="lineno"> 696</span>  allRegMatr = <a class="code" href="group__testutilities.html#gab5ac6842ba67b8d38bd17385ab179b67">getKroneckerProduct</a>(singleRegMatr, allRegMatr);</div>
<div class="line"><a name="l00697"></a><span class="lineno"> 697</span>  startInd += numTermsPerReg[r];</div>
<div class="line"><a name="l00698"></a><span class="lineno"> 698</span>  }</div>
<div class="line"><a name="l00699"></a><span class="lineno"> 699</span>  </div>
<div class="line"><a name="l00700"></a><span class="lineno"> 700</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00701"></a><span class="lineno"> 701</span>  </div>
<div class="line"><a name="l00702"></a><span class="lineno"> 702</span>  <a class="code" href="group__operator.html#ga008a46d178a5a9691e2f5d363e3f518f">applyMultiVarPhaseFunc</a>(quregVec, regs, numQubitsPerReg, numRegs, encoding, coeffs, expons, numTermsPerReg);</div>
<div class="line"><a name="l00703"></a><span class="lineno"> 703</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, regs, totalNumQubits, allRegMatr);</div>
<div class="line"><a name="l00704"></a><span class="lineno"> 704</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec, 1E4*REAL_EPS) );</div>
<div class="line"><a name="l00705"></a><span class="lineno"> 705</span>  }</div>
<div class="line"><a name="l00706"></a><span class="lineno"> 706</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00707"></a><span class="lineno"> 707</span>  </div>
<div class="line"><a name="l00708"></a><span class="lineno"> 708</span>  <a class="code" href="group__operator.html#ga008a46d178a5a9691e2f5d363e3f518f">applyMultiVarPhaseFunc</a>(quregMatr, regs, numQubitsPerReg, numRegs, encoding, coeffs, expons, numTermsPerReg);</div>
<div class="line"><a name="l00709"></a><span class="lineno"> 709</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, regs, totalNumQubits, allRegMatr);</div>
<div class="line"><a name="l00710"></a><span class="lineno"> 710</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 1E6*REAL_EPS) );</div>
<div class="line"><a name="l00711"></a><span class="lineno"> 711</span>  }</div>
<div class="line"><a name="l00712"></a><span class="lineno"> 712</span>  }</div>
<div class="line"><a name="l00713"></a><span class="lineno"> 713</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00714"></a><span class="lineno"> 714</span>  </div>
<div class="line"><a name="l00715"></a><span class="lineno"> 715</span>  <span class="keywordtype">int</span> numRegs = 2;</div>
<div class="line"><a name="l00716"></a><span class="lineno"> 716</span>  <span class="keywordtype">int</span> numQubitsPerReg[] = {2,3};</div>
<div class="line"><a name="l00717"></a><span class="lineno"> 717</span>  <span class="keywordtype">int</span> qubits[] = {0,1,2,3,4};</div>
<div class="line"><a name="l00718"></a><span class="lineno"> 718</span>  </div>
<div class="line"><a name="l00719"></a><span class="lineno"> 719</span>  SECTION( <span class="stringliteral">"number of registers"</span> ) {</div>
<div class="line"><a name="l00720"></a><span class="lineno"> 720</span>  </div>
<div class="line"><a name="l00721"></a><span class="lineno"> 721</span>  numRegs = GENERATE_COPY( -1, 0, 1+<a class="code" href="QuEST__precision_8h.html#a6698ce2a3971003a0a0289e5980d39c5">MAX_NUM_REGS_APPLY_ARBITRARY_PHASE</a> );</div>
<div class="line"><a name="l00722"></a><span class="lineno"> 722</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga008a46d178a5a9691e2f5d363e3f518f">applyMultiVarPhaseFunc</a>(quregVec, qubits, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, NULL, NULL, NULL), Contains(<span class="stringliteral">"Invalid number of qubit subregisters"</span>) );</div>
<div class="line"><a name="l00723"></a><span class="lineno"> 723</span>  }</div>
<div class="line"><a name="l00724"></a><span class="lineno"> 724</span>  SECTION( <span class="stringliteral">"number of qubits"</span> ) {</div>
<div class="line"><a name="l00725"></a><span class="lineno"> 725</span>  </div>
<div class="line"><a name="l00726"></a><span class="lineno"> 726</span>  numQubitsPerReg[GENERATE_COPY(range(0,numRegs))] = GENERATE( -1, 0, 1+<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l00727"></a><span class="lineno"> 727</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga008a46d178a5a9691e2f5d363e3f518f">applyMultiVarPhaseFunc</a>(quregVec, qubits, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, NULL, NULL, NULL), Contains(<span class="stringliteral">"Invalid number of qubits"</span>) );</div>
<div class="line"><a name="l00728"></a><span class="lineno"> 728</span>  }</div>
<div class="line"><a name="l00729"></a><span class="lineno"> 729</span>  SECTION( <span class="stringliteral">"repetition of qubits"</span> ) {</div>
<div class="line"><a name="l00730"></a><span class="lineno"> 730</span>  </div>
<div class="line"><a name="l00731"></a><span class="lineno"> 731</span>  qubits[GENERATE(2,3,4)] = qubits[1];</div>
<div class="line"><a name="l00732"></a><span class="lineno"> 732</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga008a46d178a5a9691e2f5d363e3f518f">applyMultiVarPhaseFunc</a>(quregVec, qubits, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, NULL, NULL, NULL), Contains(<span class="stringliteral">"The qubits must be unique"</span>) );</div>
<div class="line"><a name="l00733"></a><span class="lineno"> 733</span>  }</div>
<div class="line"><a name="l00734"></a><span class="lineno"> 734</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l00735"></a><span class="lineno"> 735</span>  </div>
<div class="line"><a name="l00736"></a><span class="lineno"> 736</span>  qubits[GENERATE(range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>))] = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l00737"></a><span class="lineno"> 737</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga008a46d178a5a9691e2f5d363e3f518f">applyMultiVarPhaseFunc</a>(quregVec, qubits, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, NULL, NULL, NULL), Contains(<span class="stringliteral">"Invalid qubit index"</span>) );</div>
<div class="line"><a name="l00738"></a><span class="lineno"> 738</span>  }</div>
<div class="line"><a name="l00739"></a><span class="lineno"> 739</span>  SECTION( <span class="stringliteral">"number of terms"</span> ) {</div>
<div class="line"><a name="l00740"></a><span class="lineno"> 740</span>  </div>
<div class="line"><a name="l00741"></a><span class="lineno"> 741</span>  <span class="keywordtype">int</span> numTermsPerReg[] = {3, 3};</div>
<div class="line"><a name="l00742"></a><span class="lineno"> 742</span>  </div>
<div class="line"><a name="l00743"></a><span class="lineno"> 743</span>  numTermsPerReg[GENERATE_COPY(range(0,numRegs))] = GENERATE( -1, 0 );</div>
<div class="line"><a name="l00744"></a><span class="lineno"> 744</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga008a46d178a5a9691e2f5d363e3f518f">applyMultiVarPhaseFunc</a>(quregVec, qubits, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, NULL, NULL, numTermsPerReg), Contains(<span class="stringliteral">"Invalid number of terms in the phase function"</span>) );</div>
<div class="line"><a name="l00745"></a><span class="lineno"> 745</span>  }</div>
<div class="line"><a name="l00746"></a><span class="lineno"> 746</span>  SECTION( <span class="stringliteral">"bit encoding name"</span> ) {</div>
<div class="line"><a name="l00747"></a><span class="lineno"> 747</span>  </div>
<div class="line"><a name="l00748"></a><span class="lineno"> 748</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#ga9c91c41aa42ae537995e89ffc616afe1">bitEncoding</a> enc = (<span class="keyword">enum</span> <a class="code" href="group__type.html#ga9c91c41aa42ae537995e89ffc616afe1">bitEncoding</a>) GENERATE( -1, 2 );</div>
<div class="line"><a name="l00749"></a><span class="lineno"> 749</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga008a46d178a5a9691e2f5d363e3f518f">applyMultiVarPhaseFunc</a>(quregVec, qubits, numQubitsPerReg, numRegs, enc, NULL, NULL, NULL), Contains(<span class="stringliteral">"Invalid bit encoding"</span>) );</div>
<div class="line"><a name="l00750"></a><span class="lineno"> 750</span>  }</div>
<div class="line"><a name="l00751"></a><span class="lineno"> 751</span>  SECTION( <span class="stringliteral">"two's complement register"</span> ) {</div>
<div class="line"><a name="l00752"></a><span class="lineno"> 752</span>  </div>
<div class="line"><a name="l00753"></a><span class="lineno"> 753</span>  numQubitsPerReg[GENERATE_COPY(range(0,numRegs))] = 1;</div>
<div class="line"><a name="l00754"></a><span class="lineno"> 754</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga008a46d178a5a9691e2f5d363e3f518f">applyMultiVarPhaseFunc</a>(quregVec, qubits, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>, NULL, NULL, NULL), Contains(<span class="stringliteral">"A sub-register contained too few qubits to employ TWOS_COMPLEMENT encoding"</span>) );</div>
<div class="line"><a name="l00755"></a><span class="lineno"> 755</span>  }</div>
<div class="line"><a name="l00756"></a><span class="lineno"> 756</span>  SECTION( <span class="stringliteral">"fractional exponent"</span> ) {</div>
<div class="line"><a name="l00757"></a><span class="lineno"> 757</span>  </div>
<div class="line"><a name="l00758"></a><span class="lineno"> 758</span>  <span class="keywordtype">int</span> numTermsPerReg[] = {3, 3};</div>
<div class="line"><a name="l00759"></a><span class="lineno"> 759</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeffs[] = {0,0,0, 0,0,0};</div>
<div class="line"><a name="l00760"></a><span class="lineno"> 760</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> expos[] = {1,2,3, 1,2,3};</div>
<div class="line"><a name="l00761"></a><span class="lineno"> 761</span>  </div>
<div class="line"><a name="l00762"></a><span class="lineno"> 762</span>  expos[GENERATE(range(0,6))] = GENERATE( 0.5, 1.999, 5.0001 );</div>
<div class="line"><a name="l00763"></a><span class="lineno"> 763</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga008a46d178a5a9691e2f5d363e3f518f">applyMultiVarPhaseFunc</a>(quregVec, qubits, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>, coeffs, expos, numTermsPerReg), Contains(<span class="stringliteral">"The phase function contained a fractional exponent, which is illegal in TWOS_COMPLEMENT"</span>) );</div>
<div class="line"><a name="l00764"></a><span class="lineno"> 764</span>  </div>
<div class="line"><a name="l00765"></a><span class="lineno"> 765</span>  <span class="comment">// ensure fractional exponents are valid in unsigned mode however</span></div>
<div class="line"><a name="l00766"></a><span class="lineno"> 766</span>  REQUIRE_NOTHROW( <a class="code" href="group__operator.html#ga008a46d178a5a9691e2f5d363e3f518f">applyMultiVarPhaseFunc</a>(quregVec, qubits, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, coeffs, expos, numTermsPerReg) );</div>
<div class="line"><a name="l00767"></a><span class="lineno"> 767</span>  </div>
<div class="line"><a name="l00768"></a><span class="lineno"> 768</span>  }</div>
<div class="line"><a name="l00769"></a><span class="lineno"> 769</span>  SECTION( <span class="stringliteral">"negative exponent"</span> ) {</div>
<div class="line"><a name="l00770"></a><span class="lineno"> 770</span>  </div>
<div class="line"><a name="l00771"></a><span class="lineno"> 771</span>  <span class="keywordtype">int</span> numTermsPerReg[] = {3, 3};</div>
<div class="line"><a name="l00772"></a><span class="lineno"> 772</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeffs[] = {0,0,0, 0,0,0};</div>
<div class="line"><a name="l00773"></a><span class="lineno"> 773</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> expos[] = {1,2,3, 1,2,3};</div>
<div class="line"><a name="l00774"></a><span class="lineno"> 774</span>  </div>
<div class="line"><a name="l00775"></a><span class="lineno"> 775</span>  expos[GENERATE(range(0,6))] = GENERATE( -1, -2, -2.5 );</div>
<div class="line"><a name="l00776"></a><span class="lineno"> 776</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#ga9c91c41aa42ae537995e89ffc616afe1">bitEncoding</a> enc = GENERATE( <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a> );</div>
<div class="line"><a name="l00777"></a><span class="lineno"> 777</span>  </div>
<div class="line"><a name="l00778"></a><span class="lineno"> 778</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga008a46d178a5a9691e2f5d363e3f518f">applyMultiVarPhaseFunc</a>(quregVec, qubits, numQubitsPerReg, numRegs, enc, coeffs, expos, numTermsPerReg), Contains(<span class="stringliteral">"The phase function contained an illegal negative exponent"</span>) );</div>
<div class="line"><a name="l00779"></a><span class="lineno"> 779</span>  }</div>
<div class="line"><a name="l00780"></a><span class="lineno"> 780</span>  }</div>
<div class="line"><a name="l00781"></a><span class="lineno"> 781</span>  <a class="code" href="test__operators_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l00782"></a><span class="lineno"> 782</span> }</div>
<div class="line"><a name="l00783"></a><span class="lineno"> 783</span>  </div>
<div class="line"><a name="l00784"></a><span class="lineno"> 784</span>  </div>
<div class="line"><a name="l00785"></a><span class="lineno"> 785</span>  </div>
<div class="line"><a name="l00790"></a><span class="lineno"><a class="line" href="group__unittest.html#gad82918a41dcee2da7a0cc8e6aebd542d"> 790</a></span> <a class="code" href="group__unittest.html#gaff6822e79b947a9e3b791572c674c08c">TEST_CASE</a>( <span class="stringliteral">"applyMultiVarPhaseFuncOverrides"</span>, <span class="stringliteral">"[operators]"</span> ) {</div>
<div class="line"><a name="l00791"></a><span class="lineno"> 791</span>  </div>
<div class="line"><a name="l00792"></a><span class="lineno"> 792</span>  <a class="code" href="test__operators_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l00793"></a><span class="lineno"> 793</span>  </div>
<div class="line"><a name="l00794"></a><span class="lineno"> 794</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00795"></a><span class="lineno"> 795</span>  </div>
<div class="line"><a name="l00796"></a><span class="lineno"> 796</span>  <span class="comment">// try every kind of binary encodings</span></div>
<div class="line"><a name="l00797"></a><span class="lineno"> 797</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#ga9c91c41aa42ae537995e89ffc616afe1">bitEncoding</a> encoding = GENERATE( <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>,<a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a> );</div>
<div class="line"><a name="l00798"></a><span class="lineno"> 798</span>  </div>
<div class="line"><a name="l00799"></a><span class="lineno"> 799</span>  <span class="comment">// try every possible number of registers </span></div>
<div class="line"><a name="l00800"></a><span class="lineno"> 800</span>  <span class="comment">// (between #qubits containing 1, and 1 containing #qubits)</span></div>
<div class="line"><a name="l00801"></a><span class="lineno"> 801</span>  <span class="keywordtype">int</span> numRegs;</div>
<div class="line"><a name="l00802"></a><span class="lineno"> 802</span>  <span class="keywordtype">int</span> maxNumRegs = 0;</div>
<div class="line"><a name="l00803"></a><span class="lineno"> 803</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>)</div>
<div class="line"><a name="l00804"></a><span class="lineno"> 804</span>  maxNumRegs = <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>;</div>
<div class="line"><a name="l00805"></a><span class="lineno"> 805</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>)</div>
<div class="line"><a name="l00806"></a><span class="lineno"> 806</span>  maxNumRegs = <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>/2; <span class="comment">// floors</span></div>
<div class="line"><a name="l00807"></a><span class="lineno"> 807</span>  numRegs = GENERATE_COPY( range(1, maxNumRegs+1) );</div>
<div class="line"><a name="l00808"></a><span class="lineno"> 808</span>  </div>
<div class="line"><a name="l00809"></a><span class="lineno"> 809</span>  <span class="comment">// try every possible total number of involed qubits</span></div>
<div class="line"><a name="l00810"></a><span class="lineno"> 810</span>  <span class="keywordtype">int</span> totalNumQubits;</div>
<div class="line"><a name="l00811"></a><span class="lineno"> 811</span>  <span class="keywordtype">int</span> minTotalQubits = 0;</div>
<div class="line"><a name="l00812"></a><span class="lineno"> 812</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>)</div>
<div class="line"><a name="l00813"></a><span class="lineno"> 813</span>  <span class="comment">// each register must contain at least 1 qubit</span></div>
<div class="line"><a name="l00814"></a><span class="lineno"> 814</span>  minTotalQubits = numRegs;</div>
<div class="line"><a name="l00815"></a><span class="lineno"> 815</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>)</div>
<div class="line"><a name="l00816"></a><span class="lineno"> 816</span>  <span class="comment">// each register must contain at least 2 qubits</span></div>
<div class="line"><a name="l00817"></a><span class="lineno"> 817</span>  minTotalQubits = 2*numRegs;</div>
<div class="line"><a name="l00818"></a><span class="lineno"> 818</span>  totalNumQubits = GENERATE_COPY( range(minTotalQubits,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1) );</div>
<div class="line"><a name="l00819"></a><span class="lineno"> 819</span>  </div>
<div class="line"><a name="l00820"></a><span class="lineno"> 820</span>  <span class="comment">// try every qubits subset and ordering </span></div>
<div class="line"><a name="l00821"></a><span class="lineno"> 821</span>  <span class="keywordtype">int</span>* regs = GENERATE_COPY( <a class="code" href="group__testutilities.html#ga35add15146aa606b256df79334b867d5">sublists</a>(range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>), totalNumQubits) );</div>
<div class="line"><a name="l00822"></a><span class="lineno"> 822</span>  </div>
<div class="line"><a name="l00823"></a><span class="lineno"> 823</span>  <span class="comment">// assign each sub-reg its minimum length</span></div>
<div class="line"><a name="l00824"></a><span class="lineno"> 824</span>  <span class="keywordtype">int</span> unallocQubits = totalNumQubits;</div>
<div class="line"><a name="l00825"></a><span class="lineno"> 825</span>  <span class="keywordtype">int</span> numQubitsPerReg[numRegs];</div>
<div class="line"><a name="l00826"></a><span class="lineno"> 826</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numRegs; i++) </div>
<div class="line"><a name="l00827"></a><span class="lineno"> 827</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>) {</div>
<div class="line"><a name="l00828"></a><span class="lineno"> 828</span>  numQubitsPerReg[i] = 1;</div>
<div class="line"><a name="l00829"></a><span class="lineno"> 829</span>  unallocQubits -= 1;</div>
<div class="line"><a name="l00830"></a><span class="lineno"> 830</span>  }</div>
<div class="line"><a name="l00831"></a><span class="lineno"> 831</span>  <span class="keywordflow">else</span> <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>) {</div>
<div class="line"><a name="l00832"></a><span class="lineno"> 832</span>  numQubitsPerReg[i] = 2;</div>
<div class="line"><a name="l00833"></a><span class="lineno"> 833</span>  unallocQubits -= 2;</div>
<div class="line"><a name="l00834"></a><span class="lineno"> 834</span>  }</div>
<div class="line"><a name="l00835"></a><span class="lineno"> 835</span>  <span class="comment">// and randomly allocate the remaining qubits between the registers</span></div>
<div class="line"><a name="l00836"></a><span class="lineno"> 836</span>  <span class="keywordflow">while</span> (unallocQubits > 0) {</div>
<div class="line"><a name="l00837"></a><span class="lineno"> 837</span>  numQubitsPerReg[<a class="code" href="group__testutilities.html#ga7125d0747a44db58115899727ac5f6be">getRandomInt</a>(0,numRegs)] += 1;</div>
<div class="line"><a name="l00838"></a><span class="lineno"> 838</span>  unallocQubits--;</div>
<div class="line"><a name="l00839"></a><span class="lineno"> 839</span>  }</div>
<div class="line"><a name="l00840"></a><span class="lineno"> 840</span>  </div>
<div class="line"><a name="l00841"></a><span class="lineno"> 841</span>  </div>
<div class="line"><a name="l00842"></a><span class="lineno"> 842</span>  <span class="comment">// each register gets a random number of terms in the full phase function</span></div>
<div class="line"><a name="l00843"></a><span class="lineno"> 843</span>  <span class="keywordtype">int</span> numTermsPerReg[numRegs];</div>
<div class="line"><a name="l00844"></a><span class="lineno"> 844</span>  <span class="keywordtype">int</span> numTermsTotal = 0;</div>
<div class="line"><a name="l00845"></a><span class="lineno"> 845</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r++) {</div>
<div class="line"><a name="l00846"></a><span class="lineno"> 846</span>  <span class="keywordtype">int</span> numTerms = <a class="code" href="group__testutilities.html#ga7125d0747a44db58115899727ac5f6be">getRandomInt</a>(1,5);</div>
<div class="line"><a name="l00847"></a><span class="lineno"> 847</span>  numTermsPerReg[r] = numTerms;</div>
<div class="line"><a name="l00848"></a><span class="lineno"> 848</span>  numTermsTotal += numTerms;</div>
<div class="line"><a name="l00849"></a><span class="lineno"> 849</span>  }</div>
<div class="line"><a name="l00850"></a><span class="lineno"> 850</span>  </div>
<div class="line"><a name="l00851"></a><span class="lineno"> 851</span>  <span class="comment">// populate the multi-var phase function with random but POSITIVE-power terms,</span></div>
<div class="line"><a name="l00852"></a><span class="lineno"> 852</span>  <span class="comment">// which must further be integers in two's complement</span></div>
<div class="line"><a name="l00853"></a><span class="lineno"> 853</span>  <span class="keywordtype">int</span> flatInd = 0;</div>
<div class="line"><a name="l00854"></a><span class="lineno"> 854</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeffs[numTermsTotal];</div>
<div class="line"><a name="l00855"></a><span class="lineno"> 855</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> expons[numTermsTotal];</div>
<div class="line"><a name="l00856"></a><span class="lineno"> 856</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r++) {</div>
<div class="line"><a name="l00857"></a><span class="lineno"> 857</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> t=0; t<numTermsPerReg[r]; t++) {</div>
<div class="line"><a name="l00858"></a><span class="lineno"> 858</span>  coeffs[flatInd] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-10,10);</div>
<div class="line"><a name="l00859"></a><span class="lineno"> 859</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>)</div>
<div class="line"><a name="l00860"></a><span class="lineno"> 860</span>  expons[flatInd] = <a class="code" href="group__testutilities.html#ga7125d0747a44db58115899727ac5f6be">getRandomInt</a>(0, 3+1);</div>
<div class="line"><a name="l00861"></a><span class="lineno"> 861</span>  <span class="keywordflow">else</span> <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>)</div>
<div class="line"><a name="l00862"></a><span class="lineno"> 862</span>  expons[flatInd] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(0, 3);</div>
<div class="line"><a name="l00863"></a><span class="lineno"> 863</span>  </div>
<div class="line"><a name="l00864"></a><span class="lineno"> 864</span>  flatInd++;</div>
<div class="line"><a name="l00865"></a><span class="lineno"> 865</span>  }</div>
<div class="line"><a name="l00866"></a><span class="lineno"> 866</span>  }</div>
<div class="line"><a name="l00867"></a><span class="lineno"> 867</span>  </div>
<div class="line"><a name="l00868"></a><span class="lineno"> 868</span>  </div>
<div class="line"><a name="l00869"></a><span class="lineno"> 869</span>  <span class="comment">// choose a random number of overrides (even overriding every amplitude)</span></div>
<div class="line"><a name="l00870"></a><span class="lineno"> 870</span>  <span class="keywordtype">int</span> numOverrides = <a class="code" href="group__testutilities.html#ga7125d0747a44db58115899727ac5f6be">getRandomInt</a>(0, (1<<totalNumQubits) + 1);</div>
<div class="line"><a name="l00871"></a><span class="lineno"> 871</span>  </div>
<div class="line"><a name="l00872"></a><span class="lineno"> 872</span>  <span class="comment">// randomise each override index (uniqueness isn't checked)</span></div>
<div class="line"><a name="l00873"></a><span class="lineno"> 873</span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <span class="keywordtype">int</span> overrideInds[numOverrides*numRegs];</div>
<div class="line"><a name="l00874"></a><span class="lineno"> 874</span>  flatInd = 0;</div>
<div class="line"><a name="l00875"></a><span class="lineno"> 875</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> v=0; v<numOverrides; v++) {</div>
<div class="line"><a name="l00876"></a><span class="lineno"> 876</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r++) {</div>
<div class="line"><a name="l00877"></a><span class="lineno"> 877</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>)</div>
<div class="line"><a name="l00878"></a><span class="lineno"> 878</span>  overrideInds[flatInd] = <a class="code" href="group__testutilities.html#ga7125d0747a44db58115899727ac5f6be">getRandomInt</a>(0, 1<<numQubitsPerReg[r]);</div>
<div class="line"><a name="l00879"></a><span class="lineno"> 879</span>  <span class="keywordflow">else</span> <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>) </div>
<div class="line"><a name="l00880"></a><span class="lineno"> 880</span>  overrideInds[flatInd] = <a class="code" href="group__testutilities.html#ga7125d0747a44db58115899727ac5f6be">getRandomInt</a>(-(1<<(numQubitsPerReg[r]-1)), (1<<(numQubitsPerReg[r]-1))-1);</div>
<div class="line"><a name="l00881"></a><span class="lineno"> 881</span>  flatInd++;</div>
<div class="line"><a name="l00882"></a><span class="lineno"> 882</span>  }</div>
<div class="line"><a name="l00883"></a><span class="lineno"> 883</span>  }</div>
<div class="line"><a name="l00884"></a><span class="lineno"> 884</span>  </div>
<div class="line"><a name="l00885"></a><span class="lineno"> 885</span>  <span class="comment">// override to a random phase</span></div>
<div class="line"><a name="l00886"></a><span class="lineno"> 886</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> overridePhases[numOverrides];</div>
<div class="line"><a name="l00887"></a><span class="lineno"> 887</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> v=0; v<numOverrides; v++)</div>
<div class="line"><a name="l00888"></a><span class="lineno"> 888</span>  overridePhases[v] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-4, 4); <span class="comment">// periodic in [-pi, pi]</span></div>
<div class="line"><a name="l00889"></a><span class="lineno"> 889</span>  </div>
<div class="line"><a name="l00890"></a><span class="lineno"> 890</span>  <span class="comment">/* To perform this calculation more distinctly from the QuEST </span></div>
<div class="line"><a name="l00891"></a><span class="lineno"> 891</span> <span class="comment"> * core method, we can exploit that </span></div>
<div class="line"><a name="l00892"></a><span class="lineno"> 892</span> <span class="comment"> * exp(i (f1[x1] + f2[x2]))|x2>|x1> = exp(i f2[x2])|x2> (x) exp(i f1[x1])|x1> </span></div>
<div class="line"><a name="l00893"></a><span class="lineno"> 893</span> <span class="comment"> * and so compute a separate diagonal matrix for each sub-register with </span></div>
<div class="line"><a name="l00894"></a><span class="lineno"> 894</span> <span class="comment"> * phases determined only by its own variable, and Kronecker multiply </span></div>
<div class="line"><a name="l00895"></a><span class="lineno"> 895</span> <span class="comment"> * them together. The target qubits of the Kronecker product is then </span></div>
<div class="line"><a name="l00896"></a><span class="lineno"> 896</span> <span class="comment"> * just the full register, stored in *regs. We do this, then iterate </span></div>
<div class="line"><a name="l00897"></a><span class="lineno"> 897</span> <span class="comment"> * the list of overrides directly to overwrite the ultimate diagonal </span></div>
<div class="line"><a name="l00898"></a><span class="lineno"> 898</span> <span class="comment"> * entries</span></div>
<div class="line"><a name="l00899"></a><span class="lineno"> 899</span> <span class="comment"> */</span></div>
<div class="line"><a name="l00900"></a><span class="lineno"> 900</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> allRegMatr{{1}};</div>
<div class="line"><a name="l00901"></a><span class="lineno"> 901</span>  <span class="keywordtype">int</span> startInd = 0;</div>
<div class="line"><a name="l00902"></a><span class="lineno"> 902</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r++) {</div>
<div class="line"><a name="l00903"></a><span class="lineno"> 903</span>  </div>
<div class="line"><a name="l00904"></a><span class="lineno"> 904</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> singleRegMatr = <a class="code" href="group__testutilities.html#ga6ccbb15b0f234e926be96a153181b63a">getZeroMatrix</a>( 1 << numQubitsPerReg[r] );</div>
<div class="line"><a name="l00905"></a><span class="lineno"> 905</span>  </div>
<div class="line"><a name="l00906"></a><span class="lineno"> 906</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<singleRegMatr.size(); i++) {</div>
<div class="line"><a name="l00907"></a><span class="lineno"> 907</span>  </div>
<div class="line"><a name="l00908"></a><span class="lineno"> 908</span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <span class="keywordtype">int</span> ind = 0;</div>
<div class="line"><a name="l00909"></a><span class="lineno"> 909</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>)</div>
<div class="line"><a name="l00910"></a><span class="lineno"> 910</span>  ind = i;</div>
<div class="line"><a name="l00911"></a><span class="lineno"> 911</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>)</div>
<div class="line"><a name="l00912"></a><span class="lineno"> 912</span>  ind = <a class="code" href="group__testutilities.html#ga49be3b32f7b7a274fc5ecb209fde1189">getTwosComplement</a>(i, numQubitsPerReg[r]);</div>
<div class="line"><a name="l00913"></a><span class="lineno"> 913</span>  </div>
<div class="line"><a name="l00914"></a><span class="lineno"> 914</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> phase = 0;</div>
<div class="line"><a name="l00915"></a><span class="lineno"> 915</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> t=0; t<numTermsPerReg[r]; t++)</div>
<div class="line"><a name="l00916"></a><span class="lineno"> 916</span>  phase += coeffs[t+startInd] * pow(ind, expons[t+startInd]);</div>
<div class="line"><a name="l00917"></a><span class="lineno"> 917</span>  </div>
<div class="line"><a name="l00918"></a><span class="lineno"> 918</span>  singleRegMatr[i][i] = <a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(phase);</div>
<div class="line"><a name="l00919"></a><span class="lineno"> 919</span>  }</div>
<div class="line"><a name="l00920"></a><span class="lineno"> 920</span>  allRegMatr = <a class="code" href="group__testutilities.html#gab5ac6842ba67b8d38bd17385ab179b67">getKroneckerProduct</a>(singleRegMatr, allRegMatr);</div>
<div class="line"><a name="l00921"></a><span class="lineno"> 921</span>  startInd += numTermsPerReg[r];</div>
<div class="line"><a name="l00922"></a><span class="lineno"> 922</span>  } </div>
<div class="line"><a name="l00923"></a><span class="lineno"> 923</span>  <a class="code" href="group__testutilities.html#gaf57b4b82c98e98918f74476741f60e37">setDiagMatrixOverrides</a>(allRegMatr, numQubitsPerReg, numRegs, encoding, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l00924"></a><span class="lineno"> 924</span>  </div>
<div class="line"><a name="l00925"></a><span class="lineno"> 925</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00926"></a><span class="lineno"> 926</span>  </div>
<div class="line"><a name="l00927"></a><span class="lineno"> 927</span>  <a class="code" href="group__operator.html#ga8dca543fb4d1ee1cd8b4c5d6028b3075">applyMultiVarPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, encoding, coeffs, expons, numTermsPerReg, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l00928"></a><span class="lineno"> 928</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, regs, totalNumQubits, allRegMatr);</div>
<div class="line"><a name="l00929"></a><span class="lineno"> 929</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec, 1E4*REAL_EPS) );</div>
<div class="line"><a name="l00930"></a><span class="lineno"> 930</span>  }</div>
<div class="line"><a name="l00931"></a><span class="lineno"> 931</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00932"></a><span class="lineno"> 932</span>  </div>
<div class="line"><a name="l00933"></a><span class="lineno"> 933</span>  <a class="code" href="group__operator.html#ga8dca543fb4d1ee1cd8b4c5d6028b3075">applyMultiVarPhaseFuncOverrides</a>(quregMatr, regs, numQubitsPerReg, numRegs, encoding, coeffs, expons, numTermsPerReg, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l00934"></a><span class="lineno"> 934</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, regs, totalNumQubits, allRegMatr);</div>
<div class="line"><a name="l00935"></a><span class="lineno"> 935</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 1E6*REAL_EPS) );</div>
<div class="line"><a name="l00936"></a><span class="lineno"> 936</span>  }</div>
<div class="line"><a name="l00937"></a><span class="lineno"> 937</span>  }</div>
<div class="line"><a name="l00938"></a><span class="lineno"> 938</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00939"></a><span class="lineno"> 939</span>  </div>
<div class="line"><a name="l00940"></a><span class="lineno"> 940</span>  <span class="keywordtype">int</span> numRegs = 2;</div>
<div class="line"><a name="l00941"></a><span class="lineno"> 941</span>  <span class="keywordtype">int</span> numQubitsPerReg[] = {2,3};</div>
<div class="line"><a name="l00942"></a><span class="lineno"> 942</span>  <span class="keywordtype">int</span> qubits[] = {0,1,2,3,4};</div>
<div class="line"><a name="l00943"></a><span class="lineno"> 943</span>  </div>
<div class="line"><a name="l00944"></a><span class="lineno"> 944</span>  SECTION( <span class="stringliteral">"number of registers"</span> ) {</div>
<div class="line"><a name="l00945"></a><span class="lineno"> 945</span>  </div>
<div class="line"><a name="l00946"></a><span class="lineno"> 946</span>  numRegs = GENERATE_COPY( -1, 0, 1+<a class="code" href="QuEST__precision_8h.html#a6698ce2a3971003a0a0289e5980d39c5">MAX_NUM_REGS_APPLY_ARBITRARY_PHASE</a> );</div>
<div class="line"><a name="l00947"></a><span class="lineno"> 947</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga8dca543fb4d1ee1cd8b4c5d6028b3075">applyMultiVarPhaseFuncOverrides</a>(quregVec, qubits, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, NULL, NULL, NULL, NULL, NULL, 0), Contains(<span class="stringliteral">"Invalid number of qubit subregisters"</span>) );</div>
<div class="line"><a name="l00948"></a><span class="lineno"> 948</span>  }</div>
<div class="line"><a name="l00949"></a><span class="lineno"> 949</span>  SECTION( <span class="stringliteral">"number of qubits"</span> ) {</div>
<div class="line"><a name="l00950"></a><span class="lineno"> 950</span>  </div>
<div class="line"><a name="l00951"></a><span class="lineno"> 951</span>  numQubitsPerReg[GENERATE_COPY(range(0,numRegs))] = GENERATE( -1, 0, 1+<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l00952"></a><span class="lineno"> 952</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga8dca543fb4d1ee1cd8b4c5d6028b3075">applyMultiVarPhaseFuncOverrides</a>(quregVec, qubits, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, NULL, NULL, NULL, NULL, NULL, 0), Contains(<span class="stringliteral">"Invalid number of qubits"</span>) );</div>
<div class="line"><a name="l00953"></a><span class="lineno"> 953</span>  }</div>
<div class="line"><a name="l00954"></a><span class="lineno"> 954</span>  SECTION( <span class="stringliteral">"repetition of qubits"</span> ) {</div>
<div class="line"><a name="l00955"></a><span class="lineno"> 955</span>  </div>
<div class="line"><a name="l00956"></a><span class="lineno"> 956</span>  qubits[GENERATE(2,3,4)] = qubits[1];</div>
<div class="line"><a name="l00957"></a><span class="lineno"> 957</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga8dca543fb4d1ee1cd8b4c5d6028b3075">applyMultiVarPhaseFuncOverrides</a>(quregVec, qubits, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, NULL, NULL, NULL, NULL, NULL, 0), Contains(<span class="stringliteral">"The qubits must be unique"</span>) );</div>
<div class="line"><a name="l00958"></a><span class="lineno"> 958</span>  }</div>
<div class="line"><a name="l00959"></a><span class="lineno"> 959</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l00960"></a><span class="lineno"> 960</span>  </div>
<div class="line"><a name="l00961"></a><span class="lineno"> 961</span>  qubits[GENERATE(range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>))] = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l00962"></a><span class="lineno"> 962</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga8dca543fb4d1ee1cd8b4c5d6028b3075">applyMultiVarPhaseFuncOverrides</a>(quregVec, qubits, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, NULL, NULL, NULL, NULL, NULL, 0), Contains(<span class="stringliteral">"Invalid qubit index"</span>) );</div>
<div class="line"><a name="l00963"></a><span class="lineno"> 963</span>  }</div>
<div class="line"><a name="l00964"></a><span class="lineno"> 964</span>  SECTION( <span class="stringliteral">"number of terms"</span> ) {</div>
<div class="line"><a name="l00965"></a><span class="lineno"> 965</span>  </div>
<div class="line"><a name="l00966"></a><span class="lineno"> 966</span>  <span class="keywordtype">int</span> numTermsPerReg[] = {3, 3};</div>
<div class="line"><a name="l00967"></a><span class="lineno"> 967</span>  </div>
<div class="line"><a name="l00968"></a><span class="lineno"> 968</span>  numTermsPerReg[GENERATE_COPY(range(0,numRegs))] = GENERATE( -1, 0 );</div>
<div class="line"><a name="l00969"></a><span class="lineno"> 969</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga8dca543fb4d1ee1cd8b4c5d6028b3075">applyMultiVarPhaseFuncOverrides</a>(quregVec, qubits, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, NULL, NULL, numTermsPerReg, NULL, NULL, 0), Contains(<span class="stringliteral">"Invalid number of terms in the phase function"</span>) );</div>
<div class="line"><a name="l00970"></a><span class="lineno"> 970</span>  }</div>
<div class="line"><a name="l00971"></a><span class="lineno"> 971</span>  SECTION( <span class="stringliteral">"bit encoding name"</span> ) {</div>
<div class="line"><a name="l00972"></a><span class="lineno"> 972</span>  </div>
<div class="line"><a name="l00973"></a><span class="lineno"> 973</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#ga9c91c41aa42ae537995e89ffc616afe1">bitEncoding</a> enc = (<span class="keyword">enum</span> <a class="code" href="group__type.html#ga9c91c41aa42ae537995e89ffc616afe1">bitEncoding</a>) GENERATE( -1, 2 );</div>
<div class="line"><a name="l00974"></a><span class="lineno"> 974</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga8dca543fb4d1ee1cd8b4c5d6028b3075">applyMultiVarPhaseFuncOverrides</a>(quregVec, qubits, numQubitsPerReg, numRegs, enc, NULL, NULL, NULL, NULL, NULL, 0), Contains(<span class="stringliteral">"Invalid bit encoding"</span>) );</div>
<div class="line"><a name="l00975"></a><span class="lineno"> 975</span>  }</div>
<div class="line"><a name="l00976"></a><span class="lineno"> 976</span>  SECTION( <span class="stringliteral">"two's complement register"</span> ) {</div>
<div class="line"><a name="l00977"></a><span class="lineno"> 977</span>  </div>
<div class="line"><a name="l00978"></a><span class="lineno"> 978</span>  numQubitsPerReg[GENERATE_COPY(range(0,numRegs))] = 1;</div>
<div class="line"><a name="l00979"></a><span class="lineno"> 979</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga8dca543fb4d1ee1cd8b4c5d6028b3075">applyMultiVarPhaseFuncOverrides</a>(quregVec, qubits, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>, NULL, NULL, NULL, NULL, NULL, 0), Contains(<span class="stringliteral">"A sub-register contained too few qubits to employ TWOS_COMPLEMENT encoding"</span>) );</div>
<div class="line"><a name="l00980"></a><span class="lineno"> 980</span>  }</div>
<div class="line"><a name="l00981"></a><span class="lineno"> 981</span>  SECTION( <span class="stringliteral">"fractional exponent"</span> ) {</div>
<div class="line"><a name="l00982"></a><span class="lineno"> 982</span>  </div>
<div class="line"><a name="l00983"></a><span class="lineno"> 983</span>  <span class="keywordtype">int</span> numTermsPerReg[] = {3, 3};</div>
<div class="line"><a name="l00984"></a><span class="lineno"> 984</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeffs[] = {0,0,0, 0,0,0};</div>
<div class="line"><a name="l00985"></a><span class="lineno"> 985</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> expos[] = {1,2,3, 1,2,3};</div>
<div class="line"><a name="l00986"></a><span class="lineno"> 986</span>  </div>
<div class="line"><a name="l00987"></a><span class="lineno"> 987</span>  expos[GENERATE(range(0,6))] = GENERATE( 0.5, 1.999, 5.0001 );</div>
<div class="line"><a name="l00988"></a><span class="lineno"> 988</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga8dca543fb4d1ee1cd8b4c5d6028b3075">applyMultiVarPhaseFuncOverrides</a>(quregVec, qubits, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>, coeffs, expos, numTermsPerReg, NULL, NULL, 0), Contains(<span class="stringliteral">"The phase function contained a fractional exponent, which is illegal in TWOS_COMPLEMENT"</span>) );</div>
<div class="line"><a name="l00989"></a><span class="lineno"> 989</span>  </div>
<div class="line"><a name="l00990"></a><span class="lineno"> 990</span>  <span class="comment">// ensure fractional exponents are valid in unsigned mode however</span></div>
<div class="line"><a name="l00991"></a><span class="lineno"> 991</span>  REQUIRE_NOTHROW( <a class="code" href="group__operator.html#ga8dca543fb4d1ee1cd8b4c5d6028b3075">applyMultiVarPhaseFuncOverrides</a>(quregVec, qubits, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, coeffs, expos, numTermsPerReg, NULL, NULL, 0) );</div>
<div class="line"><a name="l00992"></a><span class="lineno"> 992</span>  }</div>
<div class="line"><a name="l00993"></a><span class="lineno"> 993</span>  SECTION( <span class="stringliteral">"negative exponent"</span> ) {</div>
<div class="line"><a name="l00994"></a><span class="lineno"> 994</span>  </div>
<div class="line"><a name="l00995"></a><span class="lineno"> 995</span>  <span class="keywordtype">int</span> numTermsPerReg[] = {3, 3};</div>
<div class="line"><a name="l00996"></a><span class="lineno"> 996</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeffs[] = {0,0,0, 0,0,0};</div>
<div class="line"><a name="l00997"></a><span class="lineno"> 997</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> expos[] = {1,2,3, 1,2,3};</div>
<div class="line"><a name="l00998"></a><span class="lineno"> 998</span>  </div>
<div class="line"><a name="l00999"></a><span class="lineno"> 999</span>  expos[GENERATE(range(0,6))] = GENERATE( -1, -2, -2.5 );</div>
<div class="line"><a name="l01000"></a><span class="lineno"> 1000</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#ga9c91c41aa42ae537995e89ffc616afe1">bitEncoding</a> enc = GENERATE( <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a> );</div>
<div class="line"><a name="l01001"></a><span class="lineno"> 1001</span>  </div>
<div class="line"><a name="l01002"></a><span class="lineno"> 1002</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga8dca543fb4d1ee1cd8b4c5d6028b3075">applyMultiVarPhaseFuncOverrides</a>(quregVec, qubits, numQubitsPerReg, numRegs, enc, coeffs, expos, numTermsPerReg, NULL, NULL, 0), Contains(<span class="stringliteral">"The phase function contained an illegal negative exponent"</span>) );</div>
<div class="line"><a name="l01003"></a><span class="lineno"> 1003</span>  }</div>
<div class="line"><a name="l01004"></a><span class="lineno"> 1004</span>  SECTION( <span class="stringliteral">"number of overrides"</span> ) {</div>
<div class="line"><a name="l01005"></a><span class="lineno"> 1005</span>  </div>
<div class="line"><a name="l01006"></a><span class="lineno"> 1006</span>  <span class="keywordtype">int</span> numTermsPerReg[] = {3, 3};</div>
<div class="line"><a name="l01007"></a><span class="lineno"> 1007</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeffs[] = {0,0,0, 0,0,0};</div>
<div class="line"><a name="l01008"></a><span class="lineno"> 1008</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> expos[] = {1,2,3, 1,2,3};</div>
<div class="line"><a name="l01009"></a><span class="lineno"> 1009</span>  </div>
<div class="line"><a name="l01010"></a><span class="lineno"> 1010</span>  <span class="keywordtype">int</span> numOverrides = -1;</div>
<div class="line"><a name="l01011"></a><span class="lineno"> 1011</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga8dca543fb4d1ee1cd8b4c5d6028b3075">applyMultiVarPhaseFuncOverrides</a>(quregVec, qubits, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, coeffs, expos, numTermsPerReg, NULL, NULL, numOverrides), Contains(<span class="stringliteral">"Invalid number of phase function overrides specified"</span>) );</div>
<div class="line"><a name="l01012"></a><span class="lineno"> 1012</span>  }</div>
<div class="line"><a name="l01013"></a><span class="lineno"> 1013</span>  SECTION( <span class="stringliteral">"override indices"</span> ) {</div>
<div class="line"><a name="l01014"></a><span class="lineno"> 1014</span>  </div>
<div class="line"><a name="l01015"></a><span class="lineno"> 1015</span>  <span class="keywordtype">int</span> numTermsPerReg[] = {3, 3};</div>
<div class="line"><a name="l01016"></a><span class="lineno"> 1016</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeffs[] = {0,0,0, 0,0,0};</div>
<div class="line"><a name="l01017"></a><span class="lineno"> 1017</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> expos[] = {1,2,3, 1,2,3};</div>
<div class="line"><a name="l01018"></a><span class="lineno"> 1018</span>  </div>
<div class="line"><a name="l01019"></a><span class="lineno"> 1019</span>  <span class="comment">// numQubitsPerReg = {2, 3}</span></div>
<div class="line"><a name="l01020"></a><span class="lineno"> 1020</span>  <span class="keywordtype">int</span> numOverrides = 3;</div>
<div class="line"><a name="l01021"></a><span class="lineno"> 1021</span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <span class="keywordtype">int</span> overrideInds[] = {0,0, 0,0, 0,0}; <span class="comment">// repetition not checked</span></div>
<div class="line"><a name="l01022"></a><span class="lineno"> 1022</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> overridePhases[] = {.1, .1, .1};</div>
<div class="line"><a name="l01023"></a><span class="lineno"> 1023</span>  </div>
<div class="line"><a name="l01024"></a><span class="lineno"> 1024</span>  <span class="comment">// first element of overrideInds coordinate is a 2 qubit register</span></div>
<div class="line"><a name="l01025"></a><span class="lineno"> 1025</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#ga9c91c41aa42ae537995e89ffc616afe1">bitEncoding</a> enc = <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>;</div>
<div class="line"><a name="l01026"></a><span class="lineno"> 1026</span>  <span class="keywordtype">int</span> badInd = GENERATE(0, 2, 4);</div>
<div class="line"><a name="l01027"></a><span class="lineno"> 1027</span>  overrideInds[badInd] = GENERATE( -1, (1<<2) );</div>
<div class="line"><a name="l01028"></a><span class="lineno"> 1028</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga8dca543fb4d1ee1cd8b4c5d6028b3075">applyMultiVarPhaseFuncOverrides</a>(quregVec, qubits, numQubitsPerReg, numRegs, enc, coeffs, expos, numTermsPerReg, overrideInds, overridePhases, numOverrides), Contains(<span class="stringliteral">"Invalid phase function override index, in the UNSIGNED encoding"</span>) );</div>
<div class="line"><a name="l01029"></a><span class="lineno"> 1029</span>  overrideInds[badInd] = 0;</div>
<div class="line"><a name="l01030"></a><span class="lineno"> 1030</span>  </div>
<div class="line"><a name="l01031"></a><span class="lineno"> 1031</span>  <span class="comment">// second element of overrideInds coordinate is a 3 qubit register</span></div>
<div class="line"><a name="l01032"></a><span class="lineno"> 1032</span>  badInd += 1;</div>
<div class="line"><a name="l01033"></a><span class="lineno"> 1033</span>  overrideInds[badInd] = GENERATE( -1, (1<<3) );</div>
<div class="line"><a name="l01034"></a><span class="lineno"> 1034</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga8dca543fb4d1ee1cd8b4c5d6028b3075">applyMultiVarPhaseFuncOverrides</a>(quregVec, qubits, numQubitsPerReg, numRegs, enc, coeffs, expos, numTermsPerReg, overrideInds, overridePhases, numOverrides), Contains(<span class="stringliteral">"Invalid phase function override index, in the UNSIGNED encoding"</span>) );</div>
<div class="line"><a name="l01035"></a><span class="lineno"> 1035</span>  overrideInds[badInd] = 0;</div>
<div class="line"><a name="l01036"></a><span class="lineno"> 1036</span>  badInd -= 1;</div>
<div class="line"><a name="l01037"></a><span class="lineno"> 1037</span>  </div>
<div class="line"><a name="l01038"></a><span class="lineno"> 1038</span>  enc = <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>;</div>
<div class="line"><a name="l01039"></a><span class="lineno"> 1039</span>  <span class="keywordtype">int</span> minInd = -(1<<(numQubitsPerReg[0]-1));</div>
<div class="line"><a name="l01040"></a><span class="lineno"> 1040</span>  <span class="keywordtype">int</span> maxInd = (1<<(numQubitsPerReg[0]-1)) - 1;</div>
<div class="line"><a name="l01041"></a><span class="lineno"> 1041</span>  overrideInds[badInd] = GENERATE_COPY( minInd-1, maxInd+1 );</div>
<div class="line"><a name="l01042"></a><span class="lineno"> 1042</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga8dca543fb4d1ee1cd8b4c5d6028b3075">applyMultiVarPhaseFuncOverrides</a>(quregVec, qubits, numQubitsPerReg, numRegs, enc, coeffs, expos, numTermsPerReg, overrideInds, overridePhases, numOverrides), Contains(<span class="stringliteral">"Invalid phase function override index, in the TWOS_COMPLEMENT encoding"</span>) );</div>
<div class="line"><a name="l01043"></a><span class="lineno"> 1043</span>  overrideInds[badInd] = 0;</div>
<div class="line"><a name="l01044"></a><span class="lineno"> 1044</span>  </div>
<div class="line"><a name="l01045"></a><span class="lineno"> 1045</span>  badInd++;</div>
<div class="line"><a name="l01046"></a><span class="lineno"> 1046</span>  minInd = -(1<<(numQubitsPerReg[1]-1));</div>
<div class="line"><a name="l01047"></a><span class="lineno"> 1047</span>  maxInd = (1<<(numQubitsPerReg[1]-1)) -1;</div>
<div class="line"><a name="l01048"></a><span class="lineno"> 1048</span>  overrideInds[badInd] = GENERATE_COPY( minInd-1, maxInd+1 );</div>
<div class="line"><a name="l01049"></a><span class="lineno"> 1049</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga8dca543fb4d1ee1cd8b4c5d6028b3075">applyMultiVarPhaseFuncOverrides</a>(quregVec, qubits, numQubitsPerReg, numRegs, enc, coeffs, expos, numTermsPerReg, overrideInds, overridePhases, numOverrides), Contains(<span class="stringliteral">"Invalid phase function override index, in the TWOS_COMPLEMENT encoding"</span>) );</div>
<div class="line"><a name="l01050"></a><span class="lineno"> 1050</span>  }</div>
<div class="line"><a name="l01051"></a><span class="lineno"> 1051</span>  }</div>
<div class="line"><a name="l01052"></a><span class="lineno"> 1052</span>  <a class="code" href="test__operators_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l01053"></a><span class="lineno"> 1053</span> }</div>
<div class="line"><a name="l01054"></a><span class="lineno"> 1054</span>  </div>
<div class="line"><a name="l01055"></a><span class="lineno"> 1055</span>  </div>
<div class="line"><a name="l01056"></a><span class="lineno"> 1056</span>  </div>
<div class="line"><a name="l01061"></a><span class="lineno"><a class="line" href="group__unittest.html#gaf532fa260e97dfe85915b88688b8cbcb"> 1061</a></span> <a class="code" href="group__unittest.html#gaff6822e79b947a9e3b791572c674c08c">TEST_CASE</a>( <span class="stringliteral">"applyNamedPhaseFunc"</span>, <span class="stringliteral">"[operators]"</span> ) {</div>
<div class="line"><a name="l01062"></a><span class="lineno"> 1062</span>  </div>
<div class="line"><a name="l01063"></a><span class="lineno"> 1063</span>  <a class="code" href="test__operators_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l01064"></a><span class="lineno"> 1064</span>  </div>
<div class="line"><a name="l01065"></a><span class="lineno"> 1065</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l01066"></a><span class="lineno"> 1066</span>  </div>
<div class="line"><a name="l01067"></a><span class="lineno"> 1067</span>  <span class="comment">// try every kind of binary encoding</span></div>
<div class="line"><a name="l01068"></a><span class="lineno"> 1068</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#ga9c91c41aa42ae537995e89ffc616afe1">bitEncoding</a> encoding = GENERATE( <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>,<a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a> );</div>
<div class="line"><a name="l01069"></a><span class="lineno"> 1069</span>  </div>
<div class="line"><a name="l01070"></a><span class="lineno"> 1070</span>  <span class="comment">// try every possible number of registers </span></div>
<div class="line"><a name="l01071"></a><span class="lineno"> 1071</span>  <span class="comment">// (between #qubits containing 1, and 1 containing #qubits)</span></div>
<div class="line"><a name="l01072"></a><span class="lineno"> 1072</span>  <span class="keywordtype">int</span> numRegs;</div>
<div class="line"><a name="l01073"></a><span class="lineno"> 1073</span>  <span class="keywordtype">int</span> maxNumRegs = 0;</div>
<div class="line"><a name="l01074"></a><span class="lineno"> 1074</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>)</div>
<div class="line"><a name="l01075"></a><span class="lineno"> 1075</span>  maxNumRegs = <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>;</div>
<div class="line"><a name="l01076"></a><span class="lineno"> 1076</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>)</div>
<div class="line"><a name="l01077"></a><span class="lineno"> 1077</span>  maxNumRegs = <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>/2; <span class="comment">// floors</span></div>
<div class="line"><a name="l01078"></a><span class="lineno"> 1078</span>  numRegs = GENERATE_COPY( range(1, maxNumRegs+1) );</div>
<div class="line"><a name="l01079"></a><span class="lineno"> 1079</span>  </div>
<div class="line"><a name="l01080"></a><span class="lineno"> 1080</span>  <span class="comment">// try every possible total number of involved qubits</span></div>
<div class="line"><a name="l01081"></a><span class="lineno"> 1081</span>  <span class="keywordtype">int</span> totalNumQubits;</div>
<div class="line"><a name="l01082"></a><span class="lineno"> 1082</span>  <span class="keywordtype">int</span> minTotalQubits = 0;</div>
<div class="line"><a name="l01083"></a><span class="lineno"> 1083</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>)</div>
<div class="line"><a name="l01084"></a><span class="lineno"> 1084</span>  <span class="comment">// each register must contain at least 1 qubit</span></div>
<div class="line"><a name="l01085"></a><span class="lineno"> 1085</span>  minTotalQubits = numRegs;</div>
<div class="line"><a name="l01086"></a><span class="lineno"> 1086</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>)</div>
<div class="line"><a name="l01087"></a><span class="lineno"> 1087</span>  <span class="comment">// each register must contain at least 2 qubits</span></div>
<div class="line"><a name="l01088"></a><span class="lineno"> 1088</span>  minTotalQubits = 2*numRegs;</div>
<div class="line"><a name="l01089"></a><span class="lineno"> 1089</span>  totalNumQubits = GENERATE_COPY( range(minTotalQubits,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1) );</div>
<div class="line"><a name="l01090"></a><span class="lineno"> 1090</span>  </div>
<div class="line"><a name="l01091"></a><span class="lineno"> 1091</span>  <span class="comment">// try every qubits subset and ordering </span></div>
<div class="line"><a name="l01092"></a><span class="lineno"> 1092</span>  <span class="keywordtype">int</span>* regs = GENERATE_COPY( <a class="code" href="group__testutilities.html#ga35add15146aa606b256df79334b867d5">sublists</a>(range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>), totalNumQubits) );</div>
<div class="line"><a name="l01093"></a><span class="lineno"> 1093</span>  </div>
<div class="line"><a name="l01094"></a><span class="lineno"> 1094</span>  <span class="comment">// assign each sub-reg its minimum length</span></div>
<div class="line"><a name="l01095"></a><span class="lineno"> 1095</span>  <span class="keywordtype">int</span> unallocQubits = totalNumQubits;</div>
<div class="line"><a name="l01096"></a><span class="lineno"> 1096</span>  <span class="keywordtype">int</span> numQubitsPerReg[numRegs];</div>
<div class="line"><a name="l01097"></a><span class="lineno"> 1097</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numRegs; i++) </div>
<div class="line"><a name="l01098"></a><span class="lineno"> 1098</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>) {</div>
<div class="line"><a name="l01099"></a><span class="lineno"> 1099</span>  numQubitsPerReg[i] = 1;</div>
<div class="line"><a name="l01100"></a><span class="lineno"> 1100</span>  unallocQubits -= 1;</div>
<div class="line"><a name="l01101"></a><span class="lineno"> 1101</span>  }</div>
<div class="line"><a name="l01102"></a><span class="lineno"> 1102</span>  <span class="keywordflow">else</span> <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>) {</div>
<div class="line"><a name="l01103"></a><span class="lineno"> 1103</span>  numQubitsPerReg[i] = 2;</div>
<div class="line"><a name="l01104"></a><span class="lineno"> 1104</span>  unallocQubits -= 2;</div>
<div class="line"><a name="l01105"></a><span class="lineno"> 1105</span>  }</div>
<div class="line"><a name="l01106"></a><span class="lineno"> 1106</span>  <span class="comment">// and randomly allocate the remaining qubits between the registers</span></div>
<div class="line"><a name="l01107"></a><span class="lineno"> 1107</span>  <span class="keywordflow">while</span> (unallocQubits > 0) {</div>
<div class="line"><a name="l01108"></a><span class="lineno"> 1108</span>  numQubitsPerReg[<a class="code" href="group__testutilities.html#ga7125d0747a44db58115899727ac5f6be">getRandomInt</a>(0,numRegs)] += 1;</div>
<div class="line"><a name="l01109"></a><span class="lineno"> 1109</span>  unallocQubits--;</div>
<div class="line"><a name="l01110"></a><span class="lineno"> 1110</span>  }</div>
<div class="line"><a name="l01111"></a><span class="lineno"> 1111</span>  </div>
<div class="line"><a name="l01112"></a><span class="lineno"> 1112</span>  <span class="comment">// for reference, determine the values corresponding to each register for all basis states</span></div>
<div class="line"><a name="l01113"></a><span class="lineno"> 1113</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> regVals[1<<totalNumQubits][numRegs];</div>
<div class="line"><a name="l01114"></a><span class="lineno"> 1114</span>  <span class="keywordflow">for</span> (<span class="keywordtype">long</span> <span class="keywordtype">long</span> <span class="keywordtype">int</span> i=0; i<(1<<totalNumQubits); i++) {</div>
<div class="line"><a name="l01115"></a><span class="lineno"> 1115</span>  </div>
<div class="line"><a name="l01116"></a><span class="lineno"> 1116</span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <span class="keywordtype">int</span> bits = i;</div>
<div class="line"><a name="l01117"></a><span class="lineno"> 1117</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r++) { </div>
<div class="line"><a name="l01118"></a><span class="lineno"> 1118</span>  regVals[i][r] = bits % (1 << numQubitsPerReg[r]);</div>
<div class="line"><a name="l01119"></a><span class="lineno"> 1119</span>  bits = bits >> numQubitsPerReg[r];</div>
<div class="line"><a name="l01120"></a><span class="lineno"> 1120</span>  </div>
<div class="line"><a name="l01121"></a><span class="lineno"> 1121</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>)</div>
<div class="line"><a name="l01122"></a><span class="lineno"> 1122</span>  regVals[i][r] = <a class="code" href="group__testutilities.html#ga49be3b32f7b7a274fc5ecb209fde1189">getTwosComplement</a>(regVals[i][r], numQubitsPerReg[r]);</div>
<div class="line"><a name="l01123"></a><span class="lineno"> 1123</span>  }</div>
<div class="line"><a name="l01124"></a><span class="lineno"> 1124</span>  }</div>
<div class="line"><a name="l01125"></a><span class="lineno"> 1125</span>  </div>
<div class="line"><a name="l01126"></a><span class="lineno"> 1126</span>  <span class="comment">/* the reference diagonal matrix which assumes the qubits are</span></div>
<div class="line"><a name="l01127"></a><span class="lineno"> 1127</span> <span class="comment"> * contiguous and strictly increasing between the registers, and hence </span></div>
<div class="line"><a name="l01128"></a><span class="lineno"> 1128</span> <span class="comment"> * only depends on the number of qubits in each register.</span></div>
<div class="line"><a name="l01129"></a><span class="lineno"> 1129</span> <span class="comment"> */</span></div>
<div class="line"><a name="l01130"></a><span class="lineno"> 1130</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> diagMatr = <a class="code" href="group__testutilities.html#ga6ccbb15b0f234e926be96a153181b63a">getZeroMatrix</a>(1 << totalNumQubits);</div>
<div class="line"><a name="l01131"></a><span class="lineno"> 1131</span>  </div>
<div class="line"><a name="l01132"></a><span class="lineno"> 1132</span>  SECTION( <span class="stringliteral">"NORM"</span> ) {</div>
<div class="line"><a name="l01133"></a><span class="lineno"> 1133</span>  </div>
<div class="line"><a name="l01134"></a><span class="lineno"> 1134</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<diagMatr.size(); i++) {</div>
<div class="line"><a name="l01135"></a><span class="lineno"> 1135</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> phase = 0;</div>
<div class="line"><a name="l01136"></a><span class="lineno"> 1136</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r++)</div>
<div class="line"><a name="l01137"></a><span class="lineno"> 1137</span>  phase += pow(regVals[i][r], 2);</div>
<div class="line"><a name="l01138"></a><span class="lineno"> 1138</span>  phase = sqrt(phase);</div>
<div class="line"><a name="l01139"></a><span class="lineno"> 1139</span>  diagMatr[i][i] = <a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(phase);</div>
<div class="line"><a name="l01140"></a><span class="lineno"> 1140</span>  }</div>
<div class="line"><a name="l01141"></a><span class="lineno"> 1141</span>  </div>
<div class="line"><a name="l01142"></a><span class="lineno"> 1142</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l01143"></a><span class="lineno"> 1143</span>  </div>
<div class="line"><a name="l01144"></a><span class="lineno"> 1144</span>  <a class="code" href="group__operator.html#gac4df97d8c125c8cc65df720f67b2bf69">applyNamedPhaseFunc</a>(quregVec, regs, numQubitsPerReg, numRegs, encoding, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>);</div>
<div class="line"><a name="l01145"></a><span class="lineno"> 1145</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l01146"></a><span class="lineno"> 1146</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l01147"></a><span class="lineno"> 1147</span>  }</div>
<div class="line"><a name="l01148"></a><span class="lineno"> 1148</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01149"></a><span class="lineno"> 1149</span>  </div>
<div class="line"><a name="l01150"></a><span class="lineno"> 1150</span>  <a class="code" href="group__operator.html#gac4df97d8c125c8cc65df720f67b2bf69">applyNamedPhaseFunc</a>(quregMatr, regs, numQubitsPerReg, numRegs, encoding, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>);</div>
<div class="line"><a name="l01151"></a><span class="lineno"> 1151</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l01152"></a><span class="lineno"> 1152</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 142*REAL_EPS) );</div>
<div class="line"><a name="l01153"></a><span class="lineno"> 1153</span>  }</div>
<div class="line"><a name="l01154"></a><span class="lineno"> 1154</span>  }</div>
<div class="line"><a name="l01155"></a><span class="lineno"> 1155</span>  SECTION( <span class="stringliteral">"PRODUCT"</span> ) {</div>
<div class="line"><a name="l01156"></a><span class="lineno"> 1156</span>  </div>
<div class="line"><a name="l01157"></a><span class="lineno"> 1157</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<diagMatr.size(); i++) {</div>
<div class="line"><a name="l01158"></a><span class="lineno"> 1158</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> phase = 1;</div>
<div class="line"><a name="l01159"></a><span class="lineno"> 1159</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r++)</div>
<div class="line"><a name="l01160"></a><span class="lineno"> 1160</span>  phase *= regVals[i][r];</div>
<div class="line"><a name="l01161"></a><span class="lineno"> 1161</span>  diagMatr[i][i] = <a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(phase);</div>
<div class="line"><a name="l01162"></a><span class="lineno"> 1162</span>  }</div>
<div class="line"><a name="l01163"></a><span class="lineno"> 1163</span>  </div>
<div class="line"><a name="l01164"></a><span class="lineno"> 1164</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l01165"></a><span class="lineno"> 1165</span>  </div>
<div class="line"><a name="l01166"></a><span class="lineno"> 1166</span>  <a class="code" href="group__operator.html#gac4df97d8c125c8cc65df720f67b2bf69">applyNamedPhaseFunc</a>(quregVec, regs, numQubitsPerReg, numRegs, encoding, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65acb6911398e0068f545a31b82bcdef3e4">PRODUCT</a>);</div>
<div class="line"><a name="l01167"></a><span class="lineno"> 1167</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l01168"></a><span class="lineno"> 1168</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l01169"></a><span class="lineno"> 1169</span>  }</div>
<div class="line"><a name="l01170"></a><span class="lineno"> 1170</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01171"></a><span class="lineno"> 1171</span>  </div>
<div class="line"><a name="l01172"></a><span class="lineno"> 1172</span>  <a class="code" href="group__operator.html#gac4df97d8c125c8cc65df720f67b2bf69">applyNamedPhaseFunc</a>(quregMatr, regs, numQubitsPerReg, numRegs, encoding, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65acb6911398e0068f545a31b82bcdef3e4">PRODUCT</a>);</div>
<div class="line"><a name="l01173"></a><span class="lineno"> 1173</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l01174"></a><span class="lineno"> 1174</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 142*REAL_EPS) );</div>
<div class="line"><a name="l01175"></a><span class="lineno"> 1175</span>  }</div>
<div class="line"><a name="l01176"></a><span class="lineno"> 1176</span>  }</div>
<div class="line"><a name="l01177"></a><span class="lineno"> 1177</span>  SECTION( <span class="stringliteral">"DISTANCE"</span> ) {</div>
<div class="line"><a name="l01178"></a><span class="lineno"> 1178</span>  </div>
<div class="line"><a name="l01179"></a><span class="lineno"> 1179</span>  <span class="comment">// test only if there are an even number of registers</span></div>
<div class="line"><a name="l01180"></a><span class="lineno"> 1180</span>  <span class="keywordflow">if</span> (numRegs%2 == 0) {</div>
<div class="line"><a name="l01181"></a><span class="lineno"> 1181</span>  </div>
<div class="line"><a name="l01182"></a><span class="lineno"> 1182</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<diagMatr.size(); i++) {</div>
<div class="line"><a name="l01183"></a><span class="lineno"> 1183</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> phase = 0;</div>
<div class="line"><a name="l01184"></a><span class="lineno"> 1184</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r+=2)</div>
<div class="line"><a name="l01185"></a><span class="lineno"> 1185</span>  phase += pow(regVals[i][r+1]-regVals[i][r], 2);</div>
<div class="line"><a name="l01186"></a><span class="lineno"> 1186</span>  phase = sqrt(phase);</div>
<div class="line"><a name="l01187"></a><span class="lineno"> 1187</span>  diagMatr[i][i] = <a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(phase);</div>
<div class="line"><a name="l01188"></a><span class="lineno"> 1188</span>  }</div>
<div class="line"><a name="l01189"></a><span class="lineno"> 1189</span>  }</div>
<div class="line"><a name="l01190"></a><span class="lineno"> 1190</span>  </div>
<div class="line"><a name="l01191"></a><span class="lineno"> 1191</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l01192"></a><span class="lineno"> 1192</span>  </div>
<div class="line"><a name="l01193"></a><span class="lineno"> 1193</span>  <span class="keywordflow">if</span> (numRegs%2 == 0) {</div>
<div class="line"><a name="l01194"></a><span class="lineno"> 1194</span>  <a class="code" href="group__operator.html#gac4df97d8c125c8cc65df720f67b2bf69">applyNamedPhaseFunc</a>(quregVec, regs, numQubitsPerReg, numRegs, encoding, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a2ad72f168181763513d7793c13bf2a91">DISTANCE</a>);</div>
<div class="line"><a name="l01195"></a><span class="lineno"> 1195</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l01196"></a><span class="lineno"> 1196</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l01197"></a><span class="lineno"> 1197</span>  }</div>
<div class="line"><a name="l01198"></a><span class="lineno"> 1198</span>  }</div>
<div class="line"><a name="l01199"></a><span class="lineno"> 1199</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01200"></a><span class="lineno"> 1200</span>  </div>
<div class="line"><a name="l01201"></a><span class="lineno"> 1201</span>  <span class="keywordflow">if</span> (numRegs%2 == 0) {</div>
<div class="line"><a name="l01202"></a><span class="lineno"> 1202</span>  <a class="code" href="group__operator.html#gac4df97d8c125c8cc65df720f67b2bf69">applyNamedPhaseFunc</a>(quregMatr, regs, numQubitsPerReg, numRegs, encoding, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a2ad72f168181763513d7793c13bf2a91">DISTANCE</a>);</div>
<div class="line"><a name="l01203"></a><span class="lineno"> 1203</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l01204"></a><span class="lineno"> 1204</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 142*REAL_EPS) );</div>
<div class="line"><a name="l01205"></a><span class="lineno"> 1205</span>  }</div>
<div class="line"><a name="l01206"></a><span class="lineno"> 1206</span>  }</div>
<div class="line"><a name="l01207"></a><span class="lineno"> 1207</span>  }</div>
<div class="line"><a name="l01208"></a><span class="lineno"> 1208</span>  }</div>
<div class="line"><a name="l01209"></a><span class="lineno"> 1209</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l01210"></a><span class="lineno"> 1210</span>  </div>
<div class="line"><a name="l01211"></a><span class="lineno"> 1211</span>  <span class="keywordtype">int</span> numRegs = 2;</div>
<div class="line"><a name="l01212"></a><span class="lineno"> 1212</span>  <span class="keywordtype">int</span> numQubitsPerReg[] = {2,3};</div>
<div class="line"><a name="l01213"></a><span class="lineno"> 1213</span>  <span class="keywordtype">int</span> regs[] = {0,1,2,3,4};</div>
<div class="line"><a name="l01214"></a><span class="lineno"> 1214</span>  </div>
<div class="line"><a name="l01215"></a><span class="lineno"> 1215</span>  SECTION( <span class="stringliteral">"number of registers"</span> ) {</div>
<div class="line"><a name="l01216"></a><span class="lineno"> 1216</span>  </div>
<div class="line"><a name="l01217"></a><span class="lineno"> 1217</span>  numRegs = GENERATE_COPY( -1, 0, 1+<a class="code" href="QuEST__precision_8h.html#a6698ce2a3971003a0a0289e5980d39c5">MAX_NUM_REGS_APPLY_ARBITRARY_PHASE</a> );</div>
<div class="line"><a name="l01218"></a><span class="lineno"> 1218</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gac4df97d8c125c8cc65df720f67b2bf69">applyNamedPhaseFunc</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>), Contains(<span class="stringliteral">"Invalid number of qubit subregisters"</span>) );</div>
<div class="line"><a name="l01219"></a><span class="lineno"> 1219</span>  }</div>
<div class="line"><a name="l01220"></a><span class="lineno"> 1220</span>  SECTION( <span class="stringliteral">"number of qubits"</span> ) {</div>
<div class="line"><a name="l01221"></a><span class="lineno"> 1221</span>  </div>
<div class="line"><a name="l01222"></a><span class="lineno"> 1222</span>  numQubitsPerReg[GENERATE_COPY(range(0,numRegs))] = GENERATE( -1, 0, 1+<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l01223"></a><span class="lineno"> 1223</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gac4df97d8c125c8cc65df720f67b2bf69">applyNamedPhaseFunc</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>), Contains(<span class="stringliteral">"Invalid number of qubits"</span>) );</div>
<div class="line"><a name="l01224"></a><span class="lineno"> 1224</span>  }</div>
<div class="line"><a name="l01225"></a><span class="lineno"> 1225</span>  SECTION( <span class="stringliteral">"repetition of qubits"</span> ) {</div>
<div class="line"><a name="l01226"></a><span class="lineno"> 1226</span>  </div>
<div class="line"><a name="l01227"></a><span class="lineno"> 1227</span>  regs[GENERATE(2,3,4)] = regs[1];</div>
<div class="line"><a name="l01228"></a><span class="lineno"> 1228</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gac4df97d8c125c8cc65df720f67b2bf69">applyNamedPhaseFunc</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>), Contains(<span class="stringliteral">"The qubits must be unique"</span>) );</div>
<div class="line"><a name="l01229"></a><span class="lineno"> 1229</span>  }</div>
<div class="line"><a name="l01230"></a><span class="lineno"> 1230</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l01231"></a><span class="lineno"> 1231</span>  </div>
<div class="line"><a name="l01232"></a><span class="lineno"> 1232</span>  regs[GENERATE(range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>))] = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l01233"></a><span class="lineno"> 1233</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gac4df97d8c125c8cc65df720f67b2bf69">applyNamedPhaseFunc</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>), Contains(<span class="stringliteral">"Invalid qubit index"</span>) );</div>
<div class="line"><a name="l01234"></a><span class="lineno"> 1234</span>  }</div>
<div class="line"><a name="l01235"></a><span class="lineno"> 1235</span>  SECTION( <span class="stringliteral">"bit encoding name"</span> ) {</div>
<div class="line"><a name="l01236"></a><span class="lineno"> 1236</span>  </div>
<div class="line"><a name="l01237"></a><span class="lineno"> 1237</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#ga9c91c41aa42ae537995e89ffc616afe1">bitEncoding</a> enc = (<span class="keyword">enum</span> <a class="code" href="group__type.html#ga9c91c41aa42ae537995e89ffc616afe1">bitEncoding</a>) GENERATE( -1, 2 );</div>
<div class="line"><a name="l01238"></a><span class="lineno"> 1238</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gac4df97d8c125c8cc65df720f67b2bf69">applyNamedPhaseFunc</a>(quregVec, regs, numQubitsPerReg, numRegs, enc, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>), Contains(<span class="stringliteral">"Invalid bit encoding"</span>) );</div>
<div class="line"><a name="l01239"></a><span class="lineno"> 1239</span>  }</div>
<div class="line"><a name="l01240"></a><span class="lineno"> 1240</span>  SECTION( <span class="stringliteral">"two's complement register"</span> ) {</div>
<div class="line"><a name="l01241"></a><span class="lineno"> 1241</span>  </div>
<div class="line"><a name="l01242"></a><span class="lineno"> 1242</span>  numQubitsPerReg[GENERATE_COPY(range(0,numRegs))] = 1;</div>
<div class="line"><a name="l01243"></a><span class="lineno"> 1243</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gac4df97d8c125c8cc65df720f67b2bf69">applyNamedPhaseFunc</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>), Contains(<span class="stringliteral">"A sub-register contained too few qubits to employ TWOS_COMPLEMENT encoding"</span>) );</div>
<div class="line"><a name="l01244"></a><span class="lineno"> 1244</span>  }</div>
<div class="line"><a name="l01245"></a><span class="lineno"> 1245</span>  SECTION( <span class="stringliteral">"phase function name"</span> ) {</div>
<div class="line"><a name="l01246"></a><span class="lineno"> 1246</span>  </div>
<div class="line"><a name="l01247"></a><span class="lineno"> 1247</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = (<span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a>) GENERATE( -1, 14 );</div>
<div class="line"><a name="l01248"></a><span class="lineno"> 1248</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gac4df97d8c125c8cc65df720f67b2bf69">applyNamedPhaseFunc</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, func), Contains(<span class="stringliteral">"Invalid named phase function"</span>) );</div>
<div class="line"><a name="l01249"></a><span class="lineno"> 1249</span>  }</div>
<div class="line"><a name="l01250"></a><span class="lineno"> 1250</span>  SECTION( <span class="stringliteral">"phase function parameters"</span> ) {</div>
<div class="line"><a name="l01251"></a><span class="lineno"> 1251</span>  </div>
<div class="line"><a name="l01252"></a><span class="lineno"> 1252</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = GENERATE( <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a93c0c1e166dd43c6a57f61e5490808e1">SCALED_NORM</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ad4c32e295c08ebe224e2c5ba6497f043">INVERSE_NORM</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae8c96906c1ec109d295c491e572d01e2">SCALED_INVERSE_NORM</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65aa318172feec5b530e9a7849f2f7b44e7">SCALED_INVERSE_SHIFTED_NORM</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a31a29a30f92fe34c35098f941adbbc93">SCALED_PRODUCT</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65acb26952815118f5ced7703302dbeb556">INVERSE_PRODUCT</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a1a5168576607f460d3e60f184575cacb">SCALED_INVERSE_PRODUCT</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ace23d4b924240a245d83193f0ce398d4">SCALED_DISTANCE</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a6313e6ff48163c11c47866c4fda4bfa0">INVERSE_DISTANCE</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae5114537389194302c7a619e35e6e227">SCALED_INVERSE_DISTANCE</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a39111120b79016d6b3e773b711fa63f7">SCALED_INVERSE_SHIFTED_DISTANCE</a> );</div>
<div class="line"><a name="l01253"></a><span class="lineno"> 1253</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gac4df97d8c125c8cc65df720f67b2bf69">applyNamedPhaseFunc</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, func), Contains(<span class="stringliteral">"Invalid number of parameters"</span>) );</div>
<div class="line"><a name="l01254"></a><span class="lineno"> 1254</span>  }</div>
<div class="line"><a name="l01255"></a><span class="lineno"> 1255</span>  SECTION( <span class="stringliteral">"distance pair registers"</span> ) {</div>
<div class="line"><a name="l01256"></a><span class="lineno"> 1256</span>  </div>
<div class="line"><a name="l01257"></a><span class="lineno"> 1257</span>  <span class="keywordtype">int</span> numQb[] = {1,1,1,1,1};</div>
<div class="line"><a name="l01258"></a><span class="lineno"> 1258</span>  <span class="keywordtype">int</span> qb[] = {0,1,2,3,4};</div>
<div class="line"><a name="l01259"></a><span class="lineno"> 1259</span>  </div>
<div class="line"><a name="l01260"></a><span class="lineno"> 1260</span>  numRegs = GENERATE( 1, 3, 5 );</div>
<div class="line"><a name="l01261"></a><span class="lineno"> 1261</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gac4df97d8c125c8cc65df720f67b2bf69">applyNamedPhaseFunc</a>(quregVec, qb, numQb, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a2ad72f168181763513d7793c13bf2a91">DISTANCE</a>), Contains(<span class="stringliteral">"Phase functions DISTANCE"</span>) && Contains(<span class="stringliteral">"even number of sub-registers"</span>) );</div>
<div class="line"><a name="l01262"></a><span class="lineno"> 1262</span>  }</div>
<div class="line"><a name="l01263"></a><span class="lineno"> 1263</span>  }</div>
<div class="line"><a name="l01264"></a><span class="lineno"> 1264</span>  <a class="code" href="test__operators_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l01265"></a><span class="lineno"> 1265</span> }</div>
<div class="line"><a name="l01266"></a><span class="lineno"> 1266</span>  </div>
<div class="line"><a name="l01267"></a><span class="lineno"> 1267</span>  </div>
<div class="line"><a name="l01268"></a><span class="lineno"> 1268</span>  </div>
<div class="line"><a name="l01273"></a><span class="lineno"><a class="line" href="group__unittest.html#gacaa45de6a609b372e667e046e5c9a466"> 1273</a></span> <a class="code" href="group__unittest.html#gaff6822e79b947a9e3b791572c674c08c">TEST_CASE</a>( <span class="stringliteral">"applyNamedPhaseFuncOverrides"</span>, <span class="stringliteral">"[operators]"</span> ) {</div>
<div class="line"><a name="l01274"></a><span class="lineno"> 1274</span>  </div>
<div class="line"><a name="l01275"></a><span class="lineno"> 1275</span>  <a class="code" href="test__operators_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l01276"></a><span class="lineno"> 1276</span>  </div>
<div class="line"><a name="l01277"></a><span class="lineno"> 1277</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l01278"></a><span class="lineno"> 1278</span>  </div>
<div class="line"><a name="l01279"></a><span class="lineno"> 1279</span>  <span class="comment">// try every kind of binary encoding</span></div>
<div class="line"><a name="l01280"></a><span class="lineno"> 1280</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#ga9c91c41aa42ae537995e89ffc616afe1">bitEncoding</a> encoding = GENERATE( <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>,<a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a> );</div>
<div class="line"><a name="l01281"></a><span class="lineno"> 1281</span>  </div>
<div class="line"><a name="l01282"></a><span class="lineno"> 1282</span>  <span class="comment">// try every possible number of registers </span></div>
<div class="line"><a name="l01283"></a><span class="lineno"> 1283</span>  <span class="comment">// (between #qubits containing 1, and 1 containing #qubits)</span></div>
<div class="line"><a name="l01284"></a><span class="lineno"> 1284</span>  <span class="keywordtype">int</span> numRegs;</div>
<div class="line"><a name="l01285"></a><span class="lineno"> 1285</span>  <span class="keywordtype">int</span> maxNumRegs = 0;</div>
<div class="line"><a name="l01286"></a><span class="lineno"> 1286</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>)</div>
<div class="line"><a name="l01287"></a><span class="lineno"> 1287</span>  maxNumRegs = <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>;</div>
<div class="line"><a name="l01288"></a><span class="lineno"> 1288</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>)</div>
<div class="line"><a name="l01289"></a><span class="lineno"> 1289</span>  maxNumRegs = <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>/2; <span class="comment">// floors</span></div>
<div class="line"><a name="l01290"></a><span class="lineno"> 1290</span>  numRegs = GENERATE_COPY( range(1, maxNumRegs+1) );</div>
<div class="line"><a name="l01291"></a><span class="lineno"> 1291</span>  </div>
<div class="line"><a name="l01292"></a><span class="lineno"> 1292</span>  <span class="comment">// try every possible total number of involved qubits</span></div>
<div class="line"><a name="l01293"></a><span class="lineno"> 1293</span>  <span class="keywordtype">int</span> totalNumQubits;</div>
<div class="line"><a name="l01294"></a><span class="lineno"> 1294</span>  <span class="keywordtype">int</span> minTotalQubits = 0;</div>
<div class="line"><a name="l01295"></a><span class="lineno"> 1295</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>)</div>
<div class="line"><a name="l01296"></a><span class="lineno"> 1296</span>  <span class="comment">// each register must contain at least 1 qubit</span></div>
<div class="line"><a name="l01297"></a><span class="lineno"> 1297</span>  minTotalQubits = numRegs;</div>
<div class="line"><a name="l01298"></a><span class="lineno"> 1298</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>)</div>
<div class="line"><a name="l01299"></a><span class="lineno"> 1299</span>  <span class="comment">// each register must contain at least 2 qubits</span></div>
<div class="line"><a name="l01300"></a><span class="lineno"> 1300</span>  minTotalQubits = 2*numRegs;</div>
<div class="line"><a name="l01301"></a><span class="lineno"> 1301</span>  totalNumQubits = GENERATE_COPY( range(minTotalQubits,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1) );</div>
<div class="line"><a name="l01302"></a><span class="lineno"> 1302</span>  </div>
<div class="line"><a name="l01303"></a><span class="lineno"> 1303</span>  <span class="comment">// try every qubits subset and ordering </span></div>
<div class="line"><a name="l01304"></a><span class="lineno"> 1304</span>  <span class="keywordtype">int</span>* regs = GENERATE_COPY( <a class="code" href="group__testutilities.html#ga35add15146aa606b256df79334b867d5">sublists</a>(range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>), totalNumQubits) );</div>
<div class="line"><a name="l01305"></a><span class="lineno"> 1305</span>  </div>
<div class="line"><a name="l01306"></a><span class="lineno"> 1306</span>  <span class="comment">// assign each sub-reg its minimum length</span></div>
<div class="line"><a name="l01307"></a><span class="lineno"> 1307</span>  <span class="keywordtype">int</span> unallocQubits = totalNumQubits;</div>
<div class="line"><a name="l01308"></a><span class="lineno"> 1308</span>  <span class="keywordtype">int</span> numQubitsPerReg[numRegs];</div>
<div class="line"><a name="l01309"></a><span class="lineno"> 1309</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numRegs; i++) </div>
<div class="line"><a name="l01310"></a><span class="lineno"> 1310</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>) {</div>
<div class="line"><a name="l01311"></a><span class="lineno"> 1311</span>  numQubitsPerReg[i] = 1;</div>
<div class="line"><a name="l01312"></a><span class="lineno"> 1312</span>  unallocQubits -= 1;</div>
<div class="line"><a name="l01313"></a><span class="lineno"> 1313</span>  }</div>
<div class="line"><a name="l01314"></a><span class="lineno"> 1314</span>  <span class="keywordflow">else</span> <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>) {</div>
<div class="line"><a name="l01315"></a><span class="lineno"> 1315</span>  numQubitsPerReg[i] = 2;</div>
<div class="line"><a name="l01316"></a><span class="lineno"> 1316</span>  unallocQubits -= 2;</div>
<div class="line"><a name="l01317"></a><span class="lineno"> 1317</span>  }</div>
<div class="line"><a name="l01318"></a><span class="lineno"> 1318</span>  <span class="comment">// and randomly allocate the remaining qubits between the registers</span></div>
<div class="line"><a name="l01319"></a><span class="lineno"> 1319</span>  <span class="keywordflow">while</span> (unallocQubits > 0) {</div>
<div class="line"><a name="l01320"></a><span class="lineno"> 1320</span>  numQubitsPerReg[<a class="code" href="group__testutilities.html#ga7125d0747a44db58115899727ac5f6be">getRandomInt</a>(0,numRegs)] += 1;</div>
<div class="line"><a name="l01321"></a><span class="lineno"> 1321</span>  unallocQubits--;</div>
<div class="line"><a name="l01322"></a><span class="lineno"> 1322</span>  }</div>
<div class="line"><a name="l01323"></a><span class="lineno"> 1323</span>  </div>
<div class="line"><a name="l01324"></a><span class="lineno"> 1324</span>  </div>
<div class="line"><a name="l01325"></a><span class="lineno"> 1325</span>  <span class="comment">// choose a random number of overrides (even overriding every amplitude)</span></div>
<div class="line"><a name="l01326"></a><span class="lineno"> 1326</span>  <span class="keywordtype">int</span> numOverrides = <a class="code" href="group__testutilities.html#ga7125d0747a44db58115899727ac5f6be">getRandomInt</a>(0, (1<<totalNumQubits) + 1);</div>
<div class="line"><a name="l01327"></a><span class="lineno"> 1327</span>  </div>
<div class="line"><a name="l01328"></a><span class="lineno"> 1328</span>  <span class="comment">// randomise each override index (uniqueness isn't checked)</span></div>
<div class="line"><a name="l01329"></a><span class="lineno"> 1329</span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <span class="keywordtype">int</span> overrideInds[numOverrides*numRegs];</div>
<div class="line"><a name="l01330"></a><span class="lineno"> 1330</span>  <span class="keywordtype">int</span> flatInd = 0;</div>
<div class="line"><a name="l01331"></a><span class="lineno"> 1331</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> v=0; v<numOverrides; v++) {</div>
<div class="line"><a name="l01332"></a><span class="lineno"> 1332</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r++) {</div>
<div class="line"><a name="l01333"></a><span class="lineno"> 1333</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>)</div>
<div class="line"><a name="l01334"></a><span class="lineno"> 1334</span>  overrideInds[flatInd] = <a class="code" href="group__testutilities.html#ga7125d0747a44db58115899727ac5f6be">getRandomInt</a>(0, 1<<numQubitsPerReg[r]);</div>
<div class="line"><a name="l01335"></a><span class="lineno"> 1335</span>  <span class="keywordflow">else</span> <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>) </div>
<div class="line"><a name="l01336"></a><span class="lineno"> 1336</span>  overrideInds[flatInd] = <a class="code" href="group__testutilities.html#ga7125d0747a44db58115899727ac5f6be">getRandomInt</a>(-(1<<(numQubitsPerReg[r]-1)), (1<<(numQubitsPerReg[r]-1))-1);</div>
<div class="line"><a name="l01337"></a><span class="lineno"> 1337</span>  flatInd++;</div>
<div class="line"><a name="l01338"></a><span class="lineno"> 1338</span>  }</div>
<div class="line"><a name="l01339"></a><span class="lineno"> 1339</span>  }</div>
<div class="line"><a name="l01340"></a><span class="lineno"> 1340</span>  </div>
<div class="line"><a name="l01341"></a><span class="lineno"> 1341</span>  <span class="comment">// override to a random phase</span></div>
<div class="line"><a name="l01342"></a><span class="lineno"> 1342</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> overridePhases[numOverrides];</div>
<div class="line"><a name="l01343"></a><span class="lineno"> 1343</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> v=0; v<numOverrides; v++)</div>
<div class="line"><a name="l01344"></a><span class="lineno"> 1344</span>  overridePhases[v] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-4, 4); <span class="comment">// periodic in [-pi, pi]</span></div>
<div class="line"><a name="l01345"></a><span class="lineno"> 1345</span>  </div>
<div class="line"><a name="l01346"></a><span class="lineno"> 1346</span>  </div>
<div class="line"><a name="l01347"></a><span class="lineno"> 1347</span>  <span class="comment">// determine the values corresponding to each register for all basis states</span></div>
<div class="line"><a name="l01348"></a><span class="lineno"> 1348</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> regVals[1<<totalNumQubits][numRegs];</div>
<div class="line"><a name="l01349"></a><span class="lineno"> 1349</span>  <span class="keywordflow">for</span> (<span class="keywordtype">long</span> <span class="keywordtype">long</span> <span class="keywordtype">int</span> i=0; i<(1<<totalNumQubits); i++) {</div>
<div class="line"><a name="l01350"></a><span class="lineno"> 1350</span>  </div>
<div class="line"><a name="l01351"></a><span class="lineno"> 1351</span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <span class="keywordtype">int</span> bits = i;</div>
<div class="line"><a name="l01352"></a><span class="lineno"> 1352</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r++) { </div>
<div class="line"><a name="l01353"></a><span class="lineno"> 1353</span>  regVals[i][r] = bits % (1 << numQubitsPerReg[r]);</div>
<div class="line"><a name="l01354"></a><span class="lineno"> 1354</span>  bits = bits >> numQubitsPerReg[r];</div>
<div class="line"><a name="l01355"></a><span class="lineno"> 1355</span>  </div>
<div class="line"><a name="l01356"></a><span class="lineno"> 1356</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>)</div>
<div class="line"><a name="l01357"></a><span class="lineno"> 1357</span>  regVals[i][r] = <a class="code" href="group__testutilities.html#ga49be3b32f7b7a274fc5ecb209fde1189">getTwosComplement</a>(regVals[i][r], numQubitsPerReg[r]);</div>
<div class="line"><a name="l01358"></a><span class="lineno"> 1358</span>  }</div>
<div class="line"><a name="l01359"></a><span class="lineno"> 1359</span>  }</div>
<div class="line"><a name="l01360"></a><span class="lineno"> 1360</span>  </div>
<div class="line"><a name="l01361"></a><span class="lineno"> 1361</span>  <span class="comment">/* a reference diagonal matrix which assumes the qubits are</span></div>
<div class="line"><a name="l01362"></a><span class="lineno"> 1362</span> <span class="comment"> * contiguous and strictly increasing between the registers, and hence </span></div>
<div class="line"><a name="l01363"></a><span class="lineno"> 1363</span> <span class="comment"> * only depends on the number of qubits in each register.</span></div>
<div class="line"><a name="l01364"></a><span class="lineno"> 1364</span> <span class="comment"> */</span></div>
<div class="line"><a name="l01365"></a><span class="lineno"> 1365</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> diagMatr = <a class="code" href="group__testutilities.html#ga6ccbb15b0f234e926be96a153181b63a">getZeroMatrix</a>(1 << totalNumQubits);</div>
<div class="line"><a name="l01366"></a><span class="lineno"> 1366</span>  </div>
<div class="line"><a name="l01367"></a><span class="lineno"> 1367</span>  SECTION( <span class="stringliteral">"NORM"</span> ) {</div>
<div class="line"><a name="l01368"></a><span class="lineno"> 1368</span>  </div>
<div class="line"><a name="l01369"></a><span class="lineno"> 1369</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<diagMatr.size(); i++) {</div>
<div class="line"><a name="l01370"></a><span class="lineno"> 1370</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> phase = 0;</div>
<div class="line"><a name="l01371"></a><span class="lineno"> 1371</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r++)</div>
<div class="line"><a name="l01372"></a><span class="lineno"> 1372</span>  phase += pow(regVals[i][r], 2);</div>
<div class="line"><a name="l01373"></a><span class="lineno"> 1373</span>  phase = sqrt(phase);</div>
<div class="line"><a name="l01374"></a><span class="lineno"> 1374</span>  diagMatr[i][i] = <a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(phase);</div>
<div class="line"><a name="l01375"></a><span class="lineno"> 1375</span>  }</div>
<div class="line"><a name="l01376"></a><span class="lineno"> 1376</span>  <a class="code" href="group__testutilities.html#gaf57b4b82c98e98918f74476741f60e37">setDiagMatrixOverrides</a>(diagMatr, numQubitsPerReg, numRegs, encoding, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l01377"></a><span class="lineno"> 1377</span>  </div>
<div class="line"><a name="l01378"></a><span class="lineno"> 1378</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l01379"></a><span class="lineno"> 1379</span>  </div>
<div class="line"><a name="l01380"></a><span class="lineno"> 1380</span>  <a class="code" href="group__operator.html#ga2fbaec3bb21cc01f7a2a4ed2aa911ebf">applyNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, encoding, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l01381"></a><span class="lineno"> 1381</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l01382"></a><span class="lineno"> 1382</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l01383"></a><span class="lineno"> 1383</span>  }</div>
<div class="line"><a name="l01384"></a><span class="lineno"> 1384</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01385"></a><span class="lineno"> 1385</span>  </div>
<div class="line"><a name="l01386"></a><span class="lineno"> 1386</span>  <a class="code" href="group__operator.html#ga2fbaec3bb21cc01f7a2a4ed2aa911ebf">applyNamedPhaseFuncOverrides</a>(quregMatr, regs, numQubitsPerReg, numRegs, encoding, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l01387"></a><span class="lineno"> 1387</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l01388"></a><span class="lineno"> 1388</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 1E4*REAL_EPS) );</div>
<div class="line"><a name="l01389"></a><span class="lineno"> 1389</span>  }</div>
<div class="line"><a name="l01390"></a><span class="lineno"> 1390</span>  }</div>
<div class="line"><a name="l01391"></a><span class="lineno"> 1391</span>  SECTION( <span class="stringliteral">"PRODUCT"</span> ) {</div>
<div class="line"><a name="l01392"></a><span class="lineno"> 1392</span>  </div>
<div class="line"><a name="l01393"></a><span class="lineno"> 1393</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<diagMatr.size(); i++) {</div>
<div class="line"><a name="l01394"></a><span class="lineno"> 1394</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> phase = 1;</div>
<div class="line"><a name="l01395"></a><span class="lineno"> 1395</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r++)</div>
<div class="line"><a name="l01396"></a><span class="lineno"> 1396</span>  phase *= regVals[i][r];</div>
<div class="line"><a name="l01397"></a><span class="lineno"> 1397</span>  diagMatr[i][i] = <a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(phase);</div>
<div class="line"><a name="l01398"></a><span class="lineno"> 1398</span>  }</div>
<div class="line"><a name="l01399"></a><span class="lineno"> 1399</span>  </div>
<div class="line"><a name="l01400"></a><span class="lineno"> 1400</span>  <a class="code" href="group__testutilities.html#gaf57b4b82c98e98918f74476741f60e37">setDiagMatrixOverrides</a>(diagMatr, numQubitsPerReg, numRegs, encoding, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l01401"></a><span class="lineno"> 1401</span>  </div>
<div class="line"><a name="l01402"></a><span class="lineno"> 1402</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l01403"></a><span class="lineno"> 1403</span>  </div>
<div class="line"><a name="l01404"></a><span class="lineno"> 1404</span>  <a class="code" href="group__operator.html#ga2fbaec3bb21cc01f7a2a4ed2aa911ebf">applyNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, encoding, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65acb6911398e0068f545a31b82bcdef3e4">PRODUCT</a>, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l01405"></a><span class="lineno"> 1405</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l01406"></a><span class="lineno"> 1406</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l01407"></a><span class="lineno"> 1407</span>  }</div>
<div class="line"><a name="l01408"></a><span class="lineno"> 1408</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01409"></a><span class="lineno"> 1409</span>  </div>
<div class="line"><a name="l01410"></a><span class="lineno"> 1410</span>  <a class="code" href="group__operator.html#ga2fbaec3bb21cc01f7a2a4ed2aa911ebf">applyNamedPhaseFuncOverrides</a>(quregMatr, regs, numQubitsPerReg, numRegs, encoding, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65acb6911398e0068f545a31b82bcdef3e4">PRODUCT</a>, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l01411"></a><span class="lineno"> 1411</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l01412"></a><span class="lineno"> 1412</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 1E4*REAL_EPS) );</div>
<div class="line"><a name="l01413"></a><span class="lineno"> 1413</span>  }</div>
<div class="line"><a name="l01414"></a><span class="lineno"> 1414</span>  }</div>
<div class="line"><a name="l01415"></a><span class="lineno"> 1415</span>  SECTION( <span class="stringliteral">"DISTANCE"</span> ) {</div>
<div class="line"><a name="l01416"></a><span class="lineno"> 1416</span>  </div>
<div class="line"><a name="l01417"></a><span class="lineno"> 1417</span>  <span class="comment">// test only if there are an even number of registers</span></div>
<div class="line"><a name="l01418"></a><span class="lineno"> 1418</span>  <span class="keywordflow">if</span> (numRegs%2 == 0) {</div>
<div class="line"><a name="l01419"></a><span class="lineno"> 1419</span>  </div>
<div class="line"><a name="l01420"></a><span class="lineno"> 1420</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<diagMatr.size(); i++) {</div>
<div class="line"><a name="l01421"></a><span class="lineno"> 1421</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> phase = 0;</div>
<div class="line"><a name="l01422"></a><span class="lineno"> 1422</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r+=2)</div>
<div class="line"><a name="l01423"></a><span class="lineno"> 1423</span>  phase += pow(regVals[i][r+1]-regVals[i][r], 2);</div>
<div class="line"><a name="l01424"></a><span class="lineno"> 1424</span>  phase = sqrt(phase);</div>
<div class="line"><a name="l01425"></a><span class="lineno"> 1425</span>  diagMatr[i][i] = <a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(phase);</div>
<div class="line"><a name="l01426"></a><span class="lineno"> 1426</span>  }</div>
<div class="line"><a name="l01427"></a><span class="lineno"> 1427</span>  </div>
<div class="line"><a name="l01428"></a><span class="lineno"> 1428</span>  <a class="code" href="group__testutilities.html#gaf57b4b82c98e98918f74476741f60e37">setDiagMatrixOverrides</a>(diagMatr, numQubitsPerReg, numRegs, encoding, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l01429"></a><span class="lineno"> 1429</span>  }</div>
<div class="line"><a name="l01430"></a><span class="lineno"> 1430</span>  </div>
<div class="line"><a name="l01431"></a><span class="lineno"> 1431</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l01432"></a><span class="lineno"> 1432</span>  </div>
<div class="line"><a name="l01433"></a><span class="lineno"> 1433</span>  <span class="keywordflow">if</span> (numRegs%2 == 0) {</div>
<div class="line"><a name="l01434"></a><span class="lineno"> 1434</span>  <a class="code" href="group__operator.html#ga2fbaec3bb21cc01f7a2a4ed2aa911ebf">applyNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, encoding, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a2ad72f168181763513d7793c13bf2a91">DISTANCE</a>, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l01435"></a><span class="lineno"> 1435</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l01436"></a><span class="lineno"> 1436</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l01437"></a><span class="lineno"> 1437</span>  }</div>
<div class="line"><a name="l01438"></a><span class="lineno"> 1438</span>  }</div>
<div class="line"><a name="l01439"></a><span class="lineno"> 1439</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01440"></a><span class="lineno"> 1440</span>  </div>
<div class="line"><a name="l01441"></a><span class="lineno"> 1441</span>  <span class="keywordflow">if</span> (numRegs%2 == 0) {</div>
<div class="line"><a name="l01442"></a><span class="lineno"> 1442</span>  <a class="code" href="group__operator.html#ga2fbaec3bb21cc01f7a2a4ed2aa911ebf">applyNamedPhaseFuncOverrides</a>(quregMatr, regs, numQubitsPerReg, numRegs, encoding, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a2ad72f168181763513d7793c13bf2a91">DISTANCE</a>, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l01443"></a><span class="lineno"> 1443</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l01444"></a><span class="lineno"> 1444</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 1E4*REAL_EPS) );</div>
<div class="line"><a name="l01445"></a><span class="lineno"> 1445</span>  }</div>
<div class="line"><a name="l01446"></a><span class="lineno"> 1446</span>  }</div>
<div class="line"><a name="l01447"></a><span class="lineno"> 1447</span>  }</div>
<div class="line"><a name="l01448"></a><span class="lineno"> 1448</span>  }</div>
<div class="line"><a name="l01449"></a><span class="lineno"> 1449</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l01450"></a><span class="lineno"> 1450</span>  </div>
<div class="line"><a name="l01451"></a><span class="lineno"> 1451</span>  <span class="keywordtype">int</span> numRegs = 2;</div>
<div class="line"><a name="l01452"></a><span class="lineno"> 1452</span>  <span class="keywordtype">int</span> numQubitsPerReg[] = {2,3};</div>
<div class="line"><a name="l01453"></a><span class="lineno"> 1453</span>  <span class="keywordtype">int</span> regs[] = {0,1,2,3,4};</div>
<div class="line"><a name="l01454"></a><span class="lineno"> 1454</span>  </div>
<div class="line"><a name="l01455"></a><span class="lineno"> 1455</span>  SECTION( <span class="stringliteral">"number of registers"</span> ) {</div>
<div class="line"><a name="l01456"></a><span class="lineno"> 1456</span>  </div>
<div class="line"><a name="l01457"></a><span class="lineno"> 1457</span>  numRegs = GENERATE_COPY( -1, 0, 1+<a class="code" href="QuEST__precision_8h.html#a6698ce2a3971003a0a0289e5980d39c5">MAX_NUM_REGS_APPLY_ARBITRARY_PHASE</a> );</div>
<div class="line"><a name="l01458"></a><span class="lineno"> 1458</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga2fbaec3bb21cc01f7a2a4ed2aa911ebf">applyNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>, NULL, NULL, 0), Contains(<span class="stringliteral">"Invalid number of qubit subregisters"</span>) );</div>
<div class="line"><a name="l01459"></a><span class="lineno"> 1459</span>  }</div>
<div class="line"><a name="l01460"></a><span class="lineno"> 1460</span>  SECTION( <span class="stringliteral">"number of qubits"</span> ) {</div>
<div class="line"><a name="l01461"></a><span class="lineno"> 1461</span>  </div>
<div class="line"><a name="l01462"></a><span class="lineno"> 1462</span>  numQubitsPerReg[GENERATE_COPY(range(0,numRegs))] = GENERATE( -1, 0, 1+<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l01463"></a><span class="lineno"> 1463</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga2fbaec3bb21cc01f7a2a4ed2aa911ebf">applyNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>, NULL, NULL, 0), Contains(<span class="stringliteral">"Invalid number of qubits"</span>) );</div>
<div class="line"><a name="l01464"></a><span class="lineno"> 1464</span>  }</div>
<div class="line"><a name="l01465"></a><span class="lineno"> 1465</span>  SECTION( <span class="stringliteral">"repetition of qubits"</span> ) {</div>
<div class="line"><a name="l01466"></a><span class="lineno"> 1466</span>  </div>
<div class="line"><a name="l01467"></a><span class="lineno"> 1467</span>  regs[GENERATE(2,3,4)] = regs[1];</div>
<div class="line"><a name="l01468"></a><span class="lineno"> 1468</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga2fbaec3bb21cc01f7a2a4ed2aa911ebf">applyNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>, NULL, NULL, 0), Contains(<span class="stringliteral">"The qubits must be unique"</span>) );</div>
<div class="line"><a name="l01469"></a><span class="lineno"> 1469</span>  }</div>
<div class="line"><a name="l01470"></a><span class="lineno"> 1470</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l01471"></a><span class="lineno"> 1471</span>  </div>
<div class="line"><a name="l01472"></a><span class="lineno"> 1472</span>  regs[GENERATE(range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>))] = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l01473"></a><span class="lineno"> 1473</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga2fbaec3bb21cc01f7a2a4ed2aa911ebf">applyNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>, NULL, NULL, 0), Contains(<span class="stringliteral">"Invalid qubit index"</span>) );</div>
<div class="line"><a name="l01474"></a><span class="lineno"> 1474</span>  }</div>
<div class="line"><a name="l01475"></a><span class="lineno"> 1475</span>  SECTION( <span class="stringliteral">"bit encoding name"</span> ) {</div>
<div class="line"><a name="l01476"></a><span class="lineno"> 1476</span>  </div>
<div class="line"><a name="l01477"></a><span class="lineno"> 1477</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#ga9c91c41aa42ae537995e89ffc616afe1">bitEncoding</a> enc = (<span class="keyword">enum</span> <a class="code" href="group__type.html#ga9c91c41aa42ae537995e89ffc616afe1">bitEncoding</a>) GENERATE( -1, 2 );</div>
<div class="line"><a name="l01478"></a><span class="lineno"> 1478</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga2fbaec3bb21cc01f7a2a4ed2aa911ebf">applyNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, enc, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>, NULL, NULL, 0), Contains(<span class="stringliteral">"Invalid bit encoding"</span>) );</div>
<div class="line"><a name="l01479"></a><span class="lineno"> 1479</span>  }</div>
<div class="line"><a name="l01480"></a><span class="lineno"> 1480</span>  SECTION( <span class="stringliteral">"two's complement register"</span> ) {</div>
<div class="line"><a name="l01481"></a><span class="lineno"> 1481</span>  </div>
<div class="line"><a name="l01482"></a><span class="lineno"> 1482</span>  numQubitsPerReg[GENERATE_COPY(range(0,numRegs))] = 1;</div>
<div class="line"><a name="l01483"></a><span class="lineno"> 1483</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga2fbaec3bb21cc01f7a2a4ed2aa911ebf">applyNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>, NULL, NULL, 0), Contains(<span class="stringliteral">"A sub-register contained too few qubits to employ TWOS_COMPLEMENT encoding"</span>) );</div>
<div class="line"><a name="l01484"></a><span class="lineno"> 1484</span>  }</div>
<div class="line"><a name="l01485"></a><span class="lineno"> 1485</span>  SECTION( <span class="stringliteral">"phase function name"</span> ) {</div>
<div class="line"><a name="l01486"></a><span class="lineno"> 1486</span>  </div>
<div class="line"><a name="l01487"></a><span class="lineno"> 1487</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = (<span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a>) GENERATE( -1, 14 );</div>
<div class="line"><a name="l01488"></a><span class="lineno"> 1488</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga2fbaec3bb21cc01f7a2a4ed2aa911ebf">applyNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, func, NULL, NULL, 0), Contains(<span class="stringliteral">"Invalid named phase function"</span>) );</div>
<div class="line"><a name="l01489"></a><span class="lineno"> 1489</span>  }</div>
<div class="line"><a name="l01490"></a><span class="lineno"> 1490</span>  SECTION( <span class="stringliteral">"phase function parameters"</span> ) {</div>
<div class="line"><a name="l01491"></a><span class="lineno"> 1491</span>  </div>
<div class="line"><a name="l01492"></a><span class="lineno"> 1492</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = GENERATE( <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a93c0c1e166dd43c6a57f61e5490808e1">SCALED_NORM</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ad4c32e295c08ebe224e2c5ba6497f043">INVERSE_NORM</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae8c96906c1ec109d295c491e572d01e2">SCALED_INVERSE_NORM</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65aa318172feec5b530e9a7849f2f7b44e7">SCALED_INVERSE_SHIFTED_NORM</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a31a29a30f92fe34c35098f941adbbc93">SCALED_PRODUCT</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65acb26952815118f5ced7703302dbeb556">INVERSE_PRODUCT</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a1a5168576607f460d3e60f184575cacb">SCALED_INVERSE_PRODUCT</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ace23d4b924240a245d83193f0ce398d4">SCALED_DISTANCE</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a6313e6ff48163c11c47866c4fda4bfa0">INVERSE_DISTANCE</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae5114537389194302c7a619e35e6e227">SCALED_INVERSE_DISTANCE</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a39111120b79016d6b3e773b711fa63f7">SCALED_INVERSE_SHIFTED_DISTANCE</a> );</div>
<div class="line"><a name="l01493"></a><span class="lineno"> 1493</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga2fbaec3bb21cc01f7a2a4ed2aa911ebf">applyNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, func, NULL, NULL, 0), Contains(<span class="stringliteral">"Invalid number of parameters"</span>) );</div>
<div class="line"><a name="l01494"></a><span class="lineno"> 1494</span>  }</div>
<div class="line"><a name="l01495"></a><span class="lineno"> 1495</span>  SECTION( <span class="stringliteral">"distance pair registers"</span> ) {</div>
<div class="line"><a name="l01496"></a><span class="lineno"> 1496</span>  </div>
<div class="line"><a name="l01497"></a><span class="lineno"> 1497</span>  <span class="keywordtype">int</span> numQb[] = {1,1,1,1,1};</div>
<div class="line"><a name="l01498"></a><span class="lineno"> 1498</span>  <span class="keywordtype">int</span> qb[] = {0,1,2,3,4};</div>
<div class="line"><a name="l01499"></a><span class="lineno"> 1499</span>  </div>
<div class="line"><a name="l01500"></a><span class="lineno"> 1500</span>  numRegs = GENERATE( 1, 3, 5 );</div>
<div class="line"><a name="l01501"></a><span class="lineno"> 1501</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga2fbaec3bb21cc01f7a2a4ed2aa911ebf">applyNamedPhaseFuncOverrides</a>(quregVec, qb, numQb, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a2ad72f168181763513d7793c13bf2a91">DISTANCE</a>, NULL, NULL, 0), Contains(<span class="stringliteral">"Phase functions DISTANCE"</span>) && Contains(<span class="stringliteral">"even number of sub-registers"</span>) );</div>
<div class="line"><a name="l01502"></a><span class="lineno"> 1502</span>  }</div>
<div class="line"><a name="l01503"></a><span class="lineno"> 1503</span>  SECTION( <span class="stringliteral">"number of overrides"</span> ) {</div>
<div class="line"><a name="l01504"></a><span class="lineno"> 1504</span>  </div>
<div class="line"><a name="l01505"></a><span class="lineno"> 1505</span>  <span class="keywordtype">int</span> numOverrides = -1;</div>
<div class="line"><a name="l01506"></a><span class="lineno"> 1506</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga2fbaec3bb21cc01f7a2a4ed2aa911ebf">applyNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>, NULL, NULL, numOverrides), Contains(<span class="stringliteral">"Invalid number of phase function overrides specified"</span>) );</div>
<div class="line"><a name="l01507"></a><span class="lineno"> 1507</span>  }</div>
<div class="line"><a name="l01508"></a><span class="lineno"> 1508</span>  SECTION( <span class="stringliteral">"override indices"</span> ) {</div>
<div class="line"><a name="l01509"></a><span class="lineno"> 1509</span>  </div>
<div class="line"><a name="l01510"></a><span class="lineno"> 1510</span>  <span class="comment">// numQubitsPerReg = {2, 3}</span></div>
<div class="line"><a name="l01511"></a><span class="lineno"> 1511</span>  <span class="keywordtype">int</span> numOverrides = 3;</div>
<div class="line"><a name="l01512"></a><span class="lineno"> 1512</span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <span class="keywordtype">int</span> overrideInds[] = {0,0, 0,0, 0,0}; <span class="comment">// repetition not checked</span></div>
<div class="line"><a name="l01513"></a><span class="lineno"> 1513</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> overridePhases[] = {.1, .1, .1};</div>
<div class="line"><a name="l01514"></a><span class="lineno"> 1514</span>  </div>
<div class="line"><a name="l01515"></a><span class="lineno"> 1515</span>  <span class="comment">// first element of overrideInds coordinate is a 2 qubit register</span></div>
<div class="line"><a name="l01516"></a><span class="lineno"> 1516</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#ga9c91c41aa42ae537995e89ffc616afe1">bitEncoding</a> enc = <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>;</div>
<div class="line"><a name="l01517"></a><span class="lineno"> 1517</span>  <span class="keywordtype">int</span> badInd = GENERATE(0, 2, 4);</div>
<div class="line"><a name="l01518"></a><span class="lineno"> 1518</span>  overrideInds[badInd] = GENERATE( -1, (1<<2) );</div>
<div class="line"><a name="l01519"></a><span class="lineno"> 1519</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga2fbaec3bb21cc01f7a2a4ed2aa911ebf">applyNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, enc, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>, overrideInds, overridePhases, numOverrides), Contains(<span class="stringliteral">"Invalid phase function override index, in the UNSIGNED encoding"</span>) );</div>
<div class="line"><a name="l01520"></a><span class="lineno"> 1520</span>  overrideInds[badInd] = 0;</div>
<div class="line"><a name="l01521"></a><span class="lineno"> 1521</span>  </div>
<div class="line"><a name="l01522"></a><span class="lineno"> 1522</span>  <span class="comment">// second element of overrideInds coordinate is a 3 qubit register</span></div>
<div class="line"><a name="l01523"></a><span class="lineno"> 1523</span>  badInd += 1;</div>
<div class="line"><a name="l01524"></a><span class="lineno"> 1524</span>  overrideInds[badInd] = GENERATE( -1, (1<<3) );</div>
<div class="line"><a name="l01525"></a><span class="lineno"> 1525</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga2fbaec3bb21cc01f7a2a4ed2aa911ebf">applyNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, enc, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>, overrideInds, overridePhases, numOverrides), Contains(<span class="stringliteral">"Invalid phase function override index, in the UNSIGNED encoding"</span>) );</div>
<div class="line"><a name="l01526"></a><span class="lineno"> 1526</span>  overrideInds[badInd] = 0;</div>
<div class="line"><a name="l01527"></a><span class="lineno"> 1527</span>  badInd -= 1;</div>
<div class="line"><a name="l01528"></a><span class="lineno"> 1528</span>  </div>
<div class="line"><a name="l01529"></a><span class="lineno"> 1529</span>  enc = <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>;</div>
<div class="line"><a name="l01530"></a><span class="lineno"> 1530</span>  <span class="keywordtype">int</span> minInd = -(1<<(numQubitsPerReg[0]-1));</div>
<div class="line"><a name="l01531"></a><span class="lineno"> 1531</span>  <span class="keywordtype">int</span> maxInd = (1<<(numQubitsPerReg[0]-1)) - 1;</div>
<div class="line"><a name="l01532"></a><span class="lineno"> 1532</span>  overrideInds[badInd] = GENERATE_COPY( minInd-1, maxInd+1 );</div>
<div class="line"><a name="l01533"></a><span class="lineno"> 1533</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga2fbaec3bb21cc01f7a2a4ed2aa911ebf">applyNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, enc, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>, overrideInds, overridePhases, numOverrides), Contains(<span class="stringliteral">"Invalid phase function override index, in the TWOS_COMPLEMENT encoding"</span>) );</div>
<div class="line"><a name="l01534"></a><span class="lineno"> 1534</span>  overrideInds[badInd] = 0;</div>
<div class="line"><a name="l01535"></a><span class="lineno"> 1535</span>  </div>
<div class="line"><a name="l01536"></a><span class="lineno"> 1536</span>  badInd++;</div>
<div class="line"><a name="l01537"></a><span class="lineno"> 1537</span>  minInd = -(1<<(numQubitsPerReg[1]-1));</div>
<div class="line"><a name="l01538"></a><span class="lineno"> 1538</span>  maxInd = (1<<(numQubitsPerReg[1]-1)) -1;</div>
<div class="line"><a name="l01539"></a><span class="lineno"> 1539</span>  overrideInds[badInd] = GENERATE_COPY( minInd-1, maxInd+1 );</div>
<div class="line"><a name="l01540"></a><span class="lineno"> 1540</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga2fbaec3bb21cc01f7a2a4ed2aa911ebf">applyNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, enc, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>, overrideInds, overridePhases, numOverrides), Contains(<span class="stringliteral">"Invalid phase function override index, in the TWOS_COMPLEMENT encoding"</span>) );</div>
<div class="line"><a name="l01541"></a><span class="lineno"> 1541</span>  }</div>
<div class="line"><a name="l01542"></a><span class="lineno"> 1542</span>  }</div>
<div class="line"><a name="l01543"></a><span class="lineno"> 1543</span>  <a class="code" href="test__operators_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l01544"></a><span class="lineno"> 1544</span> }</div>
<div class="line"><a name="l01545"></a><span class="lineno"> 1545</span>  </div>
<div class="line"><a name="l01546"></a><span class="lineno"> 1546</span>  </div>
<div class="line"><a name="l01547"></a><span class="lineno"> 1547</span>  </div>
<div class="line"><a name="l01552"></a><span class="lineno"><a class="line" href="group__unittest.html#gae27f08dded40dbdb9a7b3645ee182ff0"> 1552</a></span> <a class="code" href="group__unittest.html#gaff6822e79b947a9e3b791572c674c08c">TEST_CASE</a>( <span class="stringliteral">"applyParamNamedPhaseFunc"</span>, <span class="stringliteral">"[operators]"</span> ) {</div>
<div class="line"><a name="l01553"></a><span class="lineno"> 1553</span>  </div>
<div class="line"><a name="l01554"></a><span class="lineno"> 1554</span>  <a class="code" href="test__operators_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l01555"></a><span class="lineno"> 1555</span>  </div>
<div class="line"><a name="l01556"></a><span class="lineno"> 1556</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l01557"></a><span class="lineno"> 1557</span>  </div>
<div class="line"><a name="l01558"></a><span class="lineno"> 1558</span>  <span class="comment">// try every kind of binary encoding</span></div>
<div class="line"><a name="l01559"></a><span class="lineno"> 1559</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#ga9c91c41aa42ae537995e89ffc616afe1">bitEncoding</a> encoding = GENERATE( <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>,<a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a> );</div>
<div class="line"><a name="l01560"></a><span class="lineno"> 1560</span>  </div>
<div class="line"><a name="l01561"></a><span class="lineno"> 1561</span>  <span class="comment">// try every possible number of registers </span></div>
<div class="line"><a name="l01562"></a><span class="lineno"> 1562</span>  <span class="comment">// (between #qubits containing 1, and 1 containing #qubits)</span></div>
<div class="line"><a name="l01563"></a><span class="lineno"> 1563</span>  <span class="keywordtype">int</span> numRegs;</div>
<div class="line"><a name="l01564"></a><span class="lineno"> 1564</span>  <span class="keywordtype">int</span> maxNumRegs = 0;</div>
<div class="line"><a name="l01565"></a><span class="lineno"> 1565</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>)</div>
<div class="line"><a name="l01566"></a><span class="lineno"> 1566</span>  maxNumRegs = <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>;</div>
<div class="line"><a name="l01567"></a><span class="lineno"> 1567</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>)</div>
<div class="line"><a name="l01568"></a><span class="lineno"> 1568</span>  maxNumRegs = <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>/2; <span class="comment">// floors</span></div>
<div class="line"><a name="l01569"></a><span class="lineno"> 1569</span>  numRegs = GENERATE_COPY( range(1, maxNumRegs+1) );</div>
<div class="line"><a name="l01570"></a><span class="lineno"> 1570</span>  </div>
<div class="line"><a name="l01571"></a><span class="lineno"> 1571</span>  <span class="comment">// try every possible total number of involved qubits</span></div>
<div class="line"><a name="l01572"></a><span class="lineno"> 1572</span>  <span class="keywordtype">int</span> totalNumQubits;</div>
<div class="line"><a name="l01573"></a><span class="lineno"> 1573</span>  <span class="keywordtype">int</span> minTotalQubits = 0;</div>
<div class="line"><a name="l01574"></a><span class="lineno"> 1574</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>)</div>
<div class="line"><a name="l01575"></a><span class="lineno"> 1575</span>  <span class="comment">// each register must contain at least 1 qubit</span></div>
<div class="line"><a name="l01576"></a><span class="lineno"> 1576</span>  minTotalQubits = numRegs;</div>
<div class="line"><a name="l01577"></a><span class="lineno"> 1577</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>)</div>
<div class="line"><a name="l01578"></a><span class="lineno"> 1578</span>  <span class="comment">// each register must contain at least 2 qubits</span></div>
<div class="line"><a name="l01579"></a><span class="lineno"> 1579</span>  minTotalQubits = 2*numRegs;</div>
<div class="line"><a name="l01580"></a><span class="lineno"> 1580</span>  totalNumQubits = GENERATE_COPY( range(minTotalQubits,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1) );</div>
<div class="line"><a name="l01581"></a><span class="lineno"> 1581</span>  </div>
<div class="line"><a name="l01582"></a><span class="lineno"> 1582</span>  <span class="comment">// try every qubits subset and ordering </span></div>
<div class="line"><a name="l01583"></a><span class="lineno"> 1583</span>  <span class="keywordtype">int</span>* regs = GENERATE_COPY( <a class="code" href="group__testutilities.html#ga35add15146aa606b256df79334b867d5">sublists</a>(range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>), totalNumQubits) );</div>
<div class="line"><a name="l01584"></a><span class="lineno"> 1584</span>  </div>
<div class="line"><a name="l01585"></a><span class="lineno"> 1585</span>  <span class="comment">// assign each sub-reg its minimum length</span></div>
<div class="line"><a name="l01586"></a><span class="lineno"> 1586</span>  <span class="keywordtype">int</span> unallocQubits = totalNumQubits;</div>
<div class="line"><a name="l01587"></a><span class="lineno"> 1587</span>  <span class="keywordtype">int</span> numQubitsPerReg[numRegs];</div>
<div class="line"><a name="l01588"></a><span class="lineno"> 1588</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numRegs; i++) </div>
<div class="line"><a name="l01589"></a><span class="lineno"> 1589</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>) {</div>
<div class="line"><a name="l01590"></a><span class="lineno"> 1590</span>  numQubitsPerReg[i] = 1;</div>
<div class="line"><a name="l01591"></a><span class="lineno"> 1591</span>  unallocQubits -= 1;</div>
<div class="line"><a name="l01592"></a><span class="lineno"> 1592</span>  }</div>
<div class="line"><a name="l01593"></a><span class="lineno"> 1593</span>  <span class="keywordflow">else</span> <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>) {</div>
<div class="line"><a name="l01594"></a><span class="lineno"> 1594</span>  numQubitsPerReg[i] = 2;</div>
<div class="line"><a name="l01595"></a><span class="lineno"> 1595</span>  unallocQubits -= 2;</div>
<div class="line"><a name="l01596"></a><span class="lineno"> 1596</span>  }</div>
<div class="line"><a name="l01597"></a><span class="lineno"> 1597</span>  <span class="comment">// and randomly allocate the remaining qubits between the registers</span></div>
<div class="line"><a name="l01598"></a><span class="lineno"> 1598</span>  <span class="keywordflow">while</span> (unallocQubits > 0) {</div>
<div class="line"><a name="l01599"></a><span class="lineno"> 1599</span>  numQubitsPerReg[<a class="code" href="group__testutilities.html#ga7125d0747a44db58115899727ac5f6be">getRandomInt</a>(0,numRegs)] += 1;</div>
<div class="line"><a name="l01600"></a><span class="lineno"> 1600</span>  unallocQubits--;</div>
<div class="line"><a name="l01601"></a><span class="lineno"> 1601</span>  }</div>
<div class="line"><a name="l01602"></a><span class="lineno"> 1602</span>  </div>
<div class="line"><a name="l01603"></a><span class="lineno"> 1603</span>  <span class="comment">/* produce a reference diagonal matrix which assumes the qubits are</span></div>
<div class="line"><a name="l01604"></a><span class="lineno"> 1604</span> <span class="comment"> * contiguous and strictly increasing between the registers, and hence </span></div>
<div class="line"><a name="l01605"></a><span class="lineno"> 1605</span> <span class="comment"> * only depends on the number of qubits in each register.</span></div>
<div class="line"><a name="l01606"></a><span class="lineno"> 1606</span> <span class="comment"> */</span></div>
<div class="line"><a name="l01607"></a><span class="lineno"> 1607</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> diagMatr = <a class="code" href="group__testutilities.html#ga6ccbb15b0f234e926be96a153181b63a">getZeroMatrix</a>(1 << totalNumQubits);</div>
<div class="line"><a name="l01608"></a><span class="lineno"> 1608</span>  </div>
<div class="line"><a name="l01609"></a><span class="lineno"> 1609</span>  <span class="comment">// determine the values corresponding to each register for all basis states</span></div>
<div class="line"><a name="l01610"></a><span class="lineno"> 1610</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> regVals[1<<totalNumQubits][numRegs];</div>
<div class="line"><a name="l01611"></a><span class="lineno"> 1611</span>  <span class="keywordflow">for</span> (<span class="keywordtype">long</span> <span class="keywordtype">long</span> <span class="keywordtype">int</span> i=0; i<(1<<totalNumQubits); i++) {</div>
<div class="line"><a name="l01612"></a><span class="lineno"> 1612</span>  </div>
<div class="line"><a name="l01613"></a><span class="lineno"> 1613</span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <span class="keywordtype">int</span> bits = i;</div>
<div class="line"><a name="l01614"></a><span class="lineno"> 1614</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r++) { </div>
<div class="line"><a name="l01615"></a><span class="lineno"> 1615</span>  regVals[i][r] = bits % (1 << numQubitsPerReg[r]);</div>
<div class="line"><a name="l01616"></a><span class="lineno"> 1616</span>  bits = bits >> numQubitsPerReg[r];</div>
<div class="line"><a name="l01617"></a><span class="lineno"> 1617</span>  </div>
<div class="line"><a name="l01618"></a><span class="lineno"> 1618</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>)</div>
<div class="line"><a name="l01619"></a><span class="lineno"> 1619</span>  regVals[i][r] = <a class="code" href="group__testutilities.html#ga49be3b32f7b7a274fc5ecb209fde1189">getTwosComplement</a>(regVals[i][r], numQubitsPerReg[r]);</div>
<div class="line"><a name="l01620"></a><span class="lineno"> 1620</span>  }</div>
<div class="line"><a name="l01621"></a><span class="lineno"> 1621</span>  }</div>
<div class="line"><a name="l01622"></a><span class="lineno"> 1622</span>  </div>
<div class="line"><a name="l01623"></a><span class="lineno"> 1623</span>  SECTION( <span class="stringliteral">"INVERSE_NORM"</span> ) {</div>
<div class="line"><a name="l01624"></a><span class="lineno"> 1624</span>  </div>
<div class="line"><a name="l01625"></a><span class="lineno"> 1625</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ad4c32e295c08ebe224e2c5ba6497f043">INVERSE_NORM</a>;</div>
<div class="line"><a name="l01626"></a><span class="lineno"> 1626</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> divPhase = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-4, 4);</div>
<div class="line"><a name="l01627"></a><span class="lineno"> 1627</span>  </div>
<div class="line"><a name="l01628"></a><span class="lineno"> 1628</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<diagMatr.size(); i++) {</div>
<div class="line"><a name="l01629"></a><span class="lineno"> 1629</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> phase = 0;</div>
<div class="line"><a name="l01630"></a><span class="lineno"> 1630</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r++)</div>
<div class="line"><a name="l01631"></a><span class="lineno"> 1631</span>  phase += pow(regVals[i][r], 2);</div>
<div class="line"><a name="l01632"></a><span class="lineno"> 1632</span>  phase = (phase == 0.)? divPhase : 1/sqrt(phase);</div>
<div class="line"><a name="l01633"></a><span class="lineno"> 1633</span>  diagMatr[i][i] = <a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(phase);</div>
<div class="line"><a name="l01634"></a><span class="lineno"> 1634</span>  }</div>
<div class="line"><a name="l01635"></a><span class="lineno"> 1635</span>  </div>
<div class="line"><a name="l01636"></a><span class="lineno"> 1636</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> params[] = {divPhase};</div>
<div class="line"><a name="l01637"></a><span class="lineno"> 1637</span>  <span class="keywordtype">int</span> numParams = 1;</div>
<div class="line"><a name="l01638"></a><span class="lineno"> 1638</span>  </div>
<div class="line"><a name="l01639"></a><span class="lineno"> 1639</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l01640"></a><span class="lineno"> 1640</span>  </div>
<div class="line"><a name="l01641"></a><span class="lineno"> 1641</span>  <a class="code" href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731">applyParamNamedPhaseFunc</a>(quregVec, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams);</div>
<div class="line"><a name="l01642"></a><span class="lineno"> 1642</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l01643"></a><span class="lineno"> 1643</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l01644"></a><span class="lineno"> 1644</span>  }</div>
<div class="line"><a name="l01645"></a><span class="lineno"> 1645</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01646"></a><span class="lineno"> 1646</span>  </div>
<div class="line"><a name="l01647"></a><span class="lineno"> 1647</span>  <a class="code" href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731">applyParamNamedPhaseFunc</a>(quregMatr, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams);</div>
<div class="line"><a name="l01648"></a><span class="lineno"> 1648</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l01649"></a><span class="lineno"> 1649</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l01650"></a><span class="lineno"> 1650</span>  }</div>
<div class="line"><a name="l01651"></a><span class="lineno"> 1651</span>  </div>
<div class="line"><a name="l01652"></a><span class="lineno"> 1652</span>  }</div>
<div class="line"><a name="l01653"></a><span class="lineno"> 1653</span>  SECTION( <span class="stringliteral">"SCALED_NORM"</span> ) {</div>
<div class="line"><a name="l01654"></a><span class="lineno"> 1654</span>  </div>
<div class="line"><a name="l01655"></a><span class="lineno"> 1655</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a93c0c1e166dd43c6a57f61e5490808e1">SCALED_NORM</a>;</div>
<div class="line"><a name="l01656"></a><span class="lineno"> 1656</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeff = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-10, 10);</div>
<div class="line"><a name="l01657"></a><span class="lineno"> 1657</span>  </div>
<div class="line"><a name="l01658"></a><span class="lineno"> 1658</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<diagMatr.size(); i++) {</div>
<div class="line"><a name="l01659"></a><span class="lineno"> 1659</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> phase = 0;</div>
<div class="line"><a name="l01660"></a><span class="lineno"> 1660</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r++)</div>
<div class="line"><a name="l01661"></a><span class="lineno"> 1661</span>  phase += pow(regVals[i][r], 2);</div>
<div class="line"><a name="l01662"></a><span class="lineno"> 1662</span>  phase = coeff * sqrt(phase);</div>
<div class="line"><a name="l01663"></a><span class="lineno"> 1663</span>  diagMatr[i][i] = <a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(phase);</div>
<div class="line"><a name="l01664"></a><span class="lineno"> 1664</span>  }</div>
<div class="line"><a name="l01665"></a><span class="lineno"> 1665</span>  </div>
<div class="line"><a name="l01666"></a><span class="lineno"> 1666</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> params[] = {coeff};</div>
<div class="line"><a name="l01667"></a><span class="lineno"> 1667</span>  <span class="keywordtype">int</span> numParams = 1;</div>
<div class="line"><a name="l01668"></a><span class="lineno"> 1668</span>  </div>
<div class="line"><a name="l01669"></a><span class="lineno"> 1669</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l01670"></a><span class="lineno"> 1670</span>  </div>
<div class="line"><a name="l01671"></a><span class="lineno"> 1671</span>  <a class="code" href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731">applyParamNamedPhaseFunc</a>(quregVec, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams);</div>
<div class="line"><a name="l01672"></a><span class="lineno"> 1672</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l01673"></a><span class="lineno"> 1673</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l01674"></a><span class="lineno"> 1674</span>  }</div>
<div class="line"><a name="l01675"></a><span class="lineno"> 1675</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01676"></a><span class="lineno"> 1676</span>  </div>
<div class="line"><a name="l01677"></a><span class="lineno"> 1677</span>  <a class="code" href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731">applyParamNamedPhaseFunc</a>(quregMatr, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams);</div>
<div class="line"><a name="l01678"></a><span class="lineno"> 1678</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l01679"></a><span class="lineno"> 1679</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l01680"></a><span class="lineno"> 1680</span>  }</div>
<div class="line"><a name="l01681"></a><span class="lineno"> 1681</span>  }</div>
<div class="line"><a name="l01682"></a><span class="lineno"> 1682</span>  SECTION( <span class="stringliteral">"SCALED_INVERSE_NORM"</span> ) {</div>
<div class="line"><a name="l01683"></a><span class="lineno"> 1683</span>  </div>
<div class="line"><a name="l01684"></a><span class="lineno"> 1684</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae8c96906c1ec109d295c491e572d01e2">SCALED_INVERSE_NORM</a>;</div>
<div class="line"><a name="l01685"></a><span class="lineno"> 1685</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeff = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-10, 10);</div>
<div class="line"><a name="l01686"></a><span class="lineno"> 1686</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> divPhase = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-4, 4);</div>
<div class="line"><a name="l01687"></a><span class="lineno"> 1687</span>  </div>
<div class="line"><a name="l01688"></a><span class="lineno"> 1688</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<diagMatr.size(); i++) {</div>
<div class="line"><a name="l01689"></a><span class="lineno"> 1689</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> phase = 0;</div>
<div class="line"><a name="l01690"></a><span class="lineno"> 1690</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r++)</div>
<div class="line"><a name="l01691"></a><span class="lineno"> 1691</span>  phase += pow(regVals[i][r], 2);</div>
<div class="line"><a name="l01692"></a><span class="lineno"> 1692</span>  phase = (phase == 0.)? divPhase : coeff/sqrt(phase);</div>
<div class="line"><a name="l01693"></a><span class="lineno"> 1693</span>  diagMatr[i][i] = <a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(phase);</div>
<div class="line"><a name="l01694"></a><span class="lineno"> 1694</span>  }</div>
<div class="line"><a name="l01695"></a><span class="lineno"> 1695</span>  </div>
<div class="line"><a name="l01696"></a><span class="lineno"> 1696</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> params[] = {coeff, divPhase};</div>
<div class="line"><a name="l01697"></a><span class="lineno"> 1697</span>  <span class="keywordtype">int</span> numParams = 2;</div>
<div class="line"><a name="l01698"></a><span class="lineno"> 1698</span>  </div>
<div class="line"><a name="l01699"></a><span class="lineno"> 1699</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l01700"></a><span class="lineno"> 1700</span>  </div>
<div class="line"><a name="l01701"></a><span class="lineno"> 1701</span>  <a class="code" href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731">applyParamNamedPhaseFunc</a>(quregVec, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams);</div>
<div class="line"><a name="l01702"></a><span class="lineno"> 1702</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l01703"></a><span class="lineno"> 1703</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l01704"></a><span class="lineno"> 1704</span>  }</div>
<div class="line"><a name="l01705"></a><span class="lineno"> 1705</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01706"></a><span class="lineno"> 1706</span>  </div>
<div class="line"><a name="l01707"></a><span class="lineno"> 1707</span>  <a class="code" href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731">applyParamNamedPhaseFunc</a>(quregMatr, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams);</div>
<div class="line"><a name="l01708"></a><span class="lineno"> 1708</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l01709"></a><span class="lineno"> 1709</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l01710"></a><span class="lineno"> 1710</span>  }</div>
<div class="line"><a name="l01711"></a><span class="lineno"> 1711</span>  }</div>
<div class="line"><a name="l01712"></a><span class="lineno"> 1712</span>  SECTION( <span class="stringliteral">"SCALED_INVERSE_SHIFTED_NORM"</span> ) {</div>
<div class="line"><a name="l01713"></a><span class="lineno"> 1713</span>  </div>
<div class="line"><a name="l01714"></a><span class="lineno"> 1714</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65aa318172feec5b530e9a7849f2f7b44e7">SCALED_INVERSE_SHIFTED_NORM</a>;</div>
<div class="line"><a name="l01715"></a><span class="lineno"> 1715</span>  <span class="keywordtype">int</span> numParams = 2 + numRegs;</div>
<div class="line"><a name="l01716"></a><span class="lineno"> 1716</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> params[numParams];</div>
<div class="line"><a name="l01717"></a><span class="lineno"> 1717</span>  params[0] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-10, 10); <span class="comment">// scaling</span></div>
<div class="line"><a name="l01718"></a><span class="lineno"> 1718</span>  params[1] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-4, 4); <span class="comment">// divergence override</span></div>
<div class="line"><a name="l01719"></a><span class="lineno"> 1719</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r++)</div>
<div class="line"><a name="l01720"></a><span class="lineno"> 1720</span>  params[2+r] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-8, 8); <span class="comment">// shifts</span></div>
<div class="line"><a name="l01721"></a><span class="lineno"> 1721</span>  </div>
<div class="line"><a name="l01722"></a><span class="lineno"> 1722</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<diagMatr.size(); i++) {</div>
<div class="line"><a name="l01723"></a><span class="lineno"> 1723</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> phase = 0;</div>
<div class="line"><a name="l01724"></a><span class="lineno"> 1724</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r++)</div>
<div class="line"><a name="l01725"></a><span class="lineno"> 1725</span>  phase += pow(regVals[i][r] - params[2+r], 2);</div>
<div class="line"><a name="l01726"></a><span class="lineno"> 1726</span>  phase = sqrt(phase);</div>
<div class="line"><a name="l01727"></a><span class="lineno"> 1727</span>  phase = (phase <= REAL_EPS)? params[1] : params[0]/phase;</div>
<div class="line"><a name="l01728"></a><span class="lineno"> 1728</span>  diagMatr[i][i] = <a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(phase);</div>
<div class="line"><a name="l01729"></a><span class="lineno"> 1729</span>  }</div>
<div class="line"><a name="l01730"></a><span class="lineno"> 1730</span>  </div>
<div class="line"><a name="l01731"></a><span class="lineno"> 1731</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l01732"></a><span class="lineno"> 1732</span>  </div>
<div class="line"><a name="l01733"></a><span class="lineno"> 1733</span>  <a class="code" href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731">applyParamNamedPhaseFunc</a>(quregVec, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams);</div>
<div class="line"><a name="l01734"></a><span class="lineno"> 1734</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l01735"></a><span class="lineno"> 1735</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l01736"></a><span class="lineno"> 1736</span>  }</div>
<div class="line"><a name="l01737"></a><span class="lineno"> 1737</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01738"></a><span class="lineno"> 1738</span>  </div>
<div class="line"><a name="l01739"></a><span class="lineno"> 1739</span>  <a class="code" href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731">applyParamNamedPhaseFunc</a>(quregMatr, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams);</div>
<div class="line"><a name="l01740"></a><span class="lineno"> 1740</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l01741"></a><span class="lineno"> 1741</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l01742"></a><span class="lineno"> 1742</span>  }</div>
<div class="line"><a name="l01743"></a><span class="lineno"> 1743</span>  }</div>
<div class="line"><a name="l01744"></a><span class="lineno"> 1744</span>  SECTION( <span class="stringliteral">"INVERSE_PRODUCT"</span> ) {</div>
<div class="line"><a name="l01745"></a><span class="lineno"> 1745</span>  </div>
<div class="line"><a name="l01746"></a><span class="lineno"> 1746</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65acb26952815118f5ced7703302dbeb556">INVERSE_PRODUCT</a>;</div>
<div class="line"><a name="l01747"></a><span class="lineno"> 1747</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> divPhase = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-4, 4);</div>
<div class="line"><a name="l01748"></a><span class="lineno"> 1748</span>  </div>
<div class="line"><a name="l01749"></a><span class="lineno"> 1749</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<diagMatr.size(); i++) {</div>
<div class="line"><a name="l01750"></a><span class="lineno"> 1750</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> phase = 1;</div>
<div class="line"><a name="l01751"></a><span class="lineno"> 1751</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r++)</div>
<div class="line"><a name="l01752"></a><span class="lineno"> 1752</span>  phase *= regVals[i][r];</div>
<div class="line"><a name="l01753"></a><span class="lineno"> 1753</span>  phase = (phase == 0.)? divPhase : 1. / phase;</div>
<div class="line"><a name="l01754"></a><span class="lineno"> 1754</span>  diagMatr[i][i] = <a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(phase);</div>
<div class="line"><a name="l01755"></a><span class="lineno"> 1755</span>  }</div>
<div class="line"><a name="l01756"></a><span class="lineno"> 1756</span>  </div>
<div class="line"><a name="l01757"></a><span class="lineno"> 1757</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> params[] = {divPhase};</div>
<div class="line"><a name="l01758"></a><span class="lineno"> 1758</span>  <span class="keywordtype">int</span> numParams = 1;</div>
<div class="line"><a name="l01759"></a><span class="lineno"> 1759</span>  </div>
<div class="line"><a name="l01760"></a><span class="lineno"> 1760</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l01761"></a><span class="lineno"> 1761</span>  </div>
<div class="line"><a name="l01762"></a><span class="lineno"> 1762</span>  <a class="code" href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731">applyParamNamedPhaseFunc</a>(quregVec, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams);</div>
<div class="line"><a name="l01763"></a><span class="lineno"> 1763</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l01764"></a><span class="lineno"> 1764</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l01765"></a><span class="lineno"> 1765</span>  }</div>
<div class="line"><a name="l01766"></a><span class="lineno"> 1766</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01767"></a><span class="lineno"> 1767</span>  </div>
<div class="line"><a name="l01768"></a><span class="lineno"> 1768</span>  <a class="code" href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731">applyParamNamedPhaseFunc</a>(quregMatr, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams);</div>
<div class="line"><a name="l01769"></a><span class="lineno"> 1769</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l01770"></a><span class="lineno"> 1770</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l01771"></a><span class="lineno"> 1771</span>  }</div>
<div class="line"><a name="l01772"></a><span class="lineno"> 1772</span>  }</div>
<div class="line"><a name="l01773"></a><span class="lineno"> 1773</span>  SECTION( <span class="stringliteral">"SCALED_PRODUCT"</span> ) {</div>
<div class="line"><a name="l01774"></a><span class="lineno"> 1774</span>  </div>
<div class="line"><a name="l01775"></a><span class="lineno"> 1775</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a31a29a30f92fe34c35098f941adbbc93">SCALED_PRODUCT</a>;</div>
<div class="line"><a name="l01776"></a><span class="lineno"> 1776</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeff = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-10, 10);</div>
<div class="line"><a name="l01777"></a><span class="lineno"> 1777</span>  </div>
<div class="line"><a name="l01778"></a><span class="lineno"> 1778</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<diagMatr.size(); i++) {</div>
<div class="line"><a name="l01779"></a><span class="lineno"> 1779</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> phase = 1;</div>
<div class="line"><a name="l01780"></a><span class="lineno"> 1780</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r++)</div>
<div class="line"><a name="l01781"></a><span class="lineno"> 1781</span>  phase *= regVals[i][r];</div>
<div class="line"><a name="l01782"></a><span class="lineno"> 1782</span>  diagMatr[i][i] = <a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(coeff * phase);</div>
<div class="line"><a name="l01783"></a><span class="lineno"> 1783</span>  }</div>
<div class="line"><a name="l01784"></a><span class="lineno"> 1784</span>  </div>
<div class="line"><a name="l01785"></a><span class="lineno"> 1785</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> params[] = {coeff};</div>
<div class="line"><a name="l01786"></a><span class="lineno"> 1786</span>  <span class="keywordtype">int</span> numParams = 1;</div>
<div class="line"><a name="l01787"></a><span class="lineno"> 1787</span>  </div>
<div class="line"><a name="l01788"></a><span class="lineno"> 1788</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l01789"></a><span class="lineno"> 1789</span>  </div>
<div class="line"><a name="l01790"></a><span class="lineno"> 1790</span>  <a class="code" href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731">applyParamNamedPhaseFunc</a>(quregVec, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams);</div>
<div class="line"><a name="l01791"></a><span class="lineno"> 1791</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l01792"></a><span class="lineno"> 1792</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l01793"></a><span class="lineno"> 1793</span>  }</div>
<div class="line"><a name="l01794"></a><span class="lineno"> 1794</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01795"></a><span class="lineno"> 1795</span>  </div>
<div class="line"><a name="l01796"></a><span class="lineno"> 1796</span>  <a class="code" href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731">applyParamNamedPhaseFunc</a>(quregMatr, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams);</div>
<div class="line"><a name="l01797"></a><span class="lineno"> 1797</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l01798"></a><span class="lineno"> 1798</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l01799"></a><span class="lineno"> 1799</span>  }</div>
<div class="line"><a name="l01800"></a><span class="lineno"> 1800</span>  }</div>
<div class="line"><a name="l01801"></a><span class="lineno"> 1801</span>  SECTION( <span class="stringliteral">"SCALED_INVERSE_PRODUCT"</span> ) {</div>
<div class="line"><a name="l01802"></a><span class="lineno"> 1802</span>  </div>
<div class="line"><a name="l01803"></a><span class="lineno"> 1803</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a1a5168576607f460d3e60f184575cacb">SCALED_INVERSE_PRODUCT</a>;</div>
<div class="line"><a name="l01804"></a><span class="lineno"> 1804</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeff = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-10, 10);</div>
<div class="line"><a name="l01805"></a><span class="lineno"> 1805</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> divPhase = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-4, 4);</div>
<div class="line"><a name="l01806"></a><span class="lineno"> 1806</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> params[] = {coeff, divPhase};</div>
<div class="line"><a name="l01807"></a><span class="lineno"> 1807</span>  <span class="keywordtype">int</span> numParams = 2;</div>
<div class="line"><a name="l01808"></a><span class="lineno"> 1808</span>  </div>
<div class="line"><a name="l01809"></a><span class="lineno"> 1809</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<diagMatr.size(); i++) {</div>
<div class="line"><a name="l01810"></a><span class="lineno"> 1810</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> phase = 1;</div>
<div class="line"><a name="l01811"></a><span class="lineno"> 1811</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r++)</div>
<div class="line"><a name="l01812"></a><span class="lineno"> 1812</span>  phase *= regVals[i][r];</div>
<div class="line"><a name="l01813"></a><span class="lineno"> 1813</span>  phase = (phase == 0)? divPhase : coeff / phase;</div>
<div class="line"><a name="l01814"></a><span class="lineno"> 1814</span>  diagMatr[i][i] = <a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(phase);</div>
<div class="line"><a name="l01815"></a><span class="lineno"> 1815</span>  }</div>
<div class="line"><a name="l01816"></a><span class="lineno"> 1816</span>  </div>
<div class="line"><a name="l01817"></a><span class="lineno"> 1817</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l01818"></a><span class="lineno"> 1818</span>  </div>
<div class="line"><a name="l01819"></a><span class="lineno"> 1819</span>  <a class="code" href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731">applyParamNamedPhaseFunc</a>(quregVec, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams);</div>
<div class="line"><a name="l01820"></a><span class="lineno"> 1820</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l01821"></a><span class="lineno"> 1821</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l01822"></a><span class="lineno"> 1822</span>  }</div>
<div class="line"><a name="l01823"></a><span class="lineno"> 1823</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01824"></a><span class="lineno"> 1824</span>  </div>
<div class="line"><a name="l01825"></a><span class="lineno"> 1825</span>  <a class="code" href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731">applyParamNamedPhaseFunc</a>(quregMatr, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams);</div>
<div class="line"><a name="l01826"></a><span class="lineno"> 1826</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l01827"></a><span class="lineno"> 1827</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l01828"></a><span class="lineno"> 1828</span>  }</div>
<div class="line"><a name="l01829"></a><span class="lineno"> 1829</span>  }</div>
<div class="line"><a name="l01830"></a><span class="lineno"> 1830</span>  SECTION( <span class="stringliteral">"INVERSE_DISTANCE"</span> ) {</div>
<div class="line"><a name="l01831"></a><span class="lineno"> 1831</span>  </div>
<div class="line"><a name="l01832"></a><span class="lineno"> 1832</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a6313e6ff48163c11c47866c4fda4bfa0">INVERSE_DISTANCE</a>;</div>
<div class="line"><a name="l01833"></a><span class="lineno"> 1833</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> divPhase = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>( -4, 4 );</div>
<div class="line"><a name="l01834"></a><span class="lineno"> 1834</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> params[] = {divPhase};</div>
<div class="line"><a name="l01835"></a><span class="lineno"> 1835</span>  <span class="keywordtype">int</span> numParams = 1;</div>
<div class="line"><a name="l01836"></a><span class="lineno"> 1836</span>  </div>
<div class="line"><a name="l01837"></a><span class="lineno"> 1837</span>  <span class="comment">// test only if there are an even number of registers</span></div>
<div class="line"><a name="l01838"></a><span class="lineno"> 1838</span>  <span class="keywordflow">if</span> (numRegs%2 == 0) {</div>
<div class="line"><a name="l01839"></a><span class="lineno"> 1839</span>  </div>
<div class="line"><a name="l01840"></a><span class="lineno"> 1840</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<diagMatr.size(); i++) {</div>
<div class="line"><a name="l01841"></a><span class="lineno"> 1841</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> phase = 0;</div>
<div class="line"><a name="l01842"></a><span class="lineno"> 1842</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r+=2)</div>
<div class="line"><a name="l01843"></a><span class="lineno"> 1843</span>  phase += pow(regVals[i][r+1]-regVals[i][r], 2);</div>
<div class="line"><a name="l01844"></a><span class="lineno"> 1844</span>  phase = (phase == 0.)? divPhase : 1./sqrt(phase);</div>
<div class="line"><a name="l01845"></a><span class="lineno"> 1845</span>  diagMatr[i][i] = <a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(phase);</div>
<div class="line"><a name="l01846"></a><span class="lineno"> 1846</span>  }</div>
<div class="line"><a name="l01847"></a><span class="lineno"> 1847</span>  }</div>
<div class="line"><a name="l01848"></a><span class="lineno"> 1848</span>  </div>
<div class="line"><a name="l01849"></a><span class="lineno"> 1849</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l01850"></a><span class="lineno"> 1850</span>  </div>
<div class="line"><a name="l01851"></a><span class="lineno"> 1851</span>  <span class="keywordflow">if</span> (numRegs%2 == 0) {</div>
<div class="line"><a name="l01852"></a><span class="lineno"> 1852</span>  <a class="code" href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731">applyParamNamedPhaseFunc</a>(quregVec, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams);</div>
<div class="line"><a name="l01853"></a><span class="lineno"> 1853</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l01854"></a><span class="lineno"> 1854</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l01855"></a><span class="lineno"> 1855</span>  }</div>
<div class="line"><a name="l01856"></a><span class="lineno"> 1856</span>  }</div>
<div class="line"><a name="l01857"></a><span class="lineno"> 1857</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01858"></a><span class="lineno"> 1858</span>  </div>
<div class="line"><a name="l01859"></a><span class="lineno"> 1859</span>  <span class="keywordflow">if</span> (numRegs%2 == 0) {</div>
<div class="line"><a name="l01860"></a><span class="lineno"> 1860</span>  <a class="code" href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731">applyParamNamedPhaseFunc</a>(quregMatr, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams);</div>
<div class="line"><a name="l01861"></a><span class="lineno"> 1861</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l01862"></a><span class="lineno"> 1862</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l01863"></a><span class="lineno"> 1863</span>  }</div>
<div class="line"><a name="l01864"></a><span class="lineno"> 1864</span>  }</div>
<div class="line"><a name="l01865"></a><span class="lineno"> 1865</span>  }</div>
<div class="line"><a name="l01866"></a><span class="lineno"> 1866</span>  SECTION( <span class="stringliteral">"SCALED_DISTANCE"</span> ) {</div>
<div class="line"><a name="l01867"></a><span class="lineno"> 1867</span>  </div>
<div class="line"><a name="l01868"></a><span class="lineno"> 1868</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ace23d4b924240a245d83193f0ce398d4">SCALED_DISTANCE</a>;</div>
<div class="line"><a name="l01869"></a><span class="lineno"> 1869</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeff = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>( -10, 10 );</div>
<div class="line"><a name="l01870"></a><span class="lineno"> 1870</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> params[] = {coeff};</div>
<div class="line"><a name="l01871"></a><span class="lineno"> 1871</span>  <span class="keywordtype">int</span> numParams = 1;</div>
<div class="line"><a name="l01872"></a><span class="lineno"> 1872</span>  </div>
<div class="line"><a name="l01873"></a><span class="lineno"> 1873</span>  <span class="comment">// test only if there are an even number of registers</span></div>
<div class="line"><a name="l01874"></a><span class="lineno"> 1874</span>  <span class="keywordflow">if</span> (numRegs%2 == 0) {</div>
<div class="line"><a name="l01875"></a><span class="lineno"> 1875</span>  </div>
<div class="line"><a name="l01876"></a><span class="lineno"> 1876</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<diagMatr.size(); i++) {</div>
<div class="line"><a name="l01877"></a><span class="lineno"> 1877</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> phase = 0;</div>
<div class="line"><a name="l01878"></a><span class="lineno"> 1878</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r+=2)</div>
<div class="line"><a name="l01879"></a><span class="lineno"> 1879</span>  phase += pow(regVals[i][r+1]-regVals[i][r], 2);</div>
<div class="line"><a name="l01880"></a><span class="lineno"> 1880</span>  phase = coeff * sqrt(phase);</div>
<div class="line"><a name="l01881"></a><span class="lineno"> 1881</span>  diagMatr[i][i] = <a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(phase);</div>
<div class="line"><a name="l01882"></a><span class="lineno"> 1882</span>  }</div>
<div class="line"><a name="l01883"></a><span class="lineno"> 1883</span>  }</div>
<div class="line"><a name="l01884"></a><span class="lineno"> 1884</span>  </div>
<div class="line"><a name="l01885"></a><span class="lineno"> 1885</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l01886"></a><span class="lineno"> 1886</span>  </div>
<div class="line"><a name="l01887"></a><span class="lineno"> 1887</span>  <span class="keywordflow">if</span> (numRegs%2 == 0) {</div>
<div class="line"><a name="l01888"></a><span class="lineno"> 1888</span>  <a class="code" href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731">applyParamNamedPhaseFunc</a>(quregVec, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams);</div>
<div class="line"><a name="l01889"></a><span class="lineno"> 1889</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l01890"></a><span class="lineno"> 1890</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l01891"></a><span class="lineno"> 1891</span>  }</div>
<div class="line"><a name="l01892"></a><span class="lineno"> 1892</span>  }</div>
<div class="line"><a name="l01893"></a><span class="lineno"> 1893</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01894"></a><span class="lineno"> 1894</span>  </div>
<div class="line"><a name="l01895"></a><span class="lineno"> 1895</span>  <span class="keywordflow">if</span> (numRegs%2 == 0) {</div>
<div class="line"><a name="l01896"></a><span class="lineno"> 1896</span>  <a class="code" href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731">applyParamNamedPhaseFunc</a>(quregMatr, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams);</div>
<div class="line"><a name="l01897"></a><span class="lineno"> 1897</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l01898"></a><span class="lineno"> 1898</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l01899"></a><span class="lineno"> 1899</span>  }</div>
<div class="line"><a name="l01900"></a><span class="lineno"> 1900</span>  }</div>
<div class="line"><a name="l01901"></a><span class="lineno"> 1901</span>  }</div>
<div class="line"><a name="l01902"></a><span class="lineno"> 1902</span>  SECTION( <span class="stringliteral">"SCALED_INVERSE_DISTANCE"</span> ) {</div>
<div class="line"><a name="l01903"></a><span class="lineno"> 1903</span>  </div>
<div class="line"><a name="l01904"></a><span class="lineno"> 1904</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae5114537389194302c7a619e35e6e227">SCALED_INVERSE_DISTANCE</a>;</div>
<div class="line"><a name="l01905"></a><span class="lineno"> 1905</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeff = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>( -10, 10 );</div>
<div class="line"><a name="l01906"></a><span class="lineno"> 1906</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> divPhase = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>( -4, 4 );</div>
<div class="line"><a name="l01907"></a><span class="lineno"> 1907</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> params[] = {coeff, divPhase};</div>
<div class="line"><a name="l01908"></a><span class="lineno"> 1908</span>  <span class="keywordtype">int</span> numParams = 2;</div>
<div class="line"><a name="l01909"></a><span class="lineno"> 1909</span>  </div>
<div class="line"><a name="l01910"></a><span class="lineno"> 1910</span>  <span class="comment">// test only if there are an even number of registers</span></div>
<div class="line"><a name="l01911"></a><span class="lineno"> 1911</span>  <span class="keywordflow">if</span> (numRegs%2 == 0) {</div>
<div class="line"><a name="l01912"></a><span class="lineno"> 1912</span>  </div>
<div class="line"><a name="l01913"></a><span class="lineno"> 1913</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<diagMatr.size(); i++) {</div>
<div class="line"><a name="l01914"></a><span class="lineno"> 1914</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> phase = 0;</div>
<div class="line"><a name="l01915"></a><span class="lineno"> 1915</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r+=2)</div>
<div class="line"><a name="l01916"></a><span class="lineno"> 1916</span>  phase += pow(regVals[i][r+1]-regVals[i][r], 2);</div>
<div class="line"><a name="l01917"></a><span class="lineno"> 1917</span>  phase = (phase == 0.)? divPhase : coeff/sqrt(phase);</div>
<div class="line"><a name="l01918"></a><span class="lineno"> 1918</span>  diagMatr[i][i] = <a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(phase);</div>
<div class="line"><a name="l01919"></a><span class="lineno"> 1919</span>  }</div>
<div class="line"><a name="l01920"></a><span class="lineno"> 1920</span>  }</div>
<div class="line"><a name="l01921"></a><span class="lineno"> 1921</span>  </div>
<div class="line"><a name="l01922"></a><span class="lineno"> 1922</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l01923"></a><span class="lineno"> 1923</span>  </div>
<div class="line"><a name="l01924"></a><span class="lineno"> 1924</span>  <span class="keywordflow">if</span> (numRegs%2 == 0) {</div>
<div class="line"><a name="l01925"></a><span class="lineno"> 1925</span>  <a class="code" href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731">applyParamNamedPhaseFunc</a>(quregVec, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams);</div>
<div class="line"><a name="l01926"></a><span class="lineno"> 1926</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l01927"></a><span class="lineno"> 1927</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l01928"></a><span class="lineno"> 1928</span>  }</div>
<div class="line"><a name="l01929"></a><span class="lineno"> 1929</span>  }</div>
<div class="line"><a name="l01930"></a><span class="lineno"> 1930</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01931"></a><span class="lineno"> 1931</span>  </div>
<div class="line"><a name="l01932"></a><span class="lineno"> 1932</span>  <span class="keywordflow">if</span> (numRegs%2 == 0) {</div>
<div class="line"><a name="l01933"></a><span class="lineno"> 1933</span>  <a class="code" href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731">applyParamNamedPhaseFunc</a>(quregMatr, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams);</div>
<div class="line"><a name="l01934"></a><span class="lineno"> 1934</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l01935"></a><span class="lineno"> 1935</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l01936"></a><span class="lineno"> 1936</span>  }</div>
<div class="line"><a name="l01937"></a><span class="lineno"> 1937</span>  }</div>
<div class="line"><a name="l01938"></a><span class="lineno"> 1938</span>  }</div>
<div class="line"><a name="l01939"></a><span class="lineno"> 1939</span>  SECTION( <span class="stringliteral">"SCALED_INVERSE_SHIFTED_DISTANCE"</span> ) {</div>
<div class="line"><a name="l01940"></a><span class="lineno"> 1940</span>  </div>
<div class="line"><a name="l01941"></a><span class="lineno"> 1941</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a39111120b79016d6b3e773b711fa63f7">SCALED_INVERSE_SHIFTED_DISTANCE</a>;</div>
<div class="line"><a name="l01942"></a><span class="lineno"> 1942</span>  <span class="keywordtype">int</span> numParams = 2 + numRegs/2;</div>
<div class="line"><a name="l01943"></a><span class="lineno"> 1943</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> params[numParams];</div>
<div class="line"><a name="l01944"></a><span class="lineno"> 1944</span>  </div>
<div class="line"><a name="l01945"></a><span class="lineno"> 1945</span>  <span class="comment">// test only if there are an even number of registers</span></div>
<div class="line"><a name="l01946"></a><span class="lineno"> 1946</span>  <span class="keywordflow">if</span> (numRegs%2 == 0) {</div>
<div class="line"><a name="l01947"></a><span class="lineno"> 1947</span>  </div>
<div class="line"><a name="l01948"></a><span class="lineno"> 1948</span>  params[0] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>( -10, 10 ); <span class="comment">// scaling</span></div>
<div class="line"><a name="l01949"></a><span class="lineno"> 1949</span>  params[1] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>( -4, 4 ); <span class="comment">// divergence override</span></div>
<div class="line"><a name="l01950"></a><span class="lineno"> 1950</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs/2; r++)</div>
<div class="line"><a name="l01951"></a><span class="lineno"> 1951</span>  params[2+r] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>( -8, 8 ); <span class="comment">// shifts</span></div>
<div class="line"><a name="l01952"></a><span class="lineno"> 1952</span>  </div>
<div class="line"><a name="l01953"></a><span class="lineno"> 1953</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<diagMatr.size(); i++) {</div>
<div class="line"><a name="l01954"></a><span class="lineno"> 1954</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> phase = 0;</div>
<div class="line"><a name="l01955"></a><span class="lineno"> 1955</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r+=2)</div>
<div class="line"><a name="l01956"></a><span class="lineno"> 1956</span>  phase += pow(regVals[i][r]-regVals[i][r+1]-params[2+r/2], 2);</div>
<div class="line"><a name="l01957"></a><span class="lineno"> 1957</span>  phase = sqrt(phase);</div>
<div class="line"><a name="l01958"></a><span class="lineno"> 1958</span>  phase = (phase <= REAL_EPS)? params[1] : params[0]/phase;</div>
<div class="line"><a name="l01959"></a><span class="lineno"> 1959</span>  diagMatr[i][i] = <a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(phase);</div>
<div class="line"><a name="l01960"></a><span class="lineno"> 1960</span>  }</div>
<div class="line"><a name="l01961"></a><span class="lineno"> 1961</span>  }</div>
<div class="line"><a name="l01962"></a><span class="lineno"> 1962</span>  </div>
<div class="line"><a name="l01963"></a><span class="lineno"> 1963</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l01964"></a><span class="lineno"> 1964</span>  </div>
<div class="line"><a name="l01965"></a><span class="lineno"> 1965</span>  <span class="keywordflow">if</span> (numRegs%2 == 0) {</div>
<div class="line"><a name="l01966"></a><span class="lineno"> 1966</span>  <a class="code" href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731">applyParamNamedPhaseFunc</a>(quregVec, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams);</div>
<div class="line"><a name="l01967"></a><span class="lineno"> 1967</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l01968"></a><span class="lineno"> 1968</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l01969"></a><span class="lineno"> 1969</span>  }</div>
<div class="line"><a name="l01970"></a><span class="lineno"> 1970</span>  }</div>
<div class="line"><a name="l01971"></a><span class="lineno"> 1971</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01972"></a><span class="lineno"> 1972</span>  </div>
<div class="line"><a name="l01973"></a><span class="lineno"> 1973</span>  <span class="keywordflow">if</span> (numRegs%2 == 0) {</div>
<div class="line"><a name="l01974"></a><span class="lineno"> 1974</span>  <a class="code" href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731">applyParamNamedPhaseFunc</a>(quregMatr, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams);</div>
<div class="line"><a name="l01975"></a><span class="lineno"> 1975</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l01976"></a><span class="lineno"> 1976</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l01977"></a><span class="lineno"> 1977</span>  }</div>
<div class="line"><a name="l01978"></a><span class="lineno"> 1978</span>  }</div>
<div class="line"><a name="l01979"></a><span class="lineno"> 1979</span>  }</div>
<div class="line"><a name="l01980"></a><span class="lineno"> 1980</span>  }</div>
<div class="line"><a name="l01981"></a><span class="lineno"> 1981</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l01982"></a><span class="lineno"> 1982</span>  </div>
<div class="line"><a name="l01983"></a><span class="lineno"> 1983</span>  <span class="keywordtype">int</span> numRegs = 2;</div>
<div class="line"><a name="l01984"></a><span class="lineno"> 1984</span>  <span class="keywordtype">int</span> numQubitsPerReg[] = {2,3};</div>
<div class="line"><a name="l01985"></a><span class="lineno"> 1985</span>  <span class="keywordtype">int</span> regs[] = {0,1,2,3,4};</div>
<div class="line"><a name="l01986"></a><span class="lineno"> 1986</span>  </div>
<div class="line"><a name="l01987"></a><span class="lineno"> 1987</span>  SECTION( <span class="stringliteral">"number of registers"</span> ) {</div>
<div class="line"><a name="l01988"></a><span class="lineno"> 1988</span>  </div>
<div class="line"><a name="l01989"></a><span class="lineno"> 1989</span>  numRegs = GENERATE_COPY( -1, 0, 1+<a class="code" href="QuEST__precision_8h.html#a6698ce2a3971003a0a0289e5980d39c5">MAX_NUM_REGS_APPLY_ARBITRARY_PHASE</a> );</div>
<div class="line"><a name="l01990"></a><span class="lineno"> 1990</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731">applyParamNamedPhaseFunc</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>, NULL, 0), Contains(<span class="stringliteral">"Invalid number of qubit subregisters"</span>) );</div>
<div class="line"><a name="l01991"></a><span class="lineno"> 1991</span>  }</div>
<div class="line"><a name="l01992"></a><span class="lineno"> 1992</span>  SECTION( <span class="stringliteral">"number of qubits"</span> ) {</div>
<div class="line"><a name="l01993"></a><span class="lineno"> 1993</span>  </div>
<div class="line"><a name="l01994"></a><span class="lineno"> 1994</span>  numQubitsPerReg[GENERATE_COPY(range(0,numRegs))] = GENERATE( -1, 0, 1+<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l01995"></a><span class="lineno"> 1995</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731">applyParamNamedPhaseFunc</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>, NULL, 0), Contains(<span class="stringliteral">"Invalid number of qubits"</span>) );</div>
<div class="line"><a name="l01996"></a><span class="lineno"> 1996</span>  }</div>
<div class="line"><a name="l01997"></a><span class="lineno"> 1997</span>  SECTION( <span class="stringliteral">"repetition of qubits"</span> ) {</div>
<div class="line"><a name="l01998"></a><span class="lineno"> 1998</span>  </div>
<div class="line"><a name="l01999"></a><span class="lineno"> 1999</span>  regs[GENERATE(2,3,4)] = regs[1];</div>
<div class="line"><a name="l02000"></a><span class="lineno"> 2000</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731">applyParamNamedPhaseFunc</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>, NULL, 0), Contains(<span class="stringliteral">"The qubits must be unique"</span>) );</div>
<div class="line"><a name="l02001"></a><span class="lineno"> 2001</span>  }</div>
<div class="line"><a name="l02002"></a><span class="lineno"> 2002</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l02003"></a><span class="lineno"> 2003</span>  </div>
<div class="line"><a name="l02004"></a><span class="lineno"> 2004</span>  regs[GENERATE(range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>))] = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l02005"></a><span class="lineno"> 2005</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731">applyParamNamedPhaseFunc</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>, NULL, 0), Contains(<span class="stringliteral">"Invalid qubit index"</span>) );</div>
<div class="line"><a name="l02006"></a><span class="lineno"> 2006</span>  }</div>
<div class="line"><a name="l02007"></a><span class="lineno"> 2007</span>  SECTION( <span class="stringliteral">"bit encoding name"</span> ) {</div>
<div class="line"><a name="l02008"></a><span class="lineno"> 2008</span>  </div>
<div class="line"><a name="l02009"></a><span class="lineno"> 2009</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#ga9c91c41aa42ae537995e89ffc616afe1">bitEncoding</a> enc = (<span class="keyword">enum</span> <a class="code" href="group__type.html#ga9c91c41aa42ae537995e89ffc616afe1">bitEncoding</a>) GENERATE( -1, 2 );</div>
<div class="line"><a name="l02010"></a><span class="lineno"> 2010</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731">applyParamNamedPhaseFunc</a>(quregVec, regs, numQubitsPerReg, numRegs, enc, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>, NULL, 0), Contains(<span class="stringliteral">"Invalid bit encoding"</span>) );</div>
<div class="line"><a name="l02011"></a><span class="lineno"> 2011</span>  }</div>
<div class="line"><a name="l02012"></a><span class="lineno"> 2012</span>  SECTION( <span class="stringliteral">"two's complement register"</span> ) {</div>
<div class="line"><a name="l02013"></a><span class="lineno"> 2013</span>  </div>
<div class="line"><a name="l02014"></a><span class="lineno"> 2014</span>  numQubitsPerReg[GENERATE_COPY(range(0,numRegs))] = 1;</div>
<div class="line"><a name="l02015"></a><span class="lineno"> 2015</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731">applyParamNamedPhaseFunc</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>, NULL, 0), Contains(<span class="stringliteral">"A sub-register contained too few qubits to employ TWOS_COMPLEMENT encoding"</span>) );</div>
<div class="line"><a name="l02016"></a><span class="lineno"> 2016</span>  }</div>
<div class="line"><a name="l02017"></a><span class="lineno"> 2017</span>  SECTION( <span class="stringliteral">"phase function name"</span> ) {</div>
<div class="line"><a name="l02018"></a><span class="lineno"> 2018</span>  </div>
<div class="line"><a name="l02019"></a><span class="lineno"> 2019</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = (<span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a>) GENERATE( -1, 14 );</div>
<div class="line"><a name="l02020"></a><span class="lineno"> 2020</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731">applyParamNamedPhaseFunc</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, func, NULL, 0), Contains(<span class="stringliteral">"Invalid named phase function"</span>) );</div>
<div class="line"><a name="l02021"></a><span class="lineno"> 2021</span>  }</div>
<div class="line"><a name="l02022"></a><span class="lineno"> 2022</span>  SECTION( <span class="stringliteral">"phase function parameters"</span> ) {</div>
<div class="line"><a name="l02023"></a><span class="lineno"> 2023</span>  </div>
<div class="line"><a name="l02024"></a><span class="lineno"> 2024</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> params[numRegs + 3];</div>
<div class="line"><a name="l02025"></a><span class="lineno"> 2025</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs + 3; r++)</div>
<div class="line"><a name="l02026"></a><span class="lineno"> 2026</span>  params[r] = 0;</div>
<div class="line"><a name="l02027"></a><span class="lineno"> 2027</span>  </div>
<div class="line"><a name="l02028"></a><span class="lineno"> 2028</span>  SECTION( <span class="stringliteral">"no parameter functions"</span> ) {</div>
<div class="line"><a name="l02029"></a><span class="lineno"> 2029</span>  </div>
<div class="line"><a name="l02030"></a><span class="lineno"> 2030</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = GENERATE( <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65acb6911398e0068f545a31b82bcdef3e4">PRODUCT</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a2ad72f168181763513d7793c13bf2a91">DISTANCE</a> );</div>
<div class="line"><a name="l02031"></a><span class="lineno"> 2031</span>  <span class="keywordtype">int</span> numParams = GENERATE( -1, 1, 2 );</div>
<div class="line"><a name="l02032"></a><span class="lineno"> 2032</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731">applyParamNamedPhaseFunc</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, func, params, numParams), Contains(<span class="stringliteral">"Invalid number of parameters"</span>) );</div>
<div class="line"><a name="l02033"></a><span class="lineno"> 2033</span>  }</div>
<div class="line"><a name="l02034"></a><span class="lineno"> 2034</span>  SECTION( <span class="stringliteral">"single parameter functions"</span> ) {</div>
<div class="line"><a name="l02035"></a><span class="lineno"> 2035</span>  </div>
<div class="line"><a name="l02036"></a><span class="lineno"> 2036</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = GENERATE( <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a93c0c1e166dd43c6a57f61e5490808e1">SCALED_NORM</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ad4c32e295c08ebe224e2c5ba6497f043">INVERSE_NORM</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a31a29a30f92fe34c35098f941adbbc93">SCALED_PRODUCT</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65acb26952815118f5ced7703302dbeb556">INVERSE_PRODUCT</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ace23d4b924240a245d83193f0ce398d4">SCALED_DISTANCE</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a6313e6ff48163c11c47866c4fda4bfa0">INVERSE_DISTANCE</a> );</div>
<div class="line"><a name="l02037"></a><span class="lineno"> 2037</span>  <span class="keywordtype">int</span> numParams = GENERATE( -1, 0, 2 );</div>
<div class="line"><a name="l02038"></a><span class="lineno"> 2038</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731">applyParamNamedPhaseFunc</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, func, params, numParams), Contains(<span class="stringliteral">"Invalid number of parameters"</span>) );</div>
<div class="line"><a name="l02039"></a><span class="lineno"> 2039</span>  }</div>
<div class="line"><a name="l02040"></a><span class="lineno"> 2040</span>  SECTION( <span class="stringliteral">"two parameter functions"</span> ) { </div>
<div class="line"><a name="l02041"></a><span class="lineno"> 2041</span>  </div>
<div class="line"><a name="l02042"></a><span class="lineno"> 2042</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = GENERATE( <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae8c96906c1ec109d295c491e572d01e2">SCALED_INVERSE_NORM</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a1a5168576607f460d3e60f184575cacb">SCALED_INVERSE_PRODUCT</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae5114537389194302c7a619e35e6e227">SCALED_INVERSE_DISTANCE</a> );</div>
<div class="line"><a name="l02043"></a><span class="lineno"> 2043</span>  <span class="keywordtype">int</span> numParams = GENERATE( 0, 1, 3 );</div>
<div class="line"><a name="l02044"></a><span class="lineno"> 2044</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731">applyParamNamedPhaseFunc</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, func, params, numParams), Contains(<span class="stringliteral">"Invalid number of parameters"</span>) );</div>
<div class="line"><a name="l02045"></a><span class="lineno"> 2045</span>  }</div>
<div class="line"><a name="l02046"></a><span class="lineno"> 2046</span>  SECTION( <span class="stringliteral">"shifted distance"</span> ) {</div>
<div class="line"><a name="l02047"></a><span class="lineno"> 2047</span>  </div>
<div class="line"><a name="l02048"></a><span class="lineno"> 2048</span>  <span class="keywordflow">if</span> (numRegs%2 == 0) {</div>
<div class="line"><a name="l02049"></a><span class="lineno"> 2049</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a39111120b79016d6b3e773b711fa63f7">SCALED_INVERSE_SHIFTED_DISTANCE</a>;</div>
<div class="line"><a name="l02050"></a><span class="lineno"> 2050</span>  <span class="keywordtype">int</span> numParams = GENERATE_COPY( 0, 1, numRegs/2 - 1, numRegs/2, numRegs/2 + 1, numRegs/2 + 3 );</div>
<div class="line"><a name="l02051"></a><span class="lineno"> 2051</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731">applyParamNamedPhaseFunc</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, func, params, numParams), Contains(<span class="stringliteral">"Invalid number of parameters"</span>) );</div>
<div class="line"><a name="l02052"></a><span class="lineno"> 2052</span>  }</div>
<div class="line"><a name="l02053"></a><span class="lineno"> 2053</span>  }</div>
<div class="line"><a name="l02054"></a><span class="lineno"> 2054</span>  SECTION( <span class="stringliteral">"shifted norm"</span> ) {</div>
<div class="line"><a name="l02055"></a><span class="lineno"> 2055</span>  </div>
<div class="line"><a name="l02056"></a><span class="lineno"> 2056</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65aa318172feec5b530e9a7849f2f7b44e7">SCALED_INVERSE_SHIFTED_NORM</a>;</div>
<div class="line"><a name="l02057"></a><span class="lineno"> 2057</span>  <span class="keywordtype">int</span> numParams = GENERATE_COPY( 0, 1, numRegs-1, numRegs, numRegs+1, numRegs+3 );</div>
<div class="line"><a name="l02058"></a><span class="lineno"> 2058</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731">applyParamNamedPhaseFunc</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, func, params, numParams), Contains(<span class="stringliteral">"Invalid number of parameters"</span>) );</div>
<div class="line"><a name="l02059"></a><span class="lineno"> 2059</span>  }</div>
<div class="line"><a name="l02060"></a><span class="lineno"> 2060</span>  }</div>
<div class="line"><a name="l02061"></a><span class="lineno"> 2061</span>  SECTION( <span class="stringliteral">"distance pair registers"</span> ) {</div>
<div class="line"><a name="l02062"></a><span class="lineno"> 2062</span>  </div>
<div class="line"><a name="l02063"></a><span class="lineno"> 2063</span>  <span class="keywordtype">int</span> numQb[] = {1,1,1,1,1};</div>
<div class="line"><a name="l02064"></a><span class="lineno"> 2064</span>  <span class="keywordtype">int</span> qb[] = {0,1,2,3,4};</div>
<div class="line"><a name="l02065"></a><span class="lineno"> 2065</span>  </div>
<div class="line"><a name="l02066"></a><span class="lineno"> 2066</span>  numRegs = GENERATE( 1, 3, 5 );</div>
<div class="line"><a name="l02067"></a><span class="lineno"> 2067</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731">applyParamNamedPhaseFunc</a>(quregVec, qb, numQb, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a2ad72f168181763513d7793c13bf2a91">DISTANCE</a>, NULL, 0), Contains(<span class="stringliteral">"Phase functions DISTANCE"</span>) && Contains(<span class="stringliteral">"even number of sub-registers"</span>) );</div>
<div class="line"><a name="l02068"></a><span class="lineno"> 2068</span>  }</div>
<div class="line"><a name="l02069"></a><span class="lineno"> 2069</span>  }</div>
<div class="line"><a name="l02070"></a><span class="lineno"> 2070</span>  <a class="code" href="test__operators_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l02071"></a><span class="lineno"> 2071</span> }</div>
<div class="line"><a name="l02072"></a><span class="lineno"> 2072</span>  </div>
<div class="line"><a name="l02073"></a><span class="lineno"> 2073</span>  </div>
<div class="line"><a name="l02074"></a><span class="lineno"> 2074</span>  </div>
<div class="line"><a name="l02079"></a><span class="lineno"><a class="line" href="group__unittest.html#gaaf0246e83a66816b2b6bfe3f6e69d376"> 2079</a></span> <a class="code" href="group__unittest.html#gaff6822e79b947a9e3b791572c674c08c">TEST_CASE</a>( <span class="stringliteral">"applyParamNamedPhaseFuncOverrides"</span>, <span class="stringliteral">"[operators]"</span> ) {</div>
<div class="line"><a name="l02080"></a><span class="lineno"> 2080</span>  </div>
<div class="line"><a name="l02081"></a><span class="lineno"> 2081</span>  <a class="code" href="test__operators_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l02082"></a><span class="lineno"> 2082</span>  </div>
<div class="line"><a name="l02083"></a><span class="lineno"> 2083</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l02084"></a><span class="lineno"> 2084</span>  </div>
<div class="line"><a name="l02085"></a><span class="lineno"> 2085</span>  <span class="comment">// try every kind of binary encoding</span></div>
<div class="line"><a name="l02086"></a><span class="lineno"> 2086</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#ga9c91c41aa42ae537995e89ffc616afe1">bitEncoding</a> encoding = GENERATE( <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>,<a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a> );</div>
<div class="line"><a name="l02087"></a><span class="lineno"> 2087</span>  </div>
<div class="line"><a name="l02088"></a><span class="lineno"> 2088</span>  <span class="comment">// try every possible number of registers </span></div>
<div class="line"><a name="l02089"></a><span class="lineno"> 2089</span>  <span class="comment">// (between #qubits containing 1, and 1 containing #qubits)</span></div>
<div class="line"><a name="l02090"></a><span class="lineno"> 2090</span>  <span class="keywordtype">int</span> numRegs;</div>
<div class="line"><a name="l02091"></a><span class="lineno"> 2091</span>  <span class="keywordtype">int</span> maxNumRegs = 0;</div>
<div class="line"><a name="l02092"></a><span class="lineno"> 2092</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>)</div>
<div class="line"><a name="l02093"></a><span class="lineno"> 2093</span>  maxNumRegs = <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>;</div>
<div class="line"><a name="l02094"></a><span class="lineno"> 2094</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>)</div>
<div class="line"><a name="l02095"></a><span class="lineno"> 2095</span>  maxNumRegs = <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>/2; <span class="comment">// floors</span></div>
<div class="line"><a name="l02096"></a><span class="lineno"> 2096</span>  numRegs = GENERATE_COPY( range(1, maxNumRegs+1) );</div>
<div class="line"><a name="l02097"></a><span class="lineno"> 2097</span>  </div>
<div class="line"><a name="l02098"></a><span class="lineno"> 2098</span>  <span class="comment">// try every possible total number of involved qubits</span></div>
<div class="line"><a name="l02099"></a><span class="lineno"> 2099</span>  <span class="keywordtype">int</span> totalNumQubits;</div>
<div class="line"><a name="l02100"></a><span class="lineno"> 2100</span>  <span class="keywordtype">int</span> minTotalQubits = 0;</div>
<div class="line"><a name="l02101"></a><span class="lineno"> 2101</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>)</div>
<div class="line"><a name="l02102"></a><span class="lineno"> 2102</span>  <span class="comment">// each register must contain at least 1 qubit</span></div>
<div class="line"><a name="l02103"></a><span class="lineno"> 2103</span>  minTotalQubits = numRegs;</div>
<div class="line"><a name="l02104"></a><span class="lineno"> 2104</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>)</div>
<div class="line"><a name="l02105"></a><span class="lineno"> 2105</span>  <span class="comment">// each register must contain at least 2 qubits</span></div>
<div class="line"><a name="l02106"></a><span class="lineno"> 2106</span>  minTotalQubits = 2*numRegs;</div>
<div class="line"><a name="l02107"></a><span class="lineno"> 2107</span>  totalNumQubits = GENERATE_COPY( range(minTotalQubits,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1) );</div>
<div class="line"><a name="l02108"></a><span class="lineno"> 2108</span>  </div>
<div class="line"><a name="l02109"></a><span class="lineno"> 2109</span>  <span class="comment">// try every qubits subset and ordering </span></div>
<div class="line"><a name="l02110"></a><span class="lineno"> 2110</span>  <span class="keywordtype">int</span>* regs = GENERATE_COPY( <a class="code" href="group__testutilities.html#ga35add15146aa606b256df79334b867d5">sublists</a>(range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>), totalNumQubits) );</div>
<div class="line"><a name="l02111"></a><span class="lineno"> 2111</span>  </div>
<div class="line"><a name="l02112"></a><span class="lineno"> 2112</span>  <span class="comment">// assign each sub-reg its minimum length</span></div>
<div class="line"><a name="l02113"></a><span class="lineno"> 2113</span>  <span class="keywordtype">int</span> unallocQubits = totalNumQubits;</div>
<div class="line"><a name="l02114"></a><span class="lineno"> 2114</span>  <span class="keywordtype">int</span> numQubitsPerReg[numRegs];</div>
<div class="line"><a name="l02115"></a><span class="lineno"> 2115</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numRegs; i++) </div>
<div class="line"><a name="l02116"></a><span class="lineno"> 2116</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>) {</div>
<div class="line"><a name="l02117"></a><span class="lineno"> 2117</span>  numQubitsPerReg[i] = 1;</div>
<div class="line"><a name="l02118"></a><span class="lineno"> 2118</span>  unallocQubits -= 1;</div>
<div class="line"><a name="l02119"></a><span class="lineno"> 2119</span>  }</div>
<div class="line"><a name="l02120"></a><span class="lineno"> 2120</span>  <span class="keywordflow">else</span> <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>) {</div>
<div class="line"><a name="l02121"></a><span class="lineno"> 2121</span>  numQubitsPerReg[i] = 2;</div>
<div class="line"><a name="l02122"></a><span class="lineno"> 2122</span>  unallocQubits -= 2;</div>
<div class="line"><a name="l02123"></a><span class="lineno"> 2123</span>  }</div>
<div class="line"><a name="l02124"></a><span class="lineno"> 2124</span>  <span class="comment">// and randomly allocate the remaining qubits between the registers</span></div>
<div class="line"><a name="l02125"></a><span class="lineno"> 2125</span>  <span class="keywordflow">while</span> (unallocQubits > 0) {</div>
<div class="line"><a name="l02126"></a><span class="lineno"> 2126</span>  numQubitsPerReg[<a class="code" href="group__testutilities.html#ga7125d0747a44db58115899727ac5f6be">getRandomInt</a>(0,numRegs)] += 1;</div>
<div class="line"><a name="l02127"></a><span class="lineno"> 2127</span>  unallocQubits--;</div>
<div class="line"><a name="l02128"></a><span class="lineno"> 2128</span>  }</div>
<div class="line"><a name="l02129"></a><span class="lineno"> 2129</span>  </div>
<div class="line"><a name="l02130"></a><span class="lineno"> 2130</span>  </div>
<div class="line"><a name="l02131"></a><span class="lineno"> 2131</span>  <span class="comment">// choose a random number of overrides (even overriding every amplitude)</span></div>
<div class="line"><a name="l02132"></a><span class="lineno"> 2132</span>  <span class="keywordtype">int</span> numOverrides = <a class="code" href="group__testutilities.html#ga7125d0747a44db58115899727ac5f6be">getRandomInt</a>(0, (1<<totalNumQubits) + 1);</div>
<div class="line"><a name="l02133"></a><span class="lineno"> 2133</span>  </div>
<div class="line"><a name="l02134"></a><span class="lineno"> 2134</span>  <span class="comment">// randomise each override index (uniqueness isn't checked)</span></div>
<div class="line"><a name="l02135"></a><span class="lineno"> 2135</span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <span class="keywordtype">int</span> overrideInds[numOverrides*numRegs];</div>
<div class="line"><a name="l02136"></a><span class="lineno"> 2136</span>  <span class="keywordtype">int</span> flatInd = 0;</div>
<div class="line"><a name="l02137"></a><span class="lineno"> 2137</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> v=0; v<numOverrides; v++) {</div>
<div class="line"><a name="l02138"></a><span class="lineno"> 2138</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r++) {</div>
<div class="line"><a name="l02139"></a><span class="lineno"> 2139</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>)</div>
<div class="line"><a name="l02140"></a><span class="lineno"> 2140</span>  overrideInds[flatInd] = <a class="code" href="group__testutilities.html#ga7125d0747a44db58115899727ac5f6be">getRandomInt</a>(0, 1<<numQubitsPerReg[r]);</div>
<div class="line"><a name="l02141"></a><span class="lineno"> 2141</span>  <span class="keywordflow">else</span> <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>) </div>
<div class="line"><a name="l02142"></a><span class="lineno"> 2142</span>  overrideInds[flatInd] = <a class="code" href="group__testutilities.html#ga7125d0747a44db58115899727ac5f6be">getRandomInt</a>(-(1<<(numQubitsPerReg[r]-1)), (1<<(numQubitsPerReg[r]-1))-1);</div>
<div class="line"><a name="l02143"></a><span class="lineno"> 2143</span>  flatInd++;</div>
<div class="line"><a name="l02144"></a><span class="lineno"> 2144</span>  }</div>
<div class="line"><a name="l02145"></a><span class="lineno"> 2145</span>  }</div>
<div class="line"><a name="l02146"></a><span class="lineno"> 2146</span>  </div>
<div class="line"><a name="l02147"></a><span class="lineno"> 2147</span>  <span class="comment">// override to a random phase</span></div>
<div class="line"><a name="l02148"></a><span class="lineno"> 2148</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> overridePhases[numOverrides];</div>
<div class="line"><a name="l02149"></a><span class="lineno"> 2149</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> v=0; v<numOverrides; v++)</div>
<div class="line"><a name="l02150"></a><span class="lineno"> 2150</span>  overridePhases[v] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-4, 4); <span class="comment">// periodic in [-pi, pi]</span></div>
<div class="line"><a name="l02151"></a><span class="lineno"> 2151</span>  </div>
<div class="line"><a name="l02152"></a><span class="lineno"> 2152</span>  </div>
<div class="line"><a name="l02153"></a><span class="lineno"> 2153</span>  <span class="comment">// determine the values corresponding to each register for all basis states</span></div>
<div class="line"><a name="l02154"></a><span class="lineno"> 2154</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> regVals[1<<totalNumQubits][numRegs];</div>
<div class="line"><a name="l02155"></a><span class="lineno"> 2155</span>  <span class="keywordflow">for</span> (<span class="keywordtype">long</span> <span class="keywordtype">long</span> <span class="keywordtype">int</span> i=0; i<(1<<totalNumQubits); i++) {</div>
<div class="line"><a name="l02156"></a><span class="lineno"> 2156</span>  </div>
<div class="line"><a name="l02157"></a><span class="lineno"> 2157</span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <span class="keywordtype">int</span> bits = i;</div>
<div class="line"><a name="l02158"></a><span class="lineno"> 2158</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r++) { </div>
<div class="line"><a name="l02159"></a><span class="lineno"> 2159</span>  regVals[i][r] = bits % (1 << numQubitsPerReg[r]);</div>
<div class="line"><a name="l02160"></a><span class="lineno"> 2160</span>  bits = bits >> numQubitsPerReg[r];</div>
<div class="line"><a name="l02161"></a><span class="lineno"> 2161</span>  </div>
<div class="line"><a name="l02162"></a><span class="lineno"> 2162</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>)</div>
<div class="line"><a name="l02163"></a><span class="lineno"> 2163</span>  regVals[i][r] = <a class="code" href="group__testutilities.html#ga49be3b32f7b7a274fc5ecb209fde1189">getTwosComplement</a>(regVals[i][r], numQubitsPerReg[r]);</div>
<div class="line"><a name="l02164"></a><span class="lineno"> 2164</span>  }</div>
<div class="line"><a name="l02165"></a><span class="lineno"> 2165</span>  }</div>
<div class="line"><a name="l02166"></a><span class="lineno"> 2166</span>  </div>
<div class="line"><a name="l02167"></a><span class="lineno"> 2167</span>  <span class="comment">/* produce a reference diagonal matrix which assumes the qubits are</span></div>
<div class="line"><a name="l02168"></a><span class="lineno"> 2168</span> <span class="comment"> * contiguous and strictly increasing between the registers, and hence </span></div>
<div class="line"><a name="l02169"></a><span class="lineno"> 2169</span> <span class="comment"> * only depends on the number of qubits in each register.</span></div>
<div class="line"><a name="l02170"></a><span class="lineno"> 2170</span> <span class="comment"> */</span></div>
<div class="line"><a name="l02171"></a><span class="lineno"> 2171</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> diagMatr = <a class="code" href="group__testutilities.html#ga6ccbb15b0f234e926be96a153181b63a">getZeroMatrix</a>(1 << totalNumQubits);</div>
<div class="line"><a name="l02172"></a><span class="lineno"> 2172</span>  </div>
<div class="line"><a name="l02173"></a><span class="lineno"> 2173</span>  </div>
<div class="line"><a name="l02174"></a><span class="lineno"> 2174</span>  SECTION( <span class="stringliteral">"INVERSE_NORM"</span> ) {</div>
<div class="line"><a name="l02175"></a><span class="lineno"> 2175</span>  </div>
<div class="line"><a name="l02176"></a><span class="lineno"> 2176</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ad4c32e295c08ebe224e2c5ba6497f043">INVERSE_NORM</a>;</div>
<div class="line"><a name="l02177"></a><span class="lineno"> 2177</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> divPhase = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-4, 4);</div>
<div class="line"><a name="l02178"></a><span class="lineno"> 2178</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> params[] = {divPhase};</div>
<div class="line"><a name="l02179"></a><span class="lineno"> 2179</span>  <span class="keywordtype">int</span> numParams = 1;</div>
<div class="line"><a name="l02180"></a><span class="lineno"> 2180</span>  </div>
<div class="line"><a name="l02181"></a><span class="lineno"> 2181</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<diagMatr.size(); i++) {</div>
<div class="line"><a name="l02182"></a><span class="lineno"> 2182</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> phase = 0;</div>
<div class="line"><a name="l02183"></a><span class="lineno"> 2183</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r++)</div>
<div class="line"><a name="l02184"></a><span class="lineno"> 2184</span>  phase += pow(regVals[i][r], 2);</div>
<div class="line"><a name="l02185"></a><span class="lineno"> 2185</span>  phase = (phase == 0.)? divPhase : 1/sqrt(phase);</div>
<div class="line"><a name="l02186"></a><span class="lineno"> 2186</span>  diagMatr[i][i] = <a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(phase);</div>
<div class="line"><a name="l02187"></a><span class="lineno"> 2187</span>  }</div>
<div class="line"><a name="l02188"></a><span class="lineno"> 2188</span>  <a class="code" href="group__testutilities.html#gaf57b4b82c98e98918f74476741f60e37">setDiagMatrixOverrides</a>(diagMatr, numQubitsPerReg, numRegs, encoding, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l02189"></a><span class="lineno"> 2189</span>  </div>
<div class="line"><a name="l02190"></a><span class="lineno"> 2190</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l02191"></a><span class="lineno"> 2191</span>  </div>
<div class="line"><a name="l02192"></a><span class="lineno"> 2192</span>  <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l02193"></a><span class="lineno"> 2193</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l02194"></a><span class="lineno"> 2194</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l02195"></a><span class="lineno"> 2195</span>  }</div>
<div class="line"><a name="l02196"></a><span class="lineno"> 2196</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l02197"></a><span class="lineno"> 2197</span>  </div>
<div class="line"><a name="l02198"></a><span class="lineno"> 2198</span>  <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregMatr, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l02199"></a><span class="lineno"> 2199</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l02200"></a><span class="lineno"> 2200</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l02201"></a><span class="lineno"> 2201</span>  }</div>
<div class="line"><a name="l02202"></a><span class="lineno"> 2202</span>  }</div>
<div class="line"><a name="l02203"></a><span class="lineno"> 2203</span>  SECTION( <span class="stringliteral">"SCALED_NORM"</span> ) {</div>
<div class="line"><a name="l02204"></a><span class="lineno"> 2204</span>  </div>
<div class="line"><a name="l02205"></a><span class="lineno"> 2205</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a93c0c1e166dd43c6a57f61e5490808e1">SCALED_NORM</a>;</div>
<div class="line"><a name="l02206"></a><span class="lineno"> 2206</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeff = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-10, 10);</div>
<div class="line"><a name="l02207"></a><span class="lineno"> 2207</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> params[] = {coeff};</div>
<div class="line"><a name="l02208"></a><span class="lineno"> 2208</span>  <span class="keywordtype">int</span> numParams = 1;</div>
<div class="line"><a name="l02209"></a><span class="lineno"> 2209</span>  </div>
<div class="line"><a name="l02210"></a><span class="lineno"> 2210</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<diagMatr.size(); i++) {</div>
<div class="line"><a name="l02211"></a><span class="lineno"> 2211</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> phase = 0;</div>
<div class="line"><a name="l02212"></a><span class="lineno"> 2212</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r++)</div>
<div class="line"><a name="l02213"></a><span class="lineno"> 2213</span>  phase += pow(regVals[i][r], 2);</div>
<div class="line"><a name="l02214"></a><span class="lineno"> 2214</span>  phase = coeff * sqrt(phase);</div>
<div class="line"><a name="l02215"></a><span class="lineno"> 2215</span>  diagMatr[i][i] = <a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(phase);</div>
<div class="line"><a name="l02216"></a><span class="lineno"> 2216</span>  }</div>
<div class="line"><a name="l02217"></a><span class="lineno"> 2217</span>  <a class="code" href="group__testutilities.html#gaf57b4b82c98e98918f74476741f60e37">setDiagMatrixOverrides</a>(diagMatr, numQubitsPerReg, numRegs, encoding, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l02218"></a><span class="lineno"> 2218</span>  </div>
<div class="line"><a name="l02219"></a><span class="lineno"> 2219</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l02220"></a><span class="lineno"> 2220</span>  </div>
<div class="line"><a name="l02221"></a><span class="lineno"> 2221</span>  <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l02222"></a><span class="lineno"> 2222</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l02223"></a><span class="lineno"> 2223</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l02224"></a><span class="lineno"> 2224</span>  }</div>
<div class="line"><a name="l02225"></a><span class="lineno"> 2225</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l02226"></a><span class="lineno"> 2226</span>  </div>
<div class="line"><a name="l02227"></a><span class="lineno"> 2227</span>  <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregMatr, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l02228"></a><span class="lineno"> 2228</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l02229"></a><span class="lineno"> 2229</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l02230"></a><span class="lineno"> 2230</span>  }</div>
<div class="line"><a name="l02231"></a><span class="lineno"> 2231</span>  }</div>
<div class="line"><a name="l02232"></a><span class="lineno"> 2232</span>  SECTION( <span class="stringliteral">"SCALED_INVERSE_NORM"</span> ) {</div>
<div class="line"><a name="l02233"></a><span class="lineno"> 2233</span>  </div>
<div class="line"><a name="l02234"></a><span class="lineno"> 2234</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae8c96906c1ec109d295c491e572d01e2">SCALED_INVERSE_NORM</a>;</div>
<div class="line"><a name="l02235"></a><span class="lineno"> 2235</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeff = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-10, 10);</div>
<div class="line"><a name="l02236"></a><span class="lineno"> 2236</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> divPhase = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-4, 4);</div>
<div class="line"><a name="l02237"></a><span class="lineno"> 2237</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> params[] = {coeff, divPhase};</div>
<div class="line"><a name="l02238"></a><span class="lineno"> 2238</span>  <span class="keywordtype">int</span> numParams = 2;</div>
<div class="line"><a name="l02239"></a><span class="lineno"> 2239</span>  </div>
<div class="line"><a name="l02240"></a><span class="lineno"> 2240</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<diagMatr.size(); i++) {</div>
<div class="line"><a name="l02241"></a><span class="lineno"> 2241</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> phase = 0;</div>
<div class="line"><a name="l02242"></a><span class="lineno"> 2242</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r++)</div>
<div class="line"><a name="l02243"></a><span class="lineno"> 2243</span>  phase += pow(regVals[i][r], 2);</div>
<div class="line"><a name="l02244"></a><span class="lineno"> 2244</span>  phase = (phase == 0.)? divPhase : coeff/sqrt(phase);</div>
<div class="line"><a name="l02245"></a><span class="lineno"> 2245</span>  diagMatr[i][i] = <a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(phase);</div>
<div class="line"><a name="l02246"></a><span class="lineno"> 2246</span>  }</div>
<div class="line"><a name="l02247"></a><span class="lineno"> 2247</span>  <a class="code" href="group__testutilities.html#gaf57b4b82c98e98918f74476741f60e37">setDiagMatrixOverrides</a>(diagMatr, numQubitsPerReg, numRegs, encoding, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l02248"></a><span class="lineno"> 2248</span>  </div>
<div class="line"><a name="l02249"></a><span class="lineno"> 2249</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l02250"></a><span class="lineno"> 2250</span>  </div>
<div class="line"><a name="l02251"></a><span class="lineno"> 2251</span>  <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l02252"></a><span class="lineno"> 2252</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l02253"></a><span class="lineno"> 2253</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l02254"></a><span class="lineno"> 2254</span>  }</div>
<div class="line"><a name="l02255"></a><span class="lineno"> 2255</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l02256"></a><span class="lineno"> 2256</span>  </div>
<div class="line"><a name="l02257"></a><span class="lineno"> 2257</span>  <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregMatr, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l02258"></a><span class="lineno"> 2258</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l02259"></a><span class="lineno"> 2259</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l02260"></a><span class="lineno"> 2260</span>  }</div>
<div class="line"><a name="l02261"></a><span class="lineno"> 2261</span>  }</div>
<div class="line"><a name="l02262"></a><span class="lineno"> 2262</span>  SECTION( <span class="stringliteral">"SCALED_INVERSE_SHIFTED_NORM"</span> ) {</div>
<div class="line"><a name="l02263"></a><span class="lineno"> 2263</span>  </div>
<div class="line"><a name="l02264"></a><span class="lineno"> 2264</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65aa318172feec5b530e9a7849f2f7b44e7">SCALED_INVERSE_SHIFTED_NORM</a>;</div>
<div class="line"><a name="l02265"></a><span class="lineno"> 2265</span>  <span class="keywordtype">int</span> numParams = 2 + numRegs;</div>
<div class="line"><a name="l02266"></a><span class="lineno"> 2266</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> params[numParams];</div>
<div class="line"><a name="l02267"></a><span class="lineno"> 2267</span>  params[0] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-10, 10); <span class="comment">// scaling</span></div>
<div class="line"><a name="l02268"></a><span class="lineno"> 2268</span>  params[1] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-4, 4); <span class="comment">// divergence override</span></div>
<div class="line"><a name="l02269"></a><span class="lineno"> 2269</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r++)</div>
<div class="line"><a name="l02270"></a><span class="lineno"> 2270</span>  params[2+r] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-8, 8); <span class="comment">// shifts</span></div>
<div class="line"><a name="l02271"></a><span class="lineno"> 2271</span>  </div>
<div class="line"><a name="l02272"></a><span class="lineno"> 2272</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<diagMatr.size(); i++) {</div>
<div class="line"><a name="l02273"></a><span class="lineno"> 2273</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> phase = 0;</div>
<div class="line"><a name="l02274"></a><span class="lineno"> 2274</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r++)</div>
<div class="line"><a name="l02275"></a><span class="lineno"> 2275</span>  phase += pow(regVals[i][r] - params[2+r], 2);</div>
<div class="line"><a name="l02276"></a><span class="lineno"> 2276</span>  phase = sqrt(phase);</div>
<div class="line"><a name="l02277"></a><span class="lineno"> 2277</span>  phase = (phase <= REAL_EPS)? params[1] : params[0]/phase;</div>
<div class="line"><a name="l02278"></a><span class="lineno"> 2278</span>  diagMatr[i][i] = <a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(phase);</div>
<div class="line"><a name="l02279"></a><span class="lineno"> 2279</span>  }</div>
<div class="line"><a name="l02280"></a><span class="lineno"> 2280</span>  <a class="code" href="group__testutilities.html#gaf57b4b82c98e98918f74476741f60e37">setDiagMatrixOverrides</a>(diagMatr, numQubitsPerReg, numRegs, encoding, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l02281"></a><span class="lineno"> 2281</span>  </div>
<div class="line"><a name="l02282"></a><span class="lineno"> 2282</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l02283"></a><span class="lineno"> 2283</span>  </div>
<div class="line"><a name="l02284"></a><span class="lineno"> 2284</span>  <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l02285"></a><span class="lineno"> 2285</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l02286"></a><span class="lineno"> 2286</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l02287"></a><span class="lineno"> 2287</span>  }</div>
<div class="line"><a name="l02288"></a><span class="lineno"> 2288</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l02289"></a><span class="lineno"> 2289</span>  </div>
<div class="line"><a name="l02290"></a><span class="lineno"> 2290</span>  <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregMatr, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l02291"></a><span class="lineno"> 2291</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l02292"></a><span class="lineno"> 2292</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l02293"></a><span class="lineno"> 2293</span>  }</div>
<div class="line"><a name="l02294"></a><span class="lineno"> 2294</span>  } </div>
<div class="line"><a name="l02295"></a><span class="lineno"> 2295</span>  SECTION( <span class="stringliteral">"INVERSE_PRODUCT"</span> ) {</div>
<div class="line"><a name="l02296"></a><span class="lineno"> 2296</span>  </div>
<div class="line"><a name="l02297"></a><span class="lineno"> 2297</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65acb26952815118f5ced7703302dbeb556">INVERSE_PRODUCT</a>;</div>
<div class="line"><a name="l02298"></a><span class="lineno"> 2298</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> divPhase = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-4, 4);</div>
<div class="line"><a name="l02299"></a><span class="lineno"> 2299</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> params[] = {divPhase};</div>
<div class="line"><a name="l02300"></a><span class="lineno"> 2300</span>  <span class="keywordtype">int</span> numParams = 1;</div>
<div class="line"><a name="l02301"></a><span class="lineno"> 2301</span>  </div>
<div class="line"><a name="l02302"></a><span class="lineno"> 2302</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<diagMatr.size(); i++) {</div>
<div class="line"><a name="l02303"></a><span class="lineno"> 2303</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> phase = 1;</div>
<div class="line"><a name="l02304"></a><span class="lineno"> 2304</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r++)</div>
<div class="line"><a name="l02305"></a><span class="lineno"> 2305</span>  phase *= regVals[i][r];</div>
<div class="line"><a name="l02306"></a><span class="lineno"> 2306</span>  phase = (phase == 0.)? divPhase : 1. / phase;</div>
<div class="line"><a name="l02307"></a><span class="lineno"> 2307</span>  diagMatr[i][i] = <a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(phase);</div>
<div class="line"><a name="l02308"></a><span class="lineno"> 2308</span>  }</div>
<div class="line"><a name="l02309"></a><span class="lineno"> 2309</span>  <a class="code" href="group__testutilities.html#gaf57b4b82c98e98918f74476741f60e37">setDiagMatrixOverrides</a>(diagMatr, numQubitsPerReg, numRegs, encoding, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l02310"></a><span class="lineno"> 2310</span>  </div>
<div class="line"><a name="l02311"></a><span class="lineno"> 2311</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l02312"></a><span class="lineno"> 2312</span>  </div>
<div class="line"><a name="l02313"></a><span class="lineno"> 2313</span>  <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l02314"></a><span class="lineno"> 2314</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l02315"></a><span class="lineno"> 2315</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l02316"></a><span class="lineno"> 2316</span>  }</div>
<div class="line"><a name="l02317"></a><span class="lineno"> 2317</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l02318"></a><span class="lineno"> 2318</span>  </div>
<div class="line"><a name="l02319"></a><span class="lineno"> 2319</span>  <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregMatr, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l02320"></a><span class="lineno"> 2320</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l02321"></a><span class="lineno"> 2321</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l02322"></a><span class="lineno"> 2322</span>  }</div>
<div class="line"><a name="l02323"></a><span class="lineno"> 2323</span>  }</div>
<div class="line"><a name="l02324"></a><span class="lineno"> 2324</span>  SECTION( <span class="stringliteral">"SCALED_PRODUCT"</span> ) {</div>
<div class="line"><a name="l02325"></a><span class="lineno"> 2325</span>  </div>
<div class="line"><a name="l02326"></a><span class="lineno"> 2326</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a31a29a30f92fe34c35098f941adbbc93">SCALED_PRODUCT</a>;</div>
<div class="line"><a name="l02327"></a><span class="lineno"> 2327</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeff = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-10, 10);</div>
<div class="line"><a name="l02328"></a><span class="lineno"> 2328</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> params[] = {coeff};</div>
<div class="line"><a name="l02329"></a><span class="lineno"> 2329</span>  <span class="keywordtype">int</span> numParams = 1;</div>
<div class="line"><a name="l02330"></a><span class="lineno"> 2330</span>  </div>
<div class="line"><a name="l02331"></a><span class="lineno"> 2331</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<diagMatr.size(); i++) {</div>
<div class="line"><a name="l02332"></a><span class="lineno"> 2332</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> phase = 1;</div>
<div class="line"><a name="l02333"></a><span class="lineno"> 2333</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r++)</div>
<div class="line"><a name="l02334"></a><span class="lineno"> 2334</span>  phase *= regVals[i][r];</div>
<div class="line"><a name="l02335"></a><span class="lineno"> 2335</span>  diagMatr[i][i] = <a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(coeff * phase);</div>
<div class="line"><a name="l02336"></a><span class="lineno"> 2336</span>  }</div>
<div class="line"><a name="l02337"></a><span class="lineno"> 2337</span>  <a class="code" href="group__testutilities.html#gaf57b4b82c98e98918f74476741f60e37">setDiagMatrixOverrides</a>(diagMatr, numQubitsPerReg, numRegs, encoding, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l02338"></a><span class="lineno"> 2338</span>  </div>
<div class="line"><a name="l02339"></a><span class="lineno"> 2339</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l02340"></a><span class="lineno"> 2340</span>  </div>
<div class="line"><a name="l02341"></a><span class="lineno"> 2341</span>  <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l02342"></a><span class="lineno"> 2342</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l02343"></a><span class="lineno"> 2343</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l02344"></a><span class="lineno"> 2344</span>  }</div>
<div class="line"><a name="l02345"></a><span class="lineno"> 2345</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l02346"></a><span class="lineno"> 2346</span>  </div>
<div class="line"><a name="l02347"></a><span class="lineno"> 2347</span>  <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregMatr, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l02348"></a><span class="lineno"> 2348</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l02349"></a><span class="lineno"> 2349</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l02350"></a><span class="lineno"> 2350</span>  }</div>
<div class="line"><a name="l02351"></a><span class="lineno"> 2351</span>  }</div>
<div class="line"><a name="l02352"></a><span class="lineno"> 2352</span>  SECTION( <span class="stringliteral">"SCALED_INVERSE_PRODUCT"</span> ) {</div>
<div class="line"><a name="l02353"></a><span class="lineno"> 2353</span>  </div>
<div class="line"><a name="l02354"></a><span class="lineno"> 2354</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a1a5168576607f460d3e60f184575cacb">SCALED_INVERSE_PRODUCT</a>;</div>
<div class="line"><a name="l02355"></a><span class="lineno"> 2355</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeff = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-10, 10);</div>
<div class="line"><a name="l02356"></a><span class="lineno"> 2356</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> divPhase = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-4, 4);</div>
<div class="line"><a name="l02357"></a><span class="lineno"> 2357</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> params[] = {coeff, divPhase};</div>
<div class="line"><a name="l02358"></a><span class="lineno"> 2358</span>  <span class="keywordtype">int</span> numParams = 2;</div>
<div class="line"><a name="l02359"></a><span class="lineno"> 2359</span>  </div>
<div class="line"><a name="l02360"></a><span class="lineno"> 2360</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<diagMatr.size(); i++) {</div>
<div class="line"><a name="l02361"></a><span class="lineno"> 2361</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> phase = 1;</div>
<div class="line"><a name="l02362"></a><span class="lineno"> 2362</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r++)</div>
<div class="line"><a name="l02363"></a><span class="lineno"> 2363</span>  phase *= regVals[i][r];</div>
<div class="line"><a name="l02364"></a><span class="lineno"> 2364</span>  phase = (phase == 0)? divPhase : coeff / phase;</div>
<div class="line"><a name="l02365"></a><span class="lineno"> 2365</span>  diagMatr[i][i] = <a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(phase);</div>
<div class="line"><a name="l02366"></a><span class="lineno"> 2366</span>  }</div>
<div class="line"><a name="l02367"></a><span class="lineno"> 2367</span>  <a class="code" href="group__testutilities.html#gaf57b4b82c98e98918f74476741f60e37">setDiagMatrixOverrides</a>(diagMatr, numQubitsPerReg, numRegs, encoding, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l02368"></a><span class="lineno"> 2368</span>  </div>
<div class="line"><a name="l02369"></a><span class="lineno"> 2369</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l02370"></a><span class="lineno"> 2370</span>  </div>
<div class="line"><a name="l02371"></a><span class="lineno"> 2371</span>  <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l02372"></a><span class="lineno"> 2372</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l02373"></a><span class="lineno"> 2373</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l02374"></a><span class="lineno"> 2374</span>  }</div>
<div class="line"><a name="l02375"></a><span class="lineno"> 2375</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l02376"></a><span class="lineno"> 2376</span>  </div>
<div class="line"><a name="l02377"></a><span class="lineno"> 2377</span>  <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregMatr, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l02378"></a><span class="lineno"> 2378</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l02379"></a><span class="lineno"> 2379</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l02380"></a><span class="lineno"> 2380</span>  }</div>
<div class="line"><a name="l02381"></a><span class="lineno"> 2381</span>  }</div>
<div class="line"><a name="l02382"></a><span class="lineno"> 2382</span>  SECTION( <span class="stringliteral">"INVERSE_DISTANCE"</span> ) {</div>
<div class="line"><a name="l02383"></a><span class="lineno"> 2383</span>  </div>
<div class="line"><a name="l02384"></a><span class="lineno"> 2384</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a6313e6ff48163c11c47866c4fda4bfa0">INVERSE_DISTANCE</a>;</div>
<div class="line"><a name="l02385"></a><span class="lineno"> 2385</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> divPhase = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>( -4, 4 );</div>
<div class="line"><a name="l02386"></a><span class="lineno"> 2386</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> params[] = {divPhase};</div>
<div class="line"><a name="l02387"></a><span class="lineno"> 2387</span>  <span class="keywordtype">int</span> numParams = 1;</div>
<div class="line"><a name="l02388"></a><span class="lineno"> 2388</span>  </div>
<div class="line"><a name="l02389"></a><span class="lineno"> 2389</span>  <span class="comment">// test only if there are an even number of registers</span></div>
<div class="line"><a name="l02390"></a><span class="lineno"> 2390</span>  <span class="keywordflow">if</span> (numRegs%2 == 0) {</div>
<div class="line"><a name="l02391"></a><span class="lineno"> 2391</span>  </div>
<div class="line"><a name="l02392"></a><span class="lineno"> 2392</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<diagMatr.size(); i++) {</div>
<div class="line"><a name="l02393"></a><span class="lineno"> 2393</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> phase = 0;</div>
<div class="line"><a name="l02394"></a><span class="lineno"> 2394</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r+=2)</div>
<div class="line"><a name="l02395"></a><span class="lineno"> 2395</span>  phase += pow(regVals[i][r+1]-regVals[i][r], 2);</div>
<div class="line"><a name="l02396"></a><span class="lineno"> 2396</span>  phase = (phase == 0.)? divPhase : 1./sqrt(phase);</div>
<div class="line"><a name="l02397"></a><span class="lineno"> 2397</span>  diagMatr[i][i] = <a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(phase);</div>
<div class="line"><a name="l02398"></a><span class="lineno"> 2398</span>  }</div>
<div class="line"><a name="l02399"></a><span class="lineno"> 2399</span>  <a class="code" href="group__testutilities.html#gaf57b4b82c98e98918f74476741f60e37">setDiagMatrixOverrides</a>(diagMatr, numQubitsPerReg, numRegs, encoding, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l02400"></a><span class="lineno"> 2400</span>  }</div>
<div class="line"><a name="l02401"></a><span class="lineno"> 2401</span>  </div>
<div class="line"><a name="l02402"></a><span class="lineno"> 2402</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l02403"></a><span class="lineno"> 2403</span>  </div>
<div class="line"><a name="l02404"></a><span class="lineno"> 2404</span>  <span class="keywordflow">if</span> (numRegs%2 == 0) {</div>
<div class="line"><a name="l02405"></a><span class="lineno"> 2405</span>  <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l02406"></a><span class="lineno"> 2406</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l02407"></a><span class="lineno"> 2407</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l02408"></a><span class="lineno"> 2408</span>  }</div>
<div class="line"><a name="l02409"></a><span class="lineno"> 2409</span>  }</div>
<div class="line"><a name="l02410"></a><span class="lineno"> 2410</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l02411"></a><span class="lineno"> 2411</span>  </div>
<div class="line"><a name="l02412"></a><span class="lineno"> 2412</span>  <span class="keywordflow">if</span> (numRegs%2 == 0) {</div>
<div class="line"><a name="l02413"></a><span class="lineno"> 2413</span>  <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregMatr, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l02414"></a><span class="lineno"> 2414</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l02415"></a><span class="lineno"> 2415</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l02416"></a><span class="lineno"> 2416</span>  }</div>
<div class="line"><a name="l02417"></a><span class="lineno"> 2417</span>  }</div>
<div class="line"><a name="l02418"></a><span class="lineno"> 2418</span>  }</div>
<div class="line"><a name="l02419"></a><span class="lineno"> 2419</span>  SECTION( <span class="stringliteral">"SCALED_DISTANCE"</span> ) {</div>
<div class="line"><a name="l02420"></a><span class="lineno"> 2420</span>  </div>
<div class="line"><a name="l02421"></a><span class="lineno"> 2421</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ace23d4b924240a245d83193f0ce398d4">SCALED_DISTANCE</a>;</div>
<div class="line"><a name="l02422"></a><span class="lineno"> 2422</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeff = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>( -10, 10 ); </div>
<div class="line"><a name="l02423"></a><span class="lineno"> 2423</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> params[] = {coeff};</div>
<div class="line"><a name="l02424"></a><span class="lineno"> 2424</span>  <span class="keywordtype">int</span> numParams = 1;</div>
<div class="line"><a name="l02425"></a><span class="lineno"> 2425</span>  </div>
<div class="line"><a name="l02426"></a><span class="lineno"> 2426</span>  <span class="comment">// test only if there are an even number of registers</span></div>
<div class="line"><a name="l02427"></a><span class="lineno"> 2427</span>  <span class="keywordflow">if</span> (numRegs%2 == 0) {</div>
<div class="line"><a name="l02428"></a><span class="lineno"> 2428</span>  </div>
<div class="line"><a name="l02429"></a><span class="lineno"> 2429</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<diagMatr.size(); i++) {</div>
<div class="line"><a name="l02430"></a><span class="lineno"> 2430</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> phase = 0;</div>
<div class="line"><a name="l02431"></a><span class="lineno"> 2431</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r+=2)</div>
<div class="line"><a name="l02432"></a><span class="lineno"> 2432</span>  phase += pow(regVals[i][r+1]-regVals[i][r], 2);</div>
<div class="line"><a name="l02433"></a><span class="lineno"> 2433</span>  phase = coeff * sqrt(phase);</div>
<div class="line"><a name="l02434"></a><span class="lineno"> 2434</span>  diagMatr[i][i] = <a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(phase);</div>
<div class="line"><a name="l02435"></a><span class="lineno"> 2435</span>  }</div>
<div class="line"><a name="l02436"></a><span class="lineno"> 2436</span>  <a class="code" href="group__testutilities.html#gaf57b4b82c98e98918f74476741f60e37">setDiagMatrixOverrides</a>(diagMatr, numQubitsPerReg, numRegs, encoding, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l02437"></a><span class="lineno"> 2437</span>  }</div>
<div class="line"><a name="l02438"></a><span class="lineno"> 2438</span>  </div>
<div class="line"><a name="l02439"></a><span class="lineno"> 2439</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l02440"></a><span class="lineno"> 2440</span>  </div>
<div class="line"><a name="l02441"></a><span class="lineno"> 2441</span>  <span class="keywordflow">if</span> (numRegs%2 == 0) {</div>
<div class="line"><a name="l02442"></a><span class="lineno"> 2442</span>  <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l02443"></a><span class="lineno"> 2443</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l02444"></a><span class="lineno"> 2444</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l02445"></a><span class="lineno"> 2445</span>  }</div>
<div class="line"><a name="l02446"></a><span class="lineno"> 2446</span>  }</div>
<div class="line"><a name="l02447"></a><span class="lineno"> 2447</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l02448"></a><span class="lineno"> 2448</span>  </div>
<div class="line"><a name="l02449"></a><span class="lineno"> 2449</span>  <span class="keywordflow">if</span> (numRegs%2 == 0) {</div>
<div class="line"><a name="l02450"></a><span class="lineno"> 2450</span>  <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregMatr, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l02451"></a><span class="lineno"> 2451</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l02452"></a><span class="lineno"> 2452</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l02453"></a><span class="lineno"> 2453</span>  }</div>
<div class="line"><a name="l02454"></a><span class="lineno"> 2454</span>  }</div>
<div class="line"><a name="l02455"></a><span class="lineno"> 2455</span>  }</div>
<div class="line"><a name="l02456"></a><span class="lineno"> 2456</span>  SECTION( <span class="stringliteral">"SCALED_INVERSE_DISTANCE"</span> ) {</div>
<div class="line"><a name="l02457"></a><span class="lineno"> 2457</span>  </div>
<div class="line"><a name="l02458"></a><span class="lineno"> 2458</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae5114537389194302c7a619e35e6e227">SCALED_INVERSE_DISTANCE</a>;</div>
<div class="line"><a name="l02459"></a><span class="lineno"> 2459</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeff = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>( -10, 10 );</div>
<div class="line"><a name="l02460"></a><span class="lineno"> 2460</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> divPhase = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>( -4, 4 );</div>
<div class="line"><a name="l02461"></a><span class="lineno"> 2461</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> params[] = {coeff, divPhase};</div>
<div class="line"><a name="l02462"></a><span class="lineno"> 2462</span>  <span class="keywordtype">int</span> numParams = 2;</div>
<div class="line"><a name="l02463"></a><span class="lineno"> 2463</span>  </div>
<div class="line"><a name="l02464"></a><span class="lineno"> 2464</span>  <span class="comment">// test only if there are an even number of registers</span></div>
<div class="line"><a name="l02465"></a><span class="lineno"> 2465</span>  <span class="keywordflow">if</span> (numRegs%2 == 0) {</div>
<div class="line"><a name="l02466"></a><span class="lineno"> 2466</span>  </div>
<div class="line"><a name="l02467"></a><span class="lineno"> 2467</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<diagMatr.size(); i++) {</div>
<div class="line"><a name="l02468"></a><span class="lineno"> 2468</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> phase = 0;</div>
<div class="line"><a name="l02469"></a><span class="lineno"> 2469</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r+=2)</div>
<div class="line"><a name="l02470"></a><span class="lineno"> 2470</span>  phase += pow(regVals[i][r+1]-regVals[i][r], 2);</div>
<div class="line"><a name="l02471"></a><span class="lineno"> 2471</span>  phase = (phase == 0.)? divPhase : coeff/sqrt(phase);</div>
<div class="line"><a name="l02472"></a><span class="lineno"> 2472</span>  diagMatr[i][i] = <a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(phase);</div>
<div class="line"><a name="l02473"></a><span class="lineno"> 2473</span>  }</div>
<div class="line"><a name="l02474"></a><span class="lineno"> 2474</span>  <a class="code" href="group__testutilities.html#gaf57b4b82c98e98918f74476741f60e37">setDiagMatrixOverrides</a>(diagMatr, numQubitsPerReg, numRegs, encoding, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l02475"></a><span class="lineno"> 2475</span>  }</div>
<div class="line"><a name="l02476"></a><span class="lineno"> 2476</span>  </div>
<div class="line"><a name="l02477"></a><span class="lineno"> 2477</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l02478"></a><span class="lineno"> 2478</span>  </div>
<div class="line"><a name="l02479"></a><span class="lineno"> 2479</span>  <span class="keywordflow">if</span> (numRegs%2 == 0) {</div>
<div class="line"><a name="l02480"></a><span class="lineno"> 2480</span>  <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l02481"></a><span class="lineno"> 2481</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l02482"></a><span class="lineno"> 2482</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l02483"></a><span class="lineno"> 2483</span>  }</div>
<div class="line"><a name="l02484"></a><span class="lineno"> 2484</span>  }</div>
<div class="line"><a name="l02485"></a><span class="lineno"> 2485</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l02486"></a><span class="lineno"> 2486</span>  </div>
<div class="line"><a name="l02487"></a><span class="lineno"> 2487</span>  <span class="keywordflow">if</span> (numRegs%2 == 0) {</div>
<div class="line"><a name="l02488"></a><span class="lineno"> 2488</span>  <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregMatr, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l02489"></a><span class="lineno"> 2489</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l02490"></a><span class="lineno"> 2490</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l02491"></a><span class="lineno"> 2491</span>  }</div>
<div class="line"><a name="l02492"></a><span class="lineno"> 2492</span>  }</div>
<div class="line"><a name="l02493"></a><span class="lineno"> 2493</span>  }</div>
<div class="line"><a name="l02494"></a><span class="lineno"> 2494</span>  SECTION( <span class="stringliteral">"SCALED_INVERSE_SHIFTED_DISTANCE"</span> ) {</div>
<div class="line"><a name="l02495"></a><span class="lineno"> 2495</span>  </div>
<div class="line"><a name="l02496"></a><span class="lineno"> 2496</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a39111120b79016d6b3e773b711fa63f7">SCALED_INVERSE_SHIFTED_DISTANCE</a>;</div>
<div class="line"><a name="l02497"></a><span class="lineno"> 2497</span>  <span class="keywordtype">int</span> numParams = 2 + numRegs/2;</div>
<div class="line"><a name="l02498"></a><span class="lineno"> 2498</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> params[numParams];</div>
<div class="line"><a name="l02499"></a><span class="lineno"> 2499</span>  </div>
<div class="line"><a name="l02500"></a><span class="lineno"> 2500</span>  <span class="comment">// test only if there are an even number of registers</span></div>
<div class="line"><a name="l02501"></a><span class="lineno"> 2501</span>  <span class="keywordflow">if</span> (numRegs%2 == 0) {</div>
<div class="line"><a name="l02502"></a><span class="lineno"> 2502</span>  </div>
<div class="line"><a name="l02503"></a><span class="lineno"> 2503</span>  params[0] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>( -10, 10 ); <span class="comment">// scaling</span></div>
<div class="line"><a name="l02504"></a><span class="lineno"> 2504</span>  params[1] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>( -4, 4 ); <span class="comment">// divergence override</span></div>
<div class="line"><a name="l02505"></a><span class="lineno"> 2505</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs/2; r++)</div>
<div class="line"><a name="l02506"></a><span class="lineno"> 2506</span>  params[2+r] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>( -8, 8 ); <span class="comment">// shifts</span></div>
<div class="line"><a name="l02507"></a><span class="lineno"> 2507</span>  </div>
<div class="line"><a name="l02508"></a><span class="lineno"> 2508</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<diagMatr.size(); i++) {</div>
<div class="line"><a name="l02509"></a><span class="lineno"> 2509</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> phase = 0;</div>
<div class="line"><a name="l02510"></a><span class="lineno"> 2510</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs; r+=2)</div>
<div class="line"><a name="l02511"></a><span class="lineno"> 2511</span>  phase += pow(regVals[i][r]-regVals[i][r+1]-params[2+r/2], 2);</div>
<div class="line"><a name="l02512"></a><span class="lineno"> 2512</span>  phase = sqrt(phase);</div>
<div class="line"><a name="l02513"></a><span class="lineno"> 2513</span>  phase = (phase <= REAL_EPS)? params[1] : params[0]/phase;</div>
<div class="line"><a name="l02514"></a><span class="lineno"> 2514</span>  diagMatr[i][i] = <a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(phase);</div>
<div class="line"><a name="l02515"></a><span class="lineno"> 2515</span>  }</div>
<div class="line"><a name="l02516"></a><span class="lineno"> 2516</span>  </div>
<div class="line"><a name="l02517"></a><span class="lineno"> 2517</span>  <a class="code" href="group__testutilities.html#gaf57b4b82c98e98918f74476741f60e37">setDiagMatrixOverrides</a>(diagMatr, numQubitsPerReg, numRegs, encoding, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l02518"></a><span class="lineno"> 2518</span>  }</div>
<div class="line"><a name="l02519"></a><span class="lineno"> 2519</span>  </div>
<div class="line"><a name="l02520"></a><span class="lineno"> 2520</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l02521"></a><span class="lineno"> 2521</span>  </div>
<div class="line"><a name="l02522"></a><span class="lineno"> 2522</span>  <span class="keywordflow">if</span> (numRegs%2 == 0) {</div>
<div class="line"><a name="l02523"></a><span class="lineno"> 2523</span>  <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l02524"></a><span class="lineno"> 2524</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l02525"></a><span class="lineno"> 2525</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l02526"></a><span class="lineno"> 2526</span>  }</div>
<div class="line"><a name="l02527"></a><span class="lineno"> 2527</span>  }</div>
<div class="line"><a name="l02528"></a><span class="lineno"> 2528</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l02529"></a><span class="lineno"> 2529</span>  </div>
<div class="line"><a name="l02530"></a><span class="lineno"> 2530</span>  <span class="keywordflow">if</span> (numRegs%2 == 0) {</div>
<div class="line"><a name="l02531"></a><span class="lineno"> 2531</span>  <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregMatr, regs, numQubitsPerReg, numRegs, encoding, func, params, numParams, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l02532"></a><span class="lineno"> 2532</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, regs, totalNumQubits, diagMatr);</div>
<div class="line"><a name="l02533"></a><span class="lineno"> 2533</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l02534"></a><span class="lineno"> 2534</span>  }</div>
<div class="line"><a name="l02535"></a><span class="lineno"> 2535</span>  }</div>
<div class="line"><a name="l02536"></a><span class="lineno"> 2536</span>  }</div>
<div class="line"><a name="l02537"></a><span class="lineno"> 2537</span>  }</div>
<div class="line"><a name="l02538"></a><span class="lineno"> 2538</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l02539"></a><span class="lineno"> 2539</span>  </div>
<div class="line"><a name="l02540"></a><span class="lineno"> 2540</span>  <span class="keywordtype">int</span> numRegs = 2;</div>
<div class="line"><a name="l02541"></a><span class="lineno"> 2541</span>  <span class="keywordtype">int</span> numQubitsPerReg[] = {2,3};</div>
<div class="line"><a name="l02542"></a><span class="lineno"> 2542</span>  <span class="keywordtype">int</span> regs[] = {0,1,2,3,4};</div>
<div class="line"><a name="l02543"></a><span class="lineno"> 2543</span>  </div>
<div class="line"><a name="l02544"></a><span class="lineno"> 2544</span>  SECTION( <span class="stringliteral">"number of registers"</span> ) {</div>
<div class="line"><a name="l02545"></a><span class="lineno"> 2545</span>  </div>
<div class="line"><a name="l02546"></a><span class="lineno"> 2546</span>  numRegs = GENERATE_COPY( -1, 0, 1+<a class="code" href="QuEST__precision_8h.html#a6698ce2a3971003a0a0289e5980d39c5">MAX_NUM_REGS_APPLY_ARBITRARY_PHASE</a> );</div>
<div class="line"><a name="l02547"></a><span class="lineno"> 2547</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>, NULL, 0, NULL, NULL, 0), Contains(<span class="stringliteral">"Invalid number of qubit subregisters"</span>) );</div>
<div class="line"><a name="l02548"></a><span class="lineno"> 2548</span>  }</div>
<div class="line"><a name="l02549"></a><span class="lineno"> 2549</span>  SECTION( <span class="stringliteral">"number of qubits"</span> ) {</div>
<div class="line"><a name="l02550"></a><span class="lineno"> 2550</span>  </div>
<div class="line"><a name="l02551"></a><span class="lineno"> 2551</span>  numQubitsPerReg[GENERATE_COPY(range(0,numRegs))] = GENERATE( -1, 0, 1+<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l02552"></a><span class="lineno"> 2552</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>, NULL, 0, NULL, NULL, 0), Contains(<span class="stringliteral">"Invalid number of qubits"</span>) );</div>
<div class="line"><a name="l02553"></a><span class="lineno"> 2553</span>  }</div>
<div class="line"><a name="l02554"></a><span class="lineno"> 2554</span>  SECTION( <span class="stringliteral">"repetition of qubits"</span> ) {</div>
<div class="line"><a name="l02555"></a><span class="lineno"> 2555</span>  </div>
<div class="line"><a name="l02556"></a><span class="lineno"> 2556</span>  regs[GENERATE(2,3,4)] = regs[1];</div>
<div class="line"><a name="l02557"></a><span class="lineno"> 2557</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>, NULL, 0, NULL, NULL, 0), Contains(<span class="stringliteral">"The qubits must be unique"</span>) );</div>
<div class="line"><a name="l02558"></a><span class="lineno"> 2558</span>  }</div>
<div class="line"><a name="l02559"></a><span class="lineno"> 2559</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l02560"></a><span class="lineno"> 2560</span>  </div>
<div class="line"><a name="l02561"></a><span class="lineno"> 2561</span>  regs[GENERATE(range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>))] = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l02562"></a><span class="lineno"> 2562</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>, NULL, 0, NULL, NULL, 0), Contains(<span class="stringliteral">"Invalid qubit index"</span>) );</div>
<div class="line"><a name="l02563"></a><span class="lineno"> 2563</span>  }</div>
<div class="line"><a name="l02564"></a><span class="lineno"> 2564</span>  SECTION( <span class="stringliteral">"bit encoding name"</span> ) {</div>
<div class="line"><a name="l02565"></a><span class="lineno"> 2565</span>  </div>
<div class="line"><a name="l02566"></a><span class="lineno"> 2566</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#ga9c91c41aa42ae537995e89ffc616afe1">bitEncoding</a> enc = (<span class="keyword">enum</span> <a class="code" href="group__type.html#ga9c91c41aa42ae537995e89ffc616afe1">bitEncoding</a>) GENERATE( -1, 2 );</div>
<div class="line"><a name="l02567"></a><span class="lineno"> 2567</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, enc, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>, NULL, 0, NULL, NULL, 0), Contains(<span class="stringliteral">"Invalid bit encoding"</span>) );</div>
<div class="line"><a name="l02568"></a><span class="lineno"> 2568</span>  }</div>
<div class="line"><a name="l02569"></a><span class="lineno"> 2569</span>  SECTION( <span class="stringliteral">"two's complement register"</span> ) {</div>
<div class="line"><a name="l02570"></a><span class="lineno"> 2570</span>  </div>
<div class="line"><a name="l02571"></a><span class="lineno"> 2571</span>  numQubitsPerReg[GENERATE_COPY(range(0,numRegs))] = 1;</div>
<div class="line"><a name="l02572"></a><span class="lineno"> 2572</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>, NULL, 0, NULL, NULL, 0), Contains(<span class="stringliteral">"A sub-register contained too few qubits to employ TWOS_COMPLEMENT encoding"</span>) );</div>
<div class="line"><a name="l02573"></a><span class="lineno"> 2573</span>  }</div>
<div class="line"><a name="l02574"></a><span class="lineno"> 2574</span>  SECTION( <span class="stringliteral">"phase function name"</span> ) {</div>
<div class="line"><a name="l02575"></a><span class="lineno"> 2575</span>  </div>
<div class="line"><a name="l02576"></a><span class="lineno"> 2576</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = (<span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a>) GENERATE( -1, 14 );</div>
<div class="line"><a name="l02577"></a><span class="lineno"> 2577</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, func, NULL, 0, NULL, NULL, 0), Contains(<span class="stringliteral">"Invalid named phase function"</span>) );</div>
<div class="line"><a name="l02578"></a><span class="lineno"> 2578</span>  }</div>
<div class="line"><a name="l02579"></a><span class="lineno"> 2579</span>  SECTION( <span class="stringliteral">"phase function parameters"</span> ) {</div>
<div class="line"><a name="l02580"></a><span class="lineno"> 2580</span>  </div>
<div class="line"><a name="l02581"></a><span class="lineno"> 2581</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> params[numRegs + 3];</div>
<div class="line"><a name="l02582"></a><span class="lineno"> 2582</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> r=0; r<numRegs + 3; r++)</div>
<div class="line"><a name="l02583"></a><span class="lineno"> 2583</span>  params[r] = 0;</div>
<div class="line"><a name="l02584"></a><span class="lineno"> 2584</span>  </div>
<div class="line"><a name="l02585"></a><span class="lineno"> 2585</span>  SECTION( <span class="stringliteral">"no parameter functions"</span> ) {</div>
<div class="line"><a name="l02586"></a><span class="lineno"> 2586</span>  </div>
<div class="line"><a name="l02587"></a><span class="lineno"> 2587</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = GENERATE( <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65acb6911398e0068f545a31b82bcdef3e4">PRODUCT</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a2ad72f168181763513d7793c13bf2a91">DISTANCE</a> );</div>
<div class="line"><a name="l02588"></a><span class="lineno"> 2588</span>  <span class="keywordtype">int</span> numParams = GENERATE( -1, 1, 2 );</div>
<div class="line"><a name="l02589"></a><span class="lineno"> 2589</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, func, params, numParams, NULL, NULL, 0), Contains(<span class="stringliteral">"Invalid number of parameters"</span>) );</div>
<div class="line"><a name="l02590"></a><span class="lineno"> 2590</span>  }</div>
<div class="line"><a name="l02591"></a><span class="lineno"> 2591</span>  SECTION( <span class="stringliteral">"single parameter functions"</span> ) {</div>
<div class="line"><a name="l02592"></a><span class="lineno"> 2592</span>  </div>
<div class="line"><a name="l02593"></a><span class="lineno"> 2593</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = GENERATE( <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a93c0c1e166dd43c6a57f61e5490808e1">SCALED_NORM</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ad4c32e295c08ebe224e2c5ba6497f043">INVERSE_NORM</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a31a29a30f92fe34c35098f941adbbc93">SCALED_PRODUCT</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65acb26952815118f5ced7703302dbeb556">INVERSE_PRODUCT</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ace23d4b924240a245d83193f0ce398d4">SCALED_DISTANCE</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a6313e6ff48163c11c47866c4fda4bfa0">INVERSE_DISTANCE</a> );</div>
<div class="line"><a name="l02594"></a><span class="lineno"> 2594</span>  <span class="keywordtype">int</span> numParams = GENERATE( -1, 0, 2 );</div>
<div class="line"><a name="l02595"></a><span class="lineno"> 2595</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, func, params, numParams, NULL, NULL, 0), Contains(<span class="stringliteral">"Invalid number of parameters"</span>) );</div>
<div class="line"><a name="l02596"></a><span class="lineno"> 2596</span>  }</div>
<div class="line"><a name="l02597"></a><span class="lineno"> 2597</span>  SECTION( <span class="stringliteral">"two parameter functions"</span> ) { </div>
<div class="line"><a name="l02598"></a><span class="lineno"> 2598</span>  </div>
<div class="line"><a name="l02599"></a><span class="lineno"> 2599</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = GENERATE( <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae8c96906c1ec109d295c491e572d01e2">SCALED_INVERSE_NORM</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a1a5168576607f460d3e60f184575cacb">SCALED_INVERSE_PRODUCT</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae5114537389194302c7a619e35e6e227">SCALED_INVERSE_DISTANCE</a> );</div>
<div class="line"><a name="l02600"></a><span class="lineno"> 2600</span>  <span class="keywordtype">int</span> numParams = GENERATE( 0, 1, 3 );</div>
<div class="line"><a name="l02601"></a><span class="lineno"> 2601</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, func, params, numParams, NULL, NULL, 0), Contains(<span class="stringliteral">"Invalid number of parameters"</span>) );</div>
<div class="line"><a name="l02602"></a><span class="lineno"> 2602</span>  }</div>
<div class="line"><a name="l02603"></a><span class="lineno"> 2603</span>  SECTION( <span class="stringliteral">"shifted distance"</span> ) {</div>
<div class="line"><a name="l02604"></a><span class="lineno"> 2604</span>  </div>
<div class="line"><a name="l02605"></a><span class="lineno"> 2605</span>  <span class="keywordflow">if</span> (numRegs%2 == 0) {</div>
<div class="line"><a name="l02606"></a><span class="lineno"> 2606</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a39111120b79016d6b3e773b711fa63f7">SCALED_INVERSE_SHIFTED_DISTANCE</a>;</div>
<div class="line"><a name="l02607"></a><span class="lineno"> 2607</span>  <span class="keywordtype">int</span> numParams = GENERATE_COPY( 0, 1, numRegs/2 - 1, numRegs/2, numRegs/2 + 1, numRegs/2 + 3 );</div>
<div class="line"><a name="l02608"></a><span class="lineno"> 2608</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, func, params, numParams, NULL, NULL, 0), Contains(<span class="stringliteral">"Invalid number of parameters"</span>) );</div>
<div class="line"><a name="l02609"></a><span class="lineno"> 2609</span>  }</div>
<div class="line"><a name="l02610"></a><span class="lineno"> 2610</span>  }</div>
<div class="line"><a name="l02611"></a><span class="lineno"> 2611</span>  SECTION( <span class="stringliteral">"shifted norm"</span> ) {</div>
<div class="line"><a name="l02612"></a><span class="lineno"> 2612</span>  </div>
<div class="line"><a name="l02613"></a><span class="lineno"> 2613</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a> func = <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65aa318172feec5b530e9a7849f2f7b44e7">SCALED_INVERSE_SHIFTED_NORM</a>;</div>
<div class="line"><a name="l02614"></a><span class="lineno"> 2614</span>  <span class="keywordtype">int</span> numParams = GENERATE_COPY( 0, 1, numRegs-1, numRegs, numRegs+1, numRegs+3 );</div>
<div class="line"><a name="l02615"></a><span class="lineno"> 2615</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, func, params, numParams, NULL, NULL, 0), Contains(<span class="stringliteral">"Invalid number of parameters"</span>) );</div>
<div class="line"><a name="l02616"></a><span class="lineno"> 2616</span>  }</div>
<div class="line"><a name="l02617"></a><span class="lineno"> 2617</span>  }</div>
<div class="line"><a name="l02618"></a><span class="lineno"> 2618</span>  SECTION( <span class="stringliteral">"distance pair registers"</span> ) {</div>
<div class="line"><a name="l02619"></a><span class="lineno"> 2619</span>  </div>
<div class="line"><a name="l02620"></a><span class="lineno"> 2620</span>  <span class="keywordtype">int</span> numQb[] = {1,1,1,1,1};</div>
<div class="line"><a name="l02621"></a><span class="lineno"> 2621</span>  <span class="keywordtype">int</span> qb[] = {0,1,2,3,4};</div>
<div class="line"><a name="l02622"></a><span class="lineno"> 2622</span>  </div>
<div class="line"><a name="l02623"></a><span class="lineno"> 2623</span>  numRegs = GENERATE( 1, 3, 5 );</div>
<div class="line"><a name="l02624"></a><span class="lineno"> 2624</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregVec, qb, numQb, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a2ad72f168181763513d7793c13bf2a91">DISTANCE</a>, NULL, 0, NULL, NULL, 0), Contains(<span class="stringliteral">"Phase functions DISTANCE"</span>) && Contains(<span class="stringliteral">"even number of sub-registers"</span>) );</div>
<div class="line"><a name="l02625"></a><span class="lineno"> 2625</span>  }</div>
<div class="line"><a name="l02626"></a><span class="lineno"> 2626</span>  SECTION( <span class="stringliteral">"number of overrides"</span> ) {</div>
<div class="line"><a name="l02627"></a><span class="lineno"> 2627</span>  </div>
<div class="line"><a name="l02628"></a><span class="lineno"> 2628</span>  <span class="keywordtype">int</span> numOverrides = -1;</div>
<div class="line"><a name="l02629"></a><span class="lineno"> 2629</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>, NULL, 0, NULL, NULL, numOverrides), Contains(<span class="stringliteral">"Invalid number of phase function overrides specified"</span>) );</div>
<div class="line"><a name="l02630"></a><span class="lineno"> 2630</span>  }</div>
<div class="line"><a name="l02631"></a><span class="lineno"> 2631</span>  SECTION( <span class="stringliteral">"override indices"</span> ) {</div>
<div class="line"><a name="l02632"></a><span class="lineno"> 2632</span>  </div>
<div class="line"><a name="l02633"></a><span class="lineno"> 2633</span>  <span class="comment">// numQubitsPerReg = {2, 3}</span></div>
<div class="line"><a name="l02634"></a><span class="lineno"> 2634</span>  <span class="keywordtype">int</span> numOverrides = 3;</div>
<div class="line"><a name="l02635"></a><span class="lineno"> 2635</span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <span class="keywordtype">int</span> overrideInds[] = {0,0, 0,0, 0,0}; <span class="comment">// repetition not checked</span></div>
<div class="line"><a name="l02636"></a><span class="lineno"> 2636</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> overridePhases[] = {.1, .1, .1};</div>
<div class="line"><a name="l02637"></a><span class="lineno"> 2637</span>  </div>
<div class="line"><a name="l02638"></a><span class="lineno"> 2638</span>  <span class="comment">// first element of overrideInds coordinate is a 2 qubit register</span></div>
<div class="line"><a name="l02639"></a><span class="lineno"> 2639</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#ga9c91c41aa42ae537995e89ffc616afe1">bitEncoding</a> enc = <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>;</div>
<div class="line"><a name="l02640"></a><span class="lineno"> 2640</span>  <span class="keywordtype">int</span> badInd = GENERATE(0, 2, 4);</div>
<div class="line"><a name="l02641"></a><span class="lineno"> 2641</span>  overrideInds[badInd] = GENERATE( -1, (1<<2) );</div>
<div class="line"><a name="l02642"></a><span class="lineno"> 2642</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, enc, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>, NULL, 0, overrideInds, overridePhases, numOverrides), Contains(<span class="stringliteral">"Invalid phase function override index, in the UNSIGNED encoding"</span>) );</div>
<div class="line"><a name="l02643"></a><span class="lineno"> 2643</span>  overrideInds[badInd] = 0;</div>
<div class="line"><a name="l02644"></a><span class="lineno"> 2644</span>  </div>
<div class="line"><a name="l02645"></a><span class="lineno"> 2645</span>  <span class="comment">// second element of overrideInds coordinate is a 3 qubit register</span></div>
<div class="line"><a name="l02646"></a><span class="lineno"> 2646</span>  badInd += 1;</div>
<div class="line"><a name="l02647"></a><span class="lineno"> 2647</span>  overrideInds[badInd] = GENERATE( -1, (1<<3) );</div>
<div class="line"><a name="l02648"></a><span class="lineno"> 2648</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, enc, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>, NULL, 0, overrideInds, overridePhases, numOverrides), Contains(<span class="stringliteral">"Invalid phase function override index, in the UNSIGNED encoding"</span>) );</div>
<div class="line"><a name="l02649"></a><span class="lineno"> 2649</span>  overrideInds[badInd] = 0;</div>
<div class="line"><a name="l02650"></a><span class="lineno"> 2650</span>  badInd -= 1;</div>
<div class="line"><a name="l02651"></a><span class="lineno"> 2651</span>  </div>
<div class="line"><a name="l02652"></a><span class="lineno"> 2652</span>  enc = <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>;</div>
<div class="line"><a name="l02653"></a><span class="lineno"> 2653</span>  <span class="keywordtype">int</span> minInd = -(1<<(numQubitsPerReg[0]-1));</div>
<div class="line"><a name="l02654"></a><span class="lineno"> 2654</span>  <span class="keywordtype">int</span> maxInd = (1<<(numQubitsPerReg[0]-1)) - 1;</div>
<div class="line"><a name="l02655"></a><span class="lineno"> 2655</span>  overrideInds[badInd] = GENERATE_COPY( minInd-1, maxInd+1 );</div>
<div class="line"><a name="l02656"></a><span class="lineno"> 2656</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, enc, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>, NULL, 0, overrideInds, overridePhases, numOverrides), Contains(<span class="stringliteral">"Invalid phase function override index, in the TWOS_COMPLEMENT encoding"</span>) );</div>
<div class="line"><a name="l02657"></a><span class="lineno"> 2657</span>  overrideInds[badInd] = 0;</div>
<div class="line"><a name="l02658"></a><span class="lineno"> 2658</span>  </div>
<div class="line"><a name="l02659"></a><span class="lineno"> 2659</span>  badInd++;</div>
<div class="line"><a name="l02660"></a><span class="lineno"> 2660</span>  minInd = -(1<<(numQubitsPerReg[1]-1));</div>
<div class="line"><a name="l02661"></a><span class="lineno"> 2661</span>  maxInd = (1<<(numQubitsPerReg[1]-1)) -1;</div>
<div class="line"><a name="l02662"></a><span class="lineno"> 2662</span>  overrideInds[badInd] = GENERATE_COPY( minInd-1, maxInd+1 );</div>
<div class="line"><a name="l02663"></a><span class="lineno"> 2663</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a>(quregVec, regs, numQubitsPerReg, numRegs, enc, <a class="code" href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a>, NULL, 0, overrideInds, overridePhases, numOverrides), Contains(<span class="stringliteral">"Invalid phase function override index, in the TWOS_COMPLEMENT encoding"</span>) );</div>
<div class="line"><a name="l02664"></a><span class="lineno"> 2664</span>  }</div>
<div class="line"><a name="l02665"></a><span class="lineno"> 2665</span>  }</div>
<div class="line"><a name="l02666"></a><span class="lineno"> 2666</span>  <a class="code" href="test__operators_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l02667"></a><span class="lineno"> 2667</span> }</div>
<div class="line"><a name="l02668"></a><span class="lineno"> 2668</span>  </div>
<div class="line"><a name="l02669"></a><span class="lineno"> 2669</span>  </div>
<div class="line"><a name="l02670"></a><span class="lineno"> 2670</span>  </div>
<div class="line"><a name="l02675"></a><span class="lineno"><a class="line" href="group__unittest.html#ga837338274c89440547aef67628640d97"> 2675</a></span> <a class="code" href="group__unittest.html#gaff6822e79b947a9e3b791572c674c08c">TEST_CASE</a>( <span class="stringliteral">"applyPauliHamil"</span>, <span class="stringliteral">"[operators]"</span> ) {</div>
<div class="line"><a name="l02676"></a><span class="lineno"> 2676</span>  </div>
<div class="line"><a name="l02677"></a><span class="lineno"> 2677</span>  <a class="code" href="structQureg.html">Qureg</a> vecIn = <a class="code" href="group__type.html#ga3392816c0643414165c2f5caeec17df0">createQureg</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l02678"></a><span class="lineno"> 2678</span>  <a class="code" href="structQureg.html">Qureg</a> vecOut = <a class="code" href="group__type.html#ga3392816c0643414165c2f5caeec17df0">createQureg</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l02679"></a><span class="lineno"> 2679</span>  <a class="code" href="structQureg.html">Qureg</a> matIn = <a class="code" href="group__type.html#ga93e55b6650b408abb30a1d4a8bce757c">createDensityQureg</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l02680"></a><span class="lineno"> 2680</span>  <a class="code" href="structQureg.html">Qureg</a> matOut = <a class="code" href="group__type.html#ga93e55b6650b408abb30a1d4a8bce757c">createDensityQureg</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l02681"></a><span class="lineno"> 2681</span>  </div>
<div class="line"><a name="l02682"></a><span class="lineno"> 2682</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(vecIn);</div>
<div class="line"><a name="l02683"></a><span class="lineno"> 2683</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(matIn);</div>
<div class="line"><a name="l02684"></a><span class="lineno"> 2684</span>  </div>
<div class="line"><a name="l02685"></a><span class="lineno"> 2685</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l02686"></a><span class="lineno"> 2686</span>  </div>
<div class="line"><a name="l02687"></a><span class="lineno"> 2687</span>  <span class="comment">/* it's too expensive to try every possible Pauli configuration, so</span></div>
<div class="line"><a name="l02688"></a><span class="lineno"> 2688</span> <span class="comment"> * we'll try 10 random codes, and for each, random coefficients</span></div>
<div class="line"><a name="l02689"></a><span class="lineno"> 2689</span> <span class="comment"> */</span></div>
<div class="line"><a name="l02690"></a><span class="lineno"> 2690</span>  GENERATE( range(0,10) );</div>
<div class="line"><a name="l02691"></a><span class="lineno"> 2691</span>  </div>
<div class="line"><a name="l02692"></a><span class="lineno"> 2692</span>  <span class="keywordtype">int</span> numTerms = GENERATE( 1, 2, 10, 15 );</div>
<div class="line"><a name="l02693"></a><span class="lineno"> 2693</span>  <a class="code" href="structPauliHamil.html">PauliHamil</a> hamil = <a class="code" href="group__type.html#ga35b28710877c462927366fa602e591cb">createPauliHamil</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, numTerms);</div>
<div class="line"><a name="l02694"></a><span class="lineno"> 2694</span>  <a class="code" href="group__testutilities.html#ga11c465ce1a5c238946a9e09d61c94c58">setRandomPauliSum</a>(hamil);</div>
<div class="line"><a name="l02695"></a><span class="lineno"> 2695</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> refHamil = <a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(hamil);</div>
<div class="line"><a name="l02696"></a><span class="lineno"> 2696</span>  </div>
<div class="line"><a name="l02697"></a><span class="lineno"> 2697</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l02698"></a><span class="lineno"> 2698</span>  </div>
<div class="line"><a name="l02699"></a><span class="lineno"> 2699</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> vecRef = <a class="code" href="group__testutilities.html#gade0e7c37811a69f1c21c88c11943a19f">toQVector</a>(vecIn);</div>
<div class="line"><a name="l02700"></a><span class="lineno"> 2700</span>  <a class="code" href="group__operator.html#ga54d4e589468002bdc998200ae45e7312">applyPauliHamil</a>(vecIn, hamil, vecOut);</div>
<div class="line"><a name="l02701"></a><span class="lineno"> 2701</span>  </div>
<div class="line"><a name="l02702"></a><span class="lineno"> 2702</span>  <span class="comment">// ensure vecIn barely changes under precision</span></div>
<div class="line"><a name="l02703"></a><span class="lineno"> 2703</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vecIn, vecRef) );</div>
<div class="line"><a name="l02704"></a><span class="lineno"> 2704</span>  </div>
<div class="line"><a name="l02705"></a><span class="lineno"> 2705</span>  <span class="comment">// ensure vecOut changed correctly </span></div>
<div class="line"><a name="l02706"></a><span class="lineno"> 2706</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vecOut, refHamil * vecRef) );</div>
<div class="line"><a name="l02707"></a><span class="lineno"> 2707</span>  }</div>
<div class="line"><a name="l02708"></a><span class="lineno"> 2708</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l02709"></a><span class="lineno"> 2709</span>  </div>
<div class="line"><a name="l02710"></a><span class="lineno"> 2710</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> matRef = <a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(matIn);</div>
<div class="line"><a name="l02711"></a><span class="lineno"> 2711</span>  <a class="code" href="group__operator.html#ga54d4e589468002bdc998200ae45e7312">applyPauliHamil</a>(matIn, hamil, matOut);</div>
<div class="line"><a name="l02712"></a><span class="lineno"> 2712</span>  </div>
<div class="line"><a name="l02713"></a><span class="lineno"> 2713</span>  <span class="comment">// ensure matIn barely changes under precision</span></div>
<div class="line"><a name="l02714"></a><span class="lineno"> 2714</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(matIn, matRef) );</div>
<div class="line"><a name="l02715"></a><span class="lineno"> 2715</span>  </div>
<div class="line"><a name="l02716"></a><span class="lineno"> 2716</span>  <span class="comment">// ensure matOut changed correctly </span></div>
<div class="line"><a name="l02717"></a><span class="lineno"> 2717</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(matOut, refHamil * matRef, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l02718"></a><span class="lineno"> 2718</span>  }</div>
<div class="line"><a name="l02719"></a><span class="lineno"> 2719</span>  </div>
<div class="line"><a name="l02720"></a><span class="lineno"> 2720</span>  <a class="code" href="group__type.html#gac1c8ed909b33bd55ae680901006051b6">destroyPauliHamil</a>(hamil);</div>
<div class="line"><a name="l02721"></a><span class="lineno"> 2721</span>  }</div>
<div class="line"><a name="l02722"></a><span class="lineno"> 2722</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l02723"></a><span class="lineno"> 2723</span>  </div>
<div class="line"><a name="l02724"></a><span class="lineno"> 2724</span>  SECTION( <span class="stringliteral">"pauli codes"</span> ) {</div>
<div class="line"><a name="l02725"></a><span class="lineno"> 2725</span>  </div>
<div class="line"><a name="l02726"></a><span class="lineno"> 2726</span>  <span class="keywordtype">int</span> numTerms = 3;</div>
<div class="line"><a name="l02727"></a><span class="lineno"> 2727</span>  <a class="code" href="structPauliHamil.html">PauliHamil</a> hamil = <a class="code" href="group__type.html#ga35b28710877c462927366fa602e591cb">createPauliHamil</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, numTerms);</div>
<div class="line"><a name="l02728"></a><span class="lineno"> 2728</span>  </div>
<div class="line"><a name="l02729"></a><span class="lineno"> 2729</span>  <span class="comment">// make one pauli code wrong</span></div>
<div class="line"><a name="l02730"></a><span class="lineno"> 2730</span>  hamil.<a class="code" href="structPauliHamil.html#a4b8d38c403553c07ceddcd40c46ce6c8">pauliCodes</a>[GENERATE_COPY( range(0,numTerms*<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) )] = (<a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a>) GENERATE( -1, 4 );</div>
<div class="line"><a name="l02731"></a><span class="lineno"> 2731</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga54d4e589468002bdc998200ae45e7312">applyPauliHamil</a>(vecIn, hamil, vecOut), Contains(<span class="stringliteral">"Invalid Pauli code"</span>) );</div>
<div class="line"><a name="l02732"></a><span class="lineno"> 2732</span>  </div>
<div class="line"><a name="l02733"></a><span class="lineno"> 2733</span>  <a class="code" href="group__type.html#gac1c8ed909b33bd55ae680901006051b6">destroyPauliHamil</a>(hamil);</div>
<div class="line"><a name="l02734"></a><span class="lineno"> 2734</span>  }</div>
<div class="line"><a name="l02735"></a><span class="lineno"> 2735</span>  SECTION( <span class="stringliteral">"qureg dimensions"</span> ) {</div>
<div class="line"><a name="l02736"></a><span class="lineno"> 2736</span>  </div>
<div class="line"><a name="l02737"></a><span class="lineno"> 2737</span>  <a class="code" href="structQureg.html">Qureg</a> badVec = <a class="code" href="group__type.html#ga3392816c0643414165c2f5caeec17df0">createQureg</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l02738"></a><span class="lineno"> 2738</span>  <a class="code" href="structPauliHamil.html">PauliHamil</a> hamil = <a class="code" href="group__type.html#ga35b28710877c462927366fa602e591cb">createPauliHamil</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, 1);</div>
<div class="line"><a name="l02739"></a><span class="lineno"> 2739</span>  </div>
<div class="line"><a name="l02740"></a><span class="lineno"> 2740</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga54d4e589468002bdc998200ae45e7312">applyPauliHamil</a>(vecIn, hamil, badVec), Contains(<span class="stringliteral">"Dimensions of the qubit registers don't match"</span>) );</div>
<div class="line"><a name="l02741"></a><span class="lineno"> 2741</span>  </div>
<div class="line"><a name="l02742"></a><span class="lineno"> 2742</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(badVec, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l02743"></a><span class="lineno"> 2743</span>  <a class="code" href="group__type.html#gac1c8ed909b33bd55ae680901006051b6">destroyPauliHamil</a>(hamil);</div>
<div class="line"><a name="l02744"></a><span class="lineno"> 2744</span>  }</div>
<div class="line"><a name="l02745"></a><span class="lineno"> 2745</span>  SECTION( <span class="stringliteral">"qureg types"</span> ) {</div>
<div class="line"><a name="l02746"></a><span class="lineno"> 2746</span>  </div>
<div class="line"><a name="l02747"></a><span class="lineno"> 2747</span>  <a class="code" href="structPauliHamil.html">PauliHamil</a> hamil = <a class="code" href="group__type.html#ga35b28710877c462927366fa602e591cb">createPauliHamil</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, 1);</div>
<div class="line"><a name="l02748"></a><span class="lineno"> 2748</span>  </div>
<div class="line"><a name="l02749"></a><span class="lineno"> 2749</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga54d4e589468002bdc998200ae45e7312">applyPauliHamil</a>(vecIn, hamil, matOut), Contains(<span class="stringliteral">"Registers must both be state-vectors or both be density matrices"</span>) );</div>
<div class="line"><a name="l02750"></a><span class="lineno"> 2750</span>  </div>
<div class="line"><a name="l02751"></a><span class="lineno"> 2751</span>  <a class="code" href="group__type.html#gac1c8ed909b33bd55ae680901006051b6">destroyPauliHamil</a>(hamil);</div>
<div class="line"><a name="l02752"></a><span class="lineno"> 2752</span>  }</div>
<div class="line"><a name="l02753"></a><span class="lineno"> 2753</span>  SECTION( <span class="stringliteral">"matching hamiltonian qubits"</span> ) {</div>
<div class="line"><a name="l02754"></a><span class="lineno"> 2754</span>  </div>
<div class="line"><a name="l02755"></a><span class="lineno"> 2755</span>  <a class="code" href="structPauliHamil.html">PauliHamil</a> hamil = <a class="code" href="group__type.html#ga35b28710877c462927366fa602e591cb">createPauliHamil</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> + 1, 1);</div>
<div class="line"><a name="l02756"></a><span class="lineno"> 2756</span>  </div>
<div class="line"><a name="l02757"></a><span class="lineno"> 2757</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga54d4e589468002bdc998200ae45e7312">applyPauliHamil</a>(vecIn, hamil, vecOut), Contains(<span class="stringliteral">"same number of qubits"</span>) );</div>
<div class="line"><a name="l02758"></a><span class="lineno"> 2758</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga54d4e589468002bdc998200ae45e7312">applyPauliHamil</a>(matIn, hamil, matOut), Contains(<span class="stringliteral">"same number of qubits"</span>) );</div>
<div class="line"><a name="l02759"></a><span class="lineno"> 2759</span>  </div>
<div class="line"><a name="l02760"></a><span class="lineno"> 2760</span>  <a class="code" href="group__type.html#gac1c8ed909b33bd55ae680901006051b6">destroyPauliHamil</a>(hamil);</div>
<div class="line"><a name="l02761"></a><span class="lineno"> 2761</span>  }</div>
<div class="line"><a name="l02762"></a><span class="lineno"> 2762</span>  }</div>
<div class="line"><a name="l02763"></a><span class="lineno"> 2763</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(vecIn, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l02764"></a><span class="lineno"> 2764</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(vecOut, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l02765"></a><span class="lineno"> 2765</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(matIn, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l02766"></a><span class="lineno"> 2766</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(matOut, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l02767"></a><span class="lineno"> 2767</span> }</div>
<div class="line"><a name="l02768"></a><span class="lineno"> 2768</span>  </div>
<div class="line"><a name="l02769"></a><span class="lineno"> 2769</span>  </div>
<div class="line"><a name="l02770"></a><span class="lineno"> 2770</span>  </div>
<div class="line"><a name="l02775"></a><span class="lineno"><a class="line" href="group__unittest.html#ga37d50a46caa1bdf003155dafc4426b73"> 2775</a></span> <a class="code" href="group__unittest.html#gaff6822e79b947a9e3b791572c674c08c">TEST_CASE</a>( <span class="stringliteral">"applyPauliSum"</span>, <span class="stringliteral">"[operators]"</span> ) {</div>
<div class="line"><a name="l02776"></a><span class="lineno"> 2776</span>  </div>
<div class="line"><a name="l02777"></a><span class="lineno"> 2777</span>  <a class="code" href="structQureg.html">Qureg</a> vecIn = <a class="code" href="group__type.html#ga3392816c0643414165c2f5caeec17df0">createQureg</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l02778"></a><span class="lineno"> 2778</span>  <a class="code" href="structQureg.html">Qureg</a> vecOut = <a class="code" href="group__type.html#ga3392816c0643414165c2f5caeec17df0">createQureg</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l02779"></a><span class="lineno"> 2779</span>  <a class="code" href="structQureg.html">Qureg</a> matIn = <a class="code" href="group__type.html#ga93e55b6650b408abb30a1d4a8bce757c">createDensityQureg</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l02780"></a><span class="lineno"> 2780</span>  <a class="code" href="structQureg.html">Qureg</a> matOut = <a class="code" href="group__type.html#ga93e55b6650b408abb30a1d4a8bce757c">createDensityQureg</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l02781"></a><span class="lineno"> 2781</span>  </div>
<div class="line"><a name="l02782"></a><span class="lineno"> 2782</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(vecIn);</div>
<div class="line"><a name="l02783"></a><span class="lineno"> 2783</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(matIn);</div>
<div class="line"><a name="l02784"></a><span class="lineno"> 2784</span>  </div>
<div class="line"><a name="l02785"></a><span class="lineno"> 2785</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l02786"></a><span class="lineno"> 2786</span>  </div>
<div class="line"><a name="l02787"></a><span class="lineno"> 2787</span>  <span class="comment">/* it's too expensive to try ALL Pauli sequences, via </span></div>
<div class="line"><a name="l02788"></a><span class="lineno"> 2788</span> <span class="comment"> * pauliOpType* paulis = GENERATE_COPY( pauliseqs(numPaulis) );.</span></div>
<div class="line"><a name="l02789"></a><span class="lineno"> 2789</span> <span class="comment"> * Furthermore, take(10, pauliseqs(numTargs)) will try the same pauli codes.</span></div>
<div class="line"><a name="l02790"></a><span class="lineno"> 2790</span> <span class="comment"> * Hence, we instead opt to repeatedly randomly generate pauliseqs</span></div>
<div class="line"><a name="l02791"></a><span class="lineno"> 2791</span> <span class="comment"> */</span></div>
<div class="line"><a name="l02792"></a><span class="lineno"> 2792</span>  GENERATE( range(0,10) ); <span class="comment">// gen 10 random pauli-codes</span></div>
<div class="line"><a name="l02793"></a><span class="lineno"> 2793</span>  </div>
<div class="line"><a name="l02794"></a><span class="lineno"> 2794</span>  <span class="keywordtype">int</span> numTerms = GENERATE( 1, 2, 10, 15);</div>
<div class="line"><a name="l02795"></a><span class="lineno"> 2795</span>  <span class="keywordtype">int</span> numPaulis = numTerms * <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>;</div>
<div class="line"><a name="l02796"></a><span class="lineno"> 2796</span>  </div>
<div class="line"><a name="l02797"></a><span class="lineno"> 2797</span>  <span class="comment">// each test will use random coefficients</span></div>
<div class="line"><a name="l02798"></a><span class="lineno"> 2798</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeffs[numTerms];</div>
<div class="line"><a name="l02799"></a><span class="lineno"> 2799</span>  <a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a> paulis[numPaulis];</div>
<div class="line"><a name="l02800"></a><span class="lineno"> 2800</span>  <a class="code" href="group__testutilities.html#ga11c465ce1a5c238946a9e09d61c94c58">setRandomPauliSum</a>(coeffs, paulis, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, numTerms);</div>
<div class="line"><a name="l02801"></a><span class="lineno"> 2801</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> pauliSum = <a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(coeffs, paulis, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, numTerms);</div>
<div class="line"><a name="l02802"></a><span class="lineno"> 2802</span>  </div>
<div class="line"><a name="l02803"></a><span class="lineno"> 2803</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l02804"></a><span class="lineno"> 2804</span>  </div>
<div class="line"><a name="l02805"></a><span class="lineno"> 2805</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> vecRef = <a class="code" href="group__testutilities.html#gade0e7c37811a69f1c21c88c11943a19f">toQVector</a>(vecIn);</div>
<div class="line"><a name="l02806"></a><span class="lineno"> 2806</span>  <a class="code" href="group__operator.html#ga6fc26cf857db070e12959e59ecfed8a6">applyPauliSum</a>(vecIn, paulis, coeffs, numTerms, vecOut);</div>
<div class="line"><a name="l02807"></a><span class="lineno"> 2807</span>  </div>
<div class="line"><a name="l02808"></a><span class="lineno"> 2808</span>  <span class="comment">// ensure vecIn barely changes under precision</span></div>
<div class="line"><a name="l02809"></a><span class="lineno"> 2809</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vecIn, vecRef) );</div>
<div class="line"><a name="l02810"></a><span class="lineno"> 2810</span>  </div>
<div class="line"><a name="l02811"></a><span class="lineno"> 2811</span>  <span class="comment">// ensure vecOut changed correctly </span></div>
<div class="line"><a name="l02812"></a><span class="lineno"> 2812</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vecOut, pauliSum * vecRef) );</div>
<div class="line"><a name="l02813"></a><span class="lineno"> 2813</span>  }</div>
<div class="line"><a name="l02814"></a><span class="lineno"> 2814</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l02815"></a><span class="lineno"> 2815</span>  </div>
<div class="line"><a name="l02816"></a><span class="lineno"> 2816</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> matRef = <a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(matIn);</div>
<div class="line"><a name="l02817"></a><span class="lineno"> 2817</span>  <a class="code" href="group__operator.html#ga6fc26cf857db070e12959e59ecfed8a6">applyPauliSum</a>(matIn, paulis, coeffs, numTerms, matOut);</div>
<div class="line"><a name="l02818"></a><span class="lineno"> 2818</span>  </div>
<div class="line"><a name="l02819"></a><span class="lineno"> 2819</span>  <span class="comment">// ensure matIn barely changes under precision</span></div>
<div class="line"><a name="l02820"></a><span class="lineno"> 2820</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(matIn, matRef) );</div>
<div class="line"><a name="l02821"></a><span class="lineno"> 2821</span>  </div>
<div class="line"><a name="l02822"></a><span class="lineno"> 2822</span>  <span class="comment">// ensure matOut changed correctly </span></div>
<div class="line"><a name="l02823"></a><span class="lineno"> 2823</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(matOut, pauliSum * matRef, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l02824"></a><span class="lineno"> 2824</span>  }</div>
<div class="line"><a name="l02825"></a><span class="lineno"> 2825</span>  }</div>
<div class="line"><a name="l02826"></a><span class="lineno"> 2826</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l02827"></a><span class="lineno"> 2827</span>  </div>
<div class="line"><a name="l02828"></a><span class="lineno"> 2828</span>  SECTION( <span class="stringliteral">"number of terms"</span> ) {</div>
<div class="line"><a name="l02829"></a><span class="lineno"> 2829</span>  </div>
<div class="line"><a name="l02830"></a><span class="lineno"> 2830</span>  <span class="keywordtype">int</span> numTerms = GENERATE( -1, 0 );</div>
<div class="line"><a name="l02831"></a><span class="lineno"> 2831</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga6fc26cf857db070e12959e59ecfed8a6">applyPauliSum</a>(vecIn, NULL, NULL, numTerms, vecOut), Contains(<span class="stringliteral">"Invalid number of terms"</span>) );</div>
<div class="line"><a name="l02832"></a><span class="lineno"> 2832</span>  }</div>
<div class="line"><a name="l02833"></a><span class="lineno"> 2833</span>  SECTION( <span class="stringliteral">"pauli codes"</span> ) {</div>
<div class="line"><a name="l02834"></a><span class="lineno"> 2834</span>  </div>
<div class="line"><a name="l02835"></a><span class="lineno"> 2835</span>  <span class="comment">// valid codes</span></div>
<div class="line"><a name="l02836"></a><span class="lineno"> 2836</span>  <span class="keywordtype">int</span> numTerms = 3;</div>
<div class="line"><a name="l02837"></a><span class="lineno"> 2837</span>  <span class="keywordtype">int</span> numPaulis = numTerms*<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>;</div>
<div class="line"><a name="l02838"></a><span class="lineno"> 2838</span>  <a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a> paulis[numPaulis];</div>
<div class="line"><a name="l02839"></a><span class="lineno"> 2839</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numPaulis; i++)</div>
<div class="line"><a name="l02840"></a><span class="lineno"> 2840</span>  paulis[i] = <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a63800f45b01ccc2608f754aee850bf4a">PAULI_I</a>;</div>
<div class="line"><a name="l02841"></a><span class="lineno"> 2841</span>  </div>
<div class="line"><a name="l02842"></a><span class="lineno"> 2842</span>  <span class="comment">// make one invalid </span></div>
<div class="line"><a name="l02843"></a><span class="lineno"> 2843</span>  paulis[GENERATE_COPY( range(0,numPaulis) )] = (<a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a>) GENERATE( -1, 4 );</div>
<div class="line"><a name="l02844"></a><span class="lineno"> 2844</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga6fc26cf857db070e12959e59ecfed8a6">applyPauliSum</a>(vecIn, paulis, NULL, numTerms, vecOut), Contains(<span class="stringliteral">"Invalid Pauli code"</span>) );</div>
<div class="line"><a name="l02845"></a><span class="lineno"> 2845</span>  }</div>
<div class="line"><a name="l02846"></a><span class="lineno"> 2846</span>  SECTION( <span class="stringliteral">"qureg dimensions"</span> ) {</div>
<div class="line"><a name="l02847"></a><span class="lineno"> 2847</span>  </div>
<div class="line"><a name="l02848"></a><span class="lineno"> 2848</span>  <a class="code" href="structQureg.html">Qureg</a> badVec = <a class="code" href="group__type.html#ga3392816c0643414165c2f5caeec17df0">createQureg</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l02849"></a><span class="lineno"> 2849</span>  <a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a> paulis[<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>];</div>
<div class="line"><a name="l02850"></a><span class="lineno"> 2850</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga6fc26cf857db070e12959e59ecfed8a6">applyPauliSum</a>(vecIn, paulis, NULL, 1, badVec), Contains(<span class="stringliteral">"Dimensions of the qubit registers don't match"</span>) );</div>
<div class="line"><a name="l02851"></a><span class="lineno"> 2851</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(badVec, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l02852"></a><span class="lineno"> 2852</span>  }</div>
<div class="line"><a name="l02853"></a><span class="lineno"> 2853</span>  SECTION( <span class="stringliteral">"qureg types"</span> ) {</div>
<div class="line"><a name="l02854"></a><span class="lineno"> 2854</span>  </div>
<div class="line"><a name="l02855"></a><span class="lineno"> 2855</span>  <a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a> paulis[<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>];</div>
<div class="line"><a name="l02856"></a><span class="lineno"> 2856</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga6fc26cf857db070e12959e59ecfed8a6">applyPauliSum</a>(vecIn, paulis, NULL, 1, matOut), Contains(<span class="stringliteral">"Registers must both be state-vectors or both be density matrices"</span>) );</div>
<div class="line"><a name="l02857"></a><span class="lineno"> 2857</span>  }</div>
<div class="line"><a name="l02858"></a><span class="lineno"> 2858</span>  }</div>
<div class="line"><a name="l02859"></a><span class="lineno"> 2859</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(vecIn, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l02860"></a><span class="lineno"> 2860</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(vecOut, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l02861"></a><span class="lineno"> 2861</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(matIn, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l02862"></a><span class="lineno"> 2862</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(matOut, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l02863"></a><span class="lineno"> 2863</span> }</div>
<div class="line"><a name="l02864"></a><span class="lineno"> 2864</span>  </div>
<div class="line"><a name="l02865"></a><span class="lineno"> 2865</span>  </div>
<div class="line"><a name="l02866"></a><span class="lineno"> 2866</span>  </div>
<div class="line"><a name="l02871"></a><span class="lineno"><a class="line" href="group__unittest.html#ga86524404eb3532ca18d0e24e657316d9"> 2871</a></span> <a class="code" href="group__unittest.html#gaff6822e79b947a9e3b791572c674c08c">TEST_CASE</a>( <span class="stringliteral">"applyPhaseFunc"</span>, <span class="stringliteral">"[operators]"</span> ) {</div>
<div class="line"><a name="l02872"></a><span class="lineno"> 2872</span>  </div>
<div class="line"><a name="l02873"></a><span class="lineno"> 2873</span>  <a class="code" href="test__operators_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l02874"></a><span class="lineno"> 2874</span>  </div>
<div class="line"><a name="l02875"></a><span class="lineno"> 2875</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l02876"></a><span class="lineno"> 2876</span>  </div>
<div class="line"><a name="l02877"></a><span class="lineno"> 2877</span>  <span class="comment">// try every kind of binary encodings</span></div>
<div class="line"><a name="l02878"></a><span class="lineno"> 2878</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#ga9c91c41aa42ae537995e89ffc616afe1">bitEncoding</a> encoding = GENERATE( <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>,<a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a> );</div>
<div class="line"><a name="l02879"></a><span class="lineno"> 2879</span>  </div>
<div class="line"><a name="l02880"></a><span class="lineno"> 2880</span>  <span class="comment">// try every sub-register size</span></div>
<div class="line"><a name="l02881"></a><span class="lineno"> 2881</span>  <span class="keywordtype">int</span> numQubits = GENERATE_COPY( range(1,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1) );</div>
<div class="line"><a name="l02882"></a><span class="lineno"> 2882</span>  </div>
<div class="line"><a name="l02883"></a><span class="lineno"> 2883</span>  <span class="comment">// force at least 2 qubits in two's compement though</span></div>
<div class="line"><a name="l02884"></a><span class="lineno"> 2884</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a> && numQubits == 1)</div>
<div class="line"><a name="l02885"></a><span class="lineno"> 2885</span>  numQubits++;</div>
<div class="line"><a name="l02886"></a><span class="lineno"> 2886</span>  </div>
<div class="line"><a name="l02887"></a><span class="lineno"> 2887</span>  <span class="comment">// try every possible sub-register</span></div>
<div class="line"><a name="l02888"></a><span class="lineno"> 2888</span>  <span class="keywordtype">int</span>* qubits = GENERATE_COPY( <a class="code" href="group__testutilities.html#ga35add15146aa606b256df79334b867d5">sublists</a>(range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>), numQubits) );</div>
<div class="line"><a name="l02889"></a><span class="lineno"> 2889</span>  </div>
<div class="line"><a name="l02890"></a><span class="lineno"> 2890</span>  <span class="comment">// choose a random number of terms in the phase function</span></div>
<div class="line"><a name="l02891"></a><span class="lineno"> 2891</span>  <span class="keywordtype">int</span> numTerms = <a class="code" href="group__testutilities.html#ga7125d0747a44db58115899727ac5f6be">getRandomInt</a>(1, 5);</div>
<div class="line"><a name="l02892"></a><span class="lineno"> 2892</span>  </div>
<div class="line"><a name="l02893"></a><span class="lineno"> 2893</span>  <span class="comment">// populate the phase function with random but POSITIVE-power terms,</span></div>
<div class="line"><a name="l02894"></a><span class="lineno"> 2894</span>  <span class="comment">// and in two's complement mode, strictly integer powers</span></div>
<div class="line"><a name="l02895"></a><span class="lineno"> 2895</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeffs[numTerms];</div>
<div class="line"><a name="l02896"></a><span class="lineno"> 2896</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> expons[numTerms];</div>
<div class="line"><a name="l02897"></a><span class="lineno"> 2897</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> t=0; t<numTerms; t++) {</div>
<div class="line"><a name="l02898"></a><span class="lineno"> 2898</span>  coeffs[t] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-10,10);</div>
<div class="line"><a name="l02899"></a><span class="lineno"> 2899</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>)</div>
<div class="line"><a name="l02900"></a><span class="lineno"> 2900</span>  expons[t] = <a class="code" href="group__testutilities.html#ga7125d0747a44db58115899727ac5f6be">getRandomInt</a>(0, 3+1); <span class="comment">// repetition of power is ok</span></div>
<div class="line"><a name="l02901"></a><span class="lineno"> 2901</span>  <span class="keywordflow">else</span> </div>
<div class="line"><a name="l02902"></a><span class="lineno"> 2902</span>  expons[t] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(0, 3);</div>
<div class="line"><a name="l02903"></a><span class="lineno"> 2903</span>  }</div>
<div class="line"><a name="l02904"></a><span class="lineno"> 2904</span>  </div>
<div class="line"><a name="l02905"></a><span class="lineno"> 2905</span>  <span class="comment">// build a reference diagonal matrix, on the reduced Hilbert space</span></div>
<div class="line"><a name="l02906"></a><span class="lineno"> 2906</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> matr = <a class="code" href="group__testutilities.html#ga6ccbb15b0f234e926be96a153181b63a">getZeroMatrix</a>( 1 << numQubits );</div>
<div class="line"><a name="l02907"></a><span class="lineno"> 2907</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<matr.size(); i++) {</div>
<div class="line"><a name="l02908"></a><span class="lineno"> 2908</span>  </div>
<div class="line"><a name="l02909"></a><span class="lineno"> 2909</span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <span class="keywordtype">int</span> ind = 0;</div>
<div class="line"><a name="l02910"></a><span class="lineno"> 2910</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>)</div>
<div class="line"><a name="l02911"></a><span class="lineno"> 2911</span>  ind = i;</div>
<div class="line"><a name="l02912"></a><span class="lineno"> 2912</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>)</div>
<div class="line"><a name="l02913"></a><span class="lineno"> 2913</span>  ind = <a class="code" href="group__testutilities.html#ga49be3b32f7b7a274fc5ecb209fde1189">getTwosComplement</a>(i, numQubits);</div>
<div class="line"><a name="l02914"></a><span class="lineno"> 2914</span>  </div>
<div class="line"><a name="l02915"></a><span class="lineno"> 2915</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> phase = 0;</div>
<div class="line"><a name="l02916"></a><span class="lineno"> 2916</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> t=0; t<numTerms; t++)</div>
<div class="line"><a name="l02917"></a><span class="lineno"> 2917</span>  phase += coeffs[t] * pow(ind, expons[t]);</div>
<div class="line"><a name="l02918"></a><span class="lineno"> 2918</span>  </div>
<div class="line"><a name="l02919"></a><span class="lineno"> 2919</span>  matr[i][i] = <a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(phase);</div>
<div class="line"><a name="l02920"></a><span class="lineno"> 2920</span>  }</div>
<div class="line"><a name="l02921"></a><span class="lineno"> 2921</span>  </div>
<div class="line"><a name="l02922"></a><span class="lineno"> 2922</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l02923"></a><span class="lineno"> 2923</span>  </div>
<div class="line"><a name="l02924"></a><span class="lineno"> 2924</span>  <a class="code" href="group__operator.html#ga467f517abd18dbc3d6fced84c6589161">applyPhaseFunc</a>(quregVec, qubits, numQubits, encoding, coeffs, expons, numTerms);</div>
<div class="line"><a name="l02925"></a><span class="lineno"> 2925</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, qubits, numQubits, matr);</div>
<div class="line"><a name="l02926"></a><span class="lineno"> 2926</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec, 1E4*REAL_EPS) );</div>
<div class="line"><a name="l02927"></a><span class="lineno"> 2927</span>  }</div>
<div class="line"><a name="l02928"></a><span class="lineno"> 2928</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l02929"></a><span class="lineno"> 2929</span>  </div>
<div class="line"><a name="l02930"></a><span class="lineno"> 2930</span>  <a class="code" href="group__operator.html#ga467f517abd18dbc3d6fced84c6589161">applyPhaseFunc</a>(quregMatr, qubits, numQubits, encoding, coeffs, expons, numTerms);</div>
<div class="line"><a name="l02931"></a><span class="lineno"> 2931</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, qubits, numQubits, matr);</div>
<div class="line"><a name="l02932"></a><span class="lineno"> 2932</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 1E6*REAL_EPS) );</div>
<div class="line"><a name="l02933"></a><span class="lineno"> 2933</span>  }</div>
<div class="line"><a name="l02934"></a><span class="lineno"> 2934</span>  }</div>
<div class="line"><a name="l02935"></a><span class="lineno"> 2935</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l02936"></a><span class="lineno"> 2936</span>  </div>
<div class="line"><a name="l02937"></a><span class="lineno"> 2937</span>  <span class="keywordtype">int</span> numQubits = 3;</div>
<div class="line"><a name="l02938"></a><span class="lineno"> 2938</span>  <span class="keywordtype">int</span> qubits[] = {0,1,2};</div>
<div class="line"><a name="l02939"></a><span class="lineno"> 2939</span>  </div>
<div class="line"><a name="l02940"></a><span class="lineno"> 2940</span>  SECTION( <span class="stringliteral">"number of qubits"</span> ) {</div>
<div class="line"><a name="l02941"></a><span class="lineno"> 2941</span>  </div>
<div class="line"><a name="l02942"></a><span class="lineno"> 2942</span>  numQubits = GENERATE_COPY( -1, 0, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1 );</div>
<div class="line"><a name="l02943"></a><span class="lineno"> 2943</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga467f517abd18dbc3d6fced84c6589161">applyPhaseFunc</a>(quregVec, NULL, numQubits, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, NULL, NULL, 1), Contains(<span class="stringliteral">"Invalid number of qubits"</span>) );</div>
<div class="line"><a name="l02944"></a><span class="lineno"> 2944</span>  }</div>
<div class="line"><a name="l02945"></a><span class="lineno"> 2945</span>  SECTION( <span class="stringliteral">"repetition of qubits"</span> ) {</div>
<div class="line"><a name="l02946"></a><span class="lineno"> 2946</span>  </div>
<div class="line"><a name="l02947"></a><span class="lineno"> 2947</span>  qubits[GENERATE(1,2)] = qubits[0];</div>
<div class="line"><a name="l02948"></a><span class="lineno"> 2948</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga467f517abd18dbc3d6fced84c6589161">applyPhaseFunc</a>(quregVec, qubits, numQubits, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, NULL, NULL, 1), Contains(<span class="stringliteral">"The qubits must be unique"</span>) );</div>
<div class="line"><a name="l02949"></a><span class="lineno"> 2949</span>  }</div>
<div class="line"><a name="l02950"></a><span class="lineno"> 2950</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l02951"></a><span class="lineno"> 2951</span>  </div>
<div class="line"><a name="l02952"></a><span class="lineno"> 2952</span>  <span class="keywordtype">int</span> inv = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l02953"></a><span class="lineno"> 2953</span>  qubits[ GENERATE_COPY( range(0,numQubits) )] = inv;</div>
<div class="line"><a name="l02954"></a><span class="lineno"> 2954</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga467f517abd18dbc3d6fced84c6589161">applyPhaseFunc</a>(quregVec, qubits, numQubits, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, NULL, NULL, 1), Contains(<span class="stringliteral">"Invalid qubit index"</span>) );</div>
<div class="line"><a name="l02955"></a><span class="lineno"> 2955</span>  }</div>
<div class="line"><a name="l02956"></a><span class="lineno"> 2956</span>  SECTION( <span class="stringliteral">"number of terms"</span> ) {</div>
<div class="line"><a name="l02957"></a><span class="lineno"> 2957</span>  </div>
<div class="line"><a name="l02958"></a><span class="lineno"> 2958</span>  <span class="keywordtype">int</span> numTerms = GENERATE( -1, 0 );</div>
<div class="line"><a name="l02959"></a><span class="lineno"> 2959</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga467f517abd18dbc3d6fced84c6589161">applyPhaseFunc</a>(quregVec, qubits, numQubits, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, NULL, NULL, numTerms), Contains(<span class="stringliteral">"Invalid number of terms in the phase function"</span>) );</div>
<div class="line"><a name="l02960"></a><span class="lineno"> 2960</span>  }</div>
<div class="line"><a name="l02961"></a><span class="lineno"> 2961</span>  SECTION( <span class="stringliteral">"bit encoding name"</span> ) {</div>
<div class="line"><a name="l02962"></a><span class="lineno"> 2962</span>  </div>
<div class="line"><a name="l02963"></a><span class="lineno"> 2963</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#ga9c91c41aa42ae537995e89ffc616afe1">bitEncoding</a> enc = (<span class="keyword">enum</span> <a class="code" href="group__type.html#ga9c91c41aa42ae537995e89ffc616afe1">bitEncoding</a>) GENERATE( -1,2 );</div>
<div class="line"><a name="l02964"></a><span class="lineno"> 2964</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga467f517abd18dbc3d6fced84c6589161">applyPhaseFunc</a>(quregVec, qubits, numQubits, enc, NULL, NULL, 1), Contains(<span class="stringliteral">"Invalid bit encoding"</span>) );</div>
<div class="line"><a name="l02965"></a><span class="lineno"> 2965</span>  }</div>
<div class="line"><a name="l02966"></a><span class="lineno"> 2966</span>  SECTION( <span class="stringliteral">"two's complement register"</span> ) {</div>
<div class="line"><a name="l02967"></a><span class="lineno"> 2967</span>  </div>
<div class="line"><a name="l02968"></a><span class="lineno"> 2968</span>  numQubits = 1;</div>
<div class="line"><a name="l02969"></a><span class="lineno"> 2969</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga467f517abd18dbc3d6fced84c6589161">applyPhaseFunc</a>(quregVec, qubits, numQubits, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>, NULL, NULL, 1), Contains(<span class="stringliteral">"too few qubits to employ TWOS_COMPLEMENT"</span>) );</div>
<div class="line"><a name="l02970"></a><span class="lineno"> 2970</span>  }</div>
<div class="line"><a name="l02971"></a><span class="lineno"> 2971</span>  SECTION( <span class="stringliteral">"fractional exponent"</span> ) {</div>
<div class="line"><a name="l02972"></a><span class="lineno"> 2972</span>  </div>
<div class="line"><a name="l02973"></a><span class="lineno"> 2973</span>  <span class="keywordtype">int</span> numTerms = 3;</div>
<div class="line"><a name="l02974"></a><span class="lineno"> 2974</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeffs[] = {0,0,0};</div>
<div class="line"><a name="l02975"></a><span class="lineno"> 2975</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> expos[] = {1,2,3};</div>
<div class="line"><a name="l02976"></a><span class="lineno"> 2976</span>  expos[GENERATE_COPY( range(0,numTerms) )] = GENERATE( 0.5, 1.999, 5.0001 );</div>
<div class="line"><a name="l02977"></a><span class="lineno"> 2977</span>  </div>
<div class="line"><a name="l02978"></a><span class="lineno"> 2978</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga467f517abd18dbc3d6fced84c6589161">applyPhaseFunc</a>(quregVec, qubits, numQubits, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>, coeffs, expos, numTerms), Contains(<span class="stringliteral">"fractional exponent"</span>) && Contains(<span class="stringliteral">"TWOS_COMPLEMENT"</span>) && Contains(<span class="stringliteral">"negative indices were not overriden"</span>) );</div>
<div class="line"><a name="l02979"></a><span class="lineno"> 2979</span>  }</div>
<div class="line"><a name="l02980"></a><span class="lineno"> 2980</span>  SECTION( <span class="stringliteral">"negative exponent"</span> ) {</div>
<div class="line"><a name="l02981"></a><span class="lineno"> 2981</span>  </div>
<div class="line"><a name="l02982"></a><span class="lineno"> 2982</span>  <span class="keywordtype">int</span> numTerms = 3;</div>
<div class="line"><a name="l02983"></a><span class="lineno"> 2983</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeffs[] = {0,0,0};</div>
<div class="line"><a name="l02984"></a><span class="lineno"> 2984</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> expos[] = {1,2,3};</div>
<div class="line"><a name="l02985"></a><span class="lineno"> 2985</span>  expos[GENERATE_COPY( range(0,numTerms) )] = GENERATE( -1, -2, -1.5 );</div>
<div class="line"><a name="l02986"></a><span class="lineno"> 2986</span>  </div>
<div class="line"><a name="l02987"></a><span class="lineno"> 2987</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#ga9c91c41aa42ae537995e89ffc616afe1">bitEncoding</a> encoding = GENERATE( <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a> );</div>
<div class="line"><a name="l02988"></a><span class="lineno"> 2988</span>  </div>
<div class="line"><a name="l02989"></a><span class="lineno"> 2989</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga467f517abd18dbc3d6fced84c6589161">applyPhaseFunc</a>(quregVec, qubits, numQubits, encoding, coeffs, expos, numTerms), Contains(<span class="stringliteral">"The phase function contained a negative exponent which would diverge at zero, but the zero index was not overriden"</span>) );</div>
<div class="line"><a name="l02990"></a><span class="lineno"> 2990</span>  }</div>
<div class="line"><a name="l02991"></a><span class="lineno"> 2991</span>  }</div>
<div class="line"><a name="l02992"></a><span class="lineno"> 2992</span>  <a class="code" href="test__operators_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l02993"></a><span class="lineno"> 2993</span> }</div>
<div class="line"><a name="l02994"></a><span class="lineno"> 2994</span>  </div>
<div class="line"><a name="l02995"></a><span class="lineno"> 2995</span>  </div>
<div class="line"><a name="l02996"></a><span class="lineno"> 2996</span>  </div>
<div class="line"><a name="l03001"></a><span class="lineno"><a class="line" href="group__unittest.html#ga664e2e125ed1b394e177ac3e8d3c1d42"> 3001</a></span> <a class="code" href="group__unittest.html#gaff6822e79b947a9e3b791572c674c08c">TEST_CASE</a>( <span class="stringliteral">"applyPhaseFuncOverrides"</span>, <span class="stringliteral">"[operators]"</span> ) {</div>
<div class="line"><a name="l03002"></a><span class="lineno"> 3002</span>  </div>
<div class="line"><a name="l03003"></a><span class="lineno"> 3003</span>  <a class="code" href="test__operators_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l03004"></a><span class="lineno"> 3004</span>  </div>
<div class="line"><a name="l03005"></a><span class="lineno"> 3005</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l03006"></a><span class="lineno"> 3006</span>  </div>
<div class="line"><a name="l03007"></a><span class="lineno"> 3007</span>  <span class="comment">// try every kind of binary encodings</span></div>
<div class="line"><a name="l03008"></a><span class="lineno"> 3008</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#ga9c91c41aa42ae537995e89ffc616afe1">bitEncoding</a> encoding = GENERATE( <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>,<a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a> );</div>
<div class="line"><a name="l03009"></a><span class="lineno"> 3009</span>  </div>
<div class="line"><a name="l03010"></a><span class="lineno"> 3010</span>  <span class="comment">// try every sub-register size</span></div>
<div class="line"><a name="l03011"></a><span class="lineno"> 3011</span>  <span class="keywordtype">int</span> numQubits = GENERATE_COPY( range(1,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1) );</div>
<div class="line"><a name="l03012"></a><span class="lineno"> 3012</span>  </div>
<div class="line"><a name="l03013"></a><span class="lineno"> 3013</span>  <span class="comment">// force at least 2 qubits in two's compement though</span></div>
<div class="line"><a name="l03014"></a><span class="lineno"> 3014</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a> && numQubits == 1)</div>
<div class="line"><a name="l03015"></a><span class="lineno"> 3015</span>  numQubits++;</div>
<div class="line"><a name="l03016"></a><span class="lineno"> 3016</span>  </div>
<div class="line"><a name="l03017"></a><span class="lineno"> 3017</span>  <span class="comment">// try every possible sub-register</span></div>
<div class="line"><a name="l03018"></a><span class="lineno"> 3018</span>  <span class="keywordtype">int</span>* qubits = GENERATE_COPY( <a class="code" href="group__testutilities.html#ga35add15146aa606b256df79334b867d5">sublists</a>(range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>), numQubits) );</div>
<div class="line"><a name="l03019"></a><span class="lineno"> 3019</span>  </div>
<div class="line"><a name="l03020"></a><span class="lineno"> 3020</span>  <span class="comment">// choose a random number of terms in the phase function</span></div>
<div class="line"><a name="l03021"></a><span class="lineno"> 3021</span>  <span class="keywordtype">int</span> numTerms = <a class="code" href="group__testutilities.html#ga7125d0747a44db58115899727ac5f6be">getRandomInt</a>(1, 21);</div>
<div class="line"><a name="l03022"></a><span class="lineno"> 3022</span>  </div>
<div class="line"><a name="l03023"></a><span class="lineno"> 3023</span>  <span class="comment">// populate the phase function with random powers.</span></div>
<div class="line"><a name="l03024"></a><span class="lineno"> 3024</span>  <span class="comment">// this includes negative powers, so we must always override 0.</span></div>
<div class="line"><a name="l03025"></a><span class="lineno"> 3025</span>  <span class="comment">// in two's complement, we must use only integer powers</span></div>
<div class="line"><a name="l03026"></a><span class="lineno"> 3026</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeffs[numTerms];</div>
<div class="line"><a name="l03027"></a><span class="lineno"> 3027</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> expons[numTerms];</div>
<div class="line"><a name="l03028"></a><span class="lineno"> 3028</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> t=0; t<numTerms; t++) {</div>
<div class="line"><a name="l03029"></a><span class="lineno"> 3029</span>  coeffs[t] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-10,10);</div>
<div class="line"><a name="l03030"></a><span class="lineno"> 3030</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>)</div>
<div class="line"><a name="l03031"></a><span class="lineno"> 3031</span>  expons[t] = <a class="code" href="group__testutilities.html#ga7125d0747a44db58115899727ac5f6be">getRandomInt</a>(-3, 3+1); <span class="comment">// note we COULD do getRandomReal(), and override all negatives</span></div>
<div class="line"><a name="l03032"></a><span class="lineno"> 3032</span>  <span class="keywordflow">else</span></div>
<div class="line"><a name="l03033"></a><span class="lineno"> 3033</span>  expons[t] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-3, 3);</div>
<div class="line"><a name="l03034"></a><span class="lineno"> 3034</span>  }</div>
<div class="line"><a name="l03035"></a><span class="lineno"> 3035</span>  </div>
<div class="line"><a name="l03036"></a><span class="lineno"> 3036</span>  <span class="comment">// choose a random number of overrides (even overriding every amplitude)</span></div>
<div class="line"><a name="l03037"></a><span class="lineno"> 3037</span>  <span class="keywordtype">int</span> numOverrides = <a class="code" href="group__testutilities.html#ga7125d0747a44db58115899727ac5f6be">getRandomInt</a>(1, (1<<numQubits) + 1);</div>
<div class="line"><a name="l03038"></a><span class="lineno"> 3038</span>  </div>
<div class="line"><a name="l03039"></a><span class="lineno"> 3039</span>  <span class="comment">// randomise each override index (uniqueness isn't checked)</span></div>
<div class="line"><a name="l03040"></a><span class="lineno"> 3040</span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <span class="keywordtype">int</span> overrideInds[numOverrides];</div>
<div class="line"><a name="l03041"></a><span class="lineno"> 3041</span>  overrideInds[0] = 0LL;</div>
<div class="line"><a name="l03042"></a><span class="lineno"> 3042</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=1; i<numOverrides; i++)</div>
<div class="line"><a name="l03043"></a><span class="lineno"> 3043</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>)</div>
<div class="line"><a name="l03044"></a><span class="lineno"> 3044</span>  overrideInds[i] = <a class="code" href="group__testutilities.html#ga7125d0747a44db58115899727ac5f6be">getRandomInt</a>(0, 1<<numQubits);</div>
<div class="line"><a name="l03045"></a><span class="lineno"> 3045</span>  <span class="keywordflow">else</span> <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>)</div>
<div class="line"><a name="l03046"></a><span class="lineno"> 3046</span>  overrideInds[i] = <a class="code" href="group__testutilities.html#ga7125d0747a44db58115899727ac5f6be">getRandomInt</a>(-(1<<(numQubits-1)), (1<<(numQubits-1))-1);</div>
<div class="line"><a name="l03047"></a><span class="lineno"> 3047</span>  </div>
<div class="line"><a name="l03048"></a><span class="lineno"> 3048</span>  <span class="comment">// override to a random phase</span></div>
<div class="line"><a name="l03049"></a><span class="lineno"> 3049</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> overridePhases[numOverrides];</div>
<div class="line"><a name="l03050"></a><span class="lineno"> 3050</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numOverrides; i++)</div>
<div class="line"><a name="l03051"></a><span class="lineno"> 3051</span>  overridePhases[i] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-4, 4); <span class="comment">// periodic in [-pi, pi]</span></div>
<div class="line"><a name="l03052"></a><span class="lineno"> 3052</span>  </div>
<div class="line"><a name="l03053"></a><span class="lineno"> 3053</span>  <span class="comment">// build a reference diagonal matrix, on the reduced Hilbert space</span></div>
<div class="line"><a name="l03054"></a><span class="lineno"> 3054</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> matr = <a class="code" href="group__testutilities.html#ga6ccbb15b0f234e926be96a153181b63a">getZeroMatrix</a>( 1 << numQubits );</div>
<div class="line"><a name="l03055"></a><span class="lineno"> 3055</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<matr.size(); i++) {</div>
<div class="line"><a name="l03056"></a><span class="lineno"> 3056</span>  </div>
<div class="line"><a name="l03057"></a><span class="lineno"> 3057</span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <span class="keywordtype">int</span> ind = 0;</div>
<div class="line"><a name="l03058"></a><span class="lineno"> 3058</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>)</div>
<div class="line"><a name="l03059"></a><span class="lineno"> 3059</span>  ind = i;</div>
<div class="line"><a name="l03060"></a><span class="lineno"> 3060</span>  <span class="keywordflow">if</span> (encoding == <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>)</div>
<div class="line"><a name="l03061"></a><span class="lineno"> 3061</span>  ind = <a class="code" href="group__testutilities.html#ga49be3b32f7b7a274fc5ecb209fde1189">getTwosComplement</a>(i, numQubits);</div>
<div class="line"><a name="l03062"></a><span class="lineno"> 3062</span>  </div>
<div class="line"><a name="l03063"></a><span class="lineno"> 3063</span>  <span class="comment">// reference diagonal matrix incorporates overriden phases</span></div>
<div class="line"><a name="l03064"></a><span class="lineno"> 3064</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> phase;</div>
<div class="line"><a name="l03065"></a><span class="lineno"> 3065</span>  <span class="keywordtype">bool</span> overriden = <span class="keyword">false</span>;</div>
<div class="line"><a name="l03066"></a><span class="lineno"> 3066</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> v=0; v<numOverrides; v++) {</div>
<div class="line"><a name="l03067"></a><span class="lineno"> 3067</span>  <span class="keywordflow">if</span> (ind == overrideInds[v]) {</div>
<div class="line"><a name="l03068"></a><span class="lineno"> 3068</span>  phase = overridePhases[v];</div>
<div class="line"><a name="l03069"></a><span class="lineno"> 3069</span>  overriden = <span class="keyword">true</span>;</div>
<div class="line"><a name="l03070"></a><span class="lineno"> 3070</span>  <span class="keywordflow">break</span>;</div>
<div class="line"><a name="l03071"></a><span class="lineno"> 3071</span>  }</div>
<div class="line"><a name="l03072"></a><span class="lineno"> 3072</span>  }</div>
<div class="line"><a name="l03073"></a><span class="lineno"> 3073</span>  </div>
<div class="line"><a name="l03074"></a><span class="lineno"> 3074</span>  <span class="keywordflow">if</span> (!overriden) {</div>
<div class="line"><a name="l03075"></a><span class="lineno"> 3075</span>  phase = 0;</div>
<div class="line"><a name="l03076"></a><span class="lineno"> 3076</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> t=0; t<numTerms; t++)</div>
<div class="line"><a name="l03077"></a><span class="lineno"> 3077</span>  phase += coeffs[t] * pow(ind, expons[t]);</div>
<div class="line"><a name="l03078"></a><span class="lineno"> 3078</span>  }</div>
<div class="line"><a name="l03079"></a><span class="lineno"> 3079</span>  </div>
<div class="line"><a name="l03080"></a><span class="lineno"> 3080</span>  matr[i][i] = <a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(phase);</div>
<div class="line"><a name="l03081"></a><span class="lineno"> 3081</span>  } </div>
<div class="line"><a name="l03082"></a><span class="lineno"> 3082</span>  </div>
<div class="line"><a name="l03083"></a><span class="lineno"> 3083</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l03084"></a><span class="lineno"> 3084</span>  </div>
<div class="line"><a name="l03085"></a><span class="lineno"> 3085</span>  <a class="code" href="group__operator.html#gaf5344129240243ad11d0c081eb9036ab">applyPhaseFuncOverrides</a>(quregVec, qubits, numQubits, encoding, coeffs, expons, numTerms, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l03086"></a><span class="lineno"> 3086</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, qubits, numQubits, matr);</div>
<div class="line"><a name="l03087"></a><span class="lineno"> 3087</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec, 1E4*REAL_EPS) );</div>
<div class="line"><a name="l03088"></a><span class="lineno"> 3088</span>  }</div>
<div class="line"><a name="l03089"></a><span class="lineno"> 3089</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l03090"></a><span class="lineno"> 3090</span>  </div>
<div class="line"><a name="l03091"></a><span class="lineno"> 3091</span>  <a class="code" href="group__operator.html#gaf5344129240243ad11d0c081eb9036ab">applyPhaseFuncOverrides</a>(quregMatr, qubits, numQubits, encoding, coeffs, expons, numTerms, overrideInds, overridePhases, numOverrides);</div>
<div class="line"><a name="l03092"></a><span class="lineno"> 3092</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, qubits, numQubits, matr);</div>
<div class="line"><a name="l03093"></a><span class="lineno"> 3093</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 1E6*REAL_EPS) );</div>
<div class="line"><a name="l03094"></a><span class="lineno"> 3094</span>  }</div>
<div class="line"><a name="l03095"></a><span class="lineno"> 3095</span>  }</div>
<div class="line"><a name="l03096"></a><span class="lineno"> 3096</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l03097"></a><span class="lineno"> 3097</span>  </div>
<div class="line"><a name="l03098"></a><span class="lineno"> 3098</span>  <span class="keywordtype">int</span> numQubits = 3;</div>
<div class="line"><a name="l03099"></a><span class="lineno"> 3099</span>  <span class="keywordtype">int</span> qubits[] = {0,1,2};</div>
<div class="line"><a name="l03100"></a><span class="lineno"> 3100</span>  </div>
<div class="line"><a name="l03101"></a><span class="lineno"> 3101</span>  SECTION( <span class="stringliteral">"number of qubits"</span> ) {</div>
<div class="line"><a name="l03102"></a><span class="lineno"> 3102</span>  </div>
<div class="line"><a name="l03103"></a><span class="lineno"> 3103</span>  <span class="keywordtype">int</span> numQubits = GENERATE_COPY( -1, 0, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1 );</div>
<div class="line"><a name="l03104"></a><span class="lineno"> 3104</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gaf5344129240243ad11d0c081eb9036ab">applyPhaseFuncOverrides</a>(quregVec, NULL, numQubits, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, NULL, NULL, 1, NULL, NULL, 0), Contains(<span class="stringliteral">"Invalid number of qubits"</span>) );</div>
<div class="line"><a name="l03105"></a><span class="lineno"> 3105</span>  }</div>
<div class="line"><a name="l03106"></a><span class="lineno"> 3106</span>  SECTION( <span class="stringliteral">"repetition qubits"</span> ) {</div>
<div class="line"><a name="l03107"></a><span class="lineno"> 3107</span>  </div>
<div class="line"><a name="l03108"></a><span class="lineno"> 3108</span>  qubits[GENERATE(1,2)] = qubits[0];</div>
<div class="line"><a name="l03109"></a><span class="lineno"> 3109</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gaf5344129240243ad11d0c081eb9036ab">applyPhaseFuncOverrides</a>(quregVec, qubits, numQubits, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, NULL, NULL, 1, NULL, NULL, 0), Contains(<span class="stringliteral">"The qubits must be unique"</span>) );</div>
<div class="line"><a name="l03110"></a><span class="lineno"> 3110</span>  }</div>
<div class="line"><a name="l03111"></a><span class="lineno"> 3111</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l03112"></a><span class="lineno"> 3112</span>  </div>
<div class="line"><a name="l03113"></a><span class="lineno"> 3113</span>  <span class="keywordtype">int</span> inv = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l03114"></a><span class="lineno"> 3114</span>  qubits[ GENERATE_COPY( range(0,numQubits) )] = inv;</div>
<div class="line"><a name="l03115"></a><span class="lineno"> 3115</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gaf5344129240243ad11d0c081eb9036ab">applyPhaseFuncOverrides</a>(quregVec, qubits, numQubits, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, NULL, NULL, 1, NULL, NULL, 0), Contains(<span class="stringliteral">"Invalid qubit index"</span>) );</div>
<div class="line"><a name="l03116"></a><span class="lineno"> 3116</span>  }</div>
<div class="line"><a name="l03117"></a><span class="lineno"> 3117</span>  SECTION( <span class="stringliteral">"number of terms"</span> ) {</div>
<div class="line"><a name="l03118"></a><span class="lineno"> 3118</span>  </div>
<div class="line"><a name="l03119"></a><span class="lineno"> 3119</span>  <span class="keywordtype">int</span> numTerms = GENERATE( -1, 0 );</div>
<div class="line"><a name="l03120"></a><span class="lineno"> 3120</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gaf5344129240243ad11d0c081eb9036ab">applyPhaseFuncOverrides</a>(quregVec, qubits, numQubits, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, NULL, NULL, numTerms, NULL, NULL, 0), Contains(<span class="stringliteral">"Invalid number of terms in the phase function"</span>) );</div>
<div class="line"><a name="l03121"></a><span class="lineno"> 3121</span>  }</div>
<div class="line"><a name="l03122"></a><span class="lineno"> 3122</span>  SECTION( <span class="stringliteral">"bit encoding name"</span> ) {</div>
<div class="line"><a name="l03123"></a><span class="lineno"> 3123</span>  </div>
<div class="line"><a name="l03124"></a><span class="lineno"> 3124</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#ga9c91c41aa42ae537995e89ffc616afe1">bitEncoding</a> enc = (<span class="keyword">enum</span> <a class="code" href="group__type.html#ga9c91c41aa42ae537995e89ffc616afe1">bitEncoding</a>) GENERATE( -1,2 );</div>
<div class="line"><a name="l03125"></a><span class="lineno"> 3125</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gaf5344129240243ad11d0c081eb9036ab">applyPhaseFuncOverrides</a>(quregVec, qubits, numQubits, enc, NULL, NULL, 1, NULL, NULL, 0), Contains(<span class="stringliteral">"Invalid bit encoding"</span>) );</div>
<div class="line"><a name="l03126"></a><span class="lineno"> 3126</span>  }</div>
<div class="line"><a name="l03127"></a><span class="lineno"> 3127</span>  SECTION( <span class="stringliteral">"two's complement register"</span> ) {</div>
<div class="line"><a name="l03128"></a><span class="lineno"> 3128</span>  </div>
<div class="line"><a name="l03129"></a><span class="lineno"> 3129</span>  numQubits = 1;</div>
<div class="line"><a name="l03130"></a><span class="lineno"> 3130</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gaf5344129240243ad11d0c081eb9036ab">applyPhaseFuncOverrides</a>(quregVec, qubits, numQubits, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>, NULL, NULL, 1, NULL, NULL, 0), Contains(<span class="stringliteral">"too few qubits to employ TWOS_COMPLEMENT"</span>) );</div>
<div class="line"><a name="l03131"></a><span class="lineno"> 3131</span>  }</div>
<div class="line"><a name="l03132"></a><span class="lineno"> 3132</span>  SECTION( <span class="stringliteral">"number of overrides"</span> ) {</div>
<div class="line"><a name="l03133"></a><span class="lineno"> 3133</span>  </div>
<div class="line"><a name="l03134"></a><span class="lineno"> 3134</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> dummyTerms[] = {0};</div>
<div class="line"><a name="l03135"></a><span class="lineno"> 3135</span>  </div>
<div class="line"><a name="l03136"></a><span class="lineno"> 3136</span>  <span class="keywordtype">int</span> numOverrides = GENERATE_COPY( -1, 1 + (1<<numQubits) );</div>
<div class="line"><a name="l03137"></a><span class="lineno"> 3137</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gaf5344129240243ad11d0c081eb9036ab">applyPhaseFuncOverrides</a>(quregVec, qubits, numQubits, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, dummyTerms, dummyTerms, 1, NULL, NULL, numOverrides), Contains(<span class="stringliteral">"Invalid number of phase function overrides"</span>) );</div>
<div class="line"><a name="l03138"></a><span class="lineno"> 3138</span>  }</div>
<div class="line"><a name="l03139"></a><span class="lineno"> 3139</span>  SECTION( <span class="stringliteral">"override indices"</span> ) {</div>
<div class="line"><a name="l03140"></a><span class="lineno"> 3140</span>  </div>
<div class="line"><a name="l03141"></a><span class="lineno"> 3141</span>  <span class="keywordtype">int</span> numOverrides = 3;</div>
<div class="line"><a name="l03142"></a><span class="lineno"> 3142</span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <span class="keywordtype">int</span> overrideInds[] = {0,1,2};</div>
<div class="line"><a name="l03143"></a><span class="lineno"> 3143</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> overridePhases[] = {.1,.1,.1};</div>
<div class="line"><a name="l03144"></a><span class="lineno"> 3144</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> dummyTerms[] = {0};</div>
<div class="line"><a name="l03145"></a><span class="lineno"> 3145</span>  </div>
<div class="line"><a name="l03146"></a><span class="lineno"> 3146</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#ga9c91c41aa42ae537995e89ffc616afe1">bitEncoding</a> encoding = <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>;</div>
<div class="line"><a name="l03147"></a><span class="lineno"> 3147</span>  overrideInds[GENERATE(0,1,2)] = GENERATE_COPY( -1, (1<<numQubits) );</div>
<div class="line"><a name="l03148"></a><span class="lineno"> 3148</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gaf5344129240243ad11d0c081eb9036ab">applyPhaseFuncOverrides</a>(quregVec, qubits, numQubits, encoding, dummyTerms, dummyTerms, 1, overrideInds, overridePhases, numOverrides), Contains(<span class="stringliteral">"Invalid phase function override index, in the UNSIGNED encoding"</span>) );</div>
<div class="line"><a name="l03149"></a><span class="lineno"> 3149</span>  </div>
<div class="line"><a name="l03150"></a><span class="lineno"> 3150</span>  encoding = <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>;</div>
<div class="line"><a name="l03151"></a><span class="lineno"> 3151</span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <span class="keywordtype">int</span> newInds[] = {0,1,2};</div>
<div class="line"><a name="l03152"></a><span class="lineno"> 3152</span>  <span class="keywordtype">int</span> minInd = -(1<<(numQubits-1));</div>
<div class="line"><a name="l03153"></a><span class="lineno"> 3153</span>  <span class="keywordtype">int</span> maxInd = (1<<(numQubits-1)) -1;</div>
<div class="line"><a name="l03154"></a><span class="lineno"> 3154</span>  newInds[GENERATE(0,1,2)] = GENERATE_COPY( minInd-1, maxInd+1 );</div>
<div class="line"><a name="l03155"></a><span class="lineno"> 3155</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gaf5344129240243ad11d0c081eb9036ab">applyPhaseFuncOverrides</a>(quregVec, qubits, numQubits, encoding, dummyTerms, dummyTerms, 1, newInds, overridePhases, numOverrides), Contains(<span class="stringliteral">"Invalid phase function override index, in the TWOS_COMPLEMENT encoding"</span>) );</div>
<div class="line"><a name="l03156"></a><span class="lineno"> 3156</span>  }</div>
<div class="line"><a name="l03157"></a><span class="lineno"> 3157</span>  SECTION( <span class="stringliteral">"fractional exponent"</span> ) {</div>
<div class="line"><a name="l03158"></a><span class="lineno"> 3158</span>  </div>
<div class="line"><a name="l03159"></a><span class="lineno"> 3159</span>  <span class="keywordtype">int</span> numTerms = 3;</div>
<div class="line"><a name="l03160"></a><span class="lineno"> 3160</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeffs[] = {0,0,0};</div>
<div class="line"><a name="l03161"></a><span class="lineno"> 3161</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> expos[] = {1,2,3};</div>
<div class="line"><a name="l03162"></a><span class="lineno"> 3162</span>  </div>
<div class="line"><a name="l03163"></a><span class="lineno"> 3163</span>  <span class="comment">// make one exponent fractional, thereby requiring negative overrides</span></div>
<div class="line"><a name="l03164"></a><span class="lineno"> 3164</span>  expos[GENERATE_COPY( range(0,numTerms) )] = GENERATE( 0.5, 1.999, 5.0001 );</div>
<div class="line"><a name="l03165"></a><span class="lineno"> 3165</span>  </div>
<div class="line"><a name="l03166"></a><span class="lineno"> 3166</span>  <span class="comment">// catch when no negative indices are overridden</span></div>
<div class="line"><a name="l03167"></a><span class="lineno"> 3167</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gaf5344129240243ad11d0c081eb9036ab">applyPhaseFuncOverrides</a>(quregVec, qubits, numQubits, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>, coeffs, expos, numTerms, NULL, NULL, 0), Contains(<span class="stringliteral">"fractional exponent"</span>) && Contains(<span class="stringliteral">"TWOS_COMPLEMENT"</span>) && Contains(<span class="stringliteral">"negative indices were not overriden"</span>) );</div>
<div class="line"><a name="l03168"></a><span class="lineno"> 3168</span>  </div>
<div class="line"><a name="l03169"></a><span class="lineno"> 3169</span>  <span class="keywordtype">int</span> numNegs = 1 << (numQubits-1);</div>
<div class="line"><a name="l03170"></a><span class="lineno"> 3170</span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <span class="keywordtype">int</span> overrideInds[numNegs];</div>
<div class="line"><a name="l03171"></a><span class="lineno"> 3171</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> overridePhases[numNegs];</div>
<div class="line"><a name="l03172"></a><span class="lineno"> 3172</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numNegs; i++) {</div>
<div class="line"><a name="l03173"></a><span class="lineno"> 3173</span>  overrideInds[i] = -(i+1);</div>
<div class="line"><a name="l03174"></a><span class="lineno"> 3174</span>  overridePhases[i] = 0;</div>
<div class="line"><a name="l03175"></a><span class="lineno"> 3175</span>  }</div>
<div class="line"><a name="l03176"></a><span class="lineno"> 3176</span>  </div>
<div class="line"><a name="l03177"></a><span class="lineno"> 3177</span>  <span class="comment">// ensure no throw when all are overriden</span></div>
<div class="line"><a name="l03178"></a><span class="lineno"> 3178</span>  REQUIRE_NOTHROW( <a class="code" href="group__operator.html#gaf5344129240243ad11d0c081eb9036ab">applyPhaseFuncOverrides</a>(quregVec, qubits, numQubits, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>, coeffs, expos, numTerms, overrideInds, overridePhases, numNegs) );</div>
<div class="line"><a name="l03179"></a><span class="lineno"> 3179</span>  </div>
<div class="line"><a name="l03180"></a><span class="lineno"> 3180</span>  <span class="comment">// catch when at least one isn't overriden</span></div>
<div class="line"><a name="l03181"></a><span class="lineno"> 3181</span>  overrideInds[GENERATE_COPY( range(0,numNegs) )] = 0; <span class="comment">// override a non-negative</span></div>
<div class="line"><a name="l03182"></a><span class="lineno"> 3182</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gaf5344129240243ad11d0c081eb9036ab">applyPhaseFuncOverrides</a>(quregVec, qubits, numQubits, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a>, coeffs, expos, numTerms, overrideInds, overridePhases, numNegs), Contains(<span class="stringliteral">"fractional exponent"</span>) && Contains(<span class="stringliteral">"TWOS_COMPLEMENT"</span>) && Contains(<span class="stringliteral">"negative indices were not overriden"</span>) );</div>
<div class="line"><a name="l03183"></a><span class="lineno"> 3183</span>  }</div>
<div class="line"><a name="l03184"></a><span class="lineno"> 3184</span>  SECTION( <span class="stringliteral">"negative exponent"</span> ) {</div>
<div class="line"><a name="l03185"></a><span class="lineno"> 3185</span>  </div>
<div class="line"><a name="l03186"></a><span class="lineno"> 3186</span>  <span class="keywordtype">int</span> numTerms = 3;</div>
<div class="line"><a name="l03187"></a><span class="lineno"> 3187</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeffs[] = {0,0,0};</div>
<div class="line"><a name="l03188"></a><span class="lineno"> 3188</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> expos[] = {1,2,3};</div>
<div class="line"><a name="l03189"></a><span class="lineno"> 3189</span>  expos[GENERATE_COPY( range(0,numTerms) )] = GENERATE( -1, -2 );</div>
<div class="line"><a name="l03190"></a><span class="lineno"> 3190</span>  </div>
<div class="line"><a name="l03191"></a><span class="lineno"> 3191</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#ga9c91c41aa42ae537995e89ffc616afe1">bitEncoding</a> encoding = GENERATE( <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a>, <a class="code" href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a> );</div>
<div class="line"><a name="l03192"></a><span class="lineno"> 3192</span>  </div>
<div class="line"><a name="l03193"></a><span class="lineno"> 3193</span>  <span class="comment">// test both when giving no overrides, and giving all non-zero overrides</span></div>
<div class="line"><a name="l03194"></a><span class="lineno"> 3194</span>  <span class="keywordtype">int</span> numOverrides = GENERATE( 0, 3 ); </div>
<div class="line"><a name="l03195"></a><span class="lineno"> 3195</span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <span class="keywordtype">int</span> overrideInds[] = {1,2,3};</div>
<div class="line"><a name="l03196"></a><span class="lineno"> 3196</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> overridePhases[] = {0,0,0};</div>
<div class="line"><a name="l03197"></a><span class="lineno"> 3197</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#gaf5344129240243ad11d0c081eb9036ab">applyPhaseFuncOverrides</a>(quregVec, qubits, numQubits, encoding, coeffs, expos, numTerms, overrideInds, overridePhases, numOverrides), Contains(<span class="stringliteral">"The phase function contained a negative exponent which would diverge at zero, but the zero index was not overriden"</span>) );</div>
<div class="line"><a name="l03198"></a><span class="lineno"> 3198</span>  </div>
<div class="line"><a name="l03199"></a><span class="lineno"> 3199</span>  <span class="comment">// but ensure that when the zero IS overriden (anywhere), there's no error </span></div>
<div class="line"><a name="l03200"></a><span class="lineno"> 3200</span>  numOverrides = 3;</div>
<div class="line"><a name="l03201"></a><span class="lineno"> 3201</span>  overrideInds[GENERATE_COPY(range(0,numOverrides))] = 0;</div>
<div class="line"><a name="l03202"></a><span class="lineno"> 3202</span>  REQUIRE_NOTHROW( <a class="code" href="group__operator.html#gaf5344129240243ad11d0c081eb9036ab">applyPhaseFuncOverrides</a>(quregVec, qubits, numQubits, encoding, coeffs, expos, numTerms, overrideInds, overridePhases, numOverrides) );</div>
<div class="line"><a name="l03203"></a><span class="lineno"> 3203</span>  }</div>
<div class="line"><a name="l03204"></a><span class="lineno"> 3204</span>  }</div>
<div class="line"><a name="l03205"></a><span class="lineno"> 3205</span>  <a class="code" href="test__operators_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l03206"></a><span class="lineno"> 3206</span> }</div>
<div class="line"><a name="l03207"></a><span class="lineno"> 3207</span>  </div>
<div class="line"><a name="l03208"></a><span class="lineno"> 3208</span>  </div>
<div class="line"><a name="l03209"></a><span class="lineno"> 3209</span>  </div>
<div class="line"><a name="l03214"></a><span class="lineno"><a class="line" href="group__unittest.html#gaa72a7f3d6425f04b1e3a8ebb4487ba5e"> 3214</a></span> <a class="code" href="group__unittest.html#gaff6822e79b947a9e3b791572c674c08c">TEST_CASE</a>( <span class="stringliteral">"applyProjector"</span>, <span class="stringliteral">"[operators]"</span> ) {</div>
<div class="line"><a name="l03215"></a><span class="lineno"> 3215</span>  </div>
<div class="line"><a name="l03216"></a><span class="lineno"> 3216</span>  <a class="code" href="structQureg.html">Qureg</a> vec = <a class="code" href="group__type.html#ga3392816c0643414165c2f5caeec17df0">createQureg</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l03217"></a><span class="lineno"> 3217</span>  <a class="code" href="structQureg.html">Qureg</a> mat = <a class="code" href="group__type.html#ga93e55b6650b408abb30a1d4a8bce757c">createDensityQureg</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l03218"></a><span class="lineno"> 3218</span>  </div>
<div class="line"><a name="l03219"></a><span class="lineno"> 3219</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l03220"></a><span class="lineno"> 3220</span>  </div>
<div class="line"><a name="l03221"></a><span class="lineno"> 3221</span>  <span class="keywordtype">int</span> qubit = GENERATE( range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) );</div>
<div class="line"><a name="l03222"></a><span class="lineno"> 3222</span>  <span class="keywordtype">int</span> outcome = GENERATE( 0, 1 );</div>
<div class="line"><a name="l03223"></a><span class="lineno"> 3223</span>  </div>
<div class="line"><a name="l03224"></a><span class="lineno"> 3224</span>  <span class="comment">// repeat these random tests 10 times on every qubit, and for both outcomes</span></div>
<div class="line"><a name="l03225"></a><span class="lineno"> 3225</span>  GENERATE( range(0,10) );</div>
<div class="line"><a name="l03226"></a><span class="lineno"> 3226</span>  </div>
<div class="line"><a name="l03227"></a><span class="lineno"> 3227</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l03228"></a><span class="lineno"> 3228</span>  </div>
<div class="line"><a name="l03229"></a><span class="lineno"> 3229</span>  SECTION( <span class="stringliteral">"normalised"</span> ) {</div>
<div class="line"><a name="l03230"></a><span class="lineno"> 3230</span>  </div>
<div class="line"><a name="l03231"></a><span class="lineno"> 3231</span>  <span class="comment">// use a random L2 state for every qubit & outcome</span></div>
<div class="line"><a name="l03232"></a><span class="lineno"> 3232</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> vecRef = <a class="code" href="group__testutilities.html#gae1d2eb70b50267f8186cbd53e300d94f">getRandomStateVector</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>);</div>
<div class="line"><a name="l03233"></a><span class="lineno"> 3233</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(vec, vecRef);</div>
<div class="line"><a name="l03234"></a><span class="lineno"> 3234</span>  </div>
<div class="line"><a name="l03235"></a><span class="lineno"> 3235</span>  <span class="comment">// zero non-outcome reference amps</span></div>
<div class="line"><a name="l03236"></a><span class="lineno"> 3236</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> ind=0; ind<vecRef.size(); ind++) {</div>
<div class="line"><a name="l03237"></a><span class="lineno"> 3237</span>  <span class="keywordtype">int</span> bit = (ind >> qubit) & 1; <span class="comment">// target-th bit</span></div>
<div class="line"><a name="l03238"></a><span class="lineno"> 3238</span>  <span class="keywordflow">if</span> (bit != outcome)</div>
<div class="line"><a name="l03239"></a><span class="lineno"> 3239</span>  vecRef[ind] = 0;</div>
<div class="line"><a name="l03240"></a><span class="lineno"> 3240</span>  }</div>
<div class="line"><a name="l03241"></a><span class="lineno"> 3241</span>  </div>
<div class="line"><a name="l03242"></a><span class="lineno"> 3242</span>  <a class="code" href="group__operator.html#ga26db8b8a8a242d388c291e50d228ab18">applyProjector</a>(vec, qubit, outcome);</div>
<div class="line"><a name="l03243"></a><span class="lineno"> 3243</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vec, vecRef) );</div>
<div class="line"><a name="l03244"></a><span class="lineno"> 3244</span>  }</div>
<div class="line"><a name="l03245"></a><span class="lineno"> 3245</span>  SECTION( <span class="stringliteral">"unnormalised"</span> ) {</div>
<div class="line"><a name="l03246"></a><span class="lineno"> 3246</span>  </div>
<div class="line"><a name="l03247"></a><span class="lineno"> 3247</span>  <span class="comment">// use a random non-physical state for every qubit & outcome</span></div>
<div class="line"><a name="l03248"></a><span class="lineno"> 3248</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> vecRef = <a class="code" href="group__testutilities.html#ga27dc818709394cb31247e26850215f8a">getRandomQVector</a>(1 << <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>);</div>
<div class="line"><a name="l03249"></a><span class="lineno"> 3249</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(vec, vecRef);</div>
<div class="line"><a name="l03250"></a><span class="lineno"> 3250</span>  </div>
<div class="line"><a name="l03251"></a><span class="lineno"> 3251</span>  <span class="comment">// zero non-outcome reference amps</span></div>
<div class="line"><a name="l03252"></a><span class="lineno"> 3252</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> ind=0; ind<vecRef.size(); ind++) {</div>
<div class="line"><a name="l03253"></a><span class="lineno"> 3253</span>  <span class="keywordtype">int</span> bit = (ind >> qubit) & 1; <span class="comment">// target-th bit</span></div>
<div class="line"><a name="l03254"></a><span class="lineno"> 3254</span>  <span class="keywordflow">if</span> (bit != outcome)</div>
<div class="line"><a name="l03255"></a><span class="lineno"> 3255</span>  vecRef[ind] = 0;</div>
<div class="line"><a name="l03256"></a><span class="lineno"> 3256</span>  }</div>
<div class="line"><a name="l03257"></a><span class="lineno"> 3257</span>  </div>
<div class="line"><a name="l03258"></a><span class="lineno"> 3258</span>  <a class="code" href="group__operator.html#ga26db8b8a8a242d388c291e50d228ab18">applyProjector</a>(vec, qubit, outcome);</div>
<div class="line"><a name="l03259"></a><span class="lineno"> 3259</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vec, vecRef) );</div>
<div class="line"><a name="l03260"></a><span class="lineno"> 3260</span>  }</div>
<div class="line"><a name="l03261"></a><span class="lineno"> 3261</span>  } </div>
<div class="line"><a name="l03262"></a><span class="lineno"> 3262</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l03263"></a><span class="lineno"> 3263</span>  </div>
<div class="line"><a name="l03264"></a><span class="lineno"> 3264</span>  SECTION( <span class="stringliteral">"pure"</span> ) {</div>
<div class="line"><a name="l03265"></a><span class="lineno"> 3265</span>  </div>
<div class="line"><a name="l03266"></a><span class="lineno"> 3266</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> vecRef = <a class="code" href="group__testutilities.html#gae1d2eb70b50267f8186cbd53e300d94f">getRandomStateVector</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>);</div>
<div class="line"><a name="l03267"></a><span class="lineno"> 3267</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> matRef = <a class="code" href="group__testutilities.html#gaecd1e4149d03d358fc4e64c335e823ef">getPureDensityMatrix</a>(vecRef);</div>
<div class="line"><a name="l03268"></a><span class="lineno"> 3268</span>  </div>
<div class="line"><a name="l03269"></a><span class="lineno"> 3269</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat, matRef);</div>
<div class="line"><a name="l03270"></a><span class="lineno"> 3270</span>  <a class="code" href="group__operator.html#ga26db8b8a8a242d388c291e50d228ab18">applyProjector</a>(mat, qubit, outcome);</div>
<div class="line"><a name="l03271"></a><span class="lineno"> 3271</span>  </div>
<div class="line"><a name="l03272"></a><span class="lineno"> 3272</span>  <span class="comment">// zero any amplitudes that aren't |outcome><outcome|</span></div>
<div class="line"><a name="l03273"></a><span class="lineno"> 3273</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> r=0; r<matRef.size(); r++) {</div>
<div class="line"><a name="l03274"></a><span class="lineno"> 3274</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> c=0; c<matRef.size(); c++) {</div>
<div class="line"><a name="l03275"></a><span class="lineno"> 3275</span>  <span class="keywordtype">int</span> ketBit = (c >> qubit) & 1;</div>
<div class="line"><a name="l03276"></a><span class="lineno"> 3276</span>  <span class="keywordtype">int</span> braBit = (r >> qubit) & 1;</div>
<div class="line"><a name="l03277"></a><span class="lineno"> 3277</span>  <span class="keywordflow">if</span> (!(ketBit == outcome && braBit == outcome))</div>
<div class="line"><a name="l03278"></a><span class="lineno"> 3278</span>  matRef[r][c] = 0;</div>
<div class="line"><a name="l03279"></a><span class="lineno"> 3279</span>  }</div>
<div class="line"><a name="l03280"></a><span class="lineno"> 3280</span>  }</div>
<div class="line"><a name="l03281"></a><span class="lineno"> 3281</span>  </div>
<div class="line"><a name="l03282"></a><span class="lineno"> 3282</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(mat, matRef) );</div>
<div class="line"><a name="l03283"></a><span class="lineno"> 3283</span>  }</div>
<div class="line"><a name="l03284"></a><span class="lineno"> 3284</span>  SECTION( <span class="stringliteral">"mixed"</span> ) {</div>
<div class="line"><a name="l03285"></a><span class="lineno"> 3285</span>  </div>
<div class="line"><a name="l03286"></a><span class="lineno"> 3286</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> matRef = <a class="code" href="group__testutilities.html#ga617b0fd1eb1c395762c937ad3b23e61b">getRandomDensityMatrix</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>);</div>
<div class="line"><a name="l03287"></a><span class="lineno"> 3287</span>  </div>
<div class="line"><a name="l03288"></a><span class="lineno"> 3288</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat, matRef);</div>
<div class="line"><a name="l03289"></a><span class="lineno"> 3289</span>  <a class="code" href="group__operator.html#ga26db8b8a8a242d388c291e50d228ab18">applyProjector</a>(mat, qubit, outcome);</div>
<div class="line"><a name="l03290"></a><span class="lineno"> 3290</span>  </div>
<div class="line"><a name="l03291"></a><span class="lineno"> 3291</span>  <span class="comment">// zero any amplitudes that aren't |outcome><outcome|</span></div>
<div class="line"><a name="l03292"></a><span class="lineno"> 3292</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> r=0; r<matRef.size(); r++) {</div>
<div class="line"><a name="l03293"></a><span class="lineno"> 3293</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> c=0; c<matRef.size(); c++) {</div>
<div class="line"><a name="l03294"></a><span class="lineno"> 3294</span>  <span class="keywordtype">int</span> ketBit = (c >> qubit) & 1;</div>
<div class="line"><a name="l03295"></a><span class="lineno"> 3295</span>  <span class="keywordtype">int</span> braBit = (r >> qubit) & 1;</div>
<div class="line"><a name="l03296"></a><span class="lineno"> 3296</span>  <span class="keywordflow">if</span> (!(ketBit == outcome && braBit == outcome))</div>
<div class="line"><a name="l03297"></a><span class="lineno"> 3297</span>  matRef[r][c] = 0;</div>
<div class="line"><a name="l03298"></a><span class="lineno"> 3298</span>  }</div>
<div class="line"><a name="l03299"></a><span class="lineno"> 3299</span>  }</div>
<div class="line"><a name="l03300"></a><span class="lineno"> 3300</span>  </div>
<div class="line"><a name="l03301"></a><span class="lineno"> 3301</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(mat, matRef) );</div>
<div class="line"><a name="l03302"></a><span class="lineno"> 3302</span>  }</div>
<div class="line"><a name="l03303"></a><span class="lineno"> 3303</span>  SECTION( <span class="stringliteral">"unnormalised"</span> ) {</div>
<div class="line"><a name="l03304"></a><span class="lineno"> 3304</span>  </div>
<div class="line"><a name="l03305"></a><span class="lineno"> 3305</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> matRef = <a class="code" href="group__testutilities.html#gaa2e8b958e0cba07e01de9f91a5ce3c9c">getRandomQMatrix</a>(1 << <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>);</div>
<div class="line"><a name="l03306"></a><span class="lineno"> 3306</span>  </div>
<div class="line"><a name="l03307"></a><span class="lineno"> 3307</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat, matRef);</div>
<div class="line"><a name="l03308"></a><span class="lineno"> 3308</span>  <a class="code" href="group__operator.html#ga26db8b8a8a242d388c291e50d228ab18">applyProjector</a>(mat, qubit, outcome);</div>
<div class="line"><a name="l03309"></a><span class="lineno"> 3309</span>  </div>
<div class="line"><a name="l03310"></a><span class="lineno"> 3310</span>  <span class="comment">// zero any amplitudes that aren't |outcome><outcome|</span></div>
<div class="line"><a name="l03311"></a><span class="lineno"> 3311</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> r=0; r<matRef.size(); r++) {</div>
<div class="line"><a name="l03312"></a><span class="lineno"> 3312</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> c=0; c<matRef.size(); c++) {</div>
<div class="line"><a name="l03313"></a><span class="lineno"> 3313</span>  <span class="keywordtype">int</span> ketBit = (c >> qubit) & 1;</div>
<div class="line"><a name="l03314"></a><span class="lineno"> 3314</span>  <span class="keywordtype">int</span> braBit = (r >> qubit) & 1;</div>
<div class="line"><a name="l03315"></a><span class="lineno"> 3315</span>  <span class="keywordflow">if</span> (!(ketBit == outcome && braBit == outcome))</div>
<div class="line"><a name="l03316"></a><span class="lineno"> 3316</span>  matRef[r][c] = 0;</div>
<div class="line"><a name="l03317"></a><span class="lineno"> 3317</span>  }</div>
<div class="line"><a name="l03318"></a><span class="lineno"> 3318</span>  }</div>
<div class="line"><a name="l03319"></a><span class="lineno"> 3319</span>  </div>
<div class="line"><a name="l03320"></a><span class="lineno"> 3320</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(mat, matRef) );</div>
<div class="line"><a name="l03321"></a><span class="lineno"> 3321</span>  }</div>
<div class="line"><a name="l03322"></a><span class="lineno"> 3322</span>  }</div>
<div class="line"><a name="l03323"></a><span class="lineno"> 3323</span>  }</div>
<div class="line"><a name="l03324"></a><span class="lineno"> 3324</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l03325"></a><span class="lineno"> 3325</span>  </div>
<div class="line"><a name="l03326"></a><span class="lineno"> 3326</span>  SECTION( <span class="stringliteral">"qubit index"</span> ) {</div>
<div class="line"><a name="l03327"></a><span class="lineno"> 3327</span>  </div>
<div class="line"><a name="l03328"></a><span class="lineno"> 3328</span>  <span class="keywordtype">int</span> qubit = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l03329"></a><span class="lineno"> 3329</span>  <span class="keywordtype">int</span> outcome = 0;</div>
<div class="line"><a name="l03330"></a><span class="lineno"> 3330</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga26db8b8a8a242d388c291e50d228ab18">applyProjector</a>(mat, qubit, outcome), Contains(<span class="stringliteral">"Invalid target qubit"</span>) );</div>
<div class="line"><a name="l03331"></a><span class="lineno"> 3331</span>  }</div>
<div class="line"><a name="l03332"></a><span class="lineno"> 3332</span>  SECTION( <span class="stringliteral">"outcome value"</span> ) {</div>
<div class="line"><a name="l03333"></a><span class="lineno"> 3333</span>  </div>
<div class="line"><a name="l03334"></a><span class="lineno"> 3334</span>  <span class="keywordtype">int</span> qubit = 0;</div>
<div class="line"><a name="l03335"></a><span class="lineno"> 3335</span>  <span class="keywordtype">int</span> outcome = GENERATE( -1, 2 );</div>
<div class="line"><a name="l03336"></a><span class="lineno"> 3336</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga26db8b8a8a242d388c291e50d228ab18">applyProjector</a>(mat, qubit, outcome), Contains(<span class="stringliteral">"Invalid measurement outcome"</span>) );</div>
<div class="line"><a name="l03337"></a><span class="lineno"> 3337</span>  }</div>
<div class="line"><a name="l03338"></a><span class="lineno"> 3338</span>  }</div>
<div class="line"><a name="l03339"></a><span class="lineno"> 3339</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(vec, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l03340"></a><span class="lineno"> 3340</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(mat, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l03341"></a><span class="lineno"> 3341</span> }</div>
<div class="line"><a name="l03342"></a><span class="lineno"> 3342</span>  </div>
<div class="line"><a name="l03343"></a><span class="lineno"> 3343</span>  </div>
<div class="line"><a name="l03344"></a><span class="lineno"> 3344</span>  </div>
<div class="line"><a name="l03349"></a><span class="lineno"><a class="line" href="group__unittest.html#ga5731cef400dd2ad09f62ce3b4213fa49"> 3349</a></span> <a class="code" href="group__unittest.html#gaff6822e79b947a9e3b791572c674c08c">TEST_CASE</a>( <span class="stringliteral">"applyQFT"</span>, <span class="stringliteral">"[operators]"</span> ) {</div>
<div class="line"><a name="l03350"></a><span class="lineno"> 3350</span>  </div>
<div class="line"><a name="l03351"></a><span class="lineno"> 3351</span>  <a class="code" href="test__operators_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l03352"></a><span class="lineno"> 3352</span>  </div>
<div class="line"><a name="l03353"></a><span class="lineno"> 3353</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l03354"></a><span class="lineno"> 3354</span>  </div>
<div class="line"><a name="l03355"></a><span class="lineno"> 3355</span>  <span class="comment">// try every sub-register size</span></div>
<div class="line"><a name="l03356"></a><span class="lineno"> 3356</span>  <span class="keywordtype">int</span> numQubits = GENERATE_COPY( range(1,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1) );</div>
<div class="line"><a name="l03357"></a><span class="lineno"> 3357</span>  </div>
<div class="line"><a name="l03358"></a><span class="lineno"> 3358</span>  <span class="comment">// try every possible sub-register</span></div>
<div class="line"><a name="l03359"></a><span class="lineno"> 3359</span>  <span class="keywordtype">int</span>* qubits = GENERATE_COPY( <a class="code" href="group__testutilities.html#ga35add15146aa606b256df79334b867d5">sublists</a>(range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>), numQubits) );</div>
<div class="line"><a name="l03360"></a><span class="lineno"> 3360</span>  </div>
<div class="line"><a name="l03361"></a><span class="lineno"> 3361</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l03362"></a><span class="lineno"> 3362</span>  </div>
<div class="line"><a name="l03363"></a><span class="lineno"> 3363</span>  SECTION( <span class="stringliteral">"normalised"</span> ) {</div>
<div class="line"><a name="l03364"></a><span class="lineno"> 3364</span>  </div>
<div class="line"><a name="l03365"></a><span class="lineno"> 3365</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> refVec = <a class="code" href="group__testutilities.html#gae1d2eb70b50267f8186cbd53e300d94f">getRandomStateVector</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>);</div>
<div class="line"><a name="l03366"></a><span class="lineno"> 3366</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(quregVec, refVec);</div>
<div class="line"><a name="l03367"></a><span class="lineno"> 3367</span>  </div>
<div class="line"><a name="l03368"></a><span class="lineno"> 3368</span>  <a class="code" href="group__operator.html#ga9bc8c4ab44f8233b5766208a0b1c0776">applyQFT</a>(quregVec, qubits, numQubits);</div>
<div class="line"><a name="l03369"></a><span class="lineno"> 3369</span>  refVec = <a class="code" href="group__testutilities.html#ga7ed0c22ff6b671eecccef4dac54bd6c1">getDFT</a>(refVec, qubits, numQubits);</div>
<div class="line"><a name="l03370"></a><span class="lineno"> 3370</span>  </div>
<div class="line"><a name="l03371"></a><span class="lineno"> 3371</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l03372"></a><span class="lineno"> 3372</span>  }</div>
<div class="line"><a name="l03373"></a><span class="lineno"> 3373</span>  SECTION( <span class="stringliteral">"unnormalised"</span> ) {</div>
<div class="line"><a name="l03374"></a><span class="lineno"> 3374</span>  </div>
<div class="line"><a name="l03375"></a><span class="lineno"> 3375</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> refVec = <a class="code" href="group__testutilities.html#ga27dc818709394cb31247e26850215f8a">getRandomQVector</a>(1 << <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>);</div>
<div class="line"><a name="l03376"></a><span class="lineno"> 3376</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(quregVec, refVec);</div>
<div class="line"><a name="l03377"></a><span class="lineno"> 3377</span>  </div>
<div class="line"><a name="l03378"></a><span class="lineno"> 3378</span>  <a class="code" href="group__operator.html#ga9bc8c4ab44f8233b5766208a0b1c0776">applyQFT</a>(quregVec, qubits, numQubits);</div>
<div class="line"><a name="l03379"></a><span class="lineno"> 3379</span>  refVec = <a class="code" href="group__testutilities.html#ga7ed0c22ff6b671eecccef4dac54bd6c1">getDFT</a>(refVec, qubits, numQubits);</div>
<div class="line"><a name="l03380"></a><span class="lineno"> 3380</span>  </div>
<div class="line"><a name="l03381"></a><span class="lineno"> 3381</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l03382"></a><span class="lineno"> 3382</span>  }</div>
<div class="line"><a name="l03383"></a><span class="lineno"> 3383</span>  }</div>
<div class="line"><a name="l03384"></a><span class="lineno"> 3384</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l03385"></a><span class="lineno"> 3385</span>  </div>
<div class="line"><a name="l03386"></a><span class="lineno"> 3386</span>  SECTION( <span class="stringliteral">"pure"</span> ) {</div>
<div class="line"><a name="l03387"></a><span class="lineno"> 3387</span>  </div>
<div class="line"><a name="l03388"></a><span class="lineno"> 3388</span>  <span class="comment">/* a pure density matrix should be mapped to a pure state </span></div>
<div class="line"><a name="l03389"></a><span class="lineno"> 3389</span> <span class="comment"> * corresponding to the state-vector DFT</span></div>
<div class="line"><a name="l03390"></a><span class="lineno"> 3390</span> <span class="comment"> */</span></div>
<div class="line"><a name="l03391"></a><span class="lineno"> 3391</span>  </div>
<div class="line"><a name="l03392"></a><span class="lineno"> 3392</span>  refVec = <a class="code" href="group__testutilities.html#gae1d2eb70b50267f8186cbd53e300d94f">getRandomStateVector</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>);</div>
<div class="line"><a name="l03393"></a><span class="lineno"> 3393</span>  refMatr = <a class="code" href="group__testutilities.html#gaecd1e4149d03d358fc4e64c335e823ef">getPureDensityMatrix</a>(refVec);</div>
<div class="line"><a name="l03394"></a><span class="lineno"> 3394</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(quregMatr, refMatr);</div>
<div class="line"><a name="l03395"></a><span class="lineno"> 3395</span>  </div>
<div class="line"><a name="l03396"></a><span class="lineno"> 3396</span>  <a class="code" href="group__operator.html#ga9bc8c4ab44f8233b5766208a0b1c0776">applyQFT</a>(quregMatr, qubits, numQubits);</div>
<div class="line"><a name="l03397"></a><span class="lineno"> 3397</span>  refVec = <a class="code" href="group__testutilities.html#ga7ed0c22ff6b671eecccef4dac54bd6c1">getDFT</a>(refVec, qubits, numQubits);</div>
<div class="line"><a name="l03398"></a><span class="lineno"> 3398</span>  refMatr = <a class="code" href="group__testutilities.html#gaecd1e4149d03d358fc4e64c335e823ef">getPureDensityMatrix</a>(refVec);</div>
<div class="line"><a name="l03399"></a><span class="lineno"> 3399</span>  </div>
<div class="line"><a name="l03400"></a><span class="lineno"> 3400</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</div>
<div class="line"><a name="l03401"></a><span class="lineno"> 3401</span>  }</div>
<div class="line"><a name="l03402"></a><span class="lineno"> 3402</span>  SECTION( <span class="stringliteral">"mixed"</span> ) {</div>
<div class="line"><a name="l03403"></a><span class="lineno"> 3403</span>  </div>
<div class="line"><a name="l03404"></a><span class="lineno"> 3404</span>  <span class="comment">/* a mixed density matrix, conceptualised as a mixture of orthogonal</span></div>
<div class="line"><a name="l03405"></a><span class="lineno"> 3405</span> <span class="comment"> * state-vectors, should be mapped to an equally weighted mixture </span></div>
<div class="line"><a name="l03406"></a><span class="lineno"> 3406</span> <span class="comment"> * of DFTs of each state-vector (because QFT is unitary and hence </span></div>
<div class="line"><a name="l03407"></a><span class="lineno"> 3407</span> <span class="comment"> * maintains state orthogonality)</span></div>
<div class="line"><a name="l03408"></a><span class="lineno"> 3408</span> <span class="comment"> */</span></div>
<div class="line"><a name="l03409"></a><span class="lineno"> 3409</span>  </div>
<div class="line"><a name="l03410"></a><span class="lineno"> 3410</span>  <span class="keywordtype">int</span> numStates = (1 << <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>)/4; <span class="comment">// a quarter of as many states as are possible</span></div>
<div class="line"><a name="l03411"></a><span class="lineno"> 3411</span>  std::vector<QVector> states = <a class="code" href="group__testutilities.html#ga2ce759464ecc923710890d633c03bcca">getRandomOrthonormalVectors</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, numStates);</div>
<div class="line"><a name="l03412"></a><span class="lineno"> 3412</span>  std::vector<qreal> probs = <a class="code" href="group__testutilities.html#gaa6a22a9144876cee28d54b70ea556527">getRandomProbabilities</a>(numStates);</div>
<div class="line"><a name="l03413"></a><span class="lineno"> 3413</span>  </div>
<div class="line"><a name="l03414"></a><span class="lineno"> 3414</span>  <span class="comment">// set qureg to random mixture of state-vectors</span></div>
<div class="line"><a name="l03415"></a><span class="lineno"> 3415</span>  refMatr = <a class="code" href="group__testutilities.html#gad6435da46323045d81e4ba9d9fe5a109">getMixedDensityMatrix</a>(probs, states);</div>
<div class="line"><a name="l03416"></a><span class="lineno"> 3416</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(quregMatr, refMatr);</div>
<div class="line"><a name="l03417"></a><span class="lineno"> 3417</span>  </div>
<div class="line"><a name="l03418"></a><span class="lineno"> 3418</span>  <span class="comment">// apply QFT to mixture</span></div>
<div class="line"><a name="l03419"></a><span class="lineno"> 3419</span>  <a class="code" href="group__operator.html#ga9bc8c4ab44f8233b5766208a0b1c0776">applyQFT</a>(quregMatr, qubits, numQubits);</div>
<div class="line"><a name="l03420"></a><span class="lineno"> 3420</span>  </div>
<div class="line"><a name="l03421"></a><span class="lineno"> 3421</span>  <span class="comment">// compute dft of mixture, via dft of each state</span></div>
<div class="line"><a name="l03422"></a><span class="lineno"> 3422</span>  refMatr = <a class="code" href="group__testutilities.html#ga6ccbb15b0f234e926be96a153181b63a">getZeroMatrix</a>(1 << <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>);</div>
<div class="line"><a name="l03423"></a><span class="lineno"> 3423</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numStates; i++) {</div>
<div class="line"><a name="l03424"></a><span class="lineno"> 3424</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> dft = <a class="code" href="group__testutilities.html#ga7ed0c22ff6b671eecccef4dac54bd6c1">getDFT</a>(states[i], qubits, numQubits);</div>
<div class="line"><a name="l03425"></a><span class="lineno"> 3425</span>  refMatr += probs[i] * <a class="code" href="group__testutilities.html#gaecd1e4149d03d358fc4e64c335e823ef">getPureDensityMatrix</a>(dft);</div>
<div class="line"><a name="l03426"></a><span class="lineno"> 3426</span>  }</div>
<div class="line"><a name="l03427"></a><span class="lineno"> 3427</span>  </div>
<div class="line"><a name="l03428"></a><span class="lineno"> 3428</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</div>
<div class="line"><a name="l03429"></a><span class="lineno"> 3429</span>  }</div>
<div class="line"><a name="l03430"></a><span class="lineno"> 3430</span>  SECTION( <span class="stringliteral">"unnormalised"</span> ) {</div>
<div class="line"><a name="l03431"></a><span class="lineno"> 3431</span>  </div>
<div class="line"><a name="l03432"></a><span class="lineno"> 3432</span>  <span class="comment">/* repeat method above, except that we use unnormalised vectors, </span></div>
<div class="line"><a name="l03433"></a><span class="lineno"> 3433</span> <span class="comment"> * and mix them with arbitrary complex numbers instead of probabilities,</span></div>
<div class="line"><a name="l03434"></a><span class="lineno"> 3434</span> <span class="comment"> * yielding an unnormalised density matrix </span></div>
<div class="line"><a name="l03435"></a><span class="lineno"> 3435</span> <span class="comment"> */</span></div>
<div class="line"><a name="l03436"></a><span class="lineno"> 3436</span>  </div>
<div class="line"><a name="l03437"></a><span class="lineno"> 3437</span>  <span class="keywordtype">int</span> numVecs = (1 << <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>)/4; <span class="comment">// a quarter of as many states as are possible</span></div>
<div class="line"><a name="l03438"></a><span class="lineno"> 3438</span>  std::vector<QVector> vecs;</div>
<div class="line"><a name="l03439"></a><span class="lineno"> 3439</span>  std::vector<qcomp> coeffs;</div>
<div class="line"><a name="l03440"></a><span class="lineno"> 3440</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numVecs; i++) {</div>
<div class="line"><a name="l03441"></a><span class="lineno"> 3441</span>  vecs.push_back(<a class="code" href="group__testutilities.html#ga27dc818709394cb31247e26850215f8a">getRandomQVector</a>(1 << <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>));</div>
<div class="line"><a name="l03442"></a><span class="lineno"> 3442</span>  coeffs.push_back(<a class="code" href="group__testutilities.html#ga723de136e368b9de0ac391f850d409ac">getRandomComplex</a>());</div>
<div class="line"><a name="l03443"></a><span class="lineno"> 3443</span>  }</div>
<div class="line"><a name="l03444"></a><span class="lineno"> 3444</span>  </div>
<div class="line"><a name="l03445"></a><span class="lineno"> 3445</span>  <span class="comment">// produce unnormalised matrix via random complex sum of random unnormalised vectors</span></div>
<div class="line"><a name="l03446"></a><span class="lineno"> 3446</span>  refMatr = <a class="code" href="group__testutilities.html#ga6ccbb15b0f234e926be96a153181b63a">getZeroMatrix</a>(1 << <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>);</div>
<div class="line"><a name="l03447"></a><span class="lineno"> 3447</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numVecs; i++)</div>
<div class="line"><a name="l03448"></a><span class="lineno"> 3448</span>  refMatr += coeffs[i] * <a class="code" href="group__testutilities.html#gaecd1e4149d03d358fc4e64c335e823ef">getPureDensityMatrix</a>(vecs[i]);</div>
<div class="line"><a name="l03449"></a><span class="lineno"> 3449</span>  </div>
<div class="line"><a name="l03450"></a><span class="lineno"> 3450</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(quregMatr, refMatr);</div>
<div class="line"><a name="l03451"></a><span class="lineno"> 3451</span>  <a class="code" href="group__operator.html#ga9bc8c4ab44f8233b5766208a0b1c0776">applyQFT</a>(quregMatr, qubits, numQubits);</div>
<div class="line"><a name="l03452"></a><span class="lineno"> 3452</span>  </div>
<div class="line"><a name="l03453"></a><span class="lineno"> 3453</span>  <span class="comment">// compute target matrix via dft of each unnormalised vector </span></div>
<div class="line"><a name="l03454"></a><span class="lineno"> 3454</span>  refMatr = <a class="code" href="group__testutilities.html#ga6ccbb15b0f234e926be96a153181b63a">getZeroMatrix</a>(1 << <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>);</div>
<div class="line"><a name="l03455"></a><span class="lineno"> 3455</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numVecs; i++) {</div>
<div class="line"><a name="l03456"></a><span class="lineno"> 3456</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> dft = <a class="code" href="group__testutilities.html#ga7ed0c22ff6b671eecccef4dac54bd6c1">getDFT</a>(vecs[i], qubits, numQubits);</div>
<div class="line"><a name="l03457"></a><span class="lineno"> 3457</span>  refMatr += coeffs[i] * <a class="code" href="group__testutilities.html#gaecd1e4149d03d358fc4e64c335e823ef">getPureDensityMatrix</a>(dft);</div>
<div class="line"><a name="l03458"></a><span class="lineno"> 3458</span>  }</div>
<div class="line"><a name="l03459"></a><span class="lineno"> 3459</span>  </div>
<div class="line"><a name="l03460"></a><span class="lineno"> 3460</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</div>
<div class="line"><a name="l03461"></a><span class="lineno"> 3461</span>  }</div>
<div class="line"><a name="l03462"></a><span class="lineno"> 3462</span>  }</div>
<div class="line"><a name="l03463"></a><span class="lineno"> 3463</span>  }</div>
<div class="line"><a name="l03464"></a><span class="lineno"> 3464</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l03465"></a><span class="lineno"> 3465</span>  </div>
<div class="line"><a name="l03466"></a><span class="lineno"> 3466</span>  SECTION( <span class="stringliteral">"number of targets"</span> ) {</div>
<div class="line"><a name="l03467"></a><span class="lineno"> 3467</span>  </div>
<div class="line"><a name="l03468"></a><span class="lineno"> 3468</span>  <span class="comment">// there cannot be more targets than qubits in register</span></div>
<div class="line"><a name="l03469"></a><span class="lineno"> 3469</span>  <span class="keywordtype">int</span> numQubits = GENERATE( -1, 0, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1 );</div>
<div class="line"><a name="l03470"></a><span class="lineno"> 3470</span>  <span class="keywordtype">int</span> qubits[<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1];</div>
<div class="line"><a name="l03471"></a><span class="lineno"> 3471</span>  </div>
<div class="line"><a name="l03472"></a><span class="lineno"> 3472</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga9bc8c4ab44f8233b5766208a0b1c0776">applyQFT</a>(quregVec, qubits, numQubits), Contains(<span class="stringliteral">"Invalid number of target"</span>));</div>
<div class="line"><a name="l03473"></a><span class="lineno"> 3473</span>  }</div>
<div class="line"><a name="l03474"></a><span class="lineno"> 3474</span>  SECTION( <span class="stringliteral">"repetition in targets"</span> ) {</div>
<div class="line"><a name="l03475"></a><span class="lineno"> 3475</span>  </div>
<div class="line"><a name="l03476"></a><span class="lineno"> 3476</span>  <span class="keywordtype">int</span> numQubits = 3;</div>
<div class="line"><a name="l03477"></a><span class="lineno"> 3477</span>  <span class="keywordtype">int</span> qubits[] = {1,2,2};</div>
<div class="line"><a name="l03478"></a><span class="lineno"> 3478</span>  </div>
<div class="line"><a name="l03479"></a><span class="lineno"> 3479</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga9bc8c4ab44f8233b5766208a0b1c0776">applyQFT</a>(quregVec, qubits, numQubits), Contains(<span class="stringliteral">"target"</span>) && Contains(<span class="stringliteral">"unique"</span>));</div>
<div class="line"><a name="l03480"></a><span class="lineno"> 3480</span>  }</div>
<div class="line"><a name="l03481"></a><span class="lineno"> 3481</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l03482"></a><span class="lineno"> 3482</span>  </div>
<div class="line"><a name="l03483"></a><span class="lineno"> 3483</span>  <span class="keywordtype">int</span> numQubits = 3;</div>
<div class="line"><a name="l03484"></a><span class="lineno"> 3484</span>  <span class="keywordtype">int</span> qubits[] = {1,2,3};</div>
<div class="line"><a name="l03485"></a><span class="lineno"> 3485</span>  </div>
<div class="line"><a name="l03486"></a><span class="lineno"> 3486</span>  <span class="keywordtype">int</span> inv = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l03487"></a><span class="lineno"> 3487</span>  qubits[GENERATE_COPY( range(0,numQubits) )] = inv; <span class="comment">// make invalid target</span></div>
<div class="line"><a name="l03488"></a><span class="lineno"> 3488</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga9bc8c4ab44f8233b5766208a0b1c0776">applyQFT</a>(quregVec, qubits, numQubits), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l03489"></a><span class="lineno"> 3489</span>  }</div>
<div class="line"><a name="l03490"></a><span class="lineno"> 3490</span>  }</div>
<div class="line"><a name="l03491"></a><span class="lineno"> 3491</span>  <a class="code" href="test__operators_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l03492"></a><span class="lineno"> 3492</span> }</div>
<div class="line"><a name="l03493"></a><span class="lineno"> 3493</span>  </div>
<div class="line"><a name="l03494"></a><span class="lineno"> 3494</span>  </div>
<div class="line"><a name="l03495"></a><span class="lineno"> 3495</span>  </div>
<div class="line"><a name="l03500"></a><span class="lineno"><a class="line" href="group__unittest.html#ga5510ce8d43eb02e094b284a60bc5b47c"> 3500</a></span> <a class="code" href="group__unittest.html#gaff6822e79b947a9e3b791572c674c08c">TEST_CASE</a>( <span class="stringliteral">"applyTrotterCircuit"</span>, <span class="stringliteral">"[operators]"</span> ) {</div>
<div class="line"><a name="l03501"></a><span class="lineno"> 3501</span>  </div>
<div class="line"><a name="l03502"></a><span class="lineno"> 3502</span>  <a class="code" href="structQureg.html">Qureg</a> vec = <a class="code" href="group__type.html#ga3392816c0643414165c2f5caeec17df0">createQureg</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l03503"></a><span class="lineno"> 3503</span>  <a class="code" href="structQureg.html">Qureg</a> mat = <a class="code" href="group__type.html#ga93e55b6650b408abb30a1d4a8bce757c">createDensityQureg</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l03504"></a><span class="lineno"> 3504</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(vec);</div>
<div class="line"><a name="l03505"></a><span class="lineno"> 3505</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(mat);</div>
<div class="line"><a name="l03506"></a><span class="lineno"> 3506</span>  </div>
<div class="line"><a name="l03507"></a><span class="lineno"> 3507</span>  <a class="code" href="structQureg.html">Qureg</a> vecRef = <a class="code" href="group__type.html#gabd07eee133dcd4e6ae7c2d2ce4c42978">createCloneQureg</a>(vec, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l03508"></a><span class="lineno"> 3508</span>  <a class="code" href="structQureg.html">Qureg</a> matRef = <a class="code" href="group__type.html#gabd07eee133dcd4e6ae7c2d2ce4c42978">createCloneQureg</a>(mat, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l03509"></a><span class="lineno"> 3509</span>  </div>
<div class="line"><a name="l03510"></a><span class="lineno"> 3510</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l03511"></a><span class="lineno"> 3511</span>  </div>
<div class="line"><a name="l03512"></a><span class="lineno"> 3512</span>  SECTION( <span class="stringliteral">"one term"</span> ) {</div>
<div class="line"><a name="l03513"></a><span class="lineno"> 3513</span>  </div>
<div class="line"><a name="l03514"></a><span class="lineno"> 3514</span>  <span class="comment">// a Hamiltonian with one term has an exact (trivial) Trotterisation</span></div>
<div class="line"><a name="l03515"></a><span class="lineno"> 3515</span>  <a class="code" href="structPauliHamil.html">PauliHamil</a> hamil = <a class="code" href="group__type.html#ga35b28710877c462927366fa602e591cb">createPauliHamil</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, 1);</div>
<div class="line"><a name="l03516"></a><span class="lineno"> 3516</span>  </div>
<div class="line"><a name="l03517"></a><span class="lineno"> 3517</span>  <span class="comment">// H = coeff X Y Z (on qubits 0,1,2)</span></div>
<div class="line"><a name="l03518"></a><span class="lineno"> 3518</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeff = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5, 5);</div>
<div class="line"><a name="l03519"></a><span class="lineno"> 3519</span>  <span class="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l03520"></a><span class="lineno"> 3520</span>  <span class="keywordtype">int</span> targs[] = {0, 1, 2};</div>
<div class="line"><a name="l03521"></a><span class="lineno"> 3521</span>  <a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a> codes[] = {<a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a7abac7bb5b71e17382014c443244ad5c">PAULI_X</a>, <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a2c64a9aaee27f6bcfef894d159e759bd">PAULI_Y</a>, <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a085c85cff6ba79c52d8b1e61c42ddddf">PAULI_Z</a>};</div>
<div class="line"><a name="l03522"></a><span class="lineno"> 3522</span>  hamil.<a class="code" href="structPauliHamil.html#ac1c6c9f6299cf83bbba88123216c3cac">termCoeffs</a>[0] = coeff;</div>
<div class="line"><a name="l03523"></a><span class="lineno"> 3523</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numTargs; i++)</div>
<div class="line"><a name="l03524"></a><span class="lineno"> 3524</span>  hamil.<a class="code" href="structPauliHamil.html#a4b8d38c403553c07ceddcd40c46ce6c8">pauliCodes</a>[targs[i]] = codes[i];</div>
<div class="line"><a name="l03525"></a><span class="lineno"> 3525</span>  </div>
<div class="line"><a name="l03526"></a><span class="lineno"> 3526</span>  <span class="comment">// time can be negative</span></div>
<div class="line"><a name="l03527"></a><span class="lineno"> 3527</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> time = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-2,2);</div>
<div class="line"><a name="l03528"></a><span class="lineno"> 3528</span>  </div>
<div class="line"><a name="l03529"></a><span class="lineno"> 3529</span>  <span class="comment">// by commutation, all reps & orders yield the same total unitary</span></div>
<div class="line"><a name="l03530"></a><span class="lineno"> 3530</span>  <span class="keywordtype">int</span> reps = GENERATE( range(1,5) );</div>
<div class="line"><a name="l03531"></a><span class="lineno"> 3531</span>  </div>
<div class="line"><a name="l03532"></a><span class="lineno"> 3532</span>  <span class="comment">// applyTrotter(t, 1, 1) = exp(-i t coeff paulis)</span></div>
<div class="line"><a name="l03533"></a><span class="lineno"> 3533</span>  <span class="comment">// multiRotatePauli(a) = exp(- i a / 2 paulis)</span></div>
<div class="line"><a name="l03534"></a><span class="lineno"> 3534</span>  </div>
<div class="line"><a name="l03535"></a><span class="lineno"> 3535</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l03536"></a><span class="lineno"> 3536</span>  </div>
<div class="line"><a name="l03537"></a><span class="lineno"> 3537</span>  <span class="keywordtype">int</span> order = GENERATE( 1, 2, 4 );</div>
<div class="line"><a name="l03538"></a><span class="lineno"> 3538</span>  </div>
<div class="line"><a name="l03539"></a><span class="lineno"> 3539</span>  <a class="code" href="group__operator.html#ga35b6321c578a8c69470132b5ee95f930">applyTrotterCircuit</a>(vec, hamil, time, order, reps);</div>
<div class="line"><a name="l03540"></a><span class="lineno"> 3540</span>  <a class="code" href="group__unitary.html#ga34aa4865c92f9aa5d898c91286c9eca5">multiRotatePauli</a>(vecRef, targs, codes, numTargs, 2*time*coeff);</div>
<div class="line"><a name="l03541"></a><span class="lineno"> 3541</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vec, vecRef, 10*REAL_EPS) );</div>
<div class="line"><a name="l03542"></a><span class="lineno"> 3542</span>  }</div>
<div class="line"><a name="l03543"></a><span class="lineno"> 3543</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l03544"></a><span class="lineno"> 3544</span>  </div>
<div class="line"><a name="l03545"></a><span class="lineno"> 3545</span>  <span class="keywordtype">int</span> order = GENERATE( 1, 2 ); <span class="comment">// precision bites density-matrices quickly</span></div>
<div class="line"><a name="l03546"></a><span class="lineno"> 3546</span>  </div>
<div class="line"><a name="l03547"></a><span class="lineno"> 3547</span>  <a class="code" href="group__operator.html#ga35b6321c578a8c69470132b5ee95f930">applyTrotterCircuit</a>(mat, hamil, time, order, reps);</div>
<div class="line"><a name="l03548"></a><span class="lineno"> 3548</span>  <a class="code" href="group__unitary.html#ga34aa4865c92f9aa5d898c91286c9eca5">multiRotatePauli</a>(matRef, targs, codes, numTargs, 2*time*coeff);</div>
<div class="line"><a name="l03549"></a><span class="lineno"> 3549</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(mat, matRef, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l03550"></a><span class="lineno"> 3550</span>  }</div>
<div class="line"><a name="l03551"></a><span class="lineno"> 3551</span>  </div>
<div class="line"><a name="l03552"></a><span class="lineno"> 3552</span>  <a class="code" href="group__type.html#gac1c8ed909b33bd55ae680901006051b6">destroyPauliHamil</a>(hamil);</div>
<div class="line"><a name="l03553"></a><span class="lineno"> 3553</span>  }</div>
<div class="line"><a name="l03554"></a><span class="lineno"> 3554</span>  SECTION( <span class="stringliteral">"commuting terms"</span> ) {</div>
<div class="line"><a name="l03555"></a><span class="lineno"> 3555</span>  </div>
<div class="line"><a name="l03556"></a><span class="lineno"> 3556</span>  <span class="comment">// a Hamiltonian of commuting terms, Trotterises exactly</span></div>
<div class="line"><a name="l03557"></a><span class="lineno"> 3557</span>  <a class="code" href="structPauliHamil.html">PauliHamil</a> hamil = <a class="code" href="group__type.html#ga35b28710877c462927366fa602e591cb">createPauliHamil</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, 2);</div>
<div class="line"><a name="l03558"></a><span class="lineno"> 3558</span>  </div>
<div class="line"><a name="l03559"></a><span class="lineno"> 3559</span>  <span class="comment">// H = c0 X Y I + c1 X I Z (on qubits 0,1,2)</span></div>
<div class="line"><a name="l03560"></a><span class="lineno"> 3560</span>  <span class="keywordtype">int</span> targs[] = {0, 1, 2};</div>
<div class="line"><a name="l03561"></a><span class="lineno"> 3561</span>  hamil.<a class="code" href="structPauliHamil.html#a4b8d38c403553c07ceddcd40c46ce6c8">pauliCodes</a>[0] = <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a7abac7bb5b71e17382014c443244ad5c">PAULI_X</a>;</div>
<div class="line"><a name="l03562"></a><span class="lineno"> 3562</span>  hamil.<a class="code" href="structPauliHamil.html#a4b8d38c403553c07ceddcd40c46ce6c8">pauliCodes</a>[0 + <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>] = <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a7abac7bb5b71e17382014c443244ad5c">PAULI_X</a>;</div>
<div class="line"><a name="l03563"></a><span class="lineno"> 3563</span>  hamil.<a class="code" href="structPauliHamil.html#a4b8d38c403553c07ceddcd40c46ce6c8">pauliCodes</a>[1] = <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a2c64a9aaee27f6bcfef894d159e759bd">PAULI_Y</a>;</div>
<div class="line"><a name="l03564"></a><span class="lineno"> 3564</span>  hamil.<a class="code" href="structPauliHamil.html#a4b8d38c403553c07ceddcd40c46ce6c8">pauliCodes</a>[1 + <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>] = <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a63800f45b01ccc2608f754aee850bf4a">PAULI_I</a>;</div>
<div class="line"><a name="l03565"></a><span class="lineno"> 3565</span>  hamil.<a class="code" href="structPauliHamil.html#a4b8d38c403553c07ceddcd40c46ce6c8">pauliCodes</a>[2] = <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a63800f45b01ccc2608f754aee850bf4a">PAULI_I</a>;</div>
<div class="line"><a name="l03566"></a><span class="lineno"> 3566</span>  hamil.<a class="code" href="structPauliHamil.html#a4b8d38c403553c07ceddcd40c46ce6c8">pauliCodes</a>[2 + <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>] = <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a085c85cff6ba79c52d8b1e61c42ddddf">PAULI_Z</a>;</div>
<div class="line"><a name="l03567"></a><span class="lineno"> 3567</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<hamil.<a class="code" href="structPauliHamil.html#a737e46b40ef8990cf004d22eb9dbe2e4">numSumTerms</a>; i++)</div>
<div class="line"><a name="l03568"></a><span class="lineno"> 3568</span>  hamil.<a class="code" href="structPauliHamil.html#ac1c6c9f6299cf83bbba88123216c3cac">termCoeffs</a>[i] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5); </div>
<div class="line"><a name="l03569"></a><span class="lineno"> 3569</span>  </div>
<div class="line"><a name="l03570"></a><span class="lineno"> 3570</span>  <span class="comment">// time can be negative</span></div>
<div class="line"><a name="l03571"></a><span class="lineno"> 3571</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> time = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-2,2);</div>
<div class="line"><a name="l03572"></a><span class="lineno"> 3572</span>  </div>
<div class="line"><a name="l03573"></a><span class="lineno"> 3573</span>  <span class="comment">// applyTrotter(t, 1, 1) = exp(-i t c0 paulis0) exp(-i t c1 paulis1)</span></div>
<div class="line"><a name="l03574"></a><span class="lineno"> 3574</span>  <span class="comment">// multiRotatePauli(a) = exp(- i a / 2 paulis)</span></div>
<div class="line"><a name="l03575"></a><span class="lineno"> 3575</span>  </div>
<div class="line"><a name="l03576"></a><span class="lineno"> 3576</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l03577"></a><span class="lineno"> 3577</span>  </div>
<div class="line"><a name="l03578"></a><span class="lineno"> 3578</span>  <span class="keywordtype">int</span> reps = GENERATE( range(1,5) );</div>
<div class="line"><a name="l03579"></a><span class="lineno"> 3579</span>  <span class="keywordtype">int</span> order = GENERATE( 1, 2, 4 );</div>
<div class="line"><a name="l03580"></a><span class="lineno"> 3580</span>  </div>
<div class="line"><a name="l03581"></a><span class="lineno"> 3581</span>  <a class="code" href="group__operator.html#ga35b6321c578a8c69470132b5ee95f930">applyTrotterCircuit</a>(vec, hamil, time, order, reps);</div>
<div class="line"><a name="l03582"></a><span class="lineno"> 3582</span>  <a class="code" href="group__unitary.html#ga34aa4865c92f9aa5d898c91286c9eca5">multiRotatePauli</a>(vecRef, targs, hamil.<a class="code" href="structPauliHamil.html#a4b8d38c403553c07ceddcd40c46ce6c8">pauliCodes</a>, 3, 2*time*hamil.<a class="code" href="structPauliHamil.html#ac1c6c9f6299cf83bbba88123216c3cac">termCoeffs</a>[0]);</div>
<div class="line"><a name="l03583"></a><span class="lineno"> 3583</span>  <a class="code" href="group__unitary.html#ga34aa4865c92f9aa5d898c91286c9eca5">multiRotatePauli</a>(vecRef, targs, &(hamil.<a class="code" href="structPauliHamil.html#a4b8d38c403553c07ceddcd40c46ce6c8">pauliCodes</a>[<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>]), 3, 2*time*hamil.<a class="code" href="structPauliHamil.html#ac1c6c9f6299cf83bbba88123216c3cac">termCoeffs</a>[1]);</div>
<div class="line"><a name="l03584"></a><span class="lineno"> 3584</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vec, vecRef, 10*REAL_EPS) );</div>
<div class="line"><a name="l03585"></a><span class="lineno"> 3585</span>  }</div>
<div class="line"><a name="l03586"></a><span class="lineno"> 3586</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l03587"></a><span class="lineno"> 3587</span>  </div>
<div class="line"><a name="l03588"></a><span class="lineno"> 3588</span>  <span class="keywordtype">int</span> reps = GENERATE( range(1,5) );</div>
<div class="line"><a name="l03589"></a><span class="lineno"> 3589</span>  <span class="keywordtype">int</span> order = GENERATE( 1, 2 ); <span class="comment">// precision hurts density matrices quickly</span></div>
<div class="line"><a name="l03590"></a><span class="lineno"> 3590</span>  </div>
<div class="line"><a name="l03591"></a><span class="lineno"> 3591</span>  <a class="code" href="group__operator.html#ga35b6321c578a8c69470132b5ee95f930">applyTrotterCircuit</a>(mat, hamil, time, order, reps);</div>
<div class="line"><a name="l03592"></a><span class="lineno"> 3592</span>  <a class="code" href="group__unitary.html#ga34aa4865c92f9aa5d898c91286c9eca5">multiRotatePauli</a>(matRef, targs, hamil.<a class="code" href="structPauliHamil.html#a4b8d38c403553c07ceddcd40c46ce6c8">pauliCodes</a>, 3, 2*time*hamil.<a class="code" href="structPauliHamil.html#ac1c6c9f6299cf83bbba88123216c3cac">termCoeffs</a>[0]);</div>
<div class="line"><a name="l03593"></a><span class="lineno"> 3593</span>  <a class="code" href="group__unitary.html#ga34aa4865c92f9aa5d898c91286c9eca5">multiRotatePauli</a>(matRef, targs, &(hamil.<a class="code" href="structPauliHamil.html#a4b8d38c403553c07ceddcd40c46ce6c8">pauliCodes</a>[<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>]), 3, 2*time*hamil.<a class="code" href="structPauliHamil.html#ac1c6c9f6299cf83bbba88123216c3cac">termCoeffs</a>[1]);</div>
<div class="line"><a name="l03594"></a><span class="lineno"> 3594</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(mat, matRef, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l03595"></a><span class="lineno"> 3595</span>  }</div>
<div class="line"><a name="l03596"></a><span class="lineno"> 3596</span>  </div>
<div class="line"><a name="l03597"></a><span class="lineno"> 3597</span>  <a class="code" href="group__type.html#gac1c8ed909b33bd55ae680901006051b6">destroyPauliHamil</a>(hamil);</div>
<div class="line"><a name="l03598"></a><span class="lineno"> 3598</span>  }</div>
<div class="line"><a name="l03599"></a><span class="lineno"> 3599</span>  SECTION( <span class="stringliteral">"general"</span> ) {</div>
<div class="line"><a name="l03600"></a><span class="lineno"> 3600</span>  </div>
<div class="line"><a name="l03601"></a><span class="lineno"> 3601</span>  <span class="comment">/* We'll consider an analytic time-evolved state, so that we can avoid </span></div>
<div class="line"><a name="l03602"></a><span class="lineno"> 3602</span> <span class="comment"> * comparing applyTrotterCircuit to other numerical approximations.</span></div>
<div class="line"><a name="l03603"></a><span class="lineno"> 3603</span> <span class="comment"> * We can construct such a state, by using a Hamiltonian with known</span></div>
<div class="line"><a name="l03604"></a><span class="lineno"> 3604</span> <span class="comment"> * analytic eigenvalues, and hence a known period. Time evolution of the </span></div>
<div class="line"><a name="l03605"></a><span class="lineno"> 3605</span> <span class="comment"> * period will just yield the input state.</span></div>
<div class="line"><a name="l03606"></a><span class="lineno"> 3606</span> <span class="comment"> *</span></div>
<div class="line"><a name="l03607"></a><span class="lineno"> 3607</span> <span class="comment"> * E.g. H = pi sqrt(2) X Y Z X Y + pi Y Z X Y Z + pi Z X Y Z X</span></div>
<div class="line"><a name="l03608"></a><span class="lineno"> 3608</span> <span class="comment"> * has (degenerate) eigenvalues +- 2 pi, so the period</span></div>
<div class="line"><a name="l03609"></a><span class="lineno"> 3609</span> <span class="comment"> * of the Hamiltonian is t=1. </span></div>
<div class="line"><a name="l03610"></a><span class="lineno"> 3610</span> <span class="comment"> */</span></div>
<div class="line"><a name="l03611"></a><span class="lineno"> 3611</span>  </div>
<div class="line"><a name="l03612"></a><span class="lineno"> 3612</span>  <span class="comment">// hardcoded 5 qubits here in the Pauli codes</span></div>
<div class="line"><a name="l03613"></a><span class="lineno"> 3613</span>  REQUIRE( <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> == 5 );</div>
<div class="line"><a name="l03614"></a><span class="lineno"> 3614</span>  </div>
<div class="line"><a name="l03615"></a><span class="lineno"> 3615</span>  <a class="code" href="structPauliHamil.html">PauliHamil</a> hamil = <a class="code" href="group__type.html#ga35b28710877c462927366fa602e591cb">createPauliHamil</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, 3);</div>
<div class="line"><a name="l03616"></a><span class="lineno"> 3616</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeffs[] = {(<a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>) (<a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a> * sqrt(2.0)), <a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>, <a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>};</div>
<div class="line"><a name="l03617"></a><span class="lineno"> 3617</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a> codes[] = {</div>
<div class="line"><a name="l03618"></a><span class="lineno"> 3618</span>  <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a7abac7bb5b71e17382014c443244ad5c">PAULI_X</a>, <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a2c64a9aaee27f6bcfef894d159e759bd">PAULI_Y</a>, <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a085c85cff6ba79c52d8b1e61c42ddddf">PAULI_Z</a>, <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a7abac7bb5b71e17382014c443244ad5c">PAULI_X</a>, <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a2c64a9aaee27f6bcfef894d159e759bd">PAULI_Y</a>,</div>
<div class="line"><a name="l03619"></a><span class="lineno"> 3619</span>  <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a2c64a9aaee27f6bcfef894d159e759bd">PAULI_Y</a>, <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a085c85cff6ba79c52d8b1e61c42ddddf">PAULI_Z</a>, <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a7abac7bb5b71e17382014c443244ad5c">PAULI_X</a>, <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a2c64a9aaee27f6bcfef894d159e759bd">PAULI_Y</a>, <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a085c85cff6ba79c52d8b1e61c42ddddf">PAULI_Z</a>,</div>
<div class="line"><a name="l03620"></a><span class="lineno"> 3620</span>  <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a085c85cff6ba79c52d8b1e61c42ddddf">PAULI_Z</a>, <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a7abac7bb5b71e17382014c443244ad5c">PAULI_X</a>, <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a2c64a9aaee27f6bcfef894d159e759bd">PAULI_Y</a>, <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a085c85cff6ba79c52d8b1e61c42ddddf">PAULI_Z</a>, <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a7abac7bb5b71e17382014c443244ad5c">PAULI_X</a>};</div>
<div class="line"><a name="l03621"></a><span class="lineno"> 3621</span>  <a class="code" href="group__type.html#gadbe6701dda1d49168f2f23253e370a7a">initPauliHamil</a>(hamil, coeffs, codes);</div>
<div class="line"><a name="l03622"></a><span class="lineno"> 3622</span>  </div>
<div class="line"><a name="l03623"></a><span class="lineno"> 3623</span>  <span class="comment">// evolving to t=1 should leave the input state unchanged</span></div>
<div class="line"><a name="l03624"></a><span class="lineno"> 3624</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> time = 1;</div>
<div class="line"><a name="l03625"></a><span class="lineno"> 3625</span>  </div>
<div class="line"><a name="l03626"></a><span class="lineno"> 3626</span>  <span class="comment">// since unnormalised (initDebugState), max fid is 728359.8336</span></div>
<div class="line"><a name="l03627"></a><span class="lineno"> 3627</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> fidNorm = 728359.8336;</div>
<div class="line"><a name="l03628"></a><span class="lineno"> 3628</span>  </div>
<div class="line"><a name="l03629"></a><span class="lineno"> 3629</span>  SECTION( <span class="stringliteral">"absolute"</span> ) {</div>
<div class="line"><a name="l03630"></a><span class="lineno"> 3630</span>  </div>
<div class="line"><a name="l03631"></a><span class="lineno"> 3631</span>  <span class="comment">// such a high order and reps should yield precise solution</span></div>
<div class="line"><a name="l03632"></a><span class="lineno"> 3632</span>  <span class="keywordtype">int</span> order = 4;</div>
<div class="line"><a name="l03633"></a><span class="lineno"> 3633</span>  <span class="keywordtype">int</span> reps = 20;</div>
<div class="line"><a name="l03634"></a><span class="lineno"> 3634</span>  <a class="code" href="group__operator.html#ga35b6321c578a8c69470132b5ee95f930">applyTrotterCircuit</a>(vec, hamil, time, 4, 20);</div>
<div class="line"><a name="l03635"></a><span class="lineno"> 3635</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> fid = <a class="code" href="group__calc.html#gaa266ed6c8ae5d0d0f49e1ac50819cffc">calcFidelity</a>(vec, vecRef) / fidNorm;</div>
<div class="line"><a name="l03636"></a><span class="lineno"> 3636</span>  </div>
<div class="line"><a name="l03637"></a><span class="lineno"> 3637</span>  REQUIRE( fid == Approx(1).epsilon(1E-8) );</div>
<div class="line"><a name="l03638"></a><span class="lineno"> 3638</span>  }</div>
<div class="line"><a name="l03639"></a><span class="lineno"> 3639</span>  SECTION( <span class="stringliteral">"repetitions scaling"</span> ) {</div>
<div class="line"><a name="l03640"></a><span class="lineno"> 3640</span>  </div>
<div class="line"><a name="l03641"></a><span class="lineno"> 3641</span>  <span class="comment">// exclude order 1; too few reps for monotonic increase of accuracy</span></div>
<div class="line"><a name="l03642"></a><span class="lineno"> 3642</span>  <span class="keywordtype">int</span> order = GENERATE( 2, 4, 6 ); </div>
<div class="line"><a name="l03643"></a><span class="lineno"> 3643</span>  </div>
<div class="line"><a name="l03644"></a><span class="lineno"> 3644</span>  <span class="comment">// accuracy should increase with increasing repetitions</span></div>
<div class="line"><a name="l03645"></a><span class="lineno"> 3645</span>  <span class="keywordtype">int</span> reps[] = {1, 5, 10};</div>
<div class="line"><a name="l03646"></a><span class="lineno"> 3646</span>  </div>
<div class="line"><a name="l03647"></a><span class="lineno"> 3647</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> prevFid = 0;</div>
<div class="line"><a name="l03648"></a><span class="lineno"> 3648</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<3; i++) {</div>
<div class="line"><a name="l03649"></a><span class="lineno"> 3649</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(vec);</div>
<div class="line"><a name="l03650"></a><span class="lineno"> 3650</span>  <a class="code" href="group__operator.html#ga35b6321c578a8c69470132b5ee95f930">applyTrotterCircuit</a>(vec, hamil, time, order, reps[i]);</div>
<div class="line"><a name="l03651"></a><span class="lineno"> 3651</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> fid = <a class="code" href="group__calc.html#gaa266ed6c8ae5d0d0f49e1ac50819cffc">calcFidelity</a>(vec, vecRef) / fidNorm;</div>
<div class="line"><a name="l03652"></a><span class="lineno"> 3652</span>  </div>
<div class="line"><a name="l03653"></a><span class="lineno"> 3653</span>  REQUIRE( fid >= prevFid );</div>
<div class="line"><a name="l03654"></a><span class="lineno"> 3654</span>  prevFid = fid;</div>
<div class="line"><a name="l03655"></a><span class="lineno"> 3655</span>  }</div>
<div class="line"><a name="l03656"></a><span class="lineno"> 3656</span>  }</div>
<div class="line"><a name="l03657"></a><span class="lineno"> 3657</span>  SECTION( <span class="stringliteral">"order scaling"</span> ) {</div>
<div class="line"><a name="l03658"></a><span class="lineno"> 3658</span>  </div>
<div class="line"><a name="l03659"></a><span class="lineno"> 3659</span>  <span class="comment">// exclude order 1; too few reps for monotonic increase of accuracy</span></div>
<div class="line"><a name="l03660"></a><span class="lineno"> 3660</span>  <span class="keywordtype">int</span> reps = GENERATE( 5, 10 ); </div>
<div class="line"><a name="l03661"></a><span class="lineno"> 3661</span>  </div>
<div class="line"><a name="l03662"></a><span class="lineno"> 3662</span>  <span class="comment">// accuracy should increase with increasing repetitions</span></div>
<div class="line"><a name="l03663"></a><span class="lineno"> 3663</span>  <span class="keywordtype">int</span> orders[] = {1, 2, 4, 6};</div>
<div class="line"><a name="l03664"></a><span class="lineno"> 3664</span>  </div>
<div class="line"><a name="l03665"></a><span class="lineno"> 3665</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> prevFid = 0;</div>
<div class="line"><a name="l03666"></a><span class="lineno"> 3666</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<4; i++) {</div>
<div class="line"><a name="l03667"></a><span class="lineno"> 3667</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(vec);</div>
<div class="line"><a name="l03668"></a><span class="lineno"> 3668</span>  <a class="code" href="group__operator.html#ga35b6321c578a8c69470132b5ee95f930">applyTrotterCircuit</a>(vec, hamil, time, orders[i], reps);</div>
<div class="line"><a name="l03669"></a><span class="lineno"> 3669</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> fid = <a class="code" href="group__calc.html#gaa266ed6c8ae5d0d0f49e1ac50819cffc">calcFidelity</a>(vec, vecRef) / fidNorm;</div>
<div class="line"><a name="l03670"></a><span class="lineno"> 3670</span>  </div>
<div class="line"><a name="l03671"></a><span class="lineno"> 3671</span>  REQUIRE( fid >= prevFid );</div>
<div class="line"><a name="l03672"></a><span class="lineno"> 3672</span>  prevFid = fid;</div>
<div class="line"><a name="l03673"></a><span class="lineno"> 3673</span>  }</div>
<div class="line"><a name="l03674"></a><span class="lineno"> 3674</span>  }</div>
<div class="line"><a name="l03675"></a><span class="lineno"> 3675</span>  </div>
<div class="line"><a name="l03676"></a><span class="lineno"> 3676</span>  <a class="code" href="group__type.html#gac1c8ed909b33bd55ae680901006051b6">destroyPauliHamil</a>(hamil);</div>
<div class="line"><a name="l03677"></a><span class="lineno"> 3677</span>  }</div>
<div class="line"><a name="l03678"></a><span class="lineno"> 3678</span>  }</div>
<div class="line"><a name="l03679"></a><span class="lineno"> 3679</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l03680"></a><span class="lineno"> 3680</span>  </div>
<div class="line"><a name="l03681"></a><span class="lineno"> 3681</span>  SECTION( <span class="stringliteral">"repetitions"</span> ) {</div>
<div class="line"><a name="l03682"></a><span class="lineno"> 3682</span>  </div>
<div class="line"><a name="l03683"></a><span class="lineno"> 3683</span>  <a class="code" href="structPauliHamil.html">PauliHamil</a> hamil = <a class="code" href="group__type.html#ga35b28710877c462927366fa602e591cb">createPauliHamil</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, 1);</div>
<div class="line"><a name="l03684"></a><span class="lineno"> 3684</span>  <span class="keywordtype">int</span> reps = GENERATE( -1, 0 );</div>
<div class="line"><a name="l03685"></a><span class="lineno"> 3685</span>  </div>
<div class="line"><a name="l03686"></a><span class="lineno"> 3686</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga35b6321c578a8c69470132b5ee95f930">applyTrotterCircuit</a>(vec, hamil, 1, 1, reps), Contains(<span class="stringliteral">"repetitions must be >=1"</span>) );</div>
<div class="line"><a name="l03687"></a><span class="lineno"> 3687</span>  </div>
<div class="line"><a name="l03688"></a><span class="lineno"> 3688</span>  <a class="code" href="group__type.html#gac1c8ed909b33bd55ae680901006051b6">destroyPauliHamil</a>(hamil);</div>
<div class="line"><a name="l03689"></a><span class="lineno"> 3689</span>  }</div>
<div class="line"><a name="l03690"></a><span class="lineno"> 3690</span>  SECTION( <span class="stringliteral">"order"</span> ) {</div>
<div class="line"><a name="l03691"></a><span class="lineno"> 3691</span>  </div>
<div class="line"><a name="l03692"></a><span class="lineno"> 3692</span>  <a class="code" href="structPauliHamil.html">PauliHamil</a> hamil = <a class="code" href="group__type.html#ga35b28710877c462927366fa602e591cb">createPauliHamil</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, 1);</div>
<div class="line"><a name="l03693"></a><span class="lineno"> 3693</span>  <span class="keywordtype">int</span> order = GENERATE( -1, 0, 3, 5, 7 );</div>
<div class="line"><a name="l03694"></a><span class="lineno"> 3694</span>  </div>
<div class="line"><a name="l03695"></a><span class="lineno"> 3695</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga35b6321c578a8c69470132b5ee95f930">applyTrotterCircuit</a>(vec, hamil, 1, order, 1), Contains(<span class="stringliteral">"order must be 1, or an even number"</span>) );</div>
<div class="line"><a name="l03696"></a><span class="lineno"> 3696</span>  </div>
<div class="line"><a name="l03697"></a><span class="lineno"> 3697</span>  <a class="code" href="group__type.html#gac1c8ed909b33bd55ae680901006051b6">destroyPauliHamil</a>(hamil);</div>
<div class="line"><a name="l03698"></a><span class="lineno"> 3698</span>  }</div>
<div class="line"><a name="l03699"></a><span class="lineno"> 3699</span>  SECTION( <span class="stringliteral">"pauli codes"</span> ) {</div>
<div class="line"><a name="l03700"></a><span class="lineno"> 3700</span>  </div>
<div class="line"><a name="l03701"></a><span class="lineno"> 3701</span>  <span class="keywordtype">int</span> numTerms = 3;</div>
<div class="line"><a name="l03702"></a><span class="lineno"> 3702</span>  <a class="code" href="structPauliHamil.html">PauliHamil</a> hamil = <a class="code" href="group__type.html#ga35b28710877c462927366fa602e591cb">createPauliHamil</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, numTerms);</div>
<div class="line"><a name="l03703"></a><span class="lineno"> 3703</span>  </div>
<div class="line"><a name="l03704"></a><span class="lineno"> 3704</span>  <span class="comment">// make one pauli code wrong</span></div>
<div class="line"><a name="l03705"></a><span class="lineno"> 3705</span>  hamil.<a class="code" href="structPauliHamil.html#a4b8d38c403553c07ceddcd40c46ce6c8">pauliCodes</a>[GENERATE_COPY( range(0,numTerms*<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) )] = (<a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a>) GENERATE( -1, 4 );</div>
<div class="line"><a name="l03706"></a><span class="lineno"> 3706</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga35b6321c578a8c69470132b5ee95f930">applyTrotterCircuit</a>(vec, hamil, 1, 1, 1), Contains(<span class="stringliteral">"Invalid Pauli code"</span>) );</div>
<div class="line"><a name="l03707"></a><span class="lineno"> 3707</span>  </div>
<div class="line"><a name="l03708"></a><span class="lineno"> 3708</span>  <a class="code" href="group__type.html#gac1c8ed909b33bd55ae680901006051b6">destroyPauliHamil</a>(hamil);</div>
<div class="line"><a name="l03709"></a><span class="lineno"> 3709</span>  }</div>
<div class="line"><a name="l03710"></a><span class="lineno"> 3710</span>  SECTION( <span class="stringliteral">"matching hamiltonian qubits"</span> ) {</div>
<div class="line"><a name="l03711"></a><span class="lineno"> 3711</span>  </div>
<div class="line"><a name="l03712"></a><span class="lineno"> 3712</span>  <a class="code" href="structPauliHamil.html">PauliHamil</a> hamil = <a class="code" href="group__type.html#ga35b28710877c462927366fa602e591cb">createPauliHamil</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> + 1, 1);</div>
<div class="line"><a name="l03713"></a><span class="lineno"> 3713</span>  </div>
<div class="line"><a name="l03714"></a><span class="lineno"> 3714</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga35b6321c578a8c69470132b5ee95f930">applyTrotterCircuit</a>(vec, hamil, 1, 1, 1), Contains(<span class="stringliteral">"same number of qubits"</span>) );</div>
<div class="line"><a name="l03715"></a><span class="lineno"> 3715</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__operator.html#ga35b6321c578a8c69470132b5ee95f930">applyTrotterCircuit</a>(mat, hamil, 1, 1, 1), Contains(<span class="stringliteral">"same number of qubits"</span>) );</div>
<div class="line"><a name="l03716"></a><span class="lineno"> 3716</span>  </div>
<div class="line"><a name="l03717"></a><span class="lineno"> 3717</span>  <a class="code" href="group__type.html#gac1c8ed909b33bd55ae680901006051b6">destroyPauliHamil</a>(hamil);</div>
<div class="line"><a name="l03718"></a><span class="lineno"> 3718</span>  }</div>
<div class="line"><a name="l03719"></a><span class="lineno"> 3719</span>  }</div>
<div class="line"><a name="l03720"></a><span class="lineno"> 3720</span>  </div>
<div class="line"><a name="l03721"></a><span class="lineno"> 3721</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(vec, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l03722"></a><span class="lineno"> 3722</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(mat, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l03723"></a><span class="lineno"> 3723</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(vecRef, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l03724"></a><span class="lineno"> 3724</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(matRef, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l03725"></a><span class="lineno"> 3725</span> }</div>
<div class="line"><a name="l03726"></a><span class="lineno"> 3726</span>  </div>
</div><!-- fragment --></div><!-- contents -->
<div class="ttc" id="agroup__type_html_ggaa7d869b117ba5024d6b84938e8cdfc65acb26952815118f5ced7703302dbeb556"><div class="ttname"><a href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65acb26952815118f5ced7703302dbeb556">INVERSE_PRODUCT</a></div><div class="ttdeci">@ INVERSE_PRODUCT</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00233">QuEST.h:233</a></div></div>
<div class="ttc" id="agroup__type_html_ga1c703cf89629e4e9c7023cd402d67028"><div class="ttname"><a href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a></div><div class="ttdeci">pauliOpType</div><div class="ttdoc">Codes for specifying Pauli operators.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00096">QuEST.h:96</a></div></div>
<div class="ttc" id="agroup__operator_html_ga467f517abd18dbc3d6fced84c6589161"><div class="ttname"><a href="group__operator.html#ga467f517abd18dbc3d6fced84c6589161">applyPhaseFunc</a></div><div class="ttdeci">void applyPhaseFunc(Qureg qureg, int *qubits, int numQubits, enum bitEncoding encoding, qreal *coeffs, qreal *exponents, int numTerms)</div><div class="ttdoc">Induces a phase change upon each amplitude of qureg, determined by the passed exponential polynomial ...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00726">QuEST.c:726</a></div></div>
<div class="ttc" id="agroup__operator_html_gab52b6315c5520b7d311b0458785eed8e"><div class="ttname"><a href="group__operator.html#gab52b6315c5520b7d311b0458785eed8e">applyMultiControlledMatrixN</a></div><div class="ttdeci">void applyMultiControlledMatrixN(Qureg qureg, int *ctrls, int numCtrls, int *targs, int numTargs, ComplexMatrixN u)</div><div class="ttdoc">Apply a general N-by-N matrix, which may be non-unitary, with additional controlled qubits.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01114">QuEST.c:1114</a></div></div>
<div class="ttc" id="agroup__operator_html_ga2fbaec3bb21cc01f7a2a4ed2aa911ebf"><div class="ttname"><a href="group__operator.html#ga2fbaec3bb21cc01f7a2a4ed2aa911ebf">applyNamedPhaseFuncOverrides</a></div><div class="ttdeci">void applyNamedPhaseFuncOverrides(Qureg qureg, int *qubits, int *numQubitsPerReg, int numRegs, enum bitEncoding encoding, enum phaseFunc functionNameCode, long long int *overrideInds, qreal *overridePhases, int numOverrides)</div><div class="ttdoc">Induces a phase change upon each amplitude of qureg, determined by a named (and potentially multi-var...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00813">QuEST.c:813</a></div></div>
<div class="ttc" id="agroup__type_html_gadbe6701dda1d49168f2f23253e370a7a"><div class="ttname"><a href="group__type.html#gadbe6701dda1d49168f2f23253e370a7a">initPauliHamil</a></div><div class="ttdeci">void initPauliHamil(PauliHamil hamil, qreal *coeffs, enum pauliOpType *codes)</div><div class="ttdoc">Initialise PauliHamil instance hamil with the given term coefficients and Pauli codes (one for every ...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01504">QuEST.c:1504</a></div></div>
<div class="ttc" id="amain_8cpp_html_a718130cc1fc36cde991aff3d4c85c47d"><div class="ttname"><a href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a></div><div class="ttdeci">QuESTEnv QUEST_ENV</div><div class="ttdoc">The global QuESTEnv instance, to be created and destroyed once in this main(), so that the MPI enviro...</div><div class="ttdef"><b>Definition:</b> <a href="main_8cpp_source.html#l00020">main.cpp:20</a></div></div>
<div class="ttc" id="agroup__operator_html_ga26db8b8a8a242d388c291e50d228ab18"><div class="ttname"><a href="group__operator.html#ga26db8b8a8a242d388c291e50d228ab18">applyProjector</a></div><div class="ttdeci">void applyProjector(Qureg qureg, int qubit, int outcome)</div><div class="ttdoc">Force the target qubit of qureg into the given classical outcome, via a non-renormalising projection.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00888">QuEST.c:888</a></div></div>
<div class="ttc" id="agroup__type_html_gga1c703cf89629e4e9c7023cd402d67028a085c85cff6ba79c52d8b1e61c42ddddf"><div class="ttname"><a href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a085c85cff6ba79c52d8b1e61c42ddddf">PAULI_Z</a></div><div class="ttdeci">@ PAULI_Z</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00096">QuEST.h:96</a></div></div>
<div class="ttc" id="agroup__testutilities_html_gab5ac6842ba67b8d38bd17385ab179b67"><div class="ttname"><a href="group__testutilities.html#gab5ac6842ba67b8d38bd17385ab179b67">getKroneckerProduct</a></div><div class="ttdeci">QVector getKroneckerProduct(QVector b, QVector a)</div><div class="ttdoc">Returns b (otimes) a.</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l00143">utilities.cpp:143</a></div></div>
<div class="ttc" id="agroup__type_html_ggaa7d869b117ba5024d6b84938e8cdfc65a2ad72f168181763513d7793c13bf2a91"><div class="ttname"><a href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a2ad72f168181763513d7793c13bf2a91">DISTANCE</a></div><div class="ttdeci">@ DISTANCE</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00234">QuEST.h:234</a></div></div>
<div class="ttc" id="agroup__type_html_ga9df2f3d86be4a6e9aad481665e5e6753"><div class="ttname"><a href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a></div><div class="ttdeci">void destroyComplexMatrixN(ComplexMatrixN m)</div><div class="ttdoc">Destroy a ComplexMatrixN instance created with createComplexMatrixN()</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01369">QuEST.c:1369</a></div></div>
<div class="ttc" id="agroup__operator_html_gac4df97d8c125c8cc65df720f67b2bf69"><div class="ttname"><a href="group__operator.html#gac4df97d8c125c8cc65df720f67b2bf69">applyNamedPhaseFunc</a></div><div class="ttdeci">void applyNamedPhaseFunc(Qureg qureg, int *qubits, int *numQubitsPerReg, int numRegs, enum bitEncoding encoding, enum phaseFunc functionNameCode)</div><div class="ttdoc">Induces a phase change upon each amplitude of qureg, determined by a named (and potentially multi-var...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00796">QuEST.c:796</a></div></div>
<div class="ttc" id="agroup__type_html_gga1c703cf89629e4e9c7023cd402d67028a63800f45b01ccc2608f754aee850bf4a"><div class="ttname"><a href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a63800f45b01ccc2608f754aee850bf4a">PAULI_I</a></div><div class="ttdeci">@ PAULI_I</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00096">QuEST.h:96</a></div></div>
<div class="ttc" id="agroup__testutilities_html_ga7125d0747a44db58115899727ac5f6be"><div class="ttname"><a href="group__testutilities.html#ga7125d0747a44db58115899727ac5f6be">getRandomInt</a></div><div class="ttdeci">int getRandomInt(int min, int max)</div><div class="ttdoc">Returns a random integer between min (inclusive) and max (exclusive), from the uniform distribution.</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l00526">utilities.cpp:526</a></div></div>
<div class="ttc" id="agroup__type_html_ga815103261fb22ea9690e1427571df00e"><div class="ttname"><a href="group__type.html#ga815103261fb22ea9690e1427571df00e">createComplexMatrixN</a></div><div class="ttdeci">ComplexMatrixN createComplexMatrixN(int numQubits)</div><div class="ttdoc">Allocate dynamic memory for a square complex matrix of any size, which can be passed to functions lik...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01348">QuEST.c:1348</a></div></div>
<div class="ttc" id="agroup__testutilities_html_gad6435da46323045d81e4ba9d9fe5a109"><div class="ttname"><a href="group__testutilities.html#gad6435da46323045d81e4ba9d9fe5a109">getMixedDensityMatrix</a></div><div class="ttdeci">QMatrix getMixedDensityMatrix(std::vector< qreal > probs, std::vector< QVector > states)</div><div class="ttdoc">Returns a mixed density matrix formed from mixing the given pure states, which are assumed normalised...</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l00640">utilities.cpp:640</a></div></div>
<div class="ttc" id="agroup__type_html_gab75d5cdc622d2778bad24e3a8130aab9"><div class="ttname"><a href="group__type.html#gab75d5cdc622d2778bad24e3a8130aab9">syncDiagonalOp</a></div><div class="ttdeci">void syncDiagonalOp(DiagonalOp op)</div><div class="ttdoc">Update the GPU memory with the current values in op.real and op.imag.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01531">QuEST.c:1531</a></div></div>
<div class="ttc" id="agroup__type_html_ga2c59f45fab56708f687b4104ee99bcd1"><div class="ttname"><a href="group__type.html#ga2c59f45fab56708f687b4104ee99bcd1">destroyDiagonalOp</a></div><div class="ttdeci">void destroyDiagonalOp(DiagonalOp op, QuESTEnv env)</div><div class="ttdoc">Destroys a DiagonalOp created with createDiagonalOp(), freeing its memory.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01524">QuEST.c:1524</a></div></div>
<div class="ttc" id="autilities_8hpp_html_a2f52338126bb8cdf7fcf68eaf01c546a"><div class="ttname"><a href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a></div><div class="ttdeci">#define NUM_QUBITS</div><div class="ttdoc">The default number of qubits in the registers created for unit testing (both statevectors and density...</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8hpp_source.html#l00036">utilities.hpp:36</a></div></div>
<div class="ttc" id="atest__operators_8cpp_html_aec8f698a7995e17e0ff1055526d2e5d4"><div class="ttname"><a href="test__operators_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a></div><div class="ttdeci">#define CLEANUP_TEST(quregVec, quregMatr)</div><div class="ttdoc">Destroys the data structures made by PREPARE_TEST.</div><div class="ttdef"><b>Definition:</b> <a href="test__operators_8cpp_source.html#l00019">test_operators.cpp:19</a></div></div>
<div class="ttc" id="aQuEST_8h_html"><div class="ttname"><a href="QuEST_8h.html">QuEST.h</a></div></div>
<div class="ttc" id="agroup__type_html_gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c"><div class="ttname"><a href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a9aa2a35d92976c7de970506c4d19a96c">TWOS_COMPLEMENT</a></div><div class="ttdeci">@ TWOS_COMPLEMENT</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00269">QuEST.h:269</a></div></div>
<div class="ttc" id="agroup__calc_html_gaa266ed6c8ae5d0d0f49e1ac50819cffc"><div class="ttname"><a href="group__calc.html#gaa266ed6c8ae5d0d0f49e1ac50819cffc">calcFidelity</a></div><div class="ttdeci">qreal calcFidelity(Qureg qureg, Qureg pureState)</div><div class="ttdoc">Calculates the fidelity of qureg (a state-vector or density matrix) against a reference pure state (n...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01191">QuEST.c:1191</a></div></div>
<div class="ttc" id="agroup__testutilities_html_gacd5aadbe10ecdedaa625f85171c0a3cd"><div class="ttname"><a href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a></div><div class="ttdeci">qreal getRandomReal(qreal min, qreal max)</div><div class="ttdoc">Returns a random real between min (inclusive) and max (exclusive), from the uniform distribution.</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l00421">utilities.cpp:421</a></div></div>
<div class="ttc" id="agroup__type_html_ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e"><div class="ttname"><a href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae003ec1158e3a4e295616ced12af154e">NORM</a></div><div class="ttdeci">@ NORM</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00232">QuEST.h:232</a></div></div>
<div class="ttc" id="agroup__testutilities_html_gaf57b4b82c98e98918f74476741f60e37"><div class="ttname"><a href="group__testutilities.html#gaf57b4b82c98e98918f74476741f60e37">setDiagMatrixOverrides</a></div><div class="ttdeci">void setDiagMatrixOverrides(QMatrix &matr, int *numQubitsPerReg, int numRegs, enum bitEncoding encoding, long long int *overrideInds, qreal *overridePhases, int numOverrides)</div><div class="ttdoc">Modifies the given diagonal matrix such that the diagonal elements which correspond to the coordinate...</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l01316">utilities.cpp:1316</a></div></div>
<div class="ttc" id="agroup__testutilities_html_ga2ce759464ecc923710890d633c03bcca"><div class="ttname"><a href="group__testutilities.html#ga2ce759464ecc923710890d633c03bcca">getRandomOrthonormalVectors</a></div><div class="ttdeci">std::vector< QVector > getRandomOrthonormalVectors(int numQb, int numStates)</div><div class="ttdoc">Returns a list of random orthonormal complex vectors, from an undisclosed distribution.</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l00613">utilities.cpp:613</a></div></div>
<div class="ttc" id="astructComplexMatrix4_html"><div class="ttname"><a href="structComplexMatrix4.html">ComplexMatrix4</a></div><div class="ttdoc">Represents a 4x4 matrix of complex numbers.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00175">QuEST.h:175</a></div></div>
<div class="ttc" id="agroup__type_html_ggaa7d869b117ba5024d6b84938e8cdfc65ae5114537389194302c7a619e35e6e227"><div class="ttname"><a href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae5114537389194302c7a619e35e6e227">SCALED_INVERSE_DISTANCE</a></div><div class="ttdeci">@ SCALED_INVERSE_DISTANCE</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00234">QuEST.h:234</a></div></div>
<div class="ttc" id="agroup__operator_html_ga54d4e589468002bdc998200ae45e7312"><div class="ttname"><a href="group__operator.html#ga54d4e589468002bdc998200ae45e7312">applyPauliHamil</a></div><div class="ttdeci">void applyPauliHamil(Qureg inQureg, PauliHamil hamil, Qureg outQureg)</div><div class="ttdoc">Modifies outQureg to be the result of applying PauliHamil (a Hermitian but not necessarily unitary op...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01059">QuEST.c:1059</a></div></div>
<div class="ttc" id="agroup__operator_html_ga9bc8c4ab44f8233b5766208a0b1c0776"><div class="ttname"><a href="group__operator.html#ga9bc8c4ab44f8233b5766208a0b1c0776">applyQFT</a></div><div class="ttdeci">void applyQFT(Qureg qureg, int *qubits, int numQubits)</div><div class="ttdoc">Applies the quantum Fourier transform (QFT) to a specific subset of qubits of the register qureg.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00866">QuEST.c:866</a></div></div>
<div class="ttc" id="agroup__type_html_gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae"><div class="ttname"><a href="group__type.html#gga9c91c41aa42ae537995e89ffc616afe1a7165f9a47792f47c718ca128556fb3ae">UNSIGNED</a></div><div class="ttdeci">@ UNSIGNED</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00269">QuEST.h:269</a></div></div>
<div class="ttc" id="agroup__operator_html_gaf5344129240243ad11d0c081eb9036ab"><div class="ttname"><a href="group__operator.html#gaf5344129240243ad11d0c081eb9036ab">applyPhaseFuncOverrides</a></div><div class="ttdeci">void applyPhaseFuncOverrides(Qureg qureg, int *qubits, int numQubits, enum bitEncoding encoding, qreal *coeffs, qreal *exponents, int numTerms, long long int *overrideInds, qreal *overridePhases, int numOverrides)</div><div class="ttdoc">Induces a phase change upon each amplitude of qureg, determined by the passed exponential polynomial ...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00743">QuEST.c:743</a></div></div>
<div class="ttc" id="astructComplexMatrixN_html"><div class="ttname"><a href="structComplexMatrixN.html">ComplexMatrixN</a></div><div class="ttdoc">Represents a general 2^N by 2^N matrix of complex numbers.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00186">QuEST.h:186</a></div></div>
<div class="ttc" id="agroup__type_html_ggaa7d869b117ba5024d6b84938e8cdfc65a6313e6ff48163c11c47866c4fda4bfa0"><div class="ttname"><a href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a6313e6ff48163c11c47866c4fda4bfa0">INVERSE_DISTANCE</a></div><div class="ttdeci">@ INVERSE_DISTANCE</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00234">QuEST.h:234</a></div></div>
<div class="ttc" id="agroup__type_html_ga7740e349b4f8bae6451547680f0ce2d6"><div class="ttname"><a href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a></div><div class="ttdeci">#define qreal</div></div>
<div class="ttc" id="agroup__unitary_html_ga34aa4865c92f9aa5d898c91286c9eca5"><div class="ttname"><a href="group__unitary.html#ga34aa4865c92f9aa5d898c91286c9eca5">multiRotatePauli</a></div><div class="ttdeci">void multiRotatePauli(Qureg qureg, int *targetQubits, enum pauliOpType *targetPaulis, int numTargets, qreal angle)</div><div class="ttdoc">Apply a multi-qubit multi-Pauli rotation, also known as a Pauli gadget, on a selected number of qubit...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00685">QuEST.c:685</a></div></div>
<div class="ttc" id="agroup__testutilities_html_ga253946523907014c4f198d2bb38d4913"><div class="ttname"><a href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a></div><div class="ttdeci">QMatrix toQMatrix(ComplexMatrix2 src)</div><div class="ttdoc">Returns a copy of the given 2-by-2 matrix.</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l01044">utilities.cpp:1044</a></div></div>
<div class="ttc" id="agroup__testutilities_html_gaf5a18d4c00dfe0523972be3bfc666362"><div class="ttname"><a href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a></div><div class="ttdeci">void toQureg(Qureg qureg, QVector vec)</div><div class="ttdoc">Initialises the state-vector qureg to have the same amplitudes as vec.</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l01201">utilities.cpp:1201</a></div></div>
<div class="ttc" id="agroup__testutilities_html_ga267884197cf7f1d428021cb12a57360c"><div class="ttname"><a href="group__testutilities.html#ga267884197cf7f1d428021cb12a57360c">calcLog2</a></div><div class="ttdeci">unsigned int calcLog2(long unsigned int num)</div><div class="ttdoc">returns log2 of numbers which must be gauranteed to be 2^n</div><div class="ttdef"><b>Definition:</b> <a href="QuEST__validation_8c_source.html#l00328">QuEST_validation.c:328</a></div></div>
<div class="ttc" id="agroup__type_html_gga1c703cf89629e4e9c7023cd402d67028a7abac7bb5b71e17382014c443244ad5c"><div class="ttname"><a href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a7abac7bb5b71e17382014c443244ad5c">PAULI_X</a></div><div class="ttdeci">@ PAULI_X</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00096">QuEST.h:96</a></div></div>
<div class="ttc" id="agroup__unittest_html_gaff6822e79b947a9e3b791572c674c08c"><div class="ttname"><a href="group__unittest.html#gaff6822e79b947a9e3b791572c674c08c">TEST_CASE</a></div><div class="ttdeci">TEST_CASE("applyDiagonalOp", "[operators]")</div><div class="ttdef"><b>Definition:</b> <a href="test__operators_8cpp_source.html#l00032">test_operators.cpp:32</a></div></div>
<div class="ttc" id="agroup__testutilities_html_ga11c465ce1a5c238946a9e09d61c94c58"><div class="ttname"><a href="group__testutilities.html#ga11c465ce1a5c238946a9e09d61c94c58">setRandomPauliSum</a></div><div class="ttdeci">void setRandomPauliSum(qreal *coeffs, pauliOpType *codes, int numQubits, int numTerms)</div><div class="ttdoc">Populates the coeffs array with random qreals in (-5, 5), and populates codes with random Pauli codes...</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l01229">utilities.cpp:1229</a></div></div>
<div class="ttc" id="agroup__testutilities_html_ga7f83695bea7d0332a577bca017dbb03c"><div class="ttname"><a href="group__testutilities.html#ga7f83695bea7d0332a577bca017dbb03c">toComplexMatrixN</a></div><div class="ttdeci">void toComplexMatrixN(QMatrix qm, ComplexMatrixN cm)</div><div class="ttdoc">Initialises cm with the values of qm.</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l01033">utilities.cpp:1033</a></div></div>
<div class="ttc" id="autilities_8cpp_html_a9dc43d4a0827b56cd004270a9c5b2604"><div class="ttname"><a href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a></div><div class="ttdeci">qcomp expI(qreal phase)</div><div class="ttdoc">Returns the unit-norm complex number exp(i*phase).</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l00417">utilities.cpp:417</a></div></div>
<div class="ttc" id="agroup__testutilities_html_gac9263a65c96a458b810b20baa81c5b94"><div class="ttname"><a href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a></div><div class="ttdeci">std::vector< qcomp > QVector</div><div class="ttdoc">A complex vector, which can be zero-initialised with QVector(numAmps).</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8hpp_source.html#l00060">utilities.hpp:60</a></div></div>
<div class="ttc" id="astructDiagonalOp_html_a85c3f52533efe831bbe40b9a48602388"><div class="ttname"><a href="structDiagonalOp.html#a85c3f52533efe831bbe40b9a48602388">DiagonalOp::imag</a></div><div class="ttdeci">qreal * imag</div><div class="ttdoc">The imaginary values of the 2^numQubits complex elements.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00310">QuEST.h:310</a></div></div>
<div class="ttc" id="agroup__type_html_gaa7d869b117ba5024d6b84938e8cdfc65"><div class="ttname"><a href="group__type.html#gaa7d869b117ba5024d6b84938e8cdfc65">phaseFunc</a></div><div class="ttdeci">phaseFunc</div><div class="ttdoc">Flags for specifying named phase functions.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00231">QuEST.h:231</a></div></div>
<div class="ttc" id="agroup__testutilities_html_gade0e7c37811a69f1c21c88c11943a19f"><div class="ttname"><a href="group__testutilities.html#gade0e7c37811a69f1c21c88c11943a19f">toQVector</a></div><div class="ttdeci">QVector toQVector(Qureg qureg)</div><div class="ttdoc">Returns an equal-size copy of the given state-vector qureg.</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l01113">utilities.cpp:1113</a></div></div>
<div class="ttc" id="agroup__operator_html_gad2e953390342cd361cfb4064d47715e6"><div class="ttname"><a href="group__operator.html#gad2e953390342cd361cfb4064d47715e6">applyDiagonalOp</a></div><div class="ttdeci">void applyDiagonalOp(Qureg qureg, DiagonalOp op)</div><div class="ttdoc">Apply a diagonal operator, which is possibly non-unitary and non-Hermitian, to the entire qureg.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01127">QuEST.c:1127</a></div></div>
<div class="ttc" id="astructPauliHamil_html_ac1c6c9f6299cf83bbba88123216c3cac"><div class="ttname"><a href="structPauliHamil.html#ac1c6c9f6299cf83bbba88123216c3cac">PauliHamil::termCoeffs</a></div><div class="ttdeci">qreal * termCoeffs</div><div class="ttdoc">The real coefficient of each Pauli product. This is an array of length PauliHamil....</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00283">QuEST.h:283</a></div></div>
<div class="ttc" id="agroup__operator_html_ga74a955ec4bce606d89317bcfc528387f"><div class="ttname"><a href="group__operator.html#ga74a955ec4bce606d89317bcfc528387f">applyMatrix4</a></div><div class="ttdeci">void applyMatrix4(Qureg qureg, int targetQubit1, int targetQubit2, ComplexMatrix4 u)</div><div class="ttdoc">Apply a general 4-by-4 matrix, which may be non-unitary.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01093">QuEST.c:1093</a></div></div>
<div class="ttc" id="astructPauliHamil_html_a4b8d38c403553c07ceddcd40c46ce6c8"><div class="ttname"><a href="structPauliHamil.html#a4b8d38c403553c07ceddcd40c46ce6c8">PauliHamil::pauliCodes</a></div><div class="ttdeci">enum pauliOpType * pauliCodes</div><div class="ttdoc">The Pauli operators acting on each qubit, flattened over every operator.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00281">QuEST.h:281</a></div></div>
<div class="ttc" id="agroup__testutilities_html_ga216f7c25bbb0cf752d1b6fff5ea8197b"><div class="ttname"><a href="group__testutilities.html#ga216f7c25bbb0cf752d1b6fff5ea8197b">toComplexMatrix4</a></div><div class="ttdeci">ComplexMatrix4 toComplexMatrix4(QMatrix qm)</div><div class="ttdoc">Returns a ComplexMatrix4 copy of QMatix qm.</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l01027">utilities.cpp:1027</a></div></div>
<div class="ttc" id="agroup__type_html_ggaa7d869b117ba5024d6b84938e8cdfc65a31a29a30f92fe34c35098f941adbbc93"><div class="ttname"><a href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a31a29a30f92fe34c35098f941adbbc93">SCALED_PRODUCT</a></div><div class="ttdeci">@ SCALED_PRODUCT</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00233">QuEST.h:233</a></div></div>
<div class="ttc" id="aQuEST__precision_8h_html_a6698ce2a3971003a0a0289e5980d39c5"><div class="ttname"><a href="QuEST__precision_8h.html#a6698ce2a3971003a0a0289e5980d39c5">MAX_NUM_REGS_APPLY_ARBITRARY_PHASE</a></div><div class="ttdeci">#define MAX_NUM_REGS_APPLY_ARBITRARY_PHASE</div><div class="ttdef"><b>Definition:</b> <a href="QuEST__precision_8h_source.html#l00072">QuEST_precision.h:72</a></div></div>
<div class="ttc" id="astructPauliHamil_html_a737e46b40ef8990cf004d22eb9dbe2e4"><div class="ttname"><a href="structPauliHamil.html#a737e46b40ef8990cf004d22eb9dbe2e4">PauliHamil::numSumTerms</a></div><div class="ttdeci">int numSumTerms</div><div class="ttdoc">The number of terms in the weighted sum, or the number of Pauli products.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00285">QuEST.h:285</a></div></div>
<div class="ttc" id="astructDiagonalOp_html"><div class="ttname"><a href="structDiagonalOp.html">DiagonalOp</a></div><div class="ttdoc">Represents a diagonal complex operator on the full Hilbert state of a Qureg.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00297">QuEST.h:297</a></div></div>
<div class="ttc" id="agroup__type_html_gga1c703cf89629e4e9c7023cd402d67028a2c64a9aaee27f6bcfef894d159e759bd"><div class="ttname"><a href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a2c64a9aaee27f6bcfef894d159e759bd">PAULI_Y</a></div><div class="ttdeci">@ PAULI_Y</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00096">QuEST.h:96</a></div></div>
<div class="ttc" id="astructPauliHamil_html"><div class="ttname"><a href="structPauliHamil.html">PauliHamil</a></div><div class="ttdoc">A Pauli Hamiltonian, expressed as a real-weighted sum of pauli products, and which can hence represen...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00277">QuEST.h:277</a></div></div>
<div class="ttc" id="agroup__type_html_ga8e1e6ad3254892edc2ee08712ea9d692"><div class="ttname"><a href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a></div><div class="ttdeci">void destroyQureg(Qureg qureg, QuESTEnv env)</div><div class="ttdoc">Deallocate a Qureg, freeing its memory.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00077">QuEST.c:77</a></div></div>
<div class="ttc" id="agroup__operator_html_gaabd7efa3beebc9f3a525321d41a28989"><div class="ttname"><a href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989">applyParamNamedPhaseFuncOverrides</a></div><div class="ttdeci">void applyParamNamedPhaseFuncOverrides(Qureg qureg, int *qubits, int *numQubitsPerReg, int numRegs, enum bitEncoding encoding, enum phaseFunc functionNameCode, qreal *params, int numParams, long long int *overrideInds, qreal *overridePhases, int numOverrides)</div><div class="ttdoc">Induces a phase change upon each amplitude of qureg, determined by a named, parameterised (and potent...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00848">QuEST.c:848</a></div></div>
<div class="ttc" id="agroup__type_html_ggaa7d869b117ba5024d6b84938e8cdfc65aa318172feec5b530e9a7849f2f7b44e7"><div class="ttname"><a href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65aa318172feec5b530e9a7849f2f7b44e7">SCALED_INVERSE_SHIFTED_NORM</a></div><div class="ttdeci">@ SCALED_INVERSE_SHIFTED_NORM</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00232">QuEST.h:232</a></div></div>
<div class="ttc" id="agroup__testutilities_html_gae1d2eb70b50267f8186cbd53e300d94f"><div class="ttname"><a href="group__testutilities.html#gae1d2eb70b50267f8186cbd53e300d94f">getRandomStateVector</a></div><div class="ttdeci">QVector getRandomStateVector(int numQb)</div><div class="ttdoc">Returns a random numQb-length L2-normalised state-vector from an undisclosed distribution.</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l00468">utilities.cpp:468</a></div></div>
<div class="ttc" id="astructComplexMatrixN_html_a446e8a077597e4f76049d547df0c9738"><div class="ttname"><a href="structComplexMatrixN.html#a446e8a077597e4f76049d547df0c9738">ComplexMatrixN::real</a></div><div class="ttdeci">qreal ** real</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00189">QuEST.h:189</a></div></div>
<div class="ttc" id="agroup__debug_html_gaa696c94112e5fbbc996af10dfc4e2c1c"><div class="ttname"><a href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a></div><div class="ttdeci">void initDebugState(Qureg qureg)</div><div class="ttdoc">Initialises qureg to be in the un-normalised, non-physical state with with -th complex amplitude give...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01578">QuEST.c:1578</a></div></div>
<div class="ttc" id="agroup__operator_html_ga6fc26cf857db070e12959e59ecfed8a6"><div class="ttname"><a href="group__operator.html#ga6fc26cf857db070e12959e59ecfed8a6">applyPauliSum</a></div><div class="ttdeci">void applyPauliSum(Qureg inQureg, enum pauliOpType *allPauliCodes, qreal *termCoeffs, int numSumTerms, Qureg outQureg)</div><div class="ttdoc">Modifies outQureg to be the result of applying the weighted sum of Pauli products (a Hermitian but no...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01048">QuEST.c:1048</a></div></div>
<div class="ttc" id="agroup__testutilities_html_gaa2e8b958e0cba07e01de9f91a5ce3c9c"><div class="ttname"><a href="group__testutilities.html#gaa2e8b958e0cba07e01de9f91a5ce3c9c">getRandomQMatrix</a></div><div class="ttdeci">QMatrix getRandomQMatrix(int dim)</div><div class="ttdoc">Returns a dim-by-dim complex matrix, where the real and imaginary value of each element are independe...</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l00379">utilities.cpp:379</a></div></div>
<div class="ttc" id="agroup__operator_html_ga358e7094a98851afa86d27f0147e32a1"><div class="ttname"><a href="group__operator.html#ga358e7094a98851afa86d27f0147e32a1">applyMatrixN</a></div><div class="ttdeci">void applyMatrixN(Qureg qureg, int *targs, int numTargs, ComplexMatrixN u)</div><div class="ttdoc">Apply a general N-by-N matrix, which may be non-unitary, on any number of target qubits.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01103">QuEST.c:1103</a></div></div>
<div class="ttc" id="agroup__operator_html_ga008a46d178a5a9691e2f5d363e3f518f"><div class="ttname"><a href="group__operator.html#ga008a46d178a5a9691e2f5d363e3f518f">applyMultiVarPhaseFunc</a></div><div class="ttdeci">void applyMultiVarPhaseFunc(Qureg qureg, int *qubits, int *numQubitsPerReg, int numRegs, enum bitEncoding encoding, qreal *coeffs, qreal *exponents, int *numTermsPerReg)</div><div class="ttdoc">Induces a phase change upon each amplitude of qureg, determined by a multi-variable exponential polyn...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00761">QuEST.c:761</a></div></div>
<div class="ttc" id="agroup__type_html_ggaa7d869b117ba5024d6b84938e8cdfc65ad4c32e295c08ebe224e2c5ba6497f043"><div class="ttname"><a href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ad4c32e295c08ebe224e2c5ba6497f043">INVERSE_NORM</a></div><div class="ttdeci">@ INVERSE_NORM</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00232">QuEST.h:232</a></div></div>
<div class="ttc" id="agroup__testutilities_html_ga49be3b32f7b7a274fc5ecb209fde1189"><div class="ttname"><a href="group__testutilities.html#ga49be3b32f7b7a274fc5ecb209fde1189">getTwosComplement</a></div><div class="ttdeci">long long int getTwosComplement(long long int decimal, int numBits)</div><div class="ttdoc">Returns the two's complement signed encoding of the unsigned number decimal, which must be a number b...</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l01286">utilities.cpp:1286</a></div></div>
<div class="ttc" id="astructQureg_html"><div class="ttname"><a href="structQureg.html">Qureg</a></div><div class="ttdoc">Represents a system of qubits.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00322">QuEST.h:322</a></div></div>
<div class="ttc" id="astructComplexMatrixN_html_afde13e469a3b4f179f45e53d1ec0a7cf"><div class="ttname"><a href="structComplexMatrixN.html#afde13e469a3b4f179f45e53d1ec0a7cf">ComplexMatrixN::imag</a></div><div class="ttdeci">qreal ** imag</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00190">QuEST.h:190</a></div></div>
<div class="ttc" id="agroup__type_html_ggaa7d869b117ba5024d6b84938e8cdfc65acb6911398e0068f545a31b82bcdef3e4"><div class="ttname"><a href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65acb6911398e0068f545a31b82bcdef3e4">PRODUCT</a></div><div class="ttdeci">@ PRODUCT</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00233">QuEST.h:233</a></div></div>
<div class="ttc" id="agroup__operator_html_ga8dca543fb4d1ee1cd8b4c5d6028b3075"><div class="ttname"><a href="group__operator.html#ga8dca543fb4d1ee1cd8b4c5d6028b3075">applyMultiVarPhaseFuncOverrides</a></div><div class="ttdeci">void applyMultiVarPhaseFuncOverrides(Qureg qureg, int *qubits, int *numQubitsPerReg, int numRegs, enum bitEncoding encoding, qreal *coeffs, qreal *exponents, int *numTermsPerReg, long long int *overrideInds, qreal *overridePhases, int numOverrides)</div><div class="ttdoc">Induces a phase change upon each amplitude of qureg, determined by a multi-variable exponential polyn...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00778">QuEST.c:778</a></div></div>
<div class="ttc" id="astructDiagonalOp_html_a2c6eab631ef48b4978db026c98180eee"><div class="ttname"><a href="structDiagonalOp.html#a2c6eab631ef48b4978db026c98180eee">DiagonalOp::numElemsPerChunk</a></div><div class="ttdeci">long long int numElemsPerChunk</div><div class="ttdoc">The number of the 2^numQubits amplitudes stored on each distributed node.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00302">QuEST.h:302</a></div></div>
<div class="ttc" id="agroup__type_html_gabd07eee133dcd4e6ae7c2d2ce4c42978"><div class="ttname"><a href="group__type.html#gabd07eee133dcd4e6ae7c2d2ce4c42978">createCloneQureg</a></div><div class="ttdeci">Qureg createCloneQureg(Qureg qureg, QuESTEnv env)</div><div class="ttdoc">Create a new Qureg which is an exact clone of the passed qureg, which can be either a state-vector or...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00064">QuEST.c:64</a></div></div>
<div class="ttc" id="agroup__testutilities_html_gabbc686f5f40eff22e08a2b2012ac4e41"><div class="ttname"><a href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a></div><div class="ttdeci">std::vector< std::vector< qcomp > > QMatrix</div><div class="ttdoc">A complex square matrix.</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8hpp_source.html#l00049">utilities.hpp:49</a></div></div>
<div class="ttc" id="agroup__testutilities_html_ga731a7a71755c25ebe96e742e3fbe5812"><div class="ttname"><a href="group__testutilities.html#ga731a7a71755c25ebe96e742e3fbe5812">toComplexMatrix2</a></div><div class="ttdeci">ComplexMatrix2 toComplexMatrix2(QMatrix qm)</div><div class="ttdoc">Returns a ComplexMatrix2 copy of QMatix qm.</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l01021">utilities.cpp:1021</a></div></div>
<div class="ttc" id="agroup__operator_html_gaf26f32c25db760065486188497c1da8b"><div class="ttname"><a href="group__operator.html#gaf26f32c25db760065486188497c1da8b">applyFullQFT</a></div><div class="ttdeci">void applyFullQFT(Qureg qureg)</div><div class="ttdoc">Applies the quantum Fourier transform (QFT) to the entirety of qureg.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00876">QuEST.c:876</a></div></div>
<div class="ttc" id="agroup__testutilities_html_ga35add15146aa606b256df79334b867d5"><div class="ttname"><a href="group__testutilities.html#ga35add15146aa606b256df79334b867d5">sublists</a></div><div class="ttdeci">Catch::Generators::GeneratorWrapper< int * > sublists(int *list, int len, int sublen)</div><div class="ttdoc">Returns a Catch2 generator of every length-sublen sublist of length-len list, in increasing lexograph...</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l01488">utilities.cpp:1488</a></div></div>
<div class="ttc" id="agroup__testutilities_html_gaa6a22a9144876cee28d54b70ea556527"><div class="ttname"><a href="group__testutilities.html#gaa6a22a9144876cee28d54b70ea556527">getRandomProbabilities</a></div><div class="ttdeci">std::vector< qreal > getRandomProbabilities(int numProbs)</div><div class="ttdoc">Returns a list of random real scalars, each in [0, 1], which sum to unity.</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l00472">utilities.cpp:472</a></div></div>
<div class="ttc" id="agroup__type_html_ggaa7d869b117ba5024d6b84938e8cdfc65ace23d4b924240a245d83193f0ce398d4"><div class="ttname"><a href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ace23d4b924240a245d83193f0ce398d4">SCALED_DISTANCE</a></div><div class="ttdeci">@ SCALED_DISTANCE</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00234">QuEST.h:234</a></div></div>
<div class="ttc" id="astructDiagonalOp_html_a1d66088bed235d524cd452b107694d5c"><div class="ttname"><a href="structDiagonalOp.html#a1d66088bed235d524cd452b107694d5c">DiagonalOp::real</a></div><div class="ttdeci">qreal * real</div><div class="ttdoc">The real values of the 2^numQubits complex elements.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00308">QuEST.h:308</a></div></div>
<div class="ttc" id="agroup__type_html_ga3392816c0643414165c2f5caeec17df0"><div class="ttname"><a href="group__type.html#ga3392816c0643414165c2f5caeec17df0">createQureg</a></div><div class="ttdeci">Qureg createQureg(int numQubits, QuESTEnv env)</div><div class="ttdoc">Creates a state-vector Qureg object representing a set of qubits which will remain in a pure state.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00036">QuEST.c:36</a></div></div>
<div class="ttc" id="agroup__type_html_gac1c8ed909b33bd55ae680901006051b6"><div class="ttname"><a href="group__type.html#gac1c8ed909b33bd55ae680901006051b6">destroyPauliHamil</a></div><div class="ttdeci">void destroyPauliHamil(PauliHamil h)</div><div class="ttdoc">Destroy a PauliHamil instance, created with either createPauliHamil() or createPauliHamilFromFile().</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01414">QuEST.c:1414</a></div></div>
<div class="ttc" id="agroup__testutilities_html_gaecd1e4149d03d358fc4e64c335e823ef"><div class="ttname"><a href="group__testutilities.html#gaecd1e4149d03d358fc4e64c335e823ef">getPureDensityMatrix</a></div><div class="ttdeci">QMatrix getPureDensityMatrix(QVector state)</div><div class="ttdoc">Returns a density matrix initialised into the given pure state.</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l00507">utilities.cpp:507</a></div></div>
<div class="ttc" id="agroup__testutilities_html_ga617b0fd1eb1c395762c937ad3b23e61b"><div class="ttname"><a href="group__testutilities.html#ga617b0fd1eb1c395762c937ad3b23e61b">getRandomDensityMatrix</a></div><div class="ttdeci">QMatrix getRandomDensityMatrix(int numQb)</div><div class="ttdoc">Returns a random numQb-by-numQb density matrix, from an undisclosed distribution, in a very mixed sta...</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l00490">utilities.cpp:490</a></div></div>
<div class="ttc" id="agroup__operator_html_ga225b82ff8b8eed1fff312240ec70c731"><div class="ttname"><a href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731">applyParamNamedPhaseFunc</a></div><div class="ttdeci">void applyParamNamedPhaseFunc(Qureg qureg, int *qubits, int *numQubitsPerReg, int numRegs, enum bitEncoding encoding, enum phaseFunc functionNameCode, qreal *params, int numParams)</div><div class="ttdoc">Induces a phase change upon each amplitude of qureg, determined by a named, paramaterized (and potent...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00831">QuEST.c:831</a></div></div>
<div class="ttc" id="agroup__type_html_ggaa7d869b117ba5024d6b84938e8cdfc65a39111120b79016d6b3e773b711fa63f7"><div class="ttname"><a href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a39111120b79016d6b3e773b711fa63f7">SCALED_INVERSE_SHIFTED_DISTANCE</a></div><div class="ttdeci">@ SCALED_INVERSE_SHIFTED_DISTANCE</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00234">QuEST.h:234</a></div></div>
<div class="ttc" id="agroup__testutilities_html_ga6ccbb15b0f234e926be96a153181b63a"><div class="ttname"><a href="group__testutilities.html#ga6ccbb15b0f234e926be96a153181b63a">getZeroMatrix</a></div><div class="ttdeci">QMatrix getZeroMatrix(size_t dim)</div><div class="ttdoc">Returns a dim-by-dim square complex matrix, initialised to all zeroes.</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l00153">utilities.cpp:153</a></div></div>
<div class="ttc" id="agroup__operator_html_gadfb5c1d99a22ce666fc715a8da2e0950"><div class="ttname"><a href="group__operator.html#gadfb5c1d99a22ce666fc715a8da2e0950">applyMatrix2</a></div><div class="ttdeci">void applyMatrix2(Qureg qureg, int targetQubit, ComplexMatrix2 u)</div><div class="ttdoc">Apply a general 2-by-2 matrix, which may be non-unitary.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01084">QuEST.c:1084</a></div></div>
<div class="ttc" id="atest__operators_8cpp_html_ae34496c47ef565b741782f01e710ea2c"><div class="ttname"><a href="test__operators_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a></div><div class="ttdeci">#define PREPARE_TEST(quregVec, quregMatr, refVec, refMatr)</div><div class="ttdoc">Prepares the needed data structures for unit testing some operators.</div><div class="ttdef"><b>Definition:</b> <a href="test__operators_8cpp_source.html#l00010">test_operators.cpp:10</a></div></div>
<div class="ttc" id="agroup__testutilities_html_ga27dc818709394cb31247e26850215f8a"><div class="ttname"><a href="group__testutilities.html#ga27dc818709394cb31247e26850215f8a">getRandomQVector</a></div><div class="ttdeci">QVector getRandomQVector(int dim)</div><div class="ttdoc">Returns a dim-length vector with random complex amplitudes in the square joining {-1-i,...</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l00435">utilities.cpp:435</a></div></div>
<div class="ttc" id="agroup__type_html_ggaa7d869b117ba5024d6b84938e8cdfc65a93c0c1e166dd43c6a57f61e5490808e1"><div class="ttname"><a href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a93c0c1e166dd43c6a57f61e5490808e1">SCALED_NORM</a></div><div class="ttdeci">@ SCALED_NORM</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00232">QuEST.h:232</a></div></div>
<div class="ttc" id="agroup__type_html_ggaa7d869b117ba5024d6b84938e8cdfc65a1a5168576607f460d3e60f184575cacb"><div class="ttname"><a href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65a1a5168576607f460d3e60f184575cacb">SCALED_INVERSE_PRODUCT</a></div><div class="ttdeci">@ SCALED_INVERSE_PRODUCT</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00233">QuEST.h:233</a></div></div>
<div class="ttc" id="agroup__testutilities_html_ga059fea2ee0415bf25929601ba0788164"><div class="ttname"><a href="group__testutilities.html#ga059fea2ee0415bf25929601ba0788164">applyReferenceMatrix</a></div><div class="ttdeci">void applyReferenceMatrix(QVector &state, int *ctrls, int numCtrls, int *targs, int numTargs, QMatrix op)</div><div class="ttdoc">Modifies the state-vector state to be the result of left-multiplying the multi-target operator matrix...</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l00841">utilities.cpp:841</a></div></div>
<div class="ttc" id="agroup__testutilities_html_ga7ed0c22ff6b671eecccef4dac54bd6c1"><div class="ttname"><a href="group__testutilities.html#ga7ed0c22ff6b671eecccef4dac54bd6c1">getDFT</a></div><div class="ttdeci">QVector getDFT(QVector in)</div><div class="ttdoc">Returns the discrete fourier transform of vector in.</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l00652">utilities.cpp:652</a></div></div>
<div class="ttc" id="agroup__testutilities_html_ga45cc399adad2e2a67b0124851189fae5"><div class="ttname"><a href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a></div><div class="ttdeci">bool areEqual(QVector a, QVector b)</div><div class="ttdoc">Returns true if the absolute value of the difference between every amplitude in vectors a and b is le...</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l00398">utilities.cpp:398</a></div></div>
<div class="ttc" id="agroup__type_html_ga93e55b6650b408abb30a1d4a8bce757c"><div class="ttname"><a href="group__type.html#ga93e55b6650b408abb30a1d4a8bce757c">createDensityQureg</a></div><div class="ttdeci">Qureg createDensityQureg(int numQubits, QuESTEnv env)</div><div class="ttdoc">Creates a density matrix Qureg object representing a set of qubits which can enter noisy and mixed st...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00050">QuEST.c:50</a></div></div>
<div class="ttc" id="agroup__testutilities_html_ga731c2de4d491629d806a03e0aea2f3a3"><div class="ttname"><a href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a></div><div class="ttdeci">void applyReferenceOp(QVector &state, int *ctrls, int numCtrls, int *targs, int numTargs, QMatrix op)</div><div class="ttdoc">Modifies the state-vector state to be the result of applying the multi-target operator matrix op,...</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l00728">utilities.cpp:728</a></div></div>
<div class="ttc" id="aQuEST__common_8c_html_ae71449b1cc6e6250b91f539153a7a0d3"><div class="ttname"><a href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a></div><div class="ttdeci">#define M_PI</div><div class="ttdef"><b>Definition:</b> <a href="QuEST__common_8c_source.html#l00041">QuEST_common.c:41</a></div></div>
<div class="ttc" id="agroup__operator_html_ga35b6321c578a8c69470132b5ee95f930"><div class="ttname"><a href="group__operator.html#ga35b6321c578a8c69470132b5ee95f930">applyTrotterCircuit</a></div><div class="ttdeci">void applyTrotterCircuit(Qureg qureg, PauliHamil hamil, qreal time, int order, int reps)</div><div class="ttdoc">Applies a trotterisation of unitary evolution to qureg.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01070">QuEST.c:1070</a></div></div>
<div class="ttc" id="agroup__type_html_ga35b28710877c462927366fa602e591cb"><div class="ttname"><a href="group__type.html#ga35b28710877c462927366fa602e591cb">createPauliHamil</a></div><div class="ttdeci">PauliHamil createPauliHamil(int numQubits, int numSumTerms)</div><div class="ttdoc">Dynamically allocates a Hamiltonian expressed as a real-weighted sum of products of Pauli operators.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01398">QuEST.c:1398</a></div></div>
<div class="ttc" id="agroup__testutilities_html_ga723de136e368b9de0ac391f850d409ac"><div class="ttname"><a href="group__testutilities.html#ga723de136e368b9de0ac391f850d409ac">getRandomComplex</a></div><div class="ttdeci">qcomp getRandomComplex()</div><div class="ttdoc">Returns a random complex number within the square closing (-1-i) and (1+i), from a distribution unifo...</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l00431">utilities.cpp:431</a></div></div>
<div class="ttc" id="autilities_8hpp_html"><div class="ttname"><a href="utilities_8hpp.html">utilities.hpp</a></div></div>
<div class="ttc" id="agroup__type_html_ga9c91c41aa42ae537995e89ffc616afe1"><div class="ttname"><a href="group__type.html#ga9c91c41aa42ae537995e89ffc616afe1">bitEncoding</a></div><div class="ttdeci">bitEncoding</div><div class="ttdoc">Flags for specifying how the bits in sub-register computational basis states are mapped to indices in...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00269">QuEST.h:269</a></div></div>
<div class="ttc" id="agroup__type_html_gaebf896dd8d5eeaf9fd896f6cc8e334fe"><div class="ttname"><a href="group__type.html#gaebf896dd8d5eeaf9fd896f6cc8e334fe">createDiagonalOp</a></div><div class="ttdeci">DiagonalOp createDiagonalOp(int numQubits, QuESTEnv env)</div><div class="ttdoc">Creates a DiagonalOp representing a diagonal operator on the full Hilbert space of a Qureg.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01518">QuEST.c:1518</a></div></div>
<div class="ttc" id="astructComplexMatrix2_html"><div class="ttname"><a href="structComplexMatrix2.html">ComplexMatrix2</a></div><div class="ttdoc">Represents a 2x2 matrix of complex numbers.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00137">QuEST.h:137</a></div></div>
<div class="ttc" id="agroup__type_html_ggaa7d869b117ba5024d6b84938e8cdfc65ae8c96906c1ec109d295c491e572d01e2"><div class="ttname"><a href="group__type.html#ggaa7d869b117ba5024d6b84938e8cdfc65ae8c96906c1ec109d295c491e572d01e2">SCALED_INVERSE_NORM</a></div><div class="ttdeci">@ SCALED_INVERSE_NORM</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00232">QuEST.h:232</a></div></div>
<!-- HTML footer for doxygen 1.8.8-->
<!-- start footer part -->
</div>
</div>
</div>
</div>
</div>
</body>
<script type="text/javascript" src="boot.js"></script>
</html>
