<!-- 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: Unit tests</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><!-- top -->
<div class="header">
<div class="summary">
<a href="#func-members">Functions</a> </div>
<div class="headertitle">
<div class="title">Unit tests</div> </div>
</div><!--header-->
<div class="contents">
<p>Unit tests of the QuEST API, using Catch2 in C++14.
<a href="#details">More...</a></p>
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a>
Functions</h2></td></tr>
<tr class="memitem:gaff6822e79b947a9e3b791572c674c08c"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gaff6822e79b947a9e3b791572c674c08c">TEST_CASE</a> ("applyDiagonalOp", "[operators]")</td></tr>
<tr class="separator:gaff6822e79b947a9e3b791572c674c08c"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaaa80d67f0d860f26067987bcf3970ec1"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gaaa80d67f0d860f26067987bcf3970ec1">TEST_CASE</a> ("applyFullQFT", "[operators]")</td></tr>
<tr class="separator:gaaa80d67f0d860f26067987bcf3970ec1"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga8e5f825652d097b2f9aa3bac8250c755"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga8e5f825652d097b2f9aa3bac8250c755">TEST_CASE</a> ("applyMatrix2", "[operators]")</td></tr>
<tr class="separator:ga8e5f825652d097b2f9aa3bac8250c755"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaaf9a656af9b7f24e10768a2408287396"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gaaf9a656af9b7f24e10768a2408287396">TEST_CASE</a> ("applyMatrix4", "[operators]")</td></tr>
<tr class="separator:gaaf9a656af9b7f24e10768a2408287396"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaeefabb147eca8dfffe23ca34195b395f"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gaeefabb147eca8dfffe23ca34195b395f">TEST_CASE</a> ("applyMatrixN", "[operators]")</td></tr>
<tr class="separator:gaeefabb147eca8dfffe23ca34195b395f"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaa5fbe07e8ee18a944dfa88b00aef1803"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gaa5fbe07e8ee18a944dfa88b00aef1803">TEST_CASE</a> ("applyMultiControlledMatrixN", "[operators]")</td></tr>
<tr class="separator:gaa5fbe07e8ee18a944dfa88b00aef1803"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga271aeb53a90bef51ccb1a21bae0f184c"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga271aeb53a90bef51ccb1a21bae0f184c">TEST_CASE</a> ("applyMultiVarPhaseFunc", "[operators]")</td></tr>
<tr class="separator:ga271aeb53a90bef51ccb1a21bae0f184c"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gad82918a41dcee2da7a0cc8e6aebd542d"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gad82918a41dcee2da7a0cc8e6aebd542d">TEST_CASE</a> ("applyMultiVarPhaseFuncOverrides", "[operators]")</td></tr>
<tr class="separator:gad82918a41dcee2da7a0cc8e6aebd542d"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaf532fa260e97dfe85915b88688b8cbcb"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gaf532fa260e97dfe85915b88688b8cbcb">TEST_CASE</a> ("applyNamedPhaseFunc", "[operators]")</td></tr>
<tr class="separator:gaf532fa260e97dfe85915b88688b8cbcb"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gacaa45de6a609b372e667e046e5c9a466"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gacaa45de6a609b372e667e046e5c9a466">TEST_CASE</a> ("applyNamedPhaseFuncOverrides", "[operators]")</td></tr>
<tr class="separator:gacaa45de6a609b372e667e046e5c9a466"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gae27f08dded40dbdb9a7b3645ee182ff0"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gae27f08dded40dbdb9a7b3645ee182ff0">TEST_CASE</a> ("applyParamNamedPhaseFunc", "[operators]")</td></tr>
<tr class="separator:gae27f08dded40dbdb9a7b3645ee182ff0"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaaf0246e83a66816b2b6bfe3f6e69d376"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gaaf0246e83a66816b2b6bfe3f6e69d376">TEST_CASE</a> ("applyParamNamedPhaseFuncOverrides", "[operators]")</td></tr>
<tr class="separator:gaaf0246e83a66816b2b6bfe3f6e69d376"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga837338274c89440547aef67628640d97"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga837338274c89440547aef67628640d97">TEST_CASE</a> ("applyPauliHamil", "[operators]")</td></tr>
<tr class="separator:ga837338274c89440547aef67628640d97"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga37d50a46caa1bdf003155dafc4426b73"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga37d50a46caa1bdf003155dafc4426b73">TEST_CASE</a> ("applyPauliSum", "[operators]")</td></tr>
<tr class="separator:ga37d50a46caa1bdf003155dafc4426b73"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga86524404eb3532ca18d0e24e657316d9"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga86524404eb3532ca18d0e24e657316d9">TEST_CASE</a> ("applyPhaseFunc", "[operators]")</td></tr>
<tr class="separator:ga86524404eb3532ca18d0e24e657316d9"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga664e2e125ed1b394e177ac3e8d3c1d42"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga664e2e125ed1b394e177ac3e8d3c1d42">TEST_CASE</a> ("applyPhaseFuncOverrides", "[operators]")</td></tr>
<tr class="separator:ga664e2e125ed1b394e177ac3e8d3c1d42"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaa72a7f3d6425f04b1e3a8ebb4487ba5e"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gaa72a7f3d6425f04b1e3a8ebb4487ba5e">TEST_CASE</a> ("applyProjector", "[operators]")</td></tr>
<tr class="separator:gaa72a7f3d6425f04b1e3a8ebb4487ba5e"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga5731cef400dd2ad09f62ce3b4213fa49"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga5731cef400dd2ad09f62ce3b4213fa49">TEST_CASE</a> ("applyQFT", "[operators]")</td></tr>
<tr class="separator:ga5731cef400dd2ad09f62ce3b4213fa49"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga5510ce8d43eb02e094b284a60bc5b47c"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga5510ce8d43eb02e094b284a60bc5b47c">TEST_CASE</a> ("applyTrotterCircuit", "[operators]")</td></tr>
<tr class="separator:ga5510ce8d43eb02e094b284a60bc5b47c"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga4f3c9ca42b9b7cd322f1b89ba2350a81"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga4f3c9ca42b9b7cd322f1b89ba2350a81">TEST_CASE</a> ("calcDensityInnerProduct", "[calculations]")</td></tr>
<tr class="separator:ga4f3c9ca42b9b7cd322f1b89ba2350a81"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga73a058eb67be1476ac4e37be653d64c3"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga73a058eb67be1476ac4e37be653d64c3">TEST_CASE</a> ("calcExpecDiagonalOp", "[calculations]")</td></tr>
<tr class="separator:ga73a058eb67be1476ac4e37be653d64c3"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga3eb91320e5854d964b125bb659b83d41"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga3eb91320e5854d964b125bb659b83d41">TEST_CASE</a> ("calcExpecPauliHamil", "[calculations]")</td></tr>
<tr class="separator:ga3eb91320e5854d964b125bb659b83d41"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga8825124816954c15598897e157f6e048"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga8825124816954c15598897e157f6e048">TEST_CASE</a> ("calcExpecPauliProd", "[calculations]")</td></tr>
<tr class="separator:ga8825124816954c15598897e157f6e048"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga919ee8725c30d7378532714b70cfb389"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga919ee8725c30d7378532714b70cfb389">TEST_CASE</a> ("calcExpecPauliSum", "[calculations]")</td></tr>
<tr class="separator:ga919ee8725c30d7378532714b70cfb389"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaceb52fe2677e119547d5b5e0f2f202fb"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gaceb52fe2677e119547d5b5e0f2f202fb">TEST_CASE</a> ("calcFidelity", "[calculations]")</td></tr>
<tr class="separator:gaceb52fe2677e119547d5b5e0f2f202fb"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga769a51547f263527bf27bbbcb51014a8"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga769a51547f263527bf27bbbcb51014a8">TEST_CASE</a> ("calcHilbertSchmidtDistance", "[calculations]")</td></tr>
<tr class="separator:ga769a51547f263527bf27bbbcb51014a8"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaf08d29f7b27caf904b748c68ff3e3372"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gaf08d29f7b27caf904b748c68ff3e3372">TEST_CASE</a> ("calcInnerProduct", "[calculations]")</td></tr>
<tr class="separator:gaf08d29f7b27caf904b748c68ff3e3372"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga94b593526f4f9a58b9d15b6c1c00f039"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga94b593526f4f9a58b9d15b6c1c00f039">TEST_CASE</a> ("calcProbOfAllOutcomes", "[calculations]")</td></tr>
<tr class="separator:ga94b593526f4f9a58b9d15b6c1c00f039"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga9360d80704ffa985e33a131fc3821d9c"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga9360d80704ffa985e33a131fc3821d9c">TEST_CASE</a> ("calcProbOfOutcome", "[calculations]")</td></tr>
<tr class="separator:ga9360d80704ffa985e33a131fc3821d9c"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaf8e08b58f3e0d94166b600513224de63"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gaf8e08b58f3e0d94166b600513224de63">TEST_CASE</a> ("calcPurity", "[calculations]")</td></tr>
<tr class="separator:gaf8e08b58f3e0d94166b600513224de63"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga841339ebf8e009dca360aeb0fcc51acc"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga841339ebf8e009dca360aeb0fcc51acc">TEST_CASE</a> ("calcTotalProb", "[calculations]")</td></tr>
<tr class="separator:ga841339ebf8e009dca360aeb0fcc51acc"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga13e82817429e0c055b01df8328ea25e9"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga13e82817429e0c055b01df8328ea25e9">TEST_CASE</a> ("cloneQureg", "[state_initialisations]")</td></tr>
<tr class="separator:ga13e82817429e0c055b01df8328ea25e9"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga0168f7b5f09ccbb226144053ad1b7497"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga0168f7b5f09ccbb226144053ad1b7497">TEST_CASE</a> ("collapseToOutcome", "[gates]")</td></tr>
<tr class="separator:ga0168f7b5f09ccbb226144053ad1b7497"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga282f468229dd7da6f78f9ac98990a477"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga282f468229dd7da6f78f9ac98990a477">TEST_CASE</a> ("compactUnitary", "[unitaries]")</td></tr>
<tr class="separator:ga282f468229dd7da6f78f9ac98990a477"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga7c4749ab5725b6608bf63313b2aaf48f"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga7c4749ab5725b6608bf63313b2aaf48f">TEST_CASE</a> ("controlledCompactUnitary", "[unitaries]")</td></tr>
<tr class="separator:ga7c4749ab5725b6608bf63313b2aaf48f"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga682affdaafaac3c37cb7155d9aae588b"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga682affdaafaac3c37cb7155d9aae588b">TEST_CASE</a> ("controlledMultiQubitUnitary", "[unitaries]")</td></tr>
<tr class="separator:ga682affdaafaac3c37cb7155d9aae588b"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga6547a0c5b3e34f461a9b0fd859445e78"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga6547a0c5b3e34f461a9b0fd859445e78">TEST_CASE</a> ("controlledNot", "[unitaries]")</td></tr>
<tr class="separator:ga6547a0c5b3e34f461a9b0fd859445e78"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga68c2309cfe69baf8733fd333451353f1"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga68c2309cfe69baf8733fd333451353f1">TEST_CASE</a> ("controlledPauliY", "[unitaries]")</td></tr>
<tr class="separator:ga68c2309cfe69baf8733fd333451353f1"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaa1bacf29d7a0a247e5a944bf76f086d0"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gaa1bacf29d7a0a247e5a944bf76f086d0">TEST_CASE</a> ("controlledPhaseFlip", "[unitaries]")</td></tr>
<tr class="separator:gaa1bacf29d7a0a247e5a944bf76f086d0"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaab0f5a29d8c51dc46ae1dd14b453b920"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gaab0f5a29d8c51dc46ae1dd14b453b920">TEST_CASE</a> ("controlledPhaseShift", "[unitaries]")</td></tr>
<tr class="separator:gaab0f5a29d8c51dc46ae1dd14b453b920"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga59fc931b7033092612225a53c41a2296"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga59fc931b7033092612225a53c41a2296">TEST_CASE</a> ("controlledRotateAroundAxis", "[unitaries]")</td></tr>
<tr class="separator:ga59fc931b7033092612225a53c41a2296"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga19c50d3654196a8c0f0574505c8ef816"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga19c50d3654196a8c0f0574505c8ef816">TEST_CASE</a> ("controlledRotateX", "[unitaries]")</td></tr>
<tr class="separator:ga19c50d3654196a8c0f0574505c8ef816"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga8b6968998c3a5d74b05d440c5e342b66"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga8b6968998c3a5d74b05d440c5e342b66">TEST_CASE</a> ("controlledRotateY", "[unitaries]")</td></tr>
<tr class="separator:ga8b6968998c3a5d74b05d440c5e342b66"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga803a1dbe819fc49e4844b50d237a4dd6"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga803a1dbe819fc49e4844b50d237a4dd6">TEST_CASE</a> ("controlledRotateZ", "[unitaries]")</td></tr>
<tr class="separator:ga803a1dbe819fc49e4844b50d237a4dd6"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga2e579c6fbc9f3f280fbfbea944de9c42"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga2e579c6fbc9f3f280fbfbea944de9c42">TEST_CASE</a> ("controlledTwoQubitUnitary", "[unitaries]")</td></tr>
<tr class="separator:ga2e579c6fbc9f3f280fbfbea944de9c42"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga9b4d4087da235bc2ea909ca2586c8ab6"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga9b4d4087da235bc2ea909ca2586c8ab6">TEST_CASE</a> ("controlledUnitary", "[unitaries]")</td></tr>
<tr class="separator:ga9b4d4087da235bc2ea909ca2586c8ab6"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga6d178e69b7654ae26e9f6365fd8208e8"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga6d178e69b7654ae26e9f6365fd8208e8">TEST_CASE</a> ("createCloneQureg", "[data_structures]")</td></tr>
<tr class="separator:ga6d178e69b7654ae26e9f6365fd8208e8"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaf929e0eed564772adcd99d2b1cab3818"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gaf929e0eed564772adcd99d2b1cab3818">TEST_CASE</a> ("createComplexMatrixN", "[data_structures]")</td></tr>
<tr class="separator:gaf929e0eed564772adcd99d2b1cab3818"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaf8887d313b85b6d9c90771e27fc0f9ff"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gaf8887d313b85b6d9c90771e27fc0f9ff">TEST_CASE</a> ("createDensityQureg", "[data_structures]")</td></tr>
<tr class="separator:gaf8887d313b85b6d9c90771e27fc0f9ff"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga41cd862a085c00936840cc0e616b6a2d"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga41cd862a085c00936840cc0e616b6a2d">TEST_CASE</a> ("createDiagonalOp", "[data_structures]")</td></tr>
<tr class="separator:ga41cd862a085c00936840cc0e616b6a2d"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga06be79820f0c646ac3bb918f91bbd02d"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga06be79820f0c646ac3bb918f91bbd02d">TEST_CASE</a> ("createDiagonalOpFromPauliHamilFile", "[data_structures]")</td></tr>
<tr class="separator:ga06be79820f0c646ac3bb918f91bbd02d"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga2a19fb07f8547c784187eba7245e8cbd"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga2a19fb07f8547c784187eba7245e8cbd">TEST_CASE</a> ("createPauliHamil", "[data_structures]")</td></tr>
<tr class="separator:ga2a19fb07f8547c784187eba7245e8cbd"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gace8b19274c10a208bbfac7437171cf2b"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gace8b19274c10a208bbfac7437171cf2b">TEST_CASE</a> ("createPauliHamilFromFile", "[data_structures]")</td></tr>
<tr class="separator:gace8b19274c10a208bbfac7437171cf2b"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga18b791c2fe5a2c484c51879ef16fba22"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga18b791c2fe5a2c484c51879ef16fba22">TEST_CASE</a> ("createQuESTEnv", "[data_structures]")</td></tr>
<tr class="separator:ga18b791c2fe5a2c484c51879ef16fba22"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga9aec4500e0046f8b085bb800f79db544"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga9aec4500e0046f8b085bb800f79db544">TEST_CASE</a> ("createQureg", "[data_structures]")</td></tr>
<tr class="separator:ga9aec4500e0046f8b085bb800f79db544"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaa4304249b102cdc1471be54a8765442f"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gaa4304249b102cdc1471be54a8765442f">TEST_CASE</a> ("destroyComplexMatrixN", "[data_structures]")</td></tr>
<tr class="separator:gaa4304249b102cdc1471be54a8765442f"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaf37fdb380465c3405ba756717171e805"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gaf37fdb380465c3405ba756717171e805">TEST_CASE</a> ("destroyDiagonalOp", "[data_structures]")</td></tr>
<tr class="separator:gaf37fdb380465c3405ba756717171e805"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga5244023e258b1b5e43352ae0d4f9a2c6"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga5244023e258b1b5e43352ae0d4f9a2c6">TEST_CASE</a> ("destroyPauliHamil", "[data_structures]")</td></tr>
<tr class="separator:ga5244023e258b1b5e43352ae0d4f9a2c6"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gab5ca964a4d64491f3c32e7fda334a5e1"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gab5ca964a4d64491f3c32e7fda334a5e1">TEST_CASE</a> ("destroyQuESTEnv", "[data_structures]")</td></tr>
<tr class="separator:gab5ca964a4d64491f3c32e7fda334a5e1"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga6e2d6773435b9191791ef1e6fb844337"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga6e2d6773435b9191791ef1e6fb844337">TEST_CASE</a> ("destroyQureg", "[data_structures]")</td></tr>
<tr class="separator:ga6e2d6773435b9191791ef1e6fb844337"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga2f0067941939643bc87b445995fc873c"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga2f0067941939643bc87b445995fc873c">TEST_CASE</a> ("fromComplex", "[data_structures]")</td></tr>
<tr class="separator:ga2f0067941939643bc87b445995fc873c"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaf530a2a0e2809ded8812a4967d291c3e"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gaf530a2a0e2809ded8812a4967d291c3e">TEST_CASE</a> ("getAmp", "[calculations]")</td></tr>
<tr class="separator:gaf530a2a0e2809ded8812a4967d291c3e"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga91c97193b23d8dcba69ad8af5ff31b85"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga91c97193b23d8dcba69ad8af5ff31b85">TEST_CASE</a> ("getDensityAmp", "[calculations]")</td></tr>
<tr class="separator:ga91c97193b23d8dcba69ad8af5ff31b85"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gae43391f4fc72b35c87ea4d76576463be"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gae43391f4fc72b35c87ea4d76576463be">TEST_CASE</a> ("getImagAmp", "[calculations]")</td></tr>
<tr class="separator:gae43391f4fc72b35c87ea4d76576463be"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga77058278e43deef9a7daac38746acdcd"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga77058278e43deef9a7daac38746acdcd">TEST_CASE</a> ("getNumAmps", "[calculations]")</td></tr>
<tr class="separator:ga77058278e43deef9a7daac38746acdcd"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga6161165d2a2ba0a72691e040964f86f4"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga6161165d2a2ba0a72691e040964f86f4">TEST_CASE</a> ("getNumQubits", "[calculations]")</td></tr>
<tr class="separator:ga6161165d2a2ba0a72691e040964f86f4"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gad7d8932b28815ad719e3ff6cc29f5656"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gad7d8932b28815ad719e3ff6cc29f5656">TEST_CASE</a> ("getProbAmp", "[calculations]")</td></tr>
<tr class="separator:gad7d8932b28815ad719e3ff6cc29f5656"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gadf3a64a1dff4833aa96ecb3c98656398"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gadf3a64a1dff4833aa96ecb3c98656398">TEST_CASE</a> ("getRealAmp", "[calculations]")</td></tr>
<tr class="separator:gadf3a64a1dff4833aa96ecb3c98656398"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga52ecd483c4f7634460972b70983de21c"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga52ecd483c4f7634460972b70983de21c">TEST_CASE</a> ("getStaticComplexMatrixN", "[data_structures]")</td></tr>
<tr class="separator:ga52ecd483c4f7634460972b70983de21c"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gab0eaeafe2da6bc602f8c79ecb986eb7f"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gab0eaeafe2da6bc602f8c79ecb986eb7f">TEST_CASE</a> ("hadamard", "[unitaries]")</td></tr>
<tr class="separator:gab0eaeafe2da6bc602f8c79ecb986eb7f"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga4ac023fcc2426bf185cc8e36a69c2e94"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga4ac023fcc2426bf185cc8e36a69c2e94">TEST_CASE</a> ("initBlankState", "[state_initialisations]")</td></tr>
<tr class="separator:ga4ac023fcc2426bf185cc8e36a69c2e94"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gafb36244534a4b9b1faa53d3bfe28e3a3"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gafb36244534a4b9b1faa53d3bfe28e3a3">TEST_CASE</a> ("initClassicalState", "[state_initialisations]")</td></tr>
<tr class="separator:gafb36244534a4b9b1faa53d3bfe28e3a3"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga9e5aba81a2f4e762ce05a1c7abd9349a"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga9e5aba81a2f4e762ce05a1c7abd9349a">TEST_CASE</a> ("initComplexMatrixN", "[data_structures]")</td></tr>
<tr class="separator:ga9e5aba81a2f4e762ce05a1c7abd9349a"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaa2c7bf2a5f949a7ecaf3e6a8225473db"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gaa2c7bf2a5f949a7ecaf3e6a8225473db">TEST_CASE</a> ("initDiagonalOp", "[data_structures]")</td></tr>
<tr class="separator:gaa2c7bf2a5f949a7ecaf3e6a8225473db"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga2e45ead2b0f35b36a499980365d7cd1a"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga2e45ead2b0f35b36a499980365d7cd1a">TEST_CASE</a> ("initDiagonalOpFromPauliHamil", "[data_structures]")</td></tr>
<tr class="separator:ga2e45ead2b0f35b36a499980365d7cd1a"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga39589b493222666589cb6596b219a14d"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga39589b493222666589cb6596b219a14d">TEST_CASE</a> ("initPauliHamil", "[data_structures]")</td></tr>
<tr class="separator:ga39589b493222666589cb6596b219a14d"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaf2260af68bc6f547784bc900602ef5fe"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gaf2260af68bc6f547784bc900602ef5fe">TEST_CASE</a> ("initPlusState", "[state_initialisations]")</td></tr>
<tr class="separator:gaf2260af68bc6f547784bc900602ef5fe"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gace25006fc345a5e33f17f1fdde217922"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gace25006fc345a5e33f17f1fdde217922">TEST_CASE</a> ("initPureState", "[state_initialisations]")</td></tr>
<tr class="separator:gace25006fc345a5e33f17f1fdde217922"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga4850d47d4eb8f39634b45e1073a46c09"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga4850d47d4eb8f39634b45e1073a46c09">TEST_CASE</a> ("initStateFromAmps", "[state_initialisations]")</td></tr>
<tr class="separator:ga4850d47d4eb8f39634b45e1073a46c09"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gacecf4e81c80f9c9c7df49b137923062d"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gacecf4e81c80f9c9c7df49b137923062d">TEST_CASE</a> ("initZeroState", "[state_initialisations]")</td></tr>
<tr class="separator:gacecf4e81c80f9c9c7df49b137923062d"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga1562bc2faa4f587e665f8974cbcc62f4"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga1562bc2faa4f587e665f8974cbcc62f4">TEST_CASE</a> ("measure", "[gates]")</td></tr>
<tr class="separator:ga1562bc2faa4f587e665f8974cbcc62f4"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga61e1bd261993b019232f5d5214423280"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga61e1bd261993b019232f5d5214423280">TEST_CASE</a> ("measureWithStats", "[gates]")</td></tr>
<tr class="separator:ga61e1bd261993b019232f5d5214423280"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga6b6a9b1ee734f0ab27cbfbb575bc7b77"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga6b6a9b1ee734f0ab27cbfbb575bc7b77">TEST_CASE</a> ("mixDamping", "[decoherence]")</td></tr>
<tr class="separator:ga6b6a9b1ee734f0ab27cbfbb575bc7b77"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga3c9d9dcf1fb89d6a95ec46fbdc2a6efa"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga3c9d9dcf1fb89d6a95ec46fbdc2a6efa">TEST_CASE</a> ("mixDensityMatrix", "[decoherence]")</td></tr>
<tr class="separator:ga3c9d9dcf1fb89d6a95ec46fbdc2a6efa"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga9c424dd4c51660f7a609a2937cc71fbb"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga9c424dd4c51660f7a609a2937cc71fbb">TEST_CASE</a> ("mixDephasing", "[decoherence]")</td></tr>
<tr class="separator:ga9c424dd4c51660f7a609a2937cc71fbb"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gae4e453a9c519926b39e3c45a6b1402d2"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gae4e453a9c519926b39e3c45a6b1402d2">TEST_CASE</a> ("mixDepolarising", "[decoherence]")</td></tr>
<tr class="separator:gae4e453a9c519926b39e3c45a6b1402d2"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaaca97157c5296fa1312c8daa3ac89864"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gaaca97157c5296fa1312c8daa3ac89864">TEST_CASE</a> ("mixKrausMap", "[decoherence]")</td></tr>
<tr class="separator:gaaca97157c5296fa1312c8daa3ac89864"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaec7d511066d9bb4da613fb06d5ce8e22"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gaec7d511066d9bb4da613fb06d5ce8e22">TEST_CASE</a> ("mixMultiQubitKrausMap", "[decoherence]")</td></tr>
<tr class="separator:gaec7d511066d9bb4da613fb06d5ce8e22"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga4e1cffea3db565911c48cae1d6d08a64"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga4e1cffea3db565911c48cae1d6d08a64">TEST_CASE</a> ("mixPauli", "[decoherence]")</td></tr>
<tr class="separator:ga4e1cffea3db565911c48cae1d6d08a64"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gab377b0280d26028a2405eb883003fe10"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gab377b0280d26028a2405eb883003fe10">TEST_CASE</a> ("mixTwoQubitDephasing", "[decoherence]")</td></tr>
<tr class="separator:gab377b0280d26028a2405eb883003fe10"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga126f891ab958e59fbb3add97c5a519e3"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga126f891ab958e59fbb3add97c5a519e3">TEST_CASE</a> ("mixTwoQubitDepolarising", "[decoherence]")</td></tr>
<tr class="separator:ga126f891ab958e59fbb3add97c5a519e3"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga6133174f068561e9d899c059c39ed36c"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga6133174f068561e9d899c059c39ed36c">TEST_CASE</a> ("mixTwoQubitKrausMap", "[decoherence]")</td></tr>
<tr class="separator:ga6133174f068561e9d899c059c39ed36c"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gab0d956ee2aa3a9288b3d39dde5e6f75d"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gab0d956ee2aa3a9288b3d39dde5e6f75d">TEST_CASE</a> ("multiControlledMultiQubitNot", "[unitaries]")</td></tr>
<tr class="separator:gab0d956ee2aa3a9288b3d39dde5e6f75d"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga4a7295ff2f6ab9b0569da7a4f34056fc"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga4a7295ff2f6ab9b0569da7a4f34056fc">TEST_CASE</a> ("multiControlledMultiQubitUnitary", "[unitaries]")</td></tr>
<tr class="separator:ga4a7295ff2f6ab9b0569da7a4f34056fc"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga5274be4471e8361ea91a59600a21f07e"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga5274be4471e8361ea91a59600a21f07e">TEST_CASE</a> ("multiControlledMultiRotatePauli", "[unitaries]")</td></tr>
<tr class="separator:ga5274be4471e8361ea91a59600a21f07e"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaa0575f97da20b2ccb7e755d7e5b02ca4"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gaa0575f97da20b2ccb7e755d7e5b02ca4">TEST_CASE</a> ("multiControlledMultiRotateZ", "[unitaries]")</td></tr>
<tr class="separator:gaa0575f97da20b2ccb7e755d7e5b02ca4"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gac41ea931fcc90e931b0ca2bf98cd9dd0"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gac41ea931fcc90e931b0ca2bf98cd9dd0">TEST_CASE</a> ("multiControlledPhaseFlip", "[unitaries]")</td></tr>
<tr class="separator:gac41ea931fcc90e931b0ca2bf98cd9dd0"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga7c7b67eb8b1ff63a941caa2d9e830cd7"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga7c7b67eb8b1ff63a941caa2d9e830cd7">TEST_CASE</a> ("multiControlledPhaseShift", "[unitaries]")</td></tr>
<tr class="separator:ga7c7b67eb8b1ff63a941caa2d9e830cd7"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga8e86adfbd714cc3309fe15efaac8a33f"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga8e86adfbd714cc3309fe15efaac8a33f">TEST_CASE</a> ("multiControlledTwoQubitUnitary", "[unitaries]")</td></tr>
<tr class="separator:ga8e86adfbd714cc3309fe15efaac8a33f"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga9fc32abbfb35c76915b3b3e1ec3656d8"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga9fc32abbfb35c76915b3b3e1ec3656d8">TEST_CASE</a> ("multiControlledUnitary", "[unitaries]")</td></tr>
<tr class="separator:ga9fc32abbfb35c76915b3b3e1ec3656d8"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga111c113392a31c145f7d4a23cd25eed6"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga111c113392a31c145f7d4a23cd25eed6">TEST_CASE</a> ("multiQubitNot", "[unitaries]")</td></tr>
<tr class="separator:ga111c113392a31c145f7d4a23cd25eed6"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaf396e2e9e1e995adfb30947201c23590"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gaf396e2e9e1e995adfb30947201c23590">TEST_CASE</a> ("multiQubitUnitary", "[unitaries]")</td></tr>
<tr class="separator:gaf396e2e9e1e995adfb30947201c23590"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga838f36bbb6dcb2aedca45153317fad16"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga838f36bbb6dcb2aedca45153317fad16">TEST_CASE</a> ("multiRotatePauli", "[unitaries]")</td></tr>
<tr class="separator:ga838f36bbb6dcb2aedca45153317fad16"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga269a80f587f1aee7e9eddfbc18022f10"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga269a80f587f1aee7e9eddfbc18022f10">TEST_CASE</a> ("multiRotateZ", "[unitaries]")</td></tr>
<tr class="separator:ga269a80f587f1aee7e9eddfbc18022f10"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga293349dc468b808c15bd68891370ef11"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga293349dc468b808c15bd68891370ef11">TEST_CASE</a> ("multiStateControlledUnitary", "[unitaries]")</td></tr>
<tr class="separator:ga293349dc468b808c15bd68891370ef11"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga873998873d09f3c3fa51e46c39076dee"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga873998873d09f3c3fa51e46c39076dee">TEST_CASE</a> ("pauliX", "[unitaries]")</td></tr>
<tr class="separator:ga873998873d09f3c3fa51e46c39076dee"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga751edff600b7ffba3a9d85565e246325"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga751edff600b7ffba3a9d85565e246325">TEST_CASE</a> ("pauliY", "[unitaries]")</td></tr>
<tr class="separator:ga751edff600b7ffba3a9d85565e246325"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga25a1ad7cfce5d2dcf4365bc107aeeb6c"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga25a1ad7cfce5d2dcf4365bc107aeeb6c">TEST_CASE</a> ("pauliZ", "[unitaries]")</td></tr>
<tr class="separator:ga25a1ad7cfce5d2dcf4365bc107aeeb6c"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga80f19ddf4e3207f35d4e2c75da05de0e"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga80f19ddf4e3207f35d4e2c75da05de0e">TEST_CASE</a> ("phaseShift", "[unitaries]")</td></tr>
<tr class="separator:ga80f19ddf4e3207f35d4e2c75da05de0e"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaa95c4914751cec33d489db13ee199043"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gaa95c4914751cec33d489db13ee199043">TEST_CASE</a> ("rotateAroundAxis", "[unitaries]")</td></tr>
<tr class="separator:gaa95c4914751cec33d489db13ee199043"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga8ab0a252e1289bc18855c992f2830cd8"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga8ab0a252e1289bc18855c992f2830cd8">TEST_CASE</a> ("rotateX", "[unitaries]")</td></tr>
<tr class="separator:ga8ab0a252e1289bc18855c992f2830cd8"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga00ec5df7831d054696e55454f32435f9"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga00ec5df7831d054696e55454f32435f9">TEST_CASE</a> ("rotateY", "[unitaries]")</td></tr>
<tr class="separator:ga00ec5df7831d054696e55454f32435f9"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga62bc1f37d73821911d160c2d4aab2e2a"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga62bc1f37d73821911d160c2d4aab2e2a">TEST_CASE</a> ("rotateZ", "[unitaries]")</td></tr>
<tr class="separator:ga62bc1f37d73821911d160c2d4aab2e2a"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga1331d2b39b5b126146735925cfc97179"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga1331d2b39b5b126146735925cfc97179">TEST_CASE</a> ("setAmps", "[state_initialisations]")</td></tr>
<tr class="separator:ga1331d2b39b5b126146735925cfc97179"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga71856bb29e1a3aa9947a67d480902f9e"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga71856bb29e1a3aa9947a67d480902f9e">TEST_CASE</a> ("setDiagonalOpElems", "[data_structures]")</td></tr>
<tr class="separator:ga71856bb29e1a3aa9947a67d480902f9e"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gae69938daf4948a63c3451f15b86bf537"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gae69938daf4948a63c3451f15b86bf537">TEST_CASE</a> ("setWeightedQureg", "[state_initialisations]")</td></tr>
<tr class="separator:gae69938daf4948a63c3451f15b86bf537"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gab9235c6edcb882a5d131013eaea4ea4a"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gab9235c6edcb882a5d131013eaea4ea4a">TEST_CASE</a> ("sGate", "[unitaries]")</td></tr>
<tr class="separator:gab9235c6edcb882a5d131013eaea4ea4a"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gac538ad512deccd07b15326bb3fcd864e"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gac538ad512deccd07b15326bb3fcd864e">TEST_CASE</a> ("sqrtSwapGate", "[unitaries]")</td></tr>
<tr class="separator:gac538ad512deccd07b15326bb3fcd864e"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga199ce1e1b6d7192b3a5477920b0d03e2"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga199ce1e1b6d7192b3a5477920b0d03e2">TEST_CASE</a> ("swapGate", "[unitaries]")</td></tr>
<tr class="separator:ga199ce1e1b6d7192b3a5477920b0d03e2"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga781f7de088fc2e86f4097dfe84e9cbf1"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga781f7de088fc2e86f4097dfe84e9cbf1">TEST_CASE</a> ("syncDiagonalOp", "[data_structures]")</td></tr>
<tr class="separator:ga781f7de088fc2e86f4097dfe84e9cbf1"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga4296b3ea07d5a25be3f5bd0e87459112"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga4296b3ea07d5a25be3f5bd0e87459112">TEST_CASE</a> ("tGate", "[unitaries]")</td></tr>
<tr class="separator:ga4296b3ea07d5a25be3f5bd0e87459112"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gabab3cf31bd73b8334ef6d2e7d2b2ea67"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#gabab3cf31bd73b8334ef6d2e7d2b2ea67">TEST_CASE</a> ("toComplex", "[data_structures]")</td></tr>
<tr class="separator:gabab3cf31bd73b8334ef6d2e7d2b2ea67"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga572d6aa93309f0de2004e2ede2a302e3"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga572d6aa93309f0de2004e2ede2a302e3">TEST_CASE</a> ("twoQubitUnitary", "[unitaries]")</td></tr>
<tr class="separator:ga572d6aa93309f0de2004e2ede2a302e3"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga826c9b5aef57549316ebef503203d85b"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__unittest.html#ga826c9b5aef57549316ebef503203d85b">TEST_CASE</a> ("unitary", "[unitaries]")</td></tr>
<tr class="separator:ga826c9b5aef57549316ebef503203d85b"><td class="memSeparator" colspan="2"> </td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<p>Unit tests of the QuEST API, using Catch2 in C++14. </p>
<h2 class="groupheader">Function Documentation</h2>
<a id="gaff6822e79b947a9e3b791572c674c08c"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaff6822e79b947a9e3b791572c674c08c">◆ </a></span>TEST_CASE() <span class="overload">[1/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"applyDiagonalOp" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[operators] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__operator.html#gad2e953390342cd361cfb4064d47715e6" title="Apply a diagonal operator, which is possibly non-unitary and non-Hermitian, to the entire qureg.">applyDiagonalOp</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__operators_8cpp_source.html#l00032">32</a> of file <a class="el" href="test__operators_8cpp_source.html">test_operators.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00032"></a><span class="lineno"> 32</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><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l01127">applyDiagonalOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__operators_8cpp_source.html#l00019">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l01518">createDiagonalOp()</a>, <a class="el" href="QuEST_8c_source.html#l01524">destroyDiagonalOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00421">getRandomReal()</a>, <a class="el" href="QuEST_8h_source.html#l00310">DiagonalOp::imag</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="QuEST_8h_source.html#l00302">DiagonalOp::numElemsPerChunk</a>, <a class="el" href="test__operators_8cpp_source.html#l00010">PREPARE_TEST</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, <a class="el" href="QuEST_8h_source.html#l00308">DiagonalOp::real</a>, <a class="el" href="QuEST_8c_source.html#l01531">syncDiagonalOp()</a>, and <a class="el" href="utilities_8cpp_source.html#l01044">toQMatrix()</a>.</p>
</div>
</div>
<a id="gaaa80d67f0d860f26067987bcf3970ec1"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaaa80d67f0d860f26067987bcf3970ec1">◆ </a></span>TEST_CASE() <span class="overload">[2/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"applyFullQFT" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[operators] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__operator.html#gaf26f32c25db760065486188497c1da8b" title="Applies the quantum Fourier transform (QFT) to the entirety of qureg.">applyFullQFT</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__operators_8cpp_source.html#l00083">83</a> of file <a class="el" href="test__operators_8cpp_source.html">test_operators.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00083"></a><span class="lineno"> 83</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><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l00876">applyFullQFT()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__operators_8cpp_source.html#l00019">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00652">getDFT()</a>, <a class="el" href="utilities_8cpp_source.html#l00640">getMixedDensityMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00507">getPureDensityMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00431">getRandomComplex()</a>, <a class="el" href="utilities_8cpp_source.html#l00613">getRandomOrthonormalVectors()</a>, <a class="el" href="utilities_8cpp_source.html#l00472">getRandomProbabilities()</a>, <a class="el" href="utilities_8cpp_source.html#l00435">getRandomQVector()</a>, <a class="el" href="utilities_8cpp_source.html#l00468">getRandomStateVector()</a>, <a class="el" href="utilities_8cpp_source.html#l00153">getZeroMatrix()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__operators_8cpp_source.html#l00010">PREPARE_TEST</a>, and <a class="el" href="utilities_8cpp_source.html#l01201">toQureg()</a>.</p>
</div>
</div>
<a id="ga8e5f825652d097b2f9aa3bac8250c755"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga8e5f825652d097b2f9aa3bac8250c755">◆ </a></span>TEST_CASE() <span class="overload">[3/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"applyMatrix2" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[operators] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__operator.html#gadfb5c1d99a22ce666fc715a8da2e0950" title="Apply a general 2-by-2 matrix, which may be non-unitary.">applyMatrix2</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__operators_8cpp_source.html#l00203">203</a> of file <a class="el" href="test__operators_8cpp_source.html">test_operators.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00203"></a><span class="lineno"> 203</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><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l01084">applyMatrix2()</a>, <a class="el" href="utilities_8cpp_source.html#l00841">applyReferenceMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__operators_8cpp_source.html#l00019">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00379">getRandomQMatrix()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__operators_8cpp_source.html#l00010">PREPARE_TEST</a>, and <a class="el" href="utilities_8cpp_source.html#l01021">toComplexMatrix2()</a>.</p>
</div>
</div>
<a id="gaaf9a656af9b7f24e10768a2408287396"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaaf9a656af9b7f24e10768a2408287396">◆ </a></span>TEST_CASE() <span class="overload">[4/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"applyMatrix4" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[operators] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__operator.html#ga74a955ec4bce606d89317bcfc528387f" title="Apply a general 4-by-4 matrix, which may be non-unitary.">applyMatrix4</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__operators_8cpp_source.html#l00253">253</a> of file <a class="el" href="test__operators_8cpp_source.html">test_operators.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00253"></a><span class="lineno"> 253</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><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l01093">applyMatrix4()</a>, <a class="el" href="utilities_8cpp_source.html#l00841">applyReferenceMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__operators_8cpp_source.html#l00019">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00379">getRandomQMatrix()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__operators_8cpp_source.html#l00010">PREPARE_TEST</a>, and <a class="el" href="utilities_8cpp_source.html#l01027">toComplexMatrix4()</a>.</p>
</div>
</div>
<a id="gaeefabb147eca8dfffe23ca34195b395f"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaeefabb147eca8dfffe23ca34195b395f">◆ </a></span>TEST_CASE() <span class="overload">[5/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"applyMatrixN" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[operators] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__operator.html#ga358e7094a98851afa86d27f0147e32a1" title="Apply a general N-by-N matrix, which may be non-unitary, on any number of target qubits.">applyMatrixN</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__operators_8cpp_source.html#l00318">318</a> of file <a class="el" href="test__operators_8cpp_source.html">test_operators.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00318"></a><span class="lineno"> 318</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><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l01103">applyMatrixN()</a>, <a class="el" href="utilities_8cpp_source.html#l00841">applyReferenceMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST__validation_8c_source.html#l00328">calcLog2()</a>, <a class="el" href="test__operators_8cpp_source.html#l00019">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l01348">createComplexMatrixN()</a>, <a class="el" href="QuEST_8c_source.html#l01369">destroyComplexMatrixN()</a>, <a class="el" href="utilities_8cpp_source.html#l00379">getRandomQMatrix()</a>, <a class="el" href="QuEST_8h_source.html#l00190">ComplexMatrixN::imag</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__operators_8cpp_source.html#l00010">PREPARE_TEST</a>, <a class="el" href="QuEST_8h_source.html#l00189">ComplexMatrixN::real</a>, <a class="el" href="utilities_8cpp_source.html#l01488">sublists()</a>, and <a class="el" href="utilities_8cpp_source.html#l01033">toComplexMatrixN()</a>.</p>
</div>
</div>
<a id="gaa5fbe07e8ee18a944dfa88b00aef1803"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaa5fbe07e8ee18a944dfa88b00aef1803">◆ </a></span>TEST_CASE() <span class="overload">[6/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"applyMultiControlledMatrixN" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[operators] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__operator.html#gab52b6315c5520b7d311b0458785eed8e" title="Apply a general N-by-N matrix, which may be non-unitary, with additional controlled qubits.">applyMultiControlledMatrixN</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__operators_8cpp_source.html#l00429">429</a> of file <a class="el" href="test__operators_8cpp_source.html">test_operators.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00429"></a><span class="lineno"> 429</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><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l01114">applyMultiControlledMatrixN()</a>, <a class="el" href="utilities_8cpp_source.html#l00841">applyReferenceMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST__validation_8c_source.html#l00328">calcLog2()</a>, <a class="el" href="test__operators_8cpp_source.html#l00019">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l01348">createComplexMatrixN()</a>, <a class="el" href="QuEST_8c_source.html#l01369">destroyComplexMatrixN()</a>, <a class="el" href="utilities_8cpp_source.html#l00379">getRandomQMatrix()</a>, <a class="el" href="QuEST_8h_source.html#l00190">ComplexMatrixN::imag</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__operators_8cpp_source.html#l00010">PREPARE_TEST</a>, <a class="el" href="QuEST_8h_source.html#l00189">ComplexMatrixN::real</a>, <a class="el" href="utilities_8cpp_source.html#l01488">sublists()</a>, and <a class="el" href="utilities_8cpp_source.html#l01033">toComplexMatrixN()</a>.</p>
</div>
</div>
<a id="ga271aeb53a90bef51ccb1a21bae0f184c"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga271aeb53a90bef51ccb1a21bae0f184c">◆ </a></span>TEST_CASE() <span class="overload">[7/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"applyMultiVarPhaseFunc" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[operators] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__operator.html#ga008a46d178a5a9691e2f5d363e3f518f" title="Induces a phase change upon each amplitude of qureg, determined by a multi-variable exponential polyn...">applyMultiVarPhaseFunc</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__operators_8cpp_source.html#l00589">589</a> of file <a class="el" href="test__operators_8cpp_source.html">test_operators.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00589"></a><span class="lineno"> 589</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><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l00761">applyMultiVarPhaseFunc()</a>, <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__operators_8cpp_source.html#l00019">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00417">expI()</a>, <a class="el" href="utilities_8cpp_source.html#l00143">getKroneckerProduct()</a>, <a class="el" href="utilities_8cpp_source.html#l00526">getRandomInt()</a>, <a class="el" href="utilities_8cpp_source.html#l00421">getRandomReal()</a>, <a class="el" href="utilities_8cpp_source.html#l01286">getTwosComplement()</a>, <a class="el" href="utilities_8cpp_source.html#l00153">getZeroMatrix()</a>, <a class="el" href="QuEST__precision_8h_source.html#l00072">MAX_NUM_REGS_APPLY_ARBITRARY_PHASE</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__operators_8cpp_source.html#l00010">PREPARE_TEST</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, <a class="el" href="utilities_8cpp_source.html#l01488">sublists()</a>, <a class="el" href="QuEST_8h_source.html#l00269">TWOS_COMPLEMENT</a>, and <a class="el" href="QuEST_8h_source.html#l00269">UNSIGNED</a>.</p>
</div>
</div>
<a id="gad82918a41dcee2da7a0cc8e6aebd542d"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gad82918a41dcee2da7a0cc8e6aebd542d">◆ </a></span>TEST_CASE() <span class="overload">[8/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"applyMultiVarPhaseFuncOverrides" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[operators] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__operator.html#ga8dca543fb4d1ee1cd8b4c5d6028b3075" title="Induces a phase change upon each amplitude of qureg, determined by a multi-variable exponential polyn...">applyMultiVarPhaseFuncOverrides</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__operators_8cpp_source.html#l00790">790</a> of file <a class="el" href="test__operators_8cpp_source.html">test_operators.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00790"></a><span class="lineno"> 790</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><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l00778">applyMultiVarPhaseFuncOverrides()</a>, <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__operators_8cpp_source.html#l00019">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00417">expI()</a>, <a class="el" href="utilities_8cpp_source.html#l00143">getKroneckerProduct()</a>, <a class="el" href="utilities_8cpp_source.html#l00526">getRandomInt()</a>, <a class="el" href="utilities_8cpp_source.html#l00421">getRandomReal()</a>, <a class="el" href="utilities_8cpp_source.html#l01286">getTwosComplement()</a>, <a class="el" href="utilities_8cpp_source.html#l00153">getZeroMatrix()</a>, <a class="el" href="QuEST__precision_8h_source.html#l00072">MAX_NUM_REGS_APPLY_ARBITRARY_PHASE</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__operators_8cpp_source.html#l00010">PREPARE_TEST</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, <a class="el" href="utilities_8cpp_source.html#l01316">setDiagMatrixOverrides()</a>, <a class="el" href="utilities_8cpp_source.html#l01488">sublists()</a>, <a class="el" href="QuEST_8h_source.html#l00269">TWOS_COMPLEMENT</a>, and <a class="el" href="QuEST_8h_source.html#l00269">UNSIGNED</a>.</p>
</div>
</div>
<a id="gaf532fa260e97dfe85915b88688b8cbcb"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaf532fa260e97dfe85915b88688b8cbcb">◆ </a></span>TEST_CASE() <span class="overload">[9/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"applyNamedPhaseFunc" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[operators] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__operator.html#gac4df97d8c125c8cc65df720f67b2bf69" title="Induces a phase change upon each amplitude of qureg, determined by a named (and potentially multi-var...">applyNamedPhaseFunc</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__operators_8cpp_source.html#l01061">1061</a> of file <a class="el" href="test__operators_8cpp_source.html">test_operators.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l01061"></a><span class="lineno"> 1061</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><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l00796">applyNamedPhaseFunc()</a>, <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__operators_8cpp_source.html#l00019">CLEANUP_TEST</a>, <a class="el" href="QuEST_8h_source.html#l00234">DISTANCE</a>, <a class="el" href="utilities_8cpp_source.html#l00417">expI()</a>, <a class="el" href="utilities_8cpp_source.html#l00526">getRandomInt()</a>, <a class="el" href="utilities_8cpp_source.html#l01286">getTwosComplement()</a>, <a class="el" href="utilities_8cpp_source.html#l00153">getZeroMatrix()</a>, <a class="el" href="QuEST_8h_source.html#l00234">INVERSE_DISTANCE</a>, <a class="el" href="QuEST_8h_source.html#l00232">INVERSE_NORM</a>, <a class="el" href="QuEST_8h_source.html#l00233">INVERSE_PRODUCT</a>, <a class="el" href="QuEST__precision_8h_source.html#l00072">MAX_NUM_REGS_APPLY_ARBITRARY_PHASE</a>, <a class="el" href="QuEST_8h_source.html#l00232">NORM</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__operators_8cpp_source.html#l00010">PREPARE_TEST</a>, <a class="el" href="QuEST_8h_source.html#l00233">PRODUCT</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, <a class="el" href="QuEST_8h_source.html#l00234">SCALED_DISTANCE</a>, <a class="el" href="QuEST_8h_source.html#l00234">SCALED_INVERSE_DISTANCE</a>, <a class="el" href="QuEST_8h_source.html#l00232">SCALED_INVERSE_NORM</a>, <a class="el" href="QuEST_8h_source.html#l00233">SCALED_INVERSE_PRODUCT</a>, <a class="el" href="QuEST_8h_source.html#l00234">SCALED_INVERSE_SHIFTED_DISTANCE</a>, <a class="el" href="QuEST_8h_source.html#l00232">SCALED_INVERSE_SHIFTED_NORM</a>, <a class="el" href="QuEST_8h_source.html#l00232">SCALED_NORM</a>, <a class="el" href="QuEST_8h_source.html#l00233">SCALED_PRODUCT</a>, <a class="el" href="utilities_8cpp_source.html#l01488">sublists()</a>, <a class="el" href="QuEST_8h_source.html#l00269">TWOS_COMPLEMENT</a>, and <a class="el" href="QuEST_8h_source.html#l00269">UNSIGNED</a>.</p>
</div>
</div>
<a id="gacaa45de6a609b372e667e046e5c9a466"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gacaa45de6a609b372e667e046e5c9a466">◆ </a></span>TEST_CASE() <span class="overload">[10/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"applyNamedPhaseFuncOverrides" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[operators] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__operator.html#ga2fbaec3bb21cc01f7a2a4ed2aa911ebf" title="Induces a phase change upon each amplitude of qureg, determined by a named (and potentially multi-var...">applyNamedPhaseFuncOverrides</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__operators_8cpp_source.html#l01273">1273</a> of file <a class="el" href="test__operators_8cpp_source.html">test_operators.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l01273"></a><span class="lineno"> 1273</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><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l00813">applyNamedPhaseFuncOverrides()</a>, <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__operators_8cpp_source.html#l00019">CLEANUP_TEST</a>, <a class="el" href="QuEST_8h_source.html#l00234">DISTANCE</a>, <a class="el" href="utilities_8cpp_source.html#l00417">expI()</a>, <a class="el" href="utilities_8cpp_source.html#l00526">getRandomInt()</a>, <a class="el" href="utilities_8cpp_source.html#l00421">getRandomReal()</a>, <a class="el" href="utilities_8cpp_source.html#l01286">getTwosComplement()</a>, <a class="el" href="utilities_8cpp_source.html#l00153">getZeroMatrix()</a>, <a class="el" href="QuEST_8h_source.html#l00234">INVERSE_DISTANCE</a>, <a class="el" href="QuEST_8h_source.html#l00232">INVERSE_NORM</a>, <a class="el" href="QuEST_8h_source.html#l00233">INVERSE_PRODUCT</a>, <a class="el" href="QuEST__precision_8h_source.html#l00072">MAX_NUM_REGS_APPLY_ARBITRARY_PHASE</a>, <a class="el" href="QuEST_8h_source.html#l00232">NORM</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__operators_8cpp_source.html#l00010">PREPARE_TEST</a>, <a class="el" href="QuEST_8h_source.html#l00233">PRODUCT</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, <a class="el" href="QuEST_8h_source.html#l00234">SCALED_DISTANCE</a>, <a class="el" href="QuEST_8h_source.html#l00234">SCALED_INVERSE_DISTANCE</a>, <a class="el" href="QuEST_8h_source.html#l00232">SCALED_INVERSE_NORM</a>, <a class="el" href="QuEST_8h_source.html#l00233">SCALED_INVERSE_PRODUCT</a>, <a class="el" href="QuEST_8h_source.html#l00234">SCALED_INVERSE_SHIFTED_DISTANCE</a>, <a class="el" href="QuEST_8h_source.html#l00232">SCALED_INVERSE_SHIFTED_NORM</a>, <a class="el" href="QuEST_8h_source.html#l00232">SCALED_NORM</a>, <a class="el" href="QuEST_8h_source.html#l00233">SCALED_PRODUCT</a>, <a class="el" href="utilities_8cpp_source.html#l01316">setDiagMatrixOverrides()</a>, <a class="el" href="utilities_8cpp_source.html#l01488">sublists()</a>, <a class="el" href="QuEST_8h_source.html#l00269">TWOS_COMPLEMENT</a>, and <a class="el" href="QuEST_8h_source.html#l00269">UNSIGNED</a>.</p>
</div>
</div>
<a id="gae27f08dded40dbdb9a7b3645ee182ff0"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gae27f08dded40dbdb9a7b3645ee182ff0">◆ </a></span>TEST_CASE() <span class="overload">[11/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"applyParamNamedPhaseFunc" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[operators] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__operator.html#ga225b82ff8b8eed1fff312240ec70c731" title="Induces a phase change upon each amplitude of qureg, determined by a named, paramaterized (and potent...">applyParamNamedPhaseFunc</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__operators_8cpp_source.html#l01552">1552</a> of file <a class="el" href="test__operators_8cpp_source.html">test_operators.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l01552"></a><span class="lineno"> 1552</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><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l00831">applyParamNamedPhaseFunc()</a>, <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__operators_8cpp_source.html#l00019">CLEANUP_TEST</a>, <a class="el" href="QuEST_8h_source.html#l00234">DISTANCE</a>, <a class="el" href="utilities_8cpp_source.html#l00417">expI()</a>, <a class="el" href="utilities_8cpp_source.html#l00526">getRandomInt()</a>, <a class="el" href="utilities_8cpp_source.html#l00421">getRandomReal()</a>, <a class="el" href="utilities_8cpp_source.html#l01286">getTwosComplement()</a>, <a class="el" href="utilities_8cpp_source.html#l00153">getZeroMatrix()</a>, <a class="el" href="QuEST_8h_source.html#l00234">INVERSE_DISTANCE</a>, <a class="el" href="QuEST_8h_source.html#l00232">INVERSE_NORM</a>, <a class="el" href="QuEST_8h_source.html#l00233">INVERSE_PRODUCT</a>, <a class="el" href="QuEST__precision_8h_source.html#l00072">MAX_NUM_REGS_APPLY_ARBITRARY_PHASE</a>, <a class="el" href="QuEST_8h_source.html#l00232">NORM</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__operators_8cpp_source.html#l00010">PREPARE_TEST</a>, <a class="el" href="QuEST_8h_source.html#l00233">PRODUCT</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, <a class="el" href="QuEST_8h_source.html#l00234">SCALED_DISTANCE</a>, <a class="el" href="QuEST_8h_source.html#l00234">SCALED_INVERSE_DISTANCE</a>, <a class="el" href="QuEST_8h_source.html#l00232">SCALED_INVERSE_NORM</a>, <a class="el" href="QuEST_8h_source.html#l00233">SCALED_INVERSE_PRODUCT</a>, <a class="el" href="QuEST_8h_source.html#l00234">SCALED_INVERSE_SHIFTED_DISTANCE</a>, <a class="el" href="QuEST_8h_source.html#l00232">SCALED_INVERSE_SHIFTED_NORM</a>, <a class="el" href="QuEST_8h_source.html#l00232">SCALED_NORM</a>, <a class="el" href="QuEST_8h_source.html#l00233">SCALED_PRODUCT</a>, <a class="el" href="utilities_8cpp_source.html#l01488">sublists()</a>, <a class="el" href="QuEST_8h_source.html#l00269">TWOS_COMPLEMENT</a>, and <a class="el" href="QuEST_8h_source.html#l00269">UNSIGNED</a>.</p>
</div>
</div>
<a id="gaaf0246e83a66816b2b6bfe3f6e69d376"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaaf0246e83a66816b2b6bfe3f6e69d376">◆ </a></span>TEST_CASE() <span class="overload">[12/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"applyParamNamedPhaseFuncOverrides" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[operators] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__operator.html#gaabd7efa3beebc9f3a525321d41a28989" title="Induces a phase change upon each amplitude of qureg, determined by a named, parameterised (and potent...">applyParamNamedPhaseFuncOverrides</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__operators_8cpp_source.html#l02079">2079</a> of file <a class="el" href="test__operators_8cpp_source.html">test_operators.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l02079"></a><span class="lineno"> 2079</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><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l00848">applyParamNamedPhaseFuncOverrides()</a>, <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__operators_8cpp_source.html#l00019">CLEANUP_TEST</a>, <a class="el" href="QuEST_8h_source.html#l00234">DISTANCE</a>, <a class="el" href="utilities_8cpp_source.html#l00417">expI()</a>, <a class="el" href="utilities_8cpp_source.html#l00526">getRandomInt()</a>, <a class="el" href="utilities_8cpp_source.html#l00421">getRandomReal()</a>, <a class="el" href="utilities_8cpp_source.html#l01286">getTwosComplement()</a>, <a class="el" href="utilities_8cpp_source.html#l00153">getZeroMatrix()</a>, <a class="el" href="QuEST_8h_source.html#l00234">INVERSE_DISTANCE</a>, <a class="el" href="QuEST_8h_source.html#l00232">INVERSE_NORM</a>, <a class="el" href="QuEST_8h_source.html#l00233">INVERSE_PRODUCT</a>, <a class="el" href="QuEST__precision_8h_source.html#l00072">MAX_NUM_REGS_APPLY_ARBITRARY_PHASE</a>, <a class="el" href="QuEST_8h_source.html#l00232">NORM</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__operators_8cpp_source.html#l00010">PREPARE_TEST</a>, <a class="el" href="QuEST_8h_source.html#l00233">PRODUCT</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, <a class="el" href="QuEST_8h_source.html#l00234">SCALED_DISTANCE</a>, <a class="el" href="QuEST_8h_source.html#l00234">SCALED_INVERSE_DISTANCE</a>, <a class="el" href="QuEST_8h_source.html#l00232">SCALED_INVERSE_NORM</a>, <a class="el" href="QuEST_8h_source.html#l00233">SCALED_INVERSE_PRODUCT</a>, <a class="el" href="QuEST_8h_source.html#l00234">SCALED_INVERSE_SHIFTED_DISTANCE</a>, <a class="el" href="QuEST_8h_source.html#l00232">SCALED_INVERSE_SHIFTED_NORM</a>, <a class="el" href="QuEST_8h_source.html#l00232">SCALED_NORM</a>, <a class="el" href="QuEST_8h_source.html#l00233">SCALED_PRODUCT</a>, <a class="el" href="utilities_8cpp_source.html#l01316">setDiagMatrixOverrides()</a>, <a class="el" href="utilities_8cpp_source.html#l01488">sublists()</a>, <a class="el" href="QuEST_8h_source.html#l00269">TWOS_COMPLEMENT</a>, and <a class="el" href="QuEST_8h_source.html#l00269">UNSIGNED</a>.</p>
</div>
</div>
<a id="ga837338274c89440547aef67628640d97"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga837338274c89440547aef67628640d97">◆ </a></span>TEST_CASE() <span class="overload">[13/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"applyPauliHamil" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[operators] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__operator.html#ga54d4e589468002bdc998200ae45e7312" title="Modifies outQureg to be the result of applying PauliHamil (a Hermitian but not necessarily unitary op...">applyPauliHamil</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__operators_8cpp_source.html#l02675">2675</a> of file <a class="el" href="test__operators_8cpp_source.html">test_operators.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l02675"></a><span class="lineno"> 2675</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><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l01059">applyPauliHamil()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l01398">createPauliHamil()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l01414">destroyPauliHamil()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="QuEST_8c_source.html#l01578">initDebugState()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="QuEST_8h_source.html#l00281">PauliHamil::pauliCodes</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, <a class="el" href="utilities_8cpp_source.html#l01229">setRandomPauliSum()</a>, <a class="el" href="utilities_8cpp_source.html#l01044">toQMatrix()</a>, and <a class="el" href="utilities_8cpp_source.html#l01113">toQVector()</a>.</p>
</div>
</div>
<a id="ga37d50a46caa1bdf003155dafc4426b73"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga37d50a46caa1bdf003155dafc4426b73">◆ </a></span>TEST_CASE() <span class="overload">[14/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"applyPauliSum" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[operators] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__operator.html#ga6fc26cf857db070e12959e59ecfed8a6" title="Modifies outQureg to be the result of applying the weighted sum of Pauli products (a Hermitian but no...">applyPauliSum</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__operators_8cpp_source.html#l02775">2775</a> of file <a class="el" href="test__operators_8cpp_source.html">test_operators.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l02775"></a><span class="lineno"> 2775</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><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l01048">applyPauliSum()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="QuEST_8c_source.html#l01578">initDebugState()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="QuEST_8h_source.html#l00096">PAULI_I</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, <a class="el" href="utilities_8cpp_source.html#l01229">setRandomPauliSum()</a>, <a class="el" href="utilities_8cpp_source.html#l01044">toQMatrix()</a>, and <a class="el" href="utilities_8cpp_source.html#l01113">toQVector()</a>.</p>
</div>
</div>
<a id="ga86524404eb3532ca18d0e24e657316d9"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga86524404eb3532ca18d0e24e657316d9">◆ </a></span>TEST_CASE() <span class="overload">[15/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"applyPhaseFunc" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[operators] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__operator.html#ga467f517abd18dbc3d6fced84c6589161" title="Induces a phase change upon each amplitude of qureg, determined by the passed exponential polynomial ...">applyPhaseFunc</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__operators_8cpp_source.html#l02871">2871</a> of file <a class="el" href="test__operators_8cpp_source.html">test_operators.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l02871"></a><span class="lineno"> 2871</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><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l00726">applyPhaseFunc()</a>, <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__operators_8cpp_source.html#l00019">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00417">expI()</a>, <a class="el" href="utilities_8cpp_source.html#l00526">getRandomInt()</a>, <a class="el" href="utilities_8cpp_source.html#l00421">getRandomReal()</a>, <a class="el" href="utilities_8cpp_source.html#l01286">getTwosComplement()</a>, <a class="el" href="utilities_8cpp_source.html#l00153">getZeroMatrix()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__operators_8cpp_source.html#l00010">PREPARE_TEST</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, <a class="el" href="utilities_8cpp_source.html#l01488">sublists()</a>, <a class="el" href="QuEST_8h_source.html#l00269">TWOS_COMPLEMENT</a>, and <a class="el" href="QuEST_8h_source.html#l00269">UNSIGNED</a>.</p>
</div>
</div>
<a id="ga664e2e125ed1b394e177ac3e8d3c1d42"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga664e2e125ed1b394e177ac3e8d3c1d42">◆ </a></span>TEST_CASE() <span class="overload">[16/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"applyPhaseFuncOverrides" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[operators] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__operator.html#gaf5344129240243ad11d0c081eb9036ab" title="Induces a phase change upon each amplitude of qureg, determined by the passed exponential polynomial ...">applyPhaseFuncOverrides</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__operators_8cpp_source.html#l03001">3001</a> of file <a class="el" href="test__operators_8cpp_source.html">test_operators.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l03001"></a><span class="lineno"> 3001</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><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l00743">applyPhaseFuncOverrides()</a>, <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__operators_8cpp_source.html#l00019">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00417">expI()</a>, <a class="el" href="utilities_8cpp_source.html#l00526">getRandomInt()</a>, <a class="el" href="utilities_8cpp_source.html#l00421">getRandomReal()</a>, <a class="el" href="utilities_8cpp_source.html#l01286">getTwosComplement()</a>, <a class="el" href="utilities_8cpp_source.html#l00153">getZeroMatrix()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__operators_8cpp_source.html#l00010">PREPARE_TEST</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, <a class="el" href="utilities_8cpp_source.html#l01488">sublists()</a>, <a class="el" href="QuEST_8h_source.html#l00269">TWOS_COMPLEMENT</a>, and <a class="el" href="QuEST_8h_source.html#l00269">UNSIGNED</a>.</p>
</div>
</div>
<a id="gaa72a7f3d6425f04b1e3a8ebb4487ba5e"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaa72a7f3d6425f04b1e3a8ebb4487ba5e">◆ </a></span>TEST_CASE() <span class="overload">[17/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"applyProjector" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[operators] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__operator.html#ga26db8b8a8a242d388c291e50d228ab18" title="Force the target qubit of qureg into the given classical outcome, via a non-renormalising projection.">applyProjector</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__operators_8cpp_source.html#l03214">3214</a> of file <a class="el" href="test__operators_8cpp_source.html">test_operators.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l03214"></a><span class="lineno"> 3214</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><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l00888">applyProjector()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00507">getPureDensityMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00490">getRandomDensityMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00379">getRandomQMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00435">getRandomQVector()</a>, <a class="el" href="utilities_8cpp_source.html#l00468">getRandomStateVector()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, and <a class="el" href="utilities_8cpp_source.html#l01201">toQureg()</a>.</p>
</div>
</div>
<a id="ga5731cef400dd2ad09f62ce3b4213fa49"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga5731cef400dd2ad09f62ce3b4213fa49">◆ </a></span>TEST_CASE() <span class="overload">[18/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"applyQFT" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[operators] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__operator.html#ga9bc8c4ab44f8233b5766208a0b1c0776" title="Applies the quantum Fourier transform (QFT) to a specific subset of qubits of the register qureg.">applyQFT</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__operators_8cpp_source.html#l03349">3349</a> of file <a class="el" href="test__operators_8cpp_source.html">test_operators.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l03349"></a><span class="lineno"> 3349</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><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l00866">applyQFT()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__operators_8cpp_source.html#l00019">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00652">getDFT()</a>, <a class="el" href="utilities_8cpp_source.html#l00640">getMixedDensityMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00507">getPureDensityMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00431">getRandomComplex()</a>, <a class="el" href="utilities_8cpp_source.html#l00613">getRandomOrthonormalVectors()</a>, <a class="el" href="utilities_8cpp_source.html#l00472">getRandomProbabilities()</a>, <a class="el" href="utilities_8cpp_source.html#l00435">getRandomQVector()</a>, <a class="el" href="utilities_8cpp_source.html#l00468">getRandomStateVector()</a>, <a class="el" href="utilities_8cpp_source.html#l00153">getZeroMatrix()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__operators_8cpp_source.html#l00010">PREPARE_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l01488">sublists()</a>, and <a class="el" href="utilities_8cpp_source.html#l01201">toQureg()</a>.</p>
</div>
</div>
<a id="ga5510ce8d43eb02e094b284a60bc5b47c"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga5510ce8d43eb02e094b284a60bc5b47c">◆ </a></span>TEST_CASE() <span class="overload">[19/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"applyTrotterCircuit" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[operators] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__operator.html#ga35b6321c578a8c69470132b5ee95f930" title="Applies a trotterisation of unitary evolution to qureg.">applyTrotterCircuit</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__operators_8cpp_source.html#l03500">3500</a> of file <a class="el" href="test__operators_8cpp_source.html">test_operators.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l03500"></a><span class="lineno"> 3500</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><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l01070">applyTrotterCircuit()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l01191">calcFidelity()</a>, <a class="el" href="QuEST_8c_source.html#l00064">createCloneQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l01398">createPauliHamil()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l01414">destroyPauliHamil()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00421">getRandomReal()</a>, <a class="el" href="QuEST_8c_source.html#l01578">initDebugState()</a>, <a class="el" href="QuEST_8c_source.html#l01504">initPauliHamil()</a>, <a class="el" href="QuEST__common_8c_source.html#l00041">M_PI</a>, <a class="el" href="QuEST_8c_source.html#l00685">multiRotatePauli()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="QuEST_8h_source.html#l00285">PauliHamil::numSumTerms</a>, <a class="el" href="QuEST_8h_source.html#l00096">PAULI_I</a>, <a class="el" href="QuEST_8h_source.html#l00096">PAULI_X</a>, <a class="el" href="QuEST_8h_source.html#l00096">PAULI_Y</a>, <a class="el" href="QuEST_8h_source.html#l00096">PAULI_Z</a>, <a class="el" href="QuEST_8h_source.html#l00281">PauliHamil::pauliCodes</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, and <a class="el" href="QuEST_8h_source.html#l00283">PauliHamil::termCoeffs</a>.</p>
</div>
</div>
<a id="ga4f3c9ca42b9b7cd322f1b89ba2350a81"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga4f3c9ca42b9b7cd322f1b89ba2350a81">◆ </a></span>TEST_CASE() <span class="overload">[20/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"calcDensityInnerProduct" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[calculations] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__calc.html#ga658b3a5cab5e73a17a7fd76a83583a22" title="Computes the Hilbert-Schmidt scalar product (which is equivalent to the Frobenius inner product of ma...">calcDensityInnerProduct</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__calculations_8cpp_source.html#l00021">21</a> of file <a class="el" href="test__calculations_8cpp_source.html">test_calculations.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00021"></a><span class="lineno"> 21</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>  <a class="code" href="structQureg.html">Qureg</a> mat1 = <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="l00024"></a><span class="lineno"> 24</span>  <a class="code" href="structQureg.html">Qureg</a> mat2 = <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="l00025"></a><span class="lineno"> 25</span>  </div>
<div class="line"><a name="l00026"></a><span class="lineno"> 26</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00027"></a><span class="lineno"> 27</span>  </div>
<div class="line"><a name="l00028"></a><span class="lineno"> 28</span>  <span class="comment">// repeat these random tests 10 times </span></div>
<div class="line"><a name="l00029"></a><span class="lineno"> 29</span>  GENERATE( range(0,10) );</div>
<div class="line"><a name="l00030"></a><span class="lineno"> 30</span>  </div>
<div class="line"><a name="l00031"></a><span class="lineno"> 31</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00032"></a><span class="lineno"> 32</span>  </div>
<div class="line"><a name="l00033"></a><span class="lineno"> 33</span>  SECTION( <span class="stringliteral">"pure"</span> ) {</div>
<div class="line"><a name="l00034"></a><span class="lineno"> 34</span>  </div>
<div class="line"><a name="l00035"></a><span class="lineno"> 35</span>  <span class="comment">// mat1 = |r1><r1|</span></div>
<div class="line"><a name="l00036"></a><span class="lineno"> 36</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> r1 = <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="l00037"></a><span class="lineno"> 37</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat1, <a class="code" href="group__testutilities.html#ga2de7d3b138728b6beb7753b82df61803">getKetBra</a>(r1,r1));</div>
<div class="line"><a name="l00038"></a><span class="lineno"> 38</span>  </div>
<div class="line"><a name="l00039"></a><span class="lineno"> 39</span>  <span class="comment">// mat2 = |r2><r2|</span></div>
<div class="line"><a name="l00040"></a><span class="lineno"> 40</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> r2 = <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="l00041"></a><span class="lineno"> 41</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat2, <a class="code" href="group__testutilities.html#ga2de7d3b138728b6beb7753b82df61803">getKetBra</a>(r2,r2));</div>
<div class="line"><a name="l00042"></a><span class="lineno"> 42</span>  </div>
<div class="line"><a name="l00043"></a><span class="lineno"> 43</span>  <span class="comment">// prod( |r1><r1|, |r2><r2| ) = |<r1|r2>|^2 </span></div>
<div class="line"><a name="l00044"></a><span class="lineno"> 44</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> prod = 0;</div>
<div class="line"><a name="l00045"></a><span class="lineno"> 45</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<r1.size(); i++)</div>
<div class="line"><a name="l00046"></a><span class="lineno"> 46</span>  prod += conj(r1[i]) * r2[i];</div>
<div class="line"><a name="l00047"></a><span class="lineno"> 47</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> densProd = pow(abs(prod),2);</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>  REQUIRE( <a class="code" href="group__calc.html#ga658b3a5cab5e73a17a7fd76a83583a22">calcDensityInnerProduct</a>(mat1,mat2) == Approx(densProd) );</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>  SECTION( <span class="stringliteral">"mixed"</span> ) {</div>
<div class="line"><a name="l00052"></a><span class="lineno"> 52</span>  </div>
<div class="line"><a name="l00053"></a><span class="lineno"> 53</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> ref1 = <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="l00054"></a><span class="lineno"> 54</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> ref2 = <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="l00055"></a><span class="lineno"> 55</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat1, ref1);</div>
<div class="line"><a name="l00056"></a><span class="lineno"> 56</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat2, ref2);</div>
<div class="line"><a name="l00057"></a><span class="lineno"> 57</span>  </div>
<div class="line"><a name="l00058"></a><span class="lineno"> 58</span>  <span class="comment">// prod(mat1, mat2) = sum_{ij} conj(mat1_{ij}) * mat2_{ij}</span></div>
<div class="line"><a name="l00059"></a><span class="lineno"> 59</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> refProd = 0;</div>
<div class="line"><a name="l00060"></a><span class="lineno"> 60</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<ref1.size(); i++)</div>
<div class="line"><a name="l00061"></a><span class="lineno"> 61</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> j=0; j<ref1.size(); j++)</div>
<div class="line"><a name="l00062"></a><span class="lineno"> 62</span>  refProd += conj(ref1[i][j]) * ref2[i][j];</div>
<div class="line"><a name="l00063"></a><span class="lineno"> 63</span>  REQUIRE( imag(refProd) == Approx(0).margin(REAL_EPS) );</div>
<div class="line"><a name="l00064"></a><span class="lineno"> 64</span>  </div>
<div class="line"><a name="l00065"></a><span class="lineno"> 65</span>  REQUIRE( <a class="code" href="group__calc.html#ga658b3a5cab5e73a17a7fd76a83583a22">calcDensityInnerProduct</a>(mat1,mat2) == Approx(real(refProd)) );</div>
<div class="line"><a name="l00066"></a><span class="lineno"> 66</span>  </div>
<div class="line"><a name="l00067"></a><span class="lineno"> 67</span>  <span class="comment">// should be invariant under ordering</span></div>
<div class="line"><a name="l00068"></a><span class="lineno"> 68</span>  REQUIRE( <a class="code" href="group__calc.html#ga658b3a5cab5e73a17a7fd76a83583a22">calcDensityInnerProduct</a>(mat1,mat2) == Approx(<a class="code" href="group__calc.html#ga658b3a5cab5e73a17a7fd76a83583a22">calcDensityInnerProduct</a>(mat2,mat1)) );</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>  SECTION( <span class="stringliteral">"unnormalised"</span> ) {</div>
<div class="line"><a name="l00071"></a><span class="lineno"> 71</span>  </div>
<div class="line"><a name="l00072"></a><span class="lineno"> 72</span>  <span class="comment">// set both to random (non-Hermitian) complex matrices</span></div>
<div class="line"><a name="l00073"></a><span class="lineno"> 73</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> ref1 = <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="l00074"></a><span class="lineno"> 74</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> ref2 = <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="l00075"></a><span class="lineno"> 75</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat1, ref1);</div>
<div class="line"><a name="l00076"></a><span class="lineno"> 76</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat2, ref2);</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>  <span class="comment">// prod(mat1, mat2) = real(sum_{ij} conj(mat1_{ij}) * mat2_{ij})</span></div>
<div class="line"><a name="l00079"></a><span class="lineno"> 79</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> refProd = 0;</div>
<div class="line"><a name="l00080"></a><span class="lineno"> 80</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<ref1.size(); i++)</div>
<div class="line"><a name="l00081"></a><span class="lineno"> 81</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> j=0; j<ref1.size(); j++)</div>
<div class="line"><a name="l00082"></a><span class="lineno"> 82</span>  refProd += conj(ref1[i][j]) * ref2[i][j];</div>
<div class="line"><a name="l00083"></a><span class="lineno"> 83</span>  </div>
<div class="line"><a name="l00084"></a><span class="lineno"> 84</span>  REQUIRE( <a class="code" href="group__calc.html#ga658b3a5cab5e73a17a7fd76a83583a22">calcDensityInnerProduct</a>(mat1,mat2) == Approx(real(refProd)) );</div>
<div class="line"><a name="l00085"></a><span class="lineno"> 85</span>  }</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>  }</div>
<div class="line"><a name="l00088"></a><span class="lineno"> 88</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00089"></a><span class="lineno"> 89</span>  </div>
<div class="line"><a name="l00090"></a><span class="lineno"> 90</span>  SECTION( <span class="stringliteral">"dimensions"</span> ) {</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>  <a class="code" href="structQureg.html">Qureg</a> mat3 = <a class="code" href="group__type.html#ga93e55b6650b408abb30a1d4a8bce757c">createDensityQureg</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="l00093"></a><span class="lineno"> 93</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga658b3a5cab5e73a17a7fd76a83583a22">calcDensityInnerProduct</a>(mat1,mat3), Contains(<span class="stringliteral">"Dimensions"</span>) && Contains(<span class="stringliteral">"don't match"</span>) );</div>
<div class="line"><a name="l00094"></a><span class="lineno"> 94</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(mat3, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</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>  SECTION( <span class="stringliteral">"state-vectors"</span> ) {</div>
<div class="line"><a name="l00097"></a><span class="lineno"> 97</span>  </div>
<div class="line"><a name="l00098"></a><span class="lineno"> 98</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="l00099"></a><span class="lineno"> 99</span>  </div>
<div class="line"><a name="l00100"></a><span class="lineno"> 100</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga658b3a5cab5e73a17a7fd76a83583a22">calcDensityInnerProduct</a>(mat1,vec), Contains(<span class="stringliteral">"valid only for density matrices"</span>) );</div>
<div class="line"><a name="l00101"></a><span class="lineno"> 101</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga658b3a5cab5e73a17a7fd76a83583a22">calcDensityInnerProduct</a>(vec,mat1), Contains(<span class="stringliteral">"valid only for density matrices"</span>) );</div>
<div class="line"><a name="l00102"></a><span class="lineno"> 102</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga658b3a5cab5e73a17a7fd76a83583a22">calcDensityInnerProduct</a>(vec,vec), Contains(<span class="stringliteral">"valid only for density matrices"</span>) ); </div>
<div class="line"><a name="l00103"></a><span class="lineno"> 103</span>  </div>
<div class="line"><a name="l00104"></a><span class="lineno"> 104</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="l00105"></a><span class="lineno"> 105</span>  }</div>
<div class="line"><a name="l00106"></a><span class="lineno"> 106</span>  }</div>
<div class="line"><a name="l00107"></a><span class="lineno"> 107</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(mat1, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00108"></a><span class="lineno"> 108</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(mat2, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00109"></a><span class="lineno"> 109</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l01158">calcDensityInnerProduct()</a>, <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00169">getKetBra()</a>, <a class="el" href="utilities_8cpp_source.html#l00490">getRandomDensityMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00379">getRandomQMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00468">getRandomStateVector()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, and <a class="el" href="utilities_8cpp_source.html#l01201">toQureg()</a>.</p>
</div>
</div>
<a id="ga73a058eb67be1476ac4e37be653d64c3"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga73a058eb67be1476ac4e37be653d64c3">◆ </a></span>TEST_CASE() <span class="overload">[21/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"calcExpecDiagonalOp" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[calculations] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__calc.html#ga82f17e96a4cb7612fb9c6ef856df3810" title="Computes the expected value of the diagonal operator op for state qureg.">calcExpecDiagonalOp</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__calculations_8cpp_source.html#l00117">117</a> of file <a class="el" href="test__calculations_8cpp_source.html">test_calculations.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00117"></a><span class="lineno"> 117</span>  {</div>
<div class="line"><a name="l00118"></a><span class="lineno"> 118</span>  </div>
<div class="line"><a name="l00119"></a><span class="lineno"> 119</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="l00120"></a><span class="lineno"> 120</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="l00121"></a><span class="lineno"> 121</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(vec);</div>
<div class="line"><a name="l00122"></a><span class="lineno"> 122</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(mat);</div>
<div class="line"><a name="l00123"></a><span class="lineno"> 123</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> vecRef = <a class="code" href="group__testutilities.html#gade0e7c37811a69f1c21c88c11943a19f">toQVector</a>(vec);</div>
<div class="line"><a name="l00124"></a><span class="lineno"> 124</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> matRef = <a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(mat);</div>
<div class="line"><a name="l00125"></a><span class="lineno"> 125</span>  </div>
<div class="line"><a name="l00126"></a><span class="lineno"> 126</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00127"></a><span class="lineno"> 127</span>  </div>
<div class="line"><a name="l00128"></a><span class="lineno"> 128</span>  <span class="comment">// try 10 random operators </span></div>
<div class="line"><a name="l00129"></a><span class="lineno"> 129</span>  GENERATE( range(0,10) );</div>
<div class="line"><a name="l00130"></a><span class="lineno"> 130</span>  </div>
<div class="line"><a name="l00131"></a><span class="lineno"> 131</span>  <span class="comment">// make a totally random (non-Hermitian) diagonal oeprator</span></div>
<div class="line"><a name="l00132"></a><span class="lineno"> 132</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="l00133"></a><span class="lineno"> 133</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="l00134"></a><span class="lineno"> 134</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="l00135"></a><span class="lineno"> 135</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="l00136"></a><span class="lineno"> 136</span>  }</div>
<div class="line"><a name="l00137"></a><span class="lineno"> 137</span>  <a class="code" href="group__type.html#gab75d5cdc622d2778bad24e3a8130aab9">syncDiagonalOp</a>(op);</div>
<div class="line"><a name="l00138"></a><span class="lineno"> 138</span>  </div>
<div class="line"><a name="l00139"></a><span class="lineno"> 139</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00140"></a><span class="lineno"> 140</span>  </div>
<div class="line"><a name="l00141"></a><span class="lineno"> 141</span>  <span class="comment">/* calcExpecDiagOp calculates <qureg|diag|qureg> */</span></div>
<div class="line"><a name="l00142"></a><span class="lineno"> 142</span>  </div>
<div class="line"><a name="l00143"></a><span class="lineno"> 143</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> sumRef = <a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(op) * vecRef;</div>
<div class="line"><a name="l00144"></a><span class="lineno"> 144</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> prod = 0;</div>
<div class="line"><a name="l00145"></a><span class="lineno"> 145</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<vecRef.size(); i++)</div>
<div class="line"><a name="l00146"></a><span class="lineno"> 146</span>  prod += conj(vecRef[i]) * sumRef[i];</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>  <a class="code" href="structComplex.html">Complex</a> res = <a class="code" href="group__calc.html#ga82f17e96a4cb7612fb9c6ef856df3810">calcExpecDiagonalOp</a>(vec, op);</div>
<div class="line"><a name="l00149"></a><span class="lineno"> 149</span>  REQUIRE( res.<a class="code" href="structComplex.html#ab5b2e2eca02131fc74b289a83636cbe3">real</a> == Approx(real(prod)).margin(REAL_EPS) );</div>
<div class="line"><a name="l00150"></a><span class="lineno"> 150</span>  REQUIRE( res.<a class="code" href="structComplex.html#a84f5439aad0ef495efdd3b4c1c02d27e">imag</a> == Approx(imag(prod)).margin(REAL_EPS) );</div>
<div class="line"><a name="l00151"></a><span class="lineno"> 151</span>  } </div>
<div class="line"><a name="l00152"></a><span class="lineno"> 152</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00153"></a><span class="lineno"> 153</span>  </div>
<div class="line"><a name="l00154"></a><span class="lineno"> 154</span>  <span class="comment">/* calcExpecDiagOp calculates Trace( diag * qureg ) */</span></div>
<div class="line"><a name="l00155"></a><span class="lineno"> 155</span>  matRef = <a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(op) * matRef; </div>
<div class="line"><a name="l00156"></a><span class="lineno"> 156</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> tr = 0;</div>
<div class="line"><a name="l00157"></a><span class="lineno"> 157</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<matRef.size(); i++)</div>
<div class="line"><a name="l00158"></a><span class="lineno"> 158</span>  tr += matRef[i][i];</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>  <a class="code" href="structComplex.html">Complex</a> res = <a class="code" href="group__calc.html#ga82f17e96a4cb7612fb9c6ef856df3810">calcExpecDiagonalOp</a>(mat, op);</div>
<div class="line"><a name="l00161"></a><span class="lineno"> 161</span>  REQUIRE( res.<a class="code" href="structComplex.html#ab5b2e2eca02131fc74b289a83636cbe3">real</a> == Approx(real(tr)).margin(100*REAL_EPS) );</div>
<div class="line"><a name="l00162"></a><span class="lineno"> 162</span>  REQUIRE( res.<a class="code" href="structComplex.html#a84f5439aad0ef495efdd3b4c1c02d27e">imag</a> == Approx(imag(tr)).margin(100*REAL_EPS) );</div>
<div class="line"><a name="l00163"></a><span class="lineno"> 163</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>  <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="l00166"></a><span class="lineno"> 166</span>  }</div>
<div class="line"><a name="l00167"></a><span class="lineno"> 167</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00168"></a><span class="lineno"> 168</span>  </div>
<div class="line"><a name="l00169"></a><span class="lineno"> 169</span>  SECTION( <span class="stringliteral">"mismatching size"</span> ) {</div>
<div class="line"><a name="l00170"></a><span class="lineno"> 170</span>  </div>
<div class="line"><a name="l00171"></a><span class="lineno"> 171</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="l00172"></a><span class="lineno"> 172</span>  </div>
<div class="line"><a name="l00173"></a><span class="lineno"> 173</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga82f17e96a4cb7612fb9c6ef856df3810">calcExpecDiagonalOp</a>(vec, op), Contains(<span class="stringliteral">"equal number of qubits"</span>));</div>
<div class="line"><a name="l00174"></a><span class="lineno"> 174</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga82f17e96a4cb7612fb9c6ef856df3810">calcExpecDiagonalOp</a>(mat, op), Contains(<span class="stringliteral">"equal number of qubits"</span>));</div>
<div class="line"><a name="l00175"></a><span class="lineno"> 175</span>  </div>
<div class="line"><a name="l00176"></a><span class="lineno"> 176</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="l00177"></a><span class="lineno"> 177</span>  }</div>
<div class="line"><a name="l00178"></a><span class="lineno"> 178</span>  }</div>
<div class="line"><a name="l00179"></a><span class="lineno"> 179</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="l00180"></a><span class="lineno"> 180</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="l00181"></a><span class="lineno"> 181</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l01228">calcExpecDiagonalOp()</a>, <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l01518">createDiagonalOp()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l01524">destroyDiagonalOp()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00421">getRandomReal()</a>, <a class="el" href="QuEST_8h_source.html#l00106">Complex::imag</a>, <a class="el" href="QuEST_8h_source.html#l00310">DiagonalOp::imag</a>, <a class="el" href="QuEST_8c_source.html#l01578">initDebugState()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="QuEST_8h_source.html#l00302">DiagonalOp::numElemsPerChunk</a>, <a class="el" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, <a class="el" href="QuEST_8h_source.html#l00105">Complex::real</a>, <a class="el" href="QuEST_8h_source.html#l00308">DiagonalOp::real</a>, <a class="el" href="QuEST_8c_source.html#l01531">syncDiagonalOp()</a>, <a class="el" href="utilities_8cpp_source.html#l01044">toQMatrix()</a>, and <a class="el" href="utilities_8cpp_source.html#l01113">toQVector()</a>.</p>
</div>
</div>
<a id="ga3eb91320e5854d964b125bb659b83d41"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga3eb91320e5854d964b125bb659b83d41">◆ </a></span>TEST_CASE() <span class="overload">[22/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"calcExpecPauliHamil" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[calculations] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__calc.html#ga5544d2833a69941b8820797b79daf79f" title="Computes the expected value of qureg under Hermitian operator hamil.">calcExpecPauliHamil</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__calculations_8cpp_source.html#l00189">189</a> of file <a class="el" href="test__calculations_8cpp_source.html">test_calculations.cpp</a>.</p>
<div class="fragment"><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>  </div>
<div class="line"><a name="l00191"></a><span class="lineno"> 191</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="l00192"></a><span class="lineno"> 192</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="l00193"></a><span class="lineno"> 193</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(vec);</div>
<div class="line"><a name="l00194"></a><span class="lineno"> 194</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(mat);</div>
<div class="line"><a name="l00195"></a><span class="lineno"> 195</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> vecRef = <a class="code" href="group__testutilities.html#gade0e7c37811a69f1c21c88c11943a19f">toQVector</a>(vec);</div>
<div class="line"><a name="l00196"></a><span class="lineno"> 196</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> matRef = <a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(mat);</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>  <a class="code" href="structQureg.html">Qureg</a> vecWork = <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="l00199"></a><span class="lineno"> 199</span>  <a class="code" href="structQureg.html">Qureg</a> matWork = <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="l00200"></a><span class="lineno"> 200</span>  </div>
<div class="line"><a name="l00201"></a><span class="lineno"> 201</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00202"></a><span class="lineno"> 202</span>  </div>
<div class="line"><a name="l00203"></a><span class="lineno"> 203</span>  <span class="comment">/* it's too expensive to try every possible Pauli configuration, so</span></div>
<div class="line"><a name="l00204"></a><span class="lineno"> 204</span> <span class="comment"> * we'll try 10 random codes, and for each, random coefficients</span></div>
<div class="line"><a name="l00205"></a><span class="lineno"> 205</span> <span class="comment"> */</span></div>
<div class="line"><a name="l00206"></a><span class="lineno"> 206</span>  GENERATE( range(0,10) );</div>
<div class="line"><a name="l00207"></a><span class="lineno"> 207</span>  </div>
<div class="line"><a name="l00208"></a><span class="lineno"> 208</span>  <span class="keywordtype">int</span> numTerms = GENERATE( 1, 2, 10, 15 );</div>
<div class="line"><a name="l00209"></a><span class="lineno"> 209</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="l00210"></a><span class="lineno"> 210</span>  <a class="code" href="group__testutilities.html#ga11c465ce1a5c238946a9e09d61c94c58">setRandomPauliSum</a>(hamil);</div>
<div class="line"><a name="l00211"></a><span class="lineno"> 211</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="l00212"></a><span class="lineno"> 212</span>  </div>
<div class="line"><a name="l00213"></a><span class="lineno"> 213</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</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">/* calcExpecPauliHamil calculates <qureg|pauliHum|qureg> */</span></div>
<div class="line"><a name="l00216"></a><span class="lineno"> 216</span>  </div>
<div class="line"><a name="l00217"></a><span class="lineno"> 217</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> sumRef = refHamil * vecRef;</div>
<div class="line"><a name="l00218"></a><span class="lineno"> 218</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> prod = 0;</div>
<div class="line"><a name="l00219"></a><span class="lineno"> 219</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<vecRef.size(); i++)</div>
<div class="line"><a name="l00220"></a><span class="lineno"> 220</span>  prod += conj(vecRef[i]) * sumRef[i];</div>
<div class="line"><a name="l00221"></a><span class="lineno"> 221</span>  REQUIRE( imag(prod) == Approx(0).margin(10*REAL_EPS) );</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__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> res = <a class="code" href="group__calc.html#ga5544d2833a69941b8820797b79daf79f">calcExpecPauliHamil</a>(vec, hamil, vecWork);</div>
<div class="line"><a name="l00224"></a><span class="lineno"> 224</span>  REQUIRE( res == Approx(real(prod)).margin(10*REAL_EPS) );</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>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</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>  <span class="comment">/* calcExpecPauliHamil calculates Trace( pauliHamil * qureg ) */</span></div>
<div class="line"><a name="l00229"></a><span class="lineno"> 229</span>  matRef = refHamil * matRef; </div>
<div class="line"><a name="l00230"></a><span class="lineno"> 230</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> tr = 0;</div>
<div class="line"><a name="l00231"></a><span class="lineno"> 231</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<matRef.size(); i++)</div>
<div class="line"><a name="l00232"></a><span class="lineno"> 232</span>  tr += real(matRef[i][i]);</div>
<div class="line"><a name="l00233"></a><span class="lineno"> 233</span>  <span class="comment">// (get real, since we start in a non-Hermitian state, hence diagonal isn't real)</span></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>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> res = <a class="code" href="group__calc.html#ga5544d2833a69941b8820797b79daf79f">calcExpecPauliHamil</a>(mat, hamil, matWork);</div>
<div class="line"><a name="l00236"></a><span class="lineno"> 236</span>  REQUIRE( res == Approx(tr).margin(1E2*REAL_EPS) );</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>  </div>
<div class="line"><a name="l00239"></a><span class="lineno"> 239</span>  <a class="code" href="group__type.html#gac1c8ed909b33bd55ae680901006051b6">destroyPauliHamil</a>(hamil);</div>
<div class="line"><a name="l00240"></a><span class="lineno"> 240</span>  }</div>
<div class="line"><a name="l00241"></a><span class="lineno"> 241</span>  SECTION( <span class="stringliteral">"input validation"</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>  SECTION( <span class="stringliteral">"pauli codes"</span> ) {</div>
<div class="line"><a name="l00244"></a><span class="lineno"> 244</span>  </div>
<div class="line"><a name="l00245"></a><span class="lineno"> 245</span>  <span class="keywordtype">int</span> numTerms = 3;</div>
<div class="line"><a name="l00246"></a><span class="lineno"> 246</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="l00247"></a><span class="lineno"> 247</span>  </div>
<div class="line"><a name="l00248"></a><span class="lineno"> 248</span>  <span class="comment">// make one pauli code wrong</span></div>
<div class="line"><a name="l00249"></a><span class="lineno"> 249</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="l00250"></a><span class="lineno"> 250</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga5544d2833a69941b8820797b79daf79f">calcExpecPauliHamil</a>(vec, hamil, vecWork), Contains(<span class="stringliteral">"Invalid Pauli code"</span>) );</div>
<div class="line"><a name="l00251"></a><span class="lineno"> 251</span>  </div>
<div class="line"><a name="l00252"></a><span class="lineno"> 252</span>  <a class="code" href="group__type.html#gac1c8ed909b33bd55ae680901006051b6">destroyPauliHamil</a>(hamil);</div>
<div class="line"><a name="l00253"></a><span class="lineno"> 253</span>  }</div>
<div class="line"><a name="l00254"></a><span class="lineno"> 254</span>  SECTION( <span class="stringliteral">"workspace type"</span> ) {</div>
<div class="line"><a name="l00255"></a><span class="lineno"> 255</span>  </div>
<div class="line"><a name="l00256"></a><span class="lineno"> 256</span>  <span class="keywordtype">int</span> numTerms = 1;</div>
<div class="line"><a name="l00257"></a><span class="lineno"> 257</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="l00258"></a><span class="lineno"> 258</span>  </div>
<div class="line"><a name="l00259"></a><span class="lineno"> 259</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga5544d2833a69941b8820797b79daf79f">calcExpecPauliHamil</a>(vec, hamil, mat), Contains(<span class="stringliteral">"Registers must both be state-vectors or both be density matrices"</span>) );</div>
<div class="line"><a name="l00260"></a><span class="lineno"> 260</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga5544d2833a69941b8820797b79daf79f">calcExpecPauliHamil</a>(mat, hamil, vec), Contains(<span class="stringliteral">"Registers must both be state-vectors or both be density matrices"</span>) );</div>
<div class="line"><a name="l00261"></a><span class="lineno"> 261</span>  </div>
<div class="line"><a name="l00262"></a><span class="lineno"> 262</span>  <a class="code" href="group__type.html#gac1c8ed909b33bd55ae680901006051b6">destroyPauliHamil</a>(hamil);</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">"workspace dimensions"</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> numTerms = 1;</div>
<div class="line"><a name="l00267"></a><span class="lineno"> 267</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="l00268"></a><span class="lineno"> 268</span>  </div>
<div class="line"><a name="l00269"></a><span class="lineno"> 269</span>  <a class="code" href="structQureg.html">Qureg</a> vec2 = <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="l00270"></a><span class="lineno"> 270</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga5544d2833a69941b8820797b79daf79f">calcExpecPauliHamil</a>(vec, hamil, vec2), Contains(<span class="stringliteral">"Dimensions"</span>) && Contains(<span class="stringliteral">"don't match"</span>) );</div>
<div class="line"><a name="l00271"></a><span class="lineno"> 271</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(vec2, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00272"></a><span class="lineno"> 272</span>  </div>
<div class="line"><a name="l00273"></a><span class="lineno"> 273</span>  <a class="code" href="structQureg.html">Qureg</a> mat2 = <a class="code" href="group__type.html#ga93e55b6650b408abb30a1d4a8bce757c">createDensityQureg</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="l00274"></a><span class="lineno"> 274</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga5544d2833a69941b8820797b79daf79f">calcExpecPauliHamil</a>(mat, hamil, mat2), Contains(<span class="stringliteral">"Dimensions"</span>) && Contains(<span class="stringliteral">"don't match"</span>) );</div>
<div class="line"><a name="l00275"></a><span class="lineno"> 275</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(mat2, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</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__type.html#gac1c8ed909b33bd55ae680901006051b6">destroyPauliHamil</a>(hamil);</div>
<div class="line"><a name="l00278"></a><span class="lineno"> 278</span>  }</div>
<div class="line"><a name="l00279"></a><span class="lineno"> 279</span>  SECTION( <span class="stringliteral">"matching hamiltonian qubits"</span> ) {</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>  <span class="keywordtype">int</span> numTerms = 1;</div>
<div class="line"><a name="l00282"></a><span class="lineno"> 282</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, numTerms);</div>
<div class="line"><a name="l00283"></a><span class="lineno"> 283</span>  </div>
<div class="line"><a name="l00284"></a><span class="lineno"> 284</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga5544d2833a69941b8820797b79daf79f">calcExpecPauliHamil</a>(vec, hamil, vecWork), Contains(<span class="stringliteral">"same number of qubits"</span>) );</div>
<div class="line"><a name="l00285"></a><span class="lineno"> 285</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga5544d2833a69941b8820797b79daf79f">calcExpecPauliHamil</a>(mat, hamil, matWork), Contains(<span class="stringliteral">"same number of qubits"</span>) );</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>  <a class="code" href="group__type.html#gac1c8ed909b33bd55ae680901006051b6">destroyPauliHamil</a>(hamil);</div>
<div class="line"><a name="l00288"></a><span class="lineno"> 288</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>  <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="l00291"></a><span class="lineno"> 291</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="l00292"></a><span class="lineno"> 292</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(vecWork, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00293"></a><span class="lineno"> 293</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(matWork, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00294"></a><span class="lineno"> 294</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l01219">calcExpecPauliHamil()</a>, <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l01398">createPauliHamil()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l01414">destroyPauliHamil()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="QuEST_8c_source.html#l01578">initDebugState()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="QuEST_8h_source.html#l00281">PauliHamil::pauliCodes</a>, <a class="el" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, <a class="el" href="utilities_8cpp_source.html#l01229">setRandomPauliSum()</a>, <a class="el" href="utilities_8cpp_source.html#l01044">toQMatrix()</a>, and <a class="el" href="utilities_8cpp_source.html#l01113">toQVector()</a>.</p>
</div>
</div>
<a id="ga8825124816954c15598897e157f6e048"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga8825124816954c15598897e157f6e048">◆ </a></span>TEST_CASE() <span class="overload">[23/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"calcExpecPauliProd" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[calculations] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__calc.html#ga15cfad3f3d26339128e3be32ae7deacd" title="Computes the expected value of a product of Pauli operators.">calcExpecPauliProd</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__calculations_8cpp_source.html#l00302">302</a> of file <a class="el" href="test__calculations_8cpp_source.html">test_calculations.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00302"></a><span class="lineno"> 302</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>  <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="l00305"></a><span class="lineno"> 305</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="l00306"></a><span class="lineno"> 306</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(vec);</div>
<div class="line"><a name="l00307"></a><span class="lineno"> 307</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(mat);</div>
<div class="line"><a name="l00308"></a><span class="lineno"> 308</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> vecRef = <a class="code" href="group__testutilities.html#gade0e7c37811a69f1c21c88c11943a19f">toQVector</a>(vec);</div>
<div class="line"><a name="l00309"></a><span class="lineno"> 309</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> matRef = <a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(mat);</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>  <a class="code" href="structQureg.html">Qureg</a> vecWork = <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="l00312"></a><span class="lineno"> 312</span>  <a class="code" href="structQureg.html">Qureg</a> matWork = <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="l00313"></a><span class="lineno"> 313</span>  </div>
<div class="line"><a name="l00314"></a><span class="lineno"> 314</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00315"></a><span class="lineno"> 315</span>  </div>
<div class="line"><a name="l00316"></a><span class="lineno"> 316</span>  <span class="keywordtype">int</span> numTargs = GENERATE( range(1,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1) );</div>
<div class="line"><a name="l00317"></a><span class="lineno"> 317</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="l00318"></a><span class="lineno"> 318</span>  </div>
<div class="line"><a name="l00319"></a><span class="lineno"> 319</span>  <span class="comment">/* it's too expensive to try ALL Pauli sequences, via </span></div>
<div class="line"><a name="l00320"></a><span class="lineno"> 320</span> <span class="comment"> * pauliOpType* paulis = GENERATE_COPY( pauliseqs(numTargs) );.</span></div>
<div class="line"><a name="l00321"></a><span class="lineno"> 321</span> <span class="comment"> * Furthermore, take(10, pauliseqs(numTargs)) will try the same pauli codes.</span></div>
<div class="line"><a name="l00322"></a><span class="lineno"> 322</span> <span class="comment"> * Hence, we instead opt to repeatedlyrandomly generate pauliseqs</span></div>
<div class="line"><a name="l00323"></a><span class="lineno"> 323</span> <span class="comment"> */</span></div>
<div class="line"><a name="l00324"></a><span class="lineno"> 324</span>  GENERATE( range(0,10) ); <span class="comment">// gen 10 random pauli-codes for every targs</span></div>
<div class="line"><a name="l00325"></a><span class="lineno"> 325</span>  <a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a> paulis[numTargs];</div>
<div class="line"><a name="l00326"></a><span class="lineno"> 326</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numTargs; i++)</div>
<div class="line"><a name="l00327"></a><span class="lineno"> 327</span>  paulis[i] = (<a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a>) <a class="code" href="group__testutilities.html#ga7125d0747a44db58115899727ac5f6be">getRandomInt</a>(0,4);</div>
<div class="line"><a name="l00328"></a><span class="lineno"> 328</span>  </div>
<div class="line"><a name="l00329"></a><span class="lineno"> 329</span>  <span class="comment">// produce a numTargs-big matrix 'pauliProd' by pauli-matrix tensoring</span></div>
<div class="line"><a name="l00330"></a><span class="lineno"> 330</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> iMatr{{1,0},{0,1}};</div>
<div class="line"><a name="l00331"></a><span class="lineno"> 331</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> xMatr{{0,1},{1,0}};</div>
<div class="line"><a name="l00332"></a><span class="lineno"> 332</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> yMatr{{0,-<a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>(0,1)},{<a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>(0,1),0}};</div>
<div class="line"><a name="l00333"></a><span class="lineno"> 333</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> zMatr{{1,0},{0,-1}};</div>
<div class="line"><a name="l00334"></a><span class="lineno"> 334</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> pauliProd{{1}};</div>
<div class="line"><a name="l00335"></a><span class="lineno"> 335</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numTargs; i++) {</div>
<div class="line"><a name="l00336"></a><span class="lineno"> 336</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> fac;</div>
<div class="line"><a name="l00337"></a><span class="lineno"> 337</span>  <span class="keywordflow">if</span> (paulis[i] == <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a63800f45b01ccc2608f754aee850bf4a">PAULI_I</a>) fac = iMatr;</div>
<div class="line"><a name="l00338"></a><span class="lineno"> 338</span>  <span class="keywordflow">if</span> (paulis[i] == <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a7abac7bb5b71e17382014c443244ad5c">PAULI_X</a>) fac = xMatr;</div>
<div class="line"><a name="l00339"></a><span class="lineno"> 339</span>  <span class="keywordflow">if</span> (paulis[i] == <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a2c64a9aaee27f6bcfef894d159e759bd">PAULI_Y</a>) fac = yMatr;</div>
<div class="line"><a name="l00340"></a><span class="lineno"> 340</span>  <span class="keywordflow">if</span> (paulis[i] == <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a085c85cff6ba79c52d8b1e61c42ddddf">PAULI_Z</a>) fac = zMatr;</div>
<div class="line"><a name="l00341"></a><span class="lineno"> 341</span>  pauliProd = <a class="code" href="group__testutilities.html#gab5ac6842ba67b8d38bd17385ab179b67">getKroneckerProduct</a>(fac, pauliProd);</div>
<div class="line"><a name="l00342"></a><span class="lineno"> 342</span>  }</div>
<div class="line"><a name="l00343"></a><span class="lineno"> 343</span>  </div>
<div class="line"><a name="l00344"></a><span class="lineno"> 344</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</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>  <span class="comment">/* calcExpecPauliProd calculates <qureg|pauliProd|qureg> */</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__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> prodRef = vecRef; </div>
<div class="line"><a name="l00349"></a><span class="lineno"> 349</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(prodRef, targs, numTargs, pauliProd);</div>
<div class="line"><a name="l00350"></a><span class="lineno"> 350</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> prod = 0;</div>
<div class="line"><a name="l00351"></a><span class="lineno"> 351</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<vecRef.size(); i++)</div>
<div class="line"><a name="l00352"></a><span class="lineno"> 352</span>  prod += conj(vecRef[i]) * prodRef[i];</div>
<div class="line"><a name="l00353"></a><span class="lineno"> 353</span>  REQUIRE( imag(prod) == Approx(0).margin(REAL_EPS) );</div>
<div class="line"><a name="l00354"></a><span class="lineno"> 354</span>  </div>
<div class="line"><a name="l00355"></a><span class="lineno"> 355</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> res = <a class="code" href="group__calc.html#ga15cfad3f3d26339128e3be32ae7deacd">calcExpecPauliProd</a>(vec, targs, paulis, numTargs, vecWork);</div>
<div class="line"><a name="l00356"></a><span class="lineno"> 356</span>  REQUIRE( res == Approx(real(prod)).margin(REAL_EPS) );</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>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00359"></a><span class="lineno"> 359</span>  </div>
<div class="line"><a name="l00360"></a><span class="lineno"> 360</span>  <span class="comment">/* calcExpecPauliProd calculates Trace( pauliProd * qureg ) */</span></div>
<div class="line"><a name="l00361"></a><span class="lineno"> 361</span>  </div>
<div class="line"><a name="l00362"></a><span class="lineno"> 362</span>  <span class="comment">// produce (pauliProd * mat)</span></div>
<div class="line"><a name="l00363"></a><span class="lineno"> 363</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> fullOp = <a class="code" href="group__testutilities.html#ga20f041452b43026d876fde17a5999265">getFullOperatorMatrix</a>(NULL, 0, targs, numTargs, pauliProd, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>);</div>
<div class="line"><a name="l00364"></a><span class="lineno"> 364</span>  matRef = fullOp * matRef;</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>  <span class="comment">// compute real(trace(pauliProd * mat))</span></div>
<div class="line"><a name="l00367"></a><span class="lineno"> 367</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> tr = 0;</div>
<div class="line"><a name="l00368"></a><span class="lineno"> 368</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<matRef.size(); i++)</div>
<div class="line"><a name="l00369"></a><span class="lineno"> 369</span>  tr += real(matRef[i][i]);</div>
<div class="line"><a name="l00370"></a><span class="lineno"> 370</span>  <span class="comment">// (get real, since we start in a non-Hermitian state, hence diagonal isn't real)</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>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> res = <a class="code" href="group__calc.html#ga15cfad3f3d26339128e3be32ae7deacd">calcExpecPauliProd</a>(mat, targs, paulis, numTargs, matWork);</div>
<div class="line"><a name="l00373"></a><span class="lineno"> 373</span>  REQUIRE( res == Approx(tr).margin(10*REAL_EPS) );</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>  }</div>
<div class="line"><a name="l00376"></a><span class="lineno"> 376</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00377"></a><span class="lineno"> 377</span>  </div>
<div class="line"><a name="l00378"></a><span class="lineno"> 378</span>  SECTION( <span class="stringliteral">"number of targets"</span> ) {</div>
<div class="line"><a name="l00379"></a><span class="lineno"> 379</span>  </div>
<div class="line"><a name="l00380"></a><span class="lineno"> 380</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="l00381"></a><span class="lineno"> 381</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga15cfad3f3d26339128e3be32ae7deacd">calcExpecPauliProd</a>(vec, NULL, NULL, numTargs, vecWork), Contains(<span class="stringliteral">"Invalid number of target"</span>) );</div>
<div class="line"><a name="l00382"></a><span class="lineno"> 382</span>  }</div>
<div class="line"><a name="l00383"></a><span class="lineno"> 383</span>  SECTION( <span class="stringliteral">"target indices"</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>  <span class="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l00386"></a><span class="lineno"> 386</span>  <span class="keywordtype">int</span> targs[3] = {0, 1, 2};</div>
<div class="line"><a name="l00387"></a><span class="lineno"> 387</span>  </div>
<div class="line"><a name="l00388"></a><span class="lineno"> 388</span>  <span class="comment">// make one index wrong</span></div>
<div class="line"><a name="l00389"></a><span class="lineno"> 389</span>  targs[GENERATE( range(0,3) )] = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l00390"></a><span class="lineno"> 390</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga15cfad3f3d26339128e3be32ae7deacd">calcExpecPauliProd</a>(vec, targs, NULL, numTargs, vecWork), Contains(<span class="stringliteral">"Invalid target qubit"</span>) );</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>  SECTION( <span class="stringliteral">"repetition in targets"</span> ) {</div>
<div class="line"><a name="l00393"></a><span class="lineno"> 393</span>  </div>
<div class="line"><a name="l00394"></a><span class="lineno"> 394</span>  <span class="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l00395"></a><span class="lineno"> 395</span>  <span class="keywordtype">int</span> targs[3] = {0, 1, 1};</div>
<div class="line"><a name="l00396"></a><span class="lineno"> 396</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga15cfad3f3d26339128e3be32ae7deacd">calcExpecPauliProd</a>(vec, targs, NULL, numTargs, vecWork), Contains(<span class="stringliteral">"target qubits must be unique"</span>) );</div>
<div class="line"><a name="l00397"></a><span class="lineno"> 397</span>  }</div>
<div class="line"><a name="l00398"></a><span class="lineno"> 398</span>  SECTION( <span class="stringliteral">"pauli codes"</span> ) {</div>
<div class="line"><a name="l00399"></a><span class="lineno"> 399</span>  </div>
<div class="line"><a name="l00400"></a><span class="lineno"> 400</span>  <span class="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l00401"></a><span class="lineno"> 401</span>  <span class="keywordtype">int</span> targs[3] = {0, 1, 2};</div>
<div class="line"><a name="l00402"></a><span class="lineno"> 402</span>  <a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a> codes[3] = {<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="l00403"></a><span class="lineno"> 403</span>  </div>
<div class="line"><a name="l00404"></a><span class="lineno"> 404</span>  <span class="comment">// make one pauli wrong</span></div>
<div class="line"><a name="l00405"></a><span class="lineno"> 405</span>  codes[GENERATE( range(0,3) )] = (<a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a>) GENERATE( -1, 4 );</div>
<div class="line"><a name="l00406"></a><span class="lineno"> 406</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga15cfad3f3d26339128e3be32ae7deacd">calcExpecPauliProd</a>(vec, targs, codes, numTargs, vecWork), Contains(<span class="stringliteral">"Invalid Pauli code"</span>) );</div>
<div class="line"><a name="l00407"></a><span class="lineno"> 407</span>  }</div>
<div class="line"><a name="l00408"></a><span class="lineno"> 408</span>  SECTION( <span class="stringliteral">"workspace type"</span> ) {</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>  <span class="keywordtype">int</span> numTargs = 1;</div>
<div class="line"><a name="l00411"></a><span class="lineno"> 411</span>  <span class="keywordtype">int</span> targs[1] = {0};</div>
<div class="line"><a name="l00412"></a><span class="lineno"> 412</span>  <a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a> codes[1] = {<a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a63800f45b01ccc2608f754aee850bf4a">PAULI_I</a>};</div>
<div class="line"><a name="l00413"></a><span class="lineno"> 413</span>  </div>
<div class="line"><a name="l00414"></a><span class="lineno"> 414</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga15cfad3f3d26339128e3be32ae7deacd">calcExpecPauliProd</a>(vec, targs, codes, numTargs, matWork), Contains(<span class="stringliteral">"Registers must both be state-vectors or both be density matrices"</span>) );</div>
<div class="line"><a name="l00415"></a><span class="lineno"> 415</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga15cfad3f3d26339128e3be32ae7deacd">calcExpecPauliProd</a>(mat, targs, codes, numTargs, vecWork), Contains(<span class="stringliteral">"Registers must both be state-vectors or both be density matrices"</span>) );</div>
<div class="line"><a name="l00416"></a><span class="lineno"> 416</span>  }</div>
<div class="line"><a name="l00417"></a><span class="lineno"> 417</span>  SECTION( <span class="stringliteral">"workspace dimensions"</span> ) {</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>  <span class="keywordtype">int</span> numTargs = 1;</div>
<div class="line"><a name="l00420"></a><span class="lineno"> 420</span>  <span class="keywordtype">int</span> targs[1] = {0};</div>
<div class="line"><a name="l00421"></a><span class="lineno"> 421</span>  <a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a> codes[1] = {<a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a63800f45b01ccc2608f754aee850bf4a">PAULI_I</a>};</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>  <a class="code" href="structQureg.html">Qureg</a> vec2 = <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="l00424"></a><span class="lineno"> 424</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga15cfad3f3d26339128e3be32ae7deacd">calcExpecPauliProd</a>(vec, targs, codes, numTargs, vec2), Contains(<span class="stringliteral">"Dimensions"</span>) && Contains(<span class="stringliteral">"don't match"</span>) );</div>
<div class="line"><a name="l00425"></a><span class="lineno"> 425</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(vec2, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00426"></a><span class="lineno"> 426</span>  </div>
<div class="line"><a name="l00427"></a><span class="lineno"> 427</span>  <a class="code" href="structQureg.html">Qureg</a> mat2 = <a class="code" href="group__type.html#ga93e55b6650b408abb30a1d4a8bce757c">createDensityQureg</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="l00428"></a><span class="lineno"> 428</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga15cfad3f3d26339128e3be32ae7deacd">calcExpecPauliProd</a>(mat, targs, codes, numTargs, mat2), Contains(<span class="stringliteral">"Dimensions"</span>) && Contains(<span class="stringliteral">"don't match"</span>) );</div>
<div class="line"><a name="l00429"></a><span class="lineno"> 429</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(mat2, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</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>  }</div>
<div class="line"><a name="l00432"></a><span class="lineno"> 432</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="l00433"></a><span class="lineno"> 433</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="l00434"></a><span class="lineno"> 434</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(vecWork, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00435"></a><span class="lineno"> 435</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(matWork, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00436"></a><span class="lineno"> 436</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="QuEST_8c_source.html#l01201">calcExpecPauliProd()</a>, <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00304">getFullOperatorMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00143">getKroneckerProduct()</a>, <a class="el" href="utilities_8cpp_source.html#l00526">getRandomInt()</a>, <a class="el" href="QuEST_8c_source.html#l01578">initDebugState()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="QuEST_8h_source.html#l00096">PAULI_I</a>, <a class="el" href="QuEST_8h_source.html#l00096">PAULI_X</a>, <a class="el" href="QuEST_8h_source.html#l00096">PAULI_Y</a>, <a class="el" href="QuEST_8h_source.html#l00096">PAULI_Z</a>, <a class="el" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, <a class="el" href="utilities_8cpp_source.html#l01488">sublists()</a>, <a class="el" href="utilities_8cpp_source.html#l01044">toQMatrix()</a>, and <a class="el" href="utilities_8cpp_source.html#l01113">toQVector()</a>.</p>
</div>
</div>
<a id="ga919ee8725c30d7378532714b70cfb389"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga919ee8725c30d7378532714b70cfb389">◆ </a></span>TEST_CASE() <span class="overload">[24/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"calcExpecPauliSum" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[calculations] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__calc.html#ga50ee589fd5ceab52fdd70d0082352b41" title="Computes the expected value of a sum of products of Pauli operators.">calcExpecPauliSum</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__calculations_8cpp_source.html#l00444">444</a> of file <a class="el" href="test__calculations_8cpp_source.html">test_calculations.cpp</a>.</p>
<div class="fragment"><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>  </div>
<div class="line"><a name="l00446"></a><span class="lineno"> 446</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="l00447"></a><span class="lineno"> 447</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="l00448"></a><span class="lineno"> 448</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(vec);</div>
<div class="line"><a name="l00449"></a><span class="lineno"> 449</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(mat);</div>
<div class="line"><a name="l00450"></a><span class="lineno"> 450</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> vecRef = <a class="code" href="group__testutilities.html#gade0e7c37811a69f1c21c88c11943a19f">toQVector</a>(vec);</div>
<div class="line"><a name="l00451"></a><span class="lineno"> 451</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> matRef = <a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(mat);</div>
<div class="line"><a name="l00452"></a><span class="lineno"> 452</span>  </div>
<div class="line"><a name="l00453"></a><span class="lineno"> 453</span>  <a class="code" href="structQureg.html">Qureg</a> vecWork = <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="l00454"></a><span class="lineno"> 454</span>  <a class="code" href="structQureg.html">Qureg</a> matWork = <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="l00455"></a><span class="lineno"> 455</span>  </div>
<div class="line"><a name="l00456"></a><span class="lineno"> 456</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00457"></a><span class="lineno"> 457</span>  </div>
<div class="line"><a name="l00458"></a><span class="lineno"> 458</span>  <span class="keywordtype">int</span> numSumTerms = GENERATE( 1, 2, 10, 15 );</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>  <span class="comment">/* it's too expensive to try every possible Pauli configuration, so</span></div>
<div class="line"><a name="l00461"></a><span class="lineno"> 461</span> <span class="comment"> * we'll try 10 random codes, and for each, random coefficients</span></div>
<div class="line"><a name="l00462"></a><span class="lineno"> 462</span> <span class="comment"> */</span></div>
<div class="line"><a name="l00463"></a><span class="lineno"> 463</span>  GENERATE( range(0,10) );</div>
<div class="line"><a name="l00464"></a><span class="lineno"> 464</span>  <span class="keywordtype">int</span> totNumCodes = numSumTerms*<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>;</div>
<div class="line"><a name="l00465"></a><span class="lineno"> 465</span>  <a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a> paulis[totNumCodes];</div>
<div class="line"><a name="l00466"></a><span class="lineno"> 466</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeffs[numSumTerms];</div>
<div class="line"><a name="l00467"></a><span class="lineno"> 467</span>  <a class="code" href="group__testutilities.html#ga11c465ce1a5c238946a9e09d61c94c58">setRandomPauliSum</a>(coeffs, paulis, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, numSumTerms);</div>
<div class="line"><a name="l00468"></a><span class="lineno"> 468</span>  </div>
<div class="line"><a name="l00469"></a><span class="lineno"> 469</span>  <span class="comment">// produce a numTargs-big matrix 'pauliSum' by pauli-matrix tensoring and summing</span></div>
<div class="line"><a name="l00470"></a><span class="lineno"> 470</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>, numSumTerms);</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>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00473"></a><span class="lineno"> 473</span>  </div>
<div class="line"><a name="l00474"></a><span class="lineno"> 474</span>  <span class="comment">/* calcExpecPauliSum calculates <qureg|pauliSum|qureg> */</span></div>
<div class="line"><a name="l00475"></a><span class="lineno"> 475</span>  </div>
<div class="line"><a name="l00476"></a><span class="lineno"> 476</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> sumRef = pauliSum * vecRef;</div>
<div class="line"><a name="l00477"></a><span class="lineno"> 477</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> prod = 0;</div>
<div class="line"><a name="l00478"></a><span class="lineno"> 478</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<vecRef.size(); i++)</div>
<div class="line"><a name="l00479"></a><span class="lineno"> 479</span>  prod += conj(vecRef[i]) * sumRef[i];</div>
<div class="line"><a name="l00480"></a><span class="lineno"> 480</span>  REQUIRE( imag(prod) == Approx(0).margin(10*REAL_EPS) );</div>
<div class="line"><a name="l00481"></a><span class="lineno"> 481</span>  </div>
<div class="line"><a name="l00482"></a><span class="lineno"> 482</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> res = <a class="code" href="group__calc.html#ga50ee589fd5ceab52fdd70d0082352b41">calcExpecPauliSum</a>(vec, paulis, coeffs, numSumTerms, vecWork);</div>
<div class="line"><a name="l00483"></a><span class="lineno"> 483</span>  REQUIRE( res == Approx(real(prod)).margin(10*REAL_EPS) );</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>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00486"></a><span class="lineno"> 486</span>  </div>
<div class="line"><a name="l00487"></a><span class="lineno"> 487</span>  <span class="comment">/* calcExpecPauliSum calculates Trace( pauliSum * qureg ) */</span></div>
<div class="line"><a name="l00488"></a><span class="lineno"> 488</span>  matRef = pauliSum * matRef; </div>
<div class="line"><a name="l00489"></a><span class="lineno"> 489</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> tr = 0;</div>
<div class="line"><a name="l00490"></a><span class="lineno"> 490</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<matRef.size(); i++)</div>
<div class="line"><a name="l00491"></a><span class="lineno"> 491</span>  tr += real(matRef[i][i]);</div>
<div class="line"><a name="l00492"></a><span class="lineno"> 492</span>  <span class="comment">// (get real, since we start in a non-Hermitian state, hence diagonal isn't real)</span></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>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> res = <a class="code" href="group__calc.html#ga50ee589fd5ceab52fdd70d0082352b41">calcExpecPauliSum</a>(mat, paulis, coeffs, numSumTerms, matWork);</div>
<div class="line"><a name="l00495"></a><span class="lineno"> 495</span>  REQUIRE( res == Approx(tr).margin(1E2*REAL_EPS) );</div>
<div class="line"><a name="l00496"></a><span class="lineno"> 496</span>  }</div>
<div class="line"><a name="l00497"></a><span class="lineno"> 497</span>  }</div>
<div class="line"><a name="l00498"></a><span class="lineno"> 498</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00499"></a><span class="lineno"> 499</span>  </div>
<div class="line"><a name="l00500"></a><span class="lineno"> 500</span>  SECTION( <span class="stringliteral">"number of sum terms"</span> ) {</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>  <span class="keywordtype">int</span> numSumTerms = GENERATE( -1, 0 );</div>
<div class="line"><a name="l00503"></a><span class="lineno"> 503</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga50ee589fd5ceab52fdd70d0082352b41">calcExpecPauliSum</a>(vec, NULL, NULL, numSumTerms, vecWork), Contains(<span class="stringliteral">"Invalid number of terms in the Pauli sum"</span>) );</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">"pauli codes"</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="comment">// make valid params</span></div>
<div class="line"><a name="l00508"></a><span class="lineno"> 508</span>  <span class="keywordtype">int</span> numSumTerms = 3;</div>
<div class="line"><a name="l00509"></a><span class="lineno"> 509</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeffs[numSumTerms];</div>
<div class="line"><a name="l00510"></a><span class="lineno"> 510</span>  <a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a> codes[numSumTerms*<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>];</div>
<div class="line"><a name="l00511"></a><span class="lineno"> 511</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numSumTerms*<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>; i++)</div>
<div class="line"><a name="l00512"></a><span class="lineno"> 512</span>  codes[i] = <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a63800f45b01ccc2608f754aee850bf4a">PAULI_I</a>;</div>
<div class="line"><a name="l00513"></a><span class="lineno"> 513</span>  </div>
<div class="line"><a name="l00514"></a><span class="lineno"> 514</span>  <span class="comment">// make one pauli wrong</span></div>
<div class="line"><a name="l00515"></a><span class="lineno"> 515</span>  codes[GENERATE_COPY( range(0,numSumTerms*<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="l00516"></a><span class="lineno"> 516</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga50ee589fd5ceab52fdd70d0082352b41">calcExpecPauliSum</a>(vec, codes, coeffs, numSumTerms, vecWork), Contains(<span class="stringliteral">"Invalid Pauli code"</span>) );</div>
<div class="line"><a name="l00517"></a><span class="lineno"> 517</span>  }</div>
<div class="line"><a name="l00518"></a><span class="lineno"> 518</span>  SECTION( <span class="stringliteral">"workspace type"</span> ) {</div>
<div class="line"><a name="l00519"></a><span class="lineno"> 519</span>  </div>
<div class="line"><a name="l00520"></a><span class="lineno"> 520</span>  <span class="comment">// make valid params</span></div>
<div class="line"><a name="l00521"></a><span class="lineno"> 521</span>  <span class="keywordtype">int</span> numSumTerms = 1;</div>
<div class="line"><a name="l00522"></a><span class="lineno"> 522</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeffs[1] = {0};</div>
<div class="line"><a name="l00523"></a><span class="lineno"> 523</span>  <a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a> codes[<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>];</div>
<div class="line"><a name="l00524"></a><span class="lineno"> 524</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>; i++)</div>
<div class="line"><a name="l00525"></a><span class="lineno"> 525</span>  codes[i] = <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a63800f45b01ccc2608f754aee850bf4a">PAULI_I</a>;</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>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga50ee589fd5ceab52fdd70d0082352b41">calcExpecPauliSum</a>(vec, codes, coeffs, numSumTerms, mat), Contains(<span class="stringliteral">"Registers must both be state-vectors or both be density matrices"</span>) );</div>
<div class="line"><a name="l00528"></a><span class="lineno"> 528</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga50ee589fd5ceab52fdd70d0082352b41">calcExpecPauliSum</a>(mat, codes, coeffs, numSumTerms, vec), Contains(<span class="stringliteral">"Registers must both be state-vectors or both be density matrices"</span>) );</div>
<div class="line"><a name="l00529"></a><span class="lineno"> 529</span>  }</div>
<div class="line"><a name="l00530"></a><span class="lineno"> 530</span>  SECTION( <span class="stringliteral">"workspace dimensions"</span> ) {</div>
<div class="line"><a name="l00531"></a><span class="lineno"> 531</span>  </div>
<div class="line"><a name="l00532"></a><span class="lineno"> 532</span>  <span class="comment">// make valid params</span></div>
<div class="line"><a name="l00533"></a><span class="lineno"> 533</span>  <span class="keywordtype">int</span> numSumTerms = 1;</div>
<div class="line"><a name="l00534"></a><span class="lineno"> 534</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeffs[1] = {0};</div>
<div class="line"><a name="l00535"></a><span class="lineno"> 535</span>  <a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a> codes[<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>];</div>
<div class="line"><a name="l00536"></a><span class="lineno"> 536</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>; i++)</div>
<div class="line"><a name="l00537"></a><span class="lineno"> 537</span>  codes[i] = <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a63800f45b01ccc2608f754aee850bf4a">PAULI_I</a>;</div>
<div class="line"><a name="l00538"></a><span class="lineno"> 538</span>  </div>
<div class="line"><a name="l00539"></a><span class="lineno"> 539</span>  <a class="code" href="structQureg.html">Qureg</a> vec2 = <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="l00540"></a><span class="lineno"> 540</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga50ee589fd5ceab52fdd70d0082352b41">calcExpecPauliSum</a>(vec, codes, coeffs, numSumTerms, vec2), Contains(<span class="stringliteral">"Dimensions"</span>) && Contains(<span class="stringliteral">"don't match"</span>) );</div>
<div class="line"><a name="l00541"></a><span class="lineno"> 541</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(vec2, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00542"></a><span class="lineno"> 542</span>  </div>
<div class="line"><a name="l00543"></a><span class="lineno"> 543</span>  <a class="code" href="structQureg.html">Qureg</a> mat2 = <a class="code" href="group__type.html#ga93e55b6650b408abb30a1d4a8bce757c">createDensityQureg</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="l00544"></a><span class="lineno"> 544</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga50ee589fd5ceab52fdd70d0082352b41">calcExpecPauliSum</a>(mat, codes, coeffs, numSumTerms, mat2), Contains(<span class="stringliteral">"Dimensions"</span>) && Contains(<span class="stringliteral">"don't match"</span>) );</div>
<div class="line"><a name="l00545"></a><span class="lineno"> 545</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(mat2, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</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>  }</div>
<div class="line"><a name="l00548"></a><span class="lineno"> 548</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="l00549"></a><span class="lineno"> 549</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="l00550"></a><span class="lineno"> 550</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(vecWork, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00551"></a><span class="lineno"> 551</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(matWork, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00552"></a><span class="lineno"> 552</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l01210">calcExpecPauliSum()</a>, <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="QuEST_8c_source.html#l01578">initDebugState()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="QuEST_8h_source.html#l00096">PAULI_I</a>, <a class="el" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, <a class="el" href="utilities_8cpp_source.html#l01229">setRandomPauliSum()</a>, <a class="el" href="utilities_8cpp_source.html#l01044">toQMatrix()</a>, and <a class="el" href="utilities_8cpp_source.html#l01113">toQVector()</a>.</p>
</div>
</div>
<a id="gaceb52fe2677e119547d5b5e0f2f202fb"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaceb52fe2677e119547d5b5e0f2f202fb">◆ </a></span>TEST_CASE() <span class="overload">[25/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"calcFidelity" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[calculations] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__calc.html#gaa266ed6c8ae5d0d0f49e1ac50819cffc" title="Calculates the fidelity of qureg (a state-vector or density matrix) against a reference pure state (n...">calcFidelity</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__calculations_8cpp_source.html#l00560">560</a> of file <a class="el" href="test__calculations_8cpp_source.html">test_calculations.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00560"></a><span class="lineno"> 560</span>  {</div>
<div class="line"><a name="l00561"></a><span class="lineno"> 561</span>  </div>
<div class="line"><a name="l00562"></a><span class="lineno"> 562</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="l00563"></a><span class="lineno"> 563</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="l00564"></a><span class="lineno"> 564</span>  <a class="code" href="structQureg.html">Qureg</a> pure = <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="l00565"></a><span class="lineno"> 565</span>  </div>
<div class="line"><a name="l00566"></a><span class="lineno"> 566</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00567"></a><span class="lineno"> 567</span>  </div>
<div class="line"><a name="l00568"></a><span class="lineno"> 568</span>  <span class="comment">// repeat the below random tests 10 times </span></div>
<div class="line"><a name="l00569"></a><span class="lineno"> 569</span>  GENERATE( range(0,10) );</div>
<div class="line"><a name="l00570"></a><span class="lineno"> 570</span>  </div>
<div class="line"><a name="l00571"></a><span class="lineno"> 571</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00572"></a><span class="lineno"> 572</span>  </div>
<div class="line"><a name="l00573"></a><span class="lineno"> 573</span>  <span class="comment">/* calcFidelity computes |<vec|pure>|^2 */</span></div>
<div class="line"><a name="l00574"></a><span class="lineno"> 574</span>  </div>
<div class="line"><a name="l00575"></a><span class="lineno"> 575</span>  SECTION( <span class="stringliteral">"normalised"</span> ) {</div>
<div class="line"><a name="l00576"></a><span class="lineno"> 576</span>  </div>
<div class="line"><a name="l00577"></a><span class="lineno"> 577</span>  <span class="comment">// random L2 vectors</span></div>
<div class="line"><a name="l00578"></a><span class="lineno"> 578</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="l00579"></a><span class="lineno"> 579</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> pureRef = <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="l00580"></a><span class="lineno"> 580</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(vec, vecRef);</div>
<div class="line"><a name="l00581"></a><span class="lineno"> 581</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(pure, pureRef);</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>  <span class="comment">// |<vec|vec>|^2 = |1|^2 = 1</span></div>
<div class="line"><a name="l00584"></a><span class="lineno"> 584</span>  REQUIRE( <a class="code" href="group__calc.html#gaa266ed6c8ae5d0d0f49e1ac50819cffc">calcFidelity</a>(vec,vec) == Approx(1) );</div>
<div class="line"><a name="l00585"></a><span class="lineno"> 585</span>  </div>
<div class="line"><a name="l00586"></a><span class="lineno"> 586</span>  <span class="comment">// |<vec|pure>|^2 = |sum_j conj(vec_j) * pure_j|^2</span></div>
<div class="line"><a name="l00587"></a><span class="lineno"> 587</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> dotProd = 0;</div>
<div class="line"><a name="l00588"></a><span class="lineno"> 588</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<vecRef.size(); i++)</div>
<div class="line"><a name="l00589"></a><span class="lineno"> 589</span>  dotProd += conj(vecRef[i]) * pureRef[i];</div>
<div class="line"><a name="l00590"></a><span class="lineno"> 590</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> refFid = pow(abs(dotProd), 2);</div>
<div class="line"><a name="l00591"></a><span class="lineno"> 591</span>  </div>
<div class="line"><a name="l00592"></a><span class="lineno"> 592</span>  REQUIRE( <a class="code" href="group__calc.html#gaa266ed6c8ae5d0d0f49e1ac50819cffc">calcFidelity</a>(vec,pure) == Approx(refFid) );</div>
<div class="line"><a name="l00593"></a><span class="lineno"> 593</span>  }</div>
<div class="line"><a name="l00594"></a><span class="lineno"> 594</span>  SECTION( <span class="stringliteral">"unnormalised"</span> ) {</div>
<div class="line"><a name="l00595"></a><span class="lineno"> 595</span>  </div>
<div class="line"><a name="l00596"></a><span class="lineno"> 596</span>  <span class="comment">// random unnormalised vectors</span></div>
<div class="line"><a name="l00597"></a><span class="lineno"> 597</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="l00598"></a><span class="lineno"> 598</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> pureRef = <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="l00599"></a><span class="lineno"> 599</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(vec, vecRef);</div>
<div class="line"><a name="l00600"></a><span class="lineno"> 600</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(pure, pureRef);</div>
<div class="line"><a name="l00601"></a><span class="lineno"> 601</span>  </div>
<div class="line"><a name="l00602"></a><span class="lineno"> 602</span>  <span class="comment">// Let nv be magnitude of vec, hence |unit-vec> = 1/sqrt(nv)|vec></span></div>
<div class="line"><a name="l00603"></a><span class="lineno"> 603</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> nv = 0;</div>
<div class="line"><a name="l00604"></a><span class="lineno"> 604</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<vecRef.size(); i++)</div>
<div class="line"><a name="l00605"></a><span class="lineno"> 605</span>  nv += pow(abs(vecRef[i]), 2);</div>
<div class="line"><a name="l00606"></a><span class="lineno"> 606</span>  <span class="comment">// then <vec|vec> = sqrt(nv)*sqrt(nv) <unit-vec|unit-vec> = nv,</span></div>
<div class="line"><a name="l00607"></a><span class="lineno"> 607</span>  <span class="comment">// hence |<vec|vec>|^2 = nv*nv</span></div>
<div class="line"><a name="l00608"></a><span class="lineno"> 608</span>  REQUIRE( <a class="code" href="group__calc.html#gaa266ed6c8ae5d0d0f49e1ac50819cffc">calcFidelity</a>(vec,vec) == Approx( nv*nv ) );</div>
<div class="line"><a name="l00609"></a><span class="lineno"> 609</span>  </div>
<div class="line"><a name="l00610"></a><span class="lineno"> 610</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> dotProd = 0;</div>
<div class="line"><a name="l00611"></a><span class="lineno"> 611</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<vecRef.size(); i++)</div>
<div class="line"><a name="l00612"></a><span class="lineno"> 612</span>  dotProd += conj(vecRef[i]) * pureRef[i];</div>
<div class="line"><a name="l00613"></a><span class="lineno"> 613</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> refFid = pow(abs(dotProd), 2);</div>
<div class="line"><a name="l00614"></a><span class="lineno"> 614</span>  </div>
<div class="line"><a name="l00615"></a><span class="lineno"> 615</span>  REQUIRE( <a class="code" href="group__calc.html#gaa266ed6c8ae5d0d0f49e1ac50819cffc">calcFidelity</a>(vec,pure) == Approx(refFid) ); </div>
<div class="line"><a name="l00616"></a><span class="lineno"> 616</span>  }</div>
<div class="line"><a name="l00617"></a><span class="lineno"> 617</span>  }</div>
<div class="line"><a name="l00618"></a><span class="lineno"> 618</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00619"></a><span class="lineno"> 619</span>  </div>
<div class="line"><a name="l00620"></a><span class="lineno"> 620</span>  <span class="comment">/* calcFidelity computes <pure|mat|pure> */</span></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>  SECTION( <span class="stringliteral">"pure"</span> ) {</div>
<div class="line"><a name="l00623"></a><span class="lineno"> 623</span>  </div>
<div class="line"><a name="l00624"></a><span class="lineno"> 624</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> pureRef = <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="l00625"></a><span class="lineno"> 625</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(pure, pureRef);</div>
<div class="line"><a name="l00626"></a><span class="lineno"> 626</span>  </div>
<div class="line"><a name="l00627"></a><span class="lineno"> 627</span>  <span class="comment">// test when density matrix is the same pure state </span></div>
<div class="line"><a name="l00628"></a><span class="lineno"> 628</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> matRef = <a class="code" href="group__testutilities.html#ga2de7d3b138728b6beb7753b82df61803">getKetBra</a>(pureRef, pureRef);</div>
<div class="line"><a name="l00629"></a><span class="lineno"> 629</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat, matRef);</div>
<div class="line"><a name="l00630"></a><span class="lineno"> 630</span>  REQUIRE( <a class="code" href="group__calc.html#gaa266ed6c8ae5d0d0f49e1ac50819cffc">calcFidelity</a>(mat,pure) == Approx(1) ); </div>
<div class="line"><a name="l00631"></a><span class="lineno"> 631</span>  </div>
<div class="line"><a name="l00632"></a><span class="lineno"> 632</span>  <span class="comment">// test when density matrix is a random pure state</span></div>
<div class="line"><a name="l00633"></a><span class="lineno"> 633</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> r1 = <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="l00634"></a><span class="lineno"> 634</span>  matRef = <a class="code" href="group__testutilities.html#ga2de7d3b138728b6beb7753b82df61803">getKetBra</a>(r1, r1); <span class="comment">// actually pure |r1><r1|</span></div>
<div class="line"><a name="l00635"></a><span class="lineno"> 635</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat, matRef);</div>
<div class="line"><a name="l00636"></a><span class="lineno"> 636</span>  </div>
<div class="line"><a name="l00637"></a><span class="lineno"> 637</span>  <span class="comment">// <pure|r1><r1|pure> = |<r1|pure>|^2 = |sum_j conj(r1_j) * pure_j|^2</span></div>
<div class="line"><a name="l00638"></a><span class="lineno"> 638</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> dotProd = 0;</div>
<div class="line"><a name="l00639"></a><span class="lineno"> 639</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<r1.size(); i++)</div>
<div class="line"><a name="l00640"></a><span class="lineno"> 640</span>  dotProd += conj(r1[i]) * pureRef[i];</div>
<div class="line"><a name="l00641"></a><span class="lineno"> 641</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> refFid = pow(abs(dotProd), 2);</div>
<div class="line"><a name="l00642"></a><span class="lineno"> 642</span>  </div>
<div class="line"><a name="l00643"></a><span class="lineno"> 643</span>  REQUIRE( <a class="code" href="group__calc.html#gaa266ed6c8ae5d0d0f49e1ac50819cffc">calcFidelity</a>(mat,pure) == Approx(refFid) ); </div>
<div class="line"><a name="l00644"></a><span class="lineno"> 644</span>  }</div>
<div class="line"><a name="l00645"></a><span class="lineno"> 645</span>  SECTION( <span class="stringliteral">"mixed"</span> ) {</div>
<div class="line"><a name="l00646"></a><span class="lineno"> 646</span>  </div>
<div class="line"><a name="l00647"></a><span class="lineno"> 647</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> pureRef = <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="l00648"></a><span class="lineno"> 648</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(pure, pureRef);</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">// test when density matrix is mixed </span></div>
<div class="line"><a name="l00651"></a><span class="lineno"> 651</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="l00652"></a><span class="lineno"> 652</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat, matRef);</div>
<div class="line"><a name="l00653"></a><span class="lineno"> 653</span>  </div>
<div class="line"><a name="l00654"></a><span class="lineno"> 654</span>  <span class="comment">// <pure|mat|pure> = <pure| (Mat|pure>)</span></div>
<div class="line"><a name="l00655"></a><span class="lineno"> 655</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> rhs = matRef * pureRef;</div>
<div class="line"><a name="l00656"></a><span class="lineno"> 656</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> dotProd = 0;</div>
<div class="line"><a name="l00657"></a><span class="lineno"> 657</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<rhs.size(); i++)</div>
<div class="line"><a name="l00658"></a><span class="lineno"> 658</span>  dotProd += conj(pureRef[i]) * rhs[i];</div>
<div class="line"><a name="l00659"></a><span class="lineno"> 659</span>  </div>
<div class="line"><a name="l00660"></a><span class="lineno"> 660</span>  REQUIRE( imag(dotProd) == Approx(0).margin(REAL_EPS) );</div>
<div class="line"><a name="l00661"></a><span class="lineno"> 661</span>  REQUIRE( <a class="code" href="group__calc.html#gaa266ed6c8ae5d0d0f49e1ac50819cffc">calcFidelity</a>(mat,pure) == Approx(real(dotProd)) );</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>  SECTION( <span class="stringliteral">"unnormalised"</span> ) {</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>  <span class="comment">// test when both density matrix and pure state are unnormalised</span></div>
<div class="line"><a name="l00666"></a><span class="lineno"> 666</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> pureRef = <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="l00667"></a><span class="lineno"> 667</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="l00668"></a><span class="lineno"> 668</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(pure, pureRef);</div>
<div class="line"><a name="l00669"></a><span class="lineno"> 669</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat, matRef);</div>
<div class="line"><a name="l00670"></a><span class="lineno"> 670</span>  </div>
<div class="line"><a name="l00671"></a><span class="lineno"> 671</span>  <span class="comment">// real[ <pure|mat|pure> ] = real[ <pure| (Mat|pure>) ]</span></div>
<div class="line"><a name="l00672"></a><span class="lineno"> 672</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> rhs = matRef * pureRef;</div>
<div class="line"><a name="l00673"></a><span class="lineno"> 673</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> dotProd = 0;</div>
<div class="line"><a name="l00674"></a><span class="lineno"> 674</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<rhs.size(); i++)</div>
<div class="line"><a name="l00675"></a><span class="lineno"> 675</span>  dotProd += conj(pureRef[i]) * rhs[i];</div>
<div class="line"><a name="l00676"></a><span class="lineno"> 676</span>  </div>
<div class="line"><a name="l00677"></a><span class="lineno"> 677</span>  REQUIRE( <a class="code" href="group__calc.html#gaa266ed6c8ae5d0d0f49e1ac50819cffc">calcFidelity</a>(mat,pure) == Approx(real(dotProd)) );</div>
<div class="line"><a name="l00678"></a><span class="lineno"> 678</span>  }</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>  }</div>
<div class="line"><a name="l00681"></a><span class="lineno"> 681</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00682"></a><span class="lineno"> 682</span>  </div>
<div class="line"><a name="l00683"></a><span class="lineno"> 683</span>  SECTION( <span class="stringliteral">"dimensions"</span> ) {</div>
<div class="line"><a name="l00684"></a><span class="lineno"> 684</span>  </div>
<div class="line"><a name="l00685"></a><span class="lineno"> 685</span>  <span class="comment">// two state-vectors</span></div>
<div class="line"><a name="l00686"></a><span class="lineno"> 686</span>  <a class="code" href="structQureg.html">Qureg</a> vec2 = <a class="code" href="group__type.html#ga3392816c0643414165c2f5caeec17df0">createQureg</a>(vec.<a class="code" href="structQureg.html#ad08dff5316b8937f4b2a1417591543dc">numQubitsRepresented</a> + 1, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00687"></a><span class="lineno"> 687</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#gaa266ed6c8ae5d0d0f49e1ac50819cffc">calcFidelity</a>(vec2,vec), Contains(<span class="stringliteral">"Dimensions"</span>) && Contains(<span class="stringliteral">"don't match"</span>) );</div>
<div class="line"><a name="l00688"></a><span class="lineno"> 688</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(vec2, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</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>  <span class="comment">// density-matrix and state-vector</span></div>
<div class="line"><a name="l00691"></a><span class="lineno"> 691</span>  <a class="code" href="structQureg.html">Qureg</a> mat2 = <a class="code" href="group__type.html#ga93e55b6650b408abb30a1d4a8bce757c">createDensityQureg</a>(vec.<a class="code" href="structQureg.html#ad08dff5316b8937f4b2a1417591543dc">numQubitsRepresented</a> + 1, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00692"></a><span class="lineno"> 692</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#gaa266ed6c8ae5d0d0f49e1ac50819cffc">calcFidelity</a>(mat2,vec), Contains(<span class="stringliteral">"Dimensions"</span>) && Contains(<span class="stringliteral">"don't match"</span>) );</div>
<div class="line"><a name="l00693"></a><span class="lineno"> 693</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(mat2, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00694"></a><span class="lineno"> 694</span>  }</div>
<div class="line"><a name="l00695"></a><span class="lineno"> 695</span>  SECTION( <span class="stringliteral">"density-matrices"</span> ) {</div>
<div class="line"><a name="l00696"></a><span class="lineno"> 696</span>  </div>
<div class="line"><a name="l00697"></a><span class="lineno"> 697</span>  <span class="comment">// two mixed statess</span></div>
<div class="line"><a name="l00698"></a><span class="lineno"> 698</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#gaa266ed6c8ae5d0d0f49e1ac50819cffc">calcFidelity</a>(mat,mat), Contains(<span class="stringliteral">"Second argument must be a state-vector"</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>  }</div>
<div class="line"><a name="l00701"></a><span class="lineno"> 701</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="l00702"></a><span class="lineno"> 702</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="l00703"></a><span class="lineno"> 703</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(pure, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00704"></a><span class="lineno"> 704</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l01191">calcFidelity()</a>, <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00169">getKetBra()</a>, <a class="el" href="utilities_8cpp_source.html#l00490">getRandomDensityMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00379">getRandomQMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00435">getRandomQVector()</a>, <a class="el" href="utilities_8cpp_source.html#l00468">getRandomStateVector()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="QuEST_8h_source.html#l00327">Qureg::numQubitsRepresented</a>, <a class="el" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, and <a class="el" href="utilities_8cpp_source.html#l01201">toQureg()</a>.</p>
</div>
</div>
<a id="ga769a51547f263527bf27bbbcb51014a8"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga769a51547f263527bf27bbbcb51014a8">◆ </a></span>TEST_CASE() <span class="overload">[26/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"calcHilbertSchmidtDistance" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[calculations] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__calc.html#ga87ddbe5c8281543541ccd99e0dafd387" title="Computes the Hilbert Schmidt distance between two density matrices a and b, defined as the Frobenius ...">calcHilbertSchmidtDistance</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__calculations_8cpp_source.html#l00712">712</a> of file <a class="el" href="test__calculations_8cpp_source.html">test_calculations.cpp</a>.</p>
<div class="fragment"><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>  </div>
<div class="line"><a name="l00714"></a><span class="lineno"> 714</span>  <a class="code" href="structQureg.html">Qureg</a> mat1 = <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="l00715"></a><span class="lineno"> 715</span>  <a class="code" href="structQureg.html">Qureg</a> mat2 = <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="l00716"></a><span class="lineno"> 716</span>  </div>
<div class="line"><a name="l00717"></a><span class="lineno"> 717</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</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>  <span class="comment">// perform these random tests 10 times </span></div>
<div class="line"><a name="l00720"></a><span class="lineno"> 720</span>  GENERATE( range(0,10) );</div>
<div class="line"><a name="l00721"></a><span class="lineno"> 721</span>  </div>
<div class="line"><a name="l00722"></a><span class="lineno"> 722</span>  SECTION( <span class="stringliteral">"density-matrix"</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">"pure"</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>  <span class="comment">// create random |r1><r1| and |r2><r2| states</span></div>
<div class="line"><a name="l00727"></a><span class="lineno"> 727</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> r1 = <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="l00728"></a><span class="lineno"> 728</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> m1 = <a class="code" href="group__testutilities.html#ga2de7d3b138728b6beb7753b82df61803">getKetBra</a>(r1,r1);</div>
<div class="line"><a name="l00729"></a><span class="lineno"> 729</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat1, m1);</div>
<div class="line"><a name="l00730"></a><span class="lineno"> 730</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> r2 = <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="l00731"></a><span class="lineno"> 731</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> m2 = <a class="code" href="group__testutilities.html#ga2de7d3b138728b6beb7753b82df61803">getKetBra</a>(r2,r2);</div>
<div class="line"><a name="l00732"></a><span class="lineno"> 732</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat2, m2);</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>  <span class="comment">// Tr{ (a-b)(a-b)^dagger } = sum_{ij} |a_{ij} - b_{ij}|^2</span></div>
<div class="line"><a name="l00735"></a><span class="lineno"> 735</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> tr = 0;</div>
<div class="line"><a name="l00736"></a><span class="lineno"> 736</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<m1.size(); i++)</div>
<div class="line"><a name="l00737"></a><span class="lineno"> 737</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> j=0; j<m1.size(); j++)</div>
<div class="line"><a name="l00738"></a><span class="lineno"> 738</span>  tr += pow(abs(m1[i][j] - m2[i][j]), 2);</div>
<div class="line"><a name="l00739"></a><span class="lineno"> 739</span>  </div>
<div class="line"><a name="l00740"></a><span class="lineno"> 740</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> res = <a class="code" href="group__calc.html#ga87ddbe5c8281543541ccd99e0dafd387">calcHilbertSchmidtDistance</a>(mat1, mat2);</div>
<div class="line"><a name="l00741"></a><span class="lineno"> 741</span>  REQUIRE( res == Approx(sqrt(tr)) );</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>  }</div>
<div class="line"><a name="l00744"></a><span class="lineno"> 744</span>  SECTION( <span class="stringliteral">"normalised"</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>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> ref1 = <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="l00747"></a><span class="lineno"> 747</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> ref2 = <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="l00748"></a><span class="lineno"> 748</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat1, ref1);</div>
<div class="line"><a name="l00749"></a><span class="lineno"> 749</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat2, ref2);</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>  <span class="comment">// Tr{ (a-b)(a-b)^dagger } = sum_{ij} |a_{ij} - b_{ij}|^2</span></div>
<div class="line"><a name="l00752"></a><span class="lineno"> 752</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> tr = 0;</div>
<div class="line"><a name="l00753"></a><span class="lineno"> 753</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<ref1.size(); i++)</div>
<div class="line"><a name="l00754"></a><span class="lineno"> 754</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> j=0; j<ref1.size(); j++)</div>
<div class="line"><a name="l00755"></a><span class="lineno"> 755</span>  tr += pow(abs(ref1[i][j] - ref2[i][j]), 2);</div>
<div class="line"><a name="l00756"></a><span class="lineno"> 756</span>  </div>
<div class="line"><a name="l00757"></a><span class="lineno"> 757</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> res = <a class="code" href="group__calc.html#ga87ddbe5c8281543541ccd99e0dafd387">calcHilbertSchmidtDistance</a>(mat1, mat2);</div>
<div class="line"><a name="l00758"></a><span class="lineno"> 758</span>  REQUIRE( res == Approx(sqrt(tr)) );</div>
<div class="line"><a name="l00759"></a><span class="lineno"> 759</span>  }</div>
<div class="line"><a name="l00760"></a><span class="lineno"> 760</span>  SECTION( <span class="stringliteral">"unnormalised"</span> ) {</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>  <span class="comment">// mat1 and mat2 are both random matrices</span></div>
<div class="line"><a name="l00763"></a><span class="lineno"> 763</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> ref1 = <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="l00764"></a><span class="lineno"> 764</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> ref2 = <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="l00765"></a><span class="lineno"> 765</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat1, ref1);</div>
<div class="line"><a name="l00766"></a><span class="lineno"> 766</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat2, ref2);</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>  <span class="comment">// Tr{ (a-b)(a-b)^dagger } = sum_{ij} |a_{ij} - b_{ij}|^2</span></div>
<div class="line"><a name="l00769"></a><span class="lineno"> 769</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> tr = 0;</div>
<div class="line"><a name="l00770"></a><span class="lineno"> 770</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<ref1.size(); i++)</div>
<div class="line"><a name="l00771"></a><span class="lineno"> 771</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> j=0; j<ref1.size(); j++)</div>
<div class="line"><a name="l00772"></a><span class="lineno"> 772</span>  tr += pow(abs(ref1[i][j] - ref2[i][j]), 2);</div>
<div class="line"><a name="l00773"></a><span class="lineno"> 773</span>  </div>
<div class="line"><a name="l00774"></a><span class="lineno"> 774</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> res = <a class="code" href="group__calc.html#ga87ddbe5c8281543541ccd99e0dafd387">calcHilbertSchmidtDistance</a>(mat1, mat2);</div>
<div class="line"><a name="l00775"></a><span class="lineno"> 775</span>  REQUIRE( res == Approx(sqrt(tr)) );</div>
<div class="line"><a name="l00776"></a><span class="lineno"> 776</span>  }</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>  }</div>
<div class="line"><a name="l00779"></a><span class="lineno"> 779</span>  SECTION( <span class="stringliteral">"input validation"</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>  SECTION( <span class="stringliteral">"dimensions"</span> ) {</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>  <a class="code" href="structQureg.html">Qureg</a> mat3 = <a class="code" href="group__type.html#ga93e55b6650b408abb30a1d4a8bce757c">createDensityQureg</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="l00784"></a><span class="lineno"> 784</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga87ddbe5c8281543541ccd99e0dafd387">calcHilbertSchmidtDistance</a>(mat1,mat3), Contains(<span class="stringliteral">"Dimensions"</span>) && Contains(<span class="stringliteral">"don't match"</span>) );</div>
<div class="line"><a name="l00785"></a><span class="lineno"> 785</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(mat3, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00786"></a><span class="lineno"> 786</span>  }</div>
<div class="line"><a name="l00787"></a><span class="lineno"> 787</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00788"></a><span class="lineno"> 788</span>  </div>
<div class="line"><a name="l00789"></a><span class="lineno"> 789</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="l00790"></a><span class="lineno"> 790</span>  </div>
<div class="line"><a name="l00791"></a><span class="lineno"> 791</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga87ddbe5c8281543541ccd99e0dafd387">calcHilbertSchmidtDistance</a>(vec,mat1), Contains(<span class="stringliteral">"valid only for density matrices"</span>) );</div>
<div class="line"><a name="l00792"></a><span class="lineno"> 792</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga87ddbe5c8281543541ccd99e0dafd387">calcHilbertSchmidtDistance</a>(mat1,vec), Contains(<span class="stringliteral">"valid only for density matrices"</span>) );</div>
<div class="line"><a name="l00793"></a><span class="lineno"> 793</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga87ddbe5c8281543541ccd99e0dafd387">calcHilbertSchmidtDistance</a>(vec,vec), Contains(<span class="stringliteral">"valid only for density matrices"</span>) );</div>
<div class="line"><a name="l00794"></a><span class="lineno"> 794</span>  </div>
<div class="line"><a name="l00795"></a><span class="lineno"> 795</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="l00796"></a><span class="lineno"> 796</span>  }</div>
<div class="line"><a name="l00797"></a><span class="lineno"> 797</span>  }</div>
<div class="line"><a name="l00798"></a><span class="lineno"> 798</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(mat1, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00799"></a><span class="lineno"> 799</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(mat2, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00800"></a><span class="lineno"> 800</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l01237">calcHilbertSchmidtDistance()</a>, <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00169">getKetBra()</a>, <a class="el" href="utilities_8cpp_source.html#l00490">getRandomDensityMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00379">getRandomQMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00468">getRandomStateVector()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, and <a class="el" href="utilities_8cpp_source.html#l01201">toQureg()</a>.</p>
</div>
</div>
<a id="gaf08d29f7b27caf904b748c68ff3e3372"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaf08d29f7b27caf904b748c68ff3e3372">◆ </a></span>TEST_CASE() <span class="overload">[27/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"calcInnerProduct" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[calculations] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__calc.html#ga374ad70804998394ae41ebfe106258a6" title="Computes the inner product of two equal-size state vectors, given by.">calcInnerProduct</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__calculations_8cpp_source.html#l00808">808</a> of file <a class="el" href="test__calculations_8cpp_source.html">test_calculations.cpp</a>.</p>
<div class="fragment"><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>  </div>
<div class="line"><a name="l00810"></a><span class="lineno"> 810</span>  <a class="code" href="structQureg.html">Qureg</a> vec1 = <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="l00811"></a><span class="lineno"> 811</span>  <a class="code" href="structQureg.html">Qureg</a> vec2 = <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="l00812"></a><span class="lineno"> 812</span>  </div>
<div class="line"><a name="l00813"></a><span class="lineno"> 813</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00814"></a><span class="lineno"> 814</span>  </div>
<div class="line"><a name="l00815"></a><span class="lineno"> 815</span>  <span class="comment">// perform these random tests 10 times </span></div>
<div class="line"><a name="l00816"></a><span class="lineno"> 816</span>  GENERATE( range(0,10) );</div>
<div class="line"><a name="l00817"></a><span class="lineno"> 817</span>  </div>
<div class="line"><a name="l00818"></a><span class="lineno"> 818</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</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>  SECTION( <span class="stringliteral">"normalised"</span> ) {</div>
<div class="line"><a name="l00821"></a><span class="lineno"> 821</span>  </div>
<div class="line"><a name="l00822"></a><span class="lineno"> 822</span>  <span class="comment">// <r1|r2> = sum_j conj(r1_j) * r2_j</span></div>
<div class="line"><a name="l00823"></a><span class="lineno"> 823</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> r1 = <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="l00824"></a><span class="lineno"> 824</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> r2 = <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="l00825"></a><span class="lineno"> 825</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> prod = 0;</div>
<div class="line"><a name="l00826"></a><span class="lineno"> 826</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<r1.size(); i++)</div>
<div class="line"><a name="l00827"></a><span class="lineno"> 827</span>  prod += conj(r1[i]) * r2[i];</div>
<div class="line"><a name="l00828"></a><span class="lineno"> 828</span>  </div>
<div class="line"><a name="l00829"></a><span class="lineno"> 829</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(vec1, r1);</div>
<div class="line"><a name="l00830"></a><span class="lineno"> 830</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(vec2, r2);</div>
<div class="line"><a name="l00831"></a><span class="lineno"> 831</span>  <a class="code" href="structComplex.html">Complex</a> res = <a class="code" href="group__calc.html#ga374ad70804998394ae41ebfe106258a6">calcInnerProduct</a>(vec1,vec2);</div>
<div class="line"><a name="l00832"></a><span class="lineno"> 832</span>  </div>
<div class="line"><a name="l00833"></a><span class="lineno"> 833</span>  REQUIRE( res.<a class="code" href="structComplex.html#ab5b2e2eca02131fc74b289a83636cbe3">real</a> == Approx(real(prod)) );</div>
<div class="line"><a name="l00834"></a><span class="lineno"> 834</span>  REQUIRE( res.<a class="code" href="structComplex.html#a84f5439aad0ef495efdd3b4c1c02d27e">imag</a> == Approx(imag(prod)) );</div>
<div class="line"><a name="l00835"></a><span class="lineno"> 835</span>  }</div>
<div class="line"><a name="l00836"></a><span class="lineno"> 836</span>  SECTION( <span class="stringliteral">"unnormalised"</span> ) {</div>
<div class="line"><a name="l00837"></a><span class="lineno"> 837</span>  </div>
<div class="line"><a name="l00838"></a><span class="lineno"> 838</span>  <span class="comment">// <r1|r2> = sum_j conj(r1_j) * r2_j</span></div>
<div class="line"><a name="l00839"></a><span class="lineno"> 839</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> r1 = <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="l00840"></a><span class="lineno"> 840</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> r2 = <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="l00841"></a><span class="lineno"> 841</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> prod = 0;</div>
<div class="line"><a name="l00842"></a><span class="lineno"> 842</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<r1.size(); i++)</div>
<div class="line"><a name="l00843"></a><span class="lineno"> 843</span>  prod += conj(r1[i]) * r2[i];</div>
<div class="line"><a name="l00844"></a><span class="lineno"> 844</span>  </div>
<div class="line"><a name="l00845"></a><span class="lineno"> 845</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(vec1, r1);</div>
<div class="line"><a name="l00846"></a><span class="lineno"> 846</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(vec2, r2);</div>
<div class="line"><a name="l00847"></a><span class="lineno"> 847</span>  <a class="code" href="structComplex.html">Complex</a> res = <a class="code" href="group__calc.html#ga374ad70804998394ae41ebfe106258a6">calcInnerProduct</a>(vec1,vec2);</div>
<div class="line"><a name="l00848"></a><span class="lineno"> 848</span>  </div>
<div class="line"><a name="l00849"></a><span class="lineno"> 849</span>  REQUIRE( res.<a class="code" href="structComplex.html#ab5b2e2eca02131fc74b289a83636cbe3">real</a> == Approx(real(prod)) );</div>
<div class="line"><a name="l00850"></a><span class="lineno"> 850</span>  REQUIRE( res.<a class="code" href="structComplex.html#a84f5439aad0ef495efdd3b4c1c02d27e">imag</a> == Approx(imag(prod)) );</div>
<div class="line"><a name="l00851"></a><span class="lineno"> 851</span>  }</div>
<div class="line"><a name="l00852"></a><span class="lineno"> 852</span>  }</div>
<div class="line"><a name="l00853"></a><span class="lineno"> 853</span>  }</div>
<div class="line"><a name="l00854"></a><span class="lineno"> 854</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00855"></a><span class="lineno"> 855</span>  </div>
<div class="line"><a name="l00856"></a><span class="lineno"> 856</span>  SECTION( <span class="stringliteral">"dimensions"</span> ) {</div>
<div class="line"><a name="l00857"></a><span class="lineno"> 857</span>  </div>
<div class="line"><a name="l00858"></a><span class="lineno"> 858</span>  <a class="code" href="structQureg.html">Qureg</a> vec3 = <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="l00859"></a><span class="lineno"> 859</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga374ad70804998394ae41ebfe106258a6">calcInnerProduct</a>(vec1,vec3), Contains(<span class="stringliteral">"Dimensions"</span>) && Contains(<span class="stringliteral">"don't match"</span>) );</div>
<div class="line"><a name="l00860"></a><span class="lineno"> 860</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(vec3, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00861"></a><span class="lineno"> 861</span>  }</div>
<div class="line"><a name="l00862"></a><span class="lineno"> 862</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</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>  <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="l00865"></a><span class="lineno"> 865</span>  </div>
<div class="line"><a name="l00866"></a><span class="lineno"> 866</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga374ad70804998394ae41ebfe106258a6">calcInnerProduct</a>(vec1,mat), Contains(<span class="stringliteral">"valid only for state-vectors"</span>) );</div>
<div class="line"><a name="l00867"></a><span class="lineno"> 867</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga374ad70804998394ae41ebfe106258a6">calcInnerProduct</a>(mat,vec1), Contains(<span class="stringliteral">"valid only for state-vectors"</span>) );</div>
<div class="line"><a name="l00868"></a><span class="lineno"> 868</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga374ad70804998394ae41ebfe106258a6">calcInnerProduct</a>(mat,mat), Contains(<span class="stringliteral">"valid only for state-vectors"</span>) );</div>
<div class="line"><a name="l00869"></a><span class="lineno"> 869</span>  </div>
<div class="line"><a name="l00870"></a><span class="lineno"> 870</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="l00871"></a><span class="lineno"> 871</span>  }</div>
<div class="line"><a name="l00872"></a><span class="lineno"> 872</span>  }</div>
<div class="line"><a name="l00873"></a><span class="lineno"> 873</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(vec1, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00874"></a><span class="lineno"> 874</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(vec2, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00875"></a><span class="lineno"> 875</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l01150">calcInnerProduct()</a>, <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00435">getRandomQVector()</a>, <a class="el" href="utilities_8cpp_source.html#l00468">getRandomStateVector()</a>, <a class="el" href="QuEST_8h_source.html#l00106">Complex::imag</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, <a class="el" href="QuEST_8h_source.html#l00105">Complex::real</a>, and <a class="el" href="utilities_8cpp_source.html#l01201">toQureg()</a>.</p>
</div>
</div>
<a id="ga94b593526f4f9a58b9d15b6c1c00f039"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga94b593526f4f9a58b9d15b6c1c00f039">◆ </a></span>TEST_CASE() <span class="overload">[28/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"calcProbOfAllOutcomes" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[calculations] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__calc.html#gad0cc08d52cad5062553d6f78126780cc" title="Populates outcomeProbs with the probabilities of every outcome of the sub-register contained in qubit...">calcProbOfAllOutcomes</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__calculations_8cpp_source.html#l00883">883</a> of file <a class="el" href="test__calculations_8cpp_source.html">test_calculations.cpp</a>.</p>
<div class="fragment"><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>  <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="l00886"></a><span class="lineno"> 886</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="l00887"></a><span class="lineno"> 887</span>  </div>
<div class="line"><a name="l00888"></a><span class="lineno"> 888</span>  SECTION( <span class="stringliteral">"correctness"</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">// generate all possible qubit arrangements</span></div>
<div class="line"><a name="l00891"></a><span class="lineno"> 891</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="l00892"></a><span class="lineno"> 892</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="l00893"></a><span class="lineno"> 893</span>  </div>
<div class="line"><a name="l00894"></a><span class="lineno"> 894</span>  <span class="keywordtype">int</span> numOutcomes = 1<<numQubits;</div>
<div class="line"><a name="l00895"></a><span class="lineno"> 895</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> probs[numOutcomes];</div>
<div class="line"><a name="l00896"></a><span class="lineno"> 896</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> refProbs = <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a>(numOutcomes);</div>
<div class="line"><a name="l00897"></a><span class="lineno"> 897</span>  </div>
<div class="line"><a name="l00898"></a><span class="lineno"> 898</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00899"></a><span class="lineno"> 899</span>  </div>
<div class="line"><a name="l00900"></a><span class="lineno"> 900</span>  SECTION( <span class="stringliteral">"normalised"</span> ) {</div>
<div class="line"><a name="l00901"></a><span class="lineno"> 901</span>  </div>
<div class="line"><a name="l00902"></a><span class="lineno"> 902</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> ref = <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="l00903"></a><span class="lineno"> 903</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(vec, ref);</div>
<div class="line"><a name="l00904"></a><span class="lineno"> 904</span>  </div>
<div class="line"><a name="l00905"></a><span class="lineno"> 905</span>  <span class="comment">// prob is sum of |amp|^2 of basis states which encode outcome</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<ref.size(); i++) {</div>
<div class="line"><a name="l00907"></a><span class="lineno"> 907</span>  <span class="keywordtype">int</span> outcome = 0;</div>
<div class="line"><a name="l00908"></a><span class="lineno"> 908</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> q=0; q<numQubits; q++) {</div>
<div class="line"><a name="l00909"></a><span class="lineno"> 909</span>  <span class="keywordtype">int</span> bit = (i >> qubits[q]) & 1;</div>
<div class="line"><a name="l00910"></a><span class="lineno"> 910</span>  outcome += bit * (1 << q);</div>
<div class="line"><a name="l00911"></a><span class="lineno"> 911</span>  }</div>
<div class="line"><a name="l00912"></a><span class="lineno"> 912</span>  refProbs[outcome] += pow(abs(ref[i]), 2);</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>  </div>
<div class="line"><a name="l00915"></a><span class="lineno"> 915</span>  <a class="code" href="group__calc.html#gad0cc08d52cad5062553d6f78126780cc">calcProbOfAllOutcomes</a>(probs, vec, qubits, numQubits);</div>
<div class="line"><a name="l00916"></a><span class="lineno"> 916</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(refProbs, probs) );</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>  SECTION( <span class="stringliteral">"unnormalised"</span> ) {</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>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> ref = <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="l00921"></a><span class="lineno"> 921</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(vec, ref);</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>  <span class="comment">// prob is sum of |amp|^2 of basis states which encode outcome</span></div>
<div class="line"><a name="l00924"></a><span class="lineno"> 924</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<ref.size(); i++) {</div>
<div class="line"><a name="l00925"></a><span class="lineno"> 925</span>  <span class="keywordtype">int</span> outcome = 0;</div>
<div class="line"><a name="l00926"></a><span class="lineno"> 926</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> q=0; q<numQubits; q++) {</div>
<div class="line"><a name="l00927"></a><span class="lineno"> 927</span>  <span class="keywordtype">int</span> bit = (i >> qubits[q]) & 1;</div>
<div class="line"><a name="l00928"></a><span class="lineno"> 928</span>  outcome += bit * (1 << q);</div>
<div class="line"><a name="l00929"></a><span class="lineno"> 929</span>  }</div>
<div class="line"><a name="l00930"></a><span class="lineno"> 930</span>  refProbs[outcome] += pow(abs(ref[i]), 2);</div>
<div class="line"><a name="l00931"></a><span class="lineno"> 931</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__calc.html#gad0cc08d52cad5062553d6f78126780cc">calcProbOfAllOutcomes</a>(probs, vec, qubits, numQubits);</div>
<div class="line"><a name="l00934"></a><span class="lineno"> 934</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(refProbs, probs) );</div>
<div class="line"><a name="l00935"></a><span class="lineno"> 935</span>  }</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>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00938"></a><span class="lineno"> 938</span>  </div>
<div class="line"><a name="l00939"></a><span class="lineno"> 939</span>  SECTION( <span class="stringliteral">"normalised"</span> ) {</div>
<div class="line"><a name="l00940"></a><span class="lineno"> 940</span>  </div>
<div class="line"><a name="l00941"></a><span class="lineno"> 941</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> ref = <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="l00942"></a><span class="lineno"> 942</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat, ref);</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>  <span class="comment">// prob is sum of diagonals which encode outcome </span></div>
<div class="line"><a name="l00945"></a><span class="lineno"> 945</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<ref.size(); i++) {</div>
<div class="line"><a name="l00946"></a><span class="lineno"> 946</span>  <span class="keywordtype">int</span> outcome = 0;</div>
<div class="line"><a name="l00947"></a><span class="lineno"> 947</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> q=0; q<numQubits; q++) {</div>
<div class="line"><a name="l00948"></a><span class="lineno"> 948</span>  <span class="keywordtype">int</span> bit = (i >> qubits[q]) & 1;</div>
<div class="line"><a name="l00949"></a><span class="lineno"> 949</span>  outcome += bit * (1 << q);</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>  refProbs[outcome] += real(ref[i][i]);</div>
<div class="line"><a name="l00952"></a><span class="lineno"> 952</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>  <a class="code" href="group__calc.html#gad0cc08d52cad5062553d6f78126780cc">calcProbOfAllOutcomes</a>(probs, mat, qubits, numQubits);</div>
<div class="line"><a name="l00955"></a><span class="lineno"> 955</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(refProbs, probs) );</div>
<div class="line"><a name="l00956"></a><span class="lineno"> 956</span>  }</div>
<div class="line"><a name="l00957"></a><span class="lineno"> 957</span>  SECTION( <span class="stringliteral">"unnormalised"</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>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> ref = <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="l00960"></a><span class="lineno"> 960</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat, ref);</div>
<div class="line"><a name="l00961"></a><span class="lineno"> 961</span>  </div>
<div class="line"><a name="l00962"></a><span class="lineno"> 962</span>  <span class="comment">// prob is sum of diagonals which encode outcome </span></div>
<div class="line"><a name="l00963"></a><span class="lineno"> 963</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<ref.size(); i++) {</div>
<div class="line"><a name="l00964"></a><span class="lineno"> 964</span>  <span class="keywordtype">int</span> outcome = 0;</div>
<div class="line"><a name="l00965"></a><span class="lineno"> 965</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> q=0; q<numQubits; q++) {</div>
<div class="line"><a name="l00966"></a><span class="lineno"> 966</span>  <span class="keywordtype">int</span> bit = (i >> qubits[q]) & 1;</div>
<div class="line"><a name="l00967"></a><span class="lineno"> 967</span>  outcome += bit * (1 << q);</div>
<div class="line"><a name="l00968"></a><span class="lineno"> 968</span>  }</div>
<div class="line"><a name="l00969"></a><span class="lineno"> 969</span>  refProbs[outcome] += real(ref[i][i]);</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>  </div>
<div class="line"><a name="l00972"></a><span class="lineno"> 972</span>  <a class="code" href="group__calc.html#gad0cc08d52cad5062553d6f78126780cc">calcProbOfAllOutcomes</a>(probs, mat, qubits, numQubits);</div>
<div class="line"><a name="l00973"></a><span class="lineno"> 973</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(refProbs, probs) );</div>
<div class="line"><a name="l00974"></a><span class="lineno"> 974</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>  }</div>
<div class="line"><a name="l00977"></a><span class="lineno"> 977</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00978"></a><span class="lineno"> 978</span>  </div>
<div class="line"><a name="l00979"></a><span class="lineno"> 979</span>  <span class="keywordtype">int</span> numQubits = 3;</div>
<div class="line"><a name="l00980"></a><span class="lineno"> 980</span>  <span class="keywordtype">int</span> qubits[] = {0, 1, 2};</div>
<div class="line"><a name="l00981"></a><span class="lineno"> 981</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> probs[8];</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>  SECTION( <span class="stringliteral">"number of qubits"</span> ) {</div>
<div class="line"><a name="l00984"></a><span class="lineno"> 984</span>  </div>
<div class="line"><a name="l00985"></a><span class="lineno"> 985</span>  numQubits = GENERATE( -1, 0, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1 );</div>
<div class="line"><a name="l00986"></a><span class="lineno"> 986</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#gad0cc08d52cad5062553d6f78126780cc">calcProbOfAllOutcomes</a>(probs, mat, qubits, numQubits), Contains(<span class="stringliteral">"Invalid number of target qubits"</span>) );</div>
<div class="line"><a name="l00987"></a><span class="lineno"> 987</span>  }</div>
<div class="line"><a name="l00988"></a><span class="lineno"> 988</span>  SECTION( <span class="stringliteral">"qubit indices"</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>  qubits[GENERATE_COPY(range(0,numQubits))] = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l00991"></a><span class="lineno"> 991</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#gad0cc08d52cad5062553d6f78126780cc">calcProbOfAllOutcomes</a>(probs, mat, qubits, numQubits), Contains(<span class="stringliteral">"Invalid target qubit"</span>) );</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">"repetition of qubits"</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>  qubits[GENERATE_COPY(1,2)] = qubits[0];</div>
<div class="line"><a name="l00996"></a><span class="lineno"> 996</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#gad0cc08d52cad5062553d6f78126780cc">calcProbOfAllOutcomes</a>(probs, mat, qubits, numQubits), Contains(<span class="stringliteral">"qubits must be unique"</span>) );</div>
<div class="line"><a name="l00997"></a><span class="lineno"> 997</span>  }</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>  <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="l01000"></a><span class="lineno"> 1000</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="l01001"></a><span class="lineno"> 1001</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l01176">calcProbOfAllOutcomes()</a>, <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00490">getRandomDensityMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00379">getRandomQMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00435">getRandomQVector()</a>, <a class="el" href="utilities_8cpp_source.html#l00468">getRandomStateVector()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, <a class="el" href="utilities_8cpp_source.html#l01488">sublists()</a>, and <a class="el" href="utilities_8cpp_source.html#l01201">toQureg()</a>.</p>
</div>
</div>
<a id="ga9360d80704ffa985e33a131fc3821d9c"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga9360d80704ffa985e33a131fc3821d9c">◆ </a></span>TEST_CASE() <span class="overload">[29/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"calcProbOfOutcome" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[calculations] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__calc.html#ga2a7946e6fa4f44c9ae0c6c9f683229ad" title="Gives the probability of a specified qubit being measured in the given outcome (0 or 1).">calcProbOfOutcome</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__calculations_8cpp_source.html#l01010">1010</a> of file <a class="el" href="test__calculations_8cpp_source.html">test_calculations.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l01010"></a><span class="lineno"> 1010</span>  {</div>
<div class="line"><a name="l01011"></a><span class="lineno"> 1011</span>  </div>
<div class="line"><a name="l01012"></a><span class="lineno"> 1012</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="l01013"></a><span class="lineno"> 1013</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="l01014"></a><span class="lineno"> 1014</span>  </div>
<div class="line"><a name="l01015"></a><span class="lineno"> 1015</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l01016"></a><span class="lineno"> 1016</span>  </div>
<div class="line"><a name="l01017"></a><span class="lineno"> 1017</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="l01018"></a><span class="lineno"> 1018</span>  <span class="keywordtype">int</span> outcome = GENERATE( 0, 1 );</div>
<div class="line"><a name="l01019"></a><span class="lineno"> 1019</span>  </div>
<div class="line"><a name="l01020"></a><span class="lineno"> 1020</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l01021"></a><span class="lineno"> 1021</span>  </div>
<div class="line"><a name="l01022"></a><span class="lineno"> 1022</span>  SECTION( <span class="stringliteral">"normalised"</span> ) {</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>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> ref = <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="l01025"></a><span class="lineno"> 1025</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(vec, ref);</div>
<div class="line"><a name="l01026"></a><span class="lineno"> 1026</span>  </div>
<div class="line"><a name="l01027"></a><span class="lineno"> 1027</span>  <span class="comment">// prob is sum of |amp|^2 of amplitudes where target bit is outcome</span></div>
<div class="line"><a name="l01028"></a><span class="lineno"> 1028</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> prob = 0;</div>
<div class="line"><a name="l01029"></a><span class="lineno"> 1029</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> ind=0; ind<ref.size(); ind++) {</div>
<div class="line"><a name="l01030"></a><span class="lineno"> 1030</span>  <span class="keywordtype">int</span> bit = (ind >> target) & 1; <span class="comment">// target-th bit</span></div>
<div class="line"><a name="l01031"></a><span class="lineno"> 1031</span>  <span class="keywordflow">if</span> (bit == outcome)</div>
<div class="line"><a name="l01032"></a><span class="lineno"> 1032</span>  prob += pow(abs(ref[ind]), 2);</div>
<div class="line"><a name="l01033"></a><span class="lineno"> 1033</span>  }</div>
<div class="line"><a name="l01034"></a><span class="lineno"> 1034</span>  </div>
<div class="line"><a name="l01035"></a><span class="lineno"> 1035</span>  REQUIRE( <a class="code" href="group__calc.html#ga2a7946e6fa4f44c9ae0c6c9f683229ad">calcProbOfOutcome</a>(vec, target, outcome) == Approx(prob) );</div>
<div class="line"><a name="l01036"></a><span class="lineno"> 1036</span>  }</div>
<div class="line"><a name="l01037"></a><span class="lineno"> 1037</span>  SECTION( <span class="stringliteral">"unnormalised"</span> ) {</div>
<div class="line"><a name="l01038"></a><span class="lineno"> 1038</span>  </div>
<div class="line"><a name="l01039"></a><span class="lineno"> 1039</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> ref = <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="l01040"></a><span class="lineno"> 1040</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(vec, ref);</div>
<div class="line"><a name="l01041"></a><span class="lineno"> 1041</span>  </div>
<div class="line"><a name="l01042"></a><span class="lineno"> 1042</span>  <span class="comment">// prob is (sum of |amp|^2 of amplitudes where target bit is zero)</span></div>
<div class="line"><a name="l01043"></a><span class="lineno"> 1043</span>  <span class="comment">// or 1 - (this) if outcome == 1</span></div>
<div class="line"><a name="l01044"></a><span class="lineno"> 1044</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> prob = 0;</div>
<div class="line"><a name="l01045"></a><span class="lineno"> 1045</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> ind=0; ind<ref.size(); ind++) {</div>
<div class="line"><a name="l01046"></a><span class="lineno"> 1046</span>  <span class="keywordtype">int</span> bit = (ind >> target) & 1; <span class="comment">// target-th bit</span></div>
<div class="line"><a name="l01047"></a><span class="lineno"> 1047</span>  <span class="keywordflow">if</span> (bit == 0)</div>
<div class="line"><a name="l01048"></a><span class="lineno"> 1048</span>  prob += pow(abs(ref[ind]), 2);</div>
<div class="line"><a name="l01049"></a><span class="lineno"> 1049</span>  }</div>
<div class="line"><a name="l01050"></a><span class="lineno"> 1050</span>  <span class="keywordflow">if</span> (outcome == 1)</div>
<div class="line"><a name="l01051"></a><span class="lineno"> 1051</span>  prob = 1 - prob;</div>
<div class="line"><a name="l01052"></a><span class="lineno"> 1052</span>  </div>
<div class="line"><a name="l01053"></a><span class="lineno"> 1053</span>  REQUIRE( <a class="code" href="group__calc.html#ga2a7946e6fa4f44c9ae0c6c9f683229ad">calcProbOfOutcome</a>(vec, target, outcome) == Approx(prob) );</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>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01057"></a><span class="lineno"> 1057</span>  </div>
<div class="line"><a name="l01058"></a><span class="lineno"> 1058</span>  SECTION( <span class="stringliteral">"pure"</span> ) {</div>
<div class="line"><a name="l01059"></a><span class="lineno"> 1059</span>  </div>
<div class="line"><a name="l01060"></a><span class="lineno"> 1060</span>  <span class="comment">// set mat to a random |r><r|</span></div>
<div class="line"><a name="l01061"></a><span class="lineno"> 1061</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> ref = <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="l01062"></a><span class="lineno"> 1062</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat, <a class="code" href="group__testutilities.html#ga2de7d3b138728b6beb7753b82df61803">getKetBra</a>(ref, ref));</div>
<div class="line"><a name="l01063"></a><span class="lineno"> 1063</span>  </div>
<div class="line"><a name="l01064"></a><span class="lineno"> 1064</span>  <span class="comment">// calc prob of the state-vector</span></div>
<div class="line"><a name="l01065"></a><span class="lineno"> 1065</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> prob = 0;</div>
<div class="line"><a name="l01066"></a><span class="lineno"> 1066</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> ind=0; ind<ref.size(); ind++) {</div>
<div class="line"><a name="l01067"></a><span class="lineno"> 1067</span>  <span class="keywordtype">int</span> bit = (ind >> target) & 1; <span class="comment">// target-th bit</span></div>
<div class="line"><a name="l01068"></a><span class="lineno"> 1068</span>  <span class="keywordflow">if</span> (bit == outcome)</div>
<div class="line"><a name="l01069"></a><span class="lineno"> 1069</span>  prob += pow(abs(ref[ind]), 2);</div>
<div class="line"><a name="l01070"></a><span class="lineno"> 1070</span>  }</div>
<div class="line"><a name="l01071"></a><span class="lineno"> 1071</span>  </div>
<div class="line"><a name="l01072"></a><span class="lineno"> 1072</span>  REQUIRE( <a class="code" href="group__calc.html#ga2a7946e6fa4f44c9ae0c6c9f683229ad">calcProbOfOutcome</a>(mat, target, outcome) == Approx(prob) );</div>
<div class="line"><a name="l01073"></a><span class="lineno"> 1073</span>  }</div>
<div class="line"><a name="l01074"></a><span class="lineno"> 1074</span>  SECTION( <span class="stringliteral">"mixed"</span> ) {</div>
<div class="line"><a name="l01075"></a><span class="lineno"> 1075</span>  </div>
<div class="line"><a name="l01076"></a><span class="lineno"> 1076</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> ref = <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="l01077"></a><span class="lineno"> 1077</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat, ref);</div>
<div class="line"><a name="l01078"></a><span class="lineno"> 1078</span>  </div>
<div class="line"><a name="l01079"></a><span class="lineno"> 1079</span>  <span class="comment">// prob is sum of diagonal amps (should be real) where target bit is outcome</span></div>
<div class="line"><a name="l01080"></a><span class="lineno"> 1080</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> tr = 0;</div>
<div class="line"><a name="l01081"></a><span class="lineno"> 1081</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> ind=0; ind<ref.size(); ind++) {</div>
<div class="line"><a name="l01082"></a><span class="lineno"> 1082</span>  <span class="keywordtype">int</span> bit = (ind >> target) & 1; <span class="comment">// target-th bit</span></div>
<div class="line"><a name="l01083"></a><span class="lineno"> 1083</span>  <span class="keywordflow">if</span> (bit == outcome)</div>
<div class="line"><a name="l01084"></a><span class="lineno"> 1084</span>  tr += ref[ind][ind];</div>
<div class="line"><a name="l01085"></a><span class="lineno"> 1085</span>  }</div>
<div class="line"><a name="l01086"></a><span class="lineno"> 1086</span>  REQUIRE( imag(tr) == Approx(0).margin(REAL_EPS) );</div>
<div class="line"><a name="l01087"></a><span class="lineno"> 1087</span>  </div>
<div class="line"><a name="l01088"></a><span class="lineno"> 1088</span>  REQUIRE( <a class="code" href="group__calc.html#ga2a7946e6fa4f44c9ae0c6c9f683229ad">calcProbOfOutcome</a>(mat, target, outcome) == Approx(real(tr)) );</div>
<div class="line"><a name="l01089"></a><span class="lineno"> 1089</span>  }</div>
<div class="line"><a name="l01090"></a><span class="lineno"> 1090</span>  SECTION( <span class="stringliteral">"unnormalised"</span> ) {</div>
<div class="line"><a name="l01091"></a><span class="lineno"> 1091</span>  </div>
<div class="line"><a name="l01092"></a><span class="lineno"> 1092</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> ref = <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="l01093"></a><span class="lineno"> 1093</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat, ref);</div>
<div class="line"><a name="l01094"></a><span class="lineno"> 1094</span>  </div>
<div class="line"><a name="l01095"></a><span class="lineno"> 1095</span>  <span class="comment">// prob is (sum of real of diagonal amps where target bit is outcome)</span></div>
<div class="line"><a name="l01096"></a><span class="lineno"> 1096</span>  <span class="comment">// or 1 - (this) if outcome == 1</span></div>
<div class="line"><a name="l01097"></a><span class="lineno"> 1097</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> tr = 0;</div>
<div class="line"><a name="l01098"></a><span class="lineno"> 1098</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> ind=0; ind<ref.size(); ind++) {</div>
<div class="line"><a name="l01099"></a><span class="lineno"> 1099</span>  <span class="keywordtype">int</span> bit = (ind >> target) & 1; <span class="comment">// target-th bit</span></div>
<div class="line"><a name="l01100"></a><span class="lineno"> 1100</span>  <span class="keywordflow">if</span> (bit == 0)</div>
<div class="line"><a name="l01101"></a><span class="lineno"> 1101</span>  tr += real(ref[ind][ind]);</div>
<div class="line"><a name="l01102"></a><span class="lineno"> 1102</span>  }</div>
<div class="line"><a name="l01103"></a><span class="lineno"> 1103</span>  <span class="keywordflow">if</span> (outcome == 1)</div>
<div class="line"><a name="l01104"></a><span class="lineno"> 1104</span>  tr = 1 - tr;</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>  REQUIRE( <a class="code" href="group__calc.html#ga2a7946e6fa4f44c9ae0c6c9f683229ad">calcProbOfOutcome</a>(mat, target, outcome) == Approx(tr) );</div>
<div class="line"><a name="l01107"></a><span class="lineno"> 1107</span>  }</div>
<div class="line"><a name="l01108"></a><span class="lineno"> 1108</span>  }</div>
<div class="line"><a name="l01109"></a><span class="lineno"> 1109</span>  }</div>
<div class="line"><a name="l01110"></a><span class="lineno"> 1110</span>  SECTION( <span class="stringliteral">"input validation"</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>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l01113"></a><span class="lineno"> 1113</span>  </div>
<div class="line"><a name="l01114"></a><span class="lineno"> 1114</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="l01115"></a><span class="lineno"> 1115</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga2a7946e6fa4f44c9ae0c6c9f683229ad">calcProbOfOutcome</a>(vec, target, 0), Contains(<span class="stringliteral">"Invalid target qubit"</span>) );</div>
<div class="line"><a name="l01116"></a><span class="lineno"> 1116</span>  }</div>
<div class="line"><a name="l01117"></a><span class="lineno"> 1117</span>  SECTION( <span class="stringliteral">"outcome value"</span> ) {</div>
<div class="line"><a name="l01118"></a><span class="lineno"> 1118</span>  </div>
<div class="line"><a name="l01119"></a><span class="lineno"> 1119</span>  <span class="keywordtype">int</span> outcome = GENERATE( -1, 2 );</div>
<div class="line"><a name="l01120"></a><span class="lineno"> 1120</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga2a7946e6fa4f44c9ae0c6c9f683229ad">calcProbOfOutcome</a>(vec, 0, outcome), Contains(<span class="stringliteral">"Invalid measurement outcome"</span>) );</div>
<div class="line"><a name="l01121"></a><span class="lineno"> 1121</span>  }</div>
<div class="line"><a name="l01122"></a><span class="lineno"> 1122</span>  }</div>
<div class="line"><a name="l01123"></a><span class="lineno"> 1123</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="l01124"></a><span class="lineno"> 1124</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="l01125"></a><span class="lineno"> 1125</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l01166">calcProbOfOutcome()</a>, <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00169">getKetBra()</a>, <a class="el" href="utilities_8cpp_source.html#l00490">getRandomDensityMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00379">getRandomQMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00435">getRandomQVector()</a>, <a class="el" href="utilities_8cpp_source.html#l00468">getRandomStateVector()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, and <a class="el" href="utilities_8cpp_source.html#l01201">toQureg()</a>.</p>
</div>
</div>
<a id="gaf8e08b58f3e0d94166b600513224de63"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaf8e08b58f3e0d94166b600513224de63">◆ </a></span>TEST_CASE() <span class="overload">[30/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"calcPurity" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[calculations] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__calc.html#ga683779343fb2c6055f6b1d01079c2ede" title="Calculates the purity of a density matrix, by the trace of the density matrix squared.">calcPurity</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__calculations_8cpp_source.html#l01133">1133</a> of file <a class="el" href="test__calculations_8cpp_source.html">test_calculations.cpp</a>.</p>
<div class="fragment"><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>  </div>
<div class="line"><a name="l01135"></a><span class="lineno"> 1135</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="l01136"></a><span class="lineno"> 1136</span>  </div>
<div class="line"><a name="l01137"></a><span class="lineno"> 1137</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l01138"></a><span class="lineno"> 1138</span>  </div>
<div class="line"><a name="l01139"></a><span class="lineno"> 1139</span>  <span class="comment">// perform the following random tests 10 times </span></div>
<div class="line"><a name="l01140"></a><span class="lineno"> 1140</span>  GENERATE( range(1,10) );</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">"density-matrix"</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>  SECTION( <span class="stringliteral">"pure"</span> ) {</div>
<div class="line"><a name="l01145"></a><span class="lineno"> 1145</span>  </div>
<div class="line"><a name="l01146"></a><span class="lineno"> 1146</span>  <span class="comment">// pure states have unity purity </span></div>
<div class="line"><a name="l01147"></a><span class="lineno"> 1147</span>  <a class="code" href="group__init.html#ga2f049055d4a51d0ea4d1a43b5234dedb">initZeroState</a>(mat);</div>
<div class="line"><a name="l01148"></a><span class="lineno"> 1148</span>  REQUIRE( <a class="code" href="group__calc.html#ga683779343fb2c6055f6b1d01079c2ede">calcPurity</a>(mat) == 1 );</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>  <span class="comment">// (try also a pure random L2-vector)</span></div>
<div class="line"><a name="l01151"></a><span class="lineno"> 1151</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> r1 = <a class="code" href="group__testutilities.html#gae1d2eb70b50267f8186cbd53e300d94f">getRandomStateVector</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>); <span class="comment">// |r></span></div>
<div class="line"><a name="l01152"></a><span class="lineno"> 1152</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> m1 = <a class="code" href="group__testutilities.html#ga2de7d3b138728b6beb7753b82df61803">getKetBra</a>(r1, r1); <span class="comment">// |r><r|</span></div>
<div class="line"><a name="l01153"></a><span class="lineno"> 1153</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat, m1);</div>
<div class="line"><a name="l01154"></a><span class="lineno"> 1154</span>  REQUIRE( <a class="code" href="group__calc.html#ga683779343fb2c6055f6b1d01079c2ede">calcPurity</a>(mat) == Approx(1) );</div>
<div class="line"><a name="l01155"></a><span class="lineno"> 1155</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>  SECTION( <span class="stringliteral">"mixed"</span> ) {</div>
<div class="line"><a name="l01158"></a><span class="lineno"> 1158</span>  </div>
<div class="line"><a name="l01159"></a><span class="lineno"> 1159</span>  <span class="comment">// mixed states have 1/2^N < purity < 1</span></div>
<div class="line"><a name="l01160"></a><span class="lineno"> 1160</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> ref = <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="l01161"></a><span class="lineno"> 1161</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat, ref);</div>
<div class="line"><a name="l01162"></a><span class="lineno"> 1162</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> purity = <a class="code" href="group__calc.html#ga683779343fb2c6055f6b1d01079c2ede">calcPurity</a>(mat);</div>
<div class="line"><a name="l01163"></a><span class="lineno"> 1163</span>  REQUIRE( purity < 1 );</div>
<div class="line"><a name="l01164"></a><span class="lineno"> 1164</span>  REQUIRE( purity >= 1/pow(2.,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) );</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>  <span class="comment">// compare to Tr(rho^2)</span></div>
<div class="line"><a name="l01167"></a><span class="lineno"> 1167</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> prod = ref*ref;</div>
<div class="line"><a name="l01168"></a><span class="lineno"> 1168</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> tr = 0;</div>
<div class="line"><a name="l01169"></a><span class="lineno"> 1169</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<prod.size(); i++)</div>
<div class="line"><a name="l01170"></a><span class="lineno"> 1170</span>  tr += real(prod[i][i]);</div>
<div class="line"><a name="l01171"></a><span class="lineno"> 1171</span>  REQUIRE( purity == Approx(tr) );</div>
<div class="line"><a name="l01172"></a><span class="lineno"> 1172</span>  }</div>
<div class="line"><a name="l01173"></a><span class="lineno"> 1173</span>  SECTION( <span class="stringliteral">"unnormalised"</span> ) {</div>
<div class="line"><a name="l01174"></a><span class="lineno"> 1174</span>  </div>
<div class="line"><a name="l01175"></a><span class="lineno"> 1175</span>  <span class="comment">// unphysical states give sum_{ij} |rho_ij|^2</span></div>
<div class="line"><a name="l01176"></a><span class="lineno"> 1176</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> ref = <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="l01177"></a><span class="lineno"> 1177</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> tot = 0;</div>
<div class="line"><a name="l01178"></a><span class="lineno"> 1178</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<ref.size(); i++)</div>
<div class="line"><a name="l01179"></a><span class="lineno"> 1179</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> j=0; j<ref.size(); j++)</div>
<div class="line"><a name="l01180"></a><span class="lineno"> 1180</span>  tot += pow(abs(ref[i][j]), 2);</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>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat, ref);</div>
<div class="line"><a name="l01183"></a><span class="lineno"> 1183</span>  REQUIRE( <a class="code" href="group__calc.html#ga683779343fb2c6055f6b1d01079c2ede">calcPurity</a>(mat) == Approx(tot) );</div>
<div class="line"><a name="l01184"></a><span class="lineno"> 1184</span>  }</div>
<div class="line"><a name="l01185"></a><span class="lineno"> 1185</span>  }</div>
<div class="line"><a name="l01186"></a><span class="lineno"> 1186</span>  }</div>
<div class="line"><a name="l01187"></a><span class="lineno"> 1187</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</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>  SECTION( <span class="stringliteral">"state-vector"</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>  <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="l01192"></a><span class="lineno"> 1192</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga683779343fb2c6055f6b1d01079c2ede">calcPurity</a>(vec), Contains(<span class="stringliteral">"valid only for density matrices"</span>) );</div>
<div class="line"><a name="l01193"></a><span class="lineno"> 1193</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="l01194"></a><span class="lineno"> 1194</span>  }</div>
<div class="line"><a name="l01195"></a><span class="lineno"> 1195</span>  }</div>
<div class="line"><a name="l01196"></a><span class="lineno"> 1196</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="l01197"></a><span class="lineno"> 1197</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l01185">calcPurity()</a>, <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00169">getKetBra()</a>, <a class="el" href="utilities_8cpp_source.html#l00490">getRandomDensityMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00379">getRandomQMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00468">getRandomStateVector()</a>, <a class="el" href="QuEST_8c_source.html#l00113">initZeroState()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, and <a class="el" href="utilities_8cpp_source.html#l01201">toQureg()</a>.</p>
</div>
</div>
<a id="ga841339ebf8e009dca360aeb0fcc51acc"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga841339ebf8e009dca360aeb0fcc51acc">◆ </a></span>TEST_CASE() <span class="overload">[31/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"calcTotalProb" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[calculations] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__calc.html#gab082910d33473ec29e1d5852943de468" title="A debugging function which calculates the probability of the qubits in qureg being in any state,...">calcTotalProb</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__calculations_8cpp_source.html#l01205">1205</a> of file <a class="el" href="test__calculations_8cpp_source.html">test_calculations.cpp</a>.</p>
<div class="fragment"><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>  <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="l01208"></a><span class="lineno"> 1208</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="l01209"></a><span class="lineno"> 1209</span>  </div>
<div class="line"><a name="l01210"></a><span class="lineno"> 1210</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l01211"></a><span class="lineno"> 1211</span>  </div>
<div class="line"><a name="l01212"></a><span class="lineno"> 1212</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l01213"></a><span class="lineno"> 1213</span>  </div>
<div class="line"><a name="l01214"></a><span class="lineno"> 1214</span>  <span class="comment">// normalised: prob(vec) = 1</span></div>
<div class="line"><a name="l01215"></a><span class="lineno"> 1215</span>  <a class="code" href="group__init.html#ga234bd34016f08288532791903b9884b5">initPlusState</a>(vec);</div>
<div class="line"><a name="l01216"></a><span class="lineno"> 1216</span>  REQUIRE( <a class="code" href="group__calc.html#gab082910d33473ec29e1d5852943de468">calcTotalProb</a>(vec) == Approx(1) );</div>
<div class="line"><a name="l01217"></a><span class="lineno"> 1217</span>  </div>
<div class="line"><a name="l01218"></a><span class="lineno"> 1218</span>  <span class="comment">// zero norm: prob(vec) = 0</span></div>
<div class="line"><a name="l01219"></a><span class="lineno"> 1219</span>  <a class="code" href="group__init.html#gada7230491a50cd409f8b00f5ee1db953">initBlankState</a>(vec);</div>
<div class="line"><a name="l01220"></a><span class="lineno"> 1220</span>  REQUIRE( <a class="code" href="group__calc.html#gab082910d33473ec29e1d5852943de468">calcTotalProb</a>(vec) == 0 );</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>  <span class="comment">// random L2 state: prob(vec) = 1</span></div>
<div class="line"><a name="l01223"></a><span class="lineno"> 1223</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(vec, <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="l01224"></a><span class="lineno"> 1224</span>  REQUIRE( <a class="code" href="group__calc.html#gab082910d33473ec29e1d5852943de468">calcTotalProb</a>(vec) == Approx(1) );</div>
<div class="line"><a name="l01225"></a><span class="lineno"> 1225</span>  </div>
<div class="line"><a name="l01226"></a><span class="lineno"> 1226</span>  <span class="comment">// unnormalised: prob(vec) = sum_i |vec_i|^2</span></div>
<div class="line"><a name="l01227"></a><span class="lineno"> 1227</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(vec);</div>
<div class="line"><a name="l01228"></a><span class="lineno"> 1228</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> ref = <a class="code" href="group__testutilities.html#gade0e7c37811a69f1c21c88c11943a19f">toQVector</a>(vec);</div>
<div class="line"><a name="l01229"></a><span class="lineno"> 1229</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> refProb = 0;</div>
<div class="line"><a name="l01230"></a><span class="lineno"> 1230</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<ref.size(); i++)</div>
<div class="line"><a name="l01231"></a><span class="lineno"> 1231</span>  refProb += pow(abs(ref[i]), 2);</div>
<div class="line"><a name="l01232"></a><span class="lineno"> 1232</span>  REQUIRE( <a class="code" href="group__calc.html#gab082910d33473ec29e1d5852943de468">calcTotalProb</a>(vec) == Approx(refProb) );</div>
<div class="line"><a name="l01233"></a><span class="lineno"> 1233</span>  }</div>
<div class="line"><a name="l01234"></a><span class="lineno"> 1234</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01235"></a><span class="lineno"> 1235</span>  </div>
<div class="line"><a name="l01236"></a><span class="lineno"> 1236</span>  <span class="comment">// normalised: prob(mat) = 1</span></div>
<div class="line"><a name="l01237"></a><span class="lineno"> 1237</span>  <a class="code" href="group__init.html#ga234bd34016f08288532791903b9884b5">initPlusState</a>(mat);</div>
<div class="line"><a name="l01238"></a><span class="lineno"> 1238</span>  REQUIRE( <a class="code" href="group__calc.html#gab082910d33473ec29e1d5852943de468">calcTotalProb</a>(mat) == Approx(1) );</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>  <span class="comment">// zero norm: prob(mat) = 0</span></div>
<div class="line"><a name="l01241"></a><span class="lineno"> 1241</span>  <a class="code" href="group__init.html#gada7230491a50cd409f8b00f5ee1db953">initBlankState</a>(mat);</div>
<div class="line"><a name="l01242"></a><span class="lineno"> 1242</span>  REQUIRE( <a class="code" href="group__calc.html#gab082910d33473ec29e1d5852943de468">calcTotalProb</a>(mat) == 0 );</div>
<div class="line"><a name="l01243"></a><span class="lineno"> 1243</span>  </div>
<div class="line"><a name="l01244"></a><span class="lineno"> 1244</span>  <span class="comment">// random density matrix: prob(mat) = 1</span></div>
<div class="line"><a name="l01245"></a><span class="lineno"> 1245</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat, <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="l01246"></a><span class="lineno"> 1246</span>  REQUIRE( <a class="code" href="group__calc.html#gab082910d33473ec29e1d5852943de468">calcTotalProb</a>(mat) == Approx(1) );</div>
<div class="line"><a name="l01247"></a><span class="lineno"> 1247</span>  </div>
<div class="line"><a name="l01248"></a><span class="lineno"> 1248</span>  <span class="comment">// unnormalised: prob(mat) = sum_i real(mat_{ii})</span></div>
<div class="line"><a name="l01249"></a><span class="lineno"> 1249</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(mat);</div>
<div class="line"><a name="l01250"></a><span class="lineno"> 1250</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> ref = <a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(mat);</div>
<div class="line"><a name="l01251"></a><span class="lineno"> 1251</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> refProb = 0;</div>
<div class="line"><a name="l01252"></a><span class="lineno"> 1252</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<ref.size(); i++)</div>
<div class="line"><a name="l01253"></a><span class="lineno"> 1253</span>  refProb += real(ref[i][i]);</div>
<div class="line"><a name="l01254"></a><span class="lineno"> 1254</span>  REQUIRE( <a class="code" href="group__calc.html#gab082910d33473ec29e1d5852943de468">calcTotalProb</a>(mat) == Approx(refProb) );</div>
<div class="line"><a name="l01255"></a><span class="lineno"> 1255</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>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l01258"></a><span class="lineno"> 1258</span>  </div>
<div class="line"><a name="l01259"></a><span class="lineno"> 1259</span>  <span class="comment">// no validation </span></div>
<div class="line"><a name="l01260"></a><span class="lineno"> 1260</span>  SUCCEED();</div>
<div class="line"><a name="l01261"></a><span class="lineno"> 1261</span>  }</div>
<div class="line"><a name="l01262"></a><span class="lineno"> 1262</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="l01263"></a><span class="lineno"> 1263</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="l01264"></a><span class="lineno"> 1264</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l01143">calcTotalProb()</a>, <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00490">getRandomDensityMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00468">getRandomStateVector()</a>, <a class="el" href="QuEST_8c_source.html#l00119">initBlankState()</a>, <a class="el" href="QuEST_8c_source.html#l01578">initDebugState()</a>, <a class="el" href="QuEST_8c_source.html#l00125">initPlusState()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, <a class="el" href="utilities_8cpp_source.html#l01044">toQMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l01201">toQureg()</a>, and <a class="el" href="utilities_8cpp_source.html#l01113">toQVector()</a>.</p>
</div>
</div>
<a id="ga13e82817429e0c055b01df8328ea25e9"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga13e82817429e0c055b01df8328ea25e9">◆ </a></span>TEST_CASE() <span class="overload">[32/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"cloneQureg" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[state_initialisations] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__init.html#ga4534403b721977b669bff7bf4e37f0fb" title="Overwrite the amplitudes of targetQureg with those from copyQureg.">cloneQureg</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__state__initialisations_8cpp_source.html#l00015">15</a> of file <a class="el" href="test__state__initialisations_8cpp_source.html">test_state_initialisations.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00015"></a><span class="lineno"> 15</span>  {</div>
<div class="line"><a name="l00016"></a><span class="lineno"> 16</span>  </div>
<div class="line"><a name="l00017"></a><span class="lineno"> 17</span>  <a class="code" href="structQureg.html">Qureg</a> vec1 = <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="l00018"></a><span class="lineno"> 18</span>  <a class="code" href="structQureg.html">Qureg</a> mat1 = <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="l00019"></a><span class="lineno"> 19</span>  </div>
<div class="line"><a name="l00020"></a><span class="lineno"> 20</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00021"></a><span class="lineno"> 21</span>  </div>
<div class="line"><a name="l00022"></a><span class="lineno"> 22</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00023"></a><span class="lineno"> 23</span>  </div>
<div class="line"><a name="l00024"></a><span class="lineno"> 24</span>  <a class="code" href="structQureg.html">Qureg</a> vec2 = <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="l00025"></a><span class="lineno"> 25</span>  </div>
<div class="line"><a name="l00026"></a><span class="lineno"> 26</span>  <span class="comment">// make sure states start differently</span></div>
<div class="line"><a name="l00027"></a><span class="lineno"> 27</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(vec1); </div>
<div class="line"><a name="l00028"></a><span class="lineno"> 28</span>  <a class="code" href="group__init.html#gada7230491a50cd409f8b00f5ee1db953">initBlankState</a>(vec2);</div>
<div class="line"><a name="l00029"></a><span class="lineno"> 29</span>  REQUIRE( !<a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vec1, vec2) );</div>
<div class="line"><a name="l00030"></a><span class="lineno"> 30</span>  </div>
<div class="line"><a name="l00031"></a><span class="lineno"> 31</span>  <span class="comment">// make sure vec2 is changed</span></div>
<div class="line"><a name="l00032"></a><span class="lineno"> 32</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> copy1 = <a class="code" href="group__testutilities.html#gade0e7c37811a69f1c21c88c11943a19f">toQVector</a>(vec1);</div>
<div class="line"><a name="l00033"></a><span class="lineno"> 33</span>  <a class="code" href="group__init.html#ga4534403b721977b669bff7bf4e37f0fb">cloneQureg</a>(vec2, vec1);</div>
<div class="line"><a name="l00034"></a><span class="lineno"> 34</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vec1, vec2) );</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>  <span class="comment">// make sure vec1 unaffected</span></div>
<div class="line"><a name="l00037"></a><span class="lineno"> 37</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vec1, copy1) );</div>
<div class="line"><a name="l00038"></a><span class="lineno"> 38</span>  </div>
<div class="line"><a name="l00039"></a><span class="lineno"> 39</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(vec2, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</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>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00042"></a><span class="lineno"> 42</span>  </div>
<div class="line"><a name="l00043"></a><span class="lineno"> 43</span>  <a class="code" href="structQureg.html">Qureg</a> mat2 = <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="l00044"></a><span class="lineno"> 44</span>  </div>
<div class="line"><a name="l00045"></a><span class="lineno"> 45</span>  <span class="comment">// make sure states start differently</span></div>
<div class="line"><a name="l00046"></a><span class="lineno"> 46</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(mat1);</div>
<div class="line"><a name="l00047"></a><span class="lineno"> 47</span>  <a class="code" href="group__init.html#gada7230491a50cd409f8b00f5ee1db953">initBlankState</a>(mat2);</div>
<div class="line"><a name="l00048"></a><span class="lineno"> 48</span>  REQUIRE( !<a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(mat1, mat2) );</div>
<div class="line"><a name="l00049"></a><span class="lineno"> 49</span>  </div>
<div class="line"><a name="l00050"></a><span class="lineno"> 50</span>  <span class="comment">// make sure vec2 is changed</span></div>
<div class="line"><a name="l00051"></a><span class="lineno"> 51</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> copy1 = <a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(mat1);</div>
<div class="line"><a name="l00052"></a><span class="lineno"> 52</span>  <a class="code" href="group__init.html#ga4534403b721977b669bff7bf4e37f0fb">cloneQureg</a>(mat2, mat1);</div>
<div class="line"><a name="l00053"></a><span class="lineno"> 53</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(mat1, mat2) );</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>  <span class="comment">// make sure vec1 unaffected</span></div>
<div class="line"><a name="l00056"></a><span class="lineno"> 56</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(mat1, copy1) );</div>
<div class="line"><a name="l00057"></a><span class="lineno"> 57</span>  </div>
<div class="line"><a name="l00058"></a><span class="lineno"> 58</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(mat2, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00059"></a><span class="lineno"> 59</span>  }</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>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00062"></a><span class="lineno"> 62</span>  </div>
<div class="line"><a name="l00063"></a><span class="lineno"> 63</span>  SECTION( <span class="stringliteral">"qureg type"</span> ) {</div>
<div class="line"><a name="l00064"></a><span class="lineno"> 64</span>  </div>
<div class="line"><a name="l00065"></a><span class="lineno"> 65</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__init.html#ga4534403b721977b669bff7bf4e37f0fb">cloneQureg</a>(mat1, vec1), Contains(<span class="stringliteral">"both be state-vectors"</span>) && Contains(<span class="stringliteral">"density matrices"</span>) );</div>
<div class="line"><a name="l00066"></a><span class="lineno"> 66</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__init.html#ga4534403b721977b669bff7bf4e37f0fb">cloneQureg</a>(vec1, mat1), Contains(<span class="stringliteral">"both be state-vectors"</span>) && Contains(<span class="stringliteral">"density matrices"</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>  SECTION( <span class="stringliteral">"qureg dimensions"</span> ) {</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>  <a class="code" href="structQureg.html">Qureg</a> vec3 = <a class="code" href="group__type.html#ga3392816c0643414165c2f5caeec17df0">createQureg</a>(vec1.<a class="code" href="structQureg.html#ad08dff5316b8937f4b2a1417591543dc">numQubitsRepresented</a> + 1, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00071"></a><span class="lineno"> 71</span>  <a class="code" href="structQureg.html">Qureg</a> mat3 = <a class="code" href="group__type.html#ga93e55b6650b408abb30a1d4a8bce757c">createDensityQureg</a>(mat1.<a class="code" href="structQureg.html#ad08dff5316b8937f4b2a1417591543dc">numQubitsRepresented</a> + 1, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</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>  REQUIRE_THROWS_WITH( <a class="code" href="group__init.html#ga4534403b721977b669bff7bf4e37f0fb">cloneQureg</a>(vec1, vec3), Contains(<span class="stringliteral">"Dimensions"</span>) && Contains(<span class="stringliteral">"don't match"</span>) );</div>
<div class="line"><a name="l00074"></a><span class="lineno"> 74</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__init.html#ga4534403b721977b669bff7bf4e37f0fb">cloneQureg</a>(mat1, mat3), Contains(<span class="stringliteral">"Dimensions"</span>) && Contains(<span class="stringliteral">"don't match"</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="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(vec3, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00077"></a><span class="lineno"> 77</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(mat3, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00078"></a><span class="lineno"> 78</span>  }</div>
<div class="line"><a name="l00079"></a><span class="lineno"> 79</span>  }</div>
<div class="line"><a name="l00080"></a><span class="lineno"> 80</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(vec1, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00081"></a><span class="lineno"> 81</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(mat1, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00082"></a><span class="lineno"> 82</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00164">cloneQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00119">initBlankState()</a>, <a class="el" href="QuEST_8c_source.html#l01578">initDebugState()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="QuEST_8h_source.html#l00327">Qureg::numQubitsRepresented</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, <a class="el" href="utilities_8cpp_source.html#l01044">toQMatrix()</a>, and <a class="el" href="utilities_8cpp_source.html#l01113">toQVector()</a>.</p>
</div>
</div>
<a id="ga0168f7b5f09ccbb226144053ad1b7497"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga0168f7b5f09ccbb226144053ad1b7497">◆ </a></span>TEST_CASE() <span class="overload">[33/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"collapseToOutcome" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[gates] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__normgate.html#ga34457f7f62ccd75fb7d3fe67cd2f815a" title="Updates qureg to be consistent with measuring measureQubit in the given outcome (0 or 1),...">collapseToOutcome</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__gates_8cpp_source.html#l00015">15</a> of file <a class="el" href="test__gates_8cpp_source.html">test_gates.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00015"></a><span class="lineno"> 15</span>  {</div>
<div class="line"><a name="l00016"></a><span class="lineno"> 16</span>  </div>
<div class="line"><a name="l00017"></a><span class="lineno"> 17</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="l00018"></a><span class="lineno"> 18</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="l00019"></a><span class="lineno"> 19</span>  </div>
<div class="line"><a name="l00020"></a><span class="lineno"> 20</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00021"></a><span class="lineno"> 21</span>  </div>
<div class="line"><a name="l00022"></a><span class="lineno"> 22</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="l00023"></a><span class="lineno"> 23</span>  <span class="keywordtype">int</span> outcome = GENERATE( 0, 1 );</div>
<div class="line"><a name="l00024"></a><span class="lineno"> 24</span>  </div>
<div class="line"><a name="l00025"></a><span class="lineno"> 25</span>  <span class="comment">// repeat these random tests 10 times on every qubit, and for both outcomes</span></div>
<div class="line"><a name="l00026"></a><span class="lineno"> 26</span>  GENERATE( range(0,10) );</div>
<div class="line"><a name="l00027"></a><span class="lineno"> 27</span>  </div>
<div class="line"><a name="l00028"></a><span class="lineno"> 28</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00029"></a><span class="lineno"> 29</span>  </div>
<div class="line"><a name="l00030"></a><span class="lineno"> 30</span>  <span class="comment">// use a random L2 state for every qubit & outcome</span></div>
<div class="line"><a name="l00031"></a><span class="lineno"> 31</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="l00032"></a><span class="lineno"> 32</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(vec, vecRef);</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>  <span class="comment">// calculate prob of outcome</span></div>
<div class="line"><a name="l00035"></a><span class="lineno"> 35</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> prob = 0;</div>
<div class="line"><a name="l00036"></a><span class="lineno"> 36</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> ind=0; ind<vecRef.size(); ind++) {</div>
<div class="line"><a name="l00037"></a><span class="lineno"> 37</span>  <span class="keywordtype">int</span> bit = (ind >> qubit) & 1; <span class="comment">// target-th bit</span></div>
<div class="line"><a name="l00038"></a><span class="lineno"> 38</span>  <span class="keywordflow">if</span> (bit == outcome)</div>
<div class="line"><a name="l00039"></a><span class="lineno"> 39</span>  prob += pow(abs(vecRef[ind]), 2);</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>  </div>
<div class="line"><a name="l00042"></a><span class="lineno"> 42</span>  <span class="comment">// renormalise by the outcome prob</span></div>
<div class="line"><a name="l00043"></a><span class="lineno"> 43</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> ind=0; ind<vecRef.size(); ind++) {</div>
<div class="line"><a name="l00044"></a><span class="lineno"> 44</span>  <span class="keywordtype">int</span> bit = (ind >> qubit) & 1; <span class="comment">// target-th bit</span></div>
<div class="line"><a name="l00045"></a><span class="lineno"> 45</span>  <span class="keywordflow">if</span> (bit == outcome)</div>
<div class="line"><a name="l00046"></a><span class="lineno"> 46</span>  vecRef[ind] /= sqrt(prob);</div>
<div class="line"><a name="l00047"></a><span class="lineno"> 47</span>  <span class="keywordflow">else</span> </div>
<div class="line"><a name="l00048"></a><span class="lineno"> 48</span>  vecRef[ind] = 0;</div>
<div class="line"><a name="l00049"></a><span class="lineno"> 49</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__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> res = <a class="code" href="group__normgate.html#ga34457f7f62ccd75fb7d3fe67cd2f815a">collapseToOutcome</a>(vec, qubit, outcome);</div>
<div class="line"><a name="l00052"></a><span class="lineno"> 52</span>  REQUIRE( res == Approx(prob) );</div>
<div class="line"><a name="l00053"></a><span class="lineno"> 53</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vec, vecRef) );</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>  <span class="comment">// use a random density matrix for every qubit & outcome </span></div>
<div class="line"><a name="l00058"></a><span class="lineno"> 58</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="l00059"></a><span class="lineno"> 59</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat, matRef);</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>  <span class="comment">// prob is sum of diagonal amps (should be real) where target bit is outcome</span></div>
<div class="line"><a name="l00062"></a><span class="lineno"> 62</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> tr = 0;</div>
<div class="line"><a name="l00063"></a><span class="lineno"> 63</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> ind=0; ind<matRef.size(); ind++) {</div>
<div class="line"><a name="l00064"></a><span class="lineno"> 64</span>  <span class="keywordtype">int</span> bit = (ind >> qubit) & 1; <span class="comment">// qubit-th bit</span></div>
<div class="line"><a name="l00065"></a><span class="lineno"> 65</span>  <span class="keywordflow">if</span> (bit == outcome)</div>
<div class="line"><a name="l00066"></a><span class="lineno"> 66</span>  tr += matRef[ind][ind];</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>  REQUIRE( imag(tr) == Approx(0).margin(REAL_EPS) );</div>
<div class="line"><a name="l00069"></a><span class="lineno"> 69</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> prob = real(tr);</div>
<div class="line"><a name="l00070"></a><span class="lineno"> 70</span>  </div>
<div class="line"><a name="l00071"></a><span class="lineno"> 71</span>  <span class="comment">// renorm (/prob) every |*outcome*><*outcome*| state, zeroing all others </span></div>
<div class="line"><a name="l00072"></a><span class="lineno"> 72</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> r=0; r<matRef.size(); r++) {</div>
<div class="line"><a name="l00073"></a><span class="lineno"> 73</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> c=0; c<matRef.size(); c++) {</div>
<div class="line"><a name="l00074"></a><span class="lineno"> 74</span>  <span class="keywordtype">int</span> ketBit = (c >> qubit) & 1;</div>
<div class="line"><a name="l00075"></a><span class="lineno"> 75</span>  <span class="keywordtype">int</span> braBit = (r >> qubit) & 1;</div>
<div class="line"><a name="l00076"></a><span class="lineno"> 76</span>  </div>
<div class="line"><a name="l00077"></a><span class="lineno"> 77</span>  <span class="keywordflow">if</span> (ketBit == outcome && braBit == outcome)</div>
<div class="line"><a name="l00078"></a><span class="lineno"> 78</span>  matRef[r][c] /= prob;</div>
<div class="line"><a name="l00079"></a><span class="lineno"> 79</span>  <span class="keywordflow">else</span></div>
<div class="line"><a name="l00080"></a><span class="lineno"> 80</span>  matRef[r][c] = 0;</div>
<div class="line"><a name="l00081"></a><span class="lineno"> 81</span>  }</div>
<div class="line"><a name="l00082"></a><span class="lineno"> 82</span>  }</div>
<div class="line"><a name="l00083"></a><span class="lineno"> 83</span>  </div>
<div class="line"><a name="l00084"></a><span class="lineno"> 84</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> res = <a class="code" href="group__normgate.html#ga34457f7f62ccd75fb7d3fe67cd2f815a">collapseToOutcome</a>(mat, qubit, outcome);</div>
<div class="line"><a name="l00085"></a><span class="lineno"> 85</span>  REQUIRE( res == Approx(prob) );</div>
<div class="line"><a name="l00086"></a><span class="lineno"> 86</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(mat, matRef) );</div>
<div class="line"><a name="l00087"></a><span class="lineno"> 87</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>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00090"></a><span class="lineno"> 90</span>  </div>
<div class="line"><a name="l00091"></a><span class="lineno"> 91</span>  SECTION( <span class="stringliteral">"qubit index"</span> ) {</div>
<div class="line"><a name="l00092"></a><span class="lineno"> 92</span>  </div>
<div class="line"><a name="l00093"></a><span class="lineno"> 93</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="l00094"></a><span class="lineno"> 94</span>  <span class="keywordtype">int</span> outcome = 0;</div>
<div class="line"><a name="l00095"></a><span class="lineno"> 95</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__normgate.html#ga34457f7f62ccd75fb7d3fe67cd2f815a">collapseToOutcome</a>(mat, qubit, outcome), Contains(<span class="stringliteral">"Invalid target qubit"</span>) );</div>
<div class="line"><a name="l00096"></a><span class="lineno"> 96</span>  }</div>
<div class="line"><a name="l00097"></a><span class="lineno"> 97</span>  SECTION( <span class="stringliteral">"outcome value"</span> ) {</div>
<div class="line"><a name="l00098"></a><span class="lineno"> 98</span>  </div>
<div class="line"><a name="l00099"></a><span class="lineno"> 99</span>  <span class="keywordtype">int</span> qubit = 0;</div>
<div class="line"><a name="l00100"></a><span class="lineno"> 100</span>  <span class="keywordtype">int</span> outcome = GENERATE( -1, 2 );</div>
<div class="line"><a name="l00101"></a><span class="lineno"> 101</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__normgate.html#ga34457f7f62ccd75fb7d3fe67cd2f815a">collapseToOutcome</a>(mat, qubit, outcome), Contains(<span class="stringliteral">"Invalid measurement outcome"</span>) );</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">"outcome probability"</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>  <a class="code" href="group__init.html#ga2f049055d4a51d0ea4d1a43b5234dedb">initZeroState</a>(vec);</div>
<div class="line"><a name="l00106"></a><span class="lineno"> 106</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__normgate.html#ga34457f7f62ccd75fb7d3fe67cd2f815a">collapseToOutcome</a>(vec, 0, 1), Contains(<span class="stringliteral">"Can't collapse to state with zero probability"</span>) );</div>
<div class="line"><a name="l00107"></a><span class="lineno"> 107</span>  <a class="code" href="group__init.html#ga0379e21efca0767a22607fc0e26a5a22">initClassicalState</a>(vec, 1);</div>
<div class="line"><a name="l00108"></a><span class="lineno"> 108</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__normgate.html#ga34457f7f62ccd75fb7d3fe67cd2f815a">collapseToOutcome</a>(vec, 0, 0), Contains(<span class="stringliteral">"Can't collapse to state with zero probability"</span>) );</div>
<div class="line"><a name="l00109"></a><span class="lineno"> 109</span>  }</div>
<div class="line"><a name="l00110"></a><span class="lineno"> 110</span>  }</div>
<div class="line"><a name="l00111"></a><span class="lineno"> 111</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="l00112"></a><span class="lineno"> 112</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="l00113"></a><span class="lineno"> 113</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00966">collapseToOutcome()</a>, <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00490">getRandomDensityMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00468">getRandomStateVector()</a>, <a class="el" href="QuEST_8c_source.html#l00134">initClassicalState()</a>, <a class="el" href="QuEST_8c_source.html#l00113">initZeroState()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, and <a class="el" href="utilities_8cpp_source.html#l01201">toQureg()</a>.</p>
</div>
</div>
<a id="ga282f468229dd7da6f78f9ac98990a477"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga282f468229dd7da6f78f9ac98990a477">◆ </a></span>TEST_CASE() <span class="overload">[34/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"compactUnitary" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#gaefaa7acba90373efe4e0f0b94987c734" title="Apply a single-qubit unitary parameterised by two given complex scalars.">compactUnitary</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l00046">46</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><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>  </div>
<div class="line"><a name="l00048"></a><span class="lineno"> 48</span>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l00049"></a><span class="lineno"> 49</span>  </div>
<div class="line"><a name="l00050"></a><span class="lineno"> 50</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> a = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-1,1) * <a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(<a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(0,2*<a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>));</div>
<div class="line"><a name="l00051"></a><span class="lineno"> 51</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> b = sqrt(1-abs(a)*abs(a)) * <a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(<a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(0,2*<a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>));</div>
<div class="line"><a name="l00052"></a><span class="lineno"> 52</span>  <a class="code" href="structComplex.html">Complex</a> alpha = <a class="code" href="group__type.html#gab54c5a1ea720830a7ee394d03fb9f4e9">toComplex</a>( a );</div>
<div class="line"><a name="l00053"></a><span class="lineno"> 53</span>  <a class="code" href="structComplex.html">Complex</a> beta = <a class="code" href="group__type.html#gab54c5a1ea720830a7ee394d03fb9f4e9">toComplex</a>( b );</div>
<div class="line"><a name="l00054"></a><span class="lineno"> 54</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op = <a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(alpha, beta);</div>
<div class="line"><a name="l00055"></a><span class="lineno"> 55</span>  </div>
<div class="line"><a name="l00056"></a><span class="lineno"> 56</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00057"></a><span class="lineno"> 57</span>  </div>
<div class="line"><a name="l00058"></a><span class="lineno"> 58</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="l00059"></a><span class="lineno"> 59</span>  </div>
<div class="line"><a name="l00060"></a><span class="lineno"> 60</span>  SECTION( <span class="stringliteral">"state-vector"</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__unitary.html#gaefaa7acba90373efe4e0f0b94987c734">compactUnitary</a>(quregVec, target, alpha, beta);</div>
<div class="line"><a name="l00063"></a><span class="lineno"> 63</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, target, op); </div>
<div class="line"><a name="l00064"></a><span class="lineno"> 64</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</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">"density-matrix"</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="group__unitary.html#gaefaa7acba90373efe4e0f0b94987c734">compactUnitary</a>(quregMatr, target, alpha, beta);</div>
<div class="line"><a name="l00069"></a><span class="lineno"> 69</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, target, op); </div>
<div class="line"><a name="l00070"></a><span class="lineno"> 70</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 10*REAL_EPS) );</div>
<div class="line"><a name="l00071"></a><span class="lineno"> 71</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>  SECTION( <span class="stringliteral">"input validation"</span> ) {</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>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l00076"></a><span class="lineno"> 76</span>  </div>
<div class="line"><a name="l00077"></a><span class="lineno"> 77</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="l00078"></a><span class="lineno"> 78</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gaefaa7acba90373efe4e0f0b94987c734">compactUnitary</a>(quregVec, target, alpha, beta), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l00079"></a><span class="lineno"> 79</span>  }</div>
<div class="line"><a name="l00080"></a><span class="lineno"> 80</span>  SECTION( <span class="stringliteral">"unitarity"</span> ) {</div>
<div class="line"><a name="l00081"></a><span class="lineno"> 81</span>  </div>
<div class="line"><a name="l00082"></a><span class="lineno"> 82</span>  <span class="comment">// unitary when |alpha|^2 + |beta|^2 = 1</span></div>
<div class="line"><a name="l00083"></a><span class="lineno"> 83</span>  alpha = {.<a class="code" href="structComplex.html#ab5b2e2eca02131fc74b289a83636cbe3">real</a>=1, .imag=2}; </div>
<div class="line"><a name="l00084"></a><span class="lineno"> 84</span>  beta = {.<a class="code" href="structComplex.html#ab5b2e2eca02131fc74b289a83636cbe3">real</a>=3, .imag=4};</div>
<div class="line"><a name="l00085"></a><span class="lineno"> 85</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gaefaa7acba90373efe4e0f0b94987c734">compactUnitary</a>(quregVec, 0, alpha, beta), Contains(<span class="stringliteral">"unitary"</span>) );</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>  }</div>
<div class="line"><a name="l00088"></a><span class="lineno"> 88</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l00089"></a><span class="lineno"> 89</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l00404">compactUnitary()</a>, <a class="el" href="utilities_8cpp_source.html#l00417">expI()</a>, <a class="el" href="utilities_8cpp_source.html#l00421">getRandomReal()</a>, <a class="el" href="QuEST__common_8c_source.html#l00041">M_PI</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, <a class="el" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>, <a class="el" href="QuEST_8h_source.html#l00105">Complex::real</a>, <a class="el" href="group__type.html#gab54c5a1ea720830a7ee394d03fb9f4e9">toComplex</a>, and <a class="el" href="utilities_8cpp_source.html#l01044">toQMatrix()</a>.</p>
</div>
</div>
<a id="ga7c4749ab5725b6608bf63313b2aaf48f"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga7c4749ab5725b6608bf63313b2aaf48f">◆ </a></span>TEST_CASE() <span class="overload">[35/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"controlledCompactUnitary" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#gaf7e15bf09c64082e0a8467998eb25623" title="Apply a controlled unitary (single control, single target) parameterised by two given complex scalars...">controlledCompactUnitary</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l00097">97</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00097"></a><span class="lineno"> 97</span>  {</div>
<div class="line"><a name="l00098"></a><span class="lineno"> 98</span>  </div>
<div class="line"><a name="l00099"></a><span class="lineno"> 99</span>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l00100"></a><span class="lineno"> 100</span>  </div>
<div class="line"><a name="l00101"></a><span class="lineno"> 101</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> a = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-1,1) * <a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(<a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(0,2*<a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>));</div>
<div class="line"><a name="l00102"></a><span class="lineno"> 102</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> b = sqrt(1-abs(a)*abs(a)) * <a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(<a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(0,2*<a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>));</div>
<div class="line"><a name="l00103"></a><span class="lineno"> 103</span>  <a class="code" href="structComplex.html">Complex</a> alpha = <a class="code" href="group__type.html#gab54c5a1ea720830a7ee394d03fb9f4e9">toComplex</a>( a );</div>
<div class="line"><a name="l00104"></a><span class="lineno"> 104</span>  <a class="code" href="structComplex.html">Complex</a> beta = <a class="code" href="group__type.html#gab54c5a1ea720830a7ee394d03fb9f4e9">toComplex</a>( b );</div>
<div class="line"><a name="l00105"></a><span class="lineno"> 105</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op = <a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(alpha, beta);</div>
<div class="line"><a name="l00106"></a><span class="lineno"> 106</span>  </div>
<div class="line"><a name="l00107"></a><span class="lineno"> 107</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</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>  <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="l00110"></a><span class="lineno"> 110</span>  <span class="keywordtype">int</span> control = GENERATE_COPY( filter([=](<span class="keywordtype">int</span> c){ <span class="keywordflow">return</span> c!=target; }, range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>)) );</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>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00113"></a><span class="lineno"> 113</span>  </div>
<div class="line"><a name="l00114"></a><span class="lineno"> 114</span>  <a class="code" href="group__unitary.html#gaf7e15bf09c64082e0a8467998eb25623">controlledCompactUnitary</a>(quregVec, control, target, alpha, beta);</div>
<div class="line"><a name="l00115"></a><span class="lineno"> 115</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, control, target, op); </div>
<div class="line"><a name="l00116"></a><span class="lineno"> 116</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l00117"></a><span class="lineno"> 117</span>  }</div>
<div class="line"><a name="l00118"></a><span class="lineno"> 118</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00119"></a><span class="lineno"> 119</span>  </div>
<div class="line"><a name="l00120"></a><span class="lineno"> 120</span>  <a class="code" href="group__unitary.html#gaf7e15bf09c64082e0a8467998eb25623">controlledCompactUnitary</a>(quregMatr, control, target, alpha, beta);</div>
<div class="line"><a name="l00121"></a><span class="lineno"> 121</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, control, target, op); </div>
<div class="line"><a name="l00122"></a><span class="lineno"> 122</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 10*REAL_EPS) );</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>  }</div>
<div class="line"><a name="l00125"></a><span class="lineno"> 125</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</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>  SECTION( <span class="stringliteral">"control and target collision"</span> ) {</div>
<div class="line"><a name="l00128"></a><span class="lineno"> 128</span>  </div>
<div class="line"><a name="l00129"></a><span class="lineno"> 129</span>  <span class="keywordtype">int</span> qb = 0;</div>
<div class="line"><a name="l00130"></a><span class="lineno"> 130</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gaf7e15bf09c64082e0a8467998eb25623">controlledCompactUnitary</a>(quregVec, qb, qb, alpha, beta), Contains(<span class="stringliteral">"Control"</span>) && Contains(<span class="stringliteral">"target"</span>) );</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">"qubit indices"</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="keywordtype">int</span> qb = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l00135"></a><span class="lineno"> 135</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gaf7e15bf09c64082e0a8467998eb25623">controlledCompactUnitary</a>(quregVec, qb, 0, alpha, beta), Contains(<span class="stringliteral">"Invalid control"</span>) );</div>
<div class="line"><a name="l00136"></a><span class="lineno"> 136</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gaf7e15bf09c64082e0a8467998eb25623">controlledCompactUnitary</a>(quregVec, 0, qb, alpha, beta), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l00137"></a><span class="lineno"> 137</span>  }</div>
<div class="line"><a name="l00138"></a><span class="lineno"> 138</span>  SECTION( <span class="stringliteral">"unitarity"</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="comment">// unitary when |a|^2 + |b^2 = 1</span></div>
<div class="line"><a name="l00141"></a><span class="lineno"> 141</span>  alpha = {.<a class="code" href="structComplex.html#ab5b2e2eca02131fc74b289a83636cbe3">real</a>=1, .imag=2};</div>
<div class="line"><a name="l00142"></a><span class="lineno"> 142</span>  beta = {.<a class="code" href="structComplex.html#ab5b2e2eca02131fc74b289a83636cbe3">real</a>=3, .imag=4};</div>
<div class="line"><a name="l00143"></a><span class="lineno"> 143</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gaf7e15bf09c64082e0a8467998eb25623">controlledCompactUnitary</a>(quregVec, 0, 1, alpha, beta), Contains(<span class="stringliteral">"unitary"</span>) );</div>
<div class="line"><a name="l00144"></a><span class="lineno"> 144</span>  }</div>
<div class="line"><a name="l00145"></a><span class="lineno"> 145</span>  }</div>
<div class="line"><a name="l00146"></a><span class="lineno"> 146</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l00147"></a><span class="lineno"> 147</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l00417">controlledCompactUnitary()</a>, <a class="el" href="utilities_8cpp_source.html#l00417">expI()</a>, <a class="el" href="utilities_8cpp_source.html#l00421">getRandomReal()</a>, <a class="el" href="QuEST__common_8c_source.html#l00041">M_PI</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, <a class="el" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>, <a class="el" href="QuEST_8h_source.html#l00105">Complex::real</a>, <a class="el" href="group__type.html#gab54c5a1ea720830a7ee394d03fb9f4e9">toComplex</a>, and <a class="el" href="utilities_8cpp_source.html#l01044">toQMatrix()</a>.</p>
</div>
</div>
<a id="ga682affdaafaac3c37cb7155d9aae588b"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga682affdaafaac3c37cb7155d9aae588b">◆ </a></span>TEST_CASE() <span class="overload">[36/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"controlledMultiQubitUnitary" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#gaeb975903209000ebbaf50ef1cc353a79" title="Apply a general controlled multi-qubit unitary (including a global phase factor).">controlledMultiQubitUnitary</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l00155">155</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><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>  </div>
<div class="line"><a name="l00157"></a><span class="lineno"> 157</span>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l00158"></a><span class="lineno"> 158</span>  </div>
<div class="line"><a name="l00159"></a><span class="lineno"> 159</span>  <span class="comment">// figure out max-num targs (inclusive) allowed by hardware backend</span></div>
<div class="line"><a name="l00160"></a><span class="lineno"> 160</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="l00161"></a><span class="lineno"> 161</span>  <span class="keywordflow">if</span> (maxNumTargs >= <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>)</div>
<div class="line"><a name="l00162"></a><span class="lineno"> 162</span>  maxNumTargs = <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> - 1; <span class="comment">// make space for control qubit</span></div>
<div class="line"><a name="l00163"></a><span class="lineno"> 163</span>  </div>
<div class="line"><a name="l00164"></a><span class="lineno"> 164</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00165"></a><span class="lineno"> 165</span>  </div>
<div class="line"><a name="l00166"></a><span class="lineno"> 166</span>  <span class="comment">// generate all possible qubit arrangements</span></div>
<div class="line"><a name="l00167"></a><span class="lineno"> 167</span>  <span class="keywordtype">int</span> ctrl = GENERATE( range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) );</div>
<div class="line"><a name="l00168"></a><span class="lineno"> 168</span>  <span class="keywordtype">int</span> numTargs = GENERATE_COPY( range(1,maxNumTargs+1) );</div>
<div class="line"><a name="l00169"></a><span class="lineno"> 169</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, ctrl) );</div>
<div class="line"><a name="l00170"></a><span class="lineno"> 170</span>  </div>
<div class="line"><a name="l00171"></a><span class="lineno"> 171</span>  <span class="comment">// for each qubit arrangement, use a new random unitary</span></div>
<div class="line"><a name="l00172"></a><span class="lineno"> 172</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op = <a class="code" href="group__testutilities.html#ga1a5e9b668716b91dd8527ce00f7500cf">getRandomUnitary</a>(numTargs);</div>
<div class="line"><a name="l00173"></a><span class="lineno"> 173</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="l00174"></a><span class="lineno"> 174</span>  <a class="code" href="group__testutilities.html#ga7f83695bea7d0332a577bca017dbb03c">toComplexMatrixN</a>(op, matr);</div>
<div class="line"><a name="l00175"></a><span class="lineno"> 175</span>  </div>
<div class="line"><a name="l00176"></a><span class="lineno"> 176</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</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__unitary.html#gaeb975903209000ebbaf50ef1cc353a79">controlledMultiQubitUnitary</a>(quregVec, ctrl, targs, numTargs, matr);</div>
<div class="line"><a name="l00179"></a><span class="lineno"> 179</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, ctrl, targs, numTargs, op);</div>
<div class="line"><a name="l00180"></a><span class="lineno"> 180</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l00181"></a><span class="lineno"> 181</span>  }</div>
<div class="line"><a name="l00182"></a><span class="lineno"> 182</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00183"></a><span class="lineno"> 183</span>  </div>
<div class="line"><a name="l00184"></a><span class="lineno"> 184</span>  <a class="code" href="group__unitary.html#gaeb975903209000ebbaf50ef1cc353a79">controlledMultiQubitUnitary</a>(quregMatr, ctrl, targs, numTargs, matr);</div>
<div class="line"><a name="l00185"></a><span class="lineno"> 185</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, ctrl, targs, numTargs, op);</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, 10*REAL_EPS) );</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>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</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>  SECTION( <span class="stringliteral">"number of targets"</span> ) {</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>  <span class="comment">// there cannot be more targets than qubits in register</span></div>
<div class="line"><a name="l00195"></a><span class="lineno"> 195</span>  <span class="comment">// (numTargs=NUM_QUBITS is caught elsewhere, because that implies ctrl is invalid)</span></div>
<div class="line"><a name="l00196"></a><span class="lineno"> 196</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="l00197"></a><span class="lineno"> 197</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="l00198"></a><span class="lineno"> 198</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="l00199"></a><span class="lineno"> 199</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gaeb975903209000ebbaf50ef1cc353a79">controlledMultiQubitUnitary</a>(quregVec, 0, targs, numTargs, matr), Contains(<span class="stringliteral">"Invalid number of target"</span>));</div>
<div class="line"><a name="l00200"></a><span class="lineno"> 200</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l00201"></a><span class="lineno"> 201</span>  }</div>
<div class="line"><a name="l00202"></a><span class="lineno"> 202</span>  SECTION( <span class="stringliteral">"repetition in targets"</span> ) {</div>
<div class="line"><a name="l00203"></a><span class="lineno"> 203</span>  </div>
<div class="line"><a name="l00204"></a><span class="lineno"> 204</span>  <span class="keywordtype">int</span> ctrl = 0;</div>
<div class="line"><a name="l00205"></a><span class="lineno"> 205</span>  <span class="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l00206"></a><span class="lineno"> 206</span>  <span class="keywordtype">int</span> targs[] = {1,2,2};</div>
<div class="line"><a name="l00207"></a><span class="lineno"> 207</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="l00208"></a><span class="lineno"> 208</span>  </div>
<div class="line"><a name="l00209"></a><span class="lineno"> 209</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gaeb975903209000ebbaf50ef1cc353a79">controlledMultiQubitUnitary</a>(quregVec, ctrl, targs, numTargs, matr), Contains(<span class="stringliteral">"target"</span>) && Contains(<span class="stringliteral">"unique"</span>));</div>
<div class="line"><a name="l00210"></a><span class="lineno"> 210</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l00211"></a><span class="lineno"> 211</span>  }</div>
<div class="line"><a name="l00212"></a><span class="lineno"> 212</span>  SECTION( <span class="stringliteral">"control and target collision"</span> ) {</div>
<div class="line"><a name="l00213"></a><span class="lineno"> 213</span>  </div>
<div class="line"><a name="l00214"></a><span class="lineno"> 214</span>  <span class="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l00215"></a><span class="lineno"> 215</span>  <span class="keywordtype">int</span> targs[] = {0,1,2};</div>
<div class="line"><a name="l00216"></a><span class="lineno"> 216</span>  <span class="keywordtype">int</span> ctrl = targs[GENERATE_COPY( range(0,numTargs) )];</div>
<div class="line"><a name="l00217"></a><span class="lineno"> 217</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="l00218"></a><span class="lineno"> 218</span>  </div>
<div class="line"><a name="l00219"></a><span class="lineno"> 219</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gaeb975903209000ebbaf50ef1cc353a79">controlledMultiQubitUnitary</a>(quregVec, ctrl, targs, numTargs, matr), Contains(<span class="stringliteral">"Control"</span>) && Contains(<span class="stringliteral">"target"</span>));</div>
<div class="line"><a name="l00220"></a><span class="lineno"> 220</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l00221"></a><span class="lineno"> 221</span>  }</div>
<div class="line"><a name="l00222"></a><span class="lineno"> 222</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l00223"></a><span class="lineno"> 223</span>  </div>
<div class="line"><a name="l00224"></a><span class="lineno"> 224</span>  <span class="keywordtype">int</span> ctrl = 0;</div>
<div class="line"><a name="l00225"></a><span class="lineno"> 225</span>  <span class="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l00226"></a><span class="lineno"> 226</span>  <span class="keywordtype">int</span> targs[] = {1,2,3};</div>
<div class="line"><a name="l00227"></a><span class="lineno"> 227</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="l00228"></a><span class="lineno"> 228</span>  </div>
<div class="line"><a name="l00229"></a><span class="lineno"> 229</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="l00230"></a><span class="lineno"> 230</span>  ctrl = inv;</div>
<div class="line"><a name="l00231"></a><span class="lineno"> 231</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gaeb975903209000ebbaf50ef1cc353a79">controlledMultiQubitUnitary</a>(quregVec, ctrl, targs, numTargs, matr), Contains(<span class="stringliteral">"Invalid control"</span>) );</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>  ctrl = 0; <span class="comment">// restore valid ctrl</span></div>
<div class="line"><a name="l00234"></a><span class="lineno"> 234</span>  targs[GENERATE_COPY( range(0,numTargs) )] = inv; <span class="comment">// make invalid target</span></div>
<div class="line"><a name="l00235"></a><span class="lineno"> 235</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gaeb975903209000ebbaf50ef1cc353a79">controlledMultiQubitUnitary</a>(quregVec, ctrl, targs, numTargs, matr), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l00236"></a><span class="lineno"> 236</span>  </div>
<div class="line"><a name="l00237"></a><span class="lineno"> 237</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l00238"></a><span class="lineno"> 238</span>  }</div>
<div class="line"><a name="l00239"></a><span class="lineno"> 239</span>  SECTION( <span class="stringliteral">"unitarity"</span> ) {</div>
<div class="line"><a name="l00240"></a><span class="lineno"> 240</span>  </div>
<div class="line"><a name="l00241"></a><span class="lineno"> 241</span>  <span class="keywordtype">int</span> ctrl = 0;</div>
<div class="line"><a name="l00242"></a><span class="lineno"> 242</span>  <span class="keywordtype">int</span> numTargs = GENERATE_COPY( range(1,maxNumTargs+1) );</div>
<div class="line"><a name="l00243"></a><span class="lineno"> 243</span>  <a class="code" href="structComplexMatrixN.html">ComplexMatrixN</a> matr = <a class="code" href="group__type.html#ga815103261fb22ea9690e1427571df00e">createComplexMatrixN</a>(numTargs); <span class="comment">// initially zero, hence not-unitary</span></div>
<div class="line"><a name="l00244"></a><span class="lineno"> 244</span>  </div>
<div class="line"><a name="l00245"></a><span class="lineno"> 245</span>  <span class="keywordtype">int</span> targs[numTargs];</div>
<div class="line"><a name="l00246"></a><span class="lineno"> 246</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numTargs; i++)</div>
<div class="line"><a name="l00247"></a><span class="lineno"> 247</span>  targs[i] = i+1;</div>
<div class="line"><a name="l00248"></a><span class="lineno"> 248</span>  </div>
<div class="line"><a name="l00249"></a><span class="lineno"> 249</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gaeb975903209000ebbaf50ef1cc353a79">controlledMultiQubitUnitary</a>(quregVec, ctrl, targs, numTargs, matr), Contains(<span class="stringliteral">"unitary"</span>) );</div>
<div class="line"><a name="l00250"></a><span class="lineno"> 250</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l00251"></a><span class="lineno"> 251</span>  }</div>
<div class="line"><a name="l00252"></a><span class="lineno"> 252</span>  SECTION( <span class="stringliteral">"unitary creation"</span> ) {</div>
<div class="line"><a name="l00253"></a><span class="lineno"> 253</span>  </div>
<div class="line"><a name="l00254"></a><span class="lineno"> 254</span>  <span class="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l00255"></a><span class="lineno"> 255</span>  <span class="keywordtype">int</span> targs[] = {1,2,3};</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">/* compilers don't auto-initialise to NULL; the below circumstance </span></div>
<div class="line"><a name="l00258"></a><span class="lineno"> 258</span> <span class="comment"> * only really occurs when 'malloc' returns NULL in createComplexMatrixN, </span></div>
<div class="line"><a name="l00259"></a><span class="lineno"> 259</span> <span class="comment"> * which actually triggers its own validation. Hence this test is useless </span></div>
<div class="line"><a name="l00260"></a><span class="lineno"> 260</span> <span class="comment"> * currently.</span></div>
<div class="line"><a name="l00261"></a><span class="lineno"> 261</span> <span class="comment"> */</span></div>
<div class="line"><a name="l00262"></a><span class="lineno"> 262</span>  <a class="code" href="structComplexMatrixN.html">ComplexMatrixN</a> matr;</div>
<div class="line"><a name="l00263"></a><span class="lineno"> 263</span>  matr.<a class="code" href="structComplexMatrixN.html#a446e8a077597e4f76049d547df0c9738">real</a> = NULL;</div>
<div class="line"><a name="l00264"></a><span class="lineno"> 264</span>  matr.<a class="code" href="structComplexMatrixN.html#afde13e469a3b4f179f45e53d1ec0a7cf">imag</a> = NULL; </div>
<div class="line"><a name="l00265"></a><span class="lineno"> 265</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gaeb975903209000ebbaf50ef1cc353a79">controlledMultiQubitUnitary</a>(quregVec, 0, targs, numTargs, matr), Contains(<span class="stringliteral">"created"</span>) );</div>
<div class="line"><a name="l00266"></a><span class="lineno"> 266</span>  }</div>
<div class="line"><a name="l00267"></a><span class="lineno"> 267</span>  SECTION( <span class="stringliteral">"unitary dimensions"</span> ) {</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="keywordtype">int</span> ctrl = 0;</div>
<div class="line"><a name="l00270"></a><span class="lineno"> 270</span>  <span class="keywordtype">int</span> targs[2] = {1,2};</div>
<div class="line"><a name="l00271"></a><span class="lineno"> 271</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="l00272"></a><span class="lineno"> 272</span>  </div>
<div class="line"><a name="l00273"></a><span class="lineno"> 273</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gaeb975903209000ebbaf50ef1cc353a79">controlledMultiQubitUnitary</a>(quregVec, ctrl, targs, 2, matr), Contains(<span class="stringliteral">"matrix size"</span>));</div>
<div class="line"><a name="l00274"></a><span class="lineno"> 274</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l00275"></a><span class="lineno"> 275</span>  }</div>
<div class="line"><a name="l00276"></a><span class="lineno"> 276</span>  SECTION( <span class="stringliteral">"unitary fits in node"</span> ) {</div>
<div class="line"><a name="l00277"></a><span class="lineno"> 277</span>  </div>
<div class="line"><a name="l00278"></a><span class="lineno"> 278</span>  <span class="comment">// pretend we have a very limited distributed memory (judged by matr size)</span></div>
<div class="line"><a name="l00279"></a><span class="lineno"> 279</span>  quregVec.numAmpsPerChunk = 1;</div>
<div class="line"><a name="l00280"></a><span class="lineno"> 280</span>  <span class="keywordtype">int</span> qb[] = {1,2};</div>
<div class="line"><a name="l00281"></a><span class="lineno"> 281</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="l00282"></a><span class="lineno"> 282</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gaeb975903209000ebbaf50ef1cc353a79">controlledMultiQubitUnitary</a>(quregVec, 0, qb, 2, matr), Contains(<span class="stringliteral">"targets too many qubits"</span>));</div>
<div class="line"><a name="l00283"></a><span class="lineno"> 283</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l00284"></a><span class="lineno"> 284</span>  }</div>
<div class="line"><a name="l00285"></a><span class="lineno"> 285</span>  }</div>
<div class="line"><a name="l00286"></a><span class="lineno"> 286</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l00287"></a><span class="lineno"> 287</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST__validation_8c_source.html#l00328">calcLog2()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l00313">controlledMultiQubitUnitary()</a>, <a class="el" href="QuEST_8c_source.html#l01348">createComplexMatrixN()</a>, <a class="el" href="QuEST_8c_source.html#l01369">destroyComplexMatrixN()</a>, <a class="el" href="utilities_8cpp_source.html#l00530">getRandomUnitary()</a>, <a class="el" href="QuEST_8h_source.html#l00190">ComplexMatrixN::imag</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, <a class="el" href="QuEST_8h_source.html#l00189">ComplexMatrixN::real</a>, <a class="el" href="utilities_8cpp_source.html#l01488">sublists()</a>, and <a class="el" href="utilities_8cpp_source.html#l01033">toComplexMatrixN()</a>.</p>
</div>
</div>
<a id="ga6547a0c5b3e34f461a9b0fd859445e78"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga6547a0c5b3e34f461a9b0fd859445e78">◆ </a></span>TEST_CASE() <span class="overload">[37/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"controlledNot" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#gaa5a138473a4433c853c6e66e7aabc237" title="Apply the controlled not (single control, single target) gate, also known as the c-X,...">controlledNot</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l00295">295</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00295"></a><span class="lineno"> 295</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>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l00298"></a><span class="lineno"> 298</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op{{0,1},{1,0}};</div>
<div class="line"><a name="l00299"></a><span class="lineno"> 299</span>  </div>
<div class="line"><a name="l00300"></a><span class="lineno"> 300</span>  SECTION( <span class="stringliteral">"correctness"</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>  <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="l00303"></a><span class="lineno"> 303</span>  <span class="keywordtype">int</span> control = GENERATE_COPY( filter([=](<span class="keywordtype">int</span> c){ <span class="keywordflow">return</span> c!=target; }, range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>)) );</div>
<div class="line"><a name="l00304"></a><span class="lineno"> 304</span>  </div>
<div class="line"><a name="l00305"></a><span class="lineno"> 305</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00306"></a><span class="lineno"> 306</span>  </div>
<div class="line"><a name="l00307"></a><span class="lineno"> 307</span>  <a class="code" href="group__unitary.html#gaa5a138473a4433c853c6e66e7aabc237">controlledNot</a>(quregVec, control, target);</div>
<div class="line"><a name="l00308"></a><span class="lineno"> 308</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, control, target, op); </div>
<div class="line"><a name="l00309"></a><span class="lineno"> 309</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</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>  SECTION( <span class="stringliteral">"density-matrix"</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>  <a class="code" href="group__unitary.html#gaa5a138473a4433c853c6e66e7aabc237">controlledNot</a>(quregMatr, control, target);</div>
<div class="line"><a name="l00314"></a><span class="lineno"> 314</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, control, target, op); </div>
<div class="line"><a name="l00315"></a><span class="lineno"> 315</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</div>
<div class="line"><a name="l00316"></a><span class="lineno"> 316</span>  }</div>
<div class="line"><a name="l00317"></a><span class="lineno"> 317</span>  }</div>
<div class="line"><a name="l00318"></a><span class="lineno"> 318</span>  SECTION( <span class="stringliteral">"input validation"</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>  SECTION( <span class="stringliteral">"control and target collision"</span> ) {</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="keywordtype">int</span> qb = GENERATE( range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) );</div>
<div class="line"><a name="l00323"></a><span class="lineno"> 323</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gaa5a138473a4433c853c6e66e7aabc237">controlledNot</a>(quregVec, qb, qb), Contains(<span class="stringliteral">"Control"</span>) && Contains(<span class="stringliteral">"target"</span>) );</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">"qubit indices"</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="keywordtype">int</span> qb = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l00328"></a><span class="lineno"> 328</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gaa5a138473a4433c853c6e66e7aabc237">controlledNot</a>(quregVec, qb, 0), Contains(<span class="stringliteral">"Invalid control"</span>) );</div>
<div class="line"><a name="l00329"></a><span class="lineno"> 329</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gaa5a138473a4433c853c6e66e7aabc237">controlledNot</a>(quregVec, 0, qb), Contains(<span class="stringliteral">"Invalid target"</span>) );</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>  }</div>
<div class="line"><a name="l00332"></a><span class="lineno"> 332</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l00333"></a><span class="lineno"> 333</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l00524">controlledNot()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, and <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>.</p>
</div>
</div>
<a id="ga68c2309cfe69baf8733fd333451353f1"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga68c2309cfe69baf8733fd333451353f1">◆ </a></span>TEST_CASE() <span class="overload">[38/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"controlledPauliY" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#ga5e5fdaa7d3dd449b3e2c5d4a01bd015a" title="Apply the controlled pauliY (single control, single target) gate, also known as the c-Y and c-sigma-Y...">controlledPauliY</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l00341">341</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><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>  </div>
<div class="line"><a name="l00343"></a><span class="lineno"> 343</span>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l00344"></a><span class="lineno"> 344</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op{{0,-<a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>(0,1)},{<a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>(0,1),0}};</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">"correctness"</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>  <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="l00349"></a><span class="lineno"> 349</span>  <span class="keywordtype">int</span> control = GENERATE_COPY( filter([=](<span class="keywordtype">int</span> c){ <span class="keywordflow">return</span> c!=target; }, range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>)) );</div>
<div class="line"><a name="l00350"></a><span class="lineno"> 350</span>  </div>
<div class="line"><a name="l00351"></a><span class="lineno"> 351</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00352"></a><span class="lineno"> 352</span>  </div>
<div class="line"><a name="l00353"></a><span class="lineno"> 353</span>  <a class="code" href="group__unitary.html#ga5e5fdaa7d3dd449b3e2c5d4a01bd015a">controlledPauliY</a>(quregVec, control, target);</div>
<div class="line"><a name="l00354"></a><span class="lineno"> 354</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, control, target, op); </div>
<div class="line"><a name="l00355"></a><span class="lineno"> 355</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l00356"></a><span class="lineno"> 356</span>  }</div>
<div class="line"><a name="l00357"></a><span class="lineno"> 357</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00358"></a><span class="lineno"> 358</span>  </div>
<div class="line"><a name="l00359"></a><span class="lineno"> 359</span>  <a class="code" href="group__unitary.html#ga5e5fdaa7d3dd449b3e2c5d4a01bd015a">controlledPauliY</a>(quregMatr, control, target);</div>
<div class="line"><a name="l00360"></a><span class="lineno"> 360</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, control, target, op); </div>
<div class="line"><a name="l00361"></a><span class="lineno"> 361</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</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>  }</div>
<div class="line"><a name="l00364"></a><span class="lineno"> 364</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</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">"control and target collision"</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> qb = GENERATE( range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) );</div>
<div class="line"><a name="l00369"></a><span class="lineno"> 369</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga5e5fdaa7d3dd449b3e2c5d4a01bd015a">controlledPauliY</a>(quregVec, qb, qb), Contains(<span class="stringliteral">"Control"</span>) && Contains(<span class="stringliteral">"target"</span>) );</div>
<div class="line"><a name="l00370"></a><span class="lineno"> 370</span>  } </div>
<div class="line"><a name="l00371"></a><span class="lineno"> 371</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l00372"></a><span class="lineno"> 372</span>  </div>
<div class="line"><a name="l00373"></a><span class="lineno"> 373</span>  <span class="keywordtype">int</span> qb = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l00374"></a><span class="lineno"> 374</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga5e5fdaa7d3dd449b3e2c5d4a01bd015a">controlledPauliY</a>(quregVec, qb, 0), Contains(<span class="stringliteral">"Invalid control"</span>) );</div>
<div class="line"><a name="l00375"></a><span class="lineno"> 375</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga5e5fdaa7d3dd449b3e2c5d4a01bd015a">controlledPauliY</a>(quregVec, 0, qb), Contains(<span class="stringliteral">"Invalid target"</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>  }</div>
<div class="line"><a name="l00378"></a><span class="lineno"> 378</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l00379"></a><span class="lineno"> 379</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l00563">controlledPauliY()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, and <a class="el" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>.</p>
</div>
</div>
<a id="gaa1bacf29d7a0a247e5a944bf76f086d0"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaa1bacf29d7a0a247e5a944bf76f086d0">◆ </a></span>TEST_CASE() <span class="overload">[39/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"controlledPhaseFlip" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#ga2fa310101ecffd6aeba96f77b7d85f56" title="Apply the (two-qubit) controlled phase flip gate, also known as the controlled pauliZ gate.">controlledPhaseFlip</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l00387">387</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00387"></a><span class="lineno"> 387</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>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l00390"></a><span class="lineno"> 390</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op{{1,0},{0,-1}};</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>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00393"></a><span class="lineno"> 393</span>  </div>
<div class="line"><a name="l00394"></a><span class="lineno"> 394</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="l00395"></a><span class="lineno"> 395</span>  <span class="keywordtype">int</span> control = GENERATE_COPY( filter([=](<span class="keywordtype">int</span> c){ <span class="keywordflow">return</span> c!=target; }, range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>)) );</div>
<div class="line"><a name="l00396"></a><span class="lineno"> 396</span>  </div>
<div class="line"><a name="l00397"></a><span class="lineno"> 397</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00398"></a><span class="lineno"> 398</span>  </div>
<div class="line"><a name="l00399"></a><span class="lineno"> 399</span>  <a class="code" href="group__unitary.html#ga2fa310101ecffd6aeba96f77b7d85f56">controlledPhaseFlip</a>(quregVec, control, target);</div>
<div class="line"><a name="l00400"></a><span class="lineno"> 400</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, control, target, op); </div>
<div class="line"><a name="l00401"></a><span class="lineno"> 401</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l00402"></a><span class="lineno"> 402</span>  }</div>
<div class="line"><a name="l00403"></a><span class="lineno"> 403</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00404"></a><span class="lineno"> 404</span>  </div>
<div class="line"><a name="l00405"></a><span class="lineno"> 405</span>  <a class="code" href="group__unitary.html#ga2fa310101ecffd6aeba96f77b7d85f56">controlledPhaseFlip</a>(quregMatr, control, target);</div>
<div class="line"><a name="l00406"></a><span class="lineno"> 406</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, control, target, op); </div>
<div class="line"><a name="l00407"></a><span class="lineno"> 407</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</div>
<div class="line"><a name="l00408"></a><span class="lineno"> 408</span>  }</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">"input validation"</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>  SECTION( <span class="stringliteral">"control and target collision"</span> ) {</div>
<div class="line"><a name="l00413"></a><span class="lineno"> 413</span>  </div>
<div class="line"><a name="l00414"></a><span class="lineno"> 414</span>  <span class="keywordtype">int</span> qb = GENERATE( range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) );</div>
<div class="line"><a name="l00415"></a><span class="lineno"> 415</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga2fa310101ecffd6aeba96f77b7d85f56">controlledPhaseFlip</a>(quregVec, qb, qb), Contains(<span class="stringliteral">"Control"</span>) && Contains(<span class="stringliteral">"target"</span>) );</div>
<div class="line"><a name="l00416"></a><span class="lineno"> 416</span>  } </div>
<div class="line"><a name="l00417"></a><span class="lineno"> 417</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</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>  <span class="keywordtype">int</span> qb = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l00420"></a><span class="lineno"> 420</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga2fa310101ecffd6aeba96f77b7d85f56">controlledPhaseFlip</a>(quregVec, qb, 0), Contains(<span class="stringliteral">"Invalid control"</span>) );</div>
<div class="line"><a name="l00421"></a><span class="lineno"> 421</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga2fa310101ecffd6aeba96f77b7d85f56">controlledPhaseFlip</a>(quregVec, 0, qb), Contains(<span class="stringliteral">"Invalid target"</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>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l00425"></a><span class="lineno"> 425</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l00575">controlledPhaseFlip()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, and <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>.</p>
</div>
</div>
<a id="gaab0f5a29d8c51dc46ae1dd14b453b920"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaab0f5a29d8c51dc46ae1dd14b453b920">◆ </a></span>TEST_CASE() <span class="overload">[40/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"controlledPhaseShift" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#ga7214a79aa22ae7a50ad6f38615968cb0" title="Introduce a phase factor on state of qubits idQubit1 and idQubit2.">controlledPhaseShift</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l00433">433</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00433"></a><span class="lineno"> 433</span>  {</div>
<div class="line"><a name="l00434"></a><span class="lineno"> 434</span>  </div>
<div class="line"><a name="l00435"></a><span class="lineno"> 435</span>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l00436"></a><span class="lineno"> 436</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> param = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-2*<a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>, 2*<a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>);</div>
<div class="line"><a name="l00437"></a><span class="lineno"> 437</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op{{1,0},{0,<a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(param)}};</div>
<div class="line"><a name="l00438"></a><span class="lineno"> 438</span>  </div>
<div class="line"><a name="l00439"></a><span class="lineno"> 439</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00440"></a><span class="lineno"> 440</span>  </div>
<div class="line"><a name="l00441"></a><span class="lineno"> 441</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="l00442"></a><span class="lineno"> 442</span>  <span class="keywordtype">int</span> control = GENERATE_COPY( filter([=](<span class="keywordtype">int</span> c){ <span class="keywordflow">return</span> c!=target; }, range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>)) );</div>
<div class="line"><a name="l00443"></a><span class="lineno"> 443</span>  </div>
<div class="line"><a name="l00444"></a><span class="lineno"> 444</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00445"></a><span class="lineno"> 445</span>  </div>
<div class="line"><a name="l00446"></a><span class="lineno"> 446</span>  <a class="code" href="group__unitary.html#ga7214a79aa22ae7a50ad6f38615968cb0">controlledPhaseShift</a>(quregVec, control, target, param);</div>
<div class="line"><a name="l00447"></a><span class="lineno"> 447</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, control, target, op); </div>
<div class="line"><a name="l00448"></a><span class="lineno"> 448</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l00449"></a><span class="lineno"> 449</span>  }</div>
<div class="line"><a name="l00450"></a><span class="lineno"> 450</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00451"></a><span class="lineno"> 451</span>  </div>
<div class="line"><a name="l00452"></a><span class="lineno"> 452</span>  <a class="code" href="group__unitary.html#ga7214a79aa22ae7a50ad6f38615968cb0">controlledPhaseShift</a>(quregMatr, control, target, param);</div>
<div class="line"><a name="l00453"></a><span class="lineno"> 453</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, control, target, op); </div>
<div class="line"><a name="l00454"></a><span class="lineno"> 454</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</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>  }</div>
<div class="line"><a name="l00457"></a><span class="lineno"> 457</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00458"></a><span class="lineno"> 458</span>  </div>
<div class="line"><a name="l00459"></a><span class="lineno"> 459</span>  SECTION( <span class="stringliteral">"control and target collision"</span> ) {</div>
<div class="line"><a name="l00460"></a><span class="lineno"> 460</span>  </div>
<div class="line"><a name="l00461"></a><span class="lineno"> 461</span>  <span class="keywordtype">int</span> qb = GENERATE( range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) );</div>
<div class="line"><a name="l00462"></a><span class="lineno"> 462</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga7214a79aa22ae7a50ad6f38615968cb0">controlledPhaseShift</a>(quregVec, qb, qb, param), Contains(<span class="stringliteral">"Control"</span>) && Contains(<span class="stringliteral">"target"</span>) );</div>
<div class="line"><a name="l00463"></a><span class="lineno"> 463</span>  } </div>
<div class="line"><a name="l00464"></a><span class="lineno"> 464</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</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>  <span class="keywordtype">int</span> qb = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l00467"></a><span class="lineno"> 467</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga7214a79aa22ae7a50ad6f38615968cb0">controlledPhaseShift</a>(quregVec, qb, 0, param), Contains(<span class="stringliteral">"Invalid control"</span>) );</div>
<div class="line"><a name="l00468"></a><span class="lineno"> 468</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga7214a79aa22ae7a50ad6f38615968cb0">controlledPhaseShift</a>(quregVec, 0, qb, param), Contains(<span class="stringliteral">"Invalid target"</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>  }</div>
<div class="line"><a name="l00471"></a><span class="lineno"> 471</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l00472"></a><span class="lineno"> 472</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l00498">controlledPhaseShift()</a>, <a class="el" href="utilities_8cpp_source.html#l00417">expI()</a>, <a class="el" href="utilities_8cpp_source.html#l00421">getRandomReal()</a>, <a class="el" href="QuEST__common_8c_source.html#l00041">M_PI</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, and <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>.</p>
</div>
</div>
<a id="ga59fc931b7033092612225a53c41a2296"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga59fc931b7033092612225a53c41a2296">◆ </a></span>TEST_CASE() <span class="overload">[41/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"controlledRotateAroundAxis" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#ga0c84c429cb1d7e2596706c1804dd9cba" title="Applies a controlled rotation by a given angle around a given vector on the Bloch-sphere.">controlledRotateAroundAxis</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l00480">480</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00480"></a><span class="lineno"> 480</span>  {</div>
<div class="line"><a name="l00481"></a><span class="lineno"> 481</span>  </div>
<div class="line"><a name="l00482"></a><span class="lineno"> 482</span>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l00483"></a><span class="lineno"> 483</span>  </div>
<div class="line"><a name="l00484"></a><span class="lineno"> 484</span>  <span class="comment">// each test will use a random parameter and axis vector </span></div>
<div class="line"><a name="l00485"></a><span class="lineno"> 485</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> param = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-4*<a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>, 4*<a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>);</div>
<div class="line"><a name="l00486"></a><span class="lineno"> 486</span>  <a class="code" href="structVector.html">Vector</a> vec = {.<a class="code" href="structVector.html#a0d0459a5b731ac5fb3dff2c6134e6e88">x</a>=<a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-1,1), .y=<a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-1,1), .z=<a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-1,1)};</div>
<div class="line"><a name="l00487"></a><span class="lineno"> 487</span>  </div>
<div class="line"><a name="l00488"></a><span class="lineno"> 488</span>  <span class="comment">// Rn(a) = cos(a/2)I - i sin(a/2) n . paulivector</span></div>
<div class="line"><a name="l00489"></a><span class="lineno"> 489</span>  <span class="comment">// (pg 24 of vcpc.univie.ac.at/~ian/hotlist/qc/talks/bloch-sphere-rotations.pdf)</span></div>
<div class="line"><a name="l00490"></a><span class="lineno"> 490</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> c = cos(param/2);</div>
<div class="line"><a name="l00491"></a><span class="lineno"> 491</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> s = sin(param/2);</div>
<div class="line"><a name="l00492"></a><span class="lineno"> 492</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> m = sqrt(vec.<a class="code" href="structVector.html#a0d0459a5b731ac5fb3dff2c6134e6e88">x</a>*vec.<a class="code" href="structVector.html#a0d0459a5b731ac5fb3dff2c6134e6e88">x</a> + vec.<a class="code" href="structVector.html#abc3cfc6c8e297b1153a373d84b981e6b">y</a>*vec.<a class="code" href="structVector.html#abc3cfc6c8e297b1153a373d84b981e6b">y</a> + vec.<a class="code" href="structVector.html#ab33976d8fda2e44b770f71269d698a25">z</a>*vec.<a class="code" href="structVector.html#ab33976d8fda2e44b770f71269d698a25">z</a>);</div>
<div class="line"><a name="l00493"></a><span class="lineno"> 493</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op{{c - <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>(0,1)*vec.<a class="code" href="structVector.html#ab33976d8fda2e44b770f71269d698a25">z</a>*s/m, -(vec.<a class="code" href="structVector.html#abc3cfc6c8e297b1153a373d84b981e6b">y</a> + <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>(0,1)*vec.<a class="code" href="structVector.html#a0d0459a5b731ac5fb3dff2c6134e6e88">x</a>)*s/m}, </div>
<div class="line"><a name="l00494"></a><span class="lineno"> 494</span>  {(vec.<a class="code" href="structVector.html#abc3cfc6c8e297b1153a373d84b981e6b">y</a> - <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>(0,1)*vec.<a class="code" href="structVector.html#a0d0459a5b731ac5fb3dff2c6134e6e88">x</a>)*s/m, c + <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>(0,1)*vec.<a class="code" href="structVector.html#ab33976d8fda2e44b770f71269d698a25">z</a>*s/m}};</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>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00497"></a><span class="lineno"> 497</span>  </div>
<div class="line"><a name="l00498"></a><span class="lineno"> 498</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="l00499"></a><span class="lineno"> 499</span>  <span class="keywordtype">int</span> control = GENERATE_COPY( filter([=](<span class="keywordtype">int</span> c){ <span class="keywordflow">return</span> c!=target; }, range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>)) );</div>
<div class="line"><a name="l00500"></a><span class="lineno"> 500</span>  </div>
<div class="line"><a name="l00501"></a><span class="lineno"> 501</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00502"></a><span class="lineno"> 502</span>  </div>
<div class="line"><a name="l00503"></a><span class="lineno"> 503</span>  <a class="code" href="group__unitary.html#ga0c84c429cb1d7e2596706c1804dd9cba">controlledRotateAroundAxis</a>(quregVec, control, target, param, vec);</div>
<div class="line"><a name="l00504"></a><span class="lineno"> 504</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, control, target, op); </div>
<div class="line"><a name="l00505"></a><span class="lineno"> 505</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</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>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00508"></a><span class="lineno"> 508</span>  </div>
<div class="line"><a name="l00509"></a><span class="lineno"> 509</span>  <a class="code" href="group__unitary.html#ga0c84c429cb1d7e2596706c1804dd9cba">controlledRotateAroundAxis</a>(quregMatr, control, target, param, vec);</div>
<div class="line"><a name="l00510"></a><span class="lineno"> 510</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, control, target, op); </div>
<div class="line"><a name="l00511"></a><span class="lineno"> 511</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 10*REAL_EPS) );</div>
<div class="line"><a name="l00512"></a><span class="lineno"> 512</span>  }</div>
<div class="line"><a name="l00513"></a><span class="lineno"> 513</span>  }</div>
<div class="line"><a name="l00514"></a><span class="lineno"> 514</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00515"></a><span class="lineno"> 515</span>  </div>
<div class="line"><a name="l00516"></a><span class="lineno"> 516</span>  SECTION( <span class="stringliteral">"control and target collision"</span> ) {</div>
<div class="line"><a name="l00517"></a><span class="lineno"> 517</span>  </div>
<div class="line"><a name="l00518"></a><span class="lineno"> 518</span>  <span class="keywordtype">int</span> qb = GENERATE( range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) );</div>
<div class="line"><a name="l00519"></a><span class="lineno"> 519</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga0c84c429cb1d7e2596706c1804dd9cba">controlledRotateAroundAxis</a>(quregVec, qb, qb, param, vec), Contains(<span class="stringliteral">"Control"</span>) && Contains(<span class="stringliteral">"target"</span>) );</div>
<div class="line"><a name="l00520"></a><span class="lineno"> 520</span>  } </div>
<div class="line"><a name="l00521"></a><span class="lineno"> 521</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l00522"></a><span class="lineno"> 522</span>  </div>
<div class="line"><a name="l00523"></a><span class="lineno"> 523</span>  <span class="keywordtype">int</span> qb = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l00524"></a><span class="lineno"> 524</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga0c84c429cb1d7e2596706c1804dd9cba">controlledRotateAroundAxis</a>(quregVec, qb, 0, param, vec), Contains(<span class="stringliteral">"Invalid control"</span>) );</div>
<div class="line"><a name="l00525"></a><span class="lineno"> 525</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga0c84c429cb1d7e2596706c1804dd9cba">controlledRotateAroundAxis</a>(quregVec, 0, qb, param, vec), Contains(<span class="stringliteral">"Invalid target"</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>  SECTION( <span class="stringliteral">"zero rotation axis"</span> ) {</div>
<div class="line"><a name="l00528"></a><span class="lineno"> 528</span>  </div>
<div class="line"><a name="l00529"></a><span class="lineno"> 529</span>  vec = {.<a class="code" href="structVector.html#a0d0459a5b731ac5fb3dff2c6134e6e88">x</a>=0, .y=0, .z=0};</div>
<div class="line"><a name="l00530"></a><span class="lineno"> 530</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga0c84c429cb1d7e2596706c1804dd9cba">controlledRotateAroundAxis</a>(quregVec, 0, 1, param, vec), Contains(<span class="stringliteral">"Invalid axis"</span>) && Contains(<span class="stringliteral">"zero"</span>) );</div>
<div class="line"><a name="l00531"></a><span class="lineno"> 531</span>  }</div>
<div class="line"><a name="l00532"></a><span class="lineno"> 532</span>  }</div>
<div class="line"><a name="l00533"></a><span class="lineno"> 533</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l00534"></a><span class="lineno"> 534</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l00614">controlledRotateAroundAxis()</a>, <a class="el" href="utilities_8cpp_source.html#l00421">getRandomReal()</a>, <a class="el" href="QuEST__common_8c_source.html#l00041">M_PI</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, <a class="el" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, <a class="el" href="QuEST_8h_source.html#l00200">Vector::x</a>, <a class="el" href="QuEST_8h_source.html#l00200">Vector::y</a>, and <a class="el" href="QuEST_8h_source.html#l00200">Vector::z</a>.</p>
</div>
</div>
<a id="ga19c50d3654196a8c0f0574505c8ef816"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga19c50d3654196a8c0f0574505c8ef816">◆ </a></span>TEST_CASE() <span class="overload">[42/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"controlledRotateX" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#ga13f904b417f647c70d163770e65906fc" title="Applies a controlled rotation by a given angle around the X-axis of the Bloch-sphere.">controlledRotateX</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l00542">542</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00542"></a><span class="lineno"> 542</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>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l00545"></a><span class="lineno"> 545</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> param = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-4*<a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>, 4*<a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>);</div>
<div class="line"><a name="l00546"></a><span class="lineno"> 546</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op{</div>
<div class="line"><a name="l00547"></a><span class="lineno"> 547</span>  {cos(param/2), -sin(param/2)*<a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>(0,1)}, </div>
<div class="line"><a name="l00548"></a><span class="lineno"> 548</span>  {-sin(param/2)*<a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>(0,1), cos(param/2)}};</div>
<div class="line"><a name="l00549"></a><span class="lineno"> 549</span>  </div>
<div class="line"><a name="l00550"></a><span class="lineno"> 550</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00551"></a><span class="lineno"> 551</span>  </div>
<div class="line"><a name="l00552"></a><span class="lineno"> 552</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="l00553"></a><span class="lineno"> 553</span>  <span class="keywordtype">int</span> control = GENERATE_COPY( filter([=](<span class="keywordtype">int</span> c){ <span class="keywordflow">return</span> c!=target; }, range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>)) );</div>
<div class="line"><a name="l00554"></a><span class="lineno"> 554</span>  </div>
<div class="line"><a name="l00555"></a><span class="lineno"> 555</span>  SECTION( <span class="stringliteral">"state-vector"</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>  <a class="code" href="group__unitary.html#ga13f904b417f647c70d163770e65906fc">controlledRotateX</a>(quregVec, control, target, param);</div>
<div class="line"><a name="l00558"></a><span class="lineno"> 558</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, control, target, op); </div>
<div class="line"><a name="l00559"></a><span class="lineno"> 559</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l00560"></a><span class="lineno"> 560</span>  }</div>
<div class="line"><a name="l00561"></a><span class="lineno"> 561</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00562"></a><span class="lineno"> 562</span>  </div>
<div class="line"><a name="l00563"></a><span class="lineno"> 563</span>  <a class="code" href="group__unitary.html#ga13f904b417f647c70d163770e65906fc">controlledRotateX</a>(quregMatr, control, target, param);</div>
<div class="line"><a name="l00564"></a><span class="lineno"> 564</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, control, target, op); </div>
<div class="line"><a name="l00565"></a><span class="lineno"> 565</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</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>  }</div>
<div class="line"><a name="l00568"></a><span class="lineno"> 568</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00569"></a><span class="lineno"> 569</span>  </div>
<div class="line"><a name="l00570"></a><span class="lineno"> 570</span>  SECTION( <span class="stringliteral">"control and target collision"</span> ) {</div>
<div class="line"><a name="l00571"></a><span class="lineno"> 571</span>  </div>
<div class="line"><a name="l00572"></a><span class="lineno"> 572</span>  <span class="keywordtype">int</span> qb = GENERATE( range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) );</div>
<div class="line"><a name="l00573"></a><span class="lineno"> 573</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga13f904b417f647c70d163770e65906fc">controlledRotateX</a>(quregVec, qb, qb, param), Contains(<span class="stringliteral">"Control"</span>) && Contains(<span class="stringliteral">"target"</span>) );</div>
<div class="line"><a name="l00574"></a><span class="lineno"> 574</span>  } </div>
<div class="line"><a name="l00575"></a><span class="lineno"> 575</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l00576"></a><span class="lineno"> 576</span>  </div>
<div class="line"><a name="l00577"></a><span class="lineno"> 577</span>  <span class="keywordtype">int</span> qb = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l00578"></a><span class="lineno"> 578</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga13f904b417f647c70d163770e65906fc">controlledRotateX</a>(quregVec, qb, 0, param), Contains(<span class="stringliteral">"Invalid control"</span>) );</div>
<div class="line"><a name="l00579"></a><span class="lineno"> 579</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga13f904b417f647c70d163770e65906fc">controlledRotateX</a>(quregVec, 0, qb, param), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l00580"></a><span class="lineno"> 580</span>  }</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>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l00583"></a><span class="lineno"> 583</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l00220">controlledRotateX()</a>, <a class="el" href="utilities_8cpp_source.html#l00421">getRandomReal()</a>, <a class="el" href="QuEST__common_8c_source.html#l00041">M_PI</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, <a class="el" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>, and <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>.</p>
</div>
</div>
<a id="ga8b6968998c3a5d74b05d440c5e342b66"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga8b6968998c3a5d74b05d440c5e342b66">◆ </a></span>TEST_CASE() <span class="overload">[43/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"controlledRotateY" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#gafbbded98b7233f5da06d74d1db5cbfdb" title="Applies a controlled rotation by a given angle around the Y-axis of the Bloch-sphere.">controlledRotateY</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l00591">591</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00591"></a><span class="lineno"> 591</span>  {</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>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l00594"></a><span class="lineno"> 594</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> param = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-4*<a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>, 4*<a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>);</div>
<div class="line"><a name="l00595"></a><span class="lineno"> 595</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op{{cos(param/2), -sin(param/2)},{sin(param/2), cos(param/2)}};</div>
<div class="line"><a name="l00596"></a><span class="lineno"> 596</span>  </div>
<div class="line"><a name="l00597"></a><span class="lineno"> 597</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00598"></a><span class="lineno"> 598</span>  </div>
<div class="line"><a name="l00599"></a><span class="lineno"> 599</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="l00600"></a><span class="lineno"> 600</span>  <span class="keywordtype">int</span> control = GENERATE_COPY( filter([=](<span class="keywordtype">int</span> c){ <span class="keywordflow">return</span> c!=target; }, range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>)) );</div>
<div class="line"><a name="l00601"></a><span class="lineno"> 601</span>  </div>
<div class="line"><a name="l00602"></a><span class="lineno"> 602</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00603"></a><span class="lineno"> 603</span>  </div>
<div class="line"><a name="l00604"></a><span class="lineno"> 604</span>  <a class="code" href="group__unitary.html#gafbbded98b7233f5da06d74d1db5cbfdb">controlledRotateY</a>(quregVec, control, target, param);</div>
<div class="line"><a name="l00605"></a><span class="lineno"> 605</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, control, target, op); </div>
<div class="line"><a name="l00606"></a><span class="lineno"> 606</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</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>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00609"></a><span class="lineno"> 609</span>  </div>
<div class="line"><a name="l00610"></a><span class="lineno"> 610</span>  <a class="code" href="group__unitary.html#gafbbded98b7233f5da06d74d1db5cbfdb">controlledRotateY</a>(quregMatr, control, target, param);</div>
<div class="line"><a name="l00611"></a><span class="lineno"> 611</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, control, target, op); </div>
<div class="line"><a name="l00612"></a><span class="lineno"> 612</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 2*REAL_EPS) );</div>
<div class="line"><a name="l00613"></a><span class="lineno"> 613</span>  }</div>
<div class="line"><a name="l00614"></a><span class="lineno"> 614</span>  }</div>
<div class="line"><a name="l00615"></a><span class="lineno"> 615</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00616"></a><span class="lineno"> 616</span>  </div>
<div class="line"><a name="l00617"></a><span class="lineno"> 617</span>  SECTION( <span class="stringliteral">"control and target collision"</span> ) {</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="keywordtype">int</span> qb = GENERATE( range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) );</div>
<div class="line"><a name="l00620"></a><span class="lineno"> 620</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gafbbded98b7233f5da06d74d1db5cbfdb">controlledRotateY</a>(quregVec, qb, qb, param), Contains(<span class="stringliteral">"Control"</span>) && Contains(<span class="stringliteral">"target"</span>) );</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>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l00623"></a><span class="lineno"> 623</span>  </div>
<div class="line"><a name="l00624"></a><span class="lineno"> 624</span>  <span class="keywordtype">int</span> qb = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l00625"></a><span class="lineno"> 625</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gafbbded98b7233f5da06d74d1db5cbfdb">controlledRotateY</a>(quregVec, qb, 0, param), Contains(<span class="stringliteral">"Invalid control"</span>) );</div>
<div class="line"><a name="l00626"></a><span class="lineno"> 626</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gafbbded98b7233f5da06d74d1db5cbfdb">controlledRotateY</a>(quregVec, 0, qb, param), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l00627"></a><span class="lineno"> 627</span>  }</div>
<div class="line"><a name="l00628"></a><span class="lineno"> 628</span>  }</div>
<div class="line"><a name="l00629"></a><span class="lineno"> 629</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l00630"></a><span class="lineno"> 630</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l00232">controlledRotateY()</a>, <a class="el" href="utilities_8cpp_source.html#l00421">getRandomReal()</a>, <a class="el" href="QuEST__common_8c_source.html#l00041">M_PI</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, and <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>.</p>
</div>
</div>
<a id="ga803a1dbe819fc49e4844b50d237a4dd6"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga803a1dbe819fc49e4844b50d237a4dd6">◆ </a></span>TEST_CASE() <span class="overload">[44/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"controlledRotateZ" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#ga7eb969c1dd6c949aecf716d2fba71120" title="Applies a controlled rotation by a given angle around the Z-axis of the Bloch-sphere.">controlledRotateZ</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l00638">638</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><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>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l00641"></a><span class="lineno"> 641</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> param = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-4*<a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>, 4*<a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>);</div>
<div class="line"><a name="l00642"></a><span class="lineno"> 642</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op{{<a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(-param/2.),0},{0,<a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(param/2.)}};</div>
<div class="line"><a name="l00643"></a><span class="lineno"> 643</span>  </div>
<div class="line"><a name="l00644"></a><span class="lineno"> 644</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00645"></a><span class="lineno"> 645</span>  </div>
<div class="line"><a name="l00646"></a><span class="lineno"> 646</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="l00647"></a><span class="lineno"> 647</span>  <span class="keywordtype">int</span> control = GENERATE_COPY( filter([=](<span class="keywordtype">int</span> c){ <span class="keywordflow">return</span> c!=target; }, range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>)) );</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>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00650"></a><span class="lineno"> 650</span>  </div>
<div class="line"><a name="l00651"></a><span class="lineno"> 651</span>  <a class="code" href="group__unitary.html#ga7eb969c1dd6c949aecf716d2fba71120">controlledRotateZ</a>(quregVec, control, target, param);</div>
<div class="line"><a name="l00652"></a><span class="lineno"> 652</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, control, target, op); </div>
<div class="line"><a name="l00653"></a><span class="lineno"> 653</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l00654"></a><span class="lineno"> 654</span>  }</div>
<div class="line"><a name="l00655"></a><span class="lineno"> 655</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00656"></a><span class="lineno"> 656</span>  </div>
<div class="line"><a name="l00657"></a><span class="lineno"> 657</span>  <a class="code" href="group__unitary.html#ga7eb969c1dd6c949aecf716d2fba71120">controlledRotateZ</a>(quregMatr, control, target, param);</div>
<div class="line"><a name="l00658"></a><span class="lineno"> 658</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, control, target, op); </div>
<div class="line"><a name="l00659"></a><span class="lineno"> 659</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 10*REAL_EPS) );</div>
<div class="line"><a name="l00660"></a><span class="lineno"> 660</span>  }</div>
<div class="line"><a name="l00661"></a><span class="lineno"> 661</span>  }</div>
<div class="line"><a name="l00662"></a><span class="lineno"> 662</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00663"></a><span class="lineno"> 663</span>  </div>
<div class="line"><a name="l00664"></a><span class="lineno"> 664</span>  SECTION( <span class="stringliteral">"control and target collision"</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>  <span class="keywordtype">int</span> qb = GENERATE( range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) );</div>
<div class="line"><a name="l00667"></a><span class="lineno"> 667</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga7eb969c1dd6c949aecf716d2fba71120">controlledRotateZ</a>(quregVec, qb, qb, param), Contains(<span class="stringliteral">"Control"</span>) && Contains(<span class="stringliteral">"target"</span>) );</div>
<div class="line"><a name="l00668"></a><span class="lineno"> 668</span>  } </div>
<div class="line"><a name="l00669"></a><span class="lineno"> 669</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l00670"></a><span class="lineno"> 670</span>  </div>
<div class="line"><a name="l00671"></a><span class="lineno"> 671</span>  <span class="keywordtype">int</span> qb = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l00672"></a><span class="lineno"> 672</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga7eb969c1dd6c949aecf716d2fba71120">controlledRotateZ</a>(quregVec, qb, 0, param), Contains(<span class="stringliteral">"Invalid control"</span>) );</div>
<div class="line"><a name="l00673"></a><span class="lineno"> 673</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga7eb969c1dd6c949aecf716d2fba71120">controlledRotateZ</a>(quregVec, 0, qb, param), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l00674"></a><span class="lineno"> 674</span>  }</div>
<div class="line"><a name="l00675"></a><span class="lineno"> 675</span>  }</div>
<div class="line"><a name="l00676"></a><span class="lineno"> 676</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l00677"></a><span class="lineno"> 677</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l00244">controlledRotateZ()</a>, <a class="el" href="utilities_8cpp_source.html#l00417">expI()</a>, <a class="el" href="utilities_8cpp_source.html#l00421">getRandomReal()</a>, <a class="el" href="QuEST__common_8c_source.html#l00041">M_PI</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, and <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>.</p>
</div>
</div>
<a id="ga2e579c6fbc9f3f280fbfbea944de9c42"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga2e579c6fbc9f3f280fbfbea944de9c42">◆ </a></span>TEST_CASE() <span class="overload">[45/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"controlledTwoQubitUnitary" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#ga3d89916b46bc4aaf23e938022e6c89c1" title="Apply a general controlled two-qubit unitary (including a global phase factor).">controlledTwoQubitUnitary</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l00685">685</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00685"></a><span class="lineno"> 685</span>  {</div>
<div class="line"><a name="l00686"></a><span class="lineno"> 686</span>  </div>
<div class="line"><a name="l00687"></a><span class="lineno"> 687</span>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l00688"></a><span class="lineno"> 688</span>  </div>
<div class="line"><a name="l00689"></a><span class="lineno"> 689</span>  <span class="comment">// in distributed mode, each node must be able to fit all amps modified by unitary </span></div>
<div class="line"><a name="l00690"></a><span class="lineno"> 690</span>  REQUIRE( quregVec.numAmpsPerChunk >= 4 );</div>
<div class="line"><a name="l00691"></a><span class="lineno"> 691</span>  </div>
<div class="line"><a name="l00692"></a><span class="lineno"> 692</span>  <span class="comment">// every test will use a unique random matrix</span></div>
<div class="line"><a name="l00693"></a><span class="lineno"> 693</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op = <a class="code" href="group__testutilities.html#ga1a5e9b668716b91dd8527ce00f7500cf">getRandomUnitary</a>(2);</div>
<div class="line"><a name="l00694"></a><span class="lineno"> 694</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="l00695"></a><span class="lineno"> 695</span>  </div>
<div class="line"><a name="l00696"></a><span class="lineno"> 696</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00697"></a><span class="lineno"> 697</span>  </div>
<div class="line"><a name="l00698"></a><span class="lineno"> 698</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="l00699"></a><span class="lineno"> 699</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="l00700"></a><span class="lineno"> 700</span>  <span class="keywordtype">int</span> control = GENERATE_COPY( filter([=](<span class="keywordtype">int</span> c){ <span class="keywordflow">return</span> c!=targ1 && c!=targ2; }, range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>)) );</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>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00703"></a><span class="lineno"> 703</span>  </div>
<div class="line"><a name="l00704"></a><span class="lineno"> 704</span>  <a class="code" href="group__unitary.html#ga3d89916b46bc4aaf23e938022e6c89c1">controlledTwoQubitUnitary</a>(quregVec, control, targ1, targ2, matr);</div>
<div class="line"><a name="l00705"></a><span class="lineno"> 705</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, control, targ1, targ2, op); </div>
<div class="line"><a name="l00706"></a><span class="lineno"> 706</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</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>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00709"></a><span class="lineno"> 709</span>  </div>
<div class="line"><a name="l00710"></a><span class="lineno"> 710</span>  <a class="code" href="group__unitary.html#ga3d89916b46bc4aaf23e938022e6c89c1">controlledTwoQubitUnitary</a>(quregMatr, control, targ1, targ2, matr);</div>
<div class="line"><a name="l00711"></a><span class="lineno"> 711</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, control, targ1, targ2, op); </div>
<div class="line"><a name="l00712"></a><span class="lineno"> 712</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 10*REAL_EPS) );</div>
<div class="line"><a name="l00713"></a><span class="lineno"> 713</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>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00716"></a><span class="lineno"> 716</span>  </div>
<div class="line"><a name="l00717"></a><span class="lineno"> 717</span>  SECTION( <span class="stringliteral">"repetition of targets"</span> ) {</div>
<div class="line"><a name="l00718"></a><span class="lineno"> 718</span>  <span class="keywordtype">int</span> targ = 0;</div>
<div class="line"><a name="l00719"></a><span class="lineno"> 719</span>  <span class="keywordtype">int</span> ctrl = 1;</div>
<div class="line"><a name="l00720"></a><span class="lineno"> 720</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga3d89916b46bc4aaf23e938022e6c89c1">controlledTwoQubitUnitary</a>(quregVec, ctrl, targ, targ, matr), Contains(<span class="stringliteral">"target"</span>) && Contains(<span class="stringliteral">"unique"</span>) );</div>
<div class="line"><a name="l00721"></a><span class="lineno"> 721</span>  }</div>
<div class="line"><a name="l00722"></a><span class="lineno"> 722</span>  SECTION( <span class="stringliteral">"control and target collision"</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>  <span class="keywordtype">int</span> targ1 = 1;</div>
<div class="line"><a name="l00725"></a><span class="lineno"> 725</span>  <span class="keywordtype">int</span> targ2 = 2;</div>
<div class="line"><a name="l00726"></a><span class="lineno"> 726</span>  <span class="keywordtype">int</span> ctrl = GENERATE( 1,2 ); <span class="comment">// catch2 bug; can't do GENERATE_COPY( targ1, targ2 )</span></div>
<div class="line"><a name="l00727"></a><span class="lineno"> 727</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga3d89916b46bc4aaf23e938022e6c89c1">controlledTwoQubitUnitary</a>(quregVec, ctrl, targ1, targ2, matr), Contains(<span class="stringliteral">"Control"</span>) && Contains(<span class="stringliteral">"target"</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">"qubit indices"</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>  <span class="comment">// valid config</span></div>
<div class="line"><a name="l00732"></a><span class="lineno"> 732</span>  <span class="keywordtype">int</span> ctrl = 0;</div>
<div class="line"><a name="l00733"></a><span class="lineno"> 733</span>  <span class="keywordtype">int</span> targ1 = 1;</div>
<div class="line"><a name="l00734"></a><span class="lineno"> 734</span>  <span class="keywordtype">int</span> targ2 = 2;</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>  <span class="keywordtype">int</span> qb = 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__unitary.html#ga3d89916b46bc4aaf23e938022e6c89c1">controlledTwoQubitUnitary</a>(quregVec, qb, targ1, targ2, matr), Contains(<span class="stringliteral">"Invalid control"</span>) );</div>
<div class="line"><a name="l00738"></a><span class="lineno"> 738</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga3d89916b46bc4aaf23e938022e6c89c1">controlledTwoQubitUnitary</a>(quregVec, ctrl, qb, targ2, matr), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l00739"></a><span class="lineno"> 739</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga3d89916b46bc4aaf23e938022e6c89c1">controlledTwoQubitUnitary</a>(quregVec, ctrl, targ1, qb, matr), Contains(<span class="stringliteral">"Invalid target"</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>  SECTION( <span class="stringliteral">"unitarity"</span> ) {</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>  matr.<a class="code" href="structComplexMatrix4.html#aeadc9893e1b16cdd585dac523e73926c">real</a>[0][0] = 0; <span class="comment">// break matr unitarity</span></div>
<div class="line"><a name="l00744"></a><span class="lineno"> 744</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga3d89916b46bc4aaf23e938022e6c89c1">controlledTwoQubitUnitary</a>(quregVec, 0, 1, 2, matr), Contains(<span class="stringliteral">"unitary"</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">"unitary fits in node"</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="comment">// pretend we have a very limited distributed memory</span></div>
<div class="line"><a name="l00749"></a><span class="lineno"> 749</span>  quregVec.numAmpsPerChunk = 1;</div>
<div class="line"><a name="l00750"></a><span class="lineno"> 750</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga3d89916b46bc4aaf23e938022e6c89c1">controlledTwoQubitUnitary</a>(quregVec, 0, 1, 2, matr), Contains(<span class="stringliteral">"targets too many qubits"</span>));</div>
<div class="line"><a name="l00751"></a><span class="lineno"> 751</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>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l00754"></a><span class="lineno"> 754</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l00269">controlledTwoQubitUnitary()</a>, <a class="el" href="utilities_8cpp_source.html#l00530">getRandomUnitary()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, <a class="el" href="QuEST_8h_source.html#l00177">ComplexMatrix4::real</a>, and <a class="el" href="utilities_8cpp_source.html#l01027">toComplexMatrix4()</a>.</p>
</div>
</div>
<a id="ga9b4d4087da235bc2ea909ca2586c8ab6"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga9b4d4087da235bc2ea909ca2586c8ab6">◆ </a></span>TEST_CASE() <span class="overload">[46/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"controlledUnitary" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#gaa3fb996a5cadd098f4acd8aec955cf9c" title="Apply a general controlled unitary (single control, single target), which can include a global phase ...">controlledUnitary</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l00762">762</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00762"></a><span class="lineno"> 762</span>  {</div>
<div class="line"><a name="l00763"></a><span class="lineno"> 763</span>  </div>
<div class="line"><a name="l00764"></a><span class="lineno"> 764</span>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l00765"></a><span class="lineno"> 765</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op = <a class="code" href="group__testutilities.html#ga1a5e9b668716b91dd8527ce00f7500cf">getRandomUnitary</a>(1);</div>
<div class="line"><a name="l00766"></a><span class="lineno"> 766</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="l00767"></a><span class="lineno"> 767</span>  </div>
<div class="line"><a name="l00768"></a><span class="lineno"> 768</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00769"></a><span class="lineno"> 769</span>  </div>
<div class="line"><a name="l00770"></a><span class="lineno"> 770</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="l00771"></a><span class="lineno"> 771</span>  <span class="keywordtype">int</span> control = GENERATE_COPY( filter([=](<span class="keywordtype">int</span> c){ <span class="keywordflow">return</span> c!=target; }, range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>)) );</div>
<div class="line"><a name="l00772"></a><span class="lineno"> 772</span>  </div>
<div class="line"><a name="l00773"></a><span class="lineno"> 773</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</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>  <a class="code" href="group__unitary.html#gaa3fb996a5cadd098f4acd8aec955cf9c">controlledUnitary</a>(quregVec, control, target, matr);</div>
<div class="line"><a name="l00776"></a><span class="lineno"> 776</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, control, target, op); </div>
<div class="line"><a name="l00777"></a><span class="lineno"> 777</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l00778"></a><span class="lineno"> 778</span>  }</div>
<div class="line"><a name="l00779"></a><span class="lineno"> 779</span>  SECTION( <span class="stringliteral">"density-matrix"</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="group__unitary.html#gaa3fb996a5cadd098f4acd8aec955cf9c">controlledUnitary</a>(quregMatr, control, target, matr);</div>
<div class="line"><a name="l00782"></a><span class="lineno"> 782</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, control, target, op); </div>
<div class="line"><a name="l00783"></a><span class="lineno"> 783</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 10*REAL_EPS) );</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="l00786"></a><span class="lineno"> 786</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00787"></a><span class="lineno"> 787</span>  </div>
<div class="line"><a name="l00788"></a><span class="lineno"> 788</span>  SECTION( <span class="stringliteral">"control and target collision"</span> ) {</div>
<div class="line"><a name="l00789"></a><span class="lineno"> 789</span>  </div>
<div class="line"><a name="l00790"></a><span class="lineno"> 790</span>  <span class="keywordtype">int</span> qb = GENERATE( range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) );</div>
<div class="line"><a name="l00791"></a><span class="lineno"> 791</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gaa3fb996a5cadd098f4acd8aec955cf9c">controlledUnitary</a>(quregVec, qb, qb, matr), Contains(<span class="stringliteral">"Control"</span>) && Contains(<span class="stringliteral">"target"</span>) );</div>
<div class="line"><a name="l00792"></a><span class="lineno"> 792</span>  } </div>
<div class="line"><a name="l00793"></a><span class="lineno"> 793</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l00794"></a><span class="lineno"> 794</span>  </div>
<div class="line"><a name="l00795"></a><span class="lineno"> 795</span>  <span class="keywordtype">int</span> qb = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l00796"></a><span class="lineno"> 796</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gaa3fb996a5cadd098f4acd8aec955cf9c">controlledUnitary</a>(quregVec, qb, 0, matr), Contains(<span class="stringliteral">"Invalid control"</span>) );</div>
<div class="line"><a name="l00797"></a><span class="lineno"> 797</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gaa3fb996a5cadd098f4acd8aec955cf9c">controlledUnitary</a>(quregVec, 0, qb, matr), Contains(<span class="stringliteral">"Invalid target"</span>) );</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>  SECTION( <span class="stringliteral">"unitarity"</span> ) {</div>
<div class="line"><a name="l00800"></a><span class="lineno"> 800</span>  </div>
<div class="line"><a name="l00801"></a><span class="lineno"> 801</span>  matr.<a class="code" href="structComplexMatrix2.html#a3ea98d545b67a190ee6abe936c72076f">real</a>[0][0] = 0; <span class="comment">// break unitarity</span></div>
<div class="line"><a name="l00802"></a><span class="lineno"> 802</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gaa3fb996a5cadd098f4acd8aec955cf9c">controlledUnitary</a>(quregVec, 0, 1, matr), Contains(<span class="stringliteral">"unitary"</span>) );</div>
<div class="line"><a name="l00803"></a><span class="lineno"> 803</span>  }</div>
<div class="line"><a name="l00804"></a><span class="lineno"> 804</span>  }</div>
<div class="line"><a name="l00805"></a><span class="lineno"> 805</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l00806"></a><span class="lineno"> 806</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l00360">controlledUnitary()</a>, <a class="el" href="utilities_8cpp_source.html#l00530">getRandomUnitary()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, <a class="el" href="QuEST_8h_source.html#l00139">ComplexMatrix2::real</a>, and <a class="el" href="utilities_8cpp_source.html#l01021">toComplexMatrix2()</a>.</p>
</div>
</div>
<a id="ga6d178e69b7654ae26e9f6365fd8208e8"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga6d178e69b7654ae26e9f6365fd8208e8">◆ </a></span>TEST_CASE() <span class="overload">[47/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"createCloneQureg" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[data_structures] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__type.html#gabd07eee133dcd4e6ae7c2d2ce4c42978" title="Create a new Qureg which is an exact clone of the passed qureg, which can be either a state-vector or...">createCloneQureg</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__data__structures_8cpp_source.html#l00057">57</a> of file <a class="el" href="test__data__structures_8cpp_source.html">test_data_structures.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00057"></a><span class="lineno"> 57</span>  {</div>
<div class="line"><a name="l00058"></a><span class="lineno"> 58</span>  </div>
<div class="line"><a name="l00059"></a><span class="lineno"> 59</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</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>  <a class="code" href="structQureg.html">Qureg</a> a = <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="l00062"></a><span class="lineno"> 62</span>  <a class="code" href="structQureg.html">Qureg</a> b = <a class="code" href="group__type.html#gabd07eee133dcd4e6ae7c2d2ce4c42978">createCloneQureg</a>(a, <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>  <span class="comment">// check properties are the same</span></div>
<div class="line"><a name="l00065"></a><span class="lineno"> 65</span>  REQUIRE( b.<a class="code" href="structQureg.html#acf78445e9435d09f44f0cc832c6aee79">isDensityMatrix</a> == a.<a class="code" href="structQureg.html#acf78445e9435d09f44f0cc832c6aee79">isDensityMatrix</a> );</div>
<div class="line"><a name="l00066"></a><span class="lineno"> 66</span>  REQUIRE( b.<a class="code" href="structQureg.html#ad08dff5316b8937f4b2a1417591543dc">numQubitsRepresented</a> == a.<a class="code" href="structQureg.html#ad08dff5316b8937f4b2a1417591543dc">numQubitsRepresented</a> );</div>
<div class="line"><a name="l00067"></a><span class="lineno"> 67</span>  REQUIRE( b.<a class="code" href="structQureg.html#a0a86e8a50ea8c998b4a0a6640c5a1218">numQubitsInStateVec</a> == a.<a class="code" href="structQureg.html#a0a86e8a50ea8c998b4a0a6640c5a1218">numQubitsInStateVec</a> );</div>
<div class="line"><a name="l00068"></a><span class="lineno"> 68</span>  REQUIRE( b.<a class="code" href="structQureg.html#ab0ea0358482b62f43fdd781469607d97">numAmpsPerChunk</a> == a.<a class="code" href="structQureg.html#ab0ea0358482b62f43fdd781469607d97">numAmpsPerChunk</a> );</div>
<div class="line"><a name="l00069"></a><span class="lineno"> 69</span>  REQUIRE( b.<a class="code" href="structQureg.html#adef4935cac95763c29164cf99b144ed4">numAmpsTotal</a> == a.<a class="code" href="structQureg.html#adef4935cac95763c29164cf99b144ed4">numAmpsTotal</a> );</div>
<div class="line"><a name="l00070"></a><span class="lineno"> 70</span>  </div>
<div class="line"><a name="l00071"></a><span class="lineno"> 71</span>  <span class="comment">// check state-vector is the same (works for GPU and distributed)</span></div>
<div class="line"><a name="l00072"></a><span class="lineno"> 72</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(a, b) ); </div>
<div class="line"><a name="l00073"></a><span class="lineno"> 73</span>  </div>
<div class="line"><a name="l00074"></a><span class="lineno"> 74</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(a, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00075"></a><span class="lineno"> 75</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(b, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00076"></a><span class="lineno"> 76</span>  }</div>
<div class="line"><a name="l00077"></a><span class="lineno"> 77</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00078"></a><span class="lineno"> 78</span>  </div>
<div class="line"><a name="l00079"></a><span class="lineno"> 79</span>  <a class="code" href="structQureg.html">Qureg</a> a = <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="l00080"></a><span class="lineno"> 80</span>  <a class="code" href="structQureg.html">Qureg</a> b = <a class="code" href="group__type.html#gabd07eee133dcd4e6ae7c2d2ce4c42978">createCloneQureg</a>(a, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00081"></a><span class="lineno"> 81</span>  </div>
<div class="line"><a name="l00082"></a><span class="lineno"> 82</span>  <span class="comment">// check properties are the same</span></div>
<div class="line"><a name="l00083"></a><span class="lineno"> 83</span>  REQUIRE( b.<a class="code" href="structQureg.html#acf78445e9435d09f44f0cc832c6aee79">isDensityMatrix</a> == a.<a class="code" href="structQureg.html#acf78445e9435d09f44f0cc832c6aee79">isDensityMatrix</a> );</div>
<div class="line"><a name="l00084"></a><span class="lineno"> 84</span>  REQUIRE( b.<a class="code" href="structQureg.html#ad08dff5316b8937f4b2a1417591543dc">numQubitsRepresented</a> == a.<a class="code" href="structQureg.html#ad08dff5316b8937f4b2a1417591543dc">numQubitsRepresented</a> );</div>
<div class="line"><a name="l00085"></a><span class="lineno"> 85</span>  REQUIRE( b.<a class="code" href="structQureg.html#a0a86e8a50ea8c998b4a0a6640c5a1218">numQubitsInStateVec</a> == a.<a class="code" href="structQureg.html#a0a86e8a50ea8c998b4a0a6640c5a1218">numQubitsInStateVec</a> );</div>
<div class="line"><a name="l00086"></a><span class="lineno"> 86</span>  REQUIRE( b.<a class="code" href="structQureg.html#ab0ea0358482b62f43fdd781469607d97">numAmpsPerChunk</a> == a.<a class="code" href="structQureg.html#ab0ea0358482b62f43fdd781469607d97">numAmpsPerChunk</a> );</div>
<div class="line"><a name="l00087"></a><span class="lineno"> 87</span>  REQUIRE( b.<a class="code" href="structQureg.html#adef4935cac95763c29164cf99b144ed4">numAmpsTotal</a> == a.<a class="code" href="structQureg.html#adef4935cac95763c29164cf99b144ed4">numAmpsTotal</a> );</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">// check state-vector is the same (works for GPU and distributed)</span></div>
<div class="line"><a name="l00090"></a><span class="lineno"> 90</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(a, b) ); </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>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(a, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00093"></a><span class="lineno"> 93</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(b, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00094"></a><span class="lineno"> 94</span>  }</div>
<div class="line"><a name="l00095"></a><span class="lineno"> 95</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00064">createCloneQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="QuEST_8h_source.html#l00325">Qureg::isDensityMatrix</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="QuEST_8h_source.html#l00332">Qureg::numAmpsPerChunk</a>, <a class="el" href="QuEST_8h_source.html#l00334">Qureg::numAmpsTotal</a>, <a class="el" href="QuEST_8h_source.html#l00329">Qureg::numQubitsInStateVec</a>, <a class="el" href="QuEST_8h_source.html#l00327">Qureg::numQubitsRepresented</a>, and <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>.</p>
</div>
</div>
<a id="gaf929e0eed564772adcd99d2b1cab3818"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaf929e0eed564772adcd99d2b1cab3818">◆ </a></span>TEST_CASE() <span class="overload">[48/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"createComplexMatrixN" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[data_structures] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__type.html#ga815103261fb22ea9690e1427571df00e" title="Allocate dynamic memory for a square complex matrix of any size, which can be passed to functions lik...">createComplexMatrixN</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__data__structures_8cpp_source.html#l00103">103</a> of file <a class="el" href="test__data__structures_8cpp_source.html">test_data_structures.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00103"></a><span class="lineno"> 103</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>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00106"></a><span class="lineno"> 106</span>  </div>
<div class="line"><a name="l00107"></a><span class="lineno"> 107</span>  <span class="keywordtype">int</span> numQb = GENERATE( range(1,10+1) );</div>
<div class="line"><a name="l00108"></a><span class="lineno"> 108</span>  <a class="code" href="structComplexMatrixN.html">ComplexMatrixN</a> m = <a class="code" href="group__type.html#ga815103261fb22ea9690e1427571df00e">createComplexMatrixN</a>(numQb);</div>
<div class="line"><a name="l00109"></a><span class="lineno"> 109</span>  </div>
<div class="line"><a name="l00110"></a><span class="lineno"> 110</span>  <span class="comment">// ensure elems are created and initialised to 0</span></div>
<div class="line"><a name="l00111"></a><span class="lineno"> 111</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(<a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(m), <a class="code" href="group__testutilities.html#ga6ccbb15b0f234e926be96a153181b63a">getZeroMatrix</a>(1<<numQb)) );</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>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(m);</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">"input validation"</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>  SECTION( <span class="stringliteral">"number of qubits"</span> ) {</div>
<div class="line"><a name="l00118"></a><span class="lineno"> 118</span>  </div>
<div class="line"><a name="l00119"></a><span class="lineno"> 119</span>  <span class="keywordtype">int</span> numQb = GENERATE( -1, 0 );</div>
<div class="line"><a name="l00120"></a><span class="lineno"> 120</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__type.html#ga815103261fb22ea9690e1427571df00e">createComplexMatrixN</a>(numQb), Contains(<span class="stringliteral">"Invalid number of qubits"</span>) );</div>
<div class="line"><a name="l00121"></a><span class="lineno"> 121</span>  }</div>
<div class="line"><a name="l00122"></a><span class="lineno"> 122</span>  }</div>
<div class="line"><a name="l00123"></a><span class="lineno"> 123</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l01348">createComplexMatrixN()</a>, <a class="el" href="QuEST_8c_source.html#l01369">destroyComplexMatrixN()</a>, <a class="el" href="utilities_8cpp_source.html#l00153">getZeroMatrix()</a>, and <a class="el" href="utilities_8cpp_source.html#l01044">toQMatrix()</a>.</p>
</div>
</div>
<a id="gaf8887d313b85b6d9c90771e27fc0f9ff"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaf8887d313b85b6d9c90771e27fc0f9ff">◆ </a></span>TEST_CASE() <span class="overload">[49/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"createDensityQureg" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[data_structures] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__type.html#ga93e55b6650b408abb30a1d4a8bce757c" title="Creates a density matrix Qureg object representing a set of qubits which can enter noisy and mixed st...">createDensityQureg</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__data__structures_8cpp_source.html#l00131">131</a> of file <a class="el" href="test__data__structures_8cpp_source.html">test_data_structures.cpp</a>.</p>
<div class="fragment"><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>  </div>
<div class="line"><a name="l00133"></a><span class="lineno"> 133</span>  <span class="comment">// must be at least one amplitude per node</span></div>
<div class="line"><a name="l00134"></a><span class="lineno"> 134</span>  <span class="keywordtype">int</span> minNumQb = <a class="code" href="group__testutilities.html#ga267884197cf7f1d428021cb12a57360c">calcLog2</a>(<a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>.<a class="code" href="structQuESTEnv.html#af22aacd7c9905accae28484785c193b4">numRanks</a>) - 1; <span class="comment">// density matrix has 2*numQb in state-vec</span></div>
<div class="line"><a name="l00135"></a><span class="lineno"> 135</span>  <span class="keywordflow">if</span> (minNumQb <= 0)</div>
<div class="line"><a name="l00136"></a><span class="lineno"> 136</span>  minNumQb = 1;</div>
<div class="line"><a name="l00137"></a><span class="lineno"> 137</span>  </div>
<div class="line"><a name="l00138"></a><span class="lineno"> 138</span>  SECTION( <span class="stringliteral">"correctness"</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="comment">// try 10 valid number of qubits</span></div>
<div class="line"><a name="l00141"></a><span class="lineno"> 141</span>  <span class="keywordtype">int</span> numQb = GENERATE_COPY( range(minNumQb, minNumQb+10) );</div>
<div class="line"><a name="l00142"></a><span class="lineno"> 142</span>  <a class="code" href="structQureg.html">Qureg</a> reg = <a class="code" href="group__type.html#ga93e55b6650b408abb30a1d4a8bce757c">createDensityQureg</a>(numQb, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</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">// ensure elems (CPU and/or GPU) are created, and reg begins in |0><0|</span></div>
<div class="line"><a name="l00145"></a><span class="lineno"> 145</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> ref = <a class="code" href="group__testutilities.html#ga6ccbb15b0f234e926be96a153181b63a">getZeroMatrix</a>(1<<numQb);</div>
<div class="line"><a name="l00146"></a><span class="lineno"> 146</span>  ref[0][0] = 1; <span class="comment">// |0><0|</span></div>
<div class="line"><a name="l00147"></a><span class="lineno"> 147</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(reg, ref) );</div>
<div class="line"><a name="l00148"></a><span class="lineno"> 148</span>  </div>
<div class="line"><a name="l00149"></a><span class="lineno"> 149</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(reg, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</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>  SECTION( <span class="stringliteral">"input validation"</span>) {</div>
<div class="line"><a name="l00152"></a><span class="lineno"> 152</span>  </div>
<div class="line"><a name="l00153"></a><span class="lineno"> 153</span>  SECTION( <span class="stringliteral">"number of qubits"</span> ) {</div>
<div class="line"><a name="l00154"></a><span class="lineno"> 154</span>  </div>
<div class="line"><a name="l00155"></a><span class="lineno"> 155</span>  <span class="keywordtype">int</span> numQb = GENERATE( -1, 0 );</div>
<div class="line"><a name="l00156"></a><span class="lineno"> 156</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__type.html#ga93e55b6650b408abb30a1d4a8bce757c">createDensityQureg</a>(numQb, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>), Contains(<span class="stringliteral">"Invalid number of qubits"</span>) );</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">"number of amplitudes"</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">// use local QuESTEnv to safely modify</span></div>
<div class="line"><a name="l00161"></a><span class="lineno"> 161</span>  <a class="code" href="structQuESTEnv.html">QuESTEnv</a> env = <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>;</div>
<div class="line"><a name="l00162"></a><span class="lineno"> 162</span>  </div>
<div class="line"><a name="l00163"></a><span class="lineno"> 163</span>  <span class="comment">// too many amplitudes to store in type</span></div>
<div class="line"><a name="l00164"></a><span class="lineno"> 164</span>  <span class="keywordtype">int</span> maxQb = (int) <a class="code" href="group__testutilities.html#ga267884197cf7f1d428021cb12a57360c">calcLog2</a>(SIZE_MAX) / 2;</div>
<div class="line"><a name="l00165"></a><span class="lineno"> 165</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__type.html#ga93e55b6650b408abb30a1d4a8bce757c">createDensityQureg</a>(maxQb+1, env), Contains(<span class="stringliteral">"Too many qubits"</span>) && Contains(<span class="stringliteral">"size_t type"</span>) );</div>
<div class="line"><a name="l00166"></a><span class="lineno"> 166</span>  </div>
<div class="line"><a name="l00167"></a><span class="lineno"> 167</span>  <span class="comment">/* n-qubit density matrix contains 2^(2n) amplitudes </span></div>
<div class="line"><a name="l00168"></a><span class="lineno"> 168</span> <span class="comment"> * so can be spread between at most 2^(2n) ranks</span></div>
<div class="line"><a name="l00169"></a><span class="lineno"> 169</span> <span class="comment"> */</span></div>
<div class="line"><a name="l00170"></a><span class="lineno"> 170</span>  <span class="keywordtype">int</span> minQb = GENERATE_COPY( range(3,maxQb) );</div>
<div class="line"><a name="l00171"></a><span class="lineno"> 171</span>  env.<a class="code" href="structQuESTEnv.html#af22aacd7c9905accae28484785c193b4">numRanks</a> = (int) pow(2, 2*minQb);</div>
<div class="line"><a name="l00172"></a><span class="lineno"> 172</span>  <span class="keywordtype">int</span> numQb = GENERATE_COPY( range(1,minQb) );</div>
<div class="line"><a name="l00173"></a><span class="lineno"> 173</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__type.html#ga93e55b6650b408abb30a1d4a8bce757c">createDensityQureg</a>(numQb, env), Contains(<span class="stringliteral">"Too few qubits"</span>) );</div>
<div class="line"><a name="l00174"></a><span class="lineno"> 174</span>  }</div>
<div class="line"><a name="l00175"></a><span class="lineno"> 175</span>  SECTION( <span class="stringliteral">"available memory"</span> ) {</div>
<div class="line"><a name="l00176"></a><span class="lineno"> 176</span>  </div>
<div class="line"><a name="l00177"></a><span class="lineno"> 177</span>  <span class="comment">/* there is no reliable way to force the malloc statements to</span></div>
<div class="line"><a name="l00178"></a><span class="lineno"> 178</span> <span class="comment"> * fail, and hence trigger the matrixInit validation */</span></div>
<div class="line"><a name="l00179"></a><span class="lineno"> 179</span>  SUCCEED( );</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>  }</div>
<div class="line"><a name="l00182"></a><span class="lineno"> 182</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST__validation_8c_source.html#l00328">calcLog2()</a>, <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00153">getZeroMatrix()</a>, <a class="el" href="QuEST_8h_source.html#l00365">QuESTEnv::numRanks</a>, and <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>.</p>
</div>
</div>
<a id="ga41cd862a085c00936840cc0e616b6a2d"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga41cd862a085c00936840cc0e616b6a2d">◆ </a></span>TEST_CASE() <span class="overload">[50/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"createDiagonalOp" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[data_structures] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__type.html#gaebf896dd8d5eeaf9fd896f6cc8e334fe" title="Creates a DiagonalOp representing a diagonal operator on the full Hilbert space of a Qureg.">createDiagonalOp</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__data__structures_8cpp_source.html#l00190">190</a> of file <a class="el" href="test__data__structures_8cpp_source.html">test_data_structures.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00190"></a><span class="lineno"> 190</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>  <span class="comment">// must be at least one amplitude per node</span></div>
<div class="line"><a name="l00193"></a><span class="lineno"> 193</span>  <span class="keywordtype">int</span> minNumQb = <a class="code" href="group__testutilities.html#ga267884197cf7f1d428021cb12a57360c">calcLog2</a>(<a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>.<a class="code" href="structQuESTEnv.html#af22aacd7c9905accae28484785c193b4">numRanks</a>);</div>
<div class="line"><a name="l00194"></a><span class="lineno"> 194</span>  <span class="keywordflow">if</span> (minNumQb == 0)</div>
<div class="line"><a name="l00195"></a><span class="lineno"> 195</span>  minNumQb = 1;</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>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00198"></a><span class="lineno"> 198</span>  </div>
<div class="line"><a name="l00199"></a><span class="lineno"> 199</span>  <span class="comment">// try 10 valid number of qubits</span></div>
<div class="line"><a name="l00200"></a><span class="lineno"> 200</span>  <span class="keywordtype">int</span> numQb = GENERATE_COPY( range(minNumQb, minNumQb+10) );</div>
<div class="line"><a name="l00201"></a><span class="lineno"> 201</span>  <a class="code" href="structDiagonalOp.html">DiagonalOp</a> op = <a class="code" href="group__type.html#gaebf896dd8d5eeaf9fd896f6cc8e334fe">createDiagonalOp</a>(numQb, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00202"></a><span class="lineno"> 202</span>  </div>
<div class="line"><a name="l00203"></a><span class="lineno"> 203</span>  <span class="comment">// check properties are correct</span></div>
<div class="line"><a name="l00204"></a><span class="lineno"> 204</span>  REQUIRE( op.<a class="code" href="structDiagonalOp.html#a5131eeb67aafb4c19ac98270c3266742">numQubits</a> == numQb );</div>
<div class="line"><a name="l00205"></a><span class="lineno"> 205</span>  REQUIRE( op.<a class="code" href="structDiagonalOp.html#aa91713a22c95a383bba55e56c4a4e37a">chunkId</a> == <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>.<a class="code" href="structQuESTEnv.html#aa648bb336cf8598467cb62db00b9cee8">rank</a> );</div>
<div class="line"><a name="l00206"></a><span class="lineno"> 206</span>  REQUIRE( op.<a class="code" href="structDiagonalOp.html#ada3bffa8e414f883e415dd74e46cd879">numChunks</a> == <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>.<a class="code" href="structQuESTEnv.html#af22aacd7c9905accae28484785c193b4">numRanks</a> );</div>
<div class="line"><a name="l00207"></a><span class="lineno"> 207</span>  REQUIRE( op.<a class="code" href="structDiagonalOp.html#a2c6eab631ef48b4978db026c98180eee">numElemsPerChunk</a> == (1LL << numQb) / <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>.<a class="code" href="structQuESTEnv.html#af22aacd7c9905accae28484785c193b4">numRanks</a> );</div>
<div class="line"><a name="l00208"></a><span class="lineno"> 208</span>  REQUIRE( op.<a class="code" href="structDiagonalOp.html#a1d66088bed235d524cd452b107694d5c">real</a> != NULL );</div>
<div class="line"><a name="l00209"></a><span class="lineno"> 209</span>  REQUIRE( op.<a class="code" href="structDiagonalOp.html#a85c3f52533efe831bbe40b9a48602388">imag</a> != NULL );</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>  <span class="comment">// check all elements in CPU are zero </span></div>
<div class="line"><a name="l00212"></a><span class="lineno"> 212</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(<a class="code" href="group__testutilities.html#gade0e7c37811a69f1c21c88c11943a19f">toQVector</a>(op), <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a>(1LL << numQb)) );</div>
<div class="line"><a name="l00213"></a><span class="lineno"> 213</span>  </div>
<div class="line"><a name="l00214"></a><span class="lineno"> 214</span>  <span class="comment">// (no concise way to check this for GPU)</span></div>
<div class="line"><a name="l00215"></a><span class="lineno"> 215</span>  </div>
<div class="line"><a name="l00216"></a><span class="lineno"> 216</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="l00217"></a><span class="lineno"> 217</span>  }</div>
<div class="line"><a name="l00218"></a><span class="lineno"> 218</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00219"></a><span class="lineno"> 219</span>  </div>
<div class="line"><a name="l00220"></a><span class="lineno"> 220</span>  SECTION( <span class="stringliteral">"number of qubits"</span> ) {</div>
<div class="line"><a name="l00221"></a><span class="lineno"> 221</span>  </div>
<div class="line"><a name="l00222"></a><span class="lineno"> 222</span>  <span class="keywordtype">int</span> numQb = GENERATE( -1, 0 );</div>
<div class="line"><a name="l00223"></a><span class="lineno"> 223</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__type.html#gaebf896dd8d5eeaf9fd896f6cc8e334fe">createDiagonalOp</a>(numQb, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>), Contains(<span class="stringliteral">"Invalid number of qubits"</span>) );</div>
<div class="line"><a name="l00224"></a><span class="lineno"> 224</span>  }</div>
<div class="line"><a name="l00225"></a><span class="lineno"> 225</span>  SECTION( <span class="stringliteral">"number of elements"</span> ) {</div>
<div class="line"><a name="l00226"></a><span class="lineno"> 226</span>  </div>
<div class="line"><a name="l00227"></a><span class="lineno"> 227</span>  <span class="comment">// use local QuESTEnv to safely modify</span></div>
<div class="line"><a name="l00228"></a><span class="lineno"> 228</span>  <a class="code" href="structQuESTEnv.html">QuESTEnv</a> env = <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>;</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>  <span class="comment">// too many amplitudes to store in type</span></div>
<div class="line"><a name="l00231"></a><span class="lineno"> 231</span>  <span class="keywordtype">int</span> maxQb = (int) <a class="code" href="group__testutilities.html#ga267884197cf7f1d428021cb12a57360c">calcLog2</a>(SIZE_MAX);</div>
<div class="line"><a name="l00232"></a><span class="lineno"> 232</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__type.html#gaebf896dd8d5eeaf9fd896f6cc8e334fe">createDiagonalOp</a>(maxQb+1, env), Contains(<span class="stringliteral">"Too many qubits"</span>) && Contains(<span class="stringliteral">"size_t type"</span>) );</div>
<div class="line"><a name="l00233"></a><span class="lineno"> 233</span>  </div>
<div class="line"><a name="l00234"></a><span class="lineno"> 234</span>  <span class="comment">// too few amplitudes to distribute</span></div>
<div class="line"><a name="l00235"></a><span class="lineno"> 235</span>  <span class="keywordtype">int</span> minQb = GENERATE_COPY( range(2,maxQb) );</div>
<div class="line"><a name="l00236"></a><span class="lineno"> 236</span>  env.<a class="code" href="structQuESTEnv.html#af22aacd7c9905accae28484785c193b4">numRanks</a> = (int) pow(2, minQb);</div>
<div class="line"><a name="l00237"></a><span class="lineno"> 237</span>  <span class="keywordtype">int</span> numQb = GENERATE_COPY( range(1,minQb) );</div>
<div class="line"><a name="l00238"></a><span class="lineno"> 238</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__type.html#gaebf896dd8d5eeaf9fd896f6cc8e334fe">createDiagonalOp</a>(numQb, env), Contains(<span class="stringliteral">"Too few qubits"</span>) && Contains(<span class="stringliteral">"distributed"</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>  SECTION( <span class="stringliteral">"available memory"</span> ) {</div>
<div class="line"><a name="l00241"></a><span class="lineno"> 241</span>  </div>
<div class="line"><a name="l00242"></a><span class="lineno"> 242</span>  <span class="comment">/* there is no reliable way to force the malloc statements to</span></div>
<div class="line"><a name="l00243"></a><span class="lineno"> 243</span> <span class="comment"> * fail, and hence trigger the diagonalOpInit validation */</span></div>
<div class="line"><a name="l00244"></a><span class="lineno"> 244</span>  SUCCEED( );</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><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST__validation_8c_source.html#l00328">calcLog2()</a>, <a class="el" href="QuEST_8h_source.html#l00306">DiagonalOp::chunkId</a>, <a class="el" href="QuEST_8c_source.html#l01518">createDiagonalOp()</a>, <a class="el" href="QuEST_8c_source.html#l01524">destroyDiagonalOp()</a>, <a class="el" href="QuEST_8h_source.html#l00310">DiagonalOp::imag</a>, <a class="el" href="QuEST_8h_source.html#l00304">DiagonalOp::numChunks</a>, <a class="el" href="QuEST_8h_source.html#l00302">DiagonalOp::numElemsPerChunk</a>, <a class="el" href="QuEST_8h_source.html#l00300">DiagonalOp::numQubits</a>, <a class="el" href="QuEST_8h_source.html#l00365">QuESTEnv::numRanks</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, <a class="el" href="QuEST_8h_source.html#l00364">QuESTEnv::rank</a>, <a class="el" href="QuEST_8h_source.html#l00308">DiagonalOp::real</a>, and <a class="el" href="utilities_8cpp_source.html#l01113">toQVector()</a>.</p>
</div>
</div>
<a id="ga06be79820f0c646ac3bb918f91bbd02d"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga06be79820f0c646ac3bb918f91bbd02d">◆ </a></span>TEST_CASE() <span class="overload">[51/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"createDiagonalOpFromPauliHamilFile" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[data_structures] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__type.html#gaa86572b44755646858d6b0292d53cc15" title="Creates and initialiases a diagonal operator from the Z Pauli Hamiltonian encoded in file with filena...">createDiagonalOpFromPauliHamilFile</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__data__structures_8cpp_source.html#l00255">255</a> of file <a class="el" href="test__data__structures_8cpp_source.html">test_data_structures.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00255"></a><span class="lineno"> 255</span>  {</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">// files created & populated during the test, and deleted afterward</span></div>
<div class="line"><a name="l00258"></a><span class="lineno"> 258</span>  <span class="keywordtype">char</span> fnPrefix[] = <span class="stringliteral">"temp_createDiagonalOpFromPauliHamilFile"</span>;</div>
<div class="line"><a name="l00259"></a><span class="lineno"> 259</span>  <span class="keywordtype">char</span> fn[100];</div>
<div class="line"><a name="l00260"></a><span class="lineno"> 260</span>  </div>
<div class="line"><a name="l00261"></a><span class="lineno"> 261</span>  <span class="comment">// each test uses a unique filename (managed by master node), to avoid file IO locks</span></div>
<div class="line"><a name="l00262"></a><span class="lineno"> 262</span>  <span class="comment">// (it's safe for sub-test to overwrite this, since after each test, all files</span></div>
<div class="line"><a name="l00263"></a><span class="lineno"> 263</span>  <span class="comment">// with prefix fnPrefix are deleted)</span></div>
<div class="line"><a name="l00264"></a><span class="lineno"> 264</span>  <a class="code" href="group__testutilities.html#ga7c35b1d233b0fb5b42de3bceee26e7e5">setUniqueFilename</a>(fn, fnPrefix);</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="comment">// diagonal op must have at least one amplitude per node</span></div>
<div class="line"><a name="l00267"></a><span class="lineno"> 267</span>  <span class="keywordtype">int</span> minNumQb = <a class="code" href="group__testutilities.html#ga267884197cf7f1d428021cb12a57360c">calcLog2</a>(<a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>.<a class="code" href="structQuESTEnv.html#af22aacd7c9905accae28484785c193b4">numRanks</a>);</div>
<div class="line"><a name="l00268"></a><span class="lineno"> 268</span>  <span class="keywordflow">if</span> (minNumQb == 0)</div>
<div class="line"><a name="l00269"></a><span class="lineno"> 269</span>  minNumQb = 1;</div>
<div class="line"><a name="l00270"></a><span class="lineno"> 270</span>  </div>
<div class="line"><a name="l00271"></a><span class="lineno"> 271</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00272"></a><span class="lineno"> 272</span>  </div>
<div class="line"><a name="l00273"></a><span class="lineno"> 273</span>  SECTION( <span class="stringliteral">"general"</span> ) {</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>  <span class="comment">// try several Pauli Hamiltonian sizes</span></div>
<div class="line"><a name="l00276"></a><span class="lineno"> 276</span>  <span class="keywordtype">int</span> numQb = GENERATE_COPY( range(minNumQb, 6+minNumQb) );</div>
<div class="line"><a name="l00277"></a><span class="lineno"> 277</span>  <span class="keywordtype">int</span> numTerms = GENERATE_COPY( 1, minNumQb, 10*minNumQb );</div>
<div class="line"><a name="l00278"></a><span class="lineno"> 278</span>  </div>
<div class="line"><a name="l00279"></a><span class="lineno"> 279</span>  <span class="comment">// create a PauliHamil with random elements</span></div>
<div class="line"><a name="l00280"></a><span class="lineno"> 280</span>  <a class="code" href="structPauliHamil.html">PauliHamil</a> hamil = <a class="code" href="group__type.html#ga35b28710877c462927366fa602e591cb">createPauliHamil</a>(numQb, numTerms);</div>
<div class="line"><a name="l00281"></a><span class="lineno"> 281</span>  <a class="code" href="group__testutilities.html#ga887d1cd8befe710189cab7f535db3910">setRandomDiagPauliHamil</a>(hamil);</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>  <span class="comment">// write the Hamiltonian to file (with trailing whitespace, and trailing newline)</span></div>
<div class="line"><a name="l00284"></a><span class="lineno"> 284</span>  <span class="keywordflow">if</span> (<a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>.<a class="code" href="structQuESTEnv.html#aa648bb336cf8598467cb62db00b9cee8">rank</a> == 0) { </div>
<div class="line"><a name="l00285"></a><span class="lineno"> 285</span>  FILE* file = fopen(fn, <span class="stringliteral">"w"</span>);</div>
<div class="line"><a name="l00286"></a><span class="lineno"> 286</span>  <span class="keywordtype">int</span> i=0;</div>
<div class="line"><a name="l00287"></a><span class="lineno"> 287</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> n=0; n<numTerms; n++) {</div>
<div class="line"><a name="l00288"></a><span class="lineno"> 288</span>  fprintf(file, REAL_STRING_FORMAT, hamil.<a class="code" href="structPauliHamil.html#ac1c6c9f6299cf83bbba88123216c3cac">termCoeffs</a>[n]);</div>
<div class="line"><a name="l00289"></a><span class="lineno"> 289</span>  fprintf(file, <span class="stringliteral">" "</span>);</div>
<div class="line"><a name="l00290"></a><span class="lineno"> 290</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> q=0; q<numQb; q++)</div>
<div class="line"><a name="l00291"></a><span class="lineno"> 291</span>  fprintf(file, <span class="stringliteral">"%d "</span>, (<span class="keywordtype">int</span>) hamil.<a class="code" href="structPauliHamil.html#a4b8d38c403553c07ceddcd40c46ce6c8">pauliCodes</a>[i++]);</div>
<div class="line"><a name="l00292"></a><span class="lineno"> 292</span>  fprintf(file, <span class="stringliteral">"\n"</span>);</div>
<div class="line"><a name="l00293"></a><span class="lineno"> 293</span>  }</div>
<div class="line"><a name="l00294"></a><span class="lineno"> 294</span>  fprintf(file, <span class="stringliteral">"\n"</span>);</div>
<div class="line"><a name="l00295"></a><span class="lineno"> 295</span>  fclose(file);</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>  <a class="code" href="group__debug.html#ga8d31fe2d1ad4d01e2a1f5f6b8bc15b77">syncQuESTEnv</a>(<a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</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="comment">// load the file as a diagonal operator, and compare</span></div>
<div class="line"><a name="l00300"></a><span class="lineno"> 300</span>  <a class="code" href="structDiagonalOp.html">DiagonalOp</a> op = <a class="code" href="group__type.html#gaa86572b44755646858d6b0292d53cc15">createDiagonalOpFromPauliHamilFile</a>(fn, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00301"></a><span class="lineno"> 301</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(<a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(op), <a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(hamil)) );</div>
<div class="line"><a name="l00302"></a><span class="lineno"> 302</span>  </div>
<div class="line"><a name="l00303"></a><span class="lineno"> 303</span>  <a class="code" href="group__type.html#gac1c8ed909b33bd55ae680901006051b6">destroyPauliHamil</a>(hamil);</div>
<div class="line"><a name="l00304"></a><span class="lineno"> 304</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="l00305"></a><span class="lineno"> 305</span>  }</div>
<div class="line"><a name="l00306"></a><span class="lineno"> 306</span>  SECTION( <span class="stringliteral">"edge cases"</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>  <span class="comment">// prepare a valid single-term diagonal Pauli Hamiltonian</span></div>
<div class="line"><a name="l00309"></a><span class="lineno"> 309</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeffs[] = {.1};</div>
<div class="line"><a name="l00310"></a><span class="lineno"> 310</span>  <a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a> codes[minNumQb];</div>
<div class="line"><a name="l00311"></a><span class="lineno"> 311</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> q=0; q<minNumQb; q++)</div>
<div class="line"><a name="l00312"></a><span class="lineno"> 312</span>  codes[q] = (q%2)? <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a63800f45b01ccc2608f754aee850bf4a">PAULI_I</a> : <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a085c85cff6ba79c52d8b1e61c42ddddf">PAULI_Z</a>; </div>
<div class="line"><a name="l00313"></a><span class="lineno"> 313</span>  </div>
<div class="line"><a name="l00314"></a><span class="lineno"> 314</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> ref = <a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(coeffs, codes, minNumQb, 1);</div>
<div class="line"><a name="l00315"></a><span class="lineno"> 315</span>  </div>
<div class="line"><a name="l00316"></a><span class="lineno"> 316</span>  <span class="comment">// prepare basic encoding string </span></div>
<div class="line"><a name="l00317"></a><span class="lineno"> 317</span>  <span class="keywordtype">string</span> line = to_string(coeffs[0]) + <span class="stringliteral">" "</span>;</div>
<div class="line"><a name="l00318"></a><span class="lineno"> 318</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> q=0; q<minNumQb; q++)</div>
<div class="line"><a name="l00319"></a><span class="lineno"> 319</span>  line += to_string(codes[q]) + ((q<minNumQb-1)? <span class="stringliteral">" "</span>:<span class="stringliteral">""</span>);</div>
<div class="line"><a name="l00320"></a><span class="lineno"> 320</span>  </div>
<div class="line"><a name="l00321"></a><span class="lineno"> 321</span>  SECTION( <span class="stringliteral">"no trailing newline or space"</span> ) {</div>
<div class="line"><a name="l00322"></a><span class="lineno"> 322</span>  </div>
<div class="line"><a name="l00323"></a><span class="lineno"> 323</span>  <a class="code" href="group__testutilities.html#ga8efe977bb581c8bc760d2ce2419161d7">writeToFileSynch</a>(fn, line);</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>  <a class="code" href="structDiagonalOp.html">DiagonalOp</a> op = <a class="code" href="group__type.html#gaa86572b44755646858d6b0292d53cc15">createDiagonalOpFromPauliHamilFile</a>(fn, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00326"></a><span class="lineno"> 326</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(ref, <a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(op)) );</div>
<div class="line"><a name="l00327"></a><span class="lineno"> 327</span>  </div>
<div class="line"><a name="l00328"></a><span class="lineno"> 328</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="l00329"></a><span class="lineno"> 329</span>  }</div>
<div class="line"><a name="l00330"></a><span class="lineno"> 330</span>  SECTION( <span class="stringliteral">"trailing newlines"</span> ) {</div>
<div class="line"><a name="l00331"></a><span class="lineno"> 331</span>  </div>
<div class="line"><a name="l00332"></a><span class="lineno"> 332</span>  <a class="code" href="group__testutilities.html#ga8efe977bb581c8bc760d2ce2419161d7">writeToFileSynch</a>(fn, line + <span class="stringliteral">"\n\n\n"</span>);</div>
<div class="line"><a name="l00333"></a><span class="lineno"> 333</span>  </div>
<div class="line"><a name="l00334"></a><span class="lineno"> 334</span>  <a class="code" href="structDiagonalOp.html">DiagonalOp</a> op = <a class="code" href="group__type.html#gaa86572b44755646858d6b0292d53cc15">createDiagonalOpFromPauliHamilFile</a>(fn, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00335"></a><span class="lineno"> 335</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(ref, <a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(op)) );</div>
<div class="line"><a name="l00336"></a><span class="lineno"> 336</span>  </div>
<div class="line"><a name="l00337"></a><span class="lineno"> 337</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="l00338"></a><span class="lineno"> 338</span>  }</div>
<div class="line"><a name="l00339"></a><span class="lineno"> 339</span>  SECTION( <span class="stringliteral">"trailing spaces"</span> ) {</div>
<div class="line"><a name="l00340"></a><span class="lineno"> 340</span>  </div>
<div class="line"><a name="l00341"></a><span class="lineno"> 341</span>  <a class="code" href="group__testutilities.html#ga8efe977bb581c8bc760d2ce2419161d7">writeToFileSynch</a>(fn, line + <span class="stringliteral">" "</span>);</div>
<div class="line"><a name="l00342"></a><span class="lineno"> 342</span>  </div>
<div class="line"><a name="l00343"></a><span class="lineno"> 343</span>  <a class="code" href="structDiagonalOp.html">DiagonalOp</a> op = <a class="code" href="group__type.html#gaa86572b44755646858d6b0292d53cc15">createDiagonalOpFromPauliHamilFile</a>(fn, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00344"></a><span class="lineno"> 344</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(ref, <a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(op)) );</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>  <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="l00347"></a><span class="lineno"> 347</span>  }</div>
<div class="line"><a name="l00348"></a><span class="lineno"> 348</span>  }</div>
<div class="line"><a name="l00349"></a><span class="lineno"> 349</span>  }</div>
<div class="line"><a name="l00350"></a><span class="lineno"> 350</span>  SECTION( <span class="stringliteral">"input validation"</span>) {</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>  SECTION( <span class="stringliteral">"number of qubits"</span> ) {</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>  <a class="code" href="group__testutilities.html#ga8efe977bb581c8bc760d2ce2419161d7">writeToFileSynch</a>(fn, <span class="stringliteral">".1 "</span>); <span class="comment">// 0 qubits</span></div>
<div class="line"><a name="l00355"></a><span class="lineno"> 355</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__type.html#gaa86572b44755646858d6b0292d53cc15">createDiagonalOpFromPauliHamilFile</a>(fn, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>), Contains(<span class="stringliteral">"The number of qubits"</span>) && Contains(<span class="stringliteral">"strictly positive"</span>));</div>
<div class="line"><a name="l00356"></a><span class="lineno"> 356</span>  }</div>
<div class="line"><a name="l00357"></a><span class="lineno"> 357</span>  SECTION( <span class="stringliteral">"number of elements"</span> ) {</div>
<div class="line"><a name="l00358"></a><span class="lineno"> 358</span>  </div>
<div class="line"><a name="l00359"></a><span class="lineno"> 359</span>  <span class="comment">// too many amplitudes to store in type</span></div>
<div class="line"><a name="l00360"></a><span class="lineno"> 360</span>  <span class="keywordtype">int</span> maxQb = (int) <a class="code" href="group__testutilities.html#ga267884197cf7f1d428021cb12a57360c">calcLog2</a>(SIZE_MAX);</div>
<div class="line"><a name="l00361"></a><span class="lineno"> 361</span>  </div>
<div class="line"><a name="l00362"></a><span class="lineno"> 362</span>  <span class="comment">// encode one more qubit than legal to file</span></div>
<div class="line"><a name="l00363"></a><span class="lineno"> 363</span>  <span class="keywordtype">string</span> line = <span class="stringliteral">".1 "</span>;</div>
<div class="line"><a name="l00364"></a><span class="lineno"> 364</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> q=0; q<(maxQb+1); q++)</div>
<div class="line"><a name="l00365"></a><span class="lineno"> 365</span>  line += <span class="stringliteral">"3 "</span>; <span class="comment">// trailing space ok</span></div>
<div class="line"><a name="l00366"></a><span class="lineno"> 366</span>  <a class="code" href="group__testutilities.html#ga8efe977bb581c8bc760d2ce2419161d7">writeToFileSynch</a>(fn, line);</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>  REQUIRE_THROWS_WITH( <a class="code" href="group__type.html#gaa86572b44755646858d6b0292d53cc15">createDiagonalOpFromPauliHamilFile</a>(fn, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>), Contains(<span class="stringliteral">"Too many qubits"</span>) && Contains(<span class="stringliteral">"size_t type"</span>) );</div>
<div class="line"><a name="l00369"></a><span class="lineno"> 369</span>  </div>
<div class="line"><a name="l00370"></a><span class="lineno"> 370</span>  <span class="comment">// use local QuESTEnv to safely modify</span></div>
<div class="line"><a name="l00371"></a><span class="lineno"> 371</span>  <a class="code" href="structQuESTEnv.html">QuESTEnv</a> env = <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>;</div>
<div class="line"><a name="l00372"></a><span class="lineno"> 372</span>  </div>
<div class="line"><a name="l00373"></a><span class="lineno"> 373</span>  <span class="comment">// too few elements to distribute</span></div>
<div class="line"><a name="l00374"></a><span class="lineno"> 374</span>  <span class="keywordtype">int</span> minQb = GENERATE_COPY( range(2,maxQb) );</div>
<div class="line"><a name="l00375"></a><span class="lineno"> 375</span>  env.<a class="code" href="structQuESTEnv.html#af22aacd7c9905accae28484785c193b4">numRanks</a> = (int) pow(2, minQb);</div>
<div class="line"><a name="l00376"></a><span class="lineno"> 376</span>  <span class="keywordtype">int</span> numQb = GENERATE_COPY( range(1,minQb) );</div>
<div class="line"><a name="l00377"></a><span class="lineno"> 377</span>  </div>
<div class="line"><a name="l00378"></a><span class="lineno"> 378</span>  line = <span class="stringliteral">".1 "</span>;</div>
<div class="line"><a name="l00379"></a><span class="lineno"> 379</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> q=0; q<numQb; q++)</div>
<div class="line"><a name="l00380"></a><span class="lineno"> 380</span>  line += <span class="stringliteral">"3 "</span>; <span class="comment">// trailing space ok</span></div>
<div class="line"><a name="l00381"></a><span class="lineno"> 381</span>  <a class="code" href="group__testutilities.html#ga7c35b1d233b0fb5b42de3bceee26e7e5">setUniqueFilename</a>(fn, fnPrefix);</div>
<div class="line"><a name="l00382"></a><span class="lineno"> 382</span>  <a class="code" href="group__testutilities.html#ga8efe977bb581c8bc760d2ce2419161d7">writeToFileSynch</a>(fn, line);</div>
<div class="line"><a name="l00383"></a><span class="lineno"> 383</span>  </div>
<div class="line"><a name="l00384"></a><span class="lineno"> 384</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__type.html#gaa86572b44755646858d6b0292d53cc15">createDiagonalOpFromPauliHamilFile</a>(fn, env), Contains(<span class="stringliteral">"Too few qubits"</span>) && Contains(<span class="stringliteral">"distributed"</span>) );</div>
<div class="line"><a name="l00385"></a><span class="lineno"> 385</span>  }</div>
<div class="line"><a name="l00386"></a><span class="lineno"> 386</span>  SECTION( <span class="stringliteral">"coefficient type"</span> ) {</div>
<div class="line"><a name="l00387"></a><span class="lineno"> 387</span>  </div>
<div class="line"><a name="l00388"></a><span class="lineno"> 388</span>  <a class="code" href="group__testutilities.html#ga8efe977bb581c8bc760d2ce2419161d7">writeToFileSynch</a>(fn, <span class="stringliteral">"notanumber 1 2 3"</span>);</div>
<div class="line"><a name="l00389"></a><span class="lineno"> 389</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__type.html#gaa86572b44755646858d6b0292d53cc15">createDiagonalOpFromPauliHamilFile</a>(fn, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>), Contains(<span class="stringliteral">"Failed to parse"</span>) && Contains(<span class="stringliteral">"coefficient"</span>));</div>
<div class="line"><a name="l00390"></a><span class="lineno"> 390</span>  }</div>
<div class="line"><a name="l00391"></a><span class="lineno"> 391</span>  SECTION( <span class="stringliteral">"pauli code"</span> ) {</div>
<div class="line"><a name="l00392"></a><span class="lineno"> 392</span>  </div>
<div class="line"><a name="l00393"></a><span class="lineno"> 393</span>  <a class="code" href="group__testutilities.html#ga8efe977bb581c8bc760d2ce2419161d7">writeToFileSynch</a>(fn, <span class="stringliteral">".1 0 3 2"</span>); <span class="comment">// final is invalid Y</span></div>
<div class="line"><a name="l00394"></a><span class="lineno"> 394</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__type.html#gaa86572b44755646858d6b0292d53cc15">createDiagonalOpFromPauliHamilFile</a>(fn, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>), Contains(<span class="stringliteral">"contained operators other than PAULI_Z and PAULI_I"</span>));</div>
<div class="line"><a name="l00395"></a><span class="lineno"> 395</span>  </div>
<div class="line"><a name="l00396"></a><span class="lineno"> 396</span>  <a class="code" href="group__testutilities.html#ga7c35b1d233b0fb5b42de3bceee26e7e5">setUniqueFilename</a>(fn, fnPrefix);</div>
<div class="line"><a name="l00397"></a><span class="lineno"> 397</span>  <a class="code" href="group__testutilities.html#ga8efe977bb581c8bc760d2ce2419161d7">writeToFileSynch</a>(fn, <span class="stringliteral">".1 0 1 3"</span>); <span class="comment">// second is invalid X</span></div>
<div class="line"><a name="l00398"></a><span class="lineno"> 398</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__type.html#gaa86572b44755646858d6b0292d53cc15">createDiagonalOpFromPauliHamilFile</a>(fn, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>), Contains(<span class="stringliteral">"contained operators other than PAULI_Z and PAULI_I"</span>));</div>
<div class="line"><a name="l00399"></a><span class="lineno"> 399</span>  </div>
<div class="line"><a name="l00400"></a><span class="lineno"> 400</span>  <a class="code" href="group__testutilities.html#ga7c35b1d233b0fb5b42de3bceee26e7e5">setUniqueFilename</a>(fn, fnPrefix);</div>
<div class="line"><a name="l00401"></a><span class="lineno"> 401</span>  <a class="code" href="group__testutilities.html#ga8efe977bb581c8bc760d2ce2419161d7">writeToFileSynch</a>(fn, <span class="stringliteral">".1 0 1 4"</span>); <span class="comment">// final is invalid Pauli code</span></div>
<div class="line"><a name="l00402"></a><span class="lineno"> 402</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__type.html#gaa86572b44755646858d6b0292d53cc15">createDiagonalOpFromPauliHamilFile</a>(fn, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>), Contains(<span class="stringliteral">"invalid pauli code"</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>  <a class="code" href="group__testutilities.html#ga7c35b1d233b0fb5b42de3bceee26e7e5">setUniqueFilename</a>(fn, fnPrefix);</div>
<div class="line"><a name="l00405"></a><span class="lineno"> 405</span>  <a class="code" href="group__testutilities.html#ga8efe977bb581c8bc760d2ce2419161d7">writeToFileSynch</a>(fn, <span class="stringliteral">".1 3 0 notanumber"</span>); <span class="comment">// final is invalid type</span></div>
<div class="line"><a name="l00406"></a><span class="lineno"> 406</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__type.html#gaa86572b44755646858d6b0292d53cc15">createDiagonalOpFromPauliHamilFile</a>(fn, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>), Contains(<span class="stringliteral">"Failed to parse the next expected Pauli code"</span>));</div>
<div class="line"><a name="l00407"></a><span class="lineno"> 407</span>  }</div>
<div class="line"><a name="l00408"></a><span class="lineno"> 408</span>  }</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>  <span class="comment">// delete all files created above</span></div>
<div class="line"><a name="l00411"></a><span class="lineno"> 411</span>  <a class="code" href="group__testutilities.html#gad2d2691472dbd81bc4b893160a560c50">deleteFilesWithPrefixSynch</a>(fnPrefix);</div>
<div class="line"><a name="l00412"></a><span class="lineno"> 412</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST__validation_8c_source.html#l00328">calcLog2()</a>, <a class="el" href="QuEST_8c_source.html#l01558">createDiagonalOpFromPauliHamilFile()</a>, <a class="el" href="QuEST_8c_source.html#l01398">createPauliHamil()</a>, <a class="el" href="utilities_8cpp_source.html#l01375">deleteFilesWithPrefixSynch()</a>, <a class="el" href="QuEST_8c_source.html#l01524">destroyDiagonalOp()</a>, <a class="el" href="QuEST_8c_source.html#l01414">destroyPauliHamil()</a>, <a class="el" href="QuEST_8h_source.html#l00365">QuESTEnv::numRanks</a>, <a class="el" href="QuEST_8h_source.html#l00096">PAULI_I</a>, <a class="el" href="QuEST_8h_source.html#l00096">PAULI_Z</a>, <a class="el" href="QuEST_8h_source.html#l00281">PauliHamil::pauliCodes</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, <a class="el" href="QuEST_8h_source.html#l00364">QuESTEnv::rank</a>, <a class="el" href="utilities_8cpp_source.html#l01241">setRandomDiagPauliHamil()</a>, <a class="el" href="utilities_8cpp_source.html#l01358">setUniqueFilename()</a>, <a class="el" href="QuEST__cpu__distributed_8c_source.html#l00164">syncQuESTEnv()</a>, <a class="el" href="QuEST_8h_source.html#l00283">PauliHamil::termCoeffs</a>, <a class="el" href="utilities_8cpp_source.html#l01044">toQMatrix()</a>, and <a class="el" href="utilities_8cpp_source.html#l01362">writeToFileSynch()</a>.</p>
</div>
</div>
<a id="ga2a19fb07f8547c784187eba7245e8cbd"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga2a19fb07f8547c784187eba7245e8cbd">◆ </a></span>TEST_CASE() <span class="overload">[52/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"createPauliHamil" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[data_structures] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__type.html#ga35b28710877c462927366fa602e591cb" title="Dynamically allocates a Hamiltonian expressed as a real-weighted sum of products of Pauli operators.">createPauliHamil</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__data__structures_8cpp_source.html#l00420">420</a> of file <a class="el" href="test__data__structures_8cpp_source.html">test_data_structures.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00420"></a><span class="lineno"> 420</span>  {</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>  SECTION( <span class="stringliteral">"correctness"</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>  <span class="keywordtype">int</span> numQb = GENERATE( range(1,5) );</div>
<div class="line"><a name="l00425"></a><span class="lineno"> 425</span>  <span class="keywordtype">int</span> numTerms = GENERATE( range(1,5) );</div>
<div class="line"><a name="l00426"></a><span class="lineno"> 426</span>  <a class="code" href="structPauliHamil.html">PauliHamil</a> hamil = <a class="code" href="group__type.html#ga35b28710877c462927366fa602e591cb">createPauliHamil</a>(numQb, numTerms);</div>
<div class="line"><a name="l00427"></a><span class="lineno"> 427</span>  </div>
<div class="line"><a name="l00428"></a><span class="lineno"> 428</span>  <span class="comment">// check fields are correct</span></div>
<div class="line"><a name="l00429"></a><span class="lineno"> 429</span>  REQUIRE( hamil.<a class="code" href="structPauliHamil.html#acb49fff0e3160ea1904c9ca34408b4e1">numQubits</a> == numQb );</div>
<div class="line"><a name="l00430"></a><span class="lineno"> 430</span>  REQUIRE( hamil.<a class="code" href="structPauliHamil.html#a737e46b40ef8990cf004d22eb9dbe2e4">numSumTerms</a> == numTerms );</div>
<div class="line"><a name="l00431"></a><span class="lineno"> 431</span>  </div>
<div class="line"><a name="l00432"></a><span class="lineno"> 432</span>  <span class="comment">// check all Pauli codes are identity</span></div>
<div class="line"><a name="l00433"></a><span class="lineno"> 433</span>  <span class="keywordtype">int</span> numPaulis = numQb * numTerms;</div>
<div class="line"><a name="l00434"></a><span class="lineno"> 434</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numPaulis; i++) {</div>
<div class="line"><a name="l00435"></a><span class="lineno"> 435</span>  REQUIRE( hamil.<a class="code" href="structPauliHamil.html#a4b8d38c403553c07ceddcd40c46ce6c8">pauliCodes</a>[i] == <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a63800f45b01ccc2608f754aee850bf4a">PAULI_I</a> );</div>
<div class="line"><a name="l00436"></a><span class="lineno"> 436</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>  <span class="comment">// check all term coefficients can be written to (no seg fault)</span></div>
<div class="line"><a name="l00439"></a><span class="lineno"> 439</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> j=0; j<numTerms; j++) {</div>
<div class="line"><a name="l00440"></a><span class="lineno"> 440</span>  hamil.<a class="code" href="structPauliHamil.html#ac1c6c9f6299cf83bbba88123216c3cac">termCoeffs</a>[j] = 1;</div>
<div class="line"><a name="l00441"></a><span class="lineno"> 441</span>  REQUIRE( hamil.<a class="code" href="structPauliHamil.html#ac1c6c9f6299cf83bbba88123216c3cac">termCoeffs</a>[j] == 1 );</div>
<div class="line"><a name="l00442"></a><span class="lineno"> 442</span>  }</div>
<div class="line"><a name="l00443"></a><span class="lineno"> 443</span>  </div>
<div class="line"><a name="l00444"></a><span class="lineno"> 444</span>  <a class="code" href="group__type.html#gac1c8ed909b33bd55ae680901006051b6">destroyPauliHamil</a>(hamil);</div>
<div class="line"><a name="l00445"></a><span class="lineno"> 445</span>  }</div>
<div class="line"><a name="l00446"></a><span class="lineno"> 446</span>  SECTION( <span class="stringliteral">"input validation"</span>) {</div>
<div class="line"><a name="l00447"></a><span class="lineno"> 447</span>  </div>
<div class="line"><a name="l00448"></a><span class="lineno"> 448</span>  SECTION( <span class="stringliteral">"number of qubits"</span> ) {</div>
<div class="line"><a name="l00449"></a><span class="lineno"> 449</span>  </div>
<div class="line"><a name="l00450"></a><span class="lineno"> 450</span>  <span class="keywordtype">int</span> numQb = GENERATE( -1, 0 );</div>
<div class="line"><a name="l00451"></a><span class="lineno"> 451</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__type.html#ga35b28710877c462927366fa602e591cb">createPauliHamil</a>(numQb, 1), Contains(<span class="stringliteral">"The number of qubits and terms in the PauliHamil must be strictly positive."</span>) );</div>
<div class="line"><a name="l00452"></a><span class="lineno"> 452</span>  }</div>
<div class="line"><a name="l00453"></a><span class="lineno"> 453</span>  SECTION( <span class="stringliteral">"number of terms"</span> ) {</div>
<div class="line"><a name="l00454"></a><span class="lineno"> 454</span>  </div>
<div class="line"><a name="l00455"></a><span class="lineno"> 455</span>  <span class="keywordtype">int</span> numTerms = GENERATE( -1, 0 );</div>
<div class="line"><a name="l00456"></a><span class="lineno"> 456</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__type.html#ga35b28710877c462927366fa602e591cb">createPauliHamil</a>(1, numTerms), Contains(<span class="stringliteral">"The number of qubits and terms in the PauliHamil must be strictly positive."</span>) );</div>
<div class="line"><a name="l00457"></a><span class="lineno"> 457</span>  }</div>
<div class="line"><a name="l00458"></a><span class="lineno"> 458</span>  }</div>
<div class="line"><a name="l00459"></a><span class="lineno"> 459</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l01398">createPauliHamil()</a>, <a class="el" href="QuEST_8c_source.html#l01414">destroyPauliHamil()</a>, <a class="el" href="QuEST_8h_source.html#l00287">PauliHamil::numQubits</a>, <a class="el" href="QuEST_8h_source.html#l00285">PauliHamil::numSumTerms</a>, <a class="el" href="QuEST_8h_source.html#l00096">PAULI_I</a>, <a class="el" href="QuEST_8h_source.html#l00281">PauliHamil::pauliCodes</a>, and <a class="el" href="QuEST_8h_source.html#l00283">PauliHamil::termCoeffs</a>.</p>
</div>
</div>
<a id="gace8b19274c10a208bbfac7437171cf2b"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gace8b19274c10a208bbfac7437171cf2b">◆ </a></span>TEST_CASE() <span class="overload">[53/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"createPauliHamilFromFile" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[data_structures] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__type.html#gaa77376c5e3518186eb085f37826d6008" title="Creates a PauliHamil instance, a real-weighted sum of products of Pauli operators,...">createPauliHamilFromFile</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__data__structures_8cpp_source.html#l00467">467</a> of file <a class="el" href="test__data__structures_8cpp_source.html">test_data_structures.cpp</a>.</p>
<div class="fragment"><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>  </div>
<div class="line"><a name="l00469"></a><span class="lineno"> 469</span>  <span class="comment">// files created & populated during the test, and deleted afterward</span></div>
<div class="line"><a name="l00470"></a><span class="lineno"> 470</span>  <span class="keywordtype">char</span> fnPrefix[] = <span class="stringliteral">"temp_createPauliHamilFromFile"</span>;</div>
<div class="line"><a name="l00471"></a><span class="lineno"> 471</span>  <span class="keywordtype">char</span> fn[100];</div>
<div class="line"><a name="l00472"></a><span class="lineno"> 472</span>  </div>
<div class="line"><a name="l00473"></a><span class="lineno"> 473</span>  <span class="comment">// each test uses a unique filename (managed by master node), to avoid file IO locks</span></div>
<div class="line"><a name="l00474"></a><span class="lineno"> 474</span>  <span class="comment">// (it's safe for sub-test to overwrite this, since after each test, all files</span></div>
<div class="line"><a name="l00475"></a><span class="lineno"> 475</span>  <span class="comment">// with prefix fnPrefix are deleted)</span></div>
<div class="line"><a name="l00476"></a><span class="lineno"> 476</span>  <a class="code" href="group__testutilities.html#ga7c35b1d233b0fb5b42de3bceee26e7e5">setUniqueFilename</a>(fn, fnPrefix);</div>
<div class="line"><a name="l00477"></a><span class="lineno"> 477</span>  </div>
<div class="line"><a name="l00478"></a><span class="lineno"> 478</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</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>  SECTION( <span class="stringliteral">"general"</span> ) {</div>
<div class="line"><a name="l00481"></a><span class="lineno"> 481</span>  </div>
<div class="line"><a name="l00482"></a><span class="lineno"> 482</span>  <span class="comment">// for several sizes...</span></div>
<div class="line"><a name="l00483"></a><span class="lineno"> 483</span>  <span class="keywordtype">int</span> numQb = GENERATE( 1, 5, 10, 15 );</div>
<div class="line"><a name="l00484"></a><span class="lineno"> 484</span>  <span class="keywordtype">int</span> numTerms = GENERATE( 1, 10, 30 );</div>
<div class="line"><a name="l00485"></a><span class="lineno"> 485</span>  <span class="keywordtype">int</span> numPaulis = numQb*numTerms;</div>
<div class="line"><a name="l00486"></a><span class="lineno"> 486</span>  </div>
<div class="line"><a name="l00487"></a><span class="lineno"> 487</span>  <span class="comment">// create a PauliHamil with random elements</span></div>
<div class="line"><a name="l00488"></a><span class="lineno"> 488</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeffs[numTerms];</div>
<div class="line"><a name="l00489"></a><span class="lineno"> 489</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a> paulis[numPaulis];</div>
<div class="line"><a name="l00490"></a><span class="lineno"> 490</span>  <a class="code" href="group__testutilities.html#ga11c465ce1a5c238946a9e09d61c94c58">setRandomPauliSum</a>(coeffs, paulis, numQb, numTerms);</div>
<div class="line"><a name="l00491"></a><span class="lineno"> 491</span>  </div>
<div class="line"><a name="l00492"></a><span class="lineno"> 492</span>  <span class="comment">// write the Hamiltonian to file (with trailing whitespace, and trailing newline)</span></div>
<div class="line"><a name="l00493"></a><span class="lineno"> 493</span>  <span class="keywordflow">if</span> (<a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>.<a class="code" href="structQuESTEnv.html#aa648bb336cf8598467cb62db00b9cee8">rank</a> == 0) {</div>
<div class="line"><a name="l00494"></a><span class="lineno"> 494</span>  FILE* file = fopen(fn, <span class="stringliteral">"w"</span>);</div>
<div class="line"><a name="l00495"></a><span class="lineno"> 495</span>  <span class="keywordtype">int</span> i=0;</div>
<div class="line"><a name="l00496"></a><span class="lineno"> 496</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> n=0; n<numTerms; n++) {</div>
<div class="line"><a name="l00497"></a><span class="lineno"> 497</span>  fprintf(file, REAL_STRING_FORMAT, coeffs[n]);</div>
<div class="line"><a name="l00498"></a><span class="lineno"> 498</span>  fprintf(file, <span class="stringliteral">" "</span>);</div>
<div class="line"><a name="l00499"></a><span class="lineno"> 499</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> q=0; q<numQb; q++)</div>
<div class="line"><a name="l00500"></a><span class="lineno"> 500</span>  fprintf(file, <span class="stringliteral">"%d "</span>, (<span class="keywordtype">int</span>) paulis[i++]);</div>
<div class="line"><a name="l00501"></a><span class="lineno"> 501</span>  fprintf(file, <span class="stringliteral">"\n"</span>);</div>
<div class="line"><a name="l00502"></a><span class="lineno"> 502</span>  }</div>
<div class="line"><a name="l00503"></a><span class="lineno"> 503</span>  fprintf(file, <span class="stringliteral">"\n"</span>);</div>
<div class="line"><a name="l00504"></a><span class="lineno"> 504</span>  fclose(file);</div>
<div class="line"><a name="l00505"></a><span class="lineno"> 505</span>  }</div>
<div class="line"><a name="l00506"></a><span class="lineno"> 506</span>  <a class="code" href="group__debug.html#ga8d31fe2d1ad4d01e2a1f5f6b8bc15b77">syncQuESTEnv</a>(<a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00507"></a><span class="lineno"> 507</span>  </div>
<div class="line"><a name="l00508"></a><span class="lineno"> 508</span>  <span class="comment">// load the file as a PauliHamil</span></div>
<div class="line"><a name="l00509"></a><span class="lineno"> 509</span>  <a class="code" href="structPauliHamil.html">PauliHamil</a> hamil = <a class="code" href="group__type.html#gaa77376c5e3518186eb085f37826d6008">createPauliHamilFromFile</a>(fn);</div>
<div class="line"><a name="l00510"></a><span class="lineno"> 510</span>  </div>
<div class="line"><a name="l00511"></a><span class="lineno"> 511</span>  <span class="comment">// check fields agree</span></div>
<div class="line"><a name="l00512"></a><span class="lineno"> 512</span>  REQUIRE( hamil.<a class="code" href="structPauliHamil.html#acb49fff0e3160ea1904c9ca34408b4e1">numQubits</a> == numQb );</div>
<div class="line"><a name="l00513"></a><span class="lineno"> 513</span>  REQUIRE( hamil.<a class="code" href="structPauliHamil.html#a737e46b40ef8990cf004d22eb9dbe2e4">numSumTerms</a> == numTerms );</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>  <span class="comment">// check elements agree</span></div>
<div class="line"><a name="l00516"></a><span class="lineno"> 516</span>  <span class="keywordtype">int</span> j=0;</div>
<div class="line"><a name="l00517"></a><span class="lineno"> 517</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> n=0; n<numTerms; n++) {</div>
<div class="line"><a name="l00518"></a><span class="lineno"> 518</span>  REQUIRE( absReal(hamil.<a class="code" href="structPauliHamil.html#ac1c6c9f6299cf83bbba88123216c3cac">termCoeffs</a>[n] - coeffs[n]) <= REAL_EPS );</div>
<div class="line"><a name="l00519"></a><span class="lineno"> 519</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> q=0; q<numQb; q++) {</div>
<div class="line"><a name="l00520"></a><span class="lineno"> 520</span>  REQUIRE( hamil.<a class="code" href="structPauliHamil.html#a4b8d38c403553c07ceddcd40c46ce6c8">pauliCodes</a>[j] == paulis[j] );</div>
<div class="line"><a name="l00521"></a><span class="lineno"> 521</span>  j++;</div>
<div class="line"><a name="l00522"></a><span class="lineno"> 522</span>  }</div>
<div class="line"><a name="l00523"></a><span class="lineno"> 523</span>  }</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>  <a class="code" href="group__type.html#gac1c8ed909b33bd55ae680901006051b6">destroyPauliHamil</a>(hamil);</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>  SECTION( <span class="stringliteral">"edge cases"</span> ) {</div>
<div class="line"><a name="l00528"></a><span class="lineno"> 528</span>  </div>
<div class="line"><a name="l00529"></a><span class="lineno"> 529</span>  SECTION( <span class="stringliteral">"no trailing newline or space"</span> ) {</div>
<div class="line"><a name="l00530"></a><span class="lineno"> 530</span>  </div>
<div class="line"><a name="l00531"></a><span class="lineno"> 531</span>  <a class="code" href="group__testutilities.html#ga8efe977bb581c8bc760d2ce2419161d7">writeToFileSynch</a>(fn, <span class="stringliteral">".1 1 0 1"</span>);</div>
<div class="line"><a name="l00532"></a><span class="lineno"> 532</span>  </div>
<div class="line"><a name="l00533"></a><span class="lineno"> 533</span>  <a class="code" href="structPauliHamil.html">PauliHamil</a> hamil = <a class="code" href="group__type.html#gaa77376c5e3518186eb085f37826d6008">createPauliHamilFromFile</a>(fn);</div>
<div class="line"><a name="l00534"></a><span class="lineno"> 534</span>  REQUIRE( hamil.<a class="code" href="structPauliHamil.html#a737e46b40ef8990cf004d22eb9dbe2e4">numSumTerms</a> == 1 );</div>
<div class="line"><a name="l00535"></a><span class="lineno"> 535</span>  REQUIRE( hamil.<a class="code" href="structPauliHamil.html#acb49fff0e3160ea1904c9ca34408b4e1">numQubits</a> == 3 );</div>
<div class="line"><a name="l00536"></a><span class="lineno"> 536</span>  </div>
<div class="line"><a name="l00537"></a><span class="lineno"> 537</span>  <a class="code" href="group__type.html#gac1c8ed909b33bd55ae680901006051b6">destroyPauliHamil</a>(hamil); </div>
<div class="line"><a name="l00538"></a><span class="lineno"> 538</span>  }</div>
<div class="line"><a name="l00539"></a><span class="lineno"> 539</span>  SECTION( <span class="stringliteral">"trailing newlines"</span> ) {</div>
<div class="line"><a name="l00540"></a><span class="lineno"> 540</span>  </div>
<div class="line"><a name="l00541"></a><span class="lineno"> 541</span>  <a class="code" href="group__testutilities.html#ga8efe977bb581c8bc760d2ce2419161d7">writeToFileSynch</a>(fn, <span class="stringliteral">".1 1 0 1\n\n\n"</span>);</div>
<div class="line"><a name="l00542"></a><span class="lineno"> 542</span>  </div>
<div class="line"><a name="l00543"></a><span class="lineno"> 543</span>  <a class="code" href="structPauliHamil.html">PauliHamil</a> hamil = <a class="code" href="group__type.html#gaa77376c5e3518186eb085f37826d6008">createPauliHamilFromFile</a>(fn);</div>
<div class="line"><a name="l00544"></a><span class="lineno"> 544</span>  REQUIRE( hamil.<a class="code" href="structPauliHamil.html#a737e46b40ef8990cf004d22eb9dbe2e4">numSumTerms</a> == 1 );</div>
<div class="line"><a name="l00545"></a><span class="lineno"> 545</span>  REQUIRE( hamil.<a class="code" href="structPauliHamil.html#acb49fff0e3160ea1904c9ca34408b4e1">numQubits</a> == 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>  <a class="code" href="group__type.html#gac1c8ed909b33bd55ae680901006051b6">destroyPauliHamil</a>(hamil); </div>
<div class="line"><a name="l00548"></a><span class="lineno"> 548</span>  }</div>
<div class="line"><a name="l00549"></a><span class="lineno"> 549</span>  SECTION( <span class="stringliteral">"trailing spaces"</span> ) {</div>
<div class="line"><a name="l00550"></a><span class="lineno"> 550</span>  </div>
<div class="line"><a name="l00551"></a><span class="lineno"> 551</span>  <a class="code" href="group__testutilities.html#ga8efe977bb581c8bc760d2ce2419161d7">writeToFileSynch</a>(fn, <span class="stringliteral">".1 1 0 1 "</span>);</div>
<div class="line"><a name="l00552"></a><span class="lineno"> 552</span>  </div>
<div class="line"><a name="l00553"></a><span class="lineno"> 553</span>  <a class="code" href="structPauliHamil.html">PauliHamil</a> hamil = <a class="code" href="group__type.html#gaa77376c5e3518186eb085f37826d6008">createPauliHamilFromFile</a>(fn);</div>
<div class="line"><a name="l00554"></a><span class="lineno"> 554</span>  REQUIRE( hamil.<a class="code" href="structPauliHamil.html#a737e46b40ef8990cf004d22eb9dbe2e4">numSumTerms</a> == 1 );</div>
<div class="line"><a name="l00555"></a><span class="lineno"> 555</span>  REQUIRE( hamil.<a class="code" href="structPauliHamil.html#acb49fff0e3160ea1904c9ca34408b4e1">numQubits</a> == 3 );</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>  <a class="code" href="group__type.html#gac1c8ed909b33bd55ae680901006051b6">destroyPauliHamil</a>(hamil); </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>  }</div>
<div class="line"><a name="l00560"></a><span class="lineno"> 560</span>  }</div>
<div class="line"><a name="l00561"></a><span class="lineno"> 561</span>  SECTION( <span class="stringliteral">"input validation"</span>) {</div>
<div class="line"><a name="l00562"></a><span class="lineno"> 562</span>  </div>
<div class="line"><a name="l00563"></a><span class="lineno"> 563</span>  SECTION( <span class="stringliteral">"number of qubits"</span> ) {</div>
<div class="line"><a name="l00564"></a><span class="lineno"> 564</span>  </div>
<div class="line"><a name="l00565"></a><span class="lineno"> 565</span>  <a class="code" href="group__testutilities.html#ga8efe977bb581c8bc760d2ce2419161d7">writeToFileSynch</a>(fn, <span class="stringliteral">".1 "</span>);</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>  REQUIRE_THROWS_WITH( <a class="code" href="group__type.html#gaa77376c5e3518186eb085f37826d6008">createPauliHamilFromFile</a>(fn), Contains(<span class="stringliteral">"The number of qubits"</span>) && Contains(<span class="stringliteral">"strictly positive"</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>  SECTION( <span class="stringliteral">"coefficient type"</span> ) {</div>
<div class="line"><a name="l00570"></a><span class="lineno"> 570</span>  </div>
<div class="line"><a name="l00571"></a><span class="lineno"> 571</span>  <a class="code" href="group__testutilities.html#ga8efe977bb581c8bc760d2ce2419161d7">writeToFileSynch</a>(fn, <span class="stringliteral">"notanumber 1 2 3"</span>);</div>
<div class="line"><a name="l00572"></a><span class="lineno"> 572</span>  </div>
<div class="line"><a name="l00573"></a><span class="lineno"> 573</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__type.html#gaa77376c5e3518186eb085f37826d6008">createPauliHamilFromFile</a>(fn), Contains(<span class="stringliteral">"Failed to parse"</span>) && Contains(<span class="stringliteral">"coefficient"</span>));</div>
<div class="line"><a name="l00574"></a><span class="lineno"> 574</span>  }</div>
<div class="line"><a name="l00575"></a><span class="lineno"> 575</span>  SECTION( <span class="stringliteral">"pauli code"</span> ) {</div>
<div class="line"><a name="l00576"></a><span class="lineno"> 576</span>  </div>
<div class="line"><a name="l00577"></a><span class="lineno"> 577</span>  <a class="code" href="group__testutilities.html#ga8efe977bb581c8bc760d2ce2419161d7">writeToFileSynch</a>(fn, <span class="stringliteral">".1 1 2 4"</span>); <span class="comment">// invalid int</span></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>  REQUIRE_THROWS_WITH( <a class="code" href="group__type.html#gaa77376c5e3518186eb085f37826d6008">createPauliHamilFromFile</a>(fn), Contains(<span class="stringliteral">"invalid pauli code"</span>));</div>
<div class="line"><a name="l00580"></a><span class="lineno"> 580</span>  </div>
<div class="line"><a name="l00581"></a><span class="lineno"> 581</span>  <a class="code" href="group__testutilities.html#ga7c35b1d233b0fb5b42de3bceee26e7e5">setUniqueFilename</a>(fn, fnPrefix);</div>
<div class="line"><a name="l00582"></a><span class="lineno"> 582</span>  <a class="code" href="group__testutilities.html#ga8efe977bb581c8bc760d2ce2419161d7">writeToFileSynch</a>(fn, <span class="stringliteral">".1 1 2 notanumber"</span>); <span class="comment">// invalid type</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>  REQUIRE_THROWS_WITH( <a class="code" href="group__type.html#gaa77376c5e3518186eb085f37826d6008">createPauliHamilFromFile</a>(fn), Contains(<span class="stringliteral">"Failed to parse the next expected Pauli code"</span>));</div>
<div class="line"><a name="l00585"></a><span class="lineno"> 585</span>  }</div>
<div class="line"><a name="l00586"></a><span class="lineno"> 586</span>  }</div>
<div class="line"><a name="l00587"></a><span class="lineno"> 587</span>  </div>
<div class="line"><a name="l00588"></a><span class="lineno"> 588</span>  <span class="comment">// cleanup temp files</span></div>
<div class="line"><a name="l00589"></a><span class="lineno"> 589</span>  <a class="code" href="group__testutilities.html#gad2d2691472dbd81bc4b893160a560c50">deleteFilesWithPrefixSynch</a>(fn);</div>
<div class="line"><a name="l00590"></a><span class="lineno"> 590</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l01420">createPauliHamilFromFile()</a>, <a class="el" href="utilities_8cpp_source.html#l01375">deleteFilesWithPrefixSynch()</a>, <a class="el" href="QuEST_8c_source.html#l01414">destroyPauliHamil()</a>, <a class="el" href="QuEST_8h_source.html#l00287">PauliHamil::numQubits</a>, <a class="el" href="QuEST_8h_source.html#l00285">PauliHamil::numSumTerms</a>, <a class="el" href="QuEST_8h_source.html#l00281">PauliHamil::pauliCodes</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, <a class="el" href="QuEST_8h_source.html#l00364">QuESTEnv::rank</a>, <a class="el" href="utilities_8cpp_source.html#l01229">setRandomPauliSum()</a>, <a class="el" href="utilities_8cpp_source.html#l01358">setUniqueFilename()</a>, <a class="el" href="QuEST__cpu__distributed_8c_source.html#l00164">syncQuESTEnv()</a>, <a class="el" href="QuEST_8h_source.html#l00283">PauliHamil::termCoeffs</a>, and <a class="el" href="utilities_8cpp_source.html#l01362">writeToFileSynch()</a>.</p>
</div>
</div>
<a id="ga18b791c2fe5a2c484c51879ef16fba22"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga18b791c2fe5a2c484c51879ef16fba22">◆ </a></span>TEST_CASE() <span class="overload">[54/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"createQuESTEnv" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[data_structures] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__type.html#ga8ba2c3388dd64d9348c3b091852d36d4" title="Create the QuEST execution environment.">createQuESTEnv</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__data__structures_8cpp_source.html#l00598">598</a> of file <a class="el" href="test__data__structures_8cpp_source.html">test_data_structures.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00598"></a><span class="lineno"> 598</span>  {</div>
<div class="line"><a name="l00599"></a><span class="lineno"> 599</span>  </div>
<div class="line"><a name="l00600"></a><span class="lineno"> 600</span>  <span class="comment">/* there is no meaningful way to test this */</span></div>
<div class="line"><a name="l00601"></a><span class="lineno"> 601</span>  SUCCEED( );</div>
<div class="line"><a name="l00602"></a><span class="lineno"> 602</span> }</div>
</div><!-- fragment -->
</div>
</div>
<a id="ga9aec4500e0046f8b085bb800f79db544"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga9aec4500e0046f8b085bb800f79db544">◆ </a></span>TEST_CASE() <span class="overload">[55/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"createQureg" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[data_structures] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__type.html#ga3392816c0643414165c2f5caeec17df0" title="Creates a state-vector Qureg object representing a set of qubits which will remain in a pure state.">createQureg</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__data__structures_8cpp_source.html#l00610">610</a> of file <a class="el" href="test__data__structures_8cpp_source.html">test_data_structures.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00610"></a><span class="lineno"> 610</span>  {</div>
<div class="line"><a name="l00611"></a><span class="lineno"> 611</span>  </div>
<div class="line"><a name="l00612"></a><span class="lineno"> 612</span>  <span class="comment">// must be at least one amplitude per node</span></div>
<div class="line"><a name="l00613"></a><span class="lineno"> 613</span>  <span class="keywordtype">int</span> minNumQb = <a class="code" href="group__testutilities.html#ga267884197cf7f1d428021cb12a57360c">calcLog2</a>(<a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>.<a class="code" href="structQuESTEnv.html#af22aacd7c9905accae28484785c193b4">numRanks</a>);</div>
<div class="line"><a name="l00614"></a><span class="lineno"> 614</span>  <span class="keywordflow">if</span> (minNumQb == 0)</div>
<div class="line"><a name="l00615"></a><span class="lineno"> 615</span>  minNumQb = 1;</div>
<div class="line"><a name="l00616"></a><span class="lineno"> 616</span>  </div>
<div class="line"><a name="l00617"></a><span class="lineno"> 617</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</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 10 valid number of qubits</span></div>
<div class="line"><a name="l00620"></a><span class="lineno"> 620</span>  <span class="keywordtype">int</span> numQb = GENERATE_COPY( range(minNumQb, minNumQb+10) );</div>
<div class="line"><a name="l00621"></a><span class="lineno"> 621</span>  <a class="code" href="structQureg.html">Qureg</a> reg = <a class="code" href="group__type.html#ga3392816c0643414165c2f5caeec17df0">createQureg</a>(numQb, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00622"></a><span class="lineno"> 622</span>  </div>
<div class="line"><a name="l00623"></a><span class="lineno"> 623</span>  <span class="comment">// ensure elems (CPU and/or GPU) are created, and reg begins in |0></span></div>
<div class="line"><a name="l00624"></a><span class="lineno"> 624</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> ref = <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a>(1<<numQb);</div>
<div class="line"><a name="l00625"></a><span class="lineno"> 625</span>  ref[0] = 1; <span class="comment">// |0></span></div>
<div class="line"><a name="l00626"></a><span class="lineno"> 626</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(reg, ref) );</div>
<div class="line"><a name="l00627"></a><span class="lineno"> 627</span>  </div>
<div class="line"><a name="l00628"></a><span class="lineno"> 628</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(reg, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</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>  SECTION( <span class="stringliteral">"input validation"</span>) {</div>
<div class="line"><a name="l00631"></a><span class="lineno"> 631</span>  </div>
<div class="line"><a name="l00632"></a><span class="lineno"> 632</span>  SECTION( <span class="stringliteral">"number of qubits"</span> ) {</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="keywordtype">int</span> numQb = GENERATE( -1, 0 );</div>
<div class="line"><a name="l00635"></a><span class="lineno"> 635</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__type.html#ga3392816c0643414165c2f5caeec17df0">createQureg</a>(numQb, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>), Contains(<span class="stringliteral">"Invalid number of qubits"</span>) );</div>
<div class="line"><a name="l00636"></a><span class="lineno"> 636</span>  }</div>
<div class="line"><a name="l00637"></a><span class="lineno"> 637</span>  SECTION( <span class="stringliteral">"number of amplitudes"</span> ) {</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>  <span class="comment">// use local QuESTEnv to safely modify</span></div>
<div class="line"><a name="l00640"></a><span class="lineno"> 640</span>  <a class="code" href="structQuESTEnv.html">QuESTEnv</a> env = <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>;</div>
<div class="line"><a name="l00641"></a><span class="lineno"> 641</span>  </div>
<div class="line"><a name="l00642"></a><span class="lineno"> 642</span>  <span class="comment">// too many amplitudes to store in type</span></div>
<div class="line"><a name="l00643"></a><span class="lineno"> 643</span>  <span class="keywordtype">int</span> maxQb = (int) <a class="code" href="group__testutilities.html#ga267884197cf7f1d428021cb12a57360c">calcLog2</a>(SIZE_MAX);</div>
<div class="line"><a name="l00644"></a><span class="lineno"> 644</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__type.html#ga3392816c0643414165c2f5caeec17df0">createQureg</a>(maxQb+1, env), Contains(<span class="stringliteral">"Too many qubits"</span>) && Contains(<span class="stringliteral">"size_t type"</span>) );</div>
<div class="line"><a name="l00645"></a><span class="lineno"> 645</span>  </div>
<div class="line"><a name="l00646"></a><span class="lineno"> 646</span>  <span class="comment">// too few amplitudes to distribute</span></div>
<div class="line"><a name="l00647"></a><span class="lineno"> 647</span>  <span class="keywordtype">int</span> minQb = GENERATE_COPY( range(2,maxQb) );</div>
<div class="line"><a name="l00648"></a><span class="lineno"> 648</span>  env.<a class="code" href="structQuESTEnv.html#af22aacd7c9905accae28484785c193b4">numRanks</a> = (int) pow(2, minQb);</div>
<div class="line"><a name="l00649"></a><span class="lineno"> 649</span>  <span class="keywordtype">int</span> numQb = GENERATE_COPY( range(1,minQb) );</div>
<div class="line"><a name="l00650"></a><span class="lineno"> 650</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__type.html#ga3392816c0643414165c2f5caeec17df0">createQureg</a>(numQb, env), Contains(<span class="stringliteral">"Too few qubits"</span>) );</div>
<div class="line"><a name="l00651"></a><span class="lineno"> 651</span>  }</div>
<div class="line"><a name="l00652"></a><span class="lineno"> 652</span>  SECTION( <span class="stringliteral">"available memory"</span> ) {</div>
<div class="line"><a name="l00653"></a><span class="lineno"> 653</span>  </div>
<div class="line"><a name="l00654"></a><span class="lineno"> 654</span>  <span class="comment">/* there is no reliable way to force the malloc statements to</span></div>
<div class="line"><a name="l00655"></a><span class="lineno"> 655</span> <span class="comment"> * fail, and hence trigger the matrixInit validation */</span></div>
<div class="line"><a name="l00656"></a><span class="lineno"> 656</span>  SUCCEED( );</div>
<div class="line"><a name="l00657"></a><span class="lineno"> 657</span>  }</div>
<div class="line"><a name="l00658"></a><span class="lineno"> 658</span>  }</div>
<div class="line"><a name="l00659"></a><span class="lineno"> 659</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST__validation_8c_source.html#l00328">calcLog2()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="QuEST_8h_source.html#l00365">QuESTEnv::numRanks</a>, and <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>.</p>
</div>
</div>
<a id="gaa4304249b102cdc1471be54a8765442f"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaa4304249b102cdc1471be54a8765442f">◆ </a></span>TEST_CASE() <span class="overload">[56/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"destroyComplexMatrixN" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[data_structures] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753" title="Destroy a ComplexMatrixN instance created with createComplexMatrixN()">destroyComplexMatrixN</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__data__structures_8cpp_source.html#l00667">667</a> of file <a class="el" href="test__data__structures_8cpp_source.html">test_data_structures.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00667"></a><span class="lineno"> 667</span>  {</div>
<div class="line"><a name="l00668"></a><span class="lineno"> 668</span>  </div>
<div class="line"><a name="l00669"></a><span class="lineno"> 669</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00670"></a><span class="lineno"> 670</span>  </div>
<div class="line"><a name="l00671"></a><span class="lineno"> 671</span>  <span class="comment">/* there is no meaningful way to test this */</span></div>
<div class="line"><a name="l00672"></a><span class="lineno"> 672</span>  SUCCEED( );</div>
<div class="line"><a name="l00673"></a><span class="lineno"> 673</span>  }</div>
<div class="line"><a name="l00674"></a><span class="lineno"> 674</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00675"></a><span class="lineno"> 675</span>  </div>
<div class="line"><a name="l00676"></a><span class="lineno"> 676</span>  SECTION( <span class="stringliteral">"matrix not created"</span> ) {</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="comment">/* this is an artificial test case since nothing in the QuEST API </span></div>
<div class="line"><a name="l00679"></a><span class="lineno"> 679</span> <span class="comment"> * automatically sets un-initialised ComplexMatrixN fields to </span></div>
<div class="line"><a name="l00680"></a><span class="lineno"> 680</span> <span class="comment"> * the NULL pointer.</span></div>
<div class="line"><a name="l00681"></a><span class="lineno"> 681</span> <span class="comment"> */</span></div>
<div class="line"><a name="l00682"></a><span class="lineno"> 682</span>  <a class="code" href="structComplexMatrixN.html">ComplexMatrixN</a> m;</div>
<div class="line"><a name="l00683"></a><span class="lineno"> 683</span>  m.<a class="code" href="structComplexMatrixN.html#a446e8a077597e4f76049d547df0c9738">real</a> = NULL;</div>
<div class="line"><a name="l00684"></a><span class="lineno"> 684</span>  </div>
<div class="line"><a name="l00685"></a><span class="lineno"> 685</span>  <span class="comment">/* the error message is also somewhat unrelated, but oh well </span></div>
<div class="line"><a name="l00686"></a><span class="lineno"> 686</span> <span class="comment"> */</span></div>
<div class="line"><a name="l00687"></a><span class="lineno"> 687</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(m), Contains(<span class="stringliteral">"The ComplexMatrixN was not successfully created"</span>) );</div>
<div class="line"><a name="l00688"></a><span class="lineno"> 688</span>  }</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> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l01369">destroyComplexMatrixN()</a>, and <a class="el" href="QuEST_8h_source.html#l00189">ComplexMatrixN::real</a>.</p>
</div>
</div>
<a id="gaf37fdb380465c3405ba756717171e805"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaf37fdb380465c3405ba756717171e805">◆ </a></span>TEST_CASE() <span class="overload">[57/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"destroyDiagonalOp" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[data_structures] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__type.html#ga2c59f45fab56708f687b4104ee99bcd1" title="Destroys a DiagonalOp created with createDiagonalOp(), freeing its memory.">destroyDiagonalOp</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__data__structures_8cpp_source.html#l00698">698</a> of file <a class="el" href="test__data__structures_8cpp_source.html">test_data_structures.cpp</a>.</p>
<div class="fragment"><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>  <span class="comment">/* there is no meaningful way to test this */</span></div>
<div class="line"><a name="l00701"></a><span class="lineno"> 701</span>  SUCCEED( );</div>
<div class="line"><a name="l00702"></a><span class="lineno"> 702</span> }</div>
</div><!-- fragment -->
</div>
</div>
<a id="ga5244023e258b1b5e43352ae0d4f9a2c6"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga5244023e258b1b5e43352ae0d4f9a2c6">◆ </a></span>TEST_CASE() <span class="overload">[58/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"destroyPauliHamil" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[data_structures] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__type.html#gac1c8ed909b33bd55ae680901006051b6" title="Destroy a PauliHamil instance, created with either createPauliHamil() or createPauliHamilFromFile().">destroyPauliHamil</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__data__structures_8cpp_source.html#l00710">710</a> of file <a class="el" href="test__data__structures_8cpp_source.html">test_data_structures.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00710"></a><span class="lineno"> 710</span>  {</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>  <span class="comment">/* there is no meaningful way to test this.</span></div>
<div class="line"><a name="l00713"></a><span class="lineno"> 713</span> <span class="comment"> * We e.g. cannot check that the pointers are NULL because </span></div>
<div class="line"><a name="l00714"></a><span class="lineno"> 714</span> <span class="comment"> * they are not updated; this function passes the struct by value,</span></div>
<div class="line"><a name="l00715"></a><span class="lineno"> 715</span> <span class="comment"> * not by reference. We also cannot reliably monitor the </span></div>
<div class="line"><a name="l00716"></a><span class="lineno"> 716</span> <span class="comment"> * memory used in the heap at runtime.</span></div>
<div class="line"><a name="l00717"></a><span class="lineno"> 717</span> <span class="comment"> */</span></div>
<div class="line"><a name="l00718"></a><span class="lineno"> 718</span>  SUCCEED( );</div>
<div class="line"><a name="l00719"></a><span class="lineno"> 719</span> }</div>
</div><!-- fragment -->
</div>
</div>
<a id="gab5ca964a4d64491f3c32e7fda334a5e1"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gab5ca964a4d64491f3c32e7fda334a5e1">◆ </a></span>TEST_CASE() <span class="overload">[59/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"destroyQuESTEnv" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[data_structures] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__type.html#gaeff624226629d7063a8a776958a4f991" title="Destroy the QuEST environment.">destroyQuESTEnv</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__data__structures_8cpp_source.html#l00727">727</a> of file <a class="el" href="test__data__structures_8cpp_source.html">test_data_structures.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00727"></a><span class="lineno"> 727</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>  <span class="comment">/* there is no meaningful way to test this */</span></div>
<div class="line"><a name="l00730"></a><span class="lineno"> 730</span>  SUCCEED( );</div>
<div class="line"><a name="l00731"></a><span class="lineno"> 731</span> }</div>
</div><!-- fragment -->
</div>
</div>
<a id="ga6e2d6773435b9191791ef1e6fb844337"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga6e2d6773435b9191791ef1e6fb844337">◆ </a></span>TEST_CASE() <span class="overload">[60/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"destroyQureg" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[data_structures] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692" title="Deallocate a Qureg, freeing its memory.">destroyQureg</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__data__structures_8cpp_source.html#l00739">739</a> of file <a class="el" href="test__data__structures_8cpp_source.html">test_data_structures.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00739"></a><span class="lineno"> 739</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="comment">/* there is no meaningful way to test this.</span></div>
<div class="line"><a name="l00742"></a><span class="lineno"> 742</span> <span class="comment"> * We e.g. cannot check that the pointers are NULL because </span></div>
<div class="line"><a name="l00743"></a><span class="lineno"> 743</span> <span class="comment"> * they are not updated; this function passes the struct by value,</span></div>
<div class="line"><a name="l00744"></a><span class="lineno"> 744</span> <span class="comment"> * not by reference. We also cannot reliably monitor the </span></div>
<div class="line"><a name="l00745"></a><span class="lineno"> 745</span> <span class="comment"> * memory used in the heap at runtime.</span></div>
<div class="line"><a name="l00746"></a><span class="lineno"> 746</span> <span class="comment"> */</span></div>
<div class="line"><a name="l00747"></a><span class="lineno"> 747</span>  SUCCEED( );</div>
<div class="line"><a name="l00748"></a><span class="lineno"> 748</span> }</div>
</div><!-- fragment -->
</div>
</div>
<a id="ga2f0067941939643bc87b445995fc873c"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga2f0067941939643bc87b445995fc873c">◆ </a></span>TEST_CASE() <span class="overload">[61/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"fromComplex" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[data_structures] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__type.html#ga3cf635d2b2e57226c8d5a777f513367e">fromComplex</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__data__structures_8cpp_source.html#l00015">15</a> of file <a class="el" href="test__data__structures_8cpp_source.html">test_data_structures.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00015"></a><span class="lineno"> 15</span>  {</div>
<div class="line"><a name="l00016"></a><span class="lineno"> 16</span>  </div>
<div class="line"><a name="l00017"></a><span class="lineno"> 17</span>  <a class="code" href="structComplex.html">Complex</a> a = {.<a class="code" href="structComplex.html#ab5b2e2eca02131fc74b289a83636cbe3">real</a>=.5, .imag=-.2};</div>
<div class="line"><a name="l00018"></a><span class="lineno"> 18</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> b = <a class="code" href="group__type.html#ga3cf635d2b2e57226c8d5a777f513367e">fromComplex</a>(a);</div>
<div class="line"><a name="l00019"></a><span class="lineno"> 19</span>  </div>
<div class="line"><a name="l00020"></a><span class="lineno"> 20</span>  REQUIRE( a.<a class="code" href="structComplex.html#ab5b2e2eca02131fc74b289a83636cbe3">real</a> == real(b) );</div>
<div class="line"><a name="l00021"></a><span class="lineno"> 21</span>  REQUIRE( a.<a class="code" href="structComplex.html#a84f5439aad0ef495efdd3b4c1c02d27e">imag</a> == imag(b) );</div>
<div class="line"><a name="l00022"></a><span class="lineno"> 22</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="group__type.html#ga3cf635d2b2e57226c8d5a777f513367e">fromComplex</a>, <a class="el" href="QuEST_8h_source.html#l00106">Complex::imag</a>, <a class="el" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>, and <a class="el" href="QuEST_8h_source.html#l00105">Complex::real</a>.</p>
</div>
</div>
<a id="gaf530a2a0e2809ded8812a4967d291c3e"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaf530a2a0e2809ded8812a4967d291c3e">◆ </a></span>TEST_CASE() <span class="overload">[62/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"getAmp" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[calculations] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__calc.html#ga30d6f8b7c766c9c9914b2c61a2fc0def" title="Get the complex amplitude at a given index in the state vector.">getAmp</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__calculations_8cpp_source.html#l01272">1272</a> of file <a class="el" href="test__calculations_8cpp_source.html">test_calculations.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l01272"></a><span class="lineno"> 1272</span>  {</div>
<div class="line"><a name="l01273"></a><span class="lineno"> 1273</span>  </div>
<div class="line"><a name="l01274"></a><span class="lineno"> 1274</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="l01275"></a><span class="lineno"> 1275</span>  </div>
<div class="line"><a name="l01276"></a><span class="lineno"> 1276</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l01277"></a><span class="lineno"> 1277</span>  </div>
<div class="line"><a name="l01278"></a><span class="lineno"> 1278</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l01279"></a><span class="lineno"> 1279</span>  </div>
<div class="line"><a name="l01280"></a><span class="lineno"> 1280</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(vec);</div>
<div class="line"><a name="l01281"></a><span class="lineno"> 1281</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> ref = <a class="code" href="group__testutilities.html#gade0e7c37811a69f1c21c88c11943a19f">toQVector</a>(vec);</div>
<div class="line"><a name="l01282"></a><span class="lineno"> 1282</span>  </div>
<div class="line"><a name="l01283"></a><span class="lineno"> 1283</span>  <span class="keywordtype">int</span> ind = GENERATE( range(0,1<<<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) );</div>
<div class="line"><a name="l01284"></a><span class="lineno"> 1284</span>  <a class="code" href="structComplex.html">Complex</a> amp = <a class="code" href="group__calc.html#ga30d6f8b7c766c9c9914b2c61a2fc0def">getAmp</a>(vec,ind);</div>
<div class="line"><a name="l01285"></a><span class="lineno"> 1285</span>  REQUIRE( <a class="code" href="group__type.html#ga3cf635d2b2e57226c8d5a777f513367e">fromComplex</a>(amp) == ref[ind] );</div>
<div class="line"><a name="l01286"></a><span class="lineno"> 1286</span>  }</div>
<div class="line"><a name="l01287"></a><span class="lineno"> 1287</span>  }</div>
<div class="line"><a name="l01288"></a><span class="lineno"> 1288</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l01289"></a><span class="lineno"> 1289</span>  </div>
<div class="line"><a name="l01290"></a><span class="lineno"> 1290</span>  SECTION( <span class="stringliteral">"state index"</span> ) {</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="keywordtype">int</span> ind = GENERATE( -1, 1<<<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l01293"></a><span class="lineno"> 1293</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga30d6f8b7c766c9c9914b2c61a2fc0def">getAmp</a>(vec,ind), Contains(<span class="stringliteral">"Invalid amplitude index"</span>) );</div>
<div class="line"><a name="l01294"></a><span class="lineno"> 1294</span>  }</div>
<div class="line"><a name="l01295"></a><span class="lineno"> 1295</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01296"></a><span class="lineno"> 1296</span>  </div>
<div class="line"><a name="l01297"></a><span class="lineno"> 1297</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="l01298"></a><span class="lineno"> 1298</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga30d6f8b7c766c9c9914b2c61a2fc0def">getAmp</a>(mat,0), Contains(<span class="stringliteral">"valid only for state-vectors"</span>) );</div>
<div class="line"><a name="l01299"></a><span class="lineno"> 1299</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="l01300"></a><span class="lineno"> 1300</span>  }</div>
<div class="line"><a name="l01301"></a><span class="lineno"> 1301</span>  }</div>
<div class="line"><a name="l01302"></a><span class="lineno"> 1302</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="l01303"></a><span class="lineno"> 1303</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="group__type.html#ga3cf635d2b2e57226c8d5a777f513367e">fromComplex</a>, <a class="el" href="QuEST_8c_source.html#l00939">getAmp()</a>, <a class="el" href="QuEST_8c_source.html#l01578">initDebugState()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, and <a class="el" href="utilities_8cpp_source.html#l01113">toQVector()</a>.</p>
</div>
</div>
<a id="ga91c97193b23d8dcba69ad8af5ff31b85"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga91c97193b23d8dcba69ad8af5ff31b85">◆ </a></span>TEST_CASE() <span class="overload">[63/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"getDensityAmp" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[calculations] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__calc.html#gadca286c4ad5cde6124d4e80a7ab95a68" title="Get an amplitude from a density matrix at a given row and column.">getDensityAmp</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__calculations_8cpp_source.html#l01311">1311</a> of file <a class="el" href="test__calculations_8cpp_source.html">test_calculations.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l01311"></a><span class="lineno"> 1311</span>  {</div>
<div class="line"><a name="l01312"></a><span class="lineno"> 1312</span>  </div>
<div class="line"><a name="l01313"></a><span class="lineno"> 1313</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="l01314"></a><span class="lineno"> 1314</span>  </div>
<div class="line"><a name="l01315"></a><span class="lineno"> 1315</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l01316"></a><span class="lineno"> 1316</span>  </div>
<div class="line"><a name="l01317"></a><span class="lineno"> 1317</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01318"></a><span class="lineno"> 1318</span>  </div>
<div class="line"><a name="l01319"></a><span class="lineno"> 1319</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(mat);</div>
<div class="line"><a name="l01320"></a><span class="lineno"> 1320</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> ref = <a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(mat);</div>
<div class="line"><a name="l01321"></a><span class="lineno"> 1321</span>  </div>
<div class="line"><a name="l01322"></a><span class="lineno"> 1322</span>  <span class="keywordtype">int</span> row = GENERATE( range(0,1<<<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) );</div>
<div class="line"><a name="l01323"></a><span class="lineno"> 1323</span>  <span class="keywordtype">int</span> col = GENERATE( range(0,1<<<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) );</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>  <a class="code" href="structComplex.html">Complex</a> amp = <a class="code" href="group__calc.html#gadca286c4ad5cde6124d4e80a7ab95a68">getDensityAmp</a>(mat,row,col);</div>
<div class="line"><a name="l01326"></a><span class="lineno"> 1326</span>  REQUIRE( <a class="code" href="group__type.html#ga3cf635d2b2e57226c8d5a777f513367e">fromComplex</a>(amp) == ref[row][col] );</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>  }</div>
<div class="line"><a name="l01329"></a><span class="lineno"> 1329</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l01330"></a><span class="lineno"> 1330</span>  </div>
<div class="line"><a name="l01331"></a><span class="lineno"> 1331</span>  SECTION( <span class="stringliteral">"state index"</span> ) {</div>
<div class="line"><a name="l01332"></a><span class="lineno"> 1332</span>  </div>
<div class="line"><a name="l01333"></a><span class="lineno"> 1333</span>  <span class="keywordtype">int</span> ind = GENERATE( -1, 1<<<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l01334"></a><span class="lineno"> 1334</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#gadca286c4ad5cde6124d4e80a7ab95a68">getDensityAmp</a>(mat,ind,0), Contains(<span class="stringliteral">"Invalid amplitude index"</span>) );</div>
<div class="line"><a name="l01335"></a><span class="lineno"> 1335</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#gadca286c4ad5cde6124d4e80a7ab95a68">getDensityAmp</a>(mat,0,ind), Contains(<span class="stringliteral">"Invalid amplitude index"</span>) );</div>
<div class="line"><a name="l01336"></a><span class="lineno"> 1336</span>  </div>
<div class="line"><a name="l01337"></a><span class="lineno"> 1337</span>  }</div>
<div class="line"><a name="l01338"></a><span class="lineno"> 1338</span>  SECTION( <span class="stringliteral">"state-vector"</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>  <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="l01341"></a><span class="lineno"> 1341</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#gadca286c4ad5cde6124d4e80a7ab95a68">getDensityAmp</a>(vec,0,0), Contains(<span class="stringliteral">"valid only for density matrices"</span>) );</div>
<div class="line"><a name="l01342"></a><span class="lineno"> 1342</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="l01343"></a><span class="lineno"> 1343</span>  }</div>
<div class="line"><a name="l01344"></a><span class="lineno"> 1344</span>  }</div>
<div class="line"><a name="l01345"></a><span class="lineno"> 1345</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="l01346"></a><span class="lineno"> 1346</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="group__type.html#ga3cf635d2b2e57226c8d5a777f513367e">fromComplex</a>, <a class="el" href="QuEST_8c_source.html#l00949">getDensityAmp()</a>, <a class="el" href="QuEST_8c_source.html#l01578">initDebugState()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, and <a class="el" href="utilities_8cpp_source.html#l01044">toQMatrix()</a>.</p>
</div>
</div>
<a id="gae43391f4fc72b35c87ea4d76576463be"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gae43391f4fc72b35c87ea4d76576463be">◆ </a></span>TEST_CASE() <span class="overload">[64/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"getImagAmp" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[calculations] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__calc.html#gad575782de461d9ab0975b38cc7850f1a" title="Get the imaginary component of the complex probability amplitude at an index in the state vector.">getImagAmp</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__calculations_8cpp_source.html#l01354">1354</a> of file <a class="el" href="test__calculations_8cpp_source.html">test_calculations.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l01354"></a><span class="lineno"> 1354</span>  {</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>  <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="l01357"></a><span class="lineno"> 1357</span>  </div>
<div class="line"><a name="l01358"></a><span class="lineno"> 1358</span>  SECTION( <span class="stringliteral">"correctness"</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>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l01361"></a><span class="lineno"> 1361</span>  </div>
<div class="line"><a name="l01362"></a><span class="lineno"> 1362</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(vec);</div>
<div class="line"><a name="l01363"></a><span class="lineno"> 1363</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> ref = <a class="code" href="group__testutilities.html#gade0e7c37811a69f1c21c88c11943a19f">toQVector</a>(vec);</div>
<div class="line"><a name="l01364"></a><span class="lineno"> 1364</span>  </div>
<div class="line"><a name="l01365"></a><span class="lineno"> 1365</span>  <span class="keywordtype">int</span> ind = GENERATE( range(0,1<<<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) );</div>
<div class="line"><a name="l01366"></a><span class="lineno"> 1366</span>  REQUIRE( <a class="code" href="group__calc.html#gad575782de461d9ab0975b38cc7850f1a">getImagAmp</a>(vec,ind) == imag(ref[ind]) );</div>
<div class="line"><a name="l01367"></a><span class="lineno"> 1367</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>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l01370"></a><span class="lineno"> 1370</span>  </div>
<div class="line"><a name="l01371"></a><span class="lineno"> 1371</span>  SECTION( <span class="stringliteral">"state index"</span> ) {</div>
<div class="line"><a name="l01372"></a><span class="lineno"> 1372</span>  </div>
<div class="line"><a name="l01373"></a><span class="lineno"> 1373</span>  <span class="keywordtype">int</span> ind = GENERATE( -1, 1<<<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l01374"></a><span class="lineno"> 1374</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#gad575782de461d9ab0975b38cc7850f1a">getImagAmp</a>(vec,ind), Contains(<span class="stringliteral">"Invalid amplitude index"</span>) );</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>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</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>  <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="l01379"></a><span class="lineno"> 1379</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#gad575782de461d9ab0975b38cc7850f1a">getImagAmp</a>(mat,0), Contains(<span class="stringliteral">"valid only for state-vectors"</span>) );</div>
<div class="line"><a name="l01380"></a><span class="lineno"> 1380</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="l01381"></a><span class="lineno"> 1381</span>  }</div>
<div class="line"><a name="l01382"></a><span class="lineno"> 1382</span>  }</div>
<div class="line"><a name="l01383"></a><span class="lineno"> 1383</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="l01384"></a><span class="lineno"> 1384</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00925">getImagAmp()</a>, <a class="el" href="QuEST_8c_source.html#l01578">initDebugState()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, and <a class="el" href="utilities_8cpp_source.html#l01113">toQVector()</a>.</p>
</div>
</div>
<a id="ga77058278e43deef9a7daac38746acdcd"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga77058278e43deef9a7daac38746acdcd">◆ </a></span>TEST_CASE() <span class="overload">[65/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"getNumAmps" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[calculations] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__calc.html#ga8cbe422d4981bf06847d229a4c6aa3df" title="Returns the number of complex amplitudes in a state-vector qureg.">getNumAmps</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__calculations_8cpp_source.html#l01392">1392</a> of file <a class="el" href="test__calculations_8cpp_source.html">test_calculations.cpp</a>.</p>
<div class="fragment"><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>  </div>
<div class="line"><a name="l01394"></a><span class="lineno"> 1394</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l01395"></a><span class="lineno"> 1395</span>  </div>
<div class="line"><a name="l01396"></a><span class="lineno"> 1396</span>  <span class="comment">// test >= NUM_QUBITS so as not to limit distribution size</span></div>
<div class="line"><a name="l01397"></a><span class="lineno"> 1397</span>  <span class="keywordtype">int</span> numQb = GENERATE( range(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+10) );</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>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l01400"></a><span class="lineno"> 1400</span>  </div>
<div class="line"><a name="l01401"></a><span class="lineno"> 1401</span>  <a class="code" href="structQureg.html">Qureg</a> vec = <a class="code" href="group__type.html#ga3392816c0643414165c2f5caeec17df0">createQureg</a>(numQb, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l01402"></a><span class="lineno"> 1402</span>  REQUIRE( <a class="code" href="group__calc.html#ga8cbe422d4981bf06847d229a4c6aa3df">getNumAmps</a>(vec) == (1<<numQb) );</div>
<div class="line"><a name="l01403"></a><span class="lineno"> 1403</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="l01404"></a><span class="lineno"> 1404</span>  }</div>
<div class="line"><a name="l01405"></a><span class="lineno"> 1405</span>  }</div>
<div class="line"><a name="l01406"></a><span class="lineno"> 1406</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</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>  <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="l01410"></a><span class="lineno"> 1410</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga8cbe422d4981bf06847d229a4c6aa3df">getNumAmps</a>(mat), Contains(<span class="stringliteral">"valid only for state-vectors"</span>) );</div>
<div class="line"><a name="l01411"></a><span class="lineno"> 1411</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="l01412"></a><span class="lineno"> 1412</span>  }</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><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00912">getNumAmps()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, and <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>.</p>
</div>
</div>
<a id="ga6161165d2a2ba0a72691e040964f86f4"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga6161165d2a2ba0a72691e040964f86f4">◆ </a></span>TEST_CASE() <span class="overload">[66/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"getNumQubits" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[calculations] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__calc.html#ga73036c778d800703585ab3d8796a915f" title="Returns the number of qubits represented by qureg.">getNumQubits</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__calculations_8cpp_source.html#l01422">1422</a> of file <a class="el" href="test__calculations_8cpp_source.html">test_calculations.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l01422"></a><span class="lineno"> 1422</span>  {</div>
<div class="line"><a name="l01423"></a><span class="lineno"> 1423</span>  </div>
<div class="line"><a name="l01424"></a><span class="lineno"> 1424</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l01425"></a><span class="lineno"> 1425</span>  </div>
<div class="line"><a name="l01426"></a><span class="lineno"> 1426</span>  <span class="comment">// test >= NUM_QUBITS so as not to limit distribution size</span></div>
<div class="line"><a name="l01427"></a><span class="lineno"> 1427</span>  <span class="keywordtype">int</span> numQb = GENERATE( range(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+10) );</div>
<div class="line"><a name="l01428"></a><span class="lineno"> 1428</span>  </div>
<div class="line"><a name="l01429"></a><span class="lineno"> 1429</span>  SECTION( <span class="stringliteral">"state-vector"</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>  <a class="code" href="structQureg.html">Qureg</a> vec = <a class="code" href="group__type.html#ga3392816c0643414165c2f5caeec17df0">createQureg</a>(numQb, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l01432"></a><span class="lineno"> 1432</span>  REQUIRE( <a class="code" href="group__calc.html#ga73036c778d800703585ab3d8796a915f">getNumQubits</a>(vec) == numQb );</div>
<div class="line"><a name="l01433"></a><span class="lineno"> 1433</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="l01434"></a><span class="lineno"> 1434</span>  }</div>
<div class="line"><a name="l01435"></a><span class="lineno"> 1435</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01436"></a><span class="lineno"> 1436</span>  </div>
<div class="line"><a name="l01437"></a><span class="lineno"> 1437</span>  <a class="code" href="structQureg.html">Qureg</a> mat = <a class="code" href="group__type.html#ga93e55b6650b408abb30a1d4a8bce757c">createDensityQureg</a>(numQb, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l01438"></a><span class="lineno"> 1438</span>  REQUIRE( <a class="code" href="group__calc.html#ga73036c778d800703585ab3d8796a915f">getNumQubits</a>(mat) == numQb );</div>
<div class="line"><a name="l01439"></a><span class="lineno"> 1439</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="l01440"></a><span class="lineno"> 1440</span>  }</div>
<div class="line"><a name="l01441"></a><span class="lineno"> 1441</span>  }</div>
<div class="line"><a name="l01442"></a><span class="lineno"> 1442</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l01443"></a><span class="lineno"> 1443</span>  </div>
<div class="line"><a name="l01444"></a><span class="lineno"> 1444</span>  <span class="comment">// no validation</span></div>
<div class="line"><a name="l01445"></a><span class="lineno"> 1445</span>  SUCCEED();</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><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00908">getNumQubits()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, and <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>.</p>
</div>
</div>
<a id="gad7d8932b28815ad719e3ff6cc29f5656"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gad7d8932b28815ad719e3ff6cc29f5656">◆ </a></span>TEST_CASE() <span class="overload">[67/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"getProbAmp" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[calculations] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__calc.html#ga4a14d22379d399760b0cfc5c8053589b" title="Get the probability of a state-vector at an index in the full state vector.">getProbAmp</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__calculations_8cpp_source.html#l01455">1455</a> of file <a class="el" href="test__calculations_8cpp_source.html">test_calculations.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l01455"></a><span class="lineno"> 1455</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>  <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="l01458"></a><span class="lineno"> 1458</span>  </div>
<div class="line"><a name="l01459"></a><span class="lineno"> 1459</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l01460"></a><span class="lineno"> 1460</span>  </div>
<div class="line"><a name="l01461"></a><span class="lineno"> 1461</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l01462"></a><span class="lineno"> 1462</span>  </div>
<div class="line"><a name="l01463"></a><span class="lineno"> 1463</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(vec);</div>
<div class="line"><a name="l01464"></a><span class="lineno"> 1464</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> ref = <a class="code" href="group__testutilities.html#gade0e7c37811a69f1c21c88c11943a19f">toQVector</a>(vec);</div>
<div class="line"><a name="l01465"></a><span class="lineno"> 1465</span>  </div>
<div class="line"><a name="l01466"></a><span class="lineno"> 1466</span>  <span class="keywordtype">int</span> ind = GENERATE( range(0,1<<<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) );</div>
<div class="line"><a name="l01467"></a><span class="lineno"> 1467</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> refCalc = pow(abs(ref[ind]), 2);</div>
<div class="line"><a name="l01468"></a><span class="lineno"> 1468</span>  REQUIRE( <a class="code" href="group__calc.html#ga4a14d22379d399760b0cfc5c8053589b">getProbAmp</a>(vec,ind) == Approx(refCalc) );</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>  }</div>
<div class="line"><a name="l01471"></a><span class="lineno"> 1471</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l01472"></a><span class="lineno"> 1472</span>  </div>
<div class="line"><a name="l01473"></a><span class="lineno"> 1473</span>  SECTION( <span class="stringliteral">"state 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>  <span class="keywordtype">int</span> ind = GENERATE( -1, 1<<<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l01476"></a><span class="lineno"> 1476</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga4a14d22379d399760b0cfc5c8053589b">getProbAmp</a>(vec,ind), Contains(<span class="stringliteral">"Invalid amplitude index"</span>) );</div>
<div class="line"><a name="l01477"></a><span class="lineno"> 1477</span>  }</div>
<div class="line"><a name="l01478"></a><span class="lineno"> 1478</span>  SECTION( <span class="stringliteral">"density-matrix"</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>  <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="l01481"></a><span class="lineno"> 1481</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga4a14d22379d399760b0cfc5c8053589b">getProbAmp</a>(mat,0), Contains(<span class="stringliteral">"valid only for state-vectors"</span>) );</div>
<div class="line"><a name="l01482"></a><span class="lineno"> 1482</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="l01483"></a><span class="lineno"> 1483</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>  <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="l01486"></a><span class="lineno"> 1486</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00932">getProbAmp()</a>, <a class="el" href="QuEST_8c_source.html#l01578">initDebugState()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, and <a class="el" href="utilities_8cpp_source.html#l01113">toQVector()</a>.</p>
</div>
</div>
<a id="gadf3a64a1dff4833aa96ecb3c98656398"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gadf3a64a1dff4833aa96ecb3c98656398">◆ </a></span>TEST_CASE() <span class="overload">[68/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"getRealAmp" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[calculations] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__calc.html#ga1416145280c62c5dd5ec9bed89b4cd05" title="Get the real component of the complex probability amplitude at an index in the state vector.">getRealAmp</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__calculations_8cpp_source.html#l01494">1494</a> of file <a class="el" href="test__calculations_8cpp_source.html">test_calculations.cpp</a>.</p>
<div class="fragment"><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>  </div>
<div class="line"><a name="l01496"></a><span class="lineno"> 1496</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="l01497"></a><span class="lineno"> 1497</span>  </div>
<div class="line"><a name="l01498"></a><span class="lineno"> 1498</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</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>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l01501"></a><span class="lineno"> 1501</span>  </div>
<div class="line"><a name="l01502"></a><span class="lineno"> 1502</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(vec);</div>
<div class="line"><a name="l01503"></a><span class="lineno"> 1503</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> ref = <a class="code" href="group__testutilities.html#gade0e7c37811a69f1c21c88c11943a19f">toQVector</a>(vec);</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> ind = GENERATE( range(0,1<<<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) );</div>
<div class="line"><a name="l01506"></a><span class="lineno"> 1506</span>  REQUIRE( <a class="code" href="group__calc.html#ga1416145280c62c5dd5ec9bed89b4cd05">getRealAmp</a>(vec,ind) == real(ref[ind]) );</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>  }</div>
<div class="line"><a name="l01509"></a><span class="lineno"> 1509</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l01510"></a><span class="lineno"> 1510</span>  </div>
<div class="line"><a name="l01511"></a><span class="lineno"> 1511</span>  SECTION( <span class="stringliteral">"state index"</span> ) {</div>
<div class="line"><a name="l01512"></a><span class="lineno"> 1512</span>  </div>
<div class="line"><a name="l01513"></a><span class="lineno"> 1513</span>  <span class="keywordtype">int</span> ind = GENERATE( -1, 1<<<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l01514"></a><span class="lineno"> 1514</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga1416145280c62c5dd5ec9bed89b4cd05">getRealAmp</a>(vec,ind), Contains(<span class="stringliteral">"Invalid amplitude index"</span>) );</div>
<div class="line"><a name="l01515"></a><span class="lineno"> 1515</span>  }</div>
<div class="line"><a name="l01516"></a><span class="lineno"> 1516</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01517"></a><span class="lineno"> 1517</span>  </div>
<div class="line"><a name="l01518"></a><span class="lineno"> 1518</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="l01519"></a><span class="lineno"> 1519</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga1416145280c62c5dd5ec9bed89b4cd05">getRealAmp</a>(mat,0), Contains(<span class="stringliteral">"valid only for state-vectors"</span>) );</div>
<div class="line"><a name="l01520"></a><span class="lineno"> 1520</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="l01521"></a><span class="lineno"> 1521</span>  }</div>
<div class="line"><a name="l01522"></a><span class="lineno"> 1522</span>  }</div>
<div class="line"><a name="l01523"></a><span class="lineno"> 1523</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="l01524"></a><span class="lineno"> 1524</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00918">getRealAmp()</a>, <a class="el" href="QuEST_8c_source.html#l01578">initDebugState()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, and <a class="el" href="utilities_8cpp_source.html#l01113">toQVector()</a>.</p>
</div>
</div>
<a id="ga52ecd483c4f7634460972b70983de21c"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga52ecd483c4f7634460972b70983de21c">◆ </a></span>TEST_CASE() <span class="overload">[69/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"getStaticComplexMatrixN" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[data_structures] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__type.html#ga927beeee2ba3b110f33ebb440c154ae2" title="Creates a ComplexMatrixN struct which lives in the stack and so does not need freeing,...">getStaticComplexMatrixN</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__data__structures_8cpp_source.html#l00030">30</a> of file <a class="el" href="test__data__structures_8cpp_source.html">test_data_structures.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00030"></a><span class="lineno"> 30</span>  {</div>
<div class="line"><a name="l00031"></a><span class="lineno"> 31</span>  </div>
<div class="line"><a name="l00032"></a><span class="lineno"> 32</span>  <span class="comment">/* use of this function is illegal in C++ */</span></div>
<div class="line"><a name="l00033"></a><span class="lineno"> 33</span>  SUCCEED( );</div>
<div class="line"><a name="l00034"></a><span class="lineno"> 34</span> }</div>
</div><!-- fragment -->
</div>
</div>
<a id="gab0eaeafe2da6bc602f8c79ecb986eb7f"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gab0eaeafe2da6bc602f8c79ecb986eb7f">◆ </a></span>TEST_CASE() <span class="overload">[70/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"hadamard" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#ga6532decd6c404189915563492f090e6f" title="Apply the single-qubit Hadamard gate.">hadamard</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l00814">814</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00814"></a><span class="lineno"> 814</span>  {</div>
<div class="line"><a name="l00815"></a><span class="lineno"> 815</span>  </div>
<div class="line"><a name="l00816"></a><span class="lineno"> 816</span>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l00817"></a><span class="lineno"> 817</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> a = 1/sqrt(2);</div>
<div class="line"><a name="l00818"></a><span class="lineno"> 818</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op{{a,a},{a,-a}};</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>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00821"></a><span class="lineno"> 821</span>  </div>
<div class="line"><a name="l00822"></a><span class="lineno"> 822</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="l00823"></a><span class="lineno"> 823</span>  </div>
<div class="line"><a name="l00824"></a><span class="lineno"> 824</span>  SECTION( <span class="stringliteral">"state-vector "</span>) {</div>
<div class="line"><a name="l00825"></a><span class="lineno"> 825</span>  </div>
<div class="line"><a name="l00826"></a><span class="lineno"> 826</span>  <a class="code" href="group__unitary.html#ga6532decd6c404189915563492f090e6f">hadamard</a>(quregVec, target);</div>
<div class="line"><a name="l00827"></a><span class="lineno"> 827</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, target, op);</div>
<div class="line"><a name="l00828"></a><span class="lineno"> 828</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l00829"></a><span class="lineno"> 829</span>  }</div>
<div class="line"><a name="l00830"></a><span class="lineno"> 830</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00831"></a><span class="lineno"> 831</span>  </div>
<div class="line"><a name="l00832"></a><span class="lineno"> 832</span>  <a class="code" href="group__unitary.html#ga6532decd6c404189915563492f090e6f">hadamard</a>(quregMatr, target);</div>
<div class="line"><a name="l00833"></a><span class="lineno"> 833</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, target, op);</div>
<div class="line"><a name="l00834"></a><span class="lineno"> 834</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 10*REAL_EPS) );</div>
<div class="line"><a name="l00835"></a><span class="lineno"> 835</span>  }</div>
<div class="line"><a name="l00836"></a><span class="lineno"> 836</span>  }</div>
<div class="line"><a name="l00837"></a><span class="lineno"> 837</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00838"></a><span class="lineno"> 838</span>  </div>
<div class="line"><a name="l00839"></a><span class="lineno"> 839</span>  SECTION( <span class="stringliteral">"qubit indices"</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>  <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="l00842"></a><span class="lineno"> 842</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga6532decd6c404189915563492f090e6f">hadamard</a>(quregVec, target), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l00843"></a><span class="lineno"> 843</span>  }</div>
<div class="line"><a name="l00844"></a><span class="lineno"> 844</span>  }</div>
<div class="line"><a name="l00845"></a><span class="lineno"> 845</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l00846"></a><span class="lineno"> 846</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l00176">hadamard()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, and <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>.</p>
</div>
</div>
<a id="ga4ac023fcc2426bf185cc8e36a69c2e94"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga4ac023fcc2426bf185cc8e36a69c2e94">◆ </a></span>TEST_CASE() <span class="overload">[71/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"initBlankState" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[state_initialisations] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__init.html#gada7230491a50cd409f8b00f5ee1db953" title="Initialises a qureg to have all-zero-amplitudes.">initBlankState</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__state__initialisations_8cpp_source.html#l00090">90</a> of file <a class="el" href="test__state__initialisations_8cpp_source.html">test_state_initialisations.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00090"></a><span class="lineno"> 90</span>  {</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>  <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="l00093"></a><span class="lineno"> 93</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="l00094"></a><span class="lineno"> 94</span>  </div>
<div class="line"><a name="l00095"></a><span class="lineno"> 95</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00096"></a><span class="lineno"> 96</span>  </div>
<div class="line"><a name="l00097"></a><span class="lineno"> 97</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00098"></a><span class="lineno"> 98</span>  </div>
<div class="line"><a name="l00099"></a><span class="lineno"> 99</span>  <a class="code" href="group__init.html#gada7230491a50cd409f8b00f5ee1db953">initBlankState</a>(vec);</div>
<div class="line"><a name="l00100"></a><span class="lineno"> 100</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vec, <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a>(1<<<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>)) );</div>
<div class="line"><a name="l00101"></a><span class="lineno"> 101</span>  }</div>
<div class="line"><a name="l00102"></a><span class="lineno"> 102</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00103"></a><span class="lineno"> 103</span>  </div>
<div class="line"><a name="l00104"></a><span class="lineno"> 104</span>  <a class="code" href="group__init.html#gada7230491a50cd409f8b00f5ee1db953">initBlankState</a>(mat);</div>
<div class="line"><a name="l00105"></a><span class="lineno"> 105</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(mat, <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="l00106"></a><span class="lineno"> 106</span>  }</div>
<div class="line"><a name="l00107"></a><span class="lineno"> 107</span>  }</div>
<div class="line"><a name="l00108"></a><span class="lineno"> 108</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00109"></a><span class="lineno"> 109</span>  </div>
<div class="line"><a name="l00110"></a><span class="lineno"> 110</span>  <span class="comment">// no user validation</span></div>
<div class="line"><a name="l00111"></a><span class="lineno"> 111</span>  SUCCEED( );</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>  <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="l00114"></a><span class="lineno"> 114</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="l00115"></a><span class="lineno"> 115</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00153">getZeroMatrix()</a>, <a class="el" href="QuEST_8c_source.html#l00119">initBlankState()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, and <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>.</p>
</div>
</div>
<a id="gafb36244534a4b9b1faa53d3bfe28e3a3"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gafb36244534a4b9b1faa53d3bfe28e3a3">◆ </a></span>TEST_CASE() <span class="overload">[72/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"initClassicalState" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[state_initialisations] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__init.html#ga0379e21efca0767a22607fc0e26a5a22" title="Initialise qureg into the classical state (also known as a "computational basis state") with index st...">initClassicalState</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__state__initialisations_8cpp_source.html#l00123">123</a> of file <a class="el" href="test__state__initialisations_8cpp_source.html">test_state_initialisations.cpp</a>.</p>
<div class="fragment"><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>  </div>
<div class="line"><a name="l00125"></a><span class="lineno"> 125</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="l00126"></a><span class="lineno"> 126</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="l00127"></a><span class="lineno"> 127</span>  </div>
<div class="line"><a name="l00128"></a><span class="lineno"> 128</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</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>  <span class="keywordtype">int</span> numInds = (1<<<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>);</div>
<div class="line"><a name="l00131"></a><span class="lineno"> 131</span>  <span class="keywordtype">int</span> ind = GENERATE_COPY( range(0,numInds) );</div>
<div class="line"><a name="l00132"></a><span class="lineno"> 132</span>  </div>
<div class="line"><a name="l00133"></a><span class="lineno"> 133</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00134"></a><span class="lineno"> 134</span>  </div>
<div class="line"><a name="l00135"></a><span class="lineno"> 135</span>  <a class="code" href="group__init.html#ga0379e21efca0767a22607fc0e26a5a22">initClassicalState</a>(vec, ind);</div>
<div class="line"><a name="l00136"></a><span class="lineno"> 136</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> vecRef = <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a>(1<<<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>);</div>
<div class="line"><a name="l00137"></a><span class="lineno"> 137</span>  vecRef[ind] = 1;</div>
<div class="line"><a name="l00138"></a><span class="lineno"> 138</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vec, vecRef) );</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>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00141"></a><span class="lineno"> 141</span>  </div>
<div class="line"><a name="l00142"></a><span class="lineno"> 142</span>  <a class="code" href="group__init.html#ga0379e21efca0767a22607fc0e26a5a22">initClassicalState</a>(mat, ind);</div>
<div class="line"><a name="l00143"></a><span class="lineno"> 143</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> matRef = <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="l00144"></a><span class="lineno"> 144</span>  matRef[ind][ind] = 1;</div>
<div class="line"><a name="l00145"></a><span class="lineno"> 145</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(mat, matRef) );</div>
<div class="line"><a name="l00146"></a><span class="lineno"> 146</span>  }</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>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00149"></a><span class="lineno"> 149</span>  </div>
<div class="line"><a name="l00150"></a><span class="lineno"> 150</span>  SECTION( <span class="stringliteral">"state index"</span> ) {</div>
<div class="line"><a name="l00151"></a><span class="lineno"> 151</span>  </div>
<div class="line"><a name="l00152"></a><span class="lineno"> 152</span>  <span class="keywordtype">int</span> ind = GENERATE( -1, (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>  REQUIRE_THROWS_WITH( <a class="code" href="group__init.html#ga0379e21efca0767a22607fc0e26a5a22">initClassicalState</a>(vec, ind), Contains(<span class="stringliteral">"Invalid state index"</span>) );</div>
<div class="line"><a name="l00154"></a><span class="lineno"> 154</span>  }</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>  <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="l00157"></a><span class="lineno"> 157</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="l00158"></a><span class="lineno"> 158</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00153">getZeroMatrix()</a>, <a class="el" href="QuEST_8c_source.html#l00134">initClassicalState()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, and <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>.</p>
</div>
</div>
<a id="ga9e5aba81a2f4e762ce05a1c7abd9349a"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga9e5aba81a2f4e762ce05a1c7abd9349a">◆ </a></span>TEST_CASE() <span class="overload">[73/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"initComplexMatrixN" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[data_structures] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__type.html#ga429f1b90b3ef06c786dec8c7f0eda4ce" title="Initialises a ComplexMatrixN instance to have the passed real and imag values.">initComplexMatrixN</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__data__structures_8cpp_source.html#l00756">756</a> of file <a class="el" href="test__data__structures_8cpp_source.html">test_data_structures.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00756"></a><span class="lineno"> 756</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="comment">/* use of this function is illegal in C++ */</span></div>
<div class="line"><a name="l00759"></a><span class="lineno"> 759</span>  SUCCEED( );</div>
<div class="line"><a name="l00760"></a><span class="lineno"> 760</span> }</div>
</div><!-- fragment -->
</div>
</div>
<a id="gaa2c7bf2a5f949a7ecaf3e6a8225473db"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaa2c7bf2a5f949a7ecaf3e6a8225473db">◆ </a></span>TEST_CASE() <span class="overload">[74/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"initDiagonalOp" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[data_structures] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__type.html#ga12a6c59ebbfba8bdb9453a4138027d46" title="Overwrites the entire DiagonalOp op with the given real and imag complex elements.">initDiagonalOp</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__data__structures_8cpp_source.html#l00768">768</a> of file <a class="el" href="test__data__structures_8cpp_source.html">test_data_structures.cpp</a>.</p>
<div class="fragment"><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>  </div>
<div class="line"><a name="l00770"></a><span class="lineno"> 770</span>  <span class="comment">// must be at least one amplitude per node</span></div>
<div class="line"><a name="l00771"></a><span class="lineno"> 771</span>  <span class="keywordtype">int</span> minNumQb = <a class="code" href="group__testutilities.html#ga267884197cf7f1d428021cb12a57360c">calcLog2</a>(<a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>.<a class="code" href="structQuESTEnv.html#af22aacd7c9905accae28484785c193b4">numRanks</a>);</div>
<div class="line"><a name="l00772"></a><span class="lineno"> 772</span>  <span class="keywordflow">if</span> (minNumQb == 0)</div>
<div class="line"><a name="l00773"></a><span class="lineno"> 773</span>  minNumQb = 1;</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>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00776"></a><span class="lineno"> 776</span>  </div>
<div class="line"><a name="l00777"></a><span class="lineno"> 777</span>  <span class="comment">// try 10 valid number of qubits</span></div>
<div class="line"><a name="l00778"></a><span class="lineno"> 778</span>  <span class="keywordtype">int</span> numQb = GENERATE_COPY( range(minNumQb, minNumQb+10) );</div>
<div class="line"><a name="l00779"></a><span class="lineno"> 779</span>  <a class="code" href="structDiagonalOp.html">DiagonalOp</a> op = <a class="code" href="group__type.html#gaebf896dd8d5eeaf9fd896f6cc8e334fe">createDiagonalOp</a>(numQb, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</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>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <span class="keywordtype">int</span> len = (1LL << numQb);</div>
<div class="line"><a name="l00782"></a><span class="lineno"> 782</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> reals[len];</div>
<div class="line"><a name="l00783"></a><span class="lineno"> 783</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> imags[len];</div>
<div class="line"><a name="l00784"></a><span class="lineno"> 784</span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <span class="keywordtype">int</span> n;</div>
<div class="line"><a name="l00785"></a><span class="lineno"> 785</span>  <span class="keywordflow">for</span> (n=0; n<len; n++) {</div>
<div class="line"><a name="l00786"></a><span class="lineno"> 786</span>  reals[n] = (<a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>) n;</div>
<div class="line"><a name="l00787"></a><span class="lineno"> 787</span>  imags[n] = (<a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>) -2*n; <span class="comment">// (n - 2n i)</span></div>
<div class="line"><a name="l00788"></a><span class="lineno"> 788</span>  }</div>
<div class="line"><a name="l00789"></a><span class="lineno"> 789</span>  <a class="code" href="group__type.html#ga12a6c59ebbfba8bdb9453a4138027d46">initDiagonalOp</a>(op, reals, imags);</div>
<div class="line"><a name="l00790"></a><span class="lineno"> 790</span>  </div>
<div class="line"><a name="l00791"></a><span class="lineno"> 791</span>  <span class="comment">// check that op.real and op.imag were modified...</span></div>
<div class="line"><a name="l00792"></a><span class="lineno"> 792</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(<a class="code" href="group__testutilities.html#gade0e7c37811a69f1c21c88c11943a19f">toQVector</a>(op), reals, imags) );</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>  <span class="comment">// and also that GPU real and imag were modified</span></div>
<div class="line"><a name="l00795"></a><span class="lineno"> 795</span>  <span class="comment">// via if it modifies an all-unity state-vec correctly </span></div>
<div class="line"><a name="l00796"></a><span class="lineno"> 796</span>  <a class="code" href="structQureg.html">Qureg</a> qureg = <a class="code" href="group__type.html#ga3392816c0643414165c2f5caeec17df0">createQureg</a>(numQb, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00797"></a><span class="lineno"> 797</span>  <span class="keywordflow">for</span> (<span class="keywordtype">long</span> <span class="keywordtype">long</span> <span class="keywordtype">int</span> i=0; i<qureg.<a class="code" href="structQureg.html#ab0ea0358482b62f43fdd781469607d97">numAmpsPerChunk</a>; i++) {</div>
<div class="line"><a name="l00798"></a><span class="lineno"> 798</span>  qureg.<a class="code" href="structQureg.html#a441e4cacef6bd17adb9813c7442d42fe">stateVec</a>.real[i] = 1;</div>
<div class="line"><a name="l00799"></a><span class="lineno"> 799</span>  qureg.<a class="code" href="structQureg.html#a441e4cacef6bd17adb9813c7442d42fe">stateVec</a>.imag[i] = 1;</div>
<div class="line"><a name="l00800"></a><span class="lineno"> 800</span>  }</div>
<div class="line"><a name="l00801"></a><span class="lineno"> 801</span>  <a class="code" href="group__debug.html#ga11448560006dd165128e404b54ebb2f7">copyStateToGPU</a>(qureg);</div>
<div class="line"><a name="l00802"></a><span class="lineno"> 802</span>  </div>
<div class="line"><a name="l00803"></a><span class="lineno"> 803</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> prodRef = <a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(op) * <a class="code" href="group__testutilities.html#gade0e7c37811a69f1c21c88c11943a19f">toQVector</a>(qureg);</div>
<div class="line"><a name="l00804"></a><span class="lineno"> 804</span>  </div>
<div class="line"><a name="l00805"></a><span class="lineno"> 805</span>  <span class="comment">// (n - 2n i) * (1 + 1i) = 3n - n*i</span></div>
<div class="line"><a name="l00806"></a><span class="lineno"> 806</span>  <a class="code" href="group__operator.html#gad2e953390342cd361cfb4064d47715e6">applyDiagonalOp</a>(qureg, op);</div>
<div class="line"><a name="l00807"></a><span class="lineno"> 807</span>  <a class="code" href="group__debug.html#ga924ef2dbda6b733b4041270077c76ece">copyStateFromGPU</a>(qureg);</div>
<div class="line"><a name="l00808"></a><span class="lineno"> 808</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> result = <a class="code" href="group__testutilities.html#gade0e7c37811a69f1c21c88c11943a19f">toQVector</a>(qureg); </div>
<div class="line"><a name="l00809"></a><span class="lineno"> 809</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(prodRef, result) );</div>
<div class="line"><a name="l00810"></a><span class="lineno"> 810</span>  </div>
<div class="line"><a name="l00811"></a><span class="lineno"> 811</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(qureg, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00812"></a><span class="lineno"> 812</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="l00813"></a><span class="lineno"> 813</span>  }</div>
<div class="line"><a name="l00814"></a><span class="lineno"> 814</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l01127">applyDiagonalOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST__validation_8c_source.html#l00328">calcLog2()</a>, <a class="el" href="QuEST__cpu_8c_source.html#l00045">copyStateFromGPU()</a>, <a class="el" href="QuEST__cpu_8c_source.html#l00042">copyStateToGPU()</a>, <a class="el" href="QuEST_8c_source.html#l01518">createDiagonalOp()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l01524">destroyDiagonalOp()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="QuEST_8c_source.html#l01537">initDiagonalOp()</a>, <a class="el" href="QuEST_8h_source.html#l00332">Qureg::numAmpsPerChunk</a>, <a class="el" href="QuEST_8h_source.html#l00365">QuESTEnv::numRanks</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, <a class="el" href="QuEST_8h_source.html#l00341">Qureg::stateVec</a>, <a class="el" href="utilities_8cpp_source.html#l01044">toQMatrix()</a>, and <a class="el" href="utilities_8cpp_source.html#l01113">toQVector()</a>.</p>
</div>
</div>
<a id="ga2e45ead2b0f35b36a499980365d7cd1a"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga2e45ead2b0f35b36a499980365d7cd1a">◆ </a></span>TEST_CASE() <span class="overload">[75/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"initDiagonalOpFromPauliHamil" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[data_structures] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__type.html#ga2ecd67e0de9efcbbe37afbad28a8ffad" title="Populates the diagonal operator op to be equivalent to the given Pauli Hamiltonian hamil,...">initDiagonalOpFromPauliHamil</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__data__structures_8cpp_source.html#l00822">822</a> of file <a class="el" href="test__data__structures_8cpp_source.html">test_data_structures.cpp</a>.</p>
<div class="fragment"><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>  </div>
<div class="line"><a name="l00824"></a><span class="lineno"> 824</span>  <span class="comment">// distributed diagonal op must contain at least one amplitude per node</span></div>
<div class="line"><a name="l00825"></a><span class="lineno"> 825</span>  <span class="keywordtype">int</span> minNumQb = <a class="code" href="group__testutilities.html#ga267884197cf7f1d428021cb12a57360c">calcLog2</a>(<a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>.<a class="code" href="structQuESTEnv.html#af22aacd7c9905accae28484785c193b4">numRanks</a>);</div>
<div class="line"><a name="l00826"></a><span class="lineno"> 826</span>  <span class="keywordflow">if</span> (minNumQb == 0)</div>
<div class="line"><a name="l00827"></a><span class="lineno"> 827</span>  minNumQb = 1;</div>
<div class="line"><a name="l00828"></a><span class="lineno"> 828</span>  </div>
<div class="line"><a name="l00829"></a><span class="lineno"> 829</span>  SECTION( <span class="stringliteral">"correctness"</span> ) { </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="comment">// try (at most) 10 valid number of qubits (even for validation)</span></div>
<div class="line"><a name="l00832"></a><span class="lineno"> 832</span>  <span class="keywordtype">int</span> numQb = GENERATE_COPY( range(minNumQb, min(10,minNumQb+10)) );</div>
<div class="line"><a name="l00833"></a><span class="lineno"> 833</span>  <a class="code" href="structDiagonalOp.html">DiagonalOp</a> op = <a class="code" href="group__type.html#gaebf896dd8d5eeaf9fd896f6cc8e334fe">createDiagonalOp</a>(numQb, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</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">// try several sized random all-Z Hamiltonians</span></div>
<div class="line"><a name="l00836"></a><span class="lineno"> 836</span>  <span class="keywordtype">int</span> numTerms = GENERATE_COPY( 1, numQb, 5*numQb );</div>
<div class="line"><a name="l00837"></a><span class="lineno"> 837</span>  <a class="code" href="structPauliHamil.html">PauliHamil</a> hamil = <a class="code" href="group__type.html#ga35b28710877c462927366fa602e591cb">createPauliHamil</a>(numQb, numTerms);</div>
<div class="line"><a name="l00838"></a><span class="lineno"> 838</span>  <a class="code" href="group__testutilities.html#ga887d1cd8befe710189cab7f535db3910">setRandomDiagPauliHamil</a>(hamil);</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>  <a class="code" href="group__type.html#ga2ecd67e0de9efcbbe37afbad28a8ffad">initDiagonalOpFromPauliHamil</a>(op, hamil);</div>
<div class="line"><a name="l00841"></a><span class="lineno"> 841</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(<a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(op), <a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(hamil)) );</div>
<div class="line"><a name="l00842"></a><span class="lineno"> 842</span>  </div>
<div class="line"><a name="l00843"></a><span class="lineno"> 843</span>  <a class="code" href="group__type.html#gac1c8ed909b33bd55ae680901006051b6">destroyPauliHamil</a>(hamil);</div>
<div class="line"><a name="l00844"></a><span class="lineno"> 844</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="l00845"></a><span class="lineno"> 845</span>  }</div>
<div class="line"><a name="l00846"></a><span class="lineno"> 846</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00847"></a><span class="lineno"> 847</span>  </div>
<div class="line"><a name="l00848"></a><span class="lineno"> 848</span>  SECTION( <span class="stringliteral">"hamiltonian parameters"</span> ) {</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>  <a class="code" href="structDiagonalOp.html">DiagonalOp</a> op = <a class="code" href="group__type.html#gaebf896dd8d5eeaf9fd896f6cc8e334fe">createDiagonalOp</a>(minNumQb, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00851"></a><span class="lineno"> 851</span>  <a class="code" href="structPauliHamil.html">PauliHamil</a> hamil;</div>
<div class="line"><a name="l00852"></a><span class="lineno"> 852</span>  </div>
<div class="line"><a name="l00853"></a><span class="lineno"> 853</span>  hamil.<a class="code" href="structPauliHamil.html#acb49fff0e3160ea1904c9ca34408b4e1">numQubits</a> = GENERATE( -1, 0 );</div>
<div class="line"><a name="l00854"></a><span class="lineno"> 854</span>  hamil.<a class="code" href="structPauliHamil.html#a737e46b40ef8990cf004d22eb9dbe2e4">numSumTerms</a> = 1;</div>
<div class="line"><a name="l00855"></a><span class="lineno"> 855</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__type.html#ga2ecd67e0de9efcbbe37afbad28a8ffad">initDiagonalOpFromPauliHamil</a>(op, hamil), Contains(<span class="stringliteral">"number of qubits"</span>) && Contains(<span class="stringliteral">"strictly positive"</span>) );</div>
<div class="line"><a name="l00856"></a><span class="lineno"> 856</span>  </div>
<div class="line"><a name="l00857"></a><span class="lineno"> 857</span>  hamil.<a class="code" href="structPauliHamil.html#acb49fff0e3160ea1904c9ca34408b4e1">numQubits</a> = minNumQb;</div>
<div class="line"><a name="l00858"></a><span class="lineno"> 858</span>  hamil.<a class="code" href="structPauliHamil.html#a737e46b40ef8990cf004d22eb9dbe2e4">numSumTerms</a> = GENERATE( -1, 0 );</div>
<div class="line"><a name="l00859"></a><span class="lineno"> 859</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__type.html#ga2ecd67e0de9efcbbe37afbad28a8ffad">initDiagonalOpFromPauliHamil</a>(op, hamil), Contains(<span class="stringliteral">"terms"</span>) && Contains(<span class="stringliteral">"strictly positive"</span>) );</div>
<div class="line"><a name="l00860"></a><span class="lineno"> 860</span>  </div>
<div class="line"><a name="l00861"></a><span class="lineno"> 861</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="l00862"></a><span class="lineno"> 862</span>  }</div>
<div class="line"><a name="l00863"></a><span class="lineno"> 863</span>  SECTION( <span class="stringliteral">"mismatching dimensions"</span> ) {</div>
<div class="line"><a name="l00864"></a><span class="lineno"> 864</span>  </div>
<div class="line"><a name="l00865"></a><span class="lineno"> 865</span>  <span class="keywordtype">int</span> numQbA = minNumQb+1;</div>
<div class="line"><a name="l00866"></a><span class="lineno"> 866</span>  <span class="keywordtype">int</span> numQbB = GENERATE_COPY( numQbA-1, numQbA+1 );</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>  <a class="code" href="structDiagonalOp.html">DiagonalOp</a> op = <a class="code" href="group__type.html#gaebf896dd8d5eeaf9fd896f6cc8e334fe">createDiagonalOp</a>(numQbA, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00869"></a><span class="lineno"> 869</span>  <a class="code" href="structPauliHamil.html">PauliHamil</a> hamil = <a class="code" href="group__type.html#ga35b28710877c462927366fa602e591cb">createPauliHamil</a>(numQbB, 1);</div>
<div class="line"><a name="l00870"></a><span class="lineno"> 870</span>  </div>
<div class="line"><a name="l00871"></a><span class="lineno"> 871</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__type.html#ga2ecd67e0de9efcbbe37afbad28a8ffad">initDiagonalOpFromPauliHamil</a>(op, hamil), Contains(<span class="stringliteral">"Pauli Hamiltonian and diagonal operator have different, incompatible dimensions"</span>) );</div>
<div class="line"><a name="l00872"></a><span class="lineno"> 872</span>  </div>
<div class="line"><a name="l00873"></a><span class="lineno"> 873</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="l00874"></a><span class="lineno"> 874</span>  <a class="code" href="group__type.html#gac1c8ed909b33bd55ae680901006051b6">destroyPauliHamil</a>(hamil);</div>
<div class="line"><a name="l00875"></a><span class="lineno"> 875</span>  }</div>
<div class="line"><a name="l00876"></a><span class="lineno"> 876</span>  SECTION( <span class="stringliteral">"pauli codes"</span> ) {</div>
<div class="line"><a name="l00877"></a><span class="lineno"> 877</span>  </div>
<div class="line"><a name="l00878"></a><span class="lineno"> 878</span>  <a class="code" href="structDiagonalOp.html">DiagonalOp</a> op = <a class="code" href="group__type.html#gaebf896dd8d5eeaf9fd896f6cc8e334fe">createDiagonalOp</a>(minNumQb, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00879"></a><span class="lineno"> 879</span>  <a class="code" href="structPauliHamil.html">PauliHamil</a> hamil = <a class="code" href="group__type.html#ga35b28710877c462927366fa602e591cb">createPauliHamil</a>(minNumQb, 5); <span class="comment">// all I</span></div>
<div class="line"><a name="l00880"></a><span class="lineno"> 880</span>  </div>
<div class="line"><a name="l00881"></a><span class="lineno"> 881</span>  <span class="comment">// make only one code invalid</span></div>
<div class="line"><a name="l00882"></a><span class="lineno"> 882</span>  <span class="keywordtype">int</span> numCodes = minNumQb * hamil.<a class="code" href="structPauliHamil.html#a737e46b40ef8990cf004d22eb9dbe2e4">numSumTerms</a>;</div>
<div class="line"><a name="l00883"></a><span class="lineno"> 883</span>  <span class="keywordtype">int</span> ind = GENERATE_COPY( range(0,numCodes) );</div>
<div class="line"><a name="l00884"></a><span class="lineno"> 884</span>  hamil.<a class="code" href="structPauliHamil.html#a4b8d38c403553c07ceddcd40c46ce6c8">pauliCodes</a>[ind] = GENERATE( <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="l00885"></a><span class="lineno"> 885</span>  </div>
<div class="line"><a name="l00886"></a><span class="lineno"> 886</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__type.html#ga2ecd67e0de9efcbbe37afbad28a8ffad">initDiagonalOpFromPauliHamil</a>(op, hamil), Contains(<span class="stringliteral">"contained operators other than PAULI_Z and PAULI_I"</span>) );</div>
<div class="line"><a name="l00887"></a><span class="lineno"> 887</span>  </div>
<div class="line"><a name="l00888"></a><span class="lineno"> 888</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="l00889"></a><span class="lineno"> 889</span>  <a class="code" href="group__type.html#gac1c8ed909b33bd55ae680901006051b6">destroyPauliHamil</a>(hamil);</div>
<div class="line"><a name="l00890"></a><span class="lineno"> 890</span>  }</div>
<div class="line"><a name="l00891"></a><span class="lineno"> 891</span>  }</div>
<div class="line"><a name="l00892"></a><span class="lineno"> 892</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST__validation_8c_source.html#l00328">calcLog2()</a>, <a class="el" href="QuEST_8c_source.html#l01518">createDiagonalOp()</a>, <a class="el" href="QuEST_8c_source.html#l01398">createPauliHamil()</a>, <a class="el" href="QuEST_8c_source.html#l01524">destroyDiagonalOp()</a>, <a class="el" href="QuEST_8c_source.html#l01414">destroyPauliHamil()</a>, <a class="el" href="QuEST_8c_source.html#l01550">initDiagonalOpFromPauliHamil()</a>, <a class="el" href="QuEST_8h_source.html#l00287">PauliHamil::numQubits</a>, <a class="el" href="QuEST_8h_source.html#l00365">QuESTEnv::numRanks</a>, <a class="el" href="QuEST_8h_source.html#l00285">PauliHamil::numSumTerms</a>, <a class="el" href="QuEST_8h_source.html#l00096">PAULI_X</a>, <a class="el" href="QuEST_8h_source.html#l00096">PAULI_Y</a>, <a class="el" href="QuEST_8h_source.html#l00281">PauliHamil::pauliCodes</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, <a class="el" href="utilities_8cpp_source.html#l01241">setRandomDiagPauliHamil()</a>, and <a class="el" href="utilities_8cpp_source.html#l01044">toQMatrix()</a>.</p>
</div>
</div>
<a id="ga39589b493222666589cb6596b219a14d"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga39589b493222666589cb6596b219a14d">◆ </a></span>TEST_CASE() <span class="overload">[76/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"initPauliHamil" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[data_structures] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__type.html#gadbe6701dda1d49168f2f23253e370a7a" title="Initialise PauliHamil instance hamil with the given term coefficients and Pauli codes (one for every ...">initPauliHamil</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__data__structures_8cpp_source.html#l00900">900</a> of file <a class="el" href="test__data__structures_8cpp_source.html">test_data_structures.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00900"></a><span class="lineno"> 900</span>  {</div>
<div class="line"><a name="l00901"></a><span class="lineno"> 901</span>  </div>
<div class="line"><a name="l00902"></a><span class="lineno"> 902</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</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="structPauliHamil.html">PauliHamil</a> hamil = <a class="code" href="group__type.html#ga35b28710877c462927366fa602e591cb">createPauliHamil</a>(3, 2);</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>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeffs[] = {-5, 5};</div>
<div class="line"><a name="l00907"></a><span class="lineno"> 907</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a> codes[] = {</div>
<div class="line"><a name="l00908"></a><span class="lineno"> 908</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>,</div>
<div class="line"><a name="l00909"></a><span class="lineno"> 909</span>  <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a085c85cff6ba79c52d8b1e61c42ddddf">PAULI_Z</a>, <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a2c64a9aaee27f6bcfef894d159e759bd">PAULI_Y</a>, <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a7abac7bb5b71e17382014c443244ad5c">PAULI_X</a>};</div>
<div class="line"><a name="l00910"></a><span class="lineno"> 910</span>  <a class="code" href="group__type.html#gadbe6701dda1d49168f2f23253e370a7a">initPauliHamil</a>(hamil, coeffs, codes);</div>
<div class="line"><a name="l00911"></a><span class="lineno"> 911</span>  </div>
<div class="line"><a name="l00912"></a><span class="lineno"> 912</span>  <span class="comment">// check everything written correctly</span></div>
<div class="line"><a name="l00913"></a><span class="lineno"> 913</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> t=0; t<2; t++) {</div>
<div class="line"><a name="l00914"></a><span class="lineno"> 914</span>  REQUIRE( coeffs[t] == hamil.<a class="code" href="structPauliHamil.html#ac1c6c9f6299cf83bbba88123216c3cac">termCoeffs</a>[t] );</div>
<div class="line"><a name="l00915"></a><span class="lineno"> 915</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> q=0; q<3; q++) {</div>
<div class="line"><a name="l00916"></a><span class="lineno"> 916</span>  <span class="keywordtype">int</span> ind = 3*t+q;</div>
<div class="line"><a name="l00917"></a><span class="lineno"> 917</span>  REQUIRE( codes[ind] == hamil.<a class="code" href="structPauliHamil.html#a4b8d38c403553c07ceddcd40c46ce6c8">pauliCodes</a>[ind] );</div>
<div class="line"><a name="l00918"></a><span class="lineno"> 918</span>  }</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>  </div>
<div class="line"><a name="l00921"></a><span class="lineno"> 921</span>  <a class="code" href="group__type.html#gac1c8ed909b33bd55ae680901006051b6">destroyPauliHamil</a>(hamil);</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>  SECTION( <span class="stringliteral">"input validation"</span> ) {</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">"parameters"</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>  <span class="comment">// parameters checked before codes, so safe to leave un-initialised</span></div>
<div class="line"><a name="l00928"></a><span class="lineno"> 928</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeffs[1];</div>
<div class="line"><a name="l00929"></a><span class="lineno"> 929</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a> codes[1];</div>
<div class="line"><a name="l00930"></a><span class="lineno"> 930</span>  <a class="code" href="structPauliHamil.html">PauliHamil</a> hamil;</div>
<div class="line"><a name="l00931"></a><span class="lineno"> 931</span>  </div>
<div class="line"><a name="l00932"></a><span class="lineno"> 932</span>  hamil.<a class="code" href="structPauliHamil.html#acb49fff0e3160ea1904c9ca34408b4e1">numQubits</a> = GENERATE( -1, 0 );</div>
<div class="line"><a name="l00933"></a><span class="lineno"> 933</span>  hamil.<a class="code" href="structPauliHamil.html#a737e46b40ef8990cf004d22eb9dbe2e4">numSumTerms</a> = 1;</div>
<div class="line"><a name="l00934"></a><span class="lineno"> 934</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__type.html#gadbe6701dda1d49168f2f23253e370a7a">initPauliHamil</a>(hamil, coeffs, codes), Contains(<span class="stringliteral">"number of qubits"</span>) && Contains(<span class="stringliteral">"strictly positive"</span>) );</div>
<div class="line"><a name="l00935"></a><span class="lineno"> 935</span>  </div>
<div class="line"><a name="l00936"></a><span class="lineno"> 936</span>  hamil.<a class="code" href="structPauliHamil.html#acb49fff0e3160ea1904c9ca34408b4e1">numQubits</a> = 1;</div>
<div class="line"><a name="l00937"></a><span class="lineno"> 937</span>  hamil.<a class="code" href="structPauliHamil.html#a737e46b40ef8990cf004d22eb9dbe2e4">numSumTerms</a> = GENERATE( -1, 0 );</div>
<div class="line"><a name="l00938"></a><span class="lineno"> 938</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__type.html#gadbe6701dda1d49168f2f23253e370a7a">initPauliHamil</a>(hamil, coeffs, codes), Contains(<span class="stringliteral">"terms"</span>) && Contains(<span class="stringliteral">"strictly positive"</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>  SECTION( <span class="stringliteral">"Pauli codes"</span> ) {</div>
<div class="line"><a name="l00941"></a><span class="lineno"> 941</span>  </div>
<div class="line"><a name="l00942"></a><span class="lineno"> 942</span>  <span class="keywordtype">int</span> numQb = 3;</div>
<div class="line"><a name="l00943"></a><span class="lineno"> 943</span>  <span class="keywordtype">int</span> numTerms = 2;</div>
<div class="line"><a name="l00944"></a><span class="lineno"> 944</span>  <span class="keywordtype">int</span> numCodes = numQb * numTerms;</div>
<div class="line"><a name="l00945"></a><span class="lineno"> 945</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeffs[numTerms];</div>
<div class="line"><a name="l00946"></a><span class="lineno"> 946</span>  <span class="keyword">enum</span> <a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a> codes[numCodes];</div>
<div class="line"><a name="l00947"></a><span class="lineno"> 947</span>  </div>
<div class="line"><a name="l00948"></a><span class="lineno"> 948</span>  <span class="comment">// make only one code invalid</span></div>
<div class="line"><a name="l00949"></a><span class="lineno"> 949</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numCodes; i++)</div>
<div class="line"><a name="l00950"></a><span class="lineno"> 950</span>  codes[i] = <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a63800f45b01ccc2608f754aee850bf4a">PAULI_I</a>;</div>
<div class="line"><a name="l00951"></a><span class="lineno"> 951</span>  codes[GENERATE_COPY( range(0,numCodes) )] = (<a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a>) GENERATE( -1, 4 );</div>
<div class="line"><a name="l00952"></a><span class="lineno"> 952</span>  </div>
<div class="line"><a name="l00953"></a><span class="lineno"> 953</span>  <a class="code" href="structPauliHamil.html">PauliHamil</a> hamil = <a class="code" href="group__type.html#ga35b28710877c462927366fa602e591cb">createPauliHamil</a>(numQb, numTerms);</div>
<div class="line"><a name="l00954"></a><span class="lineno"> 954</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__type.html#gadbe6701dda1d49168f2f23253e370a7a">initPauliHamil</a>(hamil, coeffs, codes), Contains(<span class="stringliteral">"Invalid Pauli code"</span>) );</div>
<div class="line"><a name="l00955"></a><span class="lineno"> 955</span>  <a class="code" href="group__type.html#gac1c8ed909b33bd55ae680901006051b6">destroyPauliHamil</a>(hamil);</div>
<div class="line"><a name="l00956"></a><span class="lineno"> 956</span>  }</div>
<div class="line"><a name="l00957"></a><span class="lineno"> 957</span>  }</div>
<div class="line"><a name="l00958"></a><span class="lineno"> 958</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l01398">createPauliHamil()</a>, <a class="el" href="QuEST_8c_source.html#l01414">destroyPauliHamil()</a>, <a class="el" href="QuEST_8c_source.html#l01504">initPauliHamil()</a>, <a class="el" href="QuEST_8h_source.html#l00287">PauliHamil::numQubits</a>, <a class="el" href="QuEST_8h_source.html#l00285">PauliHamil::numSumTerms</a>, <a class="el" href="QuEST_8h_source.html#l00096">PAULI_I</a>, <a class="el" href="QuEST_8h_source.html#l00096">PAULI_X</a>, <a class="el" href="QuEST_8h_source.html#l00096">PAULI_Y</a>, <a class="el" href="QuEST_8h_source.html#l00096">PAULI_Z</a>, <a class="el" href="QuEST_8h_source.html#l00281">PauliHamil::pauliCodes</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, and <a class="el" href="QuEST_8h_source.html#l00283">PauliHamil::termCoeffs</a>.</p>
</div>
</div>
<a id="gaf2260af68bc6f547784bc900602ef5fe"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaf2260af68bc6f547784bc900602ef5fe">◆ </a></span>TEST_CASE() <span class="overload">[77/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"initPlusState" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[state_initialisations] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__init.html#ga234bd34016f08288532791903b9884b5" title="Initialise qureg into the plus state.">initPlusState</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__state__initialisations_8cpp_source.html#l00166">166</a> of file <a class="el" href="test__state__initialisations_8cpp_source.html">test_state_initialisations.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00166"></a><span class="lineno"> 166</span>  {</div>
<div class="line"><a name="l00167"></a><span class="lineno"> 167</span>  </div>
<div class="line"><a name="l00168"></a><span class="lineno"> 168</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="l00169"></a><span class="lineno"> 169</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="l00170"></a><span class="lineno"> 170</span>  </div>
<div class="line"><a name="l00171"></a><span class="lineno"> 171</span>  SECTION( <span class="stringliteral">"correctness"</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>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00174"></a><span class="lineno"> 174</span>  </div>
<div class="line"><a name="l00175"></a><span class="lineno"> 175</span>  <span class="comment">// |+> = 1/sqrt(N^2) sum_i |i></span></div>
<div class="line"><a name="l00176"></a><span class="lineno"> 176</span>  <span class="comment">// = 1/sqrt(N^2) {1, ..., 1}</span></div>
<div class="line"><a name="l00177"></a><span class="lineno"> 177</span>  <a class="code" href="group__init.html#ga234bd34016f08288532791903b9884b5">initPlusState</a>(vec);</div>
<div class="line"><a name="l00178"></a><span class="lineno"> 178</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> vecRef = <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a>(1<<<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>);</div>
<div class="line"><a name="l00179"></a><span class="lineno"> 179</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<vecRef.size(); i++)</div>
<div class="line"><a name="l00180"></a><span class="lineno"> 180</span>  vecRef[i] = 1./sqrt(pow(2,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>));</div>
<div class="line"><a name="l00181"></a><span class="lineno"> 181</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vec, vecRef) );</div>
<div class="line"><a name="l00182"></a><span class="lineno"> 182</span>  }</div>
<div class="line"><a name="l00183"></a><span class="lineno"> 183</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00184"></a><span class="lineno"> 184</span>  </div>
<div class="line"><a name="l00185"></a><span class="lineno"> 185</span>  <span class="comment">// |+><+| = 1/sqrt(N^2) sum_i |i> 1/sqrt(N^2) sum_j <j|</span></div>
<div class="line"><a name="l00186"></a><span class="lineno"> 186</span>  <span class="comment">// = 1/(N^2) sum_{ij} |i><j|</span></div>
<div class="line"><a name="l00187"></a><span class="lineno"> 187</span>  <span class="comment">// = 1/(N^2) {{1, ..., 1}, ...}</span></div>
<div class="line"><a name="l00188"></a><span class="lineno"> 188</span>  <a class="code" href="group__init.html#ga234bd34016f08288532791903b9884b5">initPlusState</a>(mat);</div>
<div class="line"><a name="l00189"></a><span class="lineno"> 189</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> matRef = <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="l00190"></a><span class="lineno"> 190</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<matRef.size(); i++)</div>
<div class="line"><a name="l00191"></a><span class="lineno"> 191</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> j=0; j<matRef.size(); j++)</div>
<div class="line"><a name="l00192"></a><span class="lineno"> 192</span>  matRef[i][j] = 1./pow(2, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>);</div>
<div class="line"><a name="l00193"></a><span class="lineno"> 193</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(mat, matRef) );</div>
<div class="line"><a name="l00194"></a><span class="lineno"> 194</span>  }</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>  SECTION( <span class="stringliteral">"input validation"</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>  <span class="comment">// no user validation</span></div>
<div class="line"><a name="l00199"></a><span class="lineno"> 199</span>  SUCCEED( );</div>
<div class="line"><a name="l00200"></a><span class="lineno"> 200</span>  }</div>
<div class="line"><a name="l00201"></a><span class="lineno"> 201</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="l00202"></a><span class="lineno"> 202</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="l00203"></a><span class="lineno"> 203</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00153">getZeroMatrix()</a>, <a class="el" href="QuEST_8c_source.html#l00125">initPlusState()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, and <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>.</p>
</div>
</div>
<a id="gace25006fc345a5e33f17f1fdde217922"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gace25006fc345a5e33f17f1fdde217922">◆ </a></span>TEST_CASE() <span class="overload">[78/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"initPureState" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[state_initialisations] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__init.html#ga9a348df3e1df623c3d4c4f12c3ee3fe8" title="Initialise qureg into to a given pure state of an equivalent Hilbert dimension.">initPureState</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__state__initialisations_8cpp_source.html#l00211">211</a> of file <a class="el" href="test__state__initialisations_8cpp_source.html">test_state_initialisations.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00211"></a><span class="lineno"> 211</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>  <a class="code" href="structQureg.html">Qureg</a> vec1 = <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="l00214"></a><span class="lineno"> 214</span>  <a class="code" href="structQureg.html">Qureg</a> mat1 = <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="l00215"></a><span class="lineno"> 215</span>  </div>
<div class="line"><a name="l00216"></a><span class="lineno"> 216</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00217"></a><span class="lineno"> 217</span>  </div>
<div class="line"><a name="l00218"></a><span class="lineno"> 218</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00219"></a><span class="lineno"> 219</span>  </div>
<div class="line"><a name="l00220"></a><span class="lineno"> 220</span>  <span class="comment">/* state-vector version just performs cloneQureg */</span></div>
<div class="line"><a name="l00221"></a><span class="lineno"> 221</span>  </div>
<div class="line"><a name="l00222"></a><span class="lineno"> 222</span>  <a class="code" href="structQureg.html">Qureg</a> vec2 = <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="l00223"></a><span class="lineno"> 223</span>  </div>
<div class="line"><a name="l00224"></a><span class="lineno"> 224</span>  <span class="comment">// make sure states start differently</span></div>
<div class="line"><a name="l00225"></a><span class="lineno"> 225</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(vec1); </div>
<div class="line"><a name="l00226"></a><span class="lineno"> 226</span>  <a class="code" href="group__init.html#gada7230491a50cd409f8b00f5ee1db953">initBlankState</a>(vec2);</div>
<div class="line"><a name="l00227"></a><span class="lineno"> 227</span>  REQUIRE( !<a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vec1, vec2) );</div>
<div class="line"><a name="l00228"></a><span class="lineno"> 228</span>  </div>
<div class="line"><a name="l00229"></a><span class="lineno"> 229</span>  <span class="comment">// make sure vec2 is overwritten with vec1</span></div>
<div class="line"><a name="l00230"></a><span class="lineno"> 230</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> copy1 = <a class="code" href="group__testutilities.html#gade0e7c37811a69f1c21c88c11943a19f">toQVector</a>(vec1);</div>
<div class="line"><a name="l00231"></a><span class="lineno"> 231</span>  <a class="code" href="group__init.html#ga9a348df3e1df623c3d4c4f12c3ee3fe8">initPureState</a>(vec2, vec1);</div>
<div class="line"><a name="l00232"></a><span class="lineno"> 232</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vec1, vec2) );</div>
<div class="line"><a name="l00233"></a><span class="lineno"> 233</span>  </div>
<div class="line"><a name="l00234"></a><span class="lineno"> 234</span>  <span class="comment">// make sure vec1 was not modified </span></div>
<div class="line"><a name="l00235"></a><span class="lineno"> 235</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vec1, copy1) );</div>
<div class="line"><a name="l00236"></a><span class="lineno"> 236</span>  </div>
<div class="line"><a name="l00237"></a><span class="lineno"> 237</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(vec2, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00238"></a><span class="lineno"> 238</span>  }</div>
<div class="line"><a name="l00239"></a><span class="lineno"> 239</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00240"></a><span class="lineno"> 240</span>  </div>
<div class="line"><a name="l00241"></a><span class="lineno"> 241</span>  <span class="comment">/* density matrix version initialises matrix in |pure><pure| */</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>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(vec1); <span class="comment">// |vec1> = sum_i a_i |i></span></div>
<div class="line"><a name="l00244"></a><span class="lineno"> 244</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> copy1 = <a class="code" href="group__testutilities.html#gade0e7c37811a69f1c21c88c11943a19f">toQVector</a>(vec1);</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>  <span class="comment">// make sure mat1 is modified correctly</span></div>
<div class="line"><a name="l00247"></a><span class="lineno"> 247</span>  <a class="code" href="group__init.html#gada7230491a50cd409f8b00f5ee1db953">initBlankState</a>(mat1); </div>
<div class="line"><a name="l00248"></a><span class="lineno"> 248</span>  <a class="code" href="group__init.html#ga9a348df3e1df623c3d4c4f12c3ee3fe8">initPureState</a>(mat1, vec1); <span class="comment">// mat1 = |vec1><vec1| = sum_{ij} a_i a_j* |i><j|</span></div>
<div class="line"><a name="l00249"></a><span class="lineno"> 249</span>  </div>
<div class="line"><a name="l00250"></a><span class="lineno"> 250</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> matRef = <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="l00251"></a><span class="lineno"> 251</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<matRef.size(); i++)</div>
<div class="line"><a name="l00252"></a><span class="lineno"> 252</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> j=0; j<matRef.size(); j++)</div>
<div class="line"><a name="l00253"></a><span class="lineno"> 253</span>  matRef[i][j] = copy1[i] * conj(copy1[j]);</div>
<div class="line"><a name="l00254"></a><span class="lineno"> 254</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(mat1, matRef) );</div>
<div class="line"><a name="l00255"></a><span class="lineno"> 255</span>  </div>
<div class="line"><a name="l00256"></a><span class="lineno"> 256</span>  <span class="comment">// make sure vec1 was not modified</span></div>
<div class="line"><a name="l00257"></a><span class="lineno"> 257</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vec1, copy1) );</div>
<div class="line"><a name="l00258"></a><span class="lineno"> 258</span>  }</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>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00261"></a><span class="lineno"> 261</span>  </div>
<div class="line"><a name="l00262"></a><span class="lineno"> 262</span>  SECTION( <span class="stringliteral">"qureg types"</span> ) {</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>  <span class="comment">// density matrix as second arg is illegal (regardless of first arg)</span></div>
<div class="line"><a name="l00265"></a><span class="lineno"> 265</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__init.html#ga9a348df3e1df623c3d4c4f12c3ee3fe8">initPureState</a>(vec1, mat1), Contains(<span class="stringliteral">"Second argument must be a state-vector"</span>) );</div>
<div class="line"><a name="l00266"></a><span class="lineno"> 266</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__init.html#ga9a348df3e1df623c3d4c4f12c3ee3fe8">initPureState</a>(mat1, mat1), Contains(<span class="stringliteral">"Second argument must be a state-vector"</span>) );</div>
<div class="line"><a name="l00267"></a><span class="lineno"> 267</span>  }</div>
<div class="line"><a name="l00268"></a><span class="lineno"> 268</span>  SECTION( <span class="stringliteral">"qureg dimensions"</span> ) {</div>
<div class="line"><a name="l00269"></a><span class="lineno"> 269</span>  </div>
<div class="line"><a name="l00270"></a><span class="lineno"> 270</span>  <a class="code" href="structQureg.html">Qureg</a> vec2 = <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="l00271"></a><span class="lineno"> 271</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__init.html#ga9a348df3e1df623c3d4c4f12c3ee3fe8">initPureState</a>(vec1, vec2), Contains(<span class="stringliteral">"Dimensions"</span>) && Contains(<span class="stringliteral">"don't match"</span>) );</div>
<div class="line"><a name="l00272"></a><span class="lineno"> 272</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__init.html#ga9a348df3e1df623c3d4c4f12c3ee3fe8">initPureState</a>(mat1, vec2), Contains(<span class="stringliteral">"Dimensions"</span>) && Contains(<span class="stringliteral">"don't match"</span>) );</div>
<div class="line"><a name="l00273"></a><span class="lineno"> 273</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(vec2, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</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>  }</div>
<div class="line"><a name="l00276"></a><span class="lineno"> 276</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(vec1, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00277"></a><span class="lineno"> 277</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(mat1, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00278"></a><span class="lineno"> 278</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00153">getZeroMatrix()</a>, <a class="el" href="QuEST_8c_source.html#l00119">initBlankState()</a>, <a class="el" href="QuEST_8c_source.html#l01578">initDebugState()</a>, <a class="el" href="QuEST_8c_source.html#l00145">initPureState()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, and <a class="el" href="utilities_8cpp_source.html#l01113">toQVector()</a>.</p>
</div>
</div>
<a id="ga4850d47d4eb8f39634b45e1073a46c09"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga4850d47d4eb8f39634b45e1073a46c09">◆ </a></span>TEST_CASE() <span class="overload">[79/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"initStateFromAmps" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[state_initialisations] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__init.html#ga4589960486ec43dcd63bd985f1c4f398" title="Initialise qureg by specifying all amplitudes.">initStateFromAmps</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__state__initialisations_8cpp_source.html#l00286">286</a> of file <a class="el" href="test__state__initialisations_8cpp_source.html">test_state_initialisations.cpp</a>.</p>
<div class="fragment"><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>  <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="l00289"></a><span class="lineno"> 289</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="l00290"></a><span class="lineno"> 290</span>  </div>
<div class="line"><a name="l00291"></a><span class="lineno"> 291</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00292"></a><span class="lineno"> 292</span>  </div>
<div class="line"><a name="l00293"></a><span class="lineno"> 293</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00294"></a><span class="lineno"> 294</span>  </div>
<div class="line"><a name="l00295"></a><span class="lineno"> 295</span>  <span class="comment">// create random (unnormalised) vector</span></div>
<div class="line"><a name="l00296"></a><span class="lineno"> 296</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="l00297"></a><span class="lineno"> 297</span>  </div>
<div class="line"><a name="l00298"></a><span class="lineno"> 298</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> ampsRe[vec.<a class="code" href="structQureg.html#adef4935cac95763c29164cf99b144ed4">numAmpsTotal</a>];</div>
<div class="line"><a name="l00299"></a><span class="lineno"> 299</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> ampsIm[vec.<a class="code" href="structQureg.html#adef4935cac95763c29164cf99b144ed4">numAmpsTotal</a>];</div>
<div class="line"><a name="l00300"></a><span class="lineno"> 300</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<vecRef.size(); i++) {</div>
<div class="line"><a name="l00301"></a><span class="lineno"> 301</span>  ampsRe[i] = real(vecRef[i]);</div>
<div class="line"><a name="l00302"></a><span class="lineno"> 302</span>  ampsIm[i] = imag(vecRef[i]);</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>  </div>
<div class="line"><a name="l00305"></a><span class="lineno"> 305</span>  <a class="code" href="group__init.html#ga4589960486ec43dcd63bd985f1c4f398">initStateFromAmps</a>(vec, ampsRe, ampsIm);</div>
<div class="line"><a name="l00306"></a><span class="lineno"> 306</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vec, vecRef) );</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>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00309"></a><span class="lineno"> 309</span>  </div>
<div class="line"><a name="l00310"></a><span class="lineno"> 310</span>  <span class="comment">// create random (unnormalised) matrix</span></div>
<div class="line"><a name="l00311"></a><span class="lineno"> 311</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="l00312"></a><span class="lineno"> 312</span>  </div>
<div class="line"><a name="l00313"></a><span class="lineno"> 313</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> ampsRe[mat.<a class="code" href="structQureg.html#adef4935cac95763c29164cf99b144ed4">numAmpsTotal</a>];</div>
<div class="line"><a name="l00314"></a><span class="lineno"> 314</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> ampsIm[mat.<a class="code" href="structQureg.html#adef4935cac95763c29164cf99b144ed4">numAmpsTotal</a>];</div>
<div class="line"><a name="l00315"></a><span class="lineno"> 315</span>  </div>
<div class="line"><a name="l00316"></a><span class="lineno"> 316</span>  <span class="comment">// populate column-wise </span></div>
<div class="line"><a name="l00317"></a><span class="lineno"> 317</span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <span class="keywordtype">int</span> i=0;</div>
<div class="line"><a name="l00318"></a><span class="lineno"> 318</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> c=0; c<matRef.size(); c++) {</div>
<div class="line"><a name="l00319"></a><span class="lineno"> 319</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> r=0; r<matRef.size(); r++) {</div>
<div class="line"><a name="l00320"></a><span class="lineno"> 320</span>  ampsRe[i] = real(matRef[r][c]);</div>
<div class="line"><a name="l00321"></a><span class="lineno"> 321</span>  ampsIm[i] = imag(matRef[r][c]);</div>
<div class="line"><a name="l00322"></a><span class="lineno"> 322</span>  i++;</div>
<div class="line"><a name="l00323"></a><span class="lineno"> 323</span>  }</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>  </div>
<div class="line"><a name="l00326"></a><span class="lineno"> 326</span>  <a class="code" href="group__init.html#ga4589960486ec43dcd63bd985f1c4f398">initStateFromAmps</a>(mat, ampsRe, ampsIm);</div>
<div class="line"><a name="l00327"></a><span class="lineno"> 327</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(mat, matRef) );</div>
<div class="line"><a name="l00328"></a><span class="lineno"> 328</span>  }</div>
<div class="line"><a name="l00329"></a><span class="lineno"> 329</span>  }</div>
<div class="line"><a name="l00330"></a><span class="lineno"> 330</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="l00331"></a><span class="lineno"> 331</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="l00332"></a><span class="lineno"> 332</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00379">getRandomQMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00435">getRandomQVector()</a>, <a class="el" href="QuEST_8c_source.html#l00157">initStateFromAmps()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="QuEST_8h_source.html#l00334">Qureg::numAmpsTotal</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, and <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>.</p>
</div>
</div>
<a id="gacecf4e81c80f9c9c7df49b137923062d"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gacecf4e81c80f9c9c7df49b137923062d">◆ </a></span>TEST_CASE() <span class="overload">[80/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"initZeroState" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[state_initialisations] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__init.html#ga2f049055d4a51d0ea4d1a43b5234dedb" title="Initialise qureg into the zero state.">initZeroState</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__state__initialisations_8cpp_source.html#l00340">340</a> of file <a class="el" href="test__state__initialisations_8cpp_source.html">test_state_initialisations.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00340"></a><span class="lineno"> 340</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="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="l00343"></a><span class="lineno"> 343</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="l00344"></a><span class="lineno"> 344</span>  </div>
<div class="line"><a name="l00345"></a><span class="lineno"> 345</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00346"></a><span class="lineno"> 346</span>  </div>
<div class="line"><a name="l00347"></a><span class="lineno"> 347</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00348"></a><span class="lineno"> 348</span>  </div>
<div class="line"><a name="l00349"></a><span class="lineno"> 349</span>  <a class="code" href="group__init.html#gada7230491a50cd409f8b00f5ee1db953">initBlankState</a>(vec);</div>
<div class="line"><a name="l00350"></a><span class="lineno"> 350</span>  <a class="code" href="group__init.html#ga2f049055d4a51d0ea4d1a43b5234dedb">initZeroState</a>(vec);</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__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> refVec = <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a>(vec.<a class="code" href="structQureg.html#adef4935cac95763c29164cf99b144ed4">numAmpsTotal</a>);</div>
<div class="line"><a name="l00353"></a><span class="lineno"> 353</span>  refVec[0] = 1;</div>
<div class="line"><a name="l00354"></a><span class="lineno"> 354</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vec, refVec) );</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">"density-matrix"</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>  <a class="code" href="group__init.html#gada7230491a50cd409f8b00f5ee1db953">initBlankState</a>(mat);</div>
<div class="line"><a name="l00359"></a><span class="lineno"> 359</span>  <a class="code" href="group__init.html#ga2f049055d4a51d0ea4d1a43b5234dedb">initZeroState</a>(mat);</div>
<div class="line"><a name="l00360"></a><span class="lineno"> 360</span>  </div>
<div class="line"><a name="l00361"></a><span class="lineno"> 361</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> refMat = <a class="code" href="group__testutilities.html#ga6ccbb15b0f234e926be96a153181b63a">getZeroMatrix</a>(1<<mat.<a class="code" href="structQureg.html#ad08dff5316b8937f4b2a1417591543dc">numQubitsRepresented</a>);</div>
<div class="line"><a name="l00362"></a><span class="lineno"> 362</span>  refMat[0][0] = 1;</div>
<div class="line"><a name="l00363"></a><span class="lineno"> 363</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(mat, refMat) );</div>
<div class="line"><a name="l00364"></a><span class="lineno"> 364</span>  }</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">"input validation"</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="comment">// no input validation </span></div>
<div class="line"><a name="l00369"></a><span class="lineno"> 369</span>  SUCCEED( );</div>
<div class="line"><a name="l00370"></a><span class="lineno"> 370</span>  }</div>
<div class="line"><a name="l00371"></a><span class="lineno"> 371</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="l00372"></a><span class="lineno"> 372</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="l00373"></a><span class="lineno"> 373</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00153">getZeroMatrix()</a>, <a class="el" href="QuEST_8c_source.html#l00119">initBlankState()</a>, <a class="el" href="QuEST_8c_source.html#l00113">initZeroState()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="QuEST_8h_source.html#l00334">Qureg::numAmpsTotal</a>, <a class="el" href="QuEST_8h_source.html#l00327">Qureg::numQubitsRepresented</a>, and <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>.</p>
</div>
</div>
<a id="ga1562bc2faa4f587e665f8974cbcc62f4"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga1562bc2faa4f587e665f8974cbcc62f4">◆ </a></span>TEST_CASE() <span class="overload">[81/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"measure" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[gates] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__normgate.html#ga2a3794103125f1e3cfa103f8b1963656" title="Measures a single qubit, collapsing it randomly to 0 or 1.">measure</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__gates_8cpp_source.html#l00121">121</a> of file <a class="el" href="test__gates_8cpp_source.html">test_gates.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00121"></a><span class="lineno"> 121</span>  {</div>
<div class="line"><a name="l00122"></a><span class="lineno"> 122</span>  </div>
<div class="line"><a name="l00123"></a><span class="lineno"> 123</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="l00124"></a><span class="lineno"> 124</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="l00125"></a><span class="lineno"> 125</span>  </div>
<div class="line"><a name="l00126"></a><span class="lineno"> 126</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00127"></a><span class="lineno"> 127</span>  </div>
<div class="line"><a name="l00128"></a><span class="lineno"> 128</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="l00129"></a><span class="lineno"> 129</span>  </div>
<div class="line"><a name="l00130"></a><span class="lineno"> 130</span>  <span class="comment">// repeat these random tests 10 times on every qubit </span></div>
<div class="line"><a name="l00131"></a><span class="lineno"> 131</span>  GENERATE( range(0,10) );</div>
<div class="line"><a name="l00132"></a><span class="lineno"> 132</span>  </div>
<div class="line"><a name="l00133"></a><span class="lineno"> 133</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00134"></a><span class="lineno"> 134</span>  </div>
<div class="line"><a name="l00135"></a><span class="lineno"> 135</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="l00136"></a><span class="lineno"> 136</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(vec, vecRef);</div>
<div class="line"><a name="l00137"></a><span class="lineno"> 137</span>  </div>
<div class="line"><a name="l00138"></a><span class="lineno"> 138</span>  <span class="keywordtype">int</span> outcome = <a class="code" href="group__normgate.html#ga2a3794103125f1e3cfa103f8b1963656">measure</a>(vec, qubit);</div>
<div class="line"><a name="l00139"></a><span class="lineno"> 139</span>  REQUIRE( (outcome == 0 || outcome == 1) );</div>
<div class="line"><a name="l00140"></a><span class="lineno"> 140</span>  </div>
<div class="line"><a name="l00141"></a><span class="lineno"> 141</span>  <span class="comment">// calculate prob of this outcome</span></div>
<div class="line"><a name="l00142"></a><span class="lineno"> 142</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> prob = 0;</div>
<div class="line"><a name="l00143"></a><span class="lineno"> 143</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> ind=0; ind<vecRef.size(); ind++) {</div>
<div class="line"><a name="l00144"></a><span class="lineno"> 144</span>  <span class="keywordtype">int</span> bit = (ind >> qubit) & 1; <span class="comment">// target-th bit</span></div>
<div class="line"><a name="l00145"></a><span class="lineno"> 145</span>  <span class="keywordflow">if</span> (bit == outcome)</div>
<div class="line"><a name="l00146"></a><span class="lineno"> 146</span>  prob += pow(abs(vecRef[ind]), 2);</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>  </div>
<div class="line"><a name="l00149"></a><span class="lineno"> 149</span>  REQUIRE( prob > REAL_EPS );</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">// renormalise by the outcome prob</span></div>
<div class="line"><a name="l00152"></a><span class="lineno"> 152</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> ind=0; ind<vecRef.size(); ind++) {</div>
<div class="line"><a name="l00153"></a><span class="lineno"> 153</span>  <span class="keywordtype">int</span> bit = (ind >> qubit) & 1; <span class="comment">// target-th bit</span></div>
<div class="line"><a name="l00154"></a><span class="lineno"> 154</span>  <span class="keywordflow">if</span> (bit == outcome)</div>
<div class="line"><a name="l00155"></a><span class="lineno"> 155</span>  vecRef[ind] /= sqrt(prob);</div>
<div class="line"><a name="l00156"></a><span class="lineno"> 156</span>  <span class="keywordflow">else</span> </div>
<div class="line"><a name="l00157"></a><span class="lineno"> 157</span>  vecRef[ind] = 0;</div>
<div class="line"><a name="l00158"></a><span class="lineno"> 158</span>  }</div>
<div class="line"><a name="l00159"></a><span class="lineno"> 159</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vec, vecRef) );</div>
<div class="line"><a name="l00160"></a><span class="lineno"> 160</span>  }</div>
<div class="line"><a name="l00161"></a><span class="lineno"> 161</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00162"></a><span class="lineno"> 162</span>  </div>
<div class="line"><a name="l00163"></a><span class="lineno"> 163</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="l00164"></a><span class="lineno"> 164</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat, matRef);</div>
<div class="line"><a name="l00165"></a><span class="lineno"> 165</span>  </div>
<div class="line"><a name="l00166"></a><span class="lineno"> 166</span>  <span class="keywordtype">int</span> outcome = <a class="code" href="group__normgate.html#ga2a3794103125f1e3cfa103f8b1963656">measure</a>(mat, qubit);</div>
<div class="line"><a name="l00167"></a><span class="lineno"> 167</span>  REQUIRE( (outcome == 0 || outcome == 1) );</div>
<div class="line"><a name="l00168"></a><span class="lineno"> 168</span>  </div>
<div class="line"><a name="l00169"></a><span class="lineno"> 169</span>  <span class="comment">// compute prob of this outcome</span></div>
<div class="line"><a name="l00170"></a><span class="lineno"> 170</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> prob = 0;</div>
<div class="line"><a name="l00171"></a><span class="lineno"> 171</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> ind=0; ind<matRef.size(); ind++) {</div>
<div class="line"><a name="l00172"></a><span class="lineno"> 172</span>  <span class="keywordtype">int</span> bit = (ind >> qubit) & 1; <span class="comment">// qubit-th bit</span></div>
<div class="line"><a name="l00173"></a><span class="lineno"> 173</span>  <span class="keywordflow">if</span> (bit == outcome)</div>
<div class="line"><a name="l00174"></a><span class="lineno"> 174</span>  prob += real(matRef[ind][ind]);</div>
<div class="line"><a name="l00175"></a><span class="lineno"> 175</span>  }</div>
<div class="line"><a name="l00176"></a><span class="lineno"> 176</span>  </div>
<div class="line"><a name="l00177"></a><span class="lineno"> 177</span>  REQUIRE( prob > REAL_EPS );</div>
<div class="line"><a name="l00178"></a><span class="lineno"> 178</span>  </div>
<div class="line"><a name="l00179"></a><span class="lineno"> 179</span>  <span class="comment">// renorm (/prob) every |*outcome*><*outcome*| state, zeroing all others </span></div>
<div class="line"><a name="l00180"></a><span class="lineno"> 180</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> r=0; r<matRef.size(); r++) {</div>
<div class="line"><a name="l00181"></a><span class="lineno"> 181</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> c=0; c<matRef.size(); c++) {</div>
<div class="line"><a name="l00182"></a><span class="lineno"> 182</span>  <span class="keywordtype">int</span> ketBit = (c >> qubit) & 1;</div>
<div class="line"><a name="l00183"></a><span class="lineno"> 183</span>  <span class="keywordtype">int</span> braBit = (r >> qubit) & 1;</div>
<div class="line"><a name="l00184"></a><span class="lineno"> 184</span>  </div>
<div class="line"><a name="l00185"></a><span class="lineno"> 185</span>  <span class="keywordflow">if</span> (ketBit == outcome && braBit == outcome)</div>
<div class="line"><a name="l00186"></a><span class="lineno"> 186</span>  matRef[r][c] /= prob;</div>
<div class="line"><a name="l00187"></a><span class="lineno"> 187</span>  <span class="keywordflow">else</span></div>
<div class="line"><a name="l00188"></a><span class="lineno"> 188</span>  matRef[r][c] = 0;</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>  }</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>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(mat, matRef) );</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>  }</div>
<div class="line"><a name="l00195"></a><span class="lineno"> 195</span>  SECTION( <span class="stringliteral">"input validation"</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>  SECTION( <span class="stringliteral">"qubit index"</span> ) {</div>
<div class="line"><a name="l00198"></a><span class="lineno"> 198</span>  </div>
<div class="line"><a name="l00199"></a><span class="lineno"> 199</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="l00200"></a><span class="lineno"> 200</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__normgate.html#ga2a3794103125f1e3cfa103f8b1963656">measure</a>(vec, qubit), Contains(<span class="stringliteral">"Invalid target qubit"</span>) );</div>
<div class="line"><a name="l00201"></a><span class="lineno"> 201</span>  }</div>
<div class="line"><a name="l00202"></a><span class="lineno"> 202</span>  }</div>
<div class="line"><a name="l00203"></a><span class="lineno"> 203</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="l00204"></a><span class="lineno"> 204</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="l00205"></a><span class="lineno"> 205</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00490">getRandomDensityMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00468">getRandomStateVector()</a>, <a class="el" href="QuEST_8c_source.html#l00998">measure()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, and <a class="el" href="utilities_8cpp_source.html#l01201">toQureg()</a>.</p>
</div>
</div>
<a id="ga61e1bd261993b019232f5d5214423280"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga61e1bd261993b019232f5d5214423280">◆ </a></span>TEST_CASE() <span class="overload">[82/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"measureWithStats" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[gates] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__normgate.html#gae192ac0759e46c7b20a7182020155240" title="Measures a single qubit, collapsing it randomly to 0 or 1, and additionally gives the probability of ...">measureWithStats</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__gates_8cpp_source.html#l00213">213</a> of file <a class="el" href="test__gates_8cpp_source.html">test_gates.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00213"></a><span class="lineno"> 213</span>  {</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>  <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="l00216"></a><span class="lineno"> 216</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="l00217"></a><span class="lineno"> 217</span>  </div>
<div class="line"><a name="l00218"></a><span class="lineno"> 218</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00219"></a><span class="lineno"> 219</span>  </div>
<div class="line"><a name="l00220"></a><span class="lineno"> 220</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="l00221"></a><span class="lineno"> 221</span>  </div>
<div class="line"><a name="l00222"></a><span class="lineno"> 222</span>  <span class="comment">// repeat these random tests 10 times on every qubit </span></div>
<div class="line"><a name="l00223"></a><span class="lineno"> 223</span>  GENERATE( range(0,10) );</div>
<div class="line"><a name="l00224"></a><span class="lineno"> 224</span>  </div>
<div class="line"><a name="l00225"></a><span class="lineno"> 225</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00226"></a><span class="lineno"> 226</span>  </div>
<div class="line"><a name="l00227"></a><span class="lineno"> 227</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="l00228"></a><span class="lineno"> 228</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(vec, vecRef);</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__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> res;</div>
<div class="line"><a name="l00231"></a><span class="lineno"> 231</span>  <span class="keywordtype">int</span> outcome = <a class="code" href="group__normgate.html#gae192ac0759e46c7b20a7182020155240">measureWithStats</a>(vec, qubit, &res);</div>
<div class="line"><a name="l00232"></a><span class="lineno"> 232</span>  REQUIRE( (outcome == 0 || outcome == 1) );</div>
<div class="line"><a name="l00233"></a><span class="lineno"> 233</span>  </div>
<div class="line"><a name="l00234"></a><span class="lineno"> 234</span>  <span class="comment">// calculate prob of this outcome</span></div>
<div class="line"><a name="l00235"></a><span class="lineno"> 235</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> prob = 0;</div>
<div class="line"><a name="l00236"></a><span class="lineno"> 236</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> ind=0; ind<vecRef.size(); ind++) {</div>
<div class="line"><a name="l00237"></a><span class="lineno"> 237</span>  <span class="keywordtype">int</span> bit = (ind >> qubit) & 1; <span class="comment">// target-th bit</span></div>
<div class="line"><a name="l00238"></a><span class="lineno"> 238</span>  <span class="keywordflow">if</span> (bit == outcome)</div>
<div class="line"><a name="l00239"></a><span class="lineno"> 239</span>  prob += pow(abs(vecRef[ind]), 2);</div>
<div class="line"><a name="l00240"></a><span class="lineno"> 240</span>  }</div>
<div class="line"><a name="l00241"></a><span class="lineno"> 241</span>  </div>
<div class="line"><a name="l00242"></a><span class="lineno"> 242</span>  REQUIRE( prob == Approx(res) );</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>  <span class="comment">// renormalise by the outcome prob</span></div>
<div class="line"><a name="l00245"></a><span class="lineno"> 245</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> ind=0; ind<vecRef.size(); ind++) {</div>
<div class="line"><a name="l00246"></a><span class="lineno"> 246</span>  <span class="keywordtype">int</span> bit = (ind >> qubit) & 1; <span class="comment">// target-th bit</span></div>
<div class="line"><a name="l00247"></a><span class="lineno"> 247</span>  <span class="keywordflow">if</span> (bit == outcome)</div>
<div class="line"><a name="l00248"></a><span class="lineno"> 248</span>  vecRef[ind] /= sqrt(prob);</div>
<div class="line"><a name="l00249"></a><span class="lineno"> 249</span>  <span class="keywordflow">else</span> </div>
<div class="line"><a name="l00250"></a><span class="lineno"> 250</span>  vecRef[ind] = 0;</div>
<div class="line"><a name="l00251"></a><span class="lineno"> 251</span>  }</div>
<div class="line"><a name="l00252"></a><span class="lineno"> 252</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vec, vecRef) );</div>
<div class="line"><a name="l00253"></a><span class="lineno"> 253</span>  }</div>
<div class="line"><a name="l00254"></a><span class="lineno"> 254</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00255"></a><span class="lineno"> 255</span>  </div>
<div class="line"><a name="l00256"></a><span class="lineno"> 256</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="l00257"></a><span class="lineno"> 257</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat, matRef);</div>
<div class="line"><a name="l00258"></a><span class="lineno"> 258</span>  </div>
<div class="line"><a name="l00259"></a><span class="lineno"> 259</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> res;</div>
<div class="line"><a name="l00260"></a><span class="lineno"> 260</span>  <span class="keywordtype">int</span> outcome = <a class="code" href="group__normgate.html#gae192ac0759e46c7b20a7182020155240">measureWithStats</a>(mat, qubit, &res);</div>
<div class="line"><a name="l00261"></a><span class="lineno"> 261</span>  REQUIRE( (outcome == 0 || outcome == 1) );</div>
<div class="line"><a name="l00262"></a><span class="lineno"> 262</span>  </div>
<div class="line"><a name="l00263"></a><span class="lineno"> 263</span>  <span class="comment">// compute prob of this outcome</span></div>
<div class="line"><a name="l00264"></a><span class="lineno"> 264</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> prob = 0;</div>
<div class="line"><a name="l00265"></a><span class="lineno"> 265</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> ind=0; ind<matRef.size(); ind++) {</div>
<div class="line"><a name="l00266"></a><span class="lineno"> 266</span>  <span class="keywordtype">int</span> bit = (ind >> qubit) & 1; <span class="comment">// qubit-th bit</span></div>
<div class="line"><a name="l00267"></a><span class="lineno"> 267</span>  <span class="keywordflow">if</span> (bit == outcome)</div>
<div class="line"><a name="l00268"></a><span class="lineno"> 268</span>  prob += real(matRef[ind][ind]);</div>
<div class="line"><a name="l00269"></a><span class="lineno"> 269</span>  }</div>
<div class="line"><a name="l00270"></a><span class="lineno"> 270</span>  </div>
<div class="line"><a name="l00271"></a><span class="lineno"> 271</span>  REQUIRE( prob == Approx(res) );</div>
<div class="line"><a name="l00272"></a><span class="lineno"> 272</span>  </div>
<div class="line"><a name="l00273"></a><span class="lineno"> 273</span>  <span class="comment">// renorm (/prob) every |*outcome*><*outcome*| state, zeroing all others </span></div>
<div class="line"><a name="l00274"></a><span class="lineno"> 274</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> r=0; r<matRef.size(); r++) {</div>
<div class="line"><a name="l00275"></a><span class="lineno"> 275</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> c=0; c<matRef.size(); c++) {</div>
<div class="line"><a name="l00276"></a><span class="lineno"> 276</span>  <span class="keywordtype">int</span> ketBit = (c >> qubit) & 1;</div>
<div class="line"><a name="l00277"></a><span class="lineno"> 277</span>  <span class="keywordtype">int</span> braBit = (r >> qubit) & 1;</div>
<div class="line"><a name="l00278"></a><span class="lineno"> 278</span>  </div>
<div class="line"><a name="l00279"></a><span class="lineno"> 279</span>  <span class="keywordflow">if</span> (ketBit == outcome && braBit == outcome)</div>
<div class="line"><a name="l00280"></a><span class="lineno"> 280</span>  matRef[r][c] /= prob;</div>
<div class="line"><a name="l00281"></a><span class="lineno"> 281</span>  <span class="keywordflow">else</span></div>
<div class="line"><a name="l00282"></a><span class="lineno"> 282</span>  matRef[r][c] = 0;</div>
<div class="line"><a name="l00283"></a><span class="lineno"> 283</span>  }</div>
<div class="line"><a name="l00284"></a><span class="lineno"> 284</span>  }</div>
<div class="line"><a name="l00285"></a><span class="lineno"> 285</span>  </div>
<div class="line"><a name="l00286"></a><span class="lineno"> 286</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(mat, matRef) );</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>  }</div>
<div class="line"><a name="l00289"></a><span class="lineno"> 289</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00290"></a><span class="lineno"> 290</span>  </div>
<div class="line"><a name="l00291"></a><span class="lineno"> 291</span>  SECTION( <span class="stringliteral">"qubit index"</span> ) {</div>
<div class="line"><a name="l00292"></a><span class="lineno"> 292</span>  </div>
<div class="line"><a name="l00293"></a><span class="lineno"> 293</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="l00294"></a><span class="lineno"> 294</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> res;</div>
<div class="line"><a name="l00295"></a><span class="lineno"> 295</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__normgate.html#gae192ac0759e46c7b20a7182020155240">measureWithStats</a>(vec, qubit, &res), Contains(<span class="stringliteral">"Invalid target qubit"</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>  }</div>
<div class="line"><a name="l00298"></a><span class="lineno"> 298</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="l00299"></a><span class="lineno"> 299</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="l00300"></a><span class="lineno"> 300</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00490">getRandomDensityMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00468">getRandomStateVector()</a>, <a class="el" href="QuEST_8c_source.html#l00985">measureWithStats()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, and <a class="el" href="utilities_8cpp_source.html#l01201">toQureg()</a>.</p>
</div>
</div>
<a id="ga6b6a9b1ee734f0ab27cbfbb575bc7b77"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga6b6a9b1ee734f0ab27cbfbb575bc7b77">◆ </a></span>TEST_CASE() <span class="overload">[83/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"mixDamping" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[decoherence] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__decoherence.html#gaea8509011985522bae857bd3b13c34ed" title="Mixes a density matrix qureg to induce single-qubit amplitude damping (decay to 0 state).">mixDamping</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__decoherence_8cpp_source.html#l00023">23</a> of file <a class="el" href="test__decoherence_8cpp_source.html">test_decoherence.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00023"></a><span class="lineno"> 23</span>  {</div>
<div class="line"><a name="l00024"></a><span class="lineno"> 24</span>  </div>
<div class="line"><a name="l00025"></a><span class="lineno"> 25</span>  <a class="code" href="test__decoherence_8cpp.html#ae828ab685c6e8b0cec317b7a6c46963a">PREPARE_TEST</a>(qureg, ref);</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>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00028"></a><span class="lineno"> 28</span>  </div>
<div class="line"><a name="l00029"></a><span class="lineno"> 29</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="l00030"></a><span class="lineno"> 30</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> prob = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(0, 1);</div>
<div class="line"><a name="l00031"></a><span class="lineno"> 31</span>  <a class="code" href="group__decoherence.html#gaea8509011985522bae857bd3b13c34ed">mixDamping</a>(qureg, target, prob);</div>
<div class="line"><a name="l00032"></a><span class="lineno"> 32</span>  </div>
<div class="line"><a name="l00033"></a><span class="lineno"> 33</span>  <span class="comment">// ref -> kraus0 ref kraus0^dagger + kraus1 ref kraus1^dagger</span></div>
<div class="line"><a name="l00034"></a><span class="lineno"> 34</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> kraus0{{1,0},{0,sqrt(1-prob)}};</div>
<div class="line"><a name="l00035"></a><span class="lineno"> 35</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> rho0 = ref;</div>
<div class="line"><a name="l00036"></a><span class="lineno"> 36</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(rho0, target, kraus0);</div>
<div class="line"><a name="l00037"></a><span class="lineno"> 37</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> kraus1{{0,sqrt(prob)},{0,0}};</div>
<div class="line"><a name="l00038"></a><span class="lineno"> 38</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> rho1 = ref;</div>
<div class="line"><a name="l00039"></a><span class="lineno"> 39</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(rho1, target, kraus1);</div>
<div class="line"><a name="l00040"></a><span class="lineno"> 40</span>  ref = rho0 + rho1;</div>
<div class="line"><a name="l00041"></a><span class="lineno"> 41</span>  </div>
<div class="line"><a name="l00042"></a><span class="lineno"> 42</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(qureg, ref) );</div>
<div class="line"><a name="l00043"></a><span class="lineno"> 43</span>  }</div>
<div class="line"><a name="l00044"></a><span class="lineno"> 44</span>  SECTION( <span class="stringliteral">"validation "</span>) {</div>
<div class="line"><a name="l00045"></a><span class="lineno"> 45</span>  </div>
<div class="line"><a name="l00046"></a><span class="lineno"> 46</span>  SECTION( <span class="stringliteral">"qubit index"</span> ) {</div>
<div class="line"><a name="l00047"></a><span class="lineno"> 47</span>  </div>
<div class="line"><a name="l00048"></a><span class="lineno"> 48</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="l00049"></a><span class="lineno"> 49</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#gaea8509011985522bae857bd3b13c34ed">mixDamping</a>(qureg, target, 0), Contains(<span class="stringliteral">"Invalid target"</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>  }</div>
<div class="line"><a name="l00052"></a><span class="lineno"> 52</span>  SECTION( <span class="stringliteral">"probability"</span> ) {</div>
<div class="line"><a name="l00053"></a><span class="lineno"> 53</span>  </div>
<div class="line"><a name="l00054"></a><span class="lineno"> 54</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#gaea8509011985522bae857bd3b13c34ed">mixDamping</a>(qureg, 0, -.1), Contains(<span class="stringliteral">"Probabilities"</span>) );</div>
<div class="line"><a name="l00055"></a><span class="lineno"> 55</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#gaea8509011985522bae857bd3b13c34ed">mixDamping</a>(qureg, 0, 1.1), Contains(<span class="stringliteral">"Probabilities"</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>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00058"></a><span class="lineno"> 58</span>  </div>
<div class="line"><a name="l00059"></a><span class="lineno"> 59</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="l00060"></a><span class="lineno"> 60</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#gaea8509011985522bae857bd3b13c34ed">mixDamping</a>(vec, 0, 0), Contains(<span class="stringliteral">"density matrices"</span>) );</div>
<div class="line"><a name="l00061"></a><span class="lineno"> 61</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="l00062"></a><span class="lineno"> 62</span>  }</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>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(qureg, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00065"></a><span class="lineno"> 65</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00421">getRandomReal()</a>, <a class="el" href="QuEST_8c_source.html#l01283">mixDamping()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__decoherence_8cpp_source.html#l00009">PREPARE_TEST</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, and <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>.</p>
</div>
</div>
<a id="ga3c9d9dcf1fb89d6a95ec46fbdc2a6efa"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga3c9d9dcf1fb89d6a95ec46fbdc2a6efa">◆ </a></span>TEST_CASE() <span class="overload">[84/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"mixDensityMatrix" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[decoherence] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__decoherence.html#ga97d563fa8f4bc51f720bbb653f5480b3" title="Modifies combineQureg to become (1-prob)combineProb + prob otherQureg.">mixDensityMatrix</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__decoherence_8cpp_source.html#l00073">73</a> of file <a class="el" href="test__decoherence_8cpp_source.html">test_decoherence.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00073"></a><span class="lineno"> 73</span>  {</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>  <a class="code" href="structQureg.html">Qureg</a> qureg1 = <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="l00076"></a><span class="lineno"> 76</span>  <a class="code" href="structQureg.html">Qureg</a> qureg2 = <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="l00077"></a><span class="lineno"> 77</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(qureg1);</div>
<div class="line"><a name="l00078"></a><span class="lineno"> 78</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(qureg2);</div>
<div class="line"><a name="l00079"></a><span class="lineno"> 79</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> ref1 = <a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(qureg1);</div>
<div class="line"><a name="l00080"></a><span class="lineno"> 80</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> ref2 = <a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(qureg2);</div>
<div class="line"><a name="l00081"></a><span class="lineno"> 81</span>  </div>
<div class="line"><a name="l00082"></a><span class="lineno"> 82</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00083"></a><span class="lineno"> 83</span>  </div>
<div class="line"><a name="l00084"></a><span class="lineno"> 84</span>  <span class="comment">// test p in {0, 1} and 10 random values in (0,1)</span></div>
<div class="line"><a name="l00085"></a><span class="lineno"> 85</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> prob = GENERATE( 0., 1., take(10, random(0.,1.)) );</div>
<div class="line"><a name="l00086"></a><span class="lineno"> 86</span>  <a class="code" href="group__decoherence.html#ga97d563fa8f4bc51f720bbb653f5480b3">mixDensityMatrix</a>(qureg1, prob, qureg2);</div>
<div class="line"><a name="l00087"></a><span class="lineno"> 87</span>  </div>
<div class="line"><a name="l00088"></a><span class="lineno"> 88</span>  <span class="comment">// ensure target qureg modified correctly</span></div>
<div class="line"><a name="l00089"></a><span class="lineno"> 89</span>  ref1 = (1-prob)*ref1 + (prob)*ref2;</div>
<div class="line"><a name="l00090"></a><span class="lineno"> 90</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(qureg1, ref1) );</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>  <span class="comment">// enure other qureg was not modified</span></div>
<div class="line"><a name="l00093"></a><span class="lineno"> 93</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(qureg2, ref2) );</div>
<div class="line"><a name="l00094"></a><span class="lineno"> 94</span>  }</div>
<div class="line"><a name="l00095"></a><span class="lineno"> 95</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00096"></a><span class="lineno"> 96</span>  </div>
<div class="line"><a name="l00097"></a><span class="lineno"> 97</span>  SECTION( <span class="stringliteral">"probabilities"</span>) {</div>
<div class="line"><a name="l00098"></a><span class="lineno"> 98</span>  </div>
<div class="line"><a name="l00099"></a><span class="lineno"> 99</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> prob = GENERATE( -0.1, 1.1 );</div>
<div class="line"><a name="l00100"></a><span class="lineno"> 100</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#ga97d563fa8f4bc51f720bbb653f5480b3">mixDensityMatrix</a>(qureg1, prob, qureg2), Contains(<span class="stringliteral">"Probabilities"</span>) );</div>
<div class="line"><a name="l00101"></a><span class="lineno"> 101</span>  }</div>
<div class="line"><a name="l00102"></a><span class="lineno"> 102</span>  SECTION( <span class="stringliteral">"density matrices"</span> ) {</div>
<div class="line"><a name="l00103"></a><span class="lineno"> 103</span>  </div>
<div class="line"><a name="l00104"></a><span class="lineno"> 104</span>  <span class="comment">// one is statevec </span></div>
<div class="line"><a name="l00105"></a><span class="lineno"> 105</span>  <a class="code" href="structQureg.html">Qureg</a> state1 = <a class="code" href="group__type.html#ga3392816c0643414165c2f5caeec17df0">createQureg</a>(qureg1.<a class="code" href="structQureg.html#ad08dff5316b8937f4b2a1417591543dc">numQubitsRepresented</a>, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00106"></a><span class="lineno"> 106</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#ga97d563fa8f4bc51f720bbb653f5480b3">mixDensityMatrix</a>(qureg1, 0, state1), Contains(<span class="stringliteral">"density matrices"</span>) );</div>
<div class="line"><a name="l00107"></a><span class="lineno"> 107</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#ga97d563fa8f4bc51f720bbb653f5480b3">mixDensityMatrix</a>(state1, 0, qureg1), Contains(<span class="stringliteral">"density matrices"</span>) );</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>  <span class="comment">// both are statevec</span></div>
<div class="line"><a name="l00110"></a><span class="lineno"> 110</span>  <a class="code" href="structQureg.html">Qureg</a> state2 = <a class="code" href="group__type.html#ga3392816c0643414165c2f5caeec17df0">createQureg</a>(qureg1.<a class="code" href="structQureg.html#ad08dff5316b8937f4b2a1417591543dc">numQubitsRepresented</a>, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00111"></a><span class="lineno"> 111</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#ga97d563fa8f4bc51f720bbb653f5480b3">mixDensityMatrix</a>(state1, 0, state2), Contains(<span class="stringliteral">"density matrices"</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>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(state1, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00114"></a><span class="lineno"> 114</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(state2, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00115"></a><span class="lineno"> 115</span>  }</div>
<div class="line"><a name="l00116"></a><span class="lineno"> 116</span>  SECTION( <span class="stringliteral">"matching dimensions"</span> ) {</div>
<div class="line"><a name="l00117"></a><span class="lineno"> 117</span>  </div>
<div class="line"><a name="l00118"></a><span class="lineno"> 118</span>  <a class="code" href="structQureg.html">Qureg</a> qureg3 = <a class="code" href="group__type.html#ga93e55b6650b408abb30a1d4a8bce757c">createDensityQureg</a>(1 + qureg1.<a class="code" href="structQureg.html#ad08dff5316b8937f4b2a1417591543dc">numQubitsRepresented</a>, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00119"></a><span class="lineno"> 119</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#ga97d563fa8f4bc51f720bbb653f5480b3">mixDensityMatrix</a>(qureg1, 0, qureg3), Contains(<span class="stringliteral">"Dimensions"</span>) );</div>
<div class="line"><a name="l00120"></a><span class="lineno"> 120</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#ga97d563fa8f4bc51f720bbb653f5480b3">mixDensityMatrix</a>(qureg3, 0, qureg1), Contains(<span class="stringliteral">"Dimensions"</span>) );</div>
<div class="line"><a name="l00121"></a><span class="lineno"> 121</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(qureg3, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00122"></a><span class="lineno"> 122</span>  }</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__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(qureg1, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00125"></a><span class="lineno"> 125</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(qureg2, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00126"></a><span class="lineno"> 126</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="QuEST_8c_source.html#l01578">initDebugState()</a>, <a class="el" href="QuEST_8c_source.html#l01012">mixDensityMatrix()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="QuEST_8h_source.html#l00327">Qureg::numQubitsRepresented</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, and <a class="el" href="utilities_8cpp_source.html#l01044">toQMatrix()</a>.</p>
</div>
</div>
<a id="ga9c424dd4c51660f7a609a2937cc71fbb"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga9c424dd4c51660f7a609a2937cc71fbb">◆ </a></span>TEST_CASE() <span class="overload">[85/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"mixDephasing" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[decoherence] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__decoherence.html#gacc2667ac87482a7afdcb711b74bf732e" title="Mixes a density matrix qureg to induce single-qubit dephasing noise.">mixDephasing</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__decoherence_8cpp_source.html#l00134">134</a> of file <a class="el" href="test__decoherence_8cpp_source.html">test_decoherence.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00134"></a><span class="lineno"> 134</span>  {</div>
<div class="line"><a name="l00135"></a><span class="lineno"> 135</span>  </div>
<div class="line"><a name="l00136"></a><span class="lineno"> 136</span>  <a class="code" href="test__decoherence_8cpp.html#ae828ab685c6e8b0cec317b7a6c46963a">PREPARE_TEST</a>(qureg, ref);</div>
<div class="line"><a name="l00137"></a><span class="lineno"> 137</span>  </div>
<div class="line"><a name="l00138"></a><span class="lineno"> 138</span>  SECTION( <span class="stringliteral">"correctness "</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> target = GENERATE( range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) );</div>
<div class="line"><a name="l00141"></a><span class="lineno"> 141</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> prob = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(0, 1/2.);</div>
<div class="line"><a name="l00142"></a><span class="lineno"> 142</span>  <a class="code" href="group__decoherence.html#gacc2667ac87482a7afdcb711b74bf732e">mixDephasing</a>(qureg, target, prob);</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">// ref -> (1 - prob) ref + prob Z ref Z</span></div>
<div class="line"><a name="l00145"></a><span class="lineno"> 145</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> phaseRef = ref;</div>
<div class="line"><a name="l00146"></a><span class="lineno"> 146</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(phaseRef, target, <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a>{{1,0},{0,-1}}); <span class="comment">// Z ref Z</span></div>
<div class="line"><a name="l00147"></a><span class="lineno"> 147</span>  ref = ((1 - prob) * ref) + (prob * phaseRef);</div>
<div class="line"><a name="l00148"></a><span class="lineno"> 148</span>  </div>
<div class="line"><a name="l00149"></a><span class="lineno"> 149</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(qureg, ref) );</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>  SECTION( <span class="stringliteral">"validation "</span>) {</div>
<div class="line"><a name="l00152"></a><span class="lineno"> 152</span>  </div>
<div class="line"><a name="l00153"></a><span class="lineno"> 153</span>  SECTION( <span class="stringliteral">"qubit index"</span> ) {</div>
<div class="line"><a name="l00154"></a><span class="lineno"> 154</span>  </div>
<div class="line"><a name="l00155"></a><span class="lineno"> 155</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="l00156"></a><span class="lineno"> 156</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#gacc2667ac87482a7afdcb711b74bf732e">mixDephasing</a>(qureg, target, 0), Contains(<span class="stringliteral">"Invalid target"</span>) );</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>  }</div>
<div class="line"><a name="l00159"></a><span class="lineno"> 159</span>  SECTION( <span class="stringliteral">"probability"</span> ) {</div>
<div class="line"><a name="l00160"></a><span class="lineno"> 160</span>  </div>
<div class="line"><a name="l00161"></a><span class="lineno"> 161</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#gacc2667ac87482a7afdcb711b74bf732e">mixDephasing</a>(qureg, 0, -.1), Contains(<span class="stringliteral">"Probabilities"</span>) );</div>
<div class="line"><a name="l00162"></a><span class="lineno"> 162</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#gacc2667ac87482a7afdcb711b74bf732e">mixDephasing</a>(qureg, 0, .6), Contains(<span class="stringliteral">"probability"</span>) && Contains(<span class="stringliteral">"cannot exceed 1/2"</span>) );</div>
<div class="line"><a name="l00163"></a><span class="lineno"> 163</span>  }</div>
<div class="line"><a name="l00164"></a><span class="lineno"> 164</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00165"></a><span class="lineno"> 165</span>  </div>
<div class="line"><a name="l00166"></a><span class="lineno"> 166</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="l00167"></a><span class="lineno"> 167</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#gacc2667ac87482a7afdcb711b74bf732e">mixDephasing</a>(vec, 0, 0), Contains(<span class="stringliteral">"density matrices"</span>) );</div>
<div class="line"><a name="l00168"></a><span class="lineno"> 168</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="l00169"></a><span class="lineno"> 169</span>  }</div>
<div class="line"><a name="l00170"></a><span class="lineno"> 170</span>  }</div>
<div class="line"><a name="l00171"></a><span class="lineno"> 171</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(qureg, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00172"></a><span class="lineno"> 172</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00421">getRandomReal()</a>, <a class="el" href="QuEST_8c_source.html#l01250">mixDephasing()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__decoherence_8cpp_source.html#l00009">PREPARE_TEST</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, and <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>.</p>
</div>
</div>
<a id="gae4e453a9c519926b39e3c45a6b1402d2"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gae4e453a9c519926b39e3c45a6b1402d2">◆ </a></span>TEST_CASE() <span class="overload">[86/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"mixDepolarising" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[decoherence] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__decoherence.html#gae2ea9255b8b11a4a382231e5604dc4e3" title="Mixes a density matrix qureg to induce single-qubit homogeneous depolarising noise.">mixDepolarising</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__decoherence_8cpp_source.html#l00180">180</a> of file <a class="el" href="test__decoherence_8cpp_source.html">test_decoherence.cpp</a>.</p>
<div class="fragment"><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>  </div>
<div class="line"><a name="l00182"></a><span class="lineno"> 182</span>  <a class="code" href="test__decoherence_8cpp.html#ae828ab685c6e8b0cec317b7a6c46963a">PREPARE_TEST</a>(qureg, ref);</div>
<div class="line"><a name="l00183"></a><span class="lineno"> 183</span>  </div>
<div class="line"><a name="l00184"></a><span class="lineno"> 184</span>  SECTION( <span class="stringliteral">"correctness "</span> ) {</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>  <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="l00187"></a><span class="lineno"> 187</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> prob = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(0, 3/4.);</div>
<div class="line"><a name="l00188"></a><span class="lineno"> 188</span>  <a class="code" href="group__decoherence.html#gae2ea9255b8b11a4a382231e5604dc4e3">mixDepolarising</a>(qureg, target, prob);</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>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> xRef = ref;</div>
<div class="line"><a name="l00191"></a><span class="lineno"> 191</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(xRef, target, <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a>{{0,1},{1,0}}); <span class="comment">// X ref X</span></div>
<div class="line"><a name="l00192"></a><span class="lineno"> 192</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> yRef = ref;</div>
<div class="line"><a name="l00193"></a><span class="lineno"> 193</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(yRef, target, <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a>{{0,-<a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>(0,1)},{<a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>(0,1),0}}); <span class="comment">// Y ref Y</span></div>
<div class="line"><a name="l00194"></a><span class="lineno"> 194</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> zRef = ref;</div>
<div class="line"><a name="l00195"></a><span class="lineno"> 195</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(zRef, target, <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a>{{1,0},{0,-1}}); <span class="comment">// Z ref Z</span></div>
<div class="line"><a name="l00196"></a><span class="lineno"> 196</span>  ref = ((1 - prob) * ref) + ((prob/3.) * ( xRef + yRef + zRef));</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>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(qureg, ref) );</div>
<div class="line"><a name="l00199"></a><span class="lineno"> 199</span>  }</div>
<div class="line"><a name="l00200"></a><span class="lineno"> 200</span>  SECTION( <span class="stringliteral">"validation "</span>) {</div>
<div class="line"><a name="l00201"></a><span class="lineno"> 201</span>  </div>
<div class="line"><a name="l00202"></a><span class="lineno"> 202</span>  SECTION( <span class="stringliteral">"qubit index"</span> ) {</div>
<div class="line"><a name="l00203"></a><span class="lineno"> 203</span>  </div>
<div class="line"><a name="l00204"></a><span class="lineno"> 204</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="l00205"></a><span class="lineno"> 205</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#gae2ea9255b8b11a4a382231e5604dc4e3">mixDepolarising</a>(qureg, target, 0), Contains(<span class="stringliteral">"Invalid target"</span>) );</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>  }</div>
<div class="line"><a name="l00208"></a><span class="lineno"> 208</span>  SECTION( <span class="stringliteral">"probability"</span> ) {</div>
<div class="line"><a name="l00209"></a><span class="lineno"> 209</span>  </div>
<div class="line"><a name="l00210"></a><span class="lineno"> 210</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#gae2ea9255b8b11a4a382231e5604dc4e3">mixDepolarising</a>(qureg, 0, -.1), Contains(<span class="stringliteral">"Probabilities"</span>) );</div>
<div class="line"><a name="l00211"></a><span class="lineno"> 211</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#gae2ea9255b8b11a4a382231e5604dc4e3">mixDepolarising</a>(qureg, 0, .76), Contains(<span class="stringliteral">"probability"</span>) && Contains(<span class="stringliteral">"cannot exceed 3/4"</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>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</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>  <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="l00216"></a><span class="lineno"> 216</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#gae2ea9255b8b11a4a382231e5604dc4e3">mixDepolarising</a>(vec, 0, 0), Contains(<span class="stringliteral">"density matrices"</span>) );</div>
<div class="line"><a name="l00217"></a><span class="lineno"> 217</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="l00218"></a><span class="lineno"> 218</span>  }</div>
<div class="line"><a name="l00219"></a><span class="lineno"> 219</span>  }</div>
<div class="line"><a name="l00220"></a><span class="lineno"> 220</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(qureg, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00221"></a><span class="lineno"> 221</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00421">getRandomReal()</a>, <a class="el" href="QuEST_8c_source.html#l01272">mixDepolarising()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__decoherence_8cpp_source.html#l00009">PREPARE_TEST</a>, <a class="el" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, and <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>.</p>
</div>
</div>
<a id="gaaca97157c5296fa1312c8daa3ac89864"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaaca97157c5296fa1312c8daa3ac89864">◆ </a></span>TEST_CASE() <span class="overload">[87/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"mixKrausMap" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[decoherence] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__decoherence.html#gacb7faa9d8afb0f4270c866424fffbccd" title="Apply a general single-qubit Kraus map to a density matrix, as specified by at most four Kraus operat...">mixKrausMap</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__decoherence_8cpp_source.html#l00520">520</a> of file <a class="el" href="test__decoherence_8cpp_source.html">test_decoherence.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00520"></a><span class="lineno"> 520</span>  {</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>  <a class="code" href="test__decoherence_8cpp.html#ae828ab685c6e8b0cec317b7a6c46963a">PREPARE_TEST</a>(qureg, ref);</div>
<div class="line"><a name="l00523"></a><span class="lineno"> 523</span>  </div>
<div class="line"><a name="l00524"></a><span class="lineno"> 524</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00525"></a><span class="lineno"> 525</span>  </div>
<div class="line"><a name="l00526"></a><span class="lineno"> 526</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="l00527"></a><span class="lineno"> 527</span>  <span class="keywordtype">int</span> numOps = GENERATE( range(1,5) ); <span class="comment">// max 4 inclusive</span></div>
<div class="line"><a name="l00528"></a><span class="lineno"> 528</span>  std::vector<QMatrix> matrs = <a class="code" href="group__testutilities.html#ga0d3b30625e2350a1e837a0b259dd3b18">getRandomKrausMap</a>(1, numOps);</div>
<div class="line"><a name="l00529"></a><span class="lineno"> 529</span>  </div>
<div class="line"><a name="l00530"></a><span class="lineno"> 530</span>  <a class="code" href="structComplexMatrix2.html">ComplexMatrix2</a> ops[numOps];</div>
<div class="line"><a name="l00531"></a><span class="lineno"> 531</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numOps; i++)</div>
<div class="line"><a name="l00532"></a><span class="lineno"> 532</span>  ops[i] = <a class="code" href="group__testutilities.html#ga731a7a71755c25ebe96e742e3fbe5812">toComplexMatrix2</a>(matrs[i]);</div>
<div class="line"><a name="l00533"></a><span class="lineno"> 533</span>  <a class="code" href="group__decoherence.html#gacb7faa9d8afb0f4270c866424fffbccd">mixKrausMap</a>(qureg, target, ops, numOps);</div>
<div class="line"><a name="l00534"></a><span class="lineno"> 534</span>  </div>
<div class="line"><a name="l00535"></a><span class="lineno"> 535</span>  <span class="comment">// set ref -> K_i ref K_i^dagger</span></div>
<div class="line"><a name="l00536"></a><span class="lineno"> 536</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> matrRefs[numOps];</div>
<div class="line"><a name="l00537"></a><span class="lineno"> 537</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numOps; i++) {</div>
<div class="line"><a name="l00538"></a><span class="lineno"> 538</span>  matrRefs[i] = ref;</div>
<div class="line"><a name="l00539"></a><span class="lineno"> 539</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(matrRefs[i], target, matrs[i]);</div>
<div class="line"><a name="l00540"></a><span class="lineno"> 540</span>  }</div>
<div class="line"><a name="l00541"></a><span class="lineno"> 541</span>  ref = <a class="code" href="group__testutilities.html#ga6ccbb15b0f234e926be96a153181b63a">getZeroMatrix</a>(ref.size());</div>
<div class="line"><a name="l00542"></a><span class="lineno"> 542</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numOps; i++)</div>
<div class="line"><a name="l00543"></a><span class="lineno"> 543</span>  ref += matrRefs[i];</div>
<div class="line"><a name="l00544"></a><span class="lineno"> 544</span>  </div>
<div class="line"><a name="l00545"></a><span class="lineno"> 545</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(qureg, ref, 10*REAL_EPS) );</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>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00548"></a><span class="lineno"> 548</span>  </div>
<div class="line"><a name="l00549"></a><span class="lineno"> 549</span>  SECTION( <span class="stringliteral">"number of operators"</span> ) {</div>
<div class="line"><a name="l00550"></a><span class="lineno"> 550</span>  </div>
<div class="line"><a name="l00551"></a><span class="lineno"> 551</span>  <span class="keywordtype">int</span> numOps = GENERATE( 0, 5 );</div>
<div class="line"><a name="l00552"></a><span class="lineno"> 552</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#gacb7faa9d8afb0f4270c866424fffbccd">mixKrausMap</a>(qureg, 0, NULL, numOps), Contains(<span class="stringliteral">"operators"</span>) );</div>
<div class="line"><a name="l00553"></a><span class="lineno"> 553</span>  }</div>
<div class="line"><a name="l00554"></a><span class="lineno"> 554</span>  SECTION( <span class="stringliteral">"trace preserving"</span> ) {</div>
<div class="line"><a name="l00555"></a><span class="lineno"> 555</span>  </div>
<div class="line"><a name="l00556"></a><span class="lineno"> 556</span>  <span class="comment">// valid Kraus map</span></div>
<div class="line"><a name="l00557"></a><span class="lineno"> 557</span>  <span class="keywordtype">int</span> numOps = GENERATE( range(1,5) ); <span class="comment">// max 4 inclusive</span></div>
<div class="line"><a name="l00558"></a><span class="lineno"> 558</span>  std::vector<QMatrix> matrs = <a class="code" href="group__testutilities.html#ga0d3b30625e2350a1e837a0b259dd3b18">getRandomKrausMap</a>(1, numOps);</div>
<div class="line"><a name="l00559"></a><span class="lineno"> 559</span>  <a class="code" href="structComplexMatrix2.html">ComplexMatrix2</a> ops[numOps];</div>
<div class="line"><a name="l00560"></a><span class="lineno"> 560</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numOps; i++)</div>
<div class="line"><a name="l00561"></a><span class="lineno"> 561</span>  ops[i] = <a class="code" href="group__testutilities.html#ga731a7a71755c25ebe96e742e3fbe5812">toComplexMatrix2</a>(matrs[i]);</div>
<div class="line"><a name="l00562"></a><span class="lineno"> 562</span>  </div>
<div class="line"><a name="l00563"></a><span class="lineno"> 563</span>  <span class="comment">// make invalid</span></div>
<div class="line"><a name="l00564"></a><span class="lineno"> 564</span>  ops[GENERATE_REF( range(0,numOps) )].<a class="code" href="structComplexMatrix2.html#a3ea98d545b67a190ee6abe936c72076f">real</a>[0][0] = 0;</div>
<div class="line"><a name="l00565"></a><span class="lineno"> 565</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#gacb7faa9d8afb0f4270c866424fffbccd">mixKrausMap</a>(qureg, 0, ops, numOps), Contains(<span class="stringliteral">"trace preserving"</span>) );</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>  }</div>
<div class="line"><a name="l00568"></a><span class="lineno"> 568</span>  SECTION( <span class="stringliteral">"qubit index"</span> ) {</div>
<div class="line"><a name="l00569"></a><span class="lineno"> 569</span>  </div>
<div class="line"><a name="l00570"></a><span class="lineno"> 570</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="l00571"></a><span class="lineno"> 571</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#gacb7faa9d8afb0f4270c866424fffbccd">mixKrausMap</a>(qureg, target, NULL, 1), Contains(<span class="stringliteral">"Invalid target qubit"</span>) );</div>
<div class="line"><a name="l00572"></a><span class="lineno"> 572</span>  }</div>
<div class="line"><a name="l00573"></a><span class="lineno"> 573</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00574"></a><span class="lineno"> 574</span>  </div>
<div class="line"><a name="l00575"></a><span class="lineno"> 575</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="l00576"></a><span class="lineno"> 576</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#gacb7faa9d8afb0f4270c866424fffbccd">mixKrausMap</a>(vec, 0, NULL, 1), Contains(<span class="stringliteral">"density matrices"</span>) );</div>
<div class="line"><a name="l00577"></a><span class="lineno"> 577</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="l00578"></a><span class="lineno"> 578</span>  }</div>
<div class="line"><a name="l00579"></a><span class="lineno"> 579</span>  SECTION( <span class="stringliteral">"operators fit in node"</span> ) {</div>
<div class="line"><a name="l00580"></a><span class="lineno"> 580</span>  </div>
<div class="line"><a name="l00581"></a><span class="lineno"> 581</span>  qureg.numAmpsPerChunk = 3; <span class="comment">// min 4</span></div>
<div class="line"><a name="l00582"></a><span class="lineno"> 582</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#gacb7faa9d8afb0f4270c866424fffbccd">mixKrausMap</a>(qureg, 0, NULL, 1), Contains(<span class="stringliteral">"targets too many qubits"</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="l00585"></a><span class="lineno"> 585</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(qureg, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00586"></a><span class="lineno"> 586</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00578">getRandomKrausMap()</a>, <a class="el" href="utilities_8cpp_source.html#l00153">getZeroMatrix()</a>, <a class="el" href="QuEST_8c_source.html#l01314">mixKrausMap()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__decoherence_8cpp_source.html#l00009">PREPARE_TEST</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, <a class="el" href="QuEST_8h_source.html#l00139">ComplexMatrix2::real</a>, and <a class="el" href="utilities_8cpp_source.html#l01021">toComplexMatrix2()</a>.</p>
</div>
</div>
<a id="gaec7d511066d9bb4da613fb06d5ce8e22"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaec7d511066d9bb4da613fb06d5ce8e22">◆ </a></span>TEST_CASE() <span class="overload">[88/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"mixMultiQubitKrausMap" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[decoherence] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__decoherence.html#ga65b4c0944090fae78a37ba3b94811ace" title="Apply a general N-qubit Kraus map to a density matrix, as specified by at most (2N)^2 Kraus operators...">mixMultiQubitKrausMap</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__decoherence_8cpp_source.html#l00229">229</a> of file <a class="el" href="test__decoherence_8cpp_source.html">test_decoherence.cpp</a>.</p>
<div class="fragment"><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>  </div>
<div class="line"><a name="l00231"></a><span class="lineno"> 231</span>  <a class="code" href="test__decoherence_8cpp.html#ae828ab685c6e8b0cec317b7a6c46963a">PREPARE_TEST</a>(qureg, ref);</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>  <span class="comment">// figure out max-num (inclusive) targs allowed by hardware backend</span></div>
<div class="line"><a name="l00234"></a><span class="lineno"> 234</span>  <span class="comment">// (each node must contain as 2^(2*numTargs) amps)</span></div>
<div class="line"><a name="l00235"></a><span class="lineno"> 235</span>  <span class="keywordtype">int</span> maxNumTargs = <a class="code" href="group__testutilities.html#ga267884197cf7f1d428021cb12a57360c">calcLog2</a>(qureg.numAmpsPerChunk) / 2;</div>
<div class="line"><a name="l00236"></a><span class="lineno"> 236</span>  </div>
<div class="line"><a name="l00237"></a><span class="lineno"> 237</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00238"></a><span class="lineno"> 238</span>  </div>
<div class="line"><a name="l00239"></a><span class="lineno"> 239</span>  <span class="comment">/* note that this function incurs a stack overhead when numTargs < 4,</span></div>
<div class="line"><a name="l00240"></a><span class="lineno"> 240</span> <span class="comment"> * and a heap overhead when numTargs >= 4</span></div>
<div class="line"><a name="l00241"></a><span class="lineno"> 241</span> <span class="comment"> */</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>  <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="l00244"></a><span class="lineno"> 244</span>  </div>
<div class="line"><a name="l00245"></a><span class="lineno"> 245</span>  <span class="comment">// note this is very expensive to try every arrangement (2 min runtime for numTargs=5 alone)</span></div>
<div class="line"><a name="l00246"></a><span class="lineno"> 246</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="l00247"></a><span class="lineno"> 247</span>  </div>
<div class="line"><a name="l00248"></a><span class="lineno"> 248</span>  <span class="comment">// try the min and max number of operators, and 2 random numbers </span></div>
<div class="line"><a name="l00249"></a><span class="lineno"> 249</span>  <span class="comment">// (there are way too many to try all!)</span></div>
<div class="line"><a name="l00250"></a><span class="lineno"> 250</span>  <span class="keywordtype">int</span> maxNumOps = (2*numTargs)*(2*numTargs);</div>
<div class="line"><a name="l00251"></a><span class="lineno"> 251</span>  <span class="keywordtype">int</span> numOps = GENERATE_COPY( 1, maxNumOps, take(2,random(1,maxNumOps)) );</div>
<div class="line"><a name="l00252"></a><span class="lineno"> 252</span>  </div>
<div class="line"><a name="l00253"></a><span class="lineno"> 253</span>  <span class="comment">// use a new random map</span></div>
<div class="line"><a name="l00254"></a><span class="lineno"> 254</span>  std::vector<QMatrix> matrs = <a class="code" href="group__testutilities.html#ga0d3b30625e2350a1e837a0b259dd3b18">getRandomKrausMap</a>(numTargs, numOps);</div>
<div class="line"><a name="l00255"></a><span class="lineno"> 255</span>  </div>
<div class="line"><a name="l00256"></a><span class="lineno"> 256</span>  <span class="comment">// create map in QuEST datatypes</span></div>
<div class="line"><a name="l00257"></a><span class="lineno"> 257</span>  <a class="code" href="structComplexMatrixN.html">ComplexMatrixN</a> ops[numOps];</div>
<div class="line"><a name="l00258"></a><span class="lineno"> 258</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numOps; i++) {</div>
<div class="line"><a name="l00259"></a><span class="lineno"> 259</span>  ops[i] = <a class="code" href="group__type.html#ga815103261fb22ea9690e1427571df00e">createComplexMatrixN</a>(numTargs);</div>
<div class="line"><a name="l00260"></a><span class="lineno"> 260</span>  <a class="code" href="group__testutilities.html#ga7f83695bea7d0332a577bca017dbb03c">toComplexMatrixN</a>(matrs[i], ops[i]);</div>
<div class="line"><a name="l00261"></a><span class="lineno"> 261</span>  }</div>
<div class="line"><a name="l00262"></a><span class="lineno"> 262</span>  </div>
<div class="line"><a name="l00263"></a><span class="lineno"> 263</span>  <a class="code" href="group__decoherence.html#ga65b4c0944090fae78a37ba3b94811ace">mixMultiQubitKrausMap</a>(qureg, targs, numTargs, ops, numOps);</div>
<div class="line"><a name="l00264"></a><span class="lineno"> 264</span>  </div>
<div class="line"><a name="l00265"></a><span class="lineno"> 265</span>  <span class="comment">// set ref -> K_i ref K_i^dagger</span></div>
<div class="line"><a name="l00266"></a><span class="lineno"> 266</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> matrRefs[numOps];</div>
<div class="line"><a name="l00267"></a><span class="lineno"> 267</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numOps; i++) {</div>
<div class="line"><a name="l00268"></a><span class="lineno"> 268</span>  matrRefs[i] = ref;</div>
<div class="line"><a name="l00269"></a><span class="lineno"> 269</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(matrRefs[i], targs, numTargs, matrs[i]);</div>
<div class="line"><a name="l00270"></a><span class="lineno"> 270</span>  }</div>
<div class="line"><a name="l00271"></a><span class="lineno"> 271</span>  ref = <a class="code" href="group__testutilities.html#ga6ccbb15b0f234e926be96a153181b63a">getZeroMatrix</a>(ref.size());</div>
<div class="line"><a name="l00272"></a><span class="lineno"> 272</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numOps; i++)</div>
<div class="line"><a name="l00273"></a><span class="lineno"> 273</span>  ref += matrRefs[i];</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>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(qureg, ref, 1E2*REAL_EPS) );</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>  <span class="comment">// cleanup QuEST datatypes</span></div>
<div class="line"><a name="l00278"></a><span class="lineno"> 278</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numOps; i++)</div>
<div class="line"><a name="l00279"></a><span class="lineno"> 279</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(ops[i]);</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">"input validation"</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>  SECTION( <span class="stringliteral">"repetition of target"</span> ) {</div>
<div class="line"><a name="l00284"></a><span class="lineno"> 284</span>  </div>
<div class="line"><a name="l00285"></a><span class="lineno"> 285</span>  <span class="comment">// make valid targets</span></div>
<div class="line"><a name="l00286"></a><span class="lineno"> 286</span>  <span class="keywordtype">int</span> targs[<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>];</div>
<div class="line"><a name="l00287"></a><span class="lineno"> 287</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>; i++)</div>
<div class="line"><a name="l00288"></a><span class="lineno"> 288</span>  targs[i] = i;</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>  <span class="comment">// duplicate one</span></div>
<div class="line"><a name="l00291"></a><span class="lineno"> 291</span>  <span class="keywordtype">int</span> badInd = GENERATE( range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) );</div>
<div class="line"><a name="l00292"></a><span class="lineno"> 292</span>  <span class="keywordtype">int</span> copyInd = GENERATE_COPY( filter([=](<span class="keywordtype">int</span> i){ <span class="keywordflow">return</span> i!=badInd; }, range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>)) );</div>
<div class="line"><a name="l00293"></a><span class="lineno"> 293</span>  targs[badInd] = targs[copyInd];</div>
<div class="line"><a name="l00294"></a><span class="lineno"> 294</span>  </div>
<div class="line"><a name="l00295"></a><span class="lineno"> 295</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#ga65b4c0944090fae78a37ba3b94811ace">mixMultiQubitKrausMap</a>(qureg, targs, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, NULL, 1), Contains(<span class="stringliteral">"target qubits"</span>) && Contains(<span class="stringliteral">"unique"</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">"qubit indices"</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="comment">// make valid targets</span></div>
<div class="line"><a name="l00300"></a><span class="lineno"> 300</span>  <span class="keywordtype">int</span> targs[<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>];</div>
<div class="line"><a name="l00301"></a><span class="lineno"> 301</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>; i++)</div>
<div class="line"><a name="l00302"></a><span class="lineno"> 302</span>  targs[i] = i;</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">// make one invalid </span></div>
<div class="line"><a name="l00305"></a><span class="lineno"> 305</span>  targs[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="l00306"></a><span class="lineno"> 306</span>  </div>
<div class="line"><a name="l00307"></a><span class="lineno"> 307</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#ga65b4c0944090fae78a37ba3b94811ace">mixMultiQubitKrausMap</a>(qureg, targs, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, NULL, 1), Contains(<span class="stringliteral">"Invalid target qubit"</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>  SECTION( <span class="stringliteral">"number of operators"</span> ) {</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>  <span class="keywordtype">int</span> numTargs = GENERATE_COPY( range(1,maxNumTargs+1) );</div>
<div class="line"><a name="l00312"></a><span class="lineno"> 312</span>  <span class="keywordtype">int</span> maxNumOps = (2*numTargs)*(2*numTargs);</div>
<div class="line"><a name="l00313"></a><span class="lineno"> 313</span>  <span class="keywordtype">int</span> numOps = GENERATE_REF( -1, 0, maxNumOps + 1 );</div>
<div class="line"><a name="l00314"></a><span class="lineno"> 314</span>  </div>
<div class="line"><a name="l00315"></a><span class="lineno"> 315</span>  <span class="comment">// make valid targets to avoid triggering target validation</span></div>
<div class="line"><a name="l00316"></a><span class="lineno"> 316</span>  <span class="keywordtype">int</span> targs[numTargs];</div>
<div class="line"><a name="l00317"></a><span class="lineno"> 317</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numTargs; i++)</div>
<div class="line"><a name="l00318"></a><span class="lineno"> 318</span>  targs[i] = i;</div>
<div class="line"><a name="l00319"></a><span class="lineno"> 319</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#ga65b4c0944090fae78a37ba3b94811ace">mixMultiQubitKrausMap</a>(qureg, targs, numTargs, NULL, numOps), Contains(<span class="stringliteral">"operators may be specified"</span>) );</div>
<div class="line"><a name="l00320"></a><span class="lineno"> 320</span>  }</div>
<div class="line"><a name="l00321"></a><span class="lineno"> 321</span>  SECTION( <span class="stringliteral">"initialisation of operators"</span> ) {</div>
<div class="line"><a name="l00322"></a><span class="lineno"> 322</span>  </div>
<div class="line"><a name="l00323"></a><span class="lineno"> 323</span>  <span class="comment">/* compilers don't auto-initialise to NULL; the below circumstance </span></div>
<div class="line"><a name="l00324"></a><span class="lineno"> 324</span> <span class="comment"> * only really occurs when 'malloc' returns NULL in createComplexMatrixN, </span></div>
<div class="line"><a name="l00325"></a><span class="lineno"> 325</span> <span class="comment"> * which actually triggers its own validation. Hence this test is useless </span></div>
<div class="line"><a name="l00326"></a><span class="lineno"> 326</span> <span class="comment"> * currently.</span></div>
<div class="line"><a name="l00327"></a><span class="lineno"> 327</span> <span class="comment"> */</span></div>
<div class="line"><a name="l00328"></a><span class="lineno"> 328</span>  </div>
<div class="line"><a name="l00329"></a><span class="lineno"> 329</span>  <span class="keywordtype">int</span> numTargs = <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>;</div>
<div class="line"><a name="l00330"></a><span class="lineno"> 330</span>  <span class="keywordtype">int</span> numOps = (2*numTargs)*(2*numTargs);</div>
<div class="line"><a name="l00331"></a><span class="lineno"> 331</span>  </div>
<div class="line"><a name="l00332"></a><span class="lineno"> 332</span>  <span class="comment">// no need to initialise ops, but set their attribs correct to avoid triggering other validation</span></div>
<div class="line"><a name="l00333"></a><span class="lineno"> 333</span>  <a class="code" href="structComplexMatrixN.html">ComplexMatrixN</a> ops[numOps];</div>
<div class="line"><a name="l00334"></a><span class="lineno"> 334</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numOps; i++)</div>
<div class="line"><a name="l00335"></a><span class="lineno"> 335</span>  ops[i].numQubits = numTargs;</div>
<div class="line"><a name="l00336"></a><span class="lineno"> 336</span>  </div>
<div class="line"><a name="l00337"></a><span class="lineno"> 337</span>  <span class="comment">// make one of the max-ops explicitly NULL</span></div>
<div class="line"><a name="l00338"></a><span class="lineno"> 338</span>  ops[GENERATE_COPY( range(0,numTargs) )].<a class="code" href="structComplexMatrixN.html#a446e8a077597e4f76049d547df0c9738">real</a> = NULL;</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>  <span class="comment">// make valid targets to avoid triggering target validation</span></div>
<div class="line"><a name="l00341"></a><span class="lineno"> 341</span>  <span class="keywordtype">int</span> targs[numTargs];</div>
<div class="line"><a name="l00342"></a><span class="lineno"> 342</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numTargs; i++)</div>
<div class="line"><a name="l00343"></a><span class="lineno"> 343</span>  targs[i] = i;</div>
<div class="line"><a name="l00344"></a><span class="lineno"> 344</span>  </div>
<div class="line"><a name="l00345"></a><span class="lineno"> 345</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#ga65b4c0944090fae78a37ba3b94811ace">mixMultiQubitKrausMap</a>(qureg, targs, numTargs, ops, numOps), Contains(<span class="stringliteral">"ComplexMatrixN"</span>) && Contains(<span class="stringliteral">"created"</span>) );</div>
<div class="line"><a name="l00346"></a><span class="lineno"> 346</span>  }</div>
<div class="line"><a name="l00347"></a><span class="lineno"> 347</span>  SECTION( <span class="stringliteral">"dimension of operators"</span> ) {</div>
<div class="line"><a name="l00348"></a><span class="lineno"> 348</span>  </div>
<div class="line"><a name="l00349"></a><span class="lineno"> 349</span>  <span class="comment">// make valid (dimension-wise) max-qubits Kraus map</span></div>
<div class="line"><a name="l00350"></a><span class="lineno"> 350</span>  <span class="keywordtype">int</span> numTargs = <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>;</div>
<div class="line"><a name="l00351"></a><span class="lineno"> 351</span>  <span class="keywordtype">int</span> numOps = (2*numTargs)*(2*numTargs);</div>
<div class="line"><a name="l00352"></a><span class="lineno"> 352</span>  <a class="code" href="structComplexMatrixN.html">ComplexMatrixN</a> ops[numOps];</div>
<div class="line"><a name="l00353"></a><span class="lineno"> 353</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numOps; i++)</div>
<div class="line"><a name="l00354"></a><span class="lineno"> 354</span>  ops[i] = <a class="code" href="group__type.html#ga815103261fb22ea9690e1427571df00e">createComplexMatrixN</a>(numTargs);</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>  <span class="comment">// make one have wrong-dimensions </span></div>
<div class="line"><a name="l00357"></a><span class="lineno"> 357</span>  <span class="keywordtype">int</span> badInd = GENERATE_COPY( range(0,numTargs) );</div>
<div class="line"><a name="l00358"></a><span class="lineno"> 358</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(ops[badInd]);</div>
<div class="line"><a name="l00359"></a><span class="lineno"> 359</span>  ops[badInd] = <a class="code" href="group__type.html#ga815103261fb22ea9690e1427571df00e">createComplexMatrixN</a>(numTargs - 1);</div>
<div class="line"><a name="l00360"></a><span class="lineno"> 360</span>  </div>
<div class="line"><a name="l00361"></a><span class="lineno"> 361</span>  <span class="comment">// make valid targets to avoid triggering target validation</span></div>
<div class="line"><a name="l00362"></a><span class="lineno"> 362</span>  <span class="keywordtype">int</span> targs[numTargs];</div>
<div class="line"><a name="l00363"></a><span class="lineno"> 363</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numTargs; i++)</div>
<div class="line"><a name="l00364"></a><span class="lineno"> 364</span>  targs[i] = i;</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>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#ga65b4c0944090fae78a37ba3b94811ace">mixMultiQubitKrausMap</a>(qureg, targs, numTargs, ops, numOps), Contains(<span class="stringliteral">"same number of qubits"</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="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numOps; i++)</div>
<div class="line"><a name="l00369"></a><span class="lineno"> 369</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(ops[i]);</div>
<div class="line"><a name="l00370"></a><span class="lineno"> 370</span>  }</div>
<div class="line"><a name="l00371"></a><span class="lineno"> 371</span>  SECTION( <span class="stringliteral">"trace preserving"</span> ) {</div>
<div class="line"><a name="l00372"></a><span class="lineno"> 372</span>  </div>
<div class="line"><a name="l00373"></a><span class="lineno"> 373</span>  <span class="keywordtype">int</span> numTargs = GENERATE_COPY( range(1,maxNumTargs+1) );</div>
<div class="line"><a name="l00374"></a><span class="lineno"> 374</span>  <span class="keywordtype">int</span> maxNumOps = (2*numTargs) * (2*numTargs);</div>
<div class="line"><a name="l00375"></a><span class="lineno"> 375</span>  <span class="keywordtype">int</span> numOps = GENERATE_COPY( 1, 2, maxNumOps );</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="comment">// generate a valid map</span></div>
<div class="line"><a name="l00378"></a><span class="lineno"> 378</span>  std::vector<QMatrix> matrs = <a class="code" href="group__testutilities.html#ga0d3b30625e2350a1e837a0b259dd3b18">getRandomKrausMap</a>(numTargs, numOps);</div>
<div class="line"><a name="l00379"></a><span class="lineno"> 379</span>  <a class="code" href="structComplexMatrixN.html">ComplexMatrixN</a> ops[numOps];</div>
<div class="line"><a name="l00380"></a><span class="lineno"> 380</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numOps; i++) {</div>
<div class="line"><a name="l00381"></a><span class="lineno"> 381</span>  ops[i] = <a class="code" href="group__type.html#ga815103261fb22ea9690e1427571df00e">createComplexMatrixN</a>(numTargs);</div>
<div class="line"><a name="l00382"></a><span class="lineno"> 382</span>  <a class="code" href="group__testutilities.html#ga7f83695bea7d0332a577bca017dbb03c">toComplexMatrixN</a>(matrs[i], ops[i]);</div>
<div class="line"><a name="l00383"></a><span class="lineno"> 383</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>  <span class="comment">// make only one invalid</span></div>
<div class="line"><a name="l00386"></a><span class="lineno"> 386</span>  ops[GENERATE_REF( range(0,numOps) )].<a class="code" href="structComplexMatrixN.html#a446e8a077597e4f76049d547df0c9738">real</a>[0][0] = 0;</div>
<div class="line"><a name="l00387"></a><span class="lineno"> 387</span>  </div>
<div class="line"><a name="l00388"></a><span class="lineno"> 388</span>  <span class="comment">// make valid targets to avoid triggering target validation</span></div>
<div class="line"><a name="l00389"></a><span class="lineno"> 389</span>  <span class="keywordtype">int</span> targs[numTargs];</div>
<div class="line"><a name="l00390"></a><span class="lineno"> 390</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numTargs; i++)</div>
<div class="line"><a name="l00391"></a><span class="lineno"> 391</span>  targs[i] = i;</div>
<div class="line"><a name="l00392"></a><span class="lineno"> 392</span>  </div>
<div class="line"><a name="l00393"></a><span class="lineno"> 393</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#ga65b4c0944090fae78a37ba3b94811ace">mixMultiQubitKrausMap</a>(qureg, targs, numTargs, ops, numOps), Contains(<span class="stringliteral">"trace preserving"</span>) );</div>
<div class="line"><a name="l00394"></a><span class="lineno"> 394</span>  </div>
<div class="line"><a name="l00395"></a><span class="lineno"> 395</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numOps; i++)</div>
<div class="line"><a name="l00396"></a><span class="lineno"> 396</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(ops[i]);</div>
<div class="line"><a name="l00397"></a><span class="lineno"> 397</span>  }</div>
<div class="line"><a name="l00398"></a><span class="lineno"> 398</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00399"></a><span class="lineno"> 399</span>  </div>
<div class="line"><a name="l00400"></a><span class="lineno"> 400</span>  <a class="code" href="structQureg.html">Qureg</a> statevec = <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="l00401"></a><span class="lineno"> 401</span>  </div>
<div class="line"><a name="l00402"></a><span class="lineno"> 402</span>  <span class="comment">// make valid targets to avoid triggering target validation</span></div>
<div class="line"><a name="l00403"></a><span class="lineno"> 403</span>  <span class="keywordtype">int</span> targs[<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>];</div>
<div class="line"><a name="l00404"></a><span class="lineno"> 404</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>; i++)</div>
<div class="line"><a name="l00405"></a><span class="lineno"> 405</span>  targs[i] = i;</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__decoherence.html#ga65b4c0944090fae78a37ba3b94811ace">mixMultiQubitKrausMap</a>(statevec, targs, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, NULL, 1), Contains(<span class="stringliteral">"valid only for density matrices"</span>) );</div>
<div class="line"><a name="l00408"></a><span class="lineno"> 408</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(statevec, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</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>  }</div>
<div class="line"><a name="l00411"></a><span class="lineno"> 411</span>  SECTION( <span class="stringliteral">"operator fits in node"</span> ) {</div>
<div class="line"><a name="l00412"></a><span class="lineno"> 412</span>  </div>
<div class="line"><a name="l00413"></a><span class="lineno"> 413</span>  <span class="comment">// each node requires (2 numTargs)^2 amplitudes</span></div>
<div class="line"><a name="l00414"></a><span class="lineno"> 414</span>  <span class="keywordtype">int</span> minAmps = (2*<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) * (2*<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>);</div>
<div class="line"><a name="l00415"></a><span class="lineno"> 415</span>  </div>
<div class="line"><a name="l00416"></a><span class="lineno"> 416</span>  <span class="comment">// make valid targets to avoid triggering target validation</span></div>
<div class="line"><a name="l00417"></a><span class="lineno"> 417</span>  <span class="keywordtype">int</span> targs[<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>];</div>
<div class="line"><a name="l00418"></a><span class="lineno"> 418</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>; i++)</div>
<div class="line"><a name="l00419"></a><span class="lineno"> 419</span>  targs[i] = i;</div>
<div class="line"><a name="l00420"></a><span class="lineno"> 420</span>  </div>
<div class="line"><a name="l00421"></a><span class="lineno"> 421</span>  <span class="comment">// make a simple Identity map </span></div>
<div class="line"><a name="l00422"></a><span class="lineno"> 422</span>  <a class="code" href="structComplexMatrixN.html">ComplexMatrixN</a> ops[] = {<a class="code" href="group__type.html#ga815103261fb22ea9690e1427571df00e">createComplexMatrixN</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>)};</div>
<div class="line"><a name="l00423"></a><span class="lineno"> 423</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<(1<<<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>); i++)</div>
<div class="line"><a name="l00424"></a><span class="lineno"> 424</span>  ops[0].real[i][i] = 1;</div>
<div class="line"><a name="l00425"></a><span class="lineno"> 425</span>  </div>
<div class="line"><a name="l00426"></a><span class="lineno"> 426</span>  <span class="comment">// fake a smaller qureg </span></div>
<div class="line"><a name="l00427"></a><span class="lineno"> 427</span>  qureg.numAmpsPerChunk = minAmps - 1;</div>
<div class="line"><a name="l00428"></a><span class="lineno"> 428</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#ga65b4c0944090fae78a37ba3b94811ace">mixMultiQubitKrausMap</a>(qureg, targs, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, ops, 1), Contains(<span class="stringliteral">"targets too many qubits"</span>) && Contains(<span class="stringliteral">"cannot all fit"</span>) );</div>
<div class="line"><a name="l00429"></a><span class="lineno"> 429</span>  </div>
<div class="line"><a name="l00430"></a><span class="lineno"> 430</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(ops[0]);</div>
<div class="line"><a name="l00431"></a><span class="lineno"> 431</span>  }</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>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(qureg, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00434"></a><span class="lineno"> 434</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST__validation_8c_source.html#l00328">calcLog2()</a>, <a class="el" href="QuEST_8c_source.html#l01348">createComplexMatrixN()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l01369">destroyComplexMatrixN()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00578">getRandomKrausMap()</a>, <a class="el" href="utilities_8cpp_source.html#l00153">getZeroMatrix()</a>, <a class="el" href="QuEST_8c_source.html#l01334">mixMultiQubitKrausMap()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__decoherence_8cpp_source.html#l00009">PREPARE_TEST</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, <a class="el" href="QuEST_8h_source.html#l00189">ComplexMatrixN::real</a>, <a class="el" href="utilities_8cpp_source.html#l01488">sublists()</a>, and <a class="el" href="utilities_8cpp_source.html#l01033">toComplexMatrixN()</a>.</p>
</div>
</div>
<a id="ga4e1cffea3db565911c48cae1d6d08a64"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga4e1cffea3db565911c48cae1d6d08a64">◆ </a></span>TEST_CASE() <span class="overload">[89/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"mixPauli" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[decoherence] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__decoherence.html#ga9a77f84e1aa7d25d036b14d7d0cd8b61" title="Mixes a density matrix qureg to induce general single-qubit Pauli noise.">mixPauli</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__decoherence_8cpp_source.html#l00442">442</a> of file <a class="el" href="test__decoherence_8cpp_source.html">test_decoherence.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00442"></a><span class="lineno"> 442</span>  {</div>
<div class="line"><a name="l00443"></a><span class="lineno"> 443</span>  </div>
<div class="line"><a name="l00444"></a><span class="lineno"> 444</span>  <a class="code" href="test__decoherence_8cpp.html#ae828ab685c6e8b0cec317b7a6c46963a">PREPARE_TEST</a>(qureg, ref);</div>
<div class="line"><a name="l00445"></a><span class="lineno"> 445</span>  </div>
<div class="line"><a name="l00446"></a><span class="lineno"> 446</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00447"></a><span class="lineno"> 447</span>  </div>
<div class="line"><a name="l00448"></a><span class="lineno"> 448</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="l00449"></a><span class="lineno"> 449</span>  </div>
<div class="line"><a name="l00450"></a><span class="lineno"> 450</span>  <span class="comment">// randomly generate valid pauli-error probabilities</span></div>
<div class="line"><a name="l00451"></a><span class="lineno"> 451</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> probs[3];</div>
<div class="line"><a name="l00452"></a><span class="lineno"> 452</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> max0 = 1/2.; <span class="comment">// satisfies p1 < 1 - py</span></div>
<div class="line"><a name="l00453"></a><span class="lineno"> 453</span>  probs[0] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(0, max0);</div>
<div class="line"><a name="l00454"></a><span class="lineno"> 454</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> max1 = (max0 - probs[0])/2.; <span class="comment">// p2 can use half of p1's "unused space"</span></div>
<div class="line"><a name="l00455"></a><span class="lineno"> 455</span>  probs[1] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(0, max1);</div>
<div class="line"><a name="l00456"></a><span class="lineno"> 456</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> max2 = (max1 - probs[1])/2.; <span class="comment">// p3 can use half of p2's "unused space"</span></div>
<div class="line"><a name="l00457"></a><span class="lineno"> 457</span>  probs[2] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(0, max2);</div>
<div class="line"><a name="l00458"></a><span class="lineno"> 458</span>  </div>
<div class="line"><a name="l00459"></a><span class="lineno"> 459</span>  <span class="comment">// uniformly randomly assign probs (bound to target)</span></div>
<div class="line"><a name="l00460"></a><span class="lineno"> 460</span>  <span class="keywordtype">int</span> inds[3] = {0,1,2};</div>
<div class="line"><a name="l00461"></a><span class="lineno"> 461</span>  std::shuffle(inds,inds+3, std::default_random_engine(1E5 * target));</div>
<div class="line"><a name="l00462"></a><span class="lineno"> 462</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> probX = probs[inds[0]]; <span class="comment">// seed:target shows no variation</span></div>
<div class="line"><a name="l00463"></a><span class="lineno"> 463</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> probY = probs[inds[1]];</div>
<div class="line"><a name="l00464"></a><span class="lineno"> 464</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> probZ = probs[inds[2]];</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__decoherence.html#ga9a77f84e1aa7d25d036b14d7d0cd8b61">mixPauli</a>(qureg, target, probX, probY, probZ);</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>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> xRef = ref;</div>
<div class="line"><a name="l00469"></a><span class="lineno"> 469</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(xRef, target, <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a>{{0,1},{1,0}}); <span class="comment">// X ref X</span></div>
<div class="line"><a name="l00470"></a><span class="lineno"> 470</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> yRef = ref;</div>
<div class="line"><a name="l00471"></a><span class="lineno"> 471</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(yRef, target, <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a>{{0,-<a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>(0,1)},{<a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>(0,1),0}}); <span class="comment">// Y ref Y</span></div>
<div class="line"><a name="l00472"></a><span class="lineno"> 472</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> zRef = ref;</div>
<div class="line"><a name="l00473"></a><span class="lineno"> 473</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(zRef, target, <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a>{{1,0},{0,-1}}); <span class="comment">// Z ref Z</span></div>
<div class="line"><a name="l00474"></a><span class="lineno"> 474</span>  ref = ((1 - probX - probY - probZ) * ref) +</div>
<div class="line"><a name="l00475"></a><span class="lineno"> 475</span>  (probX * xRef) + (probY * yRef) + (probZ * zRef);</div>
<div class="line"><a name="l00476"></a><span class="lineno"> 476</span>  </div>
<div class="line"><a name="l00477"></a><span class="lineno"> 477</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(qureg, ref) );</div>
<div class="line"><a name="l00478"></a><span class="lineno"> 478</span>  }</div>
<div class="line"><a name="l00479"></a><span class="lineno"> 479</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00480"></a><span class="lineno"> 480</span>  </div>
<div class="line"><a name="l00481"></a><span class="lineno"> 481</span>  SECTION( <span class="stringliteral">"qubit index"</span> ) {</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>  <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="l00484"></a><span class="lineno"> 484</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#ga9a77f84e1aa7d25d036b14d7d0cd8b61">mixPauli</a>(qureg, target, 0, 0, 0), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l00485"></a><span class="lineno"> 485</span>  </div>
<div class="line"><a name="l00486"></a><span class="lineno"> 486</span>  }</div>
<div class="line"><a name="l00487"></a><span class="lineno"> 487</span>  SECTION( <span class="stringliteral">"probability"</span> ) {</div>
<div class="line"><a name="l00488"></a><span class="lineno"> 488</span>  </div>
<div class="line"><a name="l00489"></a><span class="lineno"> 489</span>  <span class="keywordtype">int</span> target = 0;</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>  <span class="comment">// probs clearly must be in [0, 1]</span></div>
<div class="line"><a name="l00492"></a><span class="lineno"> 492</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#ga9a77f84e1aa7d25d036b14d7d0cd8b61">mixPauli</a>(qureg, target, -.1, 0, 0), Contains(<span class="stringliteral">"Probabilities"</span>) );</div>
<div class="line"><a name="l00493"></a><span class="lineno"> 493</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#ga9a77f84e1aa7d25d036b14d7d0cd8b61">mixPauli</a>(qureg, target, 0, -.1, 0), Contains(<span class="stringliteral">"Probabilities"</span>) );</div>
<div class="line"><a name="l00494"></a><span class="lineno"> 494</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#ga9a77f84e1aa7d25d036b14d7d0cd8b61">mixPauli</a>(qureg, target, 0, 0, -.1), Contains(<span class="stringliteral">"Probabilities"</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="comment">// max single-non-zero-prob is 0.5</span></div>
<div class="line"><a name="l00497"></a><span class="lineno"> 497</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#ga9a77f84e1aa7d25d036b14d7d0cd8b61">mixPauli</a>(qureg, target, .6, 0, 0), Contains(<span class="stringliteral">"cannot exceed the probability"</span>) );</div>
<div class="line"><a name="l00498"></a><span class="lineno"> 498</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#ga9a77f84e1aa7d25d036b14d7d0cd8b61">mixPauli</a>(qureg, target, 0, .6, 0), Contains(<span class="stringliteral">"cannot exceed the probability"</span>) );</div>
<div class="line"><a name="l00499"></a><span class="lineno"> 499</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#ga9a77f84e1aa7d25d036b14d7d0cd8b61">mixPauli</a>(qureg, target, 0, 0, .6), Contains(<span class="stringliteral">"cannot exceed the probability"</span>) );</div>
<div class="line"><a name="l00500"></a><span class="lineno"> 500</span>  </div>
<div class="line"><a name="l00501"></a><span class="lineno"> 501</span>  <span class="comment">// must satisfy px, py, pz < 1 - px - py - pz</span></div>
<div class="line"><a name="l00502"></a><span class="lineno"> 502</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#ga9a77f84e1aa7d25d036b14d7d0cd8b61">mixPauli</a>(qureg, target, .3, .3, .3), Contains(<span class="stringliteral">"cannot exceed the probability"</span>) );</div>
<div class="line"><a name="l00503"></a><span class="lineno"> 503</span>  }</div>
<div class="line"><a name="l00504"></a><span class="lineno"> 504</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00505"></a><span class="lineno"> 505</span>  </div>
<div class="line"><a name="l00506"></a><span class="lineno"> 506</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="l00507"></a><span class="lineno"> 507</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#ga9a77f84e1aa7d25d036b14d7d0cd8b61">mixPauli</a>(vec, 0, 0, 0, 0), Contains(<span class="stringliteral">"density matrices"</span>) );</div>
<div class="line"><a name="l00508"></a><span class="lineno"> 508</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="l00509"></a><span class="lineno"> 509</span>  }</div>
<div class="line"><a name="l00510"></a><span class="lineno"> 510</span>  }</div>
<div class="line"><a name="l00511"></a><span class="lineno"> 511</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(qureg, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00512"></a><span class="lineno"> 512</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00421">getRandomReal()</a>, <a class="el" href="QuEST_8c_source.html#l01303">mixPauli()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__decoherence_8cpp_source.html#l00009">PREPARE_TEST</a>, <a class="el" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, and <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>.</p>
</div>
</div>
<a id="gab377b0280d26028a2405eb883003fe10"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gab377b0280d26028a2405eb883003fe10">◆ </a></span>TEST_CASE() <span class="overload">[90/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"mixTwoQubitDephasing" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[decoherence] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__decoherence.html#ga14282bdb1dc65760ca9ecbe6305eb770" title="Mixes a density matrix qureg to induce two-qubit dephasing noise.">mixTwoQubitDephasing</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__decoherence_8cpp_source.html#l00594">594</a> of file <a class="el" href="test__decoherence_8cpp_source.html">test_decoherence.cpp</a>.</p>
<div class="fragment"><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>  </div>
<div class="line"><a name="l00596"></a><span class="lineno"> 596</span>  <a class="code" href="test__decoherence_8cpp.html#ae828ab685c6e8b0cec317b7a6c46963a">PREPARE_TEST</a>(qureg, ref);</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>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00599"></a><span class="lineno"> 599</span>  </div>
<div class="line"><a name="l00600"></a><span class="lineno"> 600</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="l00601"></a><span class="lineno"> 601</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="l00602"></a><span class="lineno"> 602</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> prob = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(0, 3/4.);</div>
<div class="line"><a name="l00603"></a><span class="lineno"> 603</span>  </div>
<div class="line"><a name="l00604"></a><span class="lineno"> 604</span>  <a class="code" href="group__decoherence.html#ga14282bdb1dc65760ca9ecbe6305eb770">mixTwoQubitDephasing</a>(qureg, targ1, targ2, prob);</div>
<div class="line"><a name="l00605"></a><span class="lineno"> 605</span>  </div>
<div class="line"><a name="l00606"></a><span class="lineno"> 606</span>  <span class="comment">// ref -> (1 - prob) ref + prob/3 (Z1 ref Z1 + Z2 ref Z2 + Z1 Z2 ref Z1 Z2)</span></div>
<div class="line"><a name="l00607"></a><span class="lineno"> 607</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> zMatr{{1,0},{0,-1}};</div>
<div class="line"><a name="l00608"></a><span class="lineno"> 608</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> z1Ref = ref;</div>
<div class="line"><a name="l00609"></a><span class="lineno"> 609</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(z1Ref, targ1, zMatr); <span class="comment">// Z1 ref Z1</span></div>
<div class="line"><a name="l00610"></a><span class="lineno"> 610</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> z2Ref = ref;</div>
<div class="line"><a name="l00611"></a><span class="lineno"> 611</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(z2Ref, targ2, zMatr); <span class="comment">// Z2 ref Z2</span></div>
<div class="line"><a name="l00612"></a><span class="lineno"> 612</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> z1z2Ref = ref;</div>
<div class="line"><a name="l00613"></a><span class="lineno"> 613</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(z1z2Ref, targ1, zMatr);</div>
<div class="line"><a name="l00614"></a><span class="lineno"> 614</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(z1z2Ref, targ2, zMatr); <span class="comment">// Z1 Z2 ref Z1 Z2</span></div>
<div class="line"><a name="l00615"></a><span class="lineno"> 615</span>  ref = ((1 - prob) * ref) + (prob/3.) * (z1Ref + z2Ref + z1z2Ref);</div>
<div class="line"><a name="l00616"></a><span class="lineno"> 616</span>  </div>
<div class="line"><a name="l00617"></a><span class="lineno"> 617</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(qureg, ref) );</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>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00620"></a><span class="lineno"> 620</span>  </div>
<div class="line"><a name="l00621"></a><span class="lineno"> 621</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l00622"></a><span class="lineno"> 622</span>  </div>
<div class="line"><a name="l00623"></a><span class="lineno"> 623</span>  <span class="keywordtype">int</span> targ = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l00624"></a><span class="lineno"> 624</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#ga14282bdb1dc65760ca9ecbe6305eb770">mixTwoQubitDephasing</a>(qureg, 0, targ, 0), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l00625"></a><span class="lineno"> 625</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#ga14282bdb1dc65760ca9ecbe6305eb770">mixTwoQubitDephasing</a>(qureg, targ, 0, 0), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l00626"></a><span class="lineno"> 626</span>  }</div>
<div class="line"><a name="l00627"></a><span class="lineno"> 627</span>  SECTION( <span class="stringliteral">"target collision"</span> ) {</div>
<div class="line"><a name="l00628"></a><span class="lineno"> 628</span>  </div>
<div class="line"><a name="l00629"></a><span class="lineno"> 629</span>  <span class="keywordtype">int</span> targ = GENERATE( range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) );</div>
<div class="line"><a name="l00630"></a><span class="lineno"> 630</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#ga14282bdb1dc65760ca9ecbe6305eb770">mixTwoQubitDephasing</a>(qureg, targ, targ, 0), Contains(<span class="stringliteral">"target"</span>) && Contains(<span class="stringliteral">"unique"</span>) );</div>
<div class="line"><a name="l00631"></a><span class="lineno"> 631</span>  }</div>
<div class="line"><a name="l00632"></a><span class="lineno"> 632</span>  SECTION( <span class="stringliteral">"probability"</span> ) {</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>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#ga14282bdb1dc65760ca9ecbe6305eb770">mixTwoQubitDephasing</a>(qureg, 0, 1, -.1), Contains(<span class="stringliteral">"Probabilities"</span>) );</div>
<div class="line"><a name="l00635"></a><span class="lineno"> 635</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#ga14282bdb1dc65760ca9ecbe6305eb770">mixTwoQubitDephasing</a>(qureg, 0, 1, 3/4. + .01), Contains(<span class="stringliteral">"probability"</span>) && Contains(<span class="stringliteral">"cannot exceed 3/4"</span>) );</div>
<div class="line"><a name="l00636"></a><span class="lineno"> 636</span>  }</div>
<div class="line"><a name="l00637"></a><span class="lineno"> 637</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</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>  <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="l00640"></a><span class="lineno"> 640</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#ga14282bdb1dc65760ca9ecbe6305eb770">mixTwoQubitDephasing</a>(vec, 0, 1, 0), Contains(<span class="stringliteral">"density matrices"</span>) );</div>
<div class="line"><a name="l00641"></a><span class="lineno"> 641</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="l00642"></a><span class="lineno"> 642</span>  }</div>
<div class="line"><a name="l00643"></a><span class="lineno"> 643</span>  }</div>
<div class="line"><a name="l00644"></a><span class="lineno"> 644</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(qureg, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00645"></a><span class="lineno"> 645</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00421">getRandomReal()</a>, <a class="el" href="QuEST_8c_source.html#l01260">mixTwoQubitDephasing()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__decoherence_8cpp_source.html#l00009">PREPARE_TEST</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, and <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>.</p>
</div>
</div>
<a id="ga126f891ab958e59fbb3add97c5a519e3"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga126f891ab958e59fbb3add97c5a519e3">◆ </a></span>TEST_CASE() <span class="overload">[91/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"mixTwoQubitDepolarising" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[decoherence] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__decoherence.html#gacfc45a8fc86ee18f60866bbd0c874ed0" title="Mixes a density matrix qureg to induce two-qubit homogeneous depolarising noise.">mixTwoQubitDepolarising</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__decoherence_8cpp_source.html#l00653">653</a> of file <a class="el" href="test__decoherence_8cpp_source.html">test_decoherence.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00653"></a><span class="lineno"> 653</span>  {</div>
<div class="line"><a name="l00654"></a><span class="lineno"> 654</span>  </div>
<div class="line"><a name="l00655"></a><span class="lineno"> 655</span>  <a class="code" href="test__decoherence_8cpp.html#ae828ab685c6e8b0cec317b7a6c46963a">PREPARE_TEST</a>(qureg, ref);</div>
<div class="line"><a name="l00656"></a><span class="lineno"> 656</span>  </div>
<div class="line"><a name="l00657"></a><span class="lineno"> 657</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00658"></a><span class="lineno"> 658</span>  </div>
<div class="line"><a name="l00659"></a><span class="lineno"> 659</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="l00660"></a><span class="lineno"> 660</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="l00661"></a><span class="lineno"> 661</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> prob = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(0, 15/16.);</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>  <a class="code" href="group__decoherence.html#gacfc45a8fc86ee18f60866bbd0c874ed0">mixTwoQubitDepolarising</a>(qureg, targ1, targ2, prob);</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>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> paulis[4] = {</div>
<div class="line"><a name="l00666"></a><span class="lineno"> 666</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a>{{1,0},{0,1}}, <span class="comment">// I </span></div>
<div class="line"><a name="l00667"></a><span class="lineno"> 667</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a>{{0,1},{1,0}}, <span class="comment">// X</span></div>
<div class="line"><a name="l00668"></a><span class="lineno"> 668</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a>{{0,-<a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>(0,1)},{<a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>(0,1),0}}, <span class="comment">// Y</span></div>
<div class="line"><a name="l00669"></a><span class="lineno"> 669</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a>{{1,0},{0,-1}} <span class="comment">// Z</span></div>
<div class="line"><a name="l00670"></a><span class="lineno"> 670</span>  };</div>
<div class="line"><a name="l00671"></a><span class="lineno"> 671</span>  </div>
<div class="line"><a name="l00672"></a><span class="lineno"> 672</span>  <span class="keywordtype">int</span> targs[2] = {targ1, targ2};</div>
<div class="line"><a name="l00673"></a><span class="lineno"> 673</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> refInit = ref;</div>
<div class="line"><a name="l00674"></a><span class="lineno"> 674</span>  ref = (1 - (16/15.)*prob) * ref;</div>
<div class="line"><a name="l00675"></a><span class="lineno"> 675</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<4; i++) {</div>
<div class="line"><a name="l00676"></a><span class="lineno"> 676</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> j=0; j<4; j++) {</div>
<div class="line"><a name="l00677"></a><span class="lineno"> 677</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> term = refInit;</div>
<div class="line"><a name="l00678"></a><span class="lineno"> 678</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(term, targs, 2,</div>
<div class="line"><a name="l00679"></a><span class="lineno"> 679</span>  <a class="code" href="group__testutilities.html#gab5ac6842ba67b8d38bd17385ab179b67">getKroneckerProduct</a>(paulis[i], paulis[j]));</div>
<div class="line"><a name="l00680"></a><span class="lineno"> 680</span>  ref += (prob/15.) * term;</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>  }</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>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(qureg, ref, 1E4*REAL_EPS) );</div>
<div class="line"><a name="l00685"></a><span class="lineno"> 685</span>  }</div>
<div class="line"><a name="l00686"></a><span class="lineno"> 686</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00687"></a><span class="lineno"> 687</span>  </div>
<div class="line"><a name="l00688"></a><span class="lineno"> 688</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</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>  <span class="keywordtype">int</span> targ = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l00691"></a><span class="lineno"> 691</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#gacfc45a8fc86ee18f60866bbd0c874ed0">mixTwoQubitDepolarising</a>(qureg, 0, targ, 0), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l00692"></a><span class="lineno"> 692</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#gacfc45a8fc86ee18f60866bbd0c874ed0">mixTwoQubitDepolarising</a>(qureg, targ, 0, 0), Contains(<span class="stringliteral">"Invalid target"</span>) );</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>  SECTION( <span class="stringliteral">"target collision"</span> ) {</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>  <span class="keywordtype">int</span> targ = GENERATE( range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) );</div>
<div class="line"><a name="l00697"></a><span class="lineno"> 697</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#gacfc45a8fc86ee18f60866bbd0c874ed0">mixTwoQubitDepolarising</a>(qureg, targ, targ, 0), Contains(<span class="stringliteral">"target"</span>) && Contains(<span class="stringliteral">"unique"</span>) );</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>  SECTION( <span class="stringliteral">"probability"</span> ) {</div>
<div class="line"><a name="l00700"></a><span class="lineno"> 700</span>  </div>
<div class="line"><a name="l00701"></a><span class="lineno"> 701</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#gacfc45a8fc86ee18f60866bbd0c874ed0">mixTwoQubitDepolarising</a>(qureg, 0, 1, -.1), Contains(<span class="stringliteral">"Probabilities"</span>) );</div>
<div class="line"><a name="l00702"></a><span class="lineno"> 702</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#gacfc45a8fc86ee18f60866bbd0c874ed0">mixTwoQubitDepolarising</a>(qureg, 0, 1, 15/16. + .01), Contains(<span class="stringliteral">"probability"</span>) && Contains(<span class="stringliteral">"cannot exceed 15/16"</span>) );</div>
<div class="line"><a name="l00703"></a><span class="lineno"> 703</span>  }</div>
<div class="line"><a name="l00704"></a><span class="lineno"> 704</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</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>  <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="l00707"></a><span class="lineno"> 707</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#gacfc45a8fc86ee18f60866bbd0c874ed0">mixTwoQubitDepolarising</a>(vec, 0, 1, 0), Contains(<span class="stringliteral">"density matrices"</span>) );</div>
<div class="line"><a name="l00708"></a><span class="lineno"> 708</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="l00709"></a><span class="lineno"> 709</span>  }</div>
<div class="line"><a name="l00710"></a><span class="lineno"> 710</span>  }</div>
<div class="line"><a name="l00711"></a><span class="lineno"> 711</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(qureg, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00712"></a><span class="lineno"> 712</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00143">getKroneckerProduct()</a>, <a class="el" href="utilities_8cpp_source.html#l00421">getRandomReal()</a>, <a class="el" href="QuEST_8c_source.html#l01291">mixTwoQubitDepolarising()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__decoherence_8cpp_source.html#l00009">PREPARE_TEST</a>, <a class="el" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, and <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>.</p>
</div>
</div>
<a id="ga6133174f068561e9d899c059c39ed36c"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga6133174f068561e9d899c059c39ed36c">◆ </a></span>TEST_CASE() <span class="overload">[92/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"mixTwoQubitKrausMap" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[decoherence] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__decoherence.html#ga2cf7dece0efea4207349f872cdcb7e81" title="Apply a general two-qubit Kraus map to a density matrix, as specified by at most sixteen Kraus operat...">mixTwoQubitKrausMap</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__decoherence_8cpp_source.html#l00720">720</a> of file <a class="el" href="test__decoherence_8cpp_source.html">test_decoherence.cpp</a>.</p>
<div class="fragment"><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>  </div>
<div class="line"><a name="l00722"></a><span class="lineno"> 722</span>  <a class="code" href="test__decoherence_8cpp.html#ae828ab685c6e8b0cec317b7a6c46963a">PREPARE_TEST</a>(qureg, ref);</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">"correctness"</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>  <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="l00727"></a><span class="lineno"> 727</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="l00728"></a><span class="lineno"> 728</span>  <span class="keywordtype">int</span> numOps = GENERATE( range(1,17) ); <span class="comment">// max 16 inclusive</span></div>
<div class="line"><a name="l00729"></a><span class="lineno"> 729</span>  std::vector<QMatrix> matrs = <a class="code" href="group__testutilities.html#ga0d3b30625e2350a1e837a0b259dd3b18">getRandomKrausMap</a>(2, numOps);</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>  <a class="code" href="structComplexMatrix4.html">ComplexMatrix4</a> ops[numOps];</div>
<div class="line"><a name="l00732"></a><span class="lineno"> 732</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numOps; i++)</div>
<div class="line"><a name="l00733"></a><span class="lineno"> 733</span>  ops[i] = <a class="code" href="group__testutilities.html#ga216f7c25bbb0cf752d1b6fff5ea8197b">toComplexMatrix4</a>(matrs[i]);</div>
<div class="line"><a name="l00734"></a><span class="lineno"> 734</span>  <a class="code" href="group__decoherence.html#ga2cf7dece0efea4207349f872cdcb7e81">mixTwoQubitKrausMap</a>(qureg, targ1, targ2, ops, numOps);</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>  <span class="comment">// set ref -> K_i ref K_i^dagger</span></div>
<div class="line"><a name="l00737"></a><span class="lineno"> 737</span>  <span class="keywordtype">int</span> targs[2] = {targ1, targ2};</div>
<div class="line"><a name="l00738"></a><span class="lineno"> 738</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> matrRefs[numOps];</div>
<div class="line"><a name="l00739"></a><span class="lineno"> 739</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numOps; i++) {</div>
<div class="line"><a name="l00740"></a><span class="lineno"> 740</span>  matrRefs[i] = ref;</div>
<div class="line"><a name="l00741"></a><span class="lineno"> 741</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(matrRefs[i], targs, 2, matrs[i]);</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>  ref = <a class="code" href="group__testutilities.html#ga6ccbb15b0f234e926be96a153181b63a">getZeroMatrix</a>(ref.size());</div>
<div class="line"><a name="l00744"></a><span class="lineno"> 744</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numOps; i++)</div>
<div class="line"><a name="l00745"></a><span class="lineno"> 745</span>  ref += matrRefs[i];</div>
<div class="line"><a name="l00746"></a><span class="lineno"> 746</span>  </div>
<div class="line"><a name="l00747"></a><span class="lineno"> 747</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(qureg, ref, 10*REAL_EPS) );</div>
<div class="line"><a name="l00748"></a><span class="lineno"> 748</span>  }</div>
<div class="line"><a name="l00749"></a><span class="lineno"> 749</span>  SECTION( <span class="stringliteral">"input validation"</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">"number of operators"</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>  <span class="keywordtype">int</span> numOps = GENERATE( 0, 17 );</div>
<div class="line"><a name="l00754"></a><span class="lineno"> 754</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#ga2cf7dece0efea4207349f872cdcb7e81">mixTwoQubitKrausMap</a>(qureg, 0,1, NULL, numOps), Contains(<span class="stringliteral">"operators"</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">"trace preserving"</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="comment">// valid Kraus map</span></div>
<div class="line"><a name="l00759"></a><span class="lineno"> 759</span>  <span class="keywordtype">int</span> numOps = GENERATE( range(1,16) );</div>
<div class="line"><a name="l00760"></a><span class="lineno"> 760</span>  std::vector<QMatrix> matrs = <a class="code" href="group__testutilities.html#ga0d3b30625e2350a1e837a0b259dd3b18">getRandomKrausMap</a>(2, numOps);</div>
<div class="line"><a name="l00761"></a><span class="lineno"> 761</span>  <a class="code" href="structComplexMatrix4.html">ComplexMatrix4</a> ops[numOps];</div>
<div class="line"><a name="l00762"></a><span class="lineno"> 762</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numOps; i++)</div>
<div class="line"><a name="l00763"></a><span class="lineno"> 763</span>  ops[i] = <a class="code" href="group__testutilities.html#ga216f7c25bbb0cf752d1b6fff5ea8197b">toComplexMatrix4</a>(matrs[i]);</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">// make only one of the ops at a time invalid</span></div>
<div class="line"><a name="l00766"></a><span class="lineno"> 766</span>  ops[GENERATE_REF( range(0,numOps) )].<a class="code" href="structComplexMatrix4.html#aeadc9893e1b16cdd585dac523e73926c">real</a>[0][0] = 0;</div>
<div class="line"><a name="l00767"></a><span class="lineno"> 767</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#ga2cf7dece0efea4207349f872cdcb7e81">mixTwoQubitKrausMap</a>(qureg, 0,1, ops, numOps), Contains(<span class="stringliteral">"trace preserving"</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">"target collision"</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> target = GENERATE( range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) );</div>
<div class="line"><a name="l00772"></a><span class="lineno"> 772</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#ga2cf7dece0efea4207349f872cdcb7e81">mixTwoQubitKrausMap</a>(qureg, target, target, NULL, 1), Contains(<span class="stringliteral">"target qubits"</span>) && Contains(<span class="stringliteral">"unique"</span>) );</div>
<div class="line"><a name="l00773"></a><span class="lineno"> 773</span>  }</div>
<div class="line"><a name="l00774"></a><span class="lineno"> 774</span>  SECTION( <span class="stringliteral">"qubit index"</span> ) {</div>
<div class="line"><a name="l00775"></a><span class="lineno"> 775</span>  </div>
<div class="line"><a name="l00776"></a><span class="lineno"> 776</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="l00777"></a><span class="lineno"> 777</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#ga2cf7dece0efea4207349f872cdcb7e81">mixTwoQubitKrausMap</a>(qureg, 0,target, NULL, 1), Contains(<span class="stringliteral">"Invalid target qubit"</span>) );</div>
<div class="line"><a name="l00778"></a><span class="lineno"> 778</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#ga2cf7dece0efea4207349f872cdcb7e81">mixTwoQubitKrausMap</a>(qureg, target,0, NULL, 1), Contains(<span class="stringliteral">"Invalid target qubit"</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>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00781"></a><span class="lineno"> 781</span>  </div>
<div class="line"><a name="l00782"></a><span class="lineno"> 782</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="l00783"></a><span class="lineno"> 783</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#ga2cf7dece0efea4207349f872cdcb7e81">mixTwoQubitKrausMap</a>(vec, 0,1, NULL, 1), Contains(<span class="stringliteral">"density matrices"</span>) );</div>
<div class="line"><a name="l00784"></a><span class="lineno"> 784</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="l00785"></a><span class="lineno"> 785</span>  }</div>
<div class="line"><a name="l00786"></a><span class="lineno"> 786</span>  SECTION( <span class="stringliteral">"operators fit in node"</span> ) {</div>
<div class="line"><a name="l00787"></a><span class="lineno"> 787</span>  </div>
<div class="line"><a name="l00788"></a><span class="lineno"> 788</span>  qureg.numAmpsPerChunk = 15; <span class="comment">// min 16</span></div>
<div class="line"><a name="l00789"></a><span class="lineno"> 789</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__decoherence.html#ga2cf7dece0efea4207349f872cdcb7e81">mixTwoQubitKrausMap</a>(qureg, 0,1, NULL, 1), Contains(<span class="stringliteral">"targets too many qubits"</span>) );</div>
<div class="line"><a name="l00790"></a><span class="lineno"> 790</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="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(qureg, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00793"></a><span class="lineno"> 793</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00578">getRandomKrausMap()</a>, <a class="el" href="utilities_8cpp_source.html#l00153">getZeroMatrix()</a>, <a class="el" href="QuEST_8c_source.html#l01324">mixTwoQubitKrausMap()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__decoherence_8cpp_source.html#l00009">PREPARE_TEST</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, <a class="el" href="QuEST_8h_source.html#l00177">ComplexMatrix4::real</a>, and <a class="el" href="utilities_8cpp_source.html#l01027">toComplexMatrix4()</a>.</p>
</div>
</div>
<a id="gab0d956ee2aa3a9288b3d39dde5e6f75d"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gab0d956ee2aa3a9288b3d39dde5e6f75d">◆ </a></span>TEST_CASE() <span class="overload">[93/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"multiControlledMultiQubitNot" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#gafd81a9217fb7d21c365443442492b2dc" title="Apply a NOT (or Pauli X) gate with multiple control and target qubits.">multiControlledMultiQubitNot</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l00854">854</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00854"></a><span class="lineno"> 854</span>  {</div>
<div class="line"><a name="l00855"></a><span class="lineno"> 855</span>  </div>
<div class="line"><a name="l00856"></a><span class="lineno"> 856</span>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l00857"></a><span class="lineno"> 857</span>  </div>
<div class="line"><a name="l00858"></a><span class="lineno"> 858</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00859"></a><span class="lineno"> 859</span>  </div>
<div class="line"><a name="l00860"></a><span class="lineno"> 860</span>  <span class="comment">// try all possible numbers of targets and controls</span></div>
<div class="line"><a name="l00861"></a><span class="lineno"> 861</span>  <span class="keywordtype">int</span> numTargs = GENERATE_COPY( range(1,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) ); <span class="comment">// leave space for 1 ctrl</span></div>
<div class="line"><a name="l00862"></a><span class="lineno"> 862</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="l00863"></a><span class="lineno"> 863</span>  <span class="keywordtype">int</span> numCtrls = GENERATE_COPY( range(1,maxNumCtrls+1) );</div>
<div class="line"><a name="l00864"></a><span class="lineno"> 864</span>  </div>
<div class="line"><a name="l00865"></a><span class="lineno"> 865</span>  <span class="comment">// generate all possible valid qubit arrangements</span></div>
<div class="line"><a name="l00866"></a><span class="lineno"> 866</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="l00867"></a><span class="lineno"> 867</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="l00868"></a><span class="lineno"> 868</span>  </div>
<div class="line"><a name="l00869"></a><span class="lineno"> 869</span>  <span class="comment">// for each qubit arrangement, use a new random unitary</span></div>
<div class="line"><a name="l00870"></a><span class="lineno"> 870</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> notOp{{0, 1},{1,0}};</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>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00873"></a><span class="lineno"> 873</span>  </div>
<div class="line"><a name="l00874"></a><span class="lineno"> 874</span>  <a class="code" href="group__unitary.html#gafd81a9217fb7d21c365443442492b2dc">multiControlledMultiQubitNot</a>(quregVec, ctrls, numCtrls, targs, numTargs);</div>
<div class="line"><a name="l00875"></a><span class="lineno"> 875</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> t=0; t<numTargs; t++)</div>
<div class="line"><a name="l00876"></a><span class="lineno"> 876</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, ctrls, numCtrls, targs[t], notOp);</div>
<div class="line"><a name="l00877"></a><span class="lineno"> 877</span>  </div>
<div class="line"><a name="l00878"></a><span class="lineno"> 878</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l00879"></a><span class="lineno"> 879</span>  }</div>
<div class="line"><a name="l00880"></a><span class="lineno"> 880</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00881"></a><span class="lineno"> 881</span>  </div>
<div class="line"><a name="l00882"></a><span class="lineno"> 882</span>  <a class="code" href="group__unitary.html#gafd81a9217fb7d21c365443442492b2dc">multiControlledMultiQubitNot</a>(quregMatr, ctrls, numCtrls, targs, numTargs);</div>
<div class="line"><a name="l00883"></a><span class="lineno"> 883</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> t=0; t<numTargs; t++)</div>
<div class="line"><a name="l00884"></a><span class="lineno"> 884</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, ctrls, numCtrls, targs[t], notOp);</div>
<div class="line"><a name="l00885"></a><span class="lineno"> 885</span>  </div>
<div class="line"><a name="l00886"></a><span class="lineno"> 886</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</div>
<div class="line"><a name="l00887"></a><span class="lineno"> 887</span>  }</div>
<div class="line"><a name="l00888"></a><span class="lineno"> 888</span>  }</div>
<div class="line"><a name="l00889"></a><span class="lineno"> 889</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00890"></a><span class="lineno"> 890</span>  </div>
<div class="line"><a name="l00891"></a><span class="lineno"> 891</span>  SECTION( <span class="stringliteral">"number of targets"</span> ) {</div>
<div class="line"><a name="l00892"></a><span class="lineno"> 892</span>  </div>
<div class="line"><a name="l00893"></a><span class="lineno"> 893</span>  <span class="comment">// there cannot be more targets than qubits in register</span></div>
<div class="line"><a name="l00894"></a><span class="lineno"> 894</span>  <span class="comment">// (numTargs=NUM_QUBITS is caught elsewhere, because that implies ctrls are invalid)</span></div>
<div class="line"><a name="l00895"></a><span class="lineno"> 895</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="l00896"></a><span class="lineno"> 896</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="l00897"></a><span class="lineno"> 897</span>  <span class="keywordtype">int</span> ctrls[] = {0}; </div>
<div class="line"><a name="l00898"></a><span class="lineno"> 898</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gafd81a9217fb7d21c365443442492b2dc">multiControlledMultiQubitNot</a>(quregVec, ctrls, 1, targs, numTargs), Contains(<span class="stringliteral">"Invalid number of target"</span>));</div>
<div class="line"><a name="l00899"></a><span class="lineno"> 899</span>  }</div>
<div class="line"><a name="l00900"></a><span class="lineno"> 900</span>  SECTION( <span class="stringliteral">"repetition in targets"</span> ) {</div>
<div class="line"><a name="l00901"></a><span class="lineno"> 901</span>  </div>
<div class="line"><a name="l00902"></a><span class="lineno"> 902</span>  <span class="keywordtype">int</span> ctrls[] = {0};</div>
<div class="line"><a name="l00903"></a><span class="lineno"> 903</span>  <span class="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l00904"></a><span class="lineno"> 904</span>  <span class="keywordtype">int</span> targs[] = {1,2,2};</div>
<div class="line"><a name="l00905"></a><span class="lineno"> 905</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gafd81a9217fb7d21c365443442492b2dc">multiControlledMultiQubitNot</a>(quregVec, ctrls, 1, targs, numTargs), Contains(<span class="stringliteral">"target"</span>) && Contains(<span class="stringliteral">"unique"</span>));</div>
<div class="line"><a name="l00906"></a><span class="lineno"> 906</span>  }</div>
<div class="line"><a name="l00907"></a><span class="lineno"> 907</span>  SECTION( <span class="stringliteral">"number of controls"</span> ) {</div>
<div class="line"><a name="l00908"></a><span class="lineno"> 908</span>  </div>
<div class="line"><a name="l00909"></a><span class="lineno"> 909</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="l00910"></a><span class="lineno"> 910</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="l00911"></a><span class="lineno"> 911</span>  <span class="keywordtype">int</span> targs[1] = {0};</div>
<div class="line"><a name="l00912"></a><span class="lineno"> 912</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gafd81a9217fb7d21c365443442492b2dc">multiControlledMultiQubitNot</a>(quregVec, ctrls, numCtrls, targs, 1), Contains(<span class="stringliteral">"Invalid number of control"</span>));</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>  SECTION( <span class="stringliteral">"repetition in controls"</span> ) {</div>
<div class="line"><a name="l00915"></a><span class="lineno"> 915</span>  </div>
<div class="line"><a name="l00916"></a><span class="lineno"> 916</span>  <span class="keywordtype">int</span> ctrls[] = {0,1,1};</div>
<div class="line"><a name="l00917"></a><span class="lineno"> 917</span>  <span class="keywordtype">int</span> targs[] = {3};</div>
<div class="line"><a name="l00918"></a><span class="lineno"> 918</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gafd81a9217fb7d21c365443442492b2dc">multiControlledMultiQubitNot</a>(quregVec, ctrls, 3, targs, 1), Contains(<span class="stringliteral">"control"</span>) && Contains(<span class="stringliteral">"unique"</span>));</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>  SECTION( <span class="stringliteral">"control and target collision"</span> ) {</div>
<div class="line"><a name="l00921"></a><span class="lineno"> 921</span>  </div>
<div class="line"><a name="l00922"></a><span class="lineno"> 922</span>  <span class="keywordtype">int</span> ctrls[] = {0,1,2};</div>
<div class="line"><a name="l00923"></a><span class="lineno"> 923</span>  <span class="keywordtype">int</span> targs[] = {3,1,4};</div>
<div class="line"><a name="l00924"></a><span class="lineno"> 924</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gafd81a9217fb7d21c365443442492b2dc">multiControlledMultiQubitNot</a>(quregVec, ctrls, 3, targs, 3), Contains(<span class="stringliteral">"Control"</span>) && Contains(<span class="stringliteral">"target"</span>) && Contains(<span class="stringliteral">"disjoint"</span>));</div>
<div class="line"><a name="l00925"></a><span class="lineno"> 925</span>  }</div>
<div class="line"><a name="l00926"></a><span class="lineno"> 926</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l00927"></a><span class="lineno"> 927</span>  </div>
<div class="line"><a name="l00928"></a><span class="lineno"> 928</span>  <span class="comment">// valid inds</span></div>
<div class="line"><a name="l00929"></a><span class="lineno"> 929</span>  <span class="keywordtype">int</span> numQb = 2;</div>
<div class="line"><a name="l00930"></a><span class="lineno"> 930</span>  <span class="keywordtype">int</span> qb1[2] = {0,1};</div>
<div class="line"><a name="l00931"></a><span class="lineno"> 931</span>  <span class="keywordtype">int</span> qb2[2] = {2,3};</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>  <span class="comment">// make qb1 invalid</span></div>
<div class="line"><a name="l00934"></a><span class="lineno"> 934</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="l00935"></a><span class="lineno"> 935</span>  qb1[GENERATE_COPY(range(0,numQb))] = inv;</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>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gafd81a9217fb7d21c365443442492b2dc">multiControlledMultiQubitNot</a>(quregVec, qb1, numQb, qb2, numQb), Contains(<span class="stringliteral">"Invalid control"</span>) );</div>
<div class="line"><a name="l00938"></a><span class="lineno"> 938</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gafd81a9217fb7d21c365443442492b2dc">multiControlledMultiQubitNot</a>(quregVec, qb2, numQb, qb1, numQb), Contains(<span class="stringliteral">"Invalid target"</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>  }</div>
<div class="line"><a name="l00941"></a><span class="lineno"> 941</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l00942"></a><span class="lineno"> 942</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l00549">multiControlledMultiQubitNot()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, and <a class="el" href="utilities_8cpp_source.html#l01488">sublists()</a>.</p>
</div>
</div>
<a id="ga4a7295ff2f6ab9b0569da7a4f34056fc"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga4a7295ff2f6ab9b0569da7a4f34056fc">◆ </a></span>TEST_CASE() <span class="overload">[94/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"multiControlledMultiQubitUnitary" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#ga3ad6c477edcdbc845fc1143e860fda08" title="Apply a general multi-controlled multi-qubit unitary (including a global phase factor).">multiControlledMultiQubitUnitary</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l00950">950</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><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>  </div>
<div class="line"><a name="l00952"></a><span class="lineno"> 952</span>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</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>  <span class="comment">// figure out max-num targs (inclusive) allowed by hardware backend</span></div>
<div class="line"><a name="l00955"></a><span class="lineno"> 955</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="l00956"></a><span class="lineno"> 956</span>  <span class="keywordflow">if</span> (maxNumTargs >= <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>)</div>
<div class="line"><a name="l00957"></a><span class="lineno"> 957</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="l00958"></a><span class="lineno"> 958</span>  </div>
<div class="line"><a name="l00959"></a><span class="lineno"> 959</span>  SECTION( <span class="stringliteral">"correctness"</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>  <span class="comment">// try all possible numbers of targets and controls</span></div>
<div class="line"><a name="l00962"></a><span class="lineno"> 962</span>  <span class="keywordtype">int</span> numTargs = GENERATE_COPY( range(1,maxNumTargs+1) );</div>
<div class="line"><a name="l00963"></a><span class="lineno"> 963</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="l00964"></a><span class="lineno"> 964</span>  <span class="keywordtype">int</span> numCtrls = GENERATE_COPY( range(1,maxNumCtrls+1) );</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="comment">// generate all possible valid qubit arrangements</span></div>
<div class="line"><a name="l00967"></a><span class="lineno"> 967</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="l00968"></a><span class="lineno"> 968</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="l00969"></a><span class="lineno"> 969</span>  </div>
<div class="line"><a name="l00970"></a><span class="lineno"> 970</span>  <span class="comment">// for each qubit arrangement, use a new random unitary</span></div>
<div class="line"><a name="l00971"></a><span class="lineno"> 971</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op = <a class="code" href="group__testutilities.html#ga1a5e9b668716b91dd8527ce00f7500cf">getRandomUnitary</a>(numTargs);</div>
<div class="line"><a name="l00972"></a><span class="lineno"> 972</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="l00973"></a><span class="lineno"> 973</span>  <a class="code" href="group__testutilities.html#ga7f83695bea7d0332a577bca017dbb03c">toComplexMatrixN</a>(op, matr);</div>
<div class="line"><a name="l00974"></a><span class="lineno"> 974</span>  </div>
<div class="line"><a name="l00975"></a><span class="lineno"> 975</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00976"></a><span class="lineno"> 976</span>  </div>
<div class="line"><a name="l00977"></a><span class="lineno"> 977</span>  <a class="code" href="group__unitary.html#ga3ad6c477edcdbc845fc1143e860fda08">multiControlledMultiQubitUnitary</a>(quregVec, ctrls, numCtrls, targs, numTargs, matr);</div>
<div class="line"><a name="l00978"></a><span class="lineno"> 978</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, ctrls, numCtrls, targs, numTargs, op);</div>
<div class="line"><a name="l00979"></a><span class="lineno"> 979</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</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">"density-matrix"</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>  <a class="code" href="group__unitary.html#ga3ad6c477edcdbc845fc1143e860fda08">multiControlledMultiQubitUnitary</a>(quregMatr, ctrls, numCtrls, targs, numTargs, matr);</div>
<div class="line"><a name="l00984"></a><span class="lineno"> 984</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, ctrls, numCtrls, targs, numTargs, op);</div>
<div class="line"><a name="l00985"></a><span class="lineno"> 985</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 10*REAL_EPS) );</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>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l00988"></a><span class="lineno"> 988</span>  }</div>
<div class="line"><a name="l00989"></a><span class="lineno"> 989</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00990"></a><span class="lineno"> 990</span>  </div>
<div class="line"><a name="l00991"></a><span class="lineno"> 991</span>  SECTION( <span class="stringliteral">"number of targets"</span> ) {</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>  <span class="comment">// there cannot be more targets than qubits in register</span></div>
<div class="line"><a name="l00994"></a><span class="lineno"> 994</span>  <span class="comment">// (numTargs=NUM_QUBITS is caught elsewhere, because that implies ctrls are invalid)</span></div>
<div class="line"><a name="l00995"></a><span class="lineno"> 995</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="l00996"></a><span class="lineno"> 996</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="l00997"></a><span class="lineno"> 997</span>  <span class="keywordtype">int</span> ctrls[] = {0};</div>
<div class="line"><a name="l00998"></a><span class="lineno"> 998</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="l00999"></a><span class="lineno"> 999</span>  <a class="code" href="group__testutilities.html#ga7f83695bea7d0332a577bca017dbb03c">toComplexMatrixN</a>(<a class="code" href="group__testutilities.html#ga1a5e9b668716b91dd8527ce00f7500cf">getRandomUnitary</a>(<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1), matr); <span class="comment">// ensure unitary</span></div>
<div class="line"><a name="l01000"></a><span class="lineno"> 1000</span>  </div>
<div class="line"><a name="l01001"></a><span class="lineno"> 1001</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga3ad6c477edcdbc845fc1143e860fda08">multiControlledMultiQubitUnitary</a>(quregVec, ctrls, 1, targs, numTargs, matr), Contains(<span class="stringliteral">"Invalid number of target"</span>));</div>
<div class="line"><a name="l01002"></a><span class="lineno"> 1002</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</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">"repetition in targets"</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> ctrls[] = {0};</div>
<div class="line"><a name="l01007"></a><span class="lineno"> 1007</span>  <span class="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l01008"></a><span class="lineno"> 1008</span>  <span class="keywordtype">int</span> targs[] = {1,2,2};</div>
<div class="line"><a name="l01009"></a><span class="lineno"> 1009</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="l01010"></a><span class="lineno"> 1010</span>  <a class="code" href="group__testutilities.html#ga7f83695bea7d0332a577bca017dbb03c">toComplexMatrixN</a>(<a class="code" href="group__testutilities.html#ga1a5e9b668716b91dd8527ce00f7500cf">getRandomUnitary</a>(numTargs), matr); <span class="comment">// ensure unitary</span></div>
<div class="line"><a name="l01011"></a><span class="lineno"> 1011</span>  </div>
<div class="line"><a name="l01012"></a><span class="lineno"> 1012</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga3ad6c477edcdbc845fc1143e860fda08">multiControlledMultiQubitUnitary</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="l01013"></a><span class="lineno"> 1013</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</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>  SECTION( <span class="stringliteral">"number of controls"</span> ) {</div>
<div class="line"><a name="l01016"></a><span class="lineno"> 1016</span>  </div>
<div class="line"><a name="l01017"></a><span class="lineno"> 1017</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="l01018"></a><span class="lineno"> 1018</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="l01019"></a><span class="lineno"> 1019</span>  <span class="keywordtype">int</span> targs[1] = {0};</div>
<div class="line"><a name="l01020"></a><span class="lineno"> 1020</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="l01021"></a><span class="lineno"> 1021</span>  <a class="code" href="group__testutilities.html#ga7f83695bea7d0332a577bca017dbb03c">toComplexMatrixN</a>(<a class="code" href="group__testutilities.html#ga1a5e9b668716b91dd8527ce00f7500cf">getRandomUnitary</a>(1), matr); <span class="comment">// ensure unitary</span></div>
<div class="line"><a name="l01022"></a><span class="lineno"> 1022</span>  </div>
<div class="line"><a name="l01023"></a><span class="lineno"> 1023</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga3ad6c477edcdbc845fc1143e860fda08">multiControlledMultiQubitUnitary</a>(quregVec, ctrls, numCtrls, targs, 1, matr), Contains(<span class="stringliteral">"Invalid number of control"</span>));</div>
<div class="line"><a name="l01024"></a><span class="lineno"> 1024</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l01025"></a><span class="lineno"> 1025</span>  }</div>
<div class="line"><a name="l01026"></a><span class="lineno"> 1026</span>  SECTION( <span class="stringliteral">"repetition in controls"</span> ) {</div>
<div class="line"><a name="l01027"></a><span class="lineno"> 1027</span>  </div>
<div class="line"><a name="l01028"></a><span class="lineno"> 1028</span>  <span class="keywordtype">int</span> ctrls[] = {0,1,1};</div>
<div class="line"><a name="l01029"></a><span class="lineno"> 1029</span>  <span class="keywordtype">int</span> targs[] = {3};</div>
<div class="line"><a name="l01030"></a><span class="lineno"> 1030</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="l01031"></a><span class="lineno"> 1031</span>  <a class="code" href="group__testutilities.html#ga7f83695bea7d0332a577bca017dbb03c">toComplexMatrixN</a>(<a class="code" href="group__testutilities.html#ga1a5e9b668716b91dd8527ce00f7500cf">getRandomUnitary</a>(1), matr); <span class="comment">// ensure unitary</span></div>
<div class="line"><a name="l01032"></a><span class="lineno"> 1032</span>  </div>
<div class="line"><a name="l01033"></a><span class="lineno"> 1033</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga3ad6c477edcdbc845fc1143e860fda08">multiControlledMultiQubitUnitary</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="l01034"></a><span class="lineno"> 1034</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l01035"></a><span class="lineno"> 1035</span>  }</div>
<div class="line"><a name="l01036"></a><span class="lineno"> 1036</span>  SECTION( <span class="stringliteral">"control and target collision"</span> ) {</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>  <span class="keywordtype">int</span> ctrls[] = {0,1,2};</div>
<div class="line"><a name="l01039"></a><span class="lineno"> 1039</span>  <span class="keywordtype">int</span> targs[] = {3,1,4};</div>
<div class="line"><a name="l01040"></a><span class="lineno"> 1040</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="l01041"></a><span class="lineno"> 1041</span>  <a class="code" href="group__testutilities.html#ga7f83695bea7d0332a577bca017dbb03c">toComplexMatrixN</a>(<a class="code" href="group__testutilities.html#ga1a5e9b668716b91dd8527ce00f7500cf">getRandomUnitary</a>(3), matr); <span class="comment">// ensure unitary</span></div>
<div class="line"><a name="l01042"></a><span class="lineno"> 1042</span>  </div>
<div class="line"><a name="l01043"></a><span class="lineno"> 1043</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga3ad6c477edcdbc845fc1143e860fda08">multiControlledMultiQubitUnitary</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="l01044"></a><span class="lineno"> 1044</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l01045"></a><span class="lineno"> 1045</span>  }</div>
<div class="line"><a name="l01046"></a><span class="lineno"> 1046</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l01047"></a><span class="lineno"> 1047</span>  </div>
<div class="line"><a name="l01048"></a><span class="lineno"> 1048</span>  <span class="comment">// valid inds</span></div>
<div class="line"><a name="l01049"></a><span class="lineno"> 1049</span>  <span class="keywordtype">int</span> numQb = 2;</div>
<div class="line"><a name="l01050"></a><span class="lineno"> 1050</span>  <span class="keywordtype">int</span> qb1[2] = {0,1};</div>
<div class="line"><a name="l01051"></a><span class="lineno"> 1051</span>  <span class="keywordtype">int</span> qb2[2] = {2,3};</div>
<div class="line"><a name="l01052"></a><span class="lineno"> 1052</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="l01053"></a><span class="lineno"> 1053</span>  <a class="code" href="group__testutilities.html#ga7f83695bea7d0332a577bca017dbb03c">toComplexMatrixN</a>(<a class="code" href="group__testutilities.html#ga1a5e9b668716b91dd8527ce00f7500cf">getRandomUnitary</a>(numQb), matr); <span class="comment">// ensure unitary</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>  <span class="comment">// make qb1 invalid</span></div>
<div class="line"><a name="l01056"></a><span class="lineno"> 1056</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="l01057"></a><span class="lineno"> 1057</span>  qb1[GENERATE_COPY(range(0,numQb))] = inv;</div>
<div class="line"><a name="l01058"></a><span class="lineno"> 1058</span>  </div>
<div class="line"><a name="l01059"></a><span class="lineno"> 1059</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga3ad6c477edcdbc845fc1143e860fda08">multiControlledMultiQubitUnitary</a>(quregVec, qb1, numQb, qb2, numQb, matr), Contains(<span class="stringliteral">"Invalid control"</span>) );</div>
<div class="line"><a name="l01060"></a><span class="lineno"> 1060</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga3ad6c477edcdbc845fc1143e860fda08">multiControlledMultiQubitUnitary</a>(quregVec, qb2, numQb, qb1, numQb, matr), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l01061"></a><span class="lineno"> 1061</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</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>  SECTION( <span class="stringliteral">"unitarity"</span> ) {</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>  <span class="keywordtype">int</span> ctrls[1] = {0};</div>
<div class="line"><a name="l01066"></a><span class="lineno"> 1066</span>  <span class="keywordtype">int</span> numTargs = GENERATE_COPY( range(1,maxNumTargs+1) );</div>
<div class="line"><a name="l01067"></a><span class="lineno"> 1067</span>  <span class="keywordtype">int</span> targs[numTargs];</div>
<div class="line"><a name="l01068"></a><span class="lineno"> 1068</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numTargs; i++)</div>
<div class="line"><a name="l01069"></a><span class="lineno"> 1069</span>  targs[i] = i+1;</div>
<div class="line"><a name="l01070"></a><span class="lineno"> 1070</span>  </div>
<div class="line"><a name="l01071"></a><span class="lineno"> 1071</span>  <a class="code" href="structComplexMatrixN.html">ComplexMatrixN</a> matr = <a class="code" href="group__type.html#ga815103261fb22ea9690e1427571df00e">createComplexMatrixN</a>(numTargs); <span class="comment">// initially zero, hence not-unitary</span></div>
<div class="line"><a name="l01072"></a><span class="lineno"> 1072</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga3ad6c477edcdbc845fc1143e860fda08">multiControlledMultiQubitUnitary</a>(quregVec, ctrls, 1, targs, numTargs, matr), Contains(<span class="stringliteral">"unitary"</span>) );</div>
<div class="line"><a name="l01073"></a><span class="lineno"> 1073</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l01074"></a><span class="lineno"> 1074</span>  }</div>
<div class="line"><a name="l01075"></a><span class="lineno"> 1075</span>  SECTION( <span class="stringliteral">"unitary creation"</span> ) {</div>
<div class="line"><a name="l01076"></a><span class="lineno"> 1076</span>  </div>
<div class="line"><a name="l01077"></a><span class="lineno"> 1077</span>  <span class="keywordtype">int</span> ctrls[1] = {0};</div>
<div class="line"><a name="l01078"></a><span class="lineno"> 1078</span>  <span class="keywordtype">int</span> targs[3] = {1,2,3};</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">/* compilers don't auto-initialise to NULL; the below circumstance </span></div>
<div class="line"><a name="l01081"></a><span class="lineno"> 1081</span> <span class="comment"> * only really occurs when 'malloc' returns NULL in createComplexMatrixN, </span></div>
<div class="line"><a name="l01082"></a><span class="lineno"> 1082</span> <span class="comment"> * which actually triggers its own validation. Hence this test is useless </span></div>
<div class="line"><a name="l01083"></a><span class="lineno"> 1083</span> <span class="comment"> * currently.</span></div>
<div class="line"><a name="l01084"></a><span class="lineno"> 1084</span> <span class="comment"> */</span></div>
<div class="line"><a name="l01085"></a><span class="lineno"> 1085</span>  <a class="code" href="structComplexMatrixN.html">ComplexMatrixN</a> matr;</div>
<div class="line"><a name="l01086"></a><span class="lineno"> 1086</span>  matr.<a class="code" href="structComplexMatrixN.html#a446e8a077597e4f76049d547df0c9738">real</a> = NULL;</div>
<div class="line"><a name="l01087"></a><span class="lineno"> 1087</span>  matr.<a class="code" href="structComplexMatrixN.html#afde13e469a3b4f179f45e53d1ec0a7cf">imag</a> = NULL; </div>
<div class="line"><a name="l01088"></a><span class="lineno"> 1088</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga3ad6c477edcdbc845fc1143e860fda08">multiControlledMultiQubitUnitary</a>(quregVec, ctrls, 1, targs, 3, matr), Contains(<span class="stringliteral">"created"</span>) );</div>
<div class="line"><a name="l01089"></a><span class="lineno"> 1089</span>  }</div>
<div class="line"><a name="l01090"></a><span class="lineno"> 1090</span>  SECTION( <span class="stringliteral">"unitary dimensions"</span> ) {</div>
<div class="line"><a name="l01091"></a><span class="lineno"> 1091</span>  </div>
<div class="line"><a name="l01092"></a><span class="lineno"> 1092</span>  <span class="keywordtype">int</span> ctrls[1] = {0};</div>
<div class="line"><a name="l01093"></a><span class="lineno"> 1093</span>  <span class="keywordtype">int</span> targs[2] = {1,2};</div>
<div class="line"><a name="l01094"></a><span class="lineno"> 1094</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="l01095"></a><span class="lineno"> 1095</span>  <a class="code" href="group__testutilities.html#ga7f83695bea7d0332a577bca017dbb03c">toComplexMatrixN</a>(<a class="code" href="group__testutilities.html#ga1a5e9b668716b91dd8527ce00f7500cf">getRandomUnitary</a>(3), matr); <span class="comment">// ensure unitary</span></div>
<div class="line"><a name="l01096"></a><span class="lineno"> 1096</span>  </div>
<div class="line"><a name="l01097"></a><span class="lineno"> 1097</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga3ad6c477edcdbc845fc1143e860fda08">multiControlledMultiQubitUnitary</a>(quregVec, ctrls, 1, targs, 2, matr), Contains(<span class="stringliteral">"matrix size"</span>));</div>
<div class="line"><a name="l01098"></a><span class="lineno"> 1098</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l01099"></a><span class="lineno"> 1099</span>  }</div>
<div class="line"><a name="l01100"></a><span class="lineno"> 1100</span>  SECTION( <span class="stringliteral">"unitary fits in node"</span> ) {</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="comment">// pretend we have a very limited distributed memory (judged by matr size)</span></div>
<div class="line"><a name="l01103"></a><span class="lineno"> 1103</span>  quregVec.numAmpsPerChunk = 1;</div>
<div class="line"><a name="l01104"></a><span class="lineno"> 1104</span>  <span class="keywordtype">int</span> ctrls[1] = {0};</div>
<div class="line"><a name="l01105"></a><span class="lineno"> 1105</span>  <span class="keywordtype">int</span> targs[2] = {1,2};</div>
<div class="line"><a name="l01106"></a><span class="lineno"> 1106</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="l01107"></a><span class="lineno"> 1107</span>  <a class="code" href="group__testutilities.html#ga7f83695bea7d0332a577bca017dbb03c">toComplexMatrixN</a>(<a class="code" href="group__testutilities.html#ga1a5e9b668716b91dd8527ce00f7500cf">getRandomUnitary</a>(2), matr); <span class="comment">// ensure unitary</span></div>
<div class="line"><a name="l01108"></a><span class="lineno"> 1108</span>  </div>
<div class="line"><a name="l01109"></a><span class="lineno"> 1109</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga3ad6c477edcdbc845fc1143e860fda08">multiControlledMultiQubitUnitary</a>(quregVec, ctrls, 1, targs, 2, matr), Contains(<span class="stringliteral">"targets too many qubits"</span>));</div>
<div class="line"><a name="l01110"></a><span class="lineno"> 1110</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</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>  }</div>
<div class="line"><a name="l01113"></a><span class="lineno"> 1113</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l01114"></a><span class="lineno"> 1114</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST__validation_8c_source.html#l00328">calcLog2()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l01348">createComplexMatrixN()</a>, <a class="el" href="QuEST_8c_source.html#l01369">destroyComplexMatrixN()</a>, <a class="el" href="utilities_8cpp_source.html#l00530">getRandomUnitary()</a>, <a class="el" href="QuEST_8h_source.html#l00190">ComplexMatrixN::imag</a>, <a class="el" href="QuEST_8c_source.html#l00330">multiControlledMultiQubitUnitary()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, <a class="el" href="QuEST_8h_source.html#l00189">ComplexMatrixN::real</a>, <a class="el" href="utilities_8cpp_source.html#l01488">sublists()</a>, and <a class="el" href="utilities_8cpp_source.html#l01033">toComplexMatrixN()</a>.</p>
</div>
</div>
<a id="ga5274be4471e8361ea91a59600a21f07e"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga5274be4471e8361ea91a59600a21f07e">◆ </a></span>TEST_CASE() <span class="overload">[95/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"multiControlledMultiRotatePauli" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#gab2ececaa253252e1b1cdb18a8452704a" title="Apply a multi-controlled multi-target multi-Pauli rotation, also known as a controlled Pauli gadget.">multiControlledMultiRotatePauli</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l01122">1122</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l01122"></a><span class="lineno"> 1122</span>  {</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>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l01125"></a><span class="lineno"> 1125</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> param = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-4*<a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>, 4*<a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>);</div>
<div class="line"><a name="l01126"></a><span class="lineno"> 1126</span>  </div>
<div class="line"><a name="l01127"></a><span class="lineno"> 1127</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l01128"></a><span class="lineno"> 1128</span>  </div>
<div class="line"><a name="l01129"></a><span class="lineno"> 1129</span>  <span class="comment">// try all possible numbers of targets and controls</span></div>
<div class="line"><a name="l01130"></a><span class="lineno"> 1130</span>  <span class="keywordtype">int</span> numTargs = GENERATE_COPY( range(1,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) ); <span class="comment">// leave space for min 1 control qubit</span></div>
<div class="line"><a name="l01131"></a><span class="lineno"> 1131</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="l01132"></a><span class="lineno"> 1132</span>  <span class="keywordtype">int</span> numCtrls = GENERATE_COPY( range(1,maxNumCtrls+1) );</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="comment">// generate all possible valid qubit arrangements</span></div>
<div class="line"><a name="l01135"></a><span class="lineno"> 1135</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="l01136"></a><span class="lineno"> 1136</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="l01137"></a><span class="lineno"> 1137</span>  </div>
<div class="line"><a name="l01138"></a><span class="lineno"> 1138</span>  <span class="comment">/* it's too expensive to try ALL Pauli sequences, via </span></div>
<div class="line"><a name="l01139"></a><span class="lineno"> 1139</span> <span class="comment"> * pauliOpType* paulis = GENERATE_COPY( pauliseqs(numTargs) );.</span></div>
<div class="line"><a name="l01140"></a><span class="lineno"> 1140</span> <span class="comment"> * Furthermore, take(10, pauliseqs(numTargs)) will try the same pauli codes.</span></div>
<div class="line"><a name="l01141"></a><span class="lineno"> 1141</span> <span class="comment"> * Hence, we instead opt to randomly generate pauliseqs</span></div>
<div class="line"><a name="l01142"></a><span class="lineno"> 1142</span> <span class="comment"> */</span></div>
<div class="line"><a name="l01143"></a><span class="lineno"> 1143</span>  <a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a> paulis[numTargs];</div>
<div class="line"><a name="l01144"></a><span class="lineno"> 1144</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numTargs; i++)</div>
<div class="line"><a name="l01145"></a><span class="lineno"> 1145</span>  paulis[i] = (<a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a>) <a class="code" href="group__testutilities.html#ga7125d0747a44db58115899727ac5f6be">getRandomInt</a>(0,4);</div>
<div class="line"><a name="l01146"></a><span class="lineno"> 1146</span>  </div>
<div class="line"><a name="l01147"></a><span class="lineno"> 1147</span>  <span class="comment">// exclude identities from reference matrix exp (they apply unwanted global phase)</span></div>
<div class="line"><a name="l01148"></a><span class="lineno"> 1148</span>  <span class="keywordtype">int</span> refTargs[numTargs];</div>
<div class="line"><a name="l01149"></a><span class="lineno"> 1149</span>  <span class="keywordtype">int</span> numRefTargs = 0;</div>
<div class="line"><a name="l01150"></a><span class="lineno"> 1150</span>  </div>
<div class="line"><a name="l01151"></a><span class="lineno"> 1151</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> xMatr{{0,1},{1,0}};</div>
<div class="line"><a name="l01152"></a><span class="lineno"> 1152</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> yMatr{{0,-<a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>(0,1)},{<a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>(0,1),0}};</div>
<div class="line"><a name="l01153"></a><span class="lineno"> 1153</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> zMatr{{1,0},{0,-1}};</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>  <span class="comment">// build correct reference matrix by pauli-matrix exponentiation...</span></div>
<div class="line"><a name="l01156"></a><span class="lineno"> 1156</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> pauliProd{{1}};</div>
<div class="line"><a name="l01157"></a><span class="lineno"> 1157</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numTargs; i++) {</div>
<div class="line"><a name="l01158"></a><span class="lineno"> 1158</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> fac;</div>
<div class="line"><a name="l01159"></a><span class="lineno"> 1159</span>  <span class="keywordflow">if</span> (paulis[i] == <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a63800f45b01ccc2608f754aee850bf4a">PAULI_I</a>) <span class="keywordflow">continue</span>; <span class="comment">// exclude I-targets from ref list</span></div>
<div class="line"><a name="l01160"></a><span class="lineno"> 1160</span>  <span class="keywordflow">if</span> (paulis[i] == <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a7abac7bb5b71e17382014c443244ad5c">PAULI_X</a>) fac = xMatr;</div>
<div class="line"><a name="l01161"></a><span class="lineno"> 1161</span>  <span class="keywordflow">if</span> (paulis[i] == <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a2c64a9aaee27f6bcfef894d159e759bd">PAULI_Y</a>) fac = yMatr;</div>
<div class="line"><a name="l01162"></a><span class="lineno"> 1162</span>  <span class="keywordflow">if</span> (paulis[i] == <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a085c85cff6ba79c52d8b1e61c42ddddf">PAULI_Z</a>) fac = zMatr;</div>
<div class="line"><a name="l01163"></a><span class="lineno"> 1163</span>  pauliProd = <a class="code" href="group__testutilities.html#gab5ac6842ba67b8d38bd17385ab179b67">getKroneckerProduct</a>(fac, pauliProd);</div>
<div class="line"><a name="l01164"></a><span class="lineno"> 1164</span>  </div>
<div class="line"><a name="l01165"></a><span class="lineno"> 1165</span>  <span class="comment">// include this target in ref list</span></div>
<div class="line"><a name="l01166"></a><span class="lineno"> 1166</span>  refTargs[numRefTargs++] = targs[i];</div>
<div class="line"><a name="l01167"></a><span class="lineno"> 1167</span>  }</div>
<div class="line"><a name="l01168"></a><span class="lineno"> 1168</span>  </div>
<div class="line"><a name="l01169"></a><span class="lineno"> 1169</span>  <span class="comment">// produces exp(-i param/2 pauliProd), unless pauliProd = I</span></div>
<div class="line"><a name="l01170"></a><span class="lineno"> 1170</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op;</div>
<div class="line"><a name="l01171"></a><span class="lineno"> 1171</span>  <span class="keywordflow">if</span> (numRefTargs > 0)</div>
<div class="line"><a name="l01172"></a><span class="lineno"> 1172</span>  op = <a class="code" href="group__testutilities.html#ga00f4feec845c019c3390898b0cc7f1ef">getExponentialOfPauliMatrix</a>(param, pauliProd);</div>
<div class="line"><a name="l01173"></a><span class="lineno"> 1173</span>  </div>
<div class="line"><a name="l01174"></a><span class="lineno"> 1174</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</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>  <a class="code" href="group__unitary.html#gab2ececaa253252e1b1cdb18a8452704a">multiControlledMultiRotatePauli</a>(quregVec, ctrls, numCtrls, targs, paulis, numTargs, param);</div>
<div class="line"><a name="l01177"></a><span class="lineno"> 1177</span>  <span class="keywordflow">if</span> (numRefTargs > 0)</div>
<div class="line"><a name="l01178"></a><span class="lineno"> 1178</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, ctrls, numCtrls, refTargs, numRefTargs, op);</div>
<div class="line"><a name="l01179"></a><span class="lineno"> 1179</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l01180"></a><span class="lineno"> 1180</span>  }</div>
<div class="line"><a name="l01181"></a><span class="lineno"> 1181</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01182"></a><span class="lineno"> 1182</span>  </div>
<div class="line"><a name="l01183"></a><span class="lineno"> 1183</span>  <a class="code" href="group__unitary.html#gab2ececaa253252e1b1cdb18a8452704a">multiControlledMultiRotatePauli</a>(quregMatr, ctrls, numCtrls, targs, paulis, numTargs, param);</div>
<div class="line"><a name="l01184"></a><span class="lineno"> 1184</span>  <span class="keywordflow">if</span> (numRefTargs > 0)</div>
<div class="line"><a name="l01185"></a><span class="lineno"> 1185</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, ctrls, numCtrls, refTargs, numRefTargs, op);</div>
<div class="line"><a name="l01186"></a><span class="lineno"> 1186</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 10*REAL_EPS) );</div>
<div class="line"><a name="l01187"></a><span class="lineno"> 1187</span>  }</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>  SECTION( <span class="stringliteral">"input validation"</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>  <span class="comment">// test all validation on both state-vector and density-matrix.</span></div>
<div class="line"><a name="l01192"></a><span class="lineno"> 1192</span>  <span class="comment">// want GENERATE_COPY( quregVec, quregMatr ), but too lazy to patch</span></div>
<div class="line"><a name="l01193"></a><span class="lineno"> 1193</span>  <span class="comment">// using github.com/catchorg/Catch2/issues/1809</span></div>
<div class="line"><a name="l01194"></a><span class="lineno"> 1194</span>  <a class="code" href="structQureg.html">Qureg</a> regs[] = {quregVec, quregMatr};</div>
<div class="line"><a name="l01195"></a><span class="lineno"> 1195</span>  <a class="code" href="structQureg.html">Qureg</a> qureg = regs[GENERATE(0,1)];</div>
<div class="line"><a name="l01196"></a><span class="lineno"> 1196</span>  </div>
<div class="line"><a name="l01197"></a><span class="lineno"> 1197</span>  <span class="comment">// over-sized array to prevent seg-fault in case of validation fail below</span></div>
<div class="line"><a name="l01198"></a><span class="lineno"> 1198</span>  <a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a> paulis[<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1];</div>
<div class="line"><a name="l01199"></a><span class="lineno"> 1199</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> q=0; q<<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1; q++)</div>
<div class="line"><a name="l01200"></a><span class="lineno"> 1200</span>  paulis[q] = <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a63800f45b01ccc2608f754aee850bf4a">PAULI_I</a>;</div>
<div class="line"><a name="l01201"></a><span class="lineno"> 1201</span>  </div>
<div class="line"><a name="l01202"></a><span class="lineno"> 1202</span>  SECTION( <span class="stringliteral">"pauli codes"</span> ) {</div>
<div class="line"><a name="l01203"></a><span class="lineno"> 1203</span>  </div>
<div class="line"><a name="l01204"></a><span class="lineno"> 1204</span>  <span class="keywordtype">int</span> numCtrls = 1;</div>
<div class="line"><a name="l01205"></a><span class="lineno"> 1205</span>  <span class="keywordtype">int</span> ctrls[] = {3};</div>
<div class="line"><a name="l01206"></a><span class="lineno"> 1206</span>  <span class="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l01207"></a><span class="lineno"> 1207</span>  <span class="keywordtype">int</span> targs[3] = {0, 1, 2};</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>  <span class="comment">// make a single Pauli invalid</span></div>
<div class="line"><a name="l01210"></a><span class="lineno"> 1210</span>  paulis[GENERATE_COPY(range(0,numTargs))] = (<a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a>) GENERATE( -1, 4 );</div>
<div class="line"><a name="l01211"></a><span class="lineno"> 1211</span>  </div>
<div class="line"><a name="l01212"></a><span class="lineno"> 1212</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gab2ececaa253252e1b1cdb18a8452704a">multiControlledMultiRotatePauli</a>(qureg, ctrls, numCtrls, targs, paulis, numTargs, param), Contains(<span class="stringliteral">"Invalid Pauli code"</span>));</div>
<div class="line"><a name="l01213"></a><span class="lineno"> 1213</span>  }</div>
<div class="line"><a name="l01214"></a><span class="lineno"> 1214</span>  SECTION( <span class="stringliteral">"number of targets"</span> ) {</div>
<div class="line"><a name="l01215"></a><span class="lineno"> 1215</span>  </div>
<div class="line"><a name="l01216"></a><span class="lineno"> 1216</span>  <span class="comment">// there cannot be more targets than qubits in register</span></div>
<div class="line"><a name="l01217"></a><span class="lineno"> 1217</span>  <span class="comment">// (numTargs=NUM_QUBITS is caught elsewhere, because that implies ctrls are invalid)</span></div>
<div class="line"><a name="l01218"></a><span class="lineno"> 1218</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="l01219"></a><span class="lineno"> 1219</span>  <span class="keywordtype">int</span> numCtrls = 1;</div>
<div class="line"><a name="l01220"></a><span class="lineno"> 1220</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="l01221"></a><span class="lineno"> 1221</span>  <span class="keywordtype">int</span> ctrls[] = {0};</div>
<div class="line"><a name="l01222"></a><span class="lineno"> 1222</span>  </div>
<div class="line"><a name="l01223"></a><span class="lineno"> 1223</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gab2ececaa253252e1b1cdb18a8452704a">multiControlledMultiRotatePauli</a>(qureg, ctrls, numCtrls, targs, paulis, numTargs, param), Contains(<span class="stringliteral">"Invalid number of target"</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 in targets"</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>  <span class="keywordtype">int</span> numCtrls = 1;</div>
<div class="line"><a name="l01228"></a><span class="lineno"> 1228</span>  <span class="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l01229"></a><span class="lineno"> 1229</span>  <span class="keywordtype">int</span> ctrls[] = {0};</div>
<div class="line"><a name="l01230"></a><span class="lineno"> 1230</span>  <span class="keywordtype">int</span> targs[] = {1,2,2};</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>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gab2ececaa253252e1b1cdb18a8452704a">multiControlledMultiRotatePauli</a>(qureg, ctrls, numCtrls, targs, paulis, numTargs, param), Contains(<span class="stringliteral">"target"</span>) && Contains(<span class="stringliteral">"unique"</span>));</div>
<div class="line"><a name="l01233"></a><span class="lineno"> 1233</span>  }</div>
<div class="line"><a name="l01234"></a><span class="lineno"> 1234</span>  SECTION( <span class="stringliteral">"number of controls"</span> ) {</div>
<div class="line"><a name="l01235"></a><span class="lineno"> 1235</span>  </div>
<div class="line"><a name="l01236"></a><span class="lineno"> 1236</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="l01237"></a><span class="lineno"> 1237</span>  <span class="keywordtype">int</span> numTargs = 1;</div>
<div class="line"><a name="l01238"></a><span class="lineno"> 1238</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="l01239"></a><span class="lineno"> 1239</span>  <span class="keywordtype">int</span> targs[1] = {0};</div>
<div class="line"><a name="l01240"></a><span class="lineno"> 1240</span>  </div>
<div class="line"><a name="l01241"></a><span class="lineno"> 1241</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gab2ececaa253252e1b1cdb18a8452704a">multiControlledMultiRotatePauli</a>(qureg, ctrls, numCtrls, targs, paulis, numTargs, param), Contains(<span class="stringliteral">"Invalid number of control"</span>));</div>
<div class="line"><a name="l01242"></a><span class="lineno"> 1242</span>  }</div>
<div class="line"><a name="l01243"></a><span class="lineno"> 1243</span>  SECTION( <span class="stringliteral">"repetition in controls"</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>  <span class="keywordtype">int</span> numCtrls = 3;</div>
<div class="line"><a name="l01246"></a><span class="lineno"> 1246</span>  <span class="keywordtype">int</span> numTargs = 1;</div>
<div class="line"><a name="l01247"></a><span class="lineno"> 1247</span>  <span class="keywordtype">int</span> ctrls[] = {0,1,1};</div>
<div class="line"><a name="l01248"></a><span class="lineno"> 1248</span>  <span class="keywordtype">int</span> targs[] = {3};</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>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gab2ececaa253252e1b1cdb18a8452704a">multiControlledMultiRotatePauli</a>(qureg, ctrls, numCtrls, targs, paulis, numTargs, param), Contains(<span class="stringliteral">"control"</span>) && Contains(<span class="stringliteral">"unique"</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>  SECTION( <span class="stringliteral">"control and target collision"</span> ) {</div>
<div class="line"><a name="l01253"></a><span class="lineno"> 1253</span>  </div>
<div class="line"><a name="l01254"></a><span class="lineno"> 1254</span>  <span class="keywordtype">int</span> numCtrls = 3;</div>
<div class="line"><a name="l01255"></a><span class="lineno"> 1255</span>  <span class="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l01256"></a><span class="lineno"> 1256</span>  <span class="keywordtype">int</span> ctrls[] = {0,1,2};</div>
<div class="line"><a name="l01257"></a><span class="lineno"> 1257</span>  <span class="keywordtype">int</span> targs[] = {3,1,4};</div>
<div class="line"><a name="l01258"></a><span class="lineno"> 1258</span>  </div>
<div class="line"><a name="l01259"></a><span class="lineno"> 1259</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gab2ececaa253252e1b1cdb18a8452704a">multiControlledMultiRotatePauli</a>(qureg, ctrls, numCtrls, targs, paulis, numTargs, param), Contains(<span class="stringliteral">"Control"</span>) && Contains(<span class="stringliteral">"target"</span>) && Contains(<span class="stringliteral">"disjoint"</span>));</div>
<div class="line"><a name="l01260"></a><span class="lineno"> 1260</span>  }</div>
<div class="line"><a name="l01261"></a><span class="lineno"> 1261</span>  SECTION( <span class="stringliteral">"qubit indices"</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>  <span class="comment">// valid inds</span></div>
<div class="line"><a name="l01264"></a><span class="lineno"> 1264</span>  <span class="keywordtype">int</span> numQb = 2;</div>
<div class="line"><a name="l01265"></a><span class="lineno"> 1265</span>  <span class="keywordtype">int</span> qb1[2] = {0,1};</div>
<div class="line"><a name="l01266"></a><span class="lineno"> 1266</span>  <span class="keywordtype">int</span> qb2[2] = {2,3};</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>  <span class="comment">// make qb1 invalid</span></div>
<div class="line"><a name="l01269"></a><span class="lineno"> 1269</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="l01270"></a><span class="lineno"> 1270</span>  qb1[GENERATE_COPY(range(0,numQb))] = inv;</div>
<div class="line"><a name="l01271"></a><span class="lineno"> 1271</span>  </div>
<div class="line"><a name="l01272"></a><span class="lineno"> 1272</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gab2ececaa253252e1b1cdb18a8452704a">multiControlledMultiRotatePauli</a>(qureg, qb1, numQb, qb2, paulis, numQb, param), Contains(<span class="stringliteral">"Invalid control"</span>) );</div>
<div class="line"><a name="l01273"></a><span class="lineno"> 1273</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gab2ececaa253252e1b1cdb18a8452704a">multiControlledMultiRotatePauli</a>(qureg, qb2, numQb, qb1, paulis, numQb, param), Contains(<span class="stringliteral">"Invalid target"</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>  }</div>
<div class="line"><a name="l01276"></a><span class="lineno"> 1276</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l01277"></a><span class="lineno"> 1277</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00216">getExponentialOfPauliMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00143">getKroneckerProduct()</a>, <a class="el" href="utilities_8cpp_source.html#l00526">getRandomInt()</a>, <a class="el" href="utilities_8cpp_source.html#l00421">getRandomReal()</a>, <a class="el" href="QuEST__common_8c_source.html#l00041">M_PI</a>, <a class="el" href="QuEST_8c_source.html#l00705">multiControlledMultiRotatePauli()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="QuEST_8h_source.html#l00096">PAULI_I</a>, <a class="el" href="QuEST_8h_source.html#l00096">PAULI_X</a>, <a class="el" href="QuEST_8h_source.html#l00096">PAULI_Y</a>, <a class="el" href="QuEST_8h_source.html#l00096">PAULI_Z</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, <a class="el" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, and <a class="el" href="utilities_8cpp_source.html#l01488">sublists()</a>.</p>
</div>
</div>
<a id="gaa0575f97da20b2ccb7e755d7e5b02ca4"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaa0575f97da20b2ccb7e755d7e5b02ca4">◆ </a></span>TEST_CASE() <span class="overload">[96/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"multiControlledMultiRotateZ" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#ga1e5dd165b402e97abaa0b807026527f2" title="Apply a multi-controlled multi-target Z rotation, also known as a controlled phase gadget.">multiControlledMultiRotateZ</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l01285">1285</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l01285"></a><span class="lineno"> 1285</span>  {</div>
<div class="line"><a name="l01286"></a><span class="lineno"> 1286</span>  </div>
<div class="line"><a name="l01287"></a><span class="lineno"> 1287</span>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l01288"></a><span class="lineno"> 1288</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> param = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-4*<a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>, 4*<a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>);</div>
<div class="line"><a name="l01289"></a><span class="lineno"> 1289</span>  </div>
<div class="line"><a name="l01290"></a><span class="lineno"> 1290</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</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 all possible numbers of targets and controls</span></div>
<div class="line"><a name="l01293"></a><span class="lineno"> 1293</span>  <span class="keywordtype">int</span> numTargs = GENERATE_COPY( range(1,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) ); <span class="comment">// leave space for min 1 control qubit</span></div>
<div class="line"><a name="l01294"></a><span class="lineno"> 1294</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="l01295"></a><span class="lineno"> 1295</span>  <span class="keywordtype">int</span> numCtrls = GENERATE_COPY( range(1,maxNumCtrls+1) );</div>
<div class="line"><a name="l01296"></a><span class="lineno"> 1296</span>  </div>
<div class="line"><a name="l01297"></a><span class="lineno"> 1297</span>  <span class="comment">// generate all possible valid qubit arrangements</span></div>
<div class="line"><a name="l01298"></a><span class="lineno"> 1298</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="l01299"></a><span class="lineno"> 1299</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="l01300"></a><span class="lineno"> 1300</span>  </div>
<div class="line"><a name="l01301"></a><span class="lineno"> 1301</span>  <span class="comment">// build correct reference matrix by diagonal-matrix exponentiation...</span></div>
<div class="line"><a name="l01302"></a><span class="lineno"> 1302</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> zMatr{{1,0},{0,-1}};</div>
<div class="line"><a name="l01303"></a><span class="lineno"> 1303</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> zProd = zMatr;</div>
<div class="line"><a name="l01304"></a><span class="lineno"> 1304</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> t=0; t<numTargs-1; t++)</div>
<div class="line"><a name="l01305"></a><span class="lineno"> 1305</span>  zProd = <a class="code" href="group__testutilities.html#gab5ac6842ba67b8d38bd17385ab179b67">getKroneckerProduct</a>(zMatr, zProd); <span class="comment">// Z . Z ... Z</span></div>
<div class="line"><a name="l01306"></a><span class="lineno"> 1306</span>  </div>
<div class="line"><a name="l01307"></a><span class="lineno"> 1307</span>  <span class="comment">// exp( -i param/2 Z . Z ... Z) </span></div>
<div class="line"><a name="l01308"></a><span class="lineno"> 1308</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op = <a class="code" href="group__testutilities.html#gac60cee26113732c491f21dc43066b605">getExponentialOfDiagonalMatrix</a>(<a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>(0, -param/2) * zProd);</div>
<div class="line"><a name="l01309"></a><span class="lineno"> 1309</span>  </div>
<div class="line"><a name="l01310"></a><span class="lineno"> 1310</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l01311"></a><span class="lineno"> 1311</span>  </div>
<div class="line"><a name="l01312"></a><span class="lineno"> 1312</span>  <a class="code" href="group__unitary.html#ga1e5dd165b402e97abaa0b807026527f2">multiControlledMultiRotateZ</a>(quregVec, ctrls, numCtrls, targs, numTargs, param);</div>
<div class="line"><a name="l01313"></a><span class="lineno"> 1313</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, ctrls, numCtrls, targs, numTargs, op);</div>
<div class="line"><a name="l01314"></a><span class="lineno"> 1314</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l01315"></a><span class="lineno"> 1315</span>  }</div>
<div class="line"><a name="l01316"></a><span class="lineno"> 1316</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</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>  <a class="code" href="group__unitary.html#ga1e5dd165b402e97abaa0b807026527f2">multiControlledMultiRotateZ</a>(quregMatr, ctrls, numCtrls, targs, numTargs, param);</div>
<div class="line"><a name="l01319"></a><span class="lineno"> 1319</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, ctrls, numCtrls, targs, numTargs, op);</div>
<div class="line"><a name="l01320"></a><span class="lineno"> 1320</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 2*REAL_EPS) );</div>
<div class="line"><a name="l01321"></a><span class="lineno"> 1321</span>  }</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>  SECTION( <span class="stringliteral">"input validation"</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">// test all validation on both state-vector and density-matrix.</span></div>
<div class="line"><a name="l01326"></a><span class="lineno"> 1326</span>  <span class="comment">// want GENERATE_COPY( quregVec, quregMatr ), but too lazy to patch</span></div>
<div class="line"><a name="l01327"></a><span class="lineno"> 1327</span>  <span class="comment">// using github.com/catchorg/Catch2/issues/1809</span></div>
<div class="line"><a name="l01328"></a><span class="lineno"> 1328</span>  <a class="code" href="structQureg.html">Qureg</a> regs[] = {quregVec, quregMatr};</div>
<div class="line"><a name="l01329"></a><span class="lineno"> 1329</span>  <a class="code" href="structQureg.html">Qureg</a> qureg = regs[GENERATE(0,1)];</div>
<div class="line"><a name="l01330"></a><span class="lineno"> 1330</span>  </div>
<div class="line"><a name="l01331"></a><span class="lineno"> 1331</span>  SECTION( <span class="stringliteral">"number of targets"</span> ) {</div>
<div class="line"><a name="l01332"></a><span class="lineno"> 1332</span>  </div>
<div class="line"><a name="l01333"></a><span class="lineno"> 1333</span>  <span class="comment">// there cannot be more targets than qubits in register</span></div>
<div class="line"><a name="l01334"></a><span class="lineno"> 1334</span>  <span class="comment">// (numTargs=NUM_QUBITS is caught elsewhere, because that implies ctrls are invalid)</span></div>
<div class="line"><a name="l01335"></a><span class="lineno"> 1335</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="l01336"></a><span class="lineno"> 1336</span>  <span class="keywordtype">int</span> numCtrls = 1;</div>
<div class="line"><a name="l01337"></a><span class="lineno"> 1337</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="l01338"></a><span class="lineno"> 1338</span>  <span class="keywordtype">int</span> ctrls[] = {0};</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>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga1e5dd165b402e97abaa0b807026527f2">multiControlledMultiRotateZ</a>(qureg, ctrls, numCtrls, targs, numTargs, param), Contains(<span class="stringliteral">"Invalid number of target"</span>) );</div>
<div class="line"><a name="l01341"></a><span class="lineno"> 1341</span>  }</div>
<div class="line"><a name="l01342"></a><span class="lineno"> 1342</span>  SECTION( <span class="stringliteral">"repetition in targets"</span> ) {</div>
<div class="line"><a name="l01343"></a><span class="lineno"> 1343</span>  </div>
<div class="line"><a name="l01344"></a><span class="lineno"> 1344</span>  <span class="keywordtype">int</span> numCtrls = 1;</div>
<div class="line"><a name="l01345"></a><span class="lineno"> 1345</span>  <span class="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l01346"></a><span class="lineno"> 1346</span>  <span class="keywordtype">int</span> ctrls[] = {0};</div>
<div class="line"><a name="l01347"></a><span class="lineno"> 1347</span>  <span class="keywordtype">int</span> targs[] = {1,2,2};</div>
<div class="line"><a name="l01348"></a><span class="lineno"> 1348</span>  </div>
<div class="line"><a name="l01349"></a><span class="lineno"> 1349</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga1e5dd165b402e97abaa0b807026527f2">multiControlledMultiRotateZ</a>(qureg, ctrls, numCtrls, targs, numTargs, param), Contains(<span class="stringliteral">"target"</span>) && Contains(<span class="stringliteral">"unique"</span>));</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>  SECTION( <span class="stringliteral">"number of controls"</span> ) {</div>
<div class="line"><a name="l01352"></a><span class="lineno"> 1352</span>  </div>
<div class="line"><a name="l01353"></a><span class="lineno"> 1353</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="l01354"></a><span class="lineno"> 1354</span>  <span class="keywordtype">int</span> numTargs = 1;</div>
<div class="line"><a name="l01355"></a><span class="lineno"> 1355</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="l01356"></a><span class="lineno"> 1356</span>  <span class="keywordtype">int</span> targs[1] = {0};</div>
<div class="line"><a name="l01357"></a><span class="lineno"> 1357</span>  </div>
<div class="line"><a name="l01358"></a><span class="lineno"> 1358</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga1e5dd165b402e97abaa0b807026527f2">multiControlledMultiRotateZ</a>(qureg, ctrls, numCtrls, targs, numTargs, param), Contains(<span class="stringliteral">"Invalid number of control"</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>  SECTION( <span class="stringliteral">"repetition in controls"</span> ) {</div>
<div class="line"><a name="l01361"></a><span class="lineno"> 1361</span>  </div>
<div class="line"><a name="l01362"></a><span class="lineno"> 1362</span>  <span class="keywordtype">int</span> numCtrls = 3;</div>
<div class="line"><a name="l01363"></a><span class="lineno"> 1363</span>  <span class="keywordtype">int</span> numTargs = 1;</div>
<div class="line"><a name="l01364"></a><span class="lineno"> 1364</span>  <span class="keywordtype">int</span> ctrls[] = {0,1,1};</div>
<div class="line"><a name="l01365"></a><span class="lineno"> 1365</span>  <span class="keywordtype">int</span> targs[] = {3};</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>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga1e5dd165b402e97abaa0b807026527f2">multiControlledMultiRotateZ</a>(qureg, ctrls, numCtrls, targs, numTargs, param), Contains(<span class="stringliteral">"control"</span>) && Contains(<span class="stringliteral">"unique"</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>  SECTION( <span class="stringliteral">"control and target collision"</span> ) {</div>
<div class="line"><a name="l01370"></a><span class="lineno"> 1370</span>  </div>
<div class="line"><a name="l01371"></a><span class="lineno"> 1371</span>  <span class="keywordtype">int</span> numCtrls = 3;</div>
<div class="line"><a name="l01372"></a><span class="lineno"> 1372</span>  <span class="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l01373"></a><span class="lineno"> 1373</span>  <span class="keywordtype">int</span> ctrls[] = {0,1,2};</div>
<div class="line"><a name="l01374"></a><span class="lineno"> 1374</span>  <span class="keywordtype">int</span> targs[] = {3,1,4};</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>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga1e5dd165b402e97abaa0b807026527f2">multiControlledMultiRotateZ</a>(qureg, ctrls, numCtrls, targs, numTargs, param), Contains(<span class="stringliteral">"Control"</span>) && Contains(<span class="stringliteral">"target"</span>) && Contains(<span class="stringliteral">"disjoint"</span>));</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">"qubit indices"</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>  <span class="comment">// valid inds</span></div>
<div class="line"><a name="l01381"></a><span class="lineno"> 1381</span>  <span class="keywordtype">int</span> numQb = 2;</div>
<div class="line"><a name="l01382"></a><span class="lineno"> 1382</span>  <span class="keywordtype">int</span> qb1[2] = {0,1};</div>
<div class="line"><a name="l01383"></a><span class="lineno"> 1383</span>  <span class="keywordtype">int</span> qb2[2] = {2,3};</div>
<div class="line"><a name="l01384"></a><span class="lineno"> 1384</span>  </div>
<div class="line"><a name="l01385"></a><span class="lineno"> 1385</span>  <span class="comment">// make qb1 invalid</span></div>
<div class="line"><a name="l01386"></a><span class="lineno"> 1386</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="l01387"></a><span class="lineno"> 1387</span>  qb1[GENERATE_COPY(range(0,numQb))] = inv;</div>
<div class="line"><a name="l01388"></a><span class="lineno"> 1388</span>  </div>
<div class="line"><a name="l01389"></a><span class="lineno"> 1389</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga1e5dd165b402e97abaa0b807026527f2">multiControlledMultiRotateZ</a>(qureg, qb1, numQb, qb2, numQb, param), Contains(<span class="stringliteral">"Invalid control"</span>) );</div>
<div class="line"><a name="l01390"></a><span class="lineno"> 1390</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga1e5dd165b402e97abaa0b807026527f2">multiControlledMultiRotateZ</a>(qureg, qb2, numQb, qb1, numQb, param), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l01391"></a><span class="lineno"> 1391</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>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l01394"></a><span class="lineno"> 1394</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00197">getExponentialOfDiagonalMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00143">getKroneckerProduct()</a>, <a class="el" href="utilities_8cpp_source.html#l00421">getRandomReal()</a>, <a class="el" href="QuEST__common_8c_source.html#l00041">M_PI</a>, <a class="el" href="QuEST_8c_source.html#l00668">multiControlledMultiRotateZ()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, <a class="el" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, and <a class="el" href="utilities_8cpp_source.html#l01488">sublists()</a>.</p>
</div>
</div>
<a id="gac41ea931fcc90e931b0ca2bf98cd9dd0"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gac41ea931fcc90e931b0ca2bf98cd9dd0">◆ </a></span>TEST_CASE() <span class="overload">[97/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"multiControlledPhaseFlip" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#gad76781842af56821ed4e223bd776f057" title="Apply the multiple-qubit controlled phase flip gate, also known as the multiple-qubit controlled paul...">multiControlledPhaseFlip</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l01402">1402</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l01402"></a><span class="lineno"> 1402</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="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l01405"></a><span class="lineno"> 1405</span>  </div>
<div class="line"><a name="l01406"></a><span class="lineno"> 1406</span>  <span class="comment">// acts on the final control qubit</span></div>
<div class="line"><a name="l01407"></a><span class="lineno"> 1407</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op{{1,0},{0,-1}};</div>
<div class="line"><a name="l01408"></a><span class="lineno"> 1408</span>  </div>
<div class="line"><a name="l01409"></a><span class="lineno"> 1409</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l01410"></a><span class="lineno"> 1410</span>  </div>
<div class="line"><a name="l01411"></a><span class="lineno"> 1411</span>  <span class="comment">// generate ALL valid qubit arrangements</span></div>
<div class="line"><a name="l01412"></a><span class="lineno"> 1412</span>  <span class="keywordtype">int</span> numCtrls = GENERATE( range(1,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) ); <span class="comment">// numCtrls=NUM_QUBITS stopped by overzealous validation</span></div>
<div class="line"><a name="l01413"></a><span class="lineno"> 1413</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) );</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">"state-vector"</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>  <a class="code" href="group__unitary.html#gad76781842af56821ed4e223bd776f057">multiControlledPhaseFlip</a>(quregVec, ctrls, numCtrls);</div>
<div class="line"><a name="l01418"></a><span class="lineno"> 1418</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, ctrls, numCtrls-1, ctrls[numCtrls-1], op);</div>
<div class="line"><a name="l01419"></a><span class="lineno"> 1419</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l01420"></a><span class="lineno"> 1420</span>  }</div>
<div class="line"><a name="l01421"></a><span class="lineno"> 1421</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01422"></a><span class="lineno"> 1422</span>  </div>
<div class="line"><a name="l01423"></a><span class="lineno"> 1423</span>  <a class="code" href="group__unitary.html#gad76781842af56821ed4e223bd776f057">multiControlledPhaseFlip</a>(quregMatr, ctrls, numCtrls);</div>
<div class="line"><a name="l01424"></a><span class="lineno"> 1424</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, ctrls, numCtrls-1, ctrls[numCtrls-1], op);</div>
<div class="line"><a name="l01425"></a><span class="lineno"> 1425</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</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>  SECTION( <span class="stringliteral">"input validation"</span> ) {</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>  SECTION( <span class="stringliteral">"number of controls"</span> ) {</div>
<div class="line"><a name="l01431"></a><span class="lineno"> 1431</span>  </div>
<div class="line"><a name="l01432"></a><span class="lineno"> 1432</span>  <span class="keywordtype">int</span> numCtrls = GENERATE( -1, 0, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1 );</div>
<div class="line"><a name="l01433"></a><span class="lineno"> 1433</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="l01434"></a><span class="lineno"> 1434</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gad76781842af56821ed4e223bd776f057">multiControlledPhaseFlip</a>(quregVec, ctrls, numCtrls), Contains(<span class="stringliteral">"Invalid number of qubits"</span>));</div>
<div class="line"><a name="l01435"></a><span class="lineno"> 1435</span>  }</div>
<div class="line"><a name="l01436"></a><span class="lineno"> 1436</span>  SECTION( <span class="stringliteral">"repetition of controls"</span> ) {</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>  <span class="keywordtype">int</span> numCtrls = 3;</div>
<div class="line"><a name="l01439"></a><span class="lineno"> 1439</span>  <span class="keywordtype">int</span> ctrls[] = {0,1,1};</div>
<div class="line"><a name="l01440"></a><span class="lineno"> 1440</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gad76781842af56821ed4e223bd776f057">multiControlledPhaseFlip</a>(quregVec, ctrls, numCtrls), Contains(<span class="stringliteral">"qubits must be unique"</span>));</div>
<div class="line"><a name="l01441"></a><span class="lineno"> 1441</span>  }</div>
<div class="line"><a name="l01442"></a><span class="lineno"> 1442</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l01443"></a><span class="lineno"> 1443</span>  </div>
<div class="line"><a name="l01444"></a><span class="lineno"> 1444</span>  <span class="keywordtype">int</span> numCtrls = 3;</div>
<div class="line"><a name="l01445"></a><span class="lineno"> 1445</span>  <span class="keywordtype">int</span> ctrls[] = { 1, 2, GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> ) };</div>
<div class="line"><a name="l01446"></a><span class="lineno"> 1446</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gad76781842af56821ed4e223bd776f057">multiControlledPhaseFlip</a>(quregVec, ctrls, numCtrls), Contains(<span class="stringliteral">"Invalid qubit"</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>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l01450"></a><span class="lineno"> 1450</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l00587">multiControlledPhaseFlip()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, and <a class="el" href="utilities_8cpp_source.html#l01488">sublists()</a>.</p>
</div>
</div>
<a id="ga7c7b67eb8b1ff63a941caa2d9e830cd7"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga7c7b67eb8b1ff63a941caa2d9e830cd7">◆ </a></span>TEST_CASE() <span class="overload">[98/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"multiControlledPhaseShift" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#ga0832e39058d913ad47af44e97a854446" title="Introduce a phase factor on state of the passed qubits.">multiControlledPhaseShift</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l01458">1458</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l01458"></a><span class="lineno"> 1458</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>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l01461"></a><span class="lineno"> 1461</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> param = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-2*<a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>, 2*<a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>);</div>
<div class="line"><a name="l01462"></a><span class="lineno"> 1462</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op{{1,0},{0,<a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(param)}};</div>
<div class="line"><a name="l01463"></a><span class="lineno"> 1463</span>  </div>
<div class="line"><a name="l01464"></a><span class="lineno"> 1464</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l01465"></a><span class="lineno"> 1465</span>  </div>
<div class="line"><a name="l01466"></a><span class="lineno"> 1466</span>  <span class="comment">// generate ALL valid qubit arrangements</span></div>
<div class="line"><a name="l01467"></a><span class="lineno"> 1467</span>  <span class="keywordtype">int</span> numCtrls = GENERATE( range(1,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) ); <span class="comment">// numCtrls=NUM_QUBITS stopped by overzealous validation</span></div>
<div class="line"><a name="l01468"></a><span class="lineno"> 1468</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) );</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">"state-vector"</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>  <a class="code" href="group__unitary.html#ga0832e39058d913ad47af44e97a854446">multiControlledPhaseShift</a>(quregVec, ctrls, numCtrls, param);</div>
<div class="line"><a name="l01473"></a><span class="lineno"> 1473</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, ctrls, numCtrls-1, ctrls[numCtrls-1], op);</div>
<div class="line"><a name="l01474"></a><span class="lineno"> 1474</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l01475"></a><span class="lineno"> 1475</span>  }</div>
<div class="line"><a name="l01476"></a><span class="lineno"> 1476</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01477"></a><span class="lineno"> 1477</span>  </div>
<div class="line"><a name="l01478"></a><span class="lineno"> 1478</span>  <a class="code" href="group__unitary.html#ga0832e39058d913ad47af44e97a854446">multiControlledPhaseShift</a>(quregMatr, ctrls, numCtrls, param);</div>
<div class="line"><a name="l01479"></a><span class="lineno"> 1479</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, ctrls, numCtrls-1, ctrls[numCtrls-1], op);</div>
<div class="line"><a name="l01480"></a><span class="lineno"> 1480</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</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>  }</div>
<div class="line"><a name="l01483"></a><span class="lineno"> 1483</span>  SECTION( <span class="stringliteral">"input validation"</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">"number of controls"</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="keywordtype">int</span> numCtrls = GENERATE( -1, 0, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1 );</div>
<div class="line"><a name="l01488"></a><span class="lineno"> 1488</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="l01489"></a><span class="lineno"> 1489</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga0832e39058d913ad47af44e97a854446">multiControlledPhaseShift</a>(quregVec, ctrls, numCtrls, param), Contains(<span class="stringliteral">"Invalid number of qubits"</span>));</div>
<div class="line"><a name="l01490"></a><span class="lineno"> 1490</span>  }</div>
<div class="line"><a name="l01491"></a><span class="lineno"> 1491</span>  SECTION( <span class="stringliteral">"repetition of controls"</span> ) {</div>
<div class="line"><a name="l01492"></a><span class="lineno"> 1492</span>  </div>
<div class="line"><a name="l01493"></a><span class="lineno"> 1493</span>  <span class="keywordtype">int</span> numCtrls = 3;</div>
<div class="line"><a name="l01494"></a><span class="lineno"> 1494</span>  <span class="keywordtype">int</span> ctrls[] = {0,1,1};</div>
<div class="line"><a name="l01495"></a><span class="lineno"> 1495</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga0832e39058d913ad47af44e97a854446">multiControlledPhaseShift</a>(quregVec, ctrls, numCtrls, param), Contains(<span class="stringliteral">"qubits must be unique"</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>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l01498"></a><span class="lineno"> 1498</span>  </div>
<div class="line"><a name="l01499"></a><span class="lineno"> 1499</span>  <span class="keywordtype">int</span> numCtrls = 3;</div>
<div class="line"><a name="l01500"></a><span class="lineno"> 1500</span>  <span class="keywordtype">int</span> ctrls[] = { 1, 2, GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> ) };</div>
<div class="line"><a name="l01501"></a><span class="lineno"> 1501</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga0832e39058d913ad47af44e97a854446">multiControlledPhaseShift</a>(quregVec, ctrls, numCtrls, param), Contains(<span class="stringliteral">"Invalid qubit"</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>  }</div>
<div class="line"><a name="l01504"></a><span class="lineno"> 1504</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l01505"></a><span class="lineno"> 1505</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00417">expI()</a>, <a class="el" href="utilities_8cpp_source.html#l00421">getRandomReal()</a>, <a class="el" href="QuEST__common_8c_source.html#l00041">M_PI</a>, <a class="el" href="QuEST_8c_source.html#l00510">multiControlledPhaseShift()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, and <a class="el" href="utilities_8cpp_source.html#l01488">sublists()</a>.</p>
</div>
</div>
<a id="ga8e86adfbd714cc3309fe15efaac8a33f"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga8e86adfbd714cc3309fe15efaac8a33f">◆ </a></span>TEST_CASE() <span class="overload">[99/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"multiControlledTwoQubitUnitary" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#ga65c7879947e398690a5428bd43e143e3" title="Apply a general multi-controlled two-qubit unitary (including a global phase factor).">multiControlledTwoQubitUnitary</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l01513">1513</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l01513"></a><span class="lineno"> 1513</span>  {</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>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l01516"></a><span class="lineno"> 1516</span>  </div>
<div class="line"><a name="l01517"></a><span class="lineno"> 1517</span>  <span class="comment">// in distributed mode, each node must be able to fit all amps modified by unitary </span></div>
<div class="line"><a name="l01518"></a><span class="lineno"> 1518</span>  REQUIRE( quregVec.numAmpsPerChunk >= 4 );</div>
<div class="line"><a name="l01519"></a><span class="lineno"> 1519</span>  </div>
<div class="line"><a name="l01520"></a><span class="lineno"> 1520</span>  <span class="comment">// every test will use a unique random matrix</span></div>
<div class="line"><a name="l01521"></a><span class="lineno"> 1521</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op = <a class="code" href="group__testutilities.html#ga1a5e9b668716b91dd8527ce00f7500cf">getRandomUnitary</a>(2);</div>
<div class="line"><a name="l01522"></a><span class="lineno"> 1522</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="l01523"></a><span class="lineno"> 1523</span>  </div>
<div class="line"><a name="l01524"></a><span class="lineno"> 1524</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l01525"></a><span class="lineno"> 1525</span>  </div>
<div class="line"><a name="l01526"></a><span class="lineno"> 1526</span>  <span class="comment">// generate ALL valid qubit arrangements</span></div>
<div class="line"><a name="l01527"></a><span class="lineno"> 1527</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="l01528"></a><span class="lineno"> 1528</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="l01529"></a><span class="lineno"> 1529</span>  <span class="keywordtype">int</span> targs[] = {targ1, targ2};</div>
<div class="line"><a name="l01530"></a><span class="lineno"> 1530</span>  <span class="keywordtype">int</span> numCtrls = GENERATE( range(1,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>-1) ); <span class="comment">// leave room for 2 targets (upper bound is exclusive)</span></div>
<div class="line"><a name="l01531"></a><span class="lineno"> 1531</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, 2) );</div>
<div class="line"><a name="l01532"></a><span class="lineno"> 1532</span>  </div>
<div class="line"><a name="l01533"></a><span class="lineno"> 1533</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l01534"></a><span class="lineno"> 1534</span>  </div>
<div class="line"><a name="l01535"></a><span class="lineno"> 1535</span>  <a class="code" href="group__unitary.html#ga65c7879947e398690a5428bd43e143e3">multiControlledTwoQubitUnitary</a>(quregVec, ctrls, numCtrls, targ1, targ2, matr);</div>
<div class="line"><a name="l01536"></a><span class="lineno"> 1536</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, ctrls, numCtrls, targ1, targ2, op);</div>
<div class="line"><a name="l01537"></a><span class="lineno"> 1537</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l01538"></a><span class="lineno"> 1538</span>  }</div>
<div class="line"><a name="l01539"></a><span class="lineno"> 1539</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01540"></a><span class="lineno"> 1540</span>  </div>
<div class="line"><a name="l01541"></a><span class="lineno"> 1541</span>  <a class="code" href="group__unitary.html#ga65c7879947e398690a5428bd43e143e3">multiControlledTwoQubitUnitary</a>(quregMatr, ctrls, numCtrls, targ1, targ2, matr);</div>
<div class="line"><a name="l01542"></a><span class="lineno"> 1542</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, ctrls, numCtrls, targ1, targ2, op);</div>
<div class="line"><a name="l01543"></a><span class="lineno"> 1543</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 10*REAL_EPS) );</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>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l01547"></a><span class="lineno"> 1547</span>  </div>
<div class="line"><a name="l01548"></a><span class="lineno"> 1548</span>  SECTION( <span class="stringliteral">"number of controls"</span> ) {</div>
<div class="line"><a name="l01549"></a><span class="lineno"> 1549</span>  </div>
<div class="line"><a name="l01550"></a><span class="lineno"> 1550</span>  <span class="comment">// numCtrls=(NUM_QUBITS-1) is ok since requires ctrl qubit inds are invalid</span></div>
<div class="line"><a name="l01551"></a><span class="lineno"> 1551</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="l01552"></a><span class="lineno"> 1552</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="l01553"></a><span class="lineno"> 1553</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga65c7879947e398690a5428bd43e143e3">multiControlledTwoQubitUnitary</a>(quregVec, ctrls, numCtrls, 0, 1, matr), Contains(<span class="stringliteral">"Invalid number of control"</span>));</div>
<div class="line"><a name="l01554"></a><span class="lineno"> 1554</span>  }</div>
<div class="line"><a name="l01555"></a><span class="lineno"> 1555</span>  SECTION( <span class="stringliteral">"repetition of controls"</span> ) {</div>
<div class="line"><a name="l01556"></a><span class="lineno"> 1556</span>  </div>
<div class="line"><a name="l01557"></a><span class="lineno"> 1557</span>  <span class="keywordtype">int</span> numCtrls = 3;</div>
<div class="line"><a name="l01558"></a><span class="lineno"> 1558</span>  <span class="keywordtype">int</span> ctrls[] = {0,1,1};</div>
<div class="line"><a name="l01559"></a><span class="lineno"> 1559</span>  <span class="keywordtype">int</span> targ1 = 2;</div>
<div class="line"><a name="l01560"></a><span class="lineno"> 1560</span>  <span class="keywordtype">int</span> targ2 = 3;</div>
<div class="line"><a name="l01561"></a><span class="lineno"> 1561</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga65c7879947e398690a5428bd43e143e3">multiControlledTwoQubitUnitary</a>(quregVec, ctrls, numCtrls, targ1, targ2, matr), Contains(<span class="stringliteral">"control"</span>) && Contains(<span class="stringliteral">"unique"</span>));;</div>
<div class="line"><a name="l01562"></a><span class="lineno"> 1562</span>  }</div>
<div class="line"><a name="l01563"></a><span class="lineno"> 1563</span>  SECTION( <span class="stringliteral">"repetition of targets"</span> ) {</div>
<div class="line"><a name="l01564"></a><span class="lineno"> 1564</span>  </div>
<div class="line"><a name="l01565"></a><span class="lineno"> 1565</span>  <span class="keywordtype">int</span> numCtrls = 3;</div>
<div class="line"><a name="l01566"></a><span class="lineno"> 1566</span>  <span class="keywordtype">int</span> ctrls[] = {0,1,2};</div>
<div class="line"><a name="l01567"></a><span class="lineno"> 1567</span>  <span class="keywordtype">int</span> targ1 = 3;</div>
<div class="line"><a name="l01568"></a><span class="lineno"> 1568</span>  <span class="keywordtype">int</span> targ2 = targ1;</div>
<div class="line"><a name="l01569"></a><span class="lineno"> 1569</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga65c7879947e398690a5428bd43e143e3">multiControlledTwoQubitUnitary</a>(quregVec, ctrls, numCtrls, targ1, targ2, matr), Contains(<span class="stringliteral">"target"</span>) && Contains(<span class="stringliteral">"unique"</span>));</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>  SECTION( <span class="stringliteral">"control and target collision"</span> ) {</div>
<div class="line"><a name="l01572"></a><span class="lineno"> 1572</span>  </div>
<div class="line"><a name="l01573"></a><span class="lineno"> 1573</span>  <span class="keywordtype">int</span> numCtrls = 3;</div>
<div class="line"><a name="l01574"></a><span class="lineno"> 1574</span>  <span class="keywordtype">int</span> ctrls[] = {0,1,2};</div>
<div class="line"><a name="l01575"></a><span class="lineno"> 1575</span>  <span class="keywordtype">int</span> targ1 = 3;</div>
<div class="line"><a name="l01576"></a><span class="lineno"> 1576</span>  <span class="keywordtype">int</span> targ2 = ctrls[GENERATE_COPY( range(0,numCtrls) )];</div>
<div class="line"><a name="l01577"></a><span class="lineno"> 1577</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga65c7879947e398690a5428bd43e143e3">multiControlledTwoQubitUnitary</a>(quregVec, ctrls, numCtrls, targ1, targ2, matr), Contains(<span class="stringliteral">"Control"</span>) && Contains(<span class="stringliteral">"target"</span>) );</div>
<div class="line"><a name="l01578"></a><span class="lineno"> 1578</span>  }</div>
<div class="line"><a name="l01579"></a><span class="lineno"> 1579</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l01580"></a><span class="lineno"> 1580</span>  </div>
<div class="line"><a name="l01581"></a><span class="lineno"> 1581</span>  <span class="comment">// valid indices</span></div>
<div class="line"><a name="l01582"></a><span class="lineno"> 1582</span>  <span class="keywordtype">int</span> targ1 = 0;</div>
<div class="line"><a name="l01583"></a><span class="lineno"> 1583</span>  <span class="keywordtype">int</span> targ2 = 1;</div>
<div class="line"><a name="l01584"></a><span class="lineno"> 1584</span>  <span class="keywordtype">int</span> numCtrls = 3;</div>
<div class="line"><a name="l01585"></a><span class="lineno"> 1585</span>  <span class="keywordtype">int</span> ctrls[] = { 2, 3, 4 };</div>
<div class="line"><a name="l01586"></a><span class="lineno"> 1586</span>  </div>
<div class="line"><a name="l01587"></a><span class="lineno"> 1587</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="l01588"></a><span class="lineno"> 1588</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga65c7879947e398690a5428bd43e143e3">multiControlledTwoQubitUnitary</a>(quregVec, ctrls, numCtrls, inv, targ2, matr), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l01589"></a><span class="lineno"> 1589</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga65c7879947e398690a5428bd43e143e3">multiControlledTwoQubitUnitary</a>(quregVec, ctrls, numCtrls, targ1, inv, matr), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l01590"></a><span class="lineno"> 1590</span>  </div>
<div class="line"><a name="l01591"></a><span class="lineno"> 1591</span>  ctrls[numCtrls-1] = inv; <span class="comment">// make ctrls invalid </span></div>
<div class="line"><a name="l01592"></a><span class="lineno"> 1592</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga65c7879947e398690a5428bd43e143e3">multiControlledTwoQubitUnitary</a>(quregVec, ctrls, numCtrls, targ1, targ2, matr), Contains(<span class="stringliteral">"Invalid control"</span>) );</div>
<div class="line"><a name="l01593"></a><span class="lineno"> 1593</span>  }</div>
<div class="line"><a name="l01594"></a><span class="lineno"> 1594</span>  SECTION( <span class="stringliteral">"unitarity "</span> ) {</div>
<div class="line"><a name="l01595"></a><span class="lineno"> 1595</span>  </div>
<div class="line"><a name="l01596"></a><span class="lineno"> 1596</span>  <span class="keywordtype">int</span> ctrls[1] = {0};</div>
<div class="line"><a name="l01597"></a><span class="lineno"> 1597</span>  matr.<a class="code" href="structComplexMatrix4.html#aeadc9893e1b16cdd585dac523e73926c">real</a>[0][0] = 0; <span class="comment">// break unitarity</span></div>
<div class="line"><a name="l01598"></a><span class="lineno"> 1598</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga65c7879947e398690a5428bd43e143e3">multiControlledTwoQubitUnitary</a>(quregVec, ctrls, 1, 1, 2, matr), Contains(<span class="stringliteral">"unitary"</span>) );</div>
<div class="line"><a name="l01599"></a><span class="lineno"> 1599</span>  }</div>
<div class="line"><a name="l01600"></a><span class="lineno"> 1600</span>  SECTION( <span class="stringliteral">"unitary fits in node"</span> ) {</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>  <span class="comment">// pretend we have a very limited distributed memory</span></div>
<div class="line"><a name="l01603"></a><span class="lineno"> 1603</span>  quregVec.numAmpsPerChunk = 1;</div>
<div class="line"><a name="l01604"></a><span class="lineno"> 1604</span>  <span class="keywordtype">int</span> ctrls[1] = {0};</div>
<div class="line"><a name="l01605"></a><span class="lineno"> 1605</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga65c7879947e398690a5428bd43e143e3">multiControlledTwoQubitUnitary</a>(quregVec, ctrls, 1, 1, 2, matr), Contains(<span class="stringliteral">"targets too many qubits"</span>));</div>
<div class="line"><a name="l01606"></a><span class="lineno"> 1606</span>  }</div>
<div class="line"><a name="l01607"></a><span class="lineno"> 1607</span>  }</div>
<div class="line"><a name="l01608"></a><span class="lineno"> 1608</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l01609"></a><span class="lineno"> 1609</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00530">getRandomUnitary()</a>, <a class="el" href="QuEST_8c_source.html#l00282">multiControlledTwoQubitUnitary()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, <a class="el" href="QuEST_8h_source.html#l00177">ComplexMatrix4::real</a>, <a class="el" href="utilities_8cpp_source.html#l01488">sublists()</a>, and <a class="el" href="utilities_8cpp_source.html#l01027">toComplexMatrix4()</a>.</p>
</div>
</div>
<a id="ga9fc32abbfb35c76915b3b3e1ec3656d8"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga9fc32abbfb35c76915b3b3e1ec3656d8">◆ </a></span>TEST_CASE() <span class="overload">[100/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"multiControlledUnitary" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#gaa700dc9657ade4cf16f1cad1624c5332" title="Apply a general multiple-control single-target unitary, which can include a global phase factor.">multiControlledUnitary</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l01617">1617</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><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>  </div>
<div class="line"><a name="l01619"></a><span class="lineno"> 1619</span>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</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>  <span class="comment">// every test will use a unique random matrix</span></div>
<div class="line"><a name="l01622"></a><span class="lineno"> 1622</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op = <a class="code" href="group__testutilities.html#ga1a5e9b668716b91dd8527ce00f7500cf">getRandomUnitary</a>(1);</div>
<div class="line"><a name="l01623"></a><span class="lineno"> 1623</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="l01624"></a><span class="lineno"> 1624</span>  </div>
<div class="line"><a name="l01625"></a><span class="lineno"> 1625</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l01626"></a><span class="lineno"> 1626</span>  </div>
<div class="line"><a name="l01627"></a><span class="lineno"> 1627</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="l01628"></a><span class="lineno"> 1628</span>  <span class="keywordtype">int</span> numCtrls = GENERATE( range(1,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) ); <span class="comment">// leave space for one target (exclusive upper bound)</span></div>
<div class="line"><a name="l01629"></a><span class="lineno"> 1629</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, target) );</div>
<div class="line"><a name="l01630"></a><span class="lineno"> 1630</span>  </div>
<div class="line"><a name="l01631"></a><span class="lineno"> 1631</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l01632"></a><span class="lineno"> 1632</span>  </div>
<div class="line"><a name="l01633"></a><span class="lineno"> 1633</span>  <a class="code" href="group__unitary.html#gaa700dc9657ade4cf16f1cad1624c5332">multiControlledUnitary</a>(quregVec, ctrls, numCtrls, target, matr);</div>
<div class="line"><a name="l01634"></a><span class="lineno"> 1634</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, ctrls, numCtrls, target, op);</div>
<div class="line"><a name="l01635"></a><span class="lineno"> 1635</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l01636"></a><span class="lineno"> 1636</span>  }</div>
<div class="line"><a name="l01637"></a><span class="lineno"> 1637</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</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>  <a class="code" href="group__unitary.html#gaa700dc9657ade4cf16f1cad1624c5332">multiControlledUnitary</a>(quregMatr, ctrls, numCtrls, target, matr);</div>
<div class="line"><a name="l01640"></a><span class="lineno"> 1640</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, ctrls, numCtrls, target, op);</div>
<div class="line"><a name="l01641"></a><span class="lineno"> 1641</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 10*REAL_EPS) );</div>
<div class="line"><a name="l01642"></a><span class="lineno"> 1642</span>  }</div>
<div class="line"><a name="l01643"></a><span class="lineno"> 1643</span>  }</div>
<div class="line"><a name="l01644"></a><span class="lineno"> 1644</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l01645"></a><span class="lineno"> 1645</span>  </div>
<div class="line"><a name="l01646"></a><span class="lineno"> 1646</span>  SECTION( <span class="stringliteral">"number of controls"</span> ) {</div>
<div class="line"><a name="l01647"></a><span class="lineno"> 1647</span>  </div>
<div class="line"><a name="l01648"></a><span class="lineno"> 1648</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="l01649"></a><span class="lineno"> 1649</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="l01650"></a><span class="lineno"> 1650</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gaa700dc9657ade4cf16f1cad1624c5332">multiControlledUnitary</a>(quregVec, ctrls, numCtrls, 0, matr), Contains(<span class="stringliteral">"Invalid number of control"</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>  SECTION( <span class="stringliteral">"repetition of controls"</span> ) {</div>
<div class="line"><a name="l01653"></a><span class="lineno"> 1653</span>  </div>
<div class="line"><a name="l01654"></a><span class="lineno"> 1654</span>  <span class="keywordtype">int</span> ctrls[] = {0,1,1};</div>
<div class="line"><a name="l01655"></a><span class="lineno"> 1655</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gaa700dc9657ade4cf16f1cad1624c5332">multiControlledUnitary</a>(quregVec, ctrls, 3, 2, matr), Contains(<span class="stringliteral">"control"</span>) && Contains(<span class="stringliteral">"unique"</span>));</div>
<div class="line"><a name="l01656"></a><span class="lineno"> 1656</span>  }</div>
<div class="line"><a name="l01657"></a><span class="lineno"> 1657</span>  SECTION( <span class="stringliteral">"control and target collision"</span> ) {</div>
<div class="line"><a name="l01658"></a><span class="lineno"> 1658</span>  </div>
<div class="line"><a name="l01659"></a><span class="lineno"> 1659</span>  <span class="keywordtype">int</span> ctrls[] = {0,1,2};</div>
<div class="line"><a name="l01660"></a><span class="lineno"> 1660</span>  <span class="keywordtype">int</span> targ = ctrls[GENERATE( range(0,3) )];</div>
<div class="line"><a name="l01661"></a><span class="lineno"> 1661</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gaa700dc9657ade4cf16f1cad1624c5332">multiControlledUnitary</a>(quregVec, ctrls, 3, targ, matr), Contains(<span class="stringliteral">"Control"</span>) && Contains(<span class="stringliteral">"target"</span>) );</div>
<div class="line"><a name="l01662"></a><span class="lineno"> 1662</span>  }</div>
<div class="line"><a name="l01663"></a><span class="lineno"> 1663</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</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>  <span class="keywordtype">int</span> ctrls[] = { 1, 2, GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> ) };</div>
<div class="line"><a name="l01666"></a><span class="lineno"> 1666</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gaa700dc9657ade4cf16f1cad1624c5332">multiControlledUnitary</a>(quregVec, ctrls, 3, 0, matr), Contains(<span class="stringliteral">"Invalid control"</span>) );</div>
<div class="line"><a name="l01667"></a><span class="lineno"> 1667</span>  </div>
<div class="line"><a name="l01668"></a><span class="lineno"> 1668</span>  ctrls[2] = 3; <span class="comment">// make ctrls valid </span></div>
<div class="line"><a name="l01669"></a><span class="lineno"> 1669</span>  <span class="keywordtype">int</span> targ = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l01670"></a><span class="lineno"> 1670</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gaa700dc9657ade4cf16f1cad1624c5332">multiControlledUnitary</a>(quregVec, ctrls, 3, targ, matr), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l01671"></a><span class="lineno"> 1671</span>  }</div>
<div class="line"><a name="l01672"></a><span class="lineno"> 1672</span>  SECTION( <span class="stringliteral">"unitarity"</span> ) {</div>
<div class="line"><a name="l01673"></a><span class="lineno"> 1673</span>  </div>
<div class="line"><a name="l01674"></a><span class="lineno"> 1674</span>  matr.<a class="code" href="structComplexMatrix2.html#a3ea98d545b67a190ee6abe936c72076f">real</a>[0][0] = 0; <span class="comment">// break matr unitarity</span></div>
<div class="line"><a name="l01675"></a><span class="lineno"> 1675</span>  <span class="keywordtype">int</span> ctrls[] = {0};</div>
<div class="line"><a name="l01676"></a><span class="lineno"> 1676</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gaa700dc9657ade4cf16f1cad1624c5332">multiControlledUnitary</a>(quregVec, ctrls, 1, 1, matr), Contains(<span class="stringliteral">"unitary"</span>) );</div>
<div class="line"><a name="l01677"></a><span class="lineno"> 1677</span>  }</div>
<div class="line"><a name="l01678"></a><span class="lineno"> 1678</span>  }</div>
<div class="line"><a name="l01679"></a><span class="lineno"> 1679</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l01680"></a><span class="lineno"> 1680</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00530">getRandomUnitary()</a>, <a class="el" href="QuEST_8c_source.html#l00373">multiControlledUnitary()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, <a class="el" href="QuEST_8h_source.html#l00139">ComplexMatrix2::real</a>, <a class="el" href="utilities_8cpp_source.html#l01488">sublists()</a>, and <a class="el" href="utilities_8cpp_source.html#l01021">toComplexMatrix2()</a>.</p>
</div>
</div>
<a id="ga111c113392a31c145f7d4a23cd25eed6"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga111c113392a31c145f7d4a23cd25eed6">◆ </a></span>TEST_CASE() <span class="overload">[101/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"multiQubitNot" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#ga7e58e8131f219f48e5b7410ca8dfe0c0" title="Apply a NOT (or Pauli X) gate with multiple target qubits, which has the same effect as (but is much ...">multiQubitNot</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l01688">1688</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l01688"></a><span class="lineno"> 1688</span>  {</div>
<div class="line"><a name="l01689"></a><span class="lineno"> 1689</span>  </div>
<div class="line"><a name="l01690"></a><span class="lineno"> 1690</span>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l01691"></a><span class="lineno"> 1691</span>  </div>
<div class="line"><a name="l01692"></a><span class="lineno"> 1692</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l01693"></a><span class="lineno"> 1693</span>  </div>
<div class="line"><a name="l01694"></a><span class="lineno"> 1694</span>  <span class="comment">// try all possible numbers of targets and controls</span></div>
<div class="line"><a name="l01695"></a><span class="lineno"> 1695</span>  <span class="keywordtype">int</span> numTargs = GENERATE_COPY( range(1,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1) ); <span class="comment">// leave space for 1 ctrl</span></div>
<div class="line"><a name="l01696"></a><span class="lineno"> 1696</span>  </div>
<div class="line"><a name="l01697"></a><span class="lineno"> 1697</span>  <span class="comment">// generate all possible valid qubit arrangements</span></div>
<div class="line"><a name="l01698"></a><span class="lineno"> 1698</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="l01699"></a><span class="lineno"> 1699</span>  </div>
<div class="line"><a name="l01700"></a><span class="lineno"> 1700</span>  <span class="comment">// for each qubit arrangement, use a new random unitary</span></div>
<div class="line"><a name="l01701"></a><span class="lineno"> 1701</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> notOp{{0, 1},{1,0}};</div>
<div class="line"><a name="l01702"></a><span class="lineno"> 1702</span>  </div>
<div class="line"><a name="l01703"></a><span class="lineno"> 1703</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</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>  <a class="code" href="group__unitary.html#ga7e58e8131f219f48e5b7410ca8dfe0c0">multiQubitNot</a>(quregVec, targs, numTargs);</div>
<div class="line"><a name="l01706"></a><span class="lineno"> 1706</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> t=0; t<numTargs; t++)</div>
<div class="line"><a name="l01707"></a><span class="lineno"> 1707</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, targs[t], notOp);</div>
<div class="line"><a name="l01708"></a><span class="lineno"> 1708</span>  </div>
<div class="line"><a name="l01709"></a><span class="lineno"> 1709</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</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>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01712"></a><span class="lineno"> 1712</span>  </div>
<div class="line"><a name="l01713"></a><span class="lineno"> 1713</span>  <a class="code" href="group__unitary.html#ga7e58e8131f219f48e5b7410ca8dfe0c0">multiQubitNot</a>(quregMatr, targs, numTargs);</div>
<div class="line"><a name="l01714"></a><span class="lineno"> 1714</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> t=0; t<numTargs; t++)</div>
<div class="line"><a name="l01715"></a><span class="lineno"> 1715</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, targs[t], notOp);</div>
<div class="line"><a name="l01716"></a><span class="lineno"> 1716</span>  </div>
<div class="line"><a name="l01717"></a><span class="lineno"> 1717</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</div>
<div class="line"><a name="l01718"></a><span class="lineno"> 1718</span>  }</div>
<div class="line"><a name="l01719"></a><span class="lineno"> 1719</span>  }</div>
<div class="line"><a name="l01720"></a><span class="lineno"> 1720</span>  SECTION( <span class="stringliteral">"input validation"</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>  SECTION( <span class="stringliteral">"number of targets"</span> ) {</div>
<div class="line"><a name="l01723"></a><span class="lineno"> 1723</span>  </div>
<div class="line"><a name="l01724"></a><span class="lineno"> 1724</span>  <span class="comment">// there cannot be more targets than qubits in register</span></div>
<div class="line"><a name="l01725"></a><span class="lineno"> 1725</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="l01726"></a><span class="lineno"> 1726</span>  <span class="keywordtype">int</span> targs[<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1];</div>
<div class="line"><a name="l01727"></a><span class="lineno"> 1727</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga7e58e8131f219f48e5b7410ca8dfe0c0">multiQubitNot</a>(quregVec, targs, numTargs), Contains(<span class="stringliteral">"Invalid number of target"</span>));</div>
<div class="line"><a name="l01728"></a><span class="lineno"> 1728</span>  }</div>
<div class="line"><a name="l01729"></a><span class="lineno"> 1729</span>  SECTION( <span class="stringliteral">"repetition in targets"</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>  <span class="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l01732"></a><span class="lineno"> 1732</span>  <span class="keywordtype">int</span> targs[] = {1,2,2};</div>
<div class="line"><a name="l01733"></a><span class="lineno"> 1733</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga7e58e8131f219f48e5b7410ca8dfe0c0">multiQubitNot</a>(quregVec, targs, numTargs), Contains(<span class="stringliteral">"target"</span>) && Contains(<span class="stringliteral">"unique"</span>));</div>
<div class="line"><a name="l01734"></a><span class="lineno"> 1734</span>  }</div>
<div class="line"><a name="l01735"></a><span class="lineno"> 1735</span>  SECTION( <span class="stringliteral">"target indices"</span> ) {</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>  <span class="comment">// valid inds</span></div>
<div class="line"><a name="l01738"></a><span class="lineno"> 1738</span>  <span class="keywordtype">int</span> numQb = 5;</div>
<div class="line"><a name="l01739"></a><span class="lineno"> 1739</span>  <span class="keywordtype">int</span> qubits[] = {0,1,2,3,4};</div>
<div class="line"><a name="l01740"></a><span class="lineno"> 1740</span>  </div>
<div class="line"><a name="l01741"></a><span class="lineno"> 1741</span>  <span class="comment">// make one index invalid</span></div>
<div class="line"><a name="l01742"></a><span class="lineno"> 1742</span>  qubits[GENERATE_COPY(range(0,numQb))] = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l01743"></a><span class="lineno"> 1743</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga7e58e8131f219f48e5b7410ca8dfe0c0">multiQubitNot</a>(quregVec, qubits, numQb), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l01744"></a><span class="lineno"> 1744</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>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l01747"></a><span class="lineno"> 1747</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l00536">multiQubitNot()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, and <a class="el" href="utilities_8cpp_source.html#l01488">sublists()</a>.</p>
</div>
</div>
<a id="gaf396e2e9e1e995adfb30947201c23590"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaf396e2e9e1e995adfb30947201c23590">◆ </a></span>TEST_CASE() <span class="overload">[102/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"multiQubitUnitary" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#ga20bf9b8a71b8a3ee4651e9497e6d1f4f" title="Apply a general multi-qubit unitary (including a global phase factor) with any number of target qubit...">multiQubitUnitary</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l01755">1755</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><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="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l01758"></a><span class="lineno"> 1758</span>  </div>
<div class="line"><a name="l01759"></a><span class="lineno"> 1759</span>  <span class="comment">// figure out max-num (inclusive) targs allowed by hardware backend</span></div>
<div class="line"><a name="l01760"></a><span class="lineno"> 1760</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="l01761"></a><span class="lineno"> 1761</span>  </div>
<div class="line"><a name="l01762"></a><span class="lineno"> 1762</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l01763"></a><span class="lineno"> 1763</span>  </div>
<div class="line"><a name="l01764"></a><span class="lineno"> 1764</span>  <span class="comment">// generate all possible qubit arrangements</span></div>
<div class="line"><a name="l01765"></a><span class="lineno"> 1765</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="l01766"></a><span class="lineno"> 1766</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="l01767"></a><span class="lineno"> 1767</span>  </div>
<div class="line"><a name="l01768"></a><span class="lineno"> 1768</span>  <span class="comment">// for each qubit arrangement, use a new random unitary</span></div>
<div class="line"><a name="l01769"></a><span class="lineno"> 1769</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op = <a class="code" href="group__testutilities.html#ga1a5e9b668716b91dd8527ce00f7500cf">getRandomUnitary</a>(numTargs);</div>
<div class="line"><a name="l01770"></a><span class="lineno"> 1770</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="l01771"></a><span class="lineno"> 1771</span>  <a class="code" href="group__testutilities.html#ga7f83695bea7d0332a577bca017dbb03c">toComplexMatrixN</a>(op, matr);</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">"state-vector"</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>  <a class="code" href="group__unitary.html#ga20bf9b8a71b8a3ee4651e9497e6d1f4f">multiQubitUnitary</a>(quregVec, targs, numTargs, matr);</div>
<div class="line"><a name="l01776"></a><span class="lineno"> 1776</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, targs, numTargs, op);</div>
<div class="line"><a name="l01777"></a><span class="lineno"> 1777</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l01778"></a><span class="lineno"> 1778</span>  }</div>
<div class="line"><a name="l01779"></a><span class="lineno"> 1779</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01780"></a><span class="lineno"> 1780</span>  </div>
<div class="line"><a name="l01781"></a><span class="lineno"> 1781</span>  <a class="code" href="group__unitary.html#ga20bf9b8a71b8a3ee4651e9497e6d1f4f">multiQubitUnitary</a>(quregMatr, targs, numTargs, matr);</div>
<div class="line"><a name="l01782"></a><span class="lineno"> 1782</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, targs, numTargs, op);</div>
<div class="line"><a name="l01783"></a><span class="lineno"> 1783</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 10*REAL_EPS) );</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#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l01786"></a><span class="lineno"> 1786</span>  }</div>
<div class="line"><a name="l01787"></a><span class="lineno"> 1787</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l01788"></a><span class="lineno"> 1788</span>  </div>
<div class="line"><a name="l01789"></a><span class="lineno"> 1789</span>  SECTION( <span class="stringliteral">"number of targets"</span> ) {</div>
<div class="line"><a name="l01790"></a><span class="lineno"> 1790</span>  </div>
<div class="line"><a name="l01791"></a><span class="lineno"> 1791</span>  <span class="comment">// there cannot be more targets than qubits in register</span></div>
<div class="line"><a name="l01792"></a><span class="lineno"> 1792</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="l01793"></a><span class="lineno"> 1793</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="l01794"></a><span class="lineno"> 1794</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="l01795"></a><span class="lineno"> 1795</span>  </div>
<div class="line"><a name="l01796"></a><span class="lineno"> 1796</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga20bf9b8a71b8a3ee4651e9497e6d1f4f">multiQubitUnitary</a>(quregVec, targs, numTargs, matr), Contains(<span class="stringliteral">"Invalid number of target"</span>));</div>
<div class="line"><a name="l01797"></a><span class="lineno"> 1797</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l01798"></a><span class="lineno"> 1798</span>  }</div>
<div class="line"><a name="l01799"></a><span class="lineno"> 1799</span>  SECTION( <span class="stringliteral">"repetition in targets"</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>  <span class="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l01802"></a><span class="lineno"> 1802</span>  <span class="keywordtype">int</span> targs[] = {1,2,2};</div>
<div class="line"><a name="l01803"></a><span class="lineno"> 1803</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="l01804"></a><span class="lineno"> 1804</span>  </div>
<div class="line"><a name="l01805"></a><span class="lineno"> 1805</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga20bf9b8a71b8a3ee4651e9497e6d1f4f">multiQubitUnitary</a>(quregVec, targs, numTargs, matr), Contains(<span class="stringliteral">"target"</span>) && Contains(<span class="stringliteral">"unique"</span>));</div>
<div class="line"><a name="l01806"></a><span class="lineno"> 1806</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l01807"></a><span class="lineno"> 1807</span>  }</div>
<div class="line"><a name="l01808"></a><span class="lineno"> 1808</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l01809"></a><span class="lineno"> 1809</span>  </div>
<div class="line"><a name="l01810"></a><span class="lineno"> 1810</span>  <span class="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l01811"></a><span class="lineno"> 1811</span>  <span class="keywordtype">int</span> targs[] = {1,2,3};</div>
<div class="line"><a name="l01812"></a><span class="lineno"> 1812</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="l01813"></a><span class="lineno"> 1813</span>  </div>
<div class="line"><a name="l01814"></a><span class="lineno"> 1814</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="l01815"></a><span class="lineno"> 1815</span>  targs[GENERATE_COPY( range(0,numTargs) )] = inv; <span class="comment">// make invalid target</span></div>
<div class="line"><a name="l01816"></a><span class="lineno"> 1816</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga20bf9b8a71b8a3ee4651e9497e6d1f4f">multiQubitUnitary</a>(quregVec, targs, numTargs, matr), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l01817"></a><span class="lineno"> 1817</span>  </div>
<div class="line"><a name="l01818"></a><span class="lineno"> 1818</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l01819"></a><span class="lineno"> 1819</span>  }</div>
<div class="line"><a name="l01820"></a><span class="lineno"> 1820</span>  SECTION( <span class="stringliteral">"unitarity"</span> ) {</div>
<div class="line"><a name="l01821"></a><span class="lineno"> 1821</span>  </div>
<div class="line"><a name="l01822"></a><span class="lineno"> 1822</span>  <span class="keywordtype">int</span> numTargs = GENERATE_COPY( range(1,maxNumTargs) );</div>
<div class="line"><a name="l01823"></a><span class="lineno"> 1823</span>  <span class="keywordtype">int</span> targs[numTargs];</div>
<div class="line"><a name="l01824"></a><span class="lineno"> 1824</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numTargs; i++)</div>
<div class="line"><a name="l01825"></a><span class="lineno"> 1825</span>  targs[i] = i+1;</div>
<div class="line"><a name="l01826"></a><span class="lineno"> 1826</span>  </div>
<div class="line"><a name="l01827"></a><span class="lineno"> 1827</span>  <a class="code" href="structComplexMatrixN.html">ComplexMatrixN</a> matr = <a class="code" href="group__type.html#ga815103261fb22ea9690e1427571df00e">createComplexMatrixN</a>(numTargs); <span class="comment">// initially zero, hence not-unitary</span></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>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga20bf9b8a71b8a3ee4651e9497e6d1f4f">multiQubitUnitary</a>(quregVec, targs, numTargs, matr), Contains(<span class="stringliteral">"unitary"</span>) );</div>
<div class="line"><a name="l01830"></a><span class="lineno"> 1830</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</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>  SECTION( <span class="stringliteral">"unitary creation"</span> ) {</div>
<div class="line"><a name="l01833"></a><span class="lineno"> 1833</span>  </div>
<div class="line"><a name="l01834"></a><span class="lineno"> 1834</span>  <span class="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l01835"></a><span class="lineno"> 1835</span>  <span class="keywordtype">int</span> targs[] = {1,2,3};</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">/* compilers don't auto-initialise to NULL; the below circumstance </span></div>
<div class="line"><a name="l01838"></a><span class="lineno"> 1838</span> <span class="comment"> * only really occurs when 'malloc' returns NULL in createComplexMatrixN, </span></div>
<div class="line"><a name="l01839"></a><span class="lineno"> 1839</span> <span class="comment"> * which actually triggers its own validation. Hence this test is useless </span></div>
<div class="line"><a name="l01840"></a><span class="lineno"> 1840</span> <span class="comment"> * currently.</span></div>
<div class="line"><a name="l01841"></a><span class="lineno"> 1841</span> <span class="comment"> */</span></div>
<div class="line"><a name="l01842"></a><span class="lineno"> 1842</span>  <a class="code" href="structComplexMatrixN.html">ComplexMatrixN</a> matr;</div>
<div class="line"><a name="l01843"></a><span class="lineno"> 1843</span>  matr.<a class="code" href="structComplexMatrixN.html#a446e8a077597e4f76049d547df0c9738">real</a> = NULL;</div>
<div class="line"><a name="l01844"></a><span class="lineno"> 1844</span>  matr.<a class="code" href="structComplexMatrixN.html#afde13e469a3b4f179f45e53d1ec0a7cf">imag</a> = NULL; </div>
<div class="line"><a name="l01845"></a><span class="lineno"> 1845</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga20bf9b8a71b8a3ee4651e9497e6d1f4f">multiQubitUnitary</a>(quregVec, targs, numTargs, matr), Contains(<span class="stringliteral">"created"</span>) );</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>  SECTION( <span class="stringliteral">"unitary dimensions"</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>  <span class="keywordtype">int</span> targs[2] = {1,2};</div>
<div class="line"><a name="l01850"></a><span class="lineno"> 1850</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="l01851"></a><span class="lineno"> 1851</span>  </div>
<div class="line"><a name="l01852"></a><span class="lineno"> 1852</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga20bf9b8a71b8a3ee4651e9497e6d1f4f">multiQubitUnitary</a>(quregVec, targs, 2, matr), Contains(<span class="stringliteral">"matrix size"</span>));</div>
<div class="line"><a name="l01853"></a><span class="lineno"> 1853</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l01854"></a><span class="lineno"> 1854</span>  }</div>
<div class="line"><a name="l01855"></a><span class="lineno"> 1855</span>  SECTION( <span class="stringliteral">"unitary fits in node"</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>  <span class="comment">// pretend we have a very limited distributed memory (judged by matr size)</span></div>
<div class="line"><a name="l01858"></a><span class="lineno"> 1858</span>  quregVec.numAmpsPerChunk = 1;</div>
<div class="line"><a name="l01859"></a><span class="lineno"> 1859</span>  <span class="keywordtype">int</span> qb[] = {1,2};</div>
<div class="line"><a name="l01860"></a><span class="lineno"> 1860</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="l01861"></a><span class="lineno"> 1861</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga20bf9b8a71b8a3ee4651e9497e6d1f4f">multiQubitUnitary</a>(quregVec, qb, 2, matr), Contains(<span class="stringliteral">"targets too many qubits"</span>));</div>
<div class="line"><a name="l01862"></a><span class="lineno"> 1862</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</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>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l01866"></a><span class="lineno"> 1866</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST__validation_8c_source.html#l00328">calcLog2()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l01348">createComplexMatrixN()</a>, <a class="el" href="QuEST_8c_source.html#l01369">destroyComplexMatrixN()</a>, <a class="el" href="utilities_8cpp_source.html#l00530">getRandomUnitary()</a>, <a class="el" href="QuEST_8h_source.html#l00190">ComplexMatrixN::imag</a>, <a class="el" href="QuEST_8c_source.html#l00296">multiQubitUnitary()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, <a class="el" href="QuEST_8h_source.html#l00189">ComplexMatrixN::real</a>, <a class="el" href="utilities_8cpp_source.html#l01488">sublists()</a>, and <a class="el" href="utilities_8cpp_source.html#l01033">toComplexMatrixN()</a>.</p>
</div>
</div>
<a id="ga838f36bbb6dcb2aedca45153317fad16"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga838f36bbb6dcb2aedca45153317fad16">◆ </a></span>TEST_CASE() <span class="overload">[103/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"multiRotatePauli" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#ga34aa4865c92f9aa5d898c91286c9eca5" title="Apply a multi-qubit multi-Pauli rotation, also known as a Pauli gadget, on a selected number of qubit...">multiRotatePauli</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l01874">1874</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l01874"></a><span class="lineno"> 1874</span>  {</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>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l01877"></a><span class="lineno"> 1877</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> param = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-4*<a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>, 4*<a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>);</div>
<div class="line"><a name="l01878"></a><span class="lineno"> 1878</span>  </div>
<div class="line"><a name="l01879"></a><span class="lineno"> 1879</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l01880"></a><span class="lineno"> 1880</span>  </div>
<div class="line"><a name="l01881"></a><span class="lineno"> 1881</span>  <span class="keywordtype">int</span> numTargs = GENERATE( range(1,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1) );</div>
<div class="line"><a name="l01882"></a><span class="lineno"> 1882</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="l01883"></a><span class="lineno"> 1883</span>  </div>
<div class="line"><a name="l01884"></a><span class="lineno"> 1884</span>  <span class="comment">/* it's too expensive to try ALL Pauli sequences, via </span></div>
<div class="line"><a name="l01885"></a><span class="lineno"> 1885</span> <span class="comment"> * pauliOpType* paulis = GENERATE_COPY( pauliseqs(numTargs) );.</span></div>
<div class="line"><a name="l01886"></a><span class="lineno"> 1886</span> <span class="comment"> * Furthermore, take(10, pauliseqs(numTargs)) will try the same pauli codes.</span></div>
<div class="line"><a name="l01887"></a><span class="lineno"> 1887</span> <span class="comment"> * Hence, we instead opt to repeatedlyrandomly generate pauliseqs</span></div>
<div class="line"><a name="l01888"></a><span class="lineno"> 1888</span> <span class="comment"> */</span></div>
<div class="line"><a name="l01889"></a><span class="lineno"> 1889</span>  GENERATE( range(0,10) ); <span class="comment">// gen 10 random pauli-codes for every targs</span></div>
<div class="line"><a name="l01890"></a><span class="lineno"> 1890</span>  <a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a> paulis[numTargs];</div>
<div class="line"><a name="l01891"></a><span class="lineno"> 1891</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numTargs; i++)</div>
<div class="line"><a name="l01892"></a><span class="lineno"> 1892</span>  paulis[i] = (<a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a>) <a class="code" href="group__testutilities.html#ga7125d0747a44db58115899727ac5f6be">getRandomInt</a>(0,4);</div>
<div class="line"><a name="l01893"></a><span class="lineno"> 1893</span>  </div>
<div class="line"><a name="l01894"></a><span class="lineno"> 1894</span>  <span class="comment">// exclude identities from reference matrix exp (they apply unwanted global phase)</span></div>
<div class="line"><a name="l01895"></a><span class="lineno"> 1895</span>  <span class="keywordtype">int</span> refTargs[numTargs];</div>
<div class="line"><a name="l01896"></a><span class="lineno"> 1896</span>  <span class="keywordtype">int</span> numRefTargs = 0;</div>
<div class="line"><a name="l01897"></a><span class="lineno"> 1897</span>  </div>
<div class="line"><a name="l01898"></a><span class="lineno"> 1898</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> xMatr{{0,1},{1,0}};</div>
<div class="line"><a name="l01899"></a><span class="lineno"> 1899</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> yMatr{{0,-<a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>(0,1)},{<a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>(0,1),0}};</div>
<div class="line"><a name="l01900"></a><span class="lineno"> 1900</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> zMatr{{1,0},{0,-1}};</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>  <span class="comment">// build correct reference matrix by pauli-matrix exponentiation...</span></div>
<div class="line"><a name="l01903"></a><span class="lineno"> 1903</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> pauliProd{{1}};</div>
<div class="line"><a name="l01904"></a><span class="lineno"> 1904</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numTargs; i++) {</div>
<div class="line"><a name="l01905"></a><span class="lineno"> 1905</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> fac;</div>
<div class="line"><a name="l01906"></a><span class="lineno"> 1906</span>  <span class="keywordflow">if</span> (paulis[i] == <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a63800f45b01ccc2608f754aee850bf4a">PAULI_I</a>) <span class="keywordflow">continue</span>; <span class="comment">// exclude I-targets from ref list</span></div>
<div class="line"><a name="l01907"></a><span class="lineno"> 1907</span>  <span class="keywordflow">if</span> (paulis[i] == <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a7abac7bb5b71e17382014c443244ad5c">PAULI_X</a>) fac = xMatr;</div>
<div class="line"><a name="l01908"></a><span class="lineno"> 1908</span>  <span class="keywordflow">if</span> (paulis[i] == <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a2c64a9aaee27f6bcfef894d159e759bd">PAULI_Y</a>) fac = yMatr;</div>
<div class="line"><a name="l01909"></a><span class="lineno"> 1909</span>  <span class="keywordflow">if</span> (paulis[i] == <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a085c85cff6ba79c52d8b1e61c42ddddf">PAULI_Z</a>) fac = zMatr;</div>
<div class="line"><a name="l01910"></a><span class="lineno"> 1910</span>  pauliProd = <a class="code" href="group__testutilities.html#gab5ac6842ba67b8d38bd17385ab179b67">getKroneckerProduct</a>(fac, pauliProd);</div>
<div class="line"><a name="l01911"></a><span class="lineno"> 1911</span>  </div>
<div class="line"><a name="l01912"></a><span class="lineno"> 1912</span>  <span class="comment">// include this target in ref list</span></div>
<div class="line"><a name="l01913"></a><span class="lineno"> 1913</span>  refTargs[numRefTargs++] = targs[i];</div>
<div class="line"><a name="l01914"></a><span class="lineno"> 1914</span>  }</div>
<div class="line"><a name="l01915"></a><span class="lineno"> 1915</span>  </div>
<div class="line"><a name="l01916"></a><span class="lineno"> 1916</span>  <span class="comment">// produces exp(-i param/2 pauliProd), unless pauliProd = I</span></div>
<div class="line"><a name="l01917"></a><span class="lineno"> 1917</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op;</div>
<div class="line"><a name="l01918"></a><span class="lineno"> 1918</span>  <span class="keywordflow">if</span> (numRefTargs > 0)</div>
<div class="line"><a name="l01919"></a><span class="lineno"> 1919</span>  op = <a class="code" href="group__testutilities.html#ga00f4feec845c019c3390898b0cc7f1ef">getExponentialOfPauliMatrix</a>(param, pauliProd);</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>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l01922"></a><span class="lineno"> 1922</span>  </div>
<div class="line"><a name="l01923"></a><span class="lineno"> 1923</span>  <a class="code" href="group__unitary.html#ga34aa4865c92f9aa5d898c91286c9eca5">multiRotatePauli</a>(quregVec, targs, paulis, numTargs, param);</div>
<div class="line"><a name="l01924"></a><span class="lineno"> 1924</span>  <span class="keywordflow">if</span> (numRefTargs > 0)</div>
<div class="line"><a name="l01925"></a><span class="lineno"> 1925</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, refTargs, numRefTargs, op);</div>
<div class="line"><a name="l01926"></a><span class="lineno"> 1926</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l01927"></a><span class="lineno"> 1927</span>  }</div>
<div class="line"><a name="l01928"></a><span class="lineno"> 1928</span>  SECTION( <span class="stringliteral">"density-matrix"</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>  <a class="code" href="group__unitary.html#ga34aa4865c92f9aa5d898c91286c9eca5">multiRotatePauli</a>(quregMatr, targs, paulis, numTargs, param);</div>
<div class="line"><a name="l01931"></a><span class="lineno"> 1931</span>  <span class="keywordflow">if</span> (numRefTargs > 0)</div>
<div class="line"><a name="l01932"></a><span class="lineno"> 1932</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, refTargs, numRefTargs, op);</div>
<div class="line"><a name="l01933"></a><span class="lineno"> 1933</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 10*REAL_EPS) );</div>
<div class="line"><a name="l01934"></a><span class="lineno"> 1934</span>  }</div>
<div class="line"><a name="l01935"></a><span class="lineno"> 1935</span>  }</div>
<div class="line"><a name="l01936"></a><span class="lineno"> 1936</span>  SECTION( <span class="stringliteral">"input validation"</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>  SECTION( <span class="stringliteral">"number of targets"</span> ) {</div>
<div class="line"><a name="l01939"></a><span class="lineno"> 1939</span>  </div>
<div class="line"><a name="l01940"></a><span class="lineno"> 1940</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="l01941"></a><span class="lineno"> 1941</span>  <span class="keywordtype">int</span> targs[<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1]; <span class="comment">// prevent seg-fault if validation isn't triggered</span></div>
<div class="line"><a name="l01942"></a><span class="lineno"> 1942</span>  <a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a> paulis[<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1] = {<a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a63800f45b01ccc2608f754aee850bf4a">PAULI_I</a>};</div>
<div class="line"><a name="l01943"></a><span class="lineno"> 1943</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga34aa4865c92f9aa5d898c91286c9eca5">multiRotatePauli</a>(quregVec, targs, paulis, numTargs, param), Contains(<span class="stringliteral">"Invalid number of target"</span>));</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>  SECTION( <span class="stringliteral">"repetition of targets"</span> ) {</div>
<div class="line"><a name="l01946"></a><span class="lineno"> 1946</span>  </div>
<div class="line"><a name="l01947"></a><span class="lineno"> 1947</span>  <span class="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l01948"></a><span class="lineno"> 1948</span>  <span class="keywordtype">int</span> targs[3] = {0, 1, 1};</div>
<div class="line"><a name="l01949"></a><span class="lineno"> 1949</span>  <a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a> paulis[3] = {<a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a63800f45b01ccc2608f754aee850bf4a">PAULI_I</a>};</div>
<div class="line"><a name="l01950"></a><span class="lineno"> 1950</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga34aa4865c92f9aa5d898c91286c9eca5">multiRotatePauli</a>(quregVec, targs, paulis, numTargs, param), Contains(<span class="stringliteral">"target"</span>) && Contains(<span class="stringliteral">"unique"</span>));</div>
<div class="line"><a name="l01951"></a><span class="lineno"> 1951</span>  }</div>
<div class="line"><a name="l01952"></a><span class="lineno"> 1952</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l01953"></a><span class="lineno"> 1953</span>  </div>
<div class="line"><a name="l01954"></a><span class="lineno"> 1954</span>  <span class="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l01955"></a><span class="lineno"> 1955</span>  <span class="keywordtype">int</span> targs[3] = {0, 1, 2};</div>
<div class="line"><a name="l01956"></a><span class="lineno"> 1956</span>  targs[GENERATE_COPY(range(0,numTargs))] = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l01957"></a><span class="lineno"> 1957</span>  <a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a> paulis[3] = {<a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a63800f45b01ccc2608f754aee850bf4a">PAULI_I</a>};</div>
<div class="line"><a name="l01958"></a><span class="lineno"> 1958</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga34aa4865c92f9aa5d898c91286c9eca5">multiRotatePauli</a>(quregVec, targs, paulis, numTargs, param), Contains(<span class="stringliteral">"Invalid target"</span>));</div>
<div class="line"><a name="l01959"></a><span class="lineno"> 1959</span>  }</div>
<div class="line"><a name="l01960"></a><span class="lineno"> 1960</span>  SECTION( <span class="stringliteral">"pauli codes"</span> ) {</div>
<div class="line"><a name="l01961"></a><span class="lineno"> 1961</span>  <span class="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l01962"></a><span class="lineno"> 1962</span>  <span class="keywordtype">int</span> targs[3] = {0, 1, 2};</div>
<div class="line"><a name="l01963"></a><span class="lineno"> 1963</span>  <a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a> paulis[3] = {<a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a63800f45b01ccc2608f754aee850bf4a">PAULI_I</a>, <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a63800f45b01ccc2608f754aee850bf4a">PAULI_I</a>, <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a63800f45b01ccc2608f754aee850bf4a">PAULI_I</a>};</div>
<div class="line"><a name="l01964"></a><span class="lineno"> 1964</span>  paulis[GENERATE_COPY(range(0,numTargs))] = (<a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a>) GENERATE( -1, 4 );</div>
<div class="line"><a name="l01965"></a><span class="lineno"> 1965</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga34aa4865c92f9aa5d898c91286c9eca5">multiRotatePauli</a>(quregVec, targs, paulis, numTargs, param), Contains(<span class="stringliteral">"Invalid Pauli code"</span>));</div>
<div class="line"><a name="l01966"></a><span class="lineno"> 1966</span>  }</div>
<div class="line"><a name="l01967"></a><span class="lineno"> 1967</span>  }</div>
<div class="line"><a name="l01968"></a><span class="lineno"> 1968</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l01969"></a><span class="lineno"> 1969</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00216">getExponentialOfPauliMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00143">getKroneckerProduct()</a>, <a class="el" href="utilities_8cpp_source.html#l00526">getRandomInt()</a>, <a class="el" href="utilities_8cpp_source.html#l00421">getRandomReal()</a>, <a class="el" href="QuEST__common_8c_source.html#l00041">M_PI</a>, <a class="el" href="QuEST_8c_source.html#l00685">multiRotatePauli()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="QuEST_8h_source.html#l00096">PAULI_I</a>, <a class="el" href="QuEST_8h_source.html#l00096">PAULI_X</a>, <a class="el" href="QuEST_8h_source.html#l00096">PAULI_Y</a>, <a class="el" href="QuEST_8h_source.html#l00096">PAULI_Z</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, <a class="el" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, and <a class="el" href="utilities_8cpp_source.html#l01488">sublists()</a>.</p>
</div>
</div>
<a id="ga269a80f587f1aee7e9eddfbc18022f10"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga269a80f587f1aee7e9eddfbc18022f10">◆ </a></span>TEST_CASE() <span class="overload">[104/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"multiRotateZ" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#ga3250d0d95b5d755cad542a6a2372b894" title="Apply a multi-qubit Z rotation, also known as a phase gadget, on a selected number of qubits.">multiRotateZ</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l01977">1977</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><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>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l01980"></a><span class="lineno"> 1980</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> param = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-4*<a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>, 4*<a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>);</div>
<div class="line"><a name="l01981"></a><span class="lineno"> 1981</span>  </div>
<div class="line"><a name="l01982"></a><span class="lineno"> 1982</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l01983"></a><span class="lineno"> 1983</span>  </div>
<div class="line"><a name="l01984"></a><span class="lineno"> 1984</span>  <span class="keywordtype">int</span> numTargs = GENERATE( range(1,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1) );</div>
<div class="line"><a name="l01985"></a><span class="lineno"> 1985</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="l01986"></a><span class="lineno"> 1986</span>  </div>
<div class="line"><a name="l01987"></a><span class="lineno"> 1987</span>  <span class="comment">// build correct reference matrix by diagonal-matrix exponentiation...</span></div>
<div class="line"><a name="l01988"></a><span class="lineno"> 1988</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> zMatr{{1,0},{0,-1}};</div>
<div class="line"><a name="l01989"></a><span class="lineno"> 1989</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> zProd = zMatr;</div>
<div class="line"><a name="l01990"></a><span class="lineno"> 1990</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> t=0; t<numTargs-1; t++)</div>
<div class="line"><a name="l01991"></a><span class="lineno"> 1991</span>  zProd = <a class="code" href="group__testutilities.html#gab5ac6842ba67b8d38bd17385ab179b67">getKroneckerProduct</a>(zMatr, zProd); <span class="comment">// Z . Z ... Z</span></div>
<div class="line"><a name="l01992"></a><span class="lineno"> 1992</span>  </div>
<div class="line"><a name="l01993"></a><span class="lineno"> 1993</span>  <span class="comment">// (-i param/2) Z . I . Z ...</span></div>
<div class="line"><a name="l01994"></a><span class="lineno"> 1994</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> expArg = <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>(0, -param/2) *</div>
<div class="line"><a name="l01995"></a><span class="lineno"> 1995</span>  <a class="code" href="group__testutilities.html#ga20f041452b43026d876fde17a5999265">getFullOperatorMatrix</a>(NULL, 0, targs, numTargs, zProd, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>);</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>  <span class="comment">// exp( -i param/2 Z . I . Z ...)</span></div>
<div class="line"><a name="l01998"></a><span class="lineno"> 1998</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op = <a class="code" href="group__testutilities.html#gac60cee26113732c491f21dc43066b605">getExponentialOfDiagonalMatrix</a>(expArg);</div>
<div class="line"><a name="l01999"></a><span class="lineno"> 1999</span>  </div>
<div class="line"><a name="l02000"></a><span class="lineno"> 2000</span>  <span class="comment">// all qubits to specify full operator matrix on reference structures</span></div>
<div class="line"><a name="l02001"></a><span class="lineno"> 2001</span>  <span class="keywordtype">int</span> allQubits[<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>];</div>
<div class="line"><a name="l02002"></a><span class="lineno"> 2002</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>; i++)</div>
<div class="line"><a name="l02003"></a><span class="lineno"> 2003</span>  allQubits[i] = i;</div>
<div class="line"><a name="l02004"></a><span class="lineno"> 2004</span>  </div>
<div class="line"><a name="l02005"></a><span class="lineno"> 2005</span>  SECTION( <span class="stringliteral">"state-vector"</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>  <a class="code" href="group__unitary.html#ga3250d0d95b5d755cad542a6a2372b894">multiRotateZ</a>(quregVec, targs, numTargs, param);</div>
<div class="line"><a name="l02008"></a><span class="lineno"> 2008</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, allQubits, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, op);</div>
<div class="line"><a name="l02009"></a><span class="lineno"> 2009</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l02010"></a><span class="lineno"> 2010</span>  }</div>
<div class="line"><a name="l02011"></a><span class="lineno"> 2011</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l02012"></a><span class="lineno"> 2012</span>  </div>
<div class="line"><a name="l02013"></a><span class="lineno"> 2013</span>  <a class="code" href="group__unitary.html#ga3250d0d95b5d755cad542a6a2372b894">multiRotateZ</a>(quregMatr, targs, numTargs, param);</div>
<div class="line"><a name="l02014"></a><span class="lineno"> 2014</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, allQubits, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>, op);</div>
<div class="line"><a name="l02015"></a><span class="lineno"> 2015</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 2*REAL_EPS) );</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>  }</div>
<div class="line"><a name="l02018"></a><span class="lineno"> 2018</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l02019"></a><span class="lineno"> 2019</span>  </div>
<div class="line"><a name="l02020"></a><span class="lineno"> 2020</span>  SECTION( <span class="stringliteral">"number of targets"</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>  <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="l02023"></a><span class="lineno"> 2023</span>  <span class="keywordtype">int</span> targs[<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1]; <span class="comment">// prevent seg-fault if validation isn't triggered</span></div>
<div class="line"><a name="l02024"></a><span class="lineno"> 2024</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga3250d0d95b5d755cad542a6a2372b894">multiRotateZ</a>(quregVec, targs, numTargs, param), Contains(<span class="stringliteral">"Invalid number of target"</span>));</div>
<div class="line"><a name="l02025"></a><span class="lineno"> 2025</span>  </div>
<div class="line"><a name="l02026"></a><span class="lineno"> 2026</span>  }</div>
<div class="line"><a name="l02027"></a><span class="lineno"> 2027</span>  SECTION( <span class="stringliteral">"repetition of targets"</span> ) {</div>
<div class="line"><a name="l02028"></a><span class="lineno"> 2028</span>  </div>
<div class="line"><a name="l02029"></a><span class="lineno"> 2029</span>  <span class="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l02030"></a><span class="lineno"> 2030</span>  <span class="keywordtype">int</span> targs[3] = {0, 1, 1};</div>
<div class="line"><a name="l02031"></a><span class="lineno"> 2031</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga3250d0d95b5d755cad542a6a2372b894">multiRotateZ</a>(quregVec, targs, numTargs, param), Contains(<span class="stringliteral">"target"</span>) && Contains(<span class="stringliteral">"unique"</span>));</div>
<div class="line"><a name="l02032"></a><span class="lineno"> 2032</span>  }</div>
<div class="line"><a name="l02033"></a><span class="lineno"> 2033</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l02034"></a><span class="lineno"> 2034</span>  </div>
<div class="line"><a name="l02035"></a><span class="lineno"> 2035</span>  <span class="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l02036"></a><span class="lineno"> 2036</span>  <span class="keywordtype">int</span> targs[3] = {0, 1, 2};</div>
<div class="line"><a name="l02037"></a><span class="lineno"> 2037</span>  targs[GENERATE_COPY(range(0,numTargs))] = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l02038"></a><span class="lineno"> 2038</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga3250d0d95b5d755cad542a6a2372b894">multiRotateZ</a>(quregVec, targs, numTargs, param), Contains(<span class="stringliteral">"Invalid target"</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>  }</div>
<div class="line"><a name="l02041"></a><span class="lineno"> 2041</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l02042"></a><span class="lineno"> 2042</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00197">getExponentialOfDiagonalMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00304">getFullOperatorMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00143">getKroneckerProduct()</a>, <a class="el" href="utilities_8cpp_source.html#l00421">getRandomReal()</a>, <a class="el" href="QuEST__common_8c_source.html#l00041">M_PI</a>, <a class="el" href="QuEST_8c_source.html#l00652">multiRotateZ()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, <a class="el" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, and <a class="el" href="utilities_8cpp_source.html#l01488">sublists()</a>.</p>
</div>
</div>
<a id="ga293349dc468b808c15bd68891370ef11"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga293349dc468b808c15bd68891370ef11">◆ </a></span>TEST_CASE() <span class="overload">[105/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"multiStateControlledUnitary" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#ga41b946a82982c3fa3dc2a7395665bc90" title="Apply a general single-qubit unitary with multiple control qubits, conditioned upon a specific bit se...">multiStateControlledUnitary</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l02050">2050</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l02050"></a><span class="lineno"> 2050</span>  {</div>
<div class="line"><a name="l02051"></a><span class="lineno"> 2051</span>  </div>
<div class="line"><a name="l02052"></a><span class="lineno"> 2052</span>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</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>  <span class="comment">// every test will use a unique random matrix</span></div>
<div class="line"><a name="l02055"></a><span class="lineno"> 2055</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op = <a class="code" href="group__testutilities.html#ga1a5e9b668716b91dd8527ce00f7500cf">getRandomUnitary</a>(1);</div>
<div class="line"><a name="l02056"></a><span class="lineno"> 2056</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="l02057"></a><span class="lineno"> 2057</span>  </div>
<div class="line"><a name="l02058"></a><span class="lineno"> 2058</span>  <span class="comment">// the zero-conditioned control qubits can be effected by notting before/after ctrls</span></div>
<div class="line"><a name="l02059"></a><span class="lineno"> 2059</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> notOp{{0,1},{1,0}};</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">"correctness"</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> target = GENERATE( range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) );</div>
<div class="line"><a name="l02064"></a><span class="lineno"> 2064</span>  <span class="keywordtype">int</span> numCtrls = GENERATE( range(1,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) ); <span class="comment">// leave space for one target (exclusive upper bound)</span></div>
<div class="line"><a name="l02065"></a><span class="lineno"> 2065</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, target) );</div>
<div class="line"><a name="l02066"></a><span class="lineno"> 2066</span>  <span class="keywordtype">int</span>* ctrlState = GENERATE_COPY( <a class="code" href="group__testutilities.html#ga2e09685323c6b2312a64daf8c74b12b5">bitsets</a>(numCtrls) );</div>
<div class="line"><a name="l02067"></a><span class="lineno"> 2067</span>  </div>
<div class="line"><a name="l02068"></a><span class="lineno"> 2068</span>  SECTION( <span class="stringliteral">"state-vector"</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="group__unitary.html#ga41b946a82982c3fa3dc2a7395665bc90">multiStateControlledUnitary</a>(quregVec, ctrls, ctrlState, numCtrls, target, matr);</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>  <span class="comment">// simulate controlled-state by notting before & after controls</span></div>
<div class="line"><a name="l02073"></a><span class="lineno"> 2073</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numCtrls; i++)</div>
<div class="line"><a name="l02074"></a><span class="lineno"> 2074</span>  <span class="keywordflow">if</span> (ctrlState[i] == 0)</div>
<div class="line"><a name="l02075"></a><span class="lineno"> 2075</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, ctrls[i], notOp);</div>
<div class="line"><a name="l02076"></a><span class="lineno"> 2076</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, ctrls, numCtrls, target, op);</div>
<div class="line"><a name="l02077"></a><span class="lineno"> 2077</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numCtrls; i++)</div>
<div class="line"><a name="l02078"></a><span class="lineno"> 2078</span>  <span class="keywordflow">if</span> (ctrlState[i] == 0)</div>
<div class="line"><a name="l02079"></a><span class="lineno"> 2079</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, ctrls[i], notOp);</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>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</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">"density-matrix"</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>  <a class="code" href="group__unitary.html#ga41b946a82982c3fa3dc2a7395665bc90">multiStateControlledUnitary</a>(quregMatr, ctrls, ctrlState, numCtrls, target, matr);</div>
<div class="line"><a name="l02086"></a><span class="lineno"> 2086</span>  </div>
<div class="line"><a name="l02087"></a><span class="lineno"> 2087</span>  <span class="comment">// simulate controlled-state by notting before & after controls</span></div>
<div class="line"><a name="l02088"></a><span class="lineno"> 2088</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numCtrls; i++)</div>
<div class="line"><a name="l02089"></a><span class="lineno"> 2089</span>  <span class="keywordflow">if</span> (ctrlState[i] == 0)</div>
<div class="line"><a name="l02090"></a><span class="lineno"> 2090</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, ctrls[i], notOp);</div>
<div class="line"><a name="l02091"></a><span class="lineno"> 2091</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, ctrls, numCtrls, target, op);</div>
<div class="line"><a name="l02092"></a><span class="lineno"> 2092</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numCtrls; i++)</div>
<div class="line"><a name="l02093"></a><span class="lineno"> 2093</span>  <span class="keywordflow">if</span> (ctrlState[i] == 0)</div>
<div class="line"><a name="l02094"></a><span class="lineno"> 2094</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, ctrls[i], notOp);</div>
<div class="line"><a name="l02095"></a><span class="lineno"> 2095</span>  </div>
<div class="line"><a name="l02096"></a><span class="lineno"> 2096</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 10*REAL_EPS) );</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>  }</div>
<div class="line"><a name="l02099"></a><span class="lineno"> 2099</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l02100"></a><span class="lineno"> 2100</span>  </div>
<div class="line"><a name="l02101"></a><span class="lineno"> 2101</span>  SECTION( <span class="stringliteral">"number of controls"</span> ) {</div>
<div class="line"><a name="l02102"></a><span class="lineno"> 2102</span>  </div>
<div class="line"><a name="l02103"></a><span class="lineno"> 2103</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="l02104"></a><span class="lineno"> 2104</span>  <span class="keywordtype">int</span> ctrls[<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1]; </div>
<div class="line"><a name="l02105"></a><span class="lineno"> 2105</span>  <span class="keywordtype">int</span> ctrlState[<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>+1] = {0}; </div>
<div class="line"><a name="l02106"></a><span class="lineno"> 2106</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga41b946a82982c3fa3dc2a7395665bc90">multiStateControlledUnitary</a>(quregVec, ctrls, ctrlState, numCtrls, 0, matr), Contains(<span class="stringliteral">"Invalid number of control"</span>));</div>
<div class="line"><a name="l02107"></a><span class="lineno"> 2107</span>  }</div>
<div class="line"><a name="l02108"></a><span class="lineno"> 2108</span>  SECTION( <span class="stringliteral">"repetition of controls"</span> ) {</div>
<div class="line"><a name="l02109"></a><span class="lineno"> 2109</span>  </div>
<div class="line"><a name="l02110"></a><span class="lineno"> 2110</span>  <span class="keywordtype">int</span> ctrls[] = {0,1,1};</div>
<div class="line"><a name="l02111"></a><span class="lineno"> 2111</span>  <span class="keywordtype">int</span> ctrlState[] = {0, 1, 0};</div>
<div class="line"><a name="l02112"></a><span class="lineno"> 2112</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga41b946a82982c3fa3dc2a7395665bc90">multiStateControlledUnitary</a>(quregVec, ctrls, ctrlState, 3, 2, matr), Contains(<span class="stringliteral">"control"</span>) && Contains(<span class="stringliteral">"unique"</span>));</div>
<div class="line"><a name="l02113"></a><span class="lineno"> 2113</span>  }</div>
<div class="line"><a name="l02114"></a><span class="lineno"> 2114</span>  SECTION( <span class="stringliteral">"control and target collision"</span> ) {</div>
<div class="line"><a name="l02115"></a><span class="lineno"> 2115</span>  </div>
<div class="line"><a name="l02116"></a><span class="lineno"> 2116</span>  <span class="keywordtype">int</span> ctrls[] = {0,1,2};</div>
<div class="line"><a name="l02117"></a><span class="lineno"> 2117</span>  <span class="keywordtype">int</span> ctrlState[] = {0, 1, 0};</div>
<div class="line"><a name="l02118"></a><span class="lineno"> 2118</span>  <span class="keywordtype">int</span> targ = ctrls[GENERATE( range(0,3) )];</div>
<div class="line"><a name="l02119"></a><span class="lineno"> 2119</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga41b946a82982c3fa3dc2a7395665bc90">multiStateControlledUnitary</a>(quregVec, ctrls, ctrlState, 3, targ, matr), Contains(<span class="stringliteral">"Control"</span>) && Contains(<span class="stringliteral">"target"</span>) );</div>
<div class="line"><a name="l02120"></a><span class="lineno"> 2120</span>  }</div>
<div class="line"><a name="l02121"></a><span class="lineno"> 2121</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l02122"></a><span class="lineno"> 2122</span>  </div>
<div class="line"><a name="l02123"></a><span class="lineno"> 2123</span>  <span class="keywordtype">int</span> ctrls[] = { 1, 2, GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> ) };</div>
<div class="line"><a name="l02124"></a><span class="lineno"> 2124</span>  <span class="keywordtype">int</span> ctrlState[] = {0, 1, 0};</div>
<div class="line"><a name="l02125"></a><span class="lineno"> 2125</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga41b946a82982c3fa3dc2a7395665bc90">multiStateControlledUnitary</a>(quregVec, ctrls, ctrlState, 3, 0, matr), Contains(<span class="stringliteral">"Invalid control"</span>) );</div>
<div class="line"><a name="l02126"></a><span class="lineno"> 2126</span>  </div>
<div class="line"><a name="l02127"></a><span class="lineno"> 2127</span>  ctrls[2] = 3; <span class="comment">// make ctrls valid </span></div>
<div class="line"><a name="l02128"></a><span class="lineno"> 2128</span>  <span class="keywordtype">int</span> targ = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l02129"></a><span class="lineno"> 2129</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga41b946a82982c3fa3dc2a7395665bc90">multiStateControlledUnitary</a>(quregVec, ctrls, ctrlState, 3, targ, matr), Contains(<span class="stringliteral">"Invalid target"</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>  SECTION( <span class="stringliteral">"unitarity"</span> ) {</div>
<div class="line"><a name="l02132"></a><span class="lineno"> 2132</span>  </div>
<div class="line"><a name="l02133"></a><span class="lineno"> 2133</span>  matr.<a class="code" href="structComplexMatrix2.html#a3ea98d545b67a190ee6abe936c72076f">real</a>[0][0] = 0; <span class="comment">// break matr unitarity</span></div>
<div class="line"><a name="l02134"></a><span class="lineno"> 2134</span>  <span class="keywordtype">int</span> ctrls[] = {0};</div>
<div class="line"><a name="l02135"></a><span class="lineno"> 2135</span>  <span class="keywordtype">int</span> ctrlState[1] = {0};</div>
<div class="line"><a name="l02136"></a><span class="lineno"> 2136</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga41b946a82982c3fa3dc2a7395665bc90">multiStateControlledUnitary</a>(quregVec, ctrls, ctrlState, 1, 1, matr), Contains(<span class="stringliteral">"unitary"</span>) );</div>
<div class="line"><a name="l02137"></a><span class="lineno"> 2137</span>  }</div>
<div class="line"><a name="l02138"></a><span class="lineno"> 2138</span>  SECTION( <span class="stringliteral">"control state bits"</span> ) {</div>
<div class="line"><a name="l02139"></a><span class="lineno"> 2139</span>  </div>
<div class="line"><a name="l02140"></a><span class="lineno"> 2140</span>  <span class="comment">// valid qubits</span></div>
<div class="line"><a name="l02141"></a><span class="lineno"> 2141</span>  <span class="keywordtype">int</span> ctrls[] = {0, 1, 2};</div>
<div class="line"><a name="l02142"></a><span class="lineno"> 2142</span>  <span class="keywordtype">int</span> ctrlState[] = {0, 0, 0};</div>
<div class="line"><a name="l02143"></a><span class="lineno"> 2143</span>  <span class="keywordtype">int</span> targ = 3;</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>  <span class="comment">// make invalid </span></div>
<div class="line"><a name="l02146"></a><span class="lineno"> 2146</span>  ctrlState[2] = GENERATE(-1, 2);</div>
<div class="line"><a name="l02147"></a><span class="lineno"> 2147</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga41b946a82982c3fa3dc2a7395665bc90">multiStateControlledUnitary</a>(quregVec, ctrls, ctrlState, 3, targ, matr), Contains(<span class="stringliteral">"state"</span>) );</div>
<div class="line"><a name="l02148"></a><span class="lineno"> 2148</span>  }</div>
<div class="line"><a name="l02149"></a><span class="lineno"> 2149</span>  }</div>
<div class="line"><a name="l02150"></a><span class="lineno"> 2150</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l02151"></a><span class="lineno"> 2151</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="utilities_8cpp_source.html#l01557">bitsets()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00530">getRandomUnitary()</a>, <a class="el" href="QuEST_8c_source.html#l00388">multiStateControlledUnitary()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, <a class="el" href="QuEST_8h_source.html#l00139">ComplexMatrix2::real</a>, <a class="el" href="utilities_8cpp_source.html#l01488">sublists()</a>, and <a class="el" href="utilities_8cpp_source.html#l01021">toComplexMatrix2()</a>.</p>
</div>
</div>
<a id="ga873998873d09f3c3fa51e46c39076dee"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga873998873d09f3c3fa51e46c39076dee">◆ </a></span>TEST_CASE() <span class="overload">[106/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"pauliX" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#ga4193c14cfb918fa3291fb0648058d63e" title="Apply the single-qubit Pauli-X (also known as the X, sigma-X, NOT or bit-flip) gate.">pauliX</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l02159">2159</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l02159"></a><span class="lineno"> 2159</span>  {</div>
<div class="line"><a name="l02160"></a><span class="lineno"> 2160</span>  </div>
<div class="line"><a name="l02161"></a><span class="lineno"> 2161</span>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l02162"></a><span class="lineno"> 2162</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op{{0,1},{1,0}};</div>
<div class="line"><a name="l02163"></a><span class="lineno"> 2163</span>  </div>
<div class="line"><a name="l02164"></a><span class="lineno"> 2164</span>  SECTION( <span class="stringliteral">"correctness"</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>  <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="l02167"></a><span class="lineno"> 2167</span>  </div>
<div class="line"><a name="l02168"></a><span class="lineno"> 2168</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l02169"></a><span class="lineno"> 2169</span>  </div>
<div class="line"><a name="l02170"></a><span class="lineno"> 2170</span>  <a class="code" href="group__unitary.html#ga4193c14cfb918fa3291fb0648058d63e">pauliX</a>(quregVec, target);</div>
<div class="line"><a name="l02171"></a><span class="lineno"> 2171</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, target, op);</div>
<div class="line"><a name="l02172"></a><span class="lineno"> 2172</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</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">"density-matrix correctness"</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>  <a class="code" href="group__unitary.html#ga4193c14cfb918fa3291fb0648058d63e">pauliX</a>(quregMatr, target);</div>
<div class="line"><a name="l02177"></a><span class="lineno"> 2177</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, target, op);</div>
<div class="line"><a name="l02178"></a><span class="lineno"> 2178</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</div>
<div class="line"><a name="l02179"></a><span class="lineno"> 2179</span>  }</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>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l02182"></a><span class="lineno"> 2182</span>  </div>
<div class="line"><a name="l02183"></a><span class="lineno"> 2183</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l02184"></a><span class="lineno"> 2184</span>  </div>
<div class="line"><a name="l02185"></a><span class="lineno"> 2185</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="l02186"></a><span class="lineno"> 2186</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga4193c14cfb918fa3291fb0648058d63e">pauliX</a>(quregVec, target), Contains(<span class="stringliteral">"Invalid target"</span>) );</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>  }</div>
<div class="line"><a name="l02189"></a><span class="lineno"> 2189</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l02190"></a><span class="lineno"> 2190</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="QuEST_8c_source.html#l00432">pauliX()</a>, and <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>.</p>
</div>
</div>
<a id="ga751edff600b7ffba3a9d85565e246325"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga751edff600b7ffba3a9d85565e246325">◆ </a></span>TEST_CASE() <span class="overload">[107/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"pauliY" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#ga8e0f03e745778a89d6f59c3c25e32df8" title="Apply the single-qubit Pauli-Y (also known as the Y or sigma-Y) gate.">pauliY</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l02198">2198</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l02198"></a><span class="lineno"> 2198</span>  {</div>
<div class="line"><a name="l02199"></a><span class="lineno"> 2199</span>  </div>
<div class="line"><a name="l02200"></a><span class="lineno"> 2200</span>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l02201"></a><span class="lineno"> 2201</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op{{0,-<a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>(0,1)},{<a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>(0,1),0}};</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">"correctness"</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="keywordtype">int</span> target = GENERATE( range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) );</div>
<div class="line"><a name="l02206"></a><span class="lineno"> 2206</span>  </div>
<div class="line"><a name="l02207"></a><span class="lineno"> 2207</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l02208"></a><span class="lineno"> 2208</span>  </div>
<div class="line"><a name="l02209"></a><span class="lineno"> 2209</span>  <a class="code" href="group__unitary.html#ga8e0f03e745778a89d6f59c3c25e32df8">pauliY</a>(quregVec, target);</div>
<div class="line"><a name="l02210"></a><span class="lineno"> 2210</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, target, op);</div>
<div class="line"><a name="l02211"></a><span class="lineno"> 2211</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l02212"></a><span class="lineno"> 2212</span>  }</div>
<div class="line"><a name="l02213"></a><span class="lineno"> 2213</span>  SECTION( <span class="stringliteral">"density-matrix correctness"</span> ) {</div>
<div class="line"><a name="l02214"></a><span class="lineno"> 2214</span>  </div>
<div class="line"><a name="l02215"></a><span class="lineno"> 2215</span>  <a class="code" href="group__unitary.html#ga8e0f03e745778a89d6f59c3c25e32df8">pauliY</a>(quregMatr, target);</div>
<div class="line"><a name="l02216"></a><span class="lineno"> 2216</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, target, op);</div>
<div class="line"><a name="l02217"></a><span class="lineno"> 2217</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</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>  }</div>
<div class="line"><a name="l02220"></a><span class="lineno"> 2220</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l02221"></a><span class="lineno"> 2221</span>  </div>
<div class="line"><a name="l02222"></a><span class="lineno"> 2222</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l02223"></a><span class="lineno"> 2223</span>  </div>
<div class="line"><a name="l02224"></a><span class="lineno"> 2224</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="l02225"></a><span class="lineno"> 2225</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga8e0f03e745778a89d6f59c3c25e32df8">pauliY</a>(quregVec, target), Contains(<span class="stringliteral">"Invalid target"</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>  }</div>
<div class="line"><a name="l02228"></a><span class="lineno"> 2228</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l02229"></a><span class="lineno"> 2229</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="QuEST_8c_source.html#l00443">pauliY()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, and <a class="el" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>.</p>
</div>
</div>
<a id="ga25a1ad7cfce5d2dcf4365bc107aeeb6c"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga25a1ad7cfce5d2dcf4365bc107aeeb6c">◆ </a></span>TEST_CASE() <span class="overload">[108/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"pauliZ" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#ga5d80b490e3910aa737a81bb597cdfcc9" title="Apply the single-qubit Pauli-Z (also known as the Z, sigma-Z or phase-flip) gate.">pauliZ</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l02237">2237</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l02237"></a><span class="lineno"> 2237</span>  {</div>
<div class="line"><a name="l02238"></a><span class="lineno"> 2238</span>  </div>
<div class="line"><a name="l02239"></a><span class="lineno"> 2239</span>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l02240"></a><span class="lineno"> 2240</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op{{1,0},{0,-1}};</div>
<div class="line"><a name="l02241"></a><span class="lineno"> 2241</span>  </div>
<div class="line"><a name="l02242"></a><span class="lineno"> 2242</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l02243"></a><span class="lineno"> 2243</span>  </div>
<div class="line"><a name="l02244"></a><span class="lineno"> 2244</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="l02245"></a><span class="lineno"> 2245</span>  </div>
<div class="line"><a name="l02246"></a><span class="lineno"> 2246</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l02247"></a><span class="lineno"> 2247</span>  </div>
<div class="line"><a name="l02248"></a><span class="lineno"> 2248</span>  <a class="code" href="group__unitary.html#ga5d80b490e3910aa737a81bb597cdfcc9">pauliZ</a>(quregVec, target);</div>
<div class="line"><a name="l02249"></a><span class="lineno"> 2249</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, target, op);</div>
<div class="line"><a name="l02250"></a><span class="lineno"> 2250</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l02251"></a><span class="lineno"> 2251</span>  }</div>
<div class="line"><a name="l02252"></a><span class="lineno"> 2252</span>  SECTION( <span class="stringliteral">"density-matrix correctness"</span> ) {</div>
<div class="line"><a name="l02253"></a><span class="lineno"> 2253</span>  </div>
<div class="line"><a name="l02254"></a><span class="lineno"> 2254</span>  <a class="code" href="group__unitary.html#ga5d80b490e3910aa737a81bb597cdfcc9">pauliZ</a>(quregMatr, target);</div>
<div class="line"><a name="l02255"></a><span class="lineno"> 2255</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, target, op);</div>
<div class="line"><a name="l02256"></a><span class="lineno"> 2256</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</div>
<div class="line"><a name="l02257"></a><span class="lineno"> 2257</span>  }</div>
<div class="line"><a name="l02258"></a><span class="lineno"> 2258</span>  }</div>
<div class="line"><a name="l02259"></a><span class="lineno"> 2259</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</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>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l02262"></a><span class="lineno"> 2262</span>  </div>
<div class="line"><a name="l02263"></a><span class="lineno"> 2263</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="l02264"></a><span class="lineno"> 2264</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga5d80b490e3910aa737a81bb597cdfcc9">pauliZ</a>(quregVec, target), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l02265"></a><span class="lineno"> 2265</span>  }</div>
<div class="line"><a name="l02266"></a><span class="lineno"> 2266</span>  }</div>
<div class="line"><a name="l02267"></a><span class="lineno"> 2267</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l02268"></a><span class="lineno"> 2268</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="QuEST_8c_source.html#l00454">pauliZ()</a>, and <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>.</p>
</div>
</div>
<a id="ga80f19ddf4e3207f35d4e2c75da05de0e"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga80f19ddf4e3207f35d4e2c75da05de0e">◆ </a></span>TEST_CASE() <span class="overload">[109/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"phaseShift" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#ga26baa057f5db8804825c2d611386753b" title="Shift the phase between and of a single qubit by a given angle.">phaseShift</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l02276">2276</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l02276"></a><span class="lineno"> 2276</span>  {</div>
<div class="line"><a name="l02277"></a><span class="lineno"> 2277</span>  </div>
<div class="line"><a name="l02278"></a><span class="lineno"> 2278</span>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l02279"></a><span class="lineno"> 2279</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> param = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-2*<a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>, 2*<a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>);</div>
<div class="line"><a name="l02280"></a><span class="lineno"> 2280</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op{{1,0},{0,<a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(param)}};</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">"correctness"</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>  <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="l02285"></a><span class="lineno"> 2285</span>  </div>
<div class="line"><a name="l02286"></a><span class="lineno"> 2286</span>  SECTION( <span class="stringliteral">"state-vector "</span>) {</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>  <a class="code" href="group__unitary.html#ga26baa057f5db8804825c2d611386753b">phaseShift</a>(quregVec, target, param);</div>
<div class="line"><a name="l02289"></a><span class="lineno"> 2289</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, target, op);</div>
<div class="line"><a name="l02290"></a><span class="lineno"> 2290</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l02291"></a><span class="lineno"> 2291</span>  }</div>
<div class="line"><a name="l02292"></a><span class="lineno"> 2292</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</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>  <a class="code" href="group__unitary.html#ga26baa057f5db8804825c2d611386753b">phaseShift</a>(quregMatr, target, param);</div>
<div class="line"><a name="l02295"></a><span class="lineno"> 2295</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, target, op);</div>
<div class="line"><a name="l02296"></a><span class="lineno"> 2296</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</div>
<div class="line"><a name="l02297"></a><span class="lineno"> 2297</span>  }</div>
<div class="line"><a name="l02298"></a><span class="lineno"> 2298</span>  }</div>
<div class="line"><a name="l02299"></a><span class="lineno"> 2299</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l02300"></a><span class="lineno"> 2300</span>  </div>
<div class="line"><a name="l02301"></a><span class="lineno"> 2301</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l02302"></a><span class="lineno"> 2302</span>  </div>
<div class="line"><a name="l02303"></a><span class="lineno"> 2303</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="l02304"></a><span class="lineno"> 2304</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga26baa057f5db8804825c2d611386753b">phaseShift</a>(quregVec, target, param), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l02305"></a><span class="lineno"> 2305</span>  }</div>
<div class="line"><a name="l02306"></a><span class="lineno"> 2306</span>  }</div>
<div class="line"><a name="l02307"></a><span class="lineno"> 2307</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l02308"></a><span class="lineno"> 2308</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00417">expI()</a>, <a class="el" href="utilities_8cpp_source.html#l00421">getRandomReal()</a>, <a class="el" href="QuEST__common_8c_source.html#l00041">M_PI</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="QuEST_8c_source.html#l00487">phaseShift()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, and <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>.</p>
</div>
</div>
<a id="gaa95c4914751cec33d489db13ee199043"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaa95c4914751cec33d489db13ee199043">◆ </a></span>TEST_CASE() <span class="overload">[110/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"rotateAroundAxis" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#ga4c708f066b244801e10f538b48b90145" title="Rotate a single qubit by a given angle around a given Vector on the Bloch-sphere.">rotateAroundAxis</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l02316">2316</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><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>  </div>
<div class="line"><a name="l02318"></a><span class="lineno"> 2318</span>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l02319"></a><span class="lineno"> 2319</span>  </div>
<div class="line"><a name="l02320"></a><span class="lineno"> 2320</span>  <span class="comment">// each test will use a random parameter and axis vector </span></div>
<div class="line"><a name="l02321"></a><span class="lineno"> 2321</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> param = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-4*<a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>, 4*<a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>);</div>
<div class="line"><a name="l02322"></a><span class="lineno"> 2322</span>  <a class="code" href="structVector.html">Vector</a> vec = {.<a class="code" href="structVector.html#a0d0459a5b731ac5fb3dff2c6134e6e88">x</a>=<a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-1,1), .y=<a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-1,1), .z=<a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-1,1)};</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>  <span class="comment">// Rn(a) = cos(a/2)I - i sin(a/2) n . paulivector</span></div>
<div class="line"><a name="l02325"></a><span class="lineno"> 2325</span>  <span class="comment">// (pg 24 of vcpc.univie.ac.at/~ian/hotlist/qc/talks/bloch-sphere-rotations.pdf)</span></div>
<div class="line"><a name="l02326"></a><span class="lineno"> 2326</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> c = cos(param/2);</div>
<div class="line"><a name="l02327"></a><span class="lineno"> 2327</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> s = sin(param/2);</div>
<div class="line"><a name="l02328"></a><span class="lineno"> 2328</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> m = sqrt(vec.<a class="code" href="structVector.html#a0d0459a5b731ac5fb3dff2c6134e6e88">x</a>*vec.<a class="code" href="structVector.html#a0d0459a5b731ac5fb3dff2c6134e6e88">x</a> + vec.<a class="code" href="structVector.html#abc3cfc6c8e297b1153a373d84b981e6b">y</a>*vec.<a class="code" href="structVector.html#abc3cfc6c8e297b1153a373d84b981e6b">y</a> + vec.<a class="code" href="structVector.html#ab33976d8fda2e44b770f71269d698a25">z</a>*vec.<a class="code" href="structVector.html#ab33976d8fda2e44b770f71269d698a25">z</a>);</div>
<div class="line"><a name="l02329"></a><span class="lineno"> 2329</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op{{c - <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>(0,1)*vec.<a class="code" href="structVector.html#ab33976d8fda2e44b770f71269d698a25">z</a>*s/m, -(vec.<a class="code" href="structVector.html#abc3cfc6c8e297b1153a373d84b981e6b">y</a> + <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>(0,1)*vec.<a class="code" href="structVector.html#a0d0459a5b731ac5fb3dff2c6134e6e88">x</a>)*s/m}, </div>
<div class="line"><a name="l02330"></a><span class="lineno"> 2330</span>  {(vec.<a class="code" href="structVector.html#abc3cfc6c8e297b1153a373d84b981e6b">y</a> - <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>(0,1)*vec.<a class="code" href="structVector.html#a0d0459a5b731ac5fb3dff2c6134e6e88">x</a>)*s/m, c + <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>(0,1)*vec.<a class="code" href="structVector.html#ab33976d8fda2e44b770f71269d698a25">z</a>*s/m}};</div>
<div class="line"><a name="l02331"></a><span class="lineno"> 2331</span>  </div>
<div class="line"><a name="l02332"></a><span class="lineno"> 2332</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l02333"></a><span class="lineno"> 2333</span>  </div>
<div class="line"><a name="l02334"></a><span class="lineno"> 2334</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="l02335"></a><span class="lineno"> 2335</span>  </div>
<div class="line"><a name="l02336"></a><span class="lineno"> 2336</span>  SECTION( <span class="stringliteral">"state-vector "</span>) {</div>
<div class="line"><a name="l02337"></a><span class="lineno"> 2337</span>  </div>
<div class="line"><a name="l02338"></a><span class="lineno"> 2338</span>  <a class="code" href="group__unitary.html#ga4c708f066b244801e10f538b48b90145">rotateAroundAxis</a>(quregVec, target, param, vec);</div>
<div class="line"><a name="l02339"></a><span class="lineno"> 2339</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, target, op);</div>
<div class="line"><a name="l02340"></a><span class="lineno"> 2340</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l02341"></a><span class="lineno"> 2341</span>  }</div>
<div class="line"><a name="l02342"></a><span class="lineno"> 2342</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l02343"></a><span class="lineno"> 2343</span>  </div>
<div class="line"><a name="l02344"></a><span class="lineno"> 2344</span>  <a class="code" href="group__unitary.html#ga4c708f066b244801e10f538b48b90145">rotateAroundAxis</a>(quregMatr, target, param, vec);</div>
<div class="line"><a name="l02345"></a><span class="lineno"> 2345</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, target, op);</div>
<div class="line"><a name="l02346"></a><span class="lineno"> 2346</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 10*REAL_EPS) );</div>
<div class="line"><a name="l02347"></a><span class="lineno"> 2347</span>  }</div>
<div class="line"><a name="l02348"></a><span class="lineno"> 2348</span>  }</div>
<div class="line"><a name="l02349"></a><span class="lineno"> 2349</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</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>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l02352"></a><span class="lineno"> 2352</span>  </div>
<div class="line"><a name="l02353"></a><span class="lineno"> 2353</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="l02354"></a><span class="lineno"> 2354</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga4c708f066b244801e10f538b48b90145">rotateAroundAxis</a>(quregVec, target, param, vec), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l02355"></a><span class="lineno"> 2355</span>  }</div>
<div class="line"><a name="l02356"></a><span class="lineno"> 2356</span>  SECTION( <span class="stringliteral">"zero rotation axis"</span> ) {</div>
<div class="line"><a name="l02357"></a><span class="lineno"> 2357</span>  </div>
<div class="line"><a name="l02358"></a><span class="lineno"> 2358</span>  <span class="keywordtype">int</span> target = 0;</div>
<div class="line"><a name="l02359"></a><span class="lineno"> 2359</span>  vec = {.<a class="code" href="structVector.html#a0d0459a5b731ac5fb3dff2c6134e6e88">x</a>=0, .y=0, .z=0};</div>
<div class="line"><a name="l02360"></a><span class="lineno"> 2360</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga4c708f066b244801e10f538b48b90145">rotateAroundAxis</a>(quregVec, target, param, vec), Contains(<span class="stringliteral">"Invalid axis"</span>) && Contains(<span class="stringliteral">"zero"</span>) );</div>
<div class="line"><a name="l02361"></a><span class="lineno"> 2361</span>  }</div>
<div class="line"><a name="l02362"></a><span class="lineno"> 2362</span>  }</div>
<div class="line"><a name="l02363"></a><span class="lineno"> 2363</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l02364"></a><span class="lineno"> 2364</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00421">getRandomReal()</a>, <a class="el" href="QuEST__common_8c_source.html#l00041">M_PI</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, <a class="el" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, <a class="el" href="QuEST_8c_source.html#l00601">rotateAroundAxis()</a>, <a class="el" href="QuEST_8h_source.html#l00200">Vector::x</a>, <a class="el" href="QuEST_8h_source.html#l00200">Vector::y</a>, and <a class="el" href="QuEST_8h_source.html#l00200">Vector::z</a>.</p>
</div>
</div>
<a id="ga8ab0a252e1289bc18855c992f2830cd8"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga8ab0a252e1289bc18855c992f2830cd8">◆ </a></span>TEST_CASE() <span class="overload">[111/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"rotateX" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#ga8886a3793b21622c48cf3bad6e15082d" title="Rotate a single qubit by a given angle around the X-axis of the Bloch-sphere.">rotateX</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l02372">2372</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l02372"></a><span class="lineno"> 2372</span>  {</div>
<div class="line"><a name="l02373"></a><span class="lineno"> 2373</span>  </div>
<div class="line"><a name="l02374"></a><span class="lineno"> 2374</span>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l02375"></a><span class="lineno"> 2375</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> param = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-4*<a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>, 4*<a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>);</div>
<div class="line"><a name="l02376"></a><span class="lineno"> 2376</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op{</div>
<div class="line"><a name="l02377"></a><span class="lineno"> 2377</span>  {cos(param/2), - sin(param/2)*<a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>(0,1)}, </div>
<div class="line"><a name="l02378"></a><span class="lineno"> 2378</span>  {- sin(param/2)*<a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>(0,1), cos(param/2)}};</div>
<div class="line"><a name="l02379"></a><span class="lineno"> 2379</span>  </div>
<div class="line"><a name="l02380"></a><span class="lineno"> 2380</span>  SECTION( <span class="stringliteral">"correctness"</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>  <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="l02383"></a><span class="lineno"> 2383</span>  </div>
<div class="line"><a name="l02384"></a><span class="lineno"> 2384</span>  SECTION( <span class="stringliteral">"state-vector "</span>) {</div>
<div class="line"><a name="l02385"></a><span class="lineno"> 2385</span>  </div>
<div class="line"><a name="l02386"></a><span class="lineno"> 2386</span>  <a class="code" href="group__unitary.html#ga8886a3793b21622c48cf3bad6e15082d">rotateX</a>(quregVec, target, param);</div>
<div class="line"><a name="l02387"></a><span class="lineno"> 2387</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, target, op);</div>
<div class="line"><a name="l02388"></a><span class="lineno"> 2388</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l02389"></a><span class="lineno"> 2389</span>  }</div>
<div class="line"><a name="l02390"></a><span class="lineno"> 2390</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</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>  <a class="code" href="group__unitary.html#ga8886a3793b21622c48cf3bad6e15082d">rotateX</a>(quregMatr, target, param);</div>
<div class="line"><a name="l02393"></a><span class="lineno"> 2393</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, target, op);</div>
<div class="line"><a name="l02394"></a><span class="lineno"> 2394</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</div>
<div class="line"><a name="l02395"></a><span class="lineno"> 2395</span>  }</div>
<div class="line"><a name="l02396"></a><span class="lineno"> 2396</span>  }</div>
<div class="line"><a name="l02397"></a><span class="lineno"> 2397</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</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>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</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>  <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="l02402"></a><span class="lineno"> 2402</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga8886a3793b21622c48cf3bad6e15082d">rotateX</a>(quregVec, target, param), Contains(<span class="stringliteral">"Invalid target"</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>  }</div>
<div class="line"><a name="l02405"></a><span class="lineno"> 2405</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l02406"></a><span class="lineno"> 2406</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00421">getRandomReal()</a>, <a class="el" href="QuEST__common_8c_source.html#l00041">M_PI</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, <a class="el" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, and <a class="el" href="QuEST_8c_source.html#l00187">rotateX()</a>.</p>
</div>
</div>
<a id="ga00ec5df7831d054696e55454f32435f9"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga00ec5df7831d054696e55454f32435f9">◆ </a></span>TEST_CASE() <span class="overload">[112/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"rotateY" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#ga34312ff52cc28bcab3cbd2ff338fd081" title="Rotate a single qubit by a given angle around the Y-axis of the Bloch-sphere.">rotateY</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l02414">2414</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l02414"></a><span class="lineno"> 2414</span>  {</div>
<div class="line"><a name="l02415"></a><span class="lineno"> 2415</span>  </div>
<div class="line"><a name="l02416"></a><span class="lineno"> 2416</span>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l02417"></a><span class="lineno"> 2417</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> param = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-4*<a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>, 4*<a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>);</div>
<div class="line"><a name="l02418"></a><span class="lineno"> 2418</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op{{cos(param/2), -sin(param/2)},{sin(param/2), cos(param/2)}};</div>
<div class="line"><a name="l02419"></a><span class="lineno"> 2419</span>  </div>
<div class="line"><a name="l02420"></a><span class="lineno"> 2420</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l02421"></a><span class="lineno"> 2421</span>  </div>
<div class="line"><a name="l02422"></a><span class="lineno"> 2422</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="l02423"></a><span class="lineno"> 2423</span>  </div>
<div class="line"><a name="l02424"></a><span class="lineno"> 2424</span>  SECTION( <span class="stringliteral">"state-vector "</span>) {</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>  <a class="code" href="group__unitary.html#ga34312ff52cc28bcab3cbd2ff338fd081">rotateY</a>(quregVec, target, param);</div>
<div class="line"><a name="l02427"></a><span class="lineno"> 2427</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, target, op);</div>
<div class="line"><a name="l02428"></a><span class="lineno"> 2428</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l02429"></a><span class="lineno"> 2429</span>  }</div>
<div class="line"><a name="l02430"></a><span class="lineno"> 2430</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l02431"></a><span class="lineno"> 2431</span>  </div>
<div class="line"><a name="l02432"></a><span class="lineno"> 2432</span>  <a class="code" href="group__unitary.html#ga34312ff52cc28bcab3cbd2ff338fd081">rotateY</a>(quregMatr, target, param);</div>
<div class="line"><a name="l02433"></a><span class="lineno"> 2433</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, target, op);</div>
<div class="line"><a name="l02434"></a><span class="lineno"> 2434</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 2*REAL_EPS) );</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>  }</div>
<div class="line"><a name="l02437"></a><span class="lineno"> 2437</span>  SECTION( <span class="stringliteral">"input validation"</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">"qubit indices"</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="keywordtype">int</span> target = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l02442"></a><span class="lineno"> 2442</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga34312ff52cc28bcab3cbd2ff338fd081">rotateY</a>(quregVec, target, param), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l02443"></a><span class="lineno"> 2443</span>  }</div>
<div class="line"><a name="l02444"></a><span class="lineno"> 2444</span>  }</div>
<div class="line"><a name="l02445"></a><span class="lineno"> 2445</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l02446"></a><span class="lineno"> 2446</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00421">getRandomReal()</a>, <a class="el" href="QuEST__common_8c_source.html#l00041">M_PI</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, and <a class="el" href="QuEST_8c_source.html#l00198">rotateY()</a>.</p>
</div>
</div>
<a id="ga62bc1f37d73821911d160c2d4aab2e2a"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga62bc1f37d73821911d160c2d4aab2e2a">◆ </a></span>TEST_CASE() <span class="overload">[113/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"rotateZ" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#gab23a8b022ec83b9d423961ca87cd8cb5" title="Rotate a single qubit by a given angle around the Z-axis of the Bloch-sphere (also known as a phase s...">rotateZ</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l02454">2454</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><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>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l02457"></a><span class="lineno"> 2457</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> param = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-4*<a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>, 4*<a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>);</div>
<div class="line"><a name="l02458"></a><span class="lineno"> 2458</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op{{<a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(-param/2.),0},{0,<a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(param/2.)}};</div>
<div class="line"><a name="l02459"></a><span class="lineno"> 2459</span>  </div>
<div class="line"><a name="l02460"></a><span class="lineno"> 2460</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l02461"></a><span class="lineno"> 2461</span>  </div>
<div class="line"><a name="l02462"></a><span class="lineno"> 2462</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="l02463"></a><span class="lineno"> 2463</span>  </div>
<div class="line"><a name="l02464"></a><span class="lineno"> 2464</span>  SECTION( <span class="stringliteral">"state-vector "</span>) {</div>
<div class="line"><a name="l02465"></a><span class="lineno"> 2465</span>  </div>
<div class="line"><a name="l02466"></a><span class="lineno"> 2466</span>  <a class="code" href="group__unitary.html#gab23a8b022ec83b9d423961ca87cd8cb5">rotateZ</a>(quregVec, target, param);</div>
<div class="line"><a name="l02467"></a><span class="lineno"> 2467</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, target, op);</div>
<div class="line"><a name="l02468"></a><span class="lineno"> 2468</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l02469"></a><span class="lineno"> 2469</span>  }</div>
<div class="line"><a name="l02470"></a><span class="lineno"> 2470</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l02471"></a><span class="lineno"> 2471</span>  </div>
<div class="line"><a name="l02472"></a><span class="lineno"> 2472</span>  <a class="code" href="group__unitary.html#gab23a8b022ec83b9d423961ca87cd8cb5">rotateZ</a>(quregMatr, target, param);</div>
<div class="line"><a name="l02473"></a><span class="lineno"> 2473</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, target, op);</div>
<div class="line"><a name="l02474"></a><span class="lineno"> 2474</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</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">"input validation"</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>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l02480"></a><span class="lineno"> 2480</span>  </div>
<div class="line"><a name="l02481"></a><span class="lineno"> 2481</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="l02482"></a><span class="lineno"> 2482</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gab23a8b022ec83b9d423961ca87cd8cb5">rotateZ</a>(quregVec, target, param), Contains(<span class="stringliteral">"Invalid target"</span>) );</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>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l02486"></a><span class="lineno"> 2486</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00417">expI()</a>, <a class="el" href="utilities_8cpp_source.html#l00421">getRandomReal()</a>, <a class="el" href="QuEST__common_8c_source.html#l00041">M_PI</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, and <a class="el" href="QuEST_8c_source.html#l00209">rotateZ()</a>.</p>
</div>
</div>
<a id="ga1331d2b39b5b126146735925cfc97179"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga1331d2b39b5b126146735925cfc97179">◆ </a></span>TEST_CASE() <span class="overload">[114/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"setAmps" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[state_initialisations] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__init.html#gabc0c64f8adf307d2a44184dc0f8ca66e" title="Overwrites a subset of the amplitudes in state-vector qureg, with those passed in reals and imags.">setAmps</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__state__initialisations_8cpp_source.html#l00381">381</a> of file <a class="el" href="test__state__initialisations_8cpp_source.html">test_state_initialisations.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00381"></a><span class="lineno"> 381</span>  {</div>
<div class="line"><a name="l00382"></a><span class="lineno"> 382</span>  </div>
<div class="line"><a name="l00383"></a><span class="lineno"> 383</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="l00384"></a><span class="lineno"> 384</span>  </div>
<div class="line"><a name="l00385"></a><span class="lineno"> 385</span>  <span class="keywordtype">int</span> maxInd = vec.<a class="code" href="structQureg.html#adef4935cac95763c29164cf99b144ed4">numAmpsTotal</a>;</div>
<div class="line"><a name="l00386"></a><span class="lineno"> 386</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> reals[maxInd];</div>
<div class="line"><a name="l00387"></a><span class="lineno"> 387</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> imags[maxInd];</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>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00390"></a><span class="lineno"> 390</span>  </div>
<div class="line"><a name="l00391"></a><span class="lineno"> 391</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00392"></a><span class="lineno"> 392</span>  </div>
<div class="line"><a name="l00393"></a><span class="lineno"> 393</span>  <span class="comment">// all valid number of amplitudes and offsets</span></div>
<div class="line"><a name="l00394"></a><span class="lineno"> 394</span>  <span class="keywordtype">int</span> startInd = GENERATE_COPY( range(0,maxInd) );</div>
<div class="line"><a name="l00395"></a><span class="lineno"> 395</span>  <span class="keywordtype">int</span> numAmps = GENERATE_COPY( range(0,1+maxInd-startInd) ); <span class="comment">// upper-bound allows all amps specified</span></div>
<div class="line"><a name="l00396"></a><span class="lineno"> 396</span>  </div>
<div class="line"><a name="l00397"></a><span class="lineno"> 397</span>  <span class="comment">// generate random amplitudes</span></div>
<div class="line"><a name="l00398"></a><span class="lineno"> 398</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numAmps; i++) {</div>
<div class="line"><a name="l00399"></a><span class="lineno"> 399</span>  reals[i] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5);</div>
<div class="line"><a name="l00400"></a><span class="lineno"> 400</span>  imags[i] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5);</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>  </div>
<div class="line"><a name="l00403"></a><span class="lineno"> 403</span>  <span class="comment">// check both specified and un-specified amplitudes are correctly handled</span></div>
<div class="line"><a name="l00404"></a><span class="lineno"> 404</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(vec);</div>
<div class="line"><a name="l00405"></a><span class="lineno"> 405</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> vecRef = <a class="code" href="group__testutilities.html#gade0e7c37811a69f1c21c88c11943a19f">toQVector</a>(vec);</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>  <a class="code" href="group__init.html#gabc0c64f8adf307d2a44184dc0f8ca66e">setAmps</a>(vec, startInd, reals, imags, numAmps);</div>
<div class="line"><a name="l00408"></a><span class="lineno"> 408</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numAmps; i++)</div>
<div class="line"><a name="l00409"></a><span class="lineno"> 409</span>  vecRef[startInd+i] = reals[i] + imags[i] * (<a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>) 1i;</div>
<div class="line"><a name="l00410"></a><span class="lineno"> 410</span>  </div>
<div class="line"><a name="l00411"></a><span class="lineno"> 411</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vec, vecRef) );</div>
<div class="line"><a name="l00412"></a><span class="lineno"> 412</span>  }</div>
<div class="line"><a name="l00413"></a><span class="lineno"> 413</span>  }</div>
<div class="line"><a name="l00414"></a><span class="lineno"> 414</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00415"></a><span class="lineno"> 415</span>  </div>
<div class="line"><a name="l00416"></a><span class="lineno"> 416</span>  SECTION( <span class="stringliteral">"start index"</span> ) {</div>
<div class="line"><a name="l00417"></a><span class="lineno"> 417</span>  </div>
<div class="line"><a name="l00418"></a><span class="lineno"> 418</span>  <span class="keywordtype">int</span> startInd = GENERATE_COPY( -1, maxInd );</div>
<div class="line"><a name="l00419"></a><span class="lineno"> 419</span>  <span class="keywordtype">int</span> numAmps = 0;</div>
<div class="line"><a name="l00420"></a><span class="lineno"> 420</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__init.html#gabc0c64f8adf307d2a44184dc0f8ca66e">setAmps</a>(vec, startInd, reals, imags, numAmps), Contains(<span class="stringliteral">"Invalid amplitude index"</span>) );</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>  SECTION( <span class="stringliteral">"number of amplitudes"</span> ) {</div>
<div class="line"><a name="l00424"></a><span class="lineno"> 424</span>  </div>
<div class="line"><a name="l00425"></a><span class="lineno"> 425</span>  <span class="comment">// independent</span></div>
<div class="line"><a name="l00426"></a><span class="lineno"> 426</span>  <span class="keywordtype">int</span> startInd = 0;</div>
<div class="line"><a name="l00427"></a><span class="lineno"> 427</span>  <span class="keywordtype">int</span> numAmps = GENERATE_COPY( -1, maxInd+1 );</div>
<div class="line"><a name="l00428"></a><span class="lineno"> 428</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__init.html#gabc0c64f8adf307d2a44184dc0f8ca66e">setAmps</a>(vec, startInd, reals, imags, numAmps), Contains(<span class="stringliteral">"Invalid number of amplitudes"</span>) );</div>
<div class="line"><a name="l00429"></a><span class="lineno"> 429</span>  </div>
<div class="line"><a name="l00430"></a><span class="lineno"> 430</span>  <span class="comment">// invalid considering start-index</span></div>
<div class="line"><a name="l00431"></a><span class="lineno"> 431</span>  startInd = maxInd - 1;</div>
<div class="line"><a name="l00432"></a><span class="lineno"> 432</span>  numAmps = 2;</div>
<div class="line"><a name="l00433"></a><span class="lineno"> 433</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__init.html#gabc0c64f8adf307d2a44184dc0f8ca66e">setAmps</a>(vec, startInd, reals, imags, numAmps), Contains(<span class="stringliteral">"More amplitudes given than exist"</span>) );</div>
<div class="line"><a name="l00434"></a><span class="lineno"> 434</span>  }</div>
<div class="line"><a name="l00435"></a><span class="lineno"> 435</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00436"></a><span class="lineno"> 436</span>  </div>
<div class="line"><a name="l00437"></a><span class="lineno"> 437</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="l00438"></a><span class="lineno"> 438</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__init.html#gabc0c64f8adf307d2a44184dc0f8ca66e">setAmps</a>(mat, 0, reals, imags, 0), Contains(<span class="stringliteral">"valid only for state-vectors"</span>) );</div>
<div class="line"><a name="l00439"></a><span class="lineno"> 439</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="l00440"></a><span class="lineno"> 440</span>  }</div>
<div class="line"><a name="l00441"></a><span class="lineno"> 441</span>  }</div>
<div class="line"><a name="l00442"></a><span class="lineno"> 442</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="l00443"></a><span class="lineno"> 443</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00421">getRandomReal()</a>, <a class="el" href="QuEST_8c_source.html#l01578">initDebugState()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="QuEST_8h_source.html#l00334">Qureg::numAmpsTotal</a>, <a class="el" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, <a class="el" href="QuEST_8c_source.html#l01021">setAmps()</a>, and <a class="el" href="utilities_8cpp_source.html#l01113">toQVector()</a>.</p>
</div>
</div>
<a id="ga71856bb29e1a3aa9947a67d480902f9e"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga71856bb29e1a3aa9947a67d480902f9e">◆ </a></span>TEST_CASE() <span class="overload">[115/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"setDiagonalOpElems" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[data_structures] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__type.html#gafabb15a6c1cf49f8ecb67e1f35c77c1e" title="Modifies a subset (starting at index startInd, and ending at index startInd + numElems) of the elemen...">setDiagonalOpElems</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__data__structures_8cpp_source.html#l00966">966</a> of file <a class="el" href="test__data__structures_8cpp_source.html">test_data_structures.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00966"></a><span class="lineno"> 966</span>  {</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>  <span class="comment">// must be at least one amplitude per node</span></div>
<div class="line"><a name="l00969"></a><span class="lineno"> 969</span>  <span class="keywordtype">int</span> minNumQb = <a class="code" href="group__testutilities.html#ga267884197cf7f1d428021cb12a57360c">calcLog2</a>(<a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>.<a class="code" href="structQuESTEnv.html#af22aacd7c9905accae28484785c193b4">numRanks</a>);</div>
<div class="line"><a name="l00970"></a><span class="lineno"> 970</span>  <span class="keywordflow">if</span> (minNumQb == 0)</div>
<div class="line"><a name="l00971"></a><span class="lineno"> 971</span>  minNumQb = 1;</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="comment">// try 10 valid number of qubits (even for validation)</span></div>
<div class="line"><a name="l00974"></a><span class="lineno"> 974</span>  <span class="keywordtype">int</span> numQb = GENERATE_COPY( range(minNumQb, minNumQb+10) );</div>
<div class="line"><a name="l00975"></a><span class="lineno"> 975</span>  <a class="code" href="structDiagonalOp.html">DiagonalOp</a> op = <a class="code" href="group__type.html#gaebf896dd8d5eeaf9fd896f6cc8e334fe">createDiagonalOp</a>(numQb, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00976"></a><span class="lineno"> 976</span>  </div>
<div class="line"><a name="l00977"></a><span class="lineno"> 977</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00978"></a><span class="lineno"> 978</span>  </div>
<div class="line"><a name="l00979"></a><span class="lineno"> 979</span>  <span class="comment">// make entire array on every node</span></div>
<div class="line"><a name="l00980"></a><span class="lineno"> 980</span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <span class="keywordtype">int</span> len = (1LL << numQb);</div>
<div class="line"><a name="l00981"></a><span class="lineno"> 981</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> reals[len];</div>
<div class="line"><a name="l00982"></a><span class="lineno"> 982</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> imags[len];</div>
<div class="line"><a name="l00983"></a><span class="lineno"> 983</span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <span class="keywordtype">int</span> n;</div>
<div class="line"><a name="l00984"></a><span class="lineno"> 984</span>  <span class="keywordflow">for</span> (n=0; n<len; n++) {</div>
<div class="line"><a name="l00985"></a><span class="lineno"> 985</span>  reals[n] = (<a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>) n;</div>
<div class="line"><a name="l00986"></a><span class="lineno"> 986</span>  imags[n] = (<a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>) -2*n; <span class="comment">// (n - 2n i)</span></div>
<div class="line"><a name="l00987"></a><span class="lineno"> 987</span>  }</div>
<div class="line"><a name="l00988"></a><span class="lineno"> 988</span>  </div>
<div class="line"><a name="l00989"></a><span class="lineno"> 989</span>  <span class="comment">// set one value at a time (only relevant nodes will update)</span></div>
<div class="line"><a name="l00990"></a><span class="lineno"> 990</span>  <span class="keywordflow">for</span> (n=0; n<len; n++)</div>
<div class="line"><a name="l00991"></a><span class="lineno"> 991</span>  <a class="code" href="group__type.html#gafabb15a6c1cf49f8ecb67e1f35c77c1e">setDiagonalOpElems</a>(op, n, &reals[n], &imags[n], 1);</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>  <span class="comment">// check op.real and op.imag updated correctly </span></div>
<div class="line"><a name="l00994"></a><span class="lineno"> 994</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(<a class="code" href="group__testutilities.html#gade0e7c37811a69f1c21c88c11943a19f">toQVector</a>(op), reals, imags) );</div>
<div class="line"><a name="l00995"></a><span class="lineno"> 995</span>  </div>
<div class="line"><a name="l00996"></a><span class="lineno"> 996</span>  <span class="comment">// no check that GPU values updated (occurs in initDiagonalOp)</span></div>
<div class="line"><a name="l00997"></a><span class="lineno"> 997</span>  }</div>
<div class="line"><a name="l00998"></a><span class="lineno"> 998</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00999"></a><span class="lineno"> 999</span>  </div>
<div class="line"><a name="l01000"></a><span class="lineno"> 1000</span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <span class="keywordtype">int</span> maxInd = (1LL << numQb);</div>
<div class="line"><a name="l01001"></a><span class="lineno"> 1001</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> *reals;</div>
<div class="line"><a name="l01002"></a><span class="lineno"> 1002</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> *imags;</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">"start index"</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> startInd = GENERATE_COPY( -1, maxInd );</div>
<div class="line"><a name="l01007"></a><span class="lineno"> 1007</span>  <span class="keywordtype">int</span> numAmps = 1;</div>
<div class="line"><a name="l01008"></a><span class="lineno"> 1008</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__type.html#gafabb15a6c1cf49f8ecb67e1f35c77c1e">setDiagonalOpElems</a>(op, startInd, reals, imags, numAmps), Contains(<span class="stringliteral">"Invalid element index"</span>) );</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>  </div>
<div class="line"><a name="l01011"></a><span class="lineno"> 1011</span>  SECTION( <span class="stringliteral">"number of elements"</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>  <span class="comment">// independent</span></div>
<div class="line"><a name="l01014"></a><span class="lineno"> 1014</span>  <span class="keywordtype">int</span> startInd = 0;</div>
<div class="line"><a name="l01015"></a><span class="lineno"> 1015</span>  <span class="keywordtype">int</span> numAmps = GENERATE_COPY( -1, maxInd+1 );</div>
<div class="line"><a name="l01016"></a><span class="lineno"> 1016</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__type.html#gafabb15a6c1cf49f8ecb67e1f35c77c1e">setDiagonalOpElems</a>(op, startInd, reals, imags, numAmps), Contains(<span class="stringliteral">"Invalid number of elements"</span>) );</div>
<div class="line"><a name="l01017"></a><span class="lineno"> 1017</span>  </div>
<div class="line"><a name="l01018"></a><span class="lineno"> 1018</span>  <span class="comment">// invalid considering start-index</span></div>
<div class="line"><a name="l01019"></a><span class="lineno"> 1019</span>  startInd = maxInd - 1;</div>
<div class="line"><a name="l01020"></a><span class="lineno"> 1020</span>  numAmps = 2;</div>
<div class="line"><a name="l01021"></a><span class="lineno"> 1021</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__type.html#gafabb15a6c1cf49f8ecb67e1f35c77c1e">setDiagonalOpElems</a>(op, startInd, reals, imags, numAmps), Contains(<span class="stringliteral">"More elements given than exist"</span>) );</div>
<div class="line"><a name="l01022"></a><span class="lineno"> 1022</span>  }</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>  </div>
<div class="line"><a name="l01025"></a><span class="lineno"> 1025</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="l01026"></a><span class="lineno"> 1026</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST__validation_8c_source.html#l00328">calcLog2()</a>, <a class="el" href="QuEST_8c_source.html#l01518">createDiagonalOp()</a>, <a class="el" href="QuEST_8c_source.html#l01524">destroyDiagonalOp()</a>, <a class="el" href="QuEST_8h_source.html#l00365">QuESTEnv::numRanks</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, <a class="el" href="QuEST_8c_source.html#l01543">setDiagonalOpElems()</a>, and <a class="el" href="utilities_8cpp_source.html#l01113">toQVector()</a>.</p>
</div>
</div>
<a id="gae69938daf4948a63c3451f15b86bf537"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gae69938daf4948a63c3451f15b86bf537">◆ </a></span>TEST_CASE() <span class="overload">[116/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"setWeightedQureg" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[state_initialisations] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__init.html#ga5d0f3f71ea38d3c44597f8c2c2f014d4" title="Modifies qureg out to the result of (facOut out + fac1 qureg1 + fac2 qureg2), imposing no constraints...">setWeightedQureg</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__state__initialisations_8cpp_source.html#l00451">451</a> of file <a class="el" href="test__state__initialisations_8cpp_source.html">test_state_initialisations.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00451"></a><span class="lineno"> 451</span>  {</div>
<div class="line"><a name="l00452"></a><span class="lineno"> 452</span>  </div>
<div class="line"><a name="l00453"></a><span class="lineno"> 453</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00454"></a><span class="lineno"> 454</span>  </div>
<div class="line"><a name="l00455"></a><span class="lineno"> 455</span>  <span class="comment">// repeat each test below 10 times </span></div>
<div class="line"><a name="l00456"></a><span class="lineno"> 456</span>  GENERATE( range(0,10) );</div>
<div class="line"><a name="l00457"></a><span class="lineno"> 457</span>  </div>
<div class="line"><a name="l00458"></a><span class="lineno"> 458</span>  <span class="comment">/* note tolerance in areEqual increases with tests, since </span></div>
<div class="line"><a name="l00459"></a><span class="lineno"> 459</span> <span class="comment"> * small differences propogate in vecC which is not re-initialised </span></div>
<div class="line"><a name="l00460"></a><span class="lineno"> 460</span> <span class="comment"> */</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>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00463"></a><span class="lineno"> 463</span>  </div>
<div class="line"><a name="l00464"></a><span class="lineno"> 464</span>  <span class="comment">// make three random vectors</span></div>
<div class="line"><a name="l00465"></a><span class="lineno"> 465</span>  <a class="code" href="structQureg.html">Qureg</a> vecA = <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="l00466"></a><span class="lineno"> 466</span>  <a class="code" href="structQureg.html">Qureg</a> vecB = <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="l00467"></a><span class="lineno"> 467</span>  <a class="code" href="structQureg.html">Qureg</a> vecC = <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="l00468"></a><span class="lineno"> 468</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> j=0; j<vecA.<a class="code" href="structQureg.html#ab0ea0358482b62f43fdd781469607d97">numAmpsPerChunk</a>; j++) {</div>
<div class="line"><a name="l00469"></a><span class="lineno"> 469</span>  vecA.<a class="code" href="structQureg.html#a441e4cacef6bd17adb9813c7442d42fe">stateVec</a>.real[j] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5); vecA.<a class="code" href="structQureg.html#a441e4cacef6bd17adb9813c7442d42fe">stateVec</a>.imag[j] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5);</div>
<div class="line"><a name="l00470"></a><span class="lineno"> 470</span>  vecB.<a class="code" href="structQureg.html#a441e4cacef6bd17adb9813c7442d42fe">stateVec</a>.real[j] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5); vecB.<a class="code" href="structQureg.html#a441e4cacef6bd17adb9813c7442d42fe">stateVec</a>.imag[j] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5);</div>
<div class="line"><a name="l00471"></a><span class="lineno"> 471</span>  vecC.<a class="code" href="structQureg.html#a441e4cacef6bd17adb9813c7442d42fe">stateVec</a>.real[j] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5); vecC.<a class="code" href="structQureg.html#a441e4cacef6bd17adb9813c7442d42fe">stateVec</a>.imag[j] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5);</div>
<div class="line"><a name="l00472"></a><span class="lineno"> 472</span>  }</div>
<div class="line"><a name="l00473"></a><span class="lineno"> 473</span>  <a class="code" href="group__debug.html#ga11448560006dd165128e404b54ebb2f7">copyStateToGPU</a>(vecA); <a class="code" href="group__debug.html#ga11448560006dd165128e404b54ebb2f7">copyStateToGPU</a>(vecB); <a class="code" href="group__debug.html#ga11448560006dd165128e404b54ebb2f7">copyStateToGPU</a>(vecC);</div>
<div class="line"><a name="l00474"></a><span class="lineno"> 474</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> refA = <a class="code" href="group__testutilities.html#gade0e7c37811a69f1c21c88c11943a19f">toQVector</a>(vecA);</div>
<div class="line"><a name="l00475"></a><span class="lineno"> 475</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> refB = <a class="code" href="group__testutilities.html#gade0e7c37811a69f1c21c88c11943a19f">toQVector</a>(vecB);</div>
<div class="line"><a name="l00476"></a><span class="lineno"> 476</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> refC = <a class="code" href="group__testutilities.html#gade0e7c37811a69f1c21c88c11943a19f">toQVector</a>(vecC);</div>
<div class="line"><a name="l00477"></a><span class="lineno"> 477</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> refOut;</div>
<div class="line"><a name="l00478"></a><span class="lineno"> 478</span>  </div>
<div class="line"><a name="l00479"></a><span class="lineno"> 479</span>  <span class="comment">// get three random factors</span></div>
<div class="line"><a name="l00480"></a><span class="lineno"> 480</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> numA = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5) + <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5) * (<a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>) 1i;</div>
<div class="line"><a name="l00481"></a><span class="lineno"> 481</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> numB = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5) + <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5) * (<a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>) 1i;</div>
<div class="line"><a name="l00482"></a><span class="lineno"> 482</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> numC = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5) + <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5) * (<a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>) 1i;</div>
<div class="line"><a name="l00483"></a><span class="lineno"> 483</span>  <a class="code" href="structComplex.html">Complex</a> facA = <a class="code" href="group__type.html#gab54c5a1ea720830a7ee394d03fb9f4e9">toComplex</a>(numA);</div>
<div class="line"><a name="l00484"></a><span class="lineno"> 484</span>  <a class="code" href="structComplex.html">Complex</a> facB = <a class="code" href="group__type.html#gab54c5a1ea720830a7ee394d03fb9f4e9">toComplex</a>(numB);</div>
<div class="line"><a name="l00485"></a><span class="lineno"> 485</span>  <a class="code" href="structComplex.html">Complex</a> facC = <a class="code" href="group__type.html#gab54c5a1ea720830a7ee394d03fb9f4e9">toComplex</a>(numC);</div>
<div class="line"><a name="l00486"></a><span class="lineno"> 486</span>  </div>
<div class="line"><a name="l00487"></a><span class="lineno"> 487</span>  <span class="comment">// check out-qureg is correct, when all quregs are unique... </span></div>
<div class="line"><a name="l00488"></a><span class="lineno"> 488</span>  <a class="code" href="group__init.html#ga5d0f3f71ea38d3c44597f8c2c2f014d4">setWeightedQureg</a>(facA, vecA, facB, vecB, facC, vecC);</div>
<div class="line"><a name="l00489"></a><span class="lineno"> 489</span>  refOut = numA*refA + numB*refB + numC*refC;</div>
<div class="line"><a name="l00490"></a><span class="lineno"> 490</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vecC, refOut) );</div>
<div class="line"><a name="l00491"></a><span class="lineno"> 491</span>  </div>
<div class="line"><a name="l00492"></a><span class="lineno"> 492</span>  <span class="comment">// ... and that other qureg's aren't modified</span></div>
<div class="line"><a name="l00493"></a><span class="lineno"> 493</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vecA, refA) );</div>
<div class="line"><a name="l00494"></a><span class="lineno"> 494</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vecB, refB) );</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="comment">// check quregOut correct, when it's also qureg2</span></div>
<div class="line"><a name="l00497"></a><span class="lineno"> 497</span>  refC = <a class="code" href="group__testutilities.html#gade0e7c37811a69f1c21c88c11943a19f">toQVector</a>(vecC);</div>
<div class="line"><a name="l00498"></a><span class="lineno"> 498</span>  <a class="code" href="group__init.html#ga5d0f3f71ea38d3c44597f8c2c2f014d4">setWeightedQureg</a>(facB, vecB, facC, vecC, facA, vecC);</div>
<div class="line"><a name="l00499"></a><span class="lineno"> 499</span>  refOut = numB*refB + numC*refC + numA*refC;</div>
<div class="line"><a name="l00500"></a><span class="lineno"> 500</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vecC, refOut, 10*REAL_EPS) );</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>  <span class="comment">// ... and that the remaining qureg is not modified</span></div>
<div class="line"><a name="l00503"></a><span class="lineno"> 503</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vecB, refB) );</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>  <span class="comment">// check quregOut correct, when it's also qureg1</span></div>
<div class="line"><a name="l00506"></a><span class="lineno"> 506</span>  refC = <a class="code" href="group__testutilities.html#gade0e7c37811a69f1c21c88c11943a19f">toQVector</a>(vecC);</div>
<div class="line"><a name="l00507"></a><span class="lineno"> 507</span>  <a class="code" href="group__init.html#ga5d0f3f71ea38d3c44597f8c2c2f014d4">setWeightedQureg</a>(facC, vecC, facB, vecB, facA, vecC);</div>
<div class="line"><a name="l00508"></a><span class="lineno"> 508</span>  refOut = numC*refC + numB*refB + numA*refC;</div>
<div class="line"><a name="l00509"></a><span class="lineno"> 509</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vecC, refOut, 10*REAL_EPS) );</div>
<div class="line"><a name="l00510"></a><span class="lineno"> 510</span>  </div>
<div class="line"><a name="l00511"></a><span class="lineno"> 511</span>  <span class="comment">// ... and that the remaining qureg is not modified</span></div>
<div class="line"><a name="l00512"></a><span class="lineno"> 512</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vecB, refB) );</div>
<div class="line"><a name="l00513"></a><span class="lineno"> 513</span>  </div>
<div class="line"><a name="l00514"></a><span class="lineno"> 514</span>  <span class="comment">// check quregOut is correct when it's both input quregs</span></div>
<div class="line"><a name="l00515"></a><span class="lineno"> 515</span>  refC = <a class="code" href="group__testutilities.html#gade0e7c37811a69f1c21c88c11943a19f">toQVector</a>(vecC);</div>
<div class="line"><a name="l00516"></a><span class="lineno"> 516</span>  <a class="code" href="group__init.html#ga5d0f3f71ea38d3c44597f8c2c2f014d4">setWeightedQureg</a>(facA, vecC, facB, vecC, facC, vecC);</div>
<div class="line"><a name="l00517"></a><span class="lineno"> 517</span>  refOut = numA*refC + numB*refC + numC*refC;</div>
<div class="line"><a name="l00518"></a><span class="lineno"> 518</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vecC, refOut, 1E3*REAL_EPS) );</div>
<div class="line"><a name="l00519"></a><span class="lineno"> 519</span>  </div>
<div class="line"><a name="l00520"></a><span class="lineno"> 520</span>  <span class="comment">// cleanup</span></div>
<div class="line"><a name="l00521"></a><span class="lineno"> 521</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(vecA, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00522"></a><span class="lineno"> 522</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(vecB, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00523"></a><span class="lineno"> 523</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(vecC, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</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">"density-matrix"</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">// make three random matrices</span></div>
<div class="line"><a name="l00528"></a><span class="lineno"> 528</span>  <a class="code" href="structQureg.html">Qureg</a> matA = <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="l00529"></a><span class="lineno"> 529</span>  <a class="code" href="structQureg.html">Qureg</a> matB = <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="l00530"></a><span class="lineno"> 530</span>  <a class="code" href="structQureg.html">Qureg</a> matC = <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="l00531"></a><span class="lineno"> 531</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> j=0; j<matA.<a class="code" href="structQureg.html#ab0ea0358482b62f43fdd781469607d97">numAmpsPerChunk</a>; j++) {</div>
<div class="line"><a name="l00532"></a><span class="lineno"> 532</span>  matA.<a class="code" href="structQureg.html#a441e4cacef6bd17adb9813c7442d42fe">stateVec</a>.real[j] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5); matA.<a class="code" href="structQureg.html#a441e4cacef6bd17adb9813c7442d42fe">stateVec</a>.imag[j] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5);</div>
<div class="line"><a name="l00533"></a><span class="lineno"> 533</span>  matB.<a class="code" href="structQureg.html#a441e4cacef6bd17adb9813c7442d42fe">stateVec</a>.real[j] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5); matB.<a class="code" href="structQureg.html#a441e4cacef6bd17adb9813c7442d42fe">stateVec</a>.imag[j] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5);</div>
<div class="line"><a name="l00534"></a><span class="lineno"> 534</span>  matC.<a class="code" href="structQureg.html#a441e4cacef6bd17adb9813c7442d42fe">stateVec</a>.real[j] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5); matC.<a class="code" href="structQureg.html#a441e4cacef6bd17adb9813c7442d42fe">stateVec</a>.imag[j] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5);</div>
<div class="line"><a name="l00535"></a><span class="lineno"> 535</span>  }</div>
<div class="line"><a name="l00536"></a><span class="lineno"> 536</span>  <a class="code" href="group__debug.html#ga11448560006dd165128e404b54ebb2f7">copyStateToGPU</a>(matA); <a class="code" href="group__debug.html#ga11448560006dd165128e404b54ebb2f7">copyStateToGPU</a>(matB); <a class="code" href="group__debug.html#ga11448560006dd165128e404b54ebb2f7">copyStateToGPU</a>(matC);</div>
<div class="line"><a name="l00537"></a><span class="lineno"> 537</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> refA = <a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(matA);</div>
<div class="line"><a name="l00538"></a><span class="lineno"> 538</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> refB = <a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(matB);</div>
<div class="line"><a name="l00539"></a><span class="lineno"> 539</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> refC = <a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(matC);</div>
<div class="line"><a name="l00540"></a><span class="lineno"> 540</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> refOut;</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>  <span class="comment">// get three random factors</span></div>
<div class="line"><a name="l00543"></a><span class="lineno"> 543</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> numA = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5) + <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5) * (<a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>) 1i;</div>
<div class="line"><a name="l00544"></a><span class="lineno"> 544</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> numB = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5) + <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5) * (<a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>) 1i;</div>
<div class="line"><a name="l00545"></a><span class="lineno"> 545</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> numC = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5) + <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5) * (<a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>) 1i;</div>
<div class="line"><a name="l00546"></a><span class="lineno"> 546</span>  <a class="code" href="structComplex.html">Complex</a> facA = <a class="code" href="group__type.html#gab54c5a1ea720830a7ee394d03fb9f4e9">toComplex</a>(numA);</div>
<div class="line"><a name="l00547"></a><span class="lineno"> 547</span>  <a class="code" href="structComplex.html">Complex</a> facB = <a class="code" href="group__type.html#gab54c5a1ea720830a7ee394d03fb9f4e9">toComplex</a>(numB);</div>
<div class="line"><a name="l00548"></a><span class="lineno"> 548</span>  <a class="code" href="structComplex.html">Complex</a> facC = <a class="code" href="group__type.html#gab54c5a1ea720830a7ee394d03fb9f4e9">toComplex</a>(numC);</div>
<div class="line"><a name="l00549"></a><span class="lineno"> 549</span>  </div>
<div class="line"><a name="l00550"></a><span class="lineno"> 550</span>  <span class="comment">// check out-qureg is correct, when all quregs are unique... </span></div>
<div class="line"><a name="l00551"></a><span class="lineno"> 551</span>  <a class="code" href="group__init.html#ga5d0f3f71ea38d3c44597f8c2c2f014d4">setWeightedQureg</a>(facA, matA, facB, matB, facC, matC);</div>
<div class="line"><a name="l00552"></a><span class="lineno"> 552</span>  refOut = numA*refA + numB*refB + numC*refC;</div>
<div class="line"><a name="l00553"></a><span class="lineno"> 553</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(matC, refOut) );</div>
<div class="line"><a name="l00554"></a><span class="lineno"> 554</span>  </div>
<div class="line"><a name="l00555"></a><span class="lineno"> 555</span>  <span class="comment">// ... and that other qureg's aren't modified</span></div>
<div class="line"><a name="l00556"></a><span class="lineno"> 556</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(matA, refA) );</div>
<div class="line"><a name="l00557"></a><span class="lineno"> 557</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(matB, refB) );</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="comment">// check quregOut correct, when it's also qureg2</span></div>
<div class="line"><a name="l00560"></a><span class="lineno"> 560</span>  refC = <a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(matC);</div>
<div class="line"><a name="l00561"></a><span class="lineno"> 561</span>  <a class="code" href="group__init.html#ga5d0f3f71ea38d3c44597f8c2c2f014d4">setWeightedQureg</a>(facB, matB, facC, matC, facA, matC);</div>
<div class="line"><a name="l00562"></a><span class="lineno"> 562</span>  refOut = numB*refB + numC*refC + numA*refC;</div>
<div class="line"><a name="l00563"></a><span class="lineno"> 563</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(matC, refOut, 10*REAL_EPS) );</div>
<div class="line"><a name="l00564"></a><span class="lineno"> 564</span>  </div>
<div class="line"><a name="l00565"></a><span class="lineno"> 565</span>  <span class="comment">// ... and that the remaining qureg is not modified</span></div>
<div class="line"><a name="l00566"></a><span class="lineno"> 566</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(matB, refB) );</div>
<div class="line"><a name="l00567"></a><span class="lineno"> 567</span>  </div>
<div class="line"><a name="l00568"></a><span class="lineno"> 568</span>  <span class="comment">// check quregOut correct, when it's also qureg1</span></div>
<div class="line"><a name="l00569"></a><span class="lineno"> 569</span>  refC = <a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(matC);</div>
<div class="line"><a name="l00570"></a><span class="lineno"> 570</span>  <a class="code" href="group__init.html#ga5d0f3f71ea38d3c44597f8c2c2f014d4">setWeightedQureg</a>(facC, matC, facB, matB, facA, matC);</div>
<div class="line"><a name="l00571"></a><span class="lineno"> 571</span>  refOut = numC*refC + numB*refB + numA*refC;</div>
<div class="line"><a name="l00572"></a><span class="lineno"> 572</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(matC, refOut, 1E2*REAL_EPS) );</div>
<div class="line"><a name="l00573"></a><span class="lineno"> 573</span>  </div>
<div class="line"><a name="l00574"></a><span class="lineno"> 574</span>  <span class="comment">// ... and that the remaining qureg is not modified</span></div>
<div class="line"><a name="l00575"></a><span class="lineno"> 575</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(matB, refB) );</div>
<div class="line"><a name="l00576"></a><span class="lineno"> 576</span>  </div>
<div class="line"><a name="l00577"></a><span class="lineno"> 577</span>  <span class="comment">// check quregOut is correct when it's both input quregs</span></div>
<div class="line"><a name="l00578"></a><span class="lineno"> 578</span>  refC = <a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(matC);</div>
<div class="line"><a name="l00579"></a><span class="lineno"> 579</span>  <a class="code" href="group__init.html#ga5d0f3f71ea38d3c44597f8c2c2f014d4">setWeightedQureg</a>(facA, matC, facB, matC, facC, matC);</div>
<div class="line"><a name="l00580"></a><span class="lineno"> 580</span>  refOut = numA*refC + numB*refC + numC*refC;</div>
<div class="line"><a name="l00581"></a><span class="lineno"> 581</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(matC, refOut, 1E3*REAL_EPS) );</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>  <span class="comment">// cleanup</span></div>
<div class="line"><a name="l00584"></a><span class="lineno"> 584</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(matA, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00585"></a><span class="lineno"> 585</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(matB, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00586"></a><span class="lineno"> 586</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(matC, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00587"></a><span class="lineno"> 587</span>  }</div>
<div class="line"><a name="l00588"></a><span class="lineno"> 588</span>  }</div>
<div class="line"><a name="l00589"></a><span class="lineno"> 589</span>  SECTION( <span class="stringliteral">"input validation"</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>  SECTION( <span class="stringliteral">"qureg types"</span> ) {</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>  <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="l00594"></a><span class="lineno"> 594</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="l00595"></a><span class="lineno"> 595</span>  <a class="code" href="structComplex.html">Complex</a> f = {.<a class="code" href="structComplex.html#ab5b2e2eca02131fc74b289a83636cbe3">real</a>=0, .imag=0};</div>
<div class="line"><a name="l00596"></a><span class="lineno"> 596</span>  </div>
<div class="line"><a name="l00597"></a><span class="lineno"> 597</span>  <span class="comment">// two state-vecs, one density-matrix</span></div>
<div class="line"><a name="l00598"></a><span class="lineno"> 598</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__init.html#ga5d0f3f71ea38d3c44597f8c2c2f014d4">setWeightedQureg</a>(f, mat, f, vec, f, vec), Contains(<span class="stringliteral">"state-vectors or"</span>) && Contains(<span class="stringliteral">"density matrices"</span>) );</div>
<div class="line"><a name="l00599"></a><span class="lineno"> 599</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__init.html#ga5d0f3f71ea38d3c44597f8c2c2f014d4">setWeightedQureg</a>(f, vec, f, mat, f, vec), Contains(<span class="stringliteral">"state-vectors or"</span>) && Contains(<span class="stringliteral">"density matrices"</span>) );</div>
<div class="line"><a name="l00600"></a><span class="lineno"> 600</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__init.html#ga5d0f3f71ea38d3c44597f8c2c2f014d4">setWeightedQureg</a>(f, vec, f, vec, f, mat), Contains(<span class="stringliteral">"state-vectors or"</span>) && Contains(<span class="stringliteral">"density matrices"</span>) );</div>
<div class="line"><a name="l00601"></a><span class="lineno"> 601</span>  </div>
<div class="line"><a name="l00602"></a><span class="lineno"> 602</span>  <span class="comment">// one state-vec, two density-matrices</span></div>
<div class="line"><a name="l00603"></a><span class="lineno"> 603</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__init.html#ga5d0f3f71ea38d3c44597f8c2c2f014d4">setWeightedQureg</a>(f, vec, f, mat, f, mat), Contains(<span class="stringliteral">"state-vectors or"</span>) && Contains(<span class="stringliteral">"density matrices"</span>) );</div>
<div class="line"><a name="l00604"></a><span class="lineno"> 604</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__init.html#ga5d0f3f71ea38d3c44597f8c2c2f014d4">setWeightedQureg</a>(f, mat, f, vec, f, mat), Contains(<span class="stringliteral">"state-vectors or"</span>) && Contains(<span class="stringliteral">"density matrices"</span>) );</div>
<div class="line"><a name="l00605"></a><span class="lineno"> 605</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__init.html#ga5d0f3f71ea38d3c44597f8c2c2f014d4">setWeightedQureg</a>(f, mat, f, mat, f, vec), Contains(<span class="stringliteral">"state-vectors or"</span>) && Contains(<span class="stringliteral">"density matrices"</span>) );</div>
<div class="line"><a name="l00606"></a><span class="lineno"> 606</span>  </div>
<div class="line"><a name="l00607"></a><span class="lineno"> 607</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="l00608"></a><span class="lineno"> 608</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="l00609"></a><span class="lineno"> 609</span>  } </div>
<div class="line"><a name="l00610"></a><span class="lineno"> 610</span>  SECTION( <span class="stringliteral">"qureg dimensions"</span> ) {</div>
<div class="line"><a name="l00611"></a><span class="lineno"> 611</span>  </div>
<div class="line"><a name="l00612"></a><span class="lineno"> 612</span>  <a class="code" href="structQureg.html">Qureg</a> vecA = <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="l00613"></a><span class="lineno"> 613</span>  <a class="code" href="structQureg.html">Qureg</a> vecB = <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="l00614"></a><span class="lineno"> 614</span>  <a class="code" href="structQureg.html">Qureg</a> matA = <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="l00615"></a><span class="lineno"> 615</span>  <a class="code" href="structQureg.html">Qureg</a> matB = <a class="code" href="group__type.html#ga93e55b6650b408abb30a1d4a8bce757c">createDensityQureg</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="l00616"></a><span class="lineno"> 616</span>  <a class="code" href="structComplex.html">Complex</a> f = {.<a class="code" href="structComplex.html#ab5b2e2eca02131fc74b289a83636cbe3">real</a>=0, .imag=0};</div>
<div class="line"><a name="l00617"></a><span class="lineno"> 617</span>  </div>
<div class="line"><a name="l00618"></a><span class="lineno"> 618</span>  <span class="comment">// state-vecs</span></div>
<div class="line"><a name="l00619"></a><span class="lineno"> 619</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__init.html#ga5d0f3f71ea38d3c44597f8c2c2f014d4">setWeightedQureg</a>(f, vecA, f, vecB, f, vecB), Contains(<span class="stringliteral">"Dimensions"</span>) );</div>
<div class="line"><a name="l00620"></a><span class="lineno"> 620</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__init.html#ga5d0f3f71ea38d3c44597f8c2c2f014d4">setWeightedQureg</a>(f, vecB, f, vecA, f, vecB), Contains(<span class="stringliteral">"Dimensions"</span>) );</div>
<div class="line"><a name="l00621"></a><span class="lineno"> 621</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__init.html#ga5d0f3f71ea38d3c44597f8c2c2f014d4">setWeightedQureg</a>(f, vecB, f, vecB, f, vecA), Contains(<span class="stringliteral">"Dimensions"</span>) );</div>
<div class="line"><a name="l00622"></a><span class="lineno"> 622</span>  </div>
<div class="line"><a name="l00623"></a><span class="lineno"> 623</span>  <span class="comment">// density-matrices</span></div>
<div class="line"><a name="l00624"></a><span class="lineno"> 624</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__init.html#ga5d0f3f71ea38d3c44597f8c2c2f014d4">setWeightedQureg</a>(f, matA, f, matB, f, matB), Contains(<span class="stringliteral">"Dimensions"</span>) );</div>
<div class="line"><a name="l00625"></a><span class="lineno"> 625</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__init.html#ga5d0f3f71ea38d3c44597f8c2c2f014d4">setWeightedQureg</a>(f, matB, f, matA, f, matB), Contains(<span class="stringliteral">"Dimensions"</span>) );</div>
<div class="line"><a name="l00626"></a><span class="lineno"> 626</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__init.html#ga5d0f3f71ea38d3c44597f8c2c2f014d4">setWeightedQureg</a>(f, matB, f, matB, f, matA), Contains(<span class="stringliteral">"Dimensions"</span>) );</div>
<div class="line"><a name="l00627"></a><span class="lineno"> 627</span>  </div>
<div class="line"><a name="l00628"></a><span class="lineno"> 628</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(vecA, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00629"></a><span class="lineno"> 629</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(vecB, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00630"></a><span class="lineno"> 630</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(matA, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00631"></a><span class="lineno"> 631</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(matB, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00632"></a><span class="lineno"> 632</span>  }</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> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="QuEST__cpu_8c_source.html#l00042">copyStateToGPU()</a>, <a class="el" href="QuEST_8c_source.html#l00050">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00421">getRandomReal()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="QuEST_8h_source.html#l00332">Qureg::numAmpsPerChunk</a>, <a class="el" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, <a class="el" href="QuEST_8h_source.html#l00105">Complex::real</a>, <a class="el" href="QuEST_8c_source.html#l01037">setWeightedQureg()</a>, <a class="el" href="QuEST_8h_source.html#l00341">Qureg::stateVec</a>, <a class="el" href="group__type.html#gab54c5a1ea720830a7ee394d03fb9f4e9">toComplex</a>, <a class="el" href="utilities_8cpp_source.html#l01044">toQMatrix()</a>, and <a class="el" href="utilities_8cpp_source.html#l01113">toQVector()</a>.</p>
</div>
</div>
<a id="gab9235c6edcb882a5d131013eaea4ea4a"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gab9235c6edcb882a5d131013eaea4ea4a">◆ </a></span>TEST_CASE() <span class="overload">[117/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"sGate" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#ga655ffcd4def2e127341c9488f5ca8455" title="Apply the single-qubit S gate.">sGate</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l02494">2494</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l02494"></a><span class="lineno"> 2494</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>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l02497"></a><span class="lineno"> 2497</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op{{1,0},{0,<a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>(0,1)}};</div>
<div class="line"><a name="l02498"></a><span class="lineno"> 2498</span>  </div>
<div class="line"><a name="l02499"></a><span class="lineno"> 2499</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l02500"></a><span class="lineno"> 2500</span>  </div>
<div class="line"><a name="l02501"></a><span class="lineno"> 2501</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="l02502"></a><span class="lineno"> 2502</span>  </div>
<div class="line"><a name="l02503"></a><span class="lineno"> 2503</span>  SECTION( <span class="stringliteral">"state-vector "</span>) {</div>
<div class="line"><a name="l02504"></a><span class="lineno"> 2504</span>  </div>
<div class="line"><a name="l02505"></a><span class="lineno"> 2505</span>  <a class="code" href="group__unitary.html#ga655ffcd4def2e127341c9488f5ca8455">sGate</a>(quregVec, target);</div>
<div class="line"><a name="l02506"></a><span class="lineno"> 2506</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, target, op);</div>
<div class="line"><a name="l02507"></a><span class="lineno"> 2507</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l02508"></a><span class="lineno"> 2508</span>  }</div>
<div class="line"><a name="l02509"></a><span class="lineno"> 2509</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l02510"></a><span class="lineno"> 2510</span>  </div>
<div class="line"><a name="l02511"></a><span class="lineno"> 2511</span>  <a class="code" href="group__unitary.html#ga655ffcd4def2e127341c9488f5ca8455">sGate</a>(quregMatr, target);</div>
<div class="line"><a name="l02512"></a><span class="lineno"> 2512</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, target, op);</div>
<div class="line"><a name="l02513"></a><span class="lineno"> 2513</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</div>
<div class="line"><a name="l02514"></a><span class="lineno"> 2514</span>  }</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>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l02517"></a><span class="lineno"> 2517</span>  </div>
<div class="line"><a name="l02518"></a><span class="lineno"> 2518</span>  SECTION( <span class="stringliteral">"qubit indices"</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>  <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="l02521"></a><span class="lineno"> 2521</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga655ffcd4def2e127341c9488f5ca8455">sGate</a>(quregVec, target), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l02522"></a><span class="lineno"> 2522</span>  }</div>
<div class="line"><a name="l02523"></a><span class="lineno"> 2523</span>  }</div>
<div class="line"><a name="l02524"></a><span class="lineno"> 2524</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l02525"></a><span class="lineno"> 2525</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, <a class="el" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>, and <a class="el" href="QuEST_8c_source.html#l00465">sGate()</a>.</p>
</div>
</div>
<a id="gac538ad512deccd07b15326bb3fcd864e"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gac538ad512deccd07b15326bb3fcd864e">◆ </a></span>TEST_CASE() <span class="overload">[118/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"sqrtSwapGate" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#ga75d5e65f87c68403602a669b9c6d52b0" title="Performs a sqrt SWAP gate between qubit1 and qubit2.">sqrtSwapGate</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l02533">2533</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l02533"></a><span class="lineno"> 2533</span>  {</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>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l02536"></a><span class="lineno"> 2536</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> a = <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>(.5, .5);</div>
<div class="line"><a name="l02537"></a><span class="lineno"> 2537</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> b = <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>(.5, -.5);</div>
<div class="line"><a name="l02538"></a><span class="lineno"> 2538</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op{{1,0,0,0},{0,a,b,0},{0,b,a,0},{0,0,0,1}};</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>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l02541"></a><span class="lineno"> 2541</span>  </div>
<div class="line"><a name="l02542"></a><span class="lineno"> 2542</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="l02543"></a><span class="lineno"> 2543</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="l02544"></a><span class="lineno"> 2544</span>  <span class="keywordtype">int</span> targs[] = {targ1, targ2};</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>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l02547"></a><span class="lineno"> 2547</span>  </div>
<div class="line"><a name="l02548"></a><span class="lineno"> 2548</span>  <a class="code" href="group__unitary.html#ga75d5e65f87c68403602a669b9c6d52b0">sqrtSwapGate</a>(quregVec, targ1, targ2);</div>
<div class="line"><a name="l02549"></a><span class="lineno"> 2549</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, targs, 2, op);</div>
<div class="line"><a name="l02550"></a><span class="lineno"> 2550</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l02551"></a><span class="lineno"> 2551</span>  }</div>
<div class="line"><a name="l02552"></a><span class="lineno"> 2552</span>  SECTION( <span class="stringliteral">"density-matrix"</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>  <a class="code" href="group__unitary.html#ga75d5e65f87c68403602a669b9c6d52b0">sqrtSwapGate</a>(quregMatr, targ1, targ2);</div>
<div class="line"><a name="l02555"></a><span class="lineno"> 2555</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, targs, 2, op);</div>
<div class="line"><a name="l02556"></a><span class="lineno"> 2556</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</div>
<div class="line"><a name="l02557"></a><span class="lineno"> 2557</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">"input validation"</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>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l02562"></a><span class="lineno"> 2562</span>  </div>
<div class="line"><a name="l02563"></a><span class="lineno"> 2563</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="l02564"></a><span class="lineno"> 2564</span>  <span class="keywordtype">int</span> targ2 = 0;</div>
<div class="line"><a name="l02565"></a><span class="lineno"> 2565</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga75d5e65f87c68403602a669b9c6d52b0">sqrtSwapGate</a>(quregVec, targ1, targ2), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l02566"></a><span class="lineno"> 2566</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga75d5e65f87c68403602a669b9c6d52b0">sqrtSwapGate</a>(quregVec, targ2, targ1), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l02567"></a><span class="lineno"> 2567</span>  }</div>
<div class="line"><a name="l02568"></a><span class="lineno"> 2568</span>  SECTION( <span class="stringliteral">"repetition of targets"</span> ) {</div>
<div class="line"><a name="l02569"></a><span class="lineno"> 2569</span>  </div>
<div class="line"><a name="l02570"></a><span class="lineno"> 2570</span>  <span class="keywordtype">int</span> qb = 0;</div>
<div class="line"><a name="l02571"></a><span class="lineno"> 2571</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga75d5e65f87c68403602a669b9c6d52b0">sqrtSwapGate</a>(quregVec, qb, qb), Contains(<span class="stringliteral">"target"</span>) && Contains(<span class="stringliteral">"unique"</span>) );</div>
<div class="line"><a name="l02572"></a><span class="lineno"> 2572</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>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l02575"></a><span class="lineno"> 2575</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, <a class="el" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>, and <a class="el" href="QuEST_8c_source.html#l00639">sqrtSwapGate()</a>.</p>
</div>
</div>
<a id="ga199ce1e1b6d7192b3a5477920b0d03e2"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga199ce1e1b6d7192b3a5477920b0d03e2">◆ </a></span>TEST_CASE() <span class="overload">[119/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"swapGate" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#ga820fd139c035136819e371308c206e36" title="Performs a SWAP gate between qubit1 and qubit2.">swapGate</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l02583">2583</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l02583"></a><span class="lineno"> 2583</span>  {</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>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l02586"></a><span class="lineno"> 2586</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op{{1,0,0,0},{0,0,1,0},{0,1,0,0},{0,0,0,1}};</div>
<div class="line"><a name="l02587"></a><span class="lineno"> 2587</span>  </div>
<div class="line"><a name="l02588"></a><span class="lineno"> 2588</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l02589"></a><span class="lineno"> 2589</span>  </div>
<div class="line"><a name="l02590"></a><span class="lineno"> 2590</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="l02591"></a><span class="lineno"> 2591</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="l02592"></a><span class="lineno"> 2592</span>  <span class="keywordtype">int</span> targs[] = {targ1, targ2};</div>
<div class="line"><a name="l02593"></a><span class="lineno"> 2593</span>  </div>
<div class="line"><a name="l02594"></a><span class="lineno"> 2594</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l02595"></a><span class="lineno"> 2595</span>  </div>
<div class="line"><a name="l02596"></a><span class="lineno"> 2596</span>  <a class="code" href="group__unitary.html#ga820fd139c035136819e371308c206e36">swapGate</a>(quregVec, targ1, targ2);</div>
<div class="line"><a name="l02597"></a><span class="lineno"> 2597</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, targs, 2, op);</div>
<div class="line"><a name="l02598"></a><span class="lineno"> 2598</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l02599"></a><span class="lineno"> 2599</span>  }</div>
<div class="line"><a name="l02600"></a><span class="lineno"> 2600</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l02601"></a><span class="lineno"> 2601</span>  </div>
<div class="line"><a name="l02602"></a><span class="lineno"> 2602</span>  <a class="code" href="group__unitary.html#ga820fd139c035136819e371308c206e36">swapGate</a>(quregMatr, targ1, targ2);</div>
<div class="line"><a name="l02603"></a><span class="lineno"> 2603</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, targs, 2, op);</div>
<div class="line"><a name="l02604"></a><span class="lineno"> 2604</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</div>
<div class="line"><a name="l02605"></a><span class="lineno"> 2605</span>  }</div>
<div class="line"><a name="l02606"></a><span class="lineno"> 2606</span>  }</div>
<div class="line"><a name="l02607"></a><span class="lineno"> 2607</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l02608"></a><span class="lineno"> 2608</span>  </div>
<div class="line"><a name="l02609"></a><span class="lineno"> 2609</span>  SECTION( <span class="stringliteral">"qubit indices"</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>  <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="l02612"></a><span class="lineno"> 2612</span>  <span class="keywordtype">int</span> targ2 = 0;</div>
<div class="line"><a name="l02613"></a><span class="lineno"> 2613</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga820fd139c035136819e371308c206e36">swapGate</a>(quregVec, targ1, targ2), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l02614"></a><span class="lineno"> 2614</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga820fd139c035136819e371308c206e36">swapGate</a>(quregVec, targ2, targ1), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l02615"></a><span class="lineno"> 2615</span>  }</div>
<div class="line"><a name="l02616"></a><span class="lineno"> 2616</span>  SECTION( <span class="stringliteral">"repetition of targets"</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>  <span class="keywordtype">int</span> qb = 0;</div>
<div class="line"><a name="l02619"></a><span class="lineno"> 2619</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga820fd139c035136819e371308c206e36">swapGate</a>(quregVec, qb, qb), Contains(<span class="stringliteral">"target"</span>) && Contains(<span class="stringliteral">"unique"</span>) );</div>
<div class="line"><a name="l02620"></a><span class="lineno"> 2620</span>  }</div>
<div class="line"><a name="l02621"></a><span class="lineno"> 2621</span>  }</div>
<div class="line"><a name="l02622"></a><span class="lineno"> 2622</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l02623"></a><span class="lineno"> 2623</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, and <a class="el" href="QuEST_8c_source.html#l00627">swapGate()</a>.</p>
</div>
</div>
<a id="ga781f7de088fc2e86f4097dfe84e9cbf1"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga781f7de088fc2e86f4097dfe84e9cbf1">◆ </a></span>TEST_CASE() <span class="overload">[120/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"syncDiagonalOp" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[data_structures] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__type.html#gab75d5cdc622d2778bad24e3a8130aab9" title="Update the GPU memory with the current values in op.real and op.imag.">syncDiagonalOp</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__data__structures_8cpp_source.html#l01034">1034</a> of file <a class="el" href="test__data__structures_8cpp_source.html">test_data_structures.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l01034"></a><span class="lineno"> 1034</span>  {</div>
<div class="line"><a name="l01035"></a><span class="lineno"> 1035</span>  </div>
<div class="line"><a name="l01036"></a><span class="lineno"> 1036</span>  <span class="comment">// must be at least one amplitude per node</span></div>
<div class="line"><a name="l01037"></a><span class="lineno"> 1037</span>  <span class="keywordtype">int</span> minNumQb = <a class="code" href="group__testutilities.html#ga267884197cf7f1d428021cb12a57360c">calcLog2</a>(<a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>.<a class="code" href="structQuESTEnv.html#af22aacd7c9905accae28484785c193b4">numRanks</a>);</div>
<div class="line"><a name="l01038"></a><span class="lineno"> 1038</span>  <span class="keywordflow">if</span> (minNumQb == 0)</div>
<div class="line"><a name="l01039"></a><span class="lineno"> 1039</span>  minNumQb = 1;</div>
<div class="line"><a name="l01040"></a><span class="lineno"> 1040</span>  </div>
<div class="line"><a name="l01041"></a><span class="lineno"> 1041</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l01042"></a><span class="lineno"> 1042</span>  </div>
<div class="line"><a name="l01043"></a><span class="lineno"> 1043</span>  <span class="comment">// try 10 valid number of qubits</span></div>
<div class="line"><a name="l01044"></a><span class="lineno"> 1044</span>  <span class="keywordtype">int</span> numQb = GENERATE_COPY( range(minNumQb, minNumQb+10) );</div>
<div class="line"><a name="l01045"></a><span class="lineno"> 1045</span>  <a class="code" href="structDiagonalOp.html">DiagonalOp</a> op = <a class="code" href="group__type.html#gaebf896dd8d5eeaf9fd896f6cc8e334fe">createDiagonalOp</a>(numQb, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l01046"></a><span class="lineno"> 1046</span>  </div>
<div class="line"><a name="l01047"></a><span class="lineno"> 1047</span>  <span class="comment">// check that changes get sync'd to the GPU...</span></div>
<div class="line"><a name="l01048"></a><span class="lineno"> 1048</span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <span class="keywordtype">int</span> n;</div>
<div class="line"><a name="l01049"></a><span class="lineno"> 1049</span>  <span class="keywordflow">for</span> (n=0; n<op.<a class="code" href="structDiagonalOp.html#a2c6eab631ef48b4978db026c98180eee">numElemsPerChunk</a>; n++) {</div>
<div class="line"><a name="l01050"></a><span class="lineno"> 1050</span>  op.<a class="code" href="structDiagonalOp.html#a1d66088bed235d524cd452b107694d5c">real</a>[n] = (<a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>) n;</div>
<div class="line"><a name="l01051"></a><span class="lineno"> 1051</span>  op.<a class="code" href="structDiagonalOp.html#a85c3f52533efe831bbe40b9a48602388">imag</a>[n] = (<a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>) -2*n; <span class="comment">// (n - 2n i)</span></div>
<div class="line"><a name="l01052"></a><span class="lineno"> 1052</span>  }</div>
<div class="line"><a name="l01053"></a><span class="lineno"> 1053</span>  <a class="code" href="group__type.html#gab75d5cdc622d2778bad24e3a8130aab9">syncDiagonalOp</a>(op);</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>  <span class="comment">// via if it modifies an all-unity state-vec correctly </span></div>
<div class="line"><a name="l01056"></a><span class="lineno"> 1056</span>  <a class="code" href="structQureg.html">Qureg</a> qureg = <a class="code" href="group__type.html#ga3392816c0643414165c2f5caeec17df0">createQureg</a>(numQb, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l01057"></a><span class="lineno"> 1057</span>  <span class="keywordflow">for</span> (<span class="keywordtype">long</span> <span class="keywordtype">long</span> <span class="keywordtype">int</span> i=0; i<qureg.<a class="code" href="structQureg.html#ab0ea0358482b62f43fdd781469607d97">numAmpsPerChunk</a>; i++) {</div>
<div class="line"><a name="l01058"></a><span class="lineno"> 1058</span>  qureg.<a class="code" href="structQureg.html#a441e4cacef6bd17adb9813c7442d42fe">stateVec</a>.real[i] = 1;</div>
<div class="line"><a name="l01059"></a><span class="lineno"> 1059</span>  qureg.<a class="code" href="structQureg.html#a441e4cacef6bd17adb9813c7442d42fe">stateVec</a>.imag[i] = 1;</div>
<div class="line"><a name="l01060"></a><span class="lineno"> 1060</span>  }</div>
<div class="line"><a name="l01061"></a><span class="lineno"> 1061</span>  <a class="code" href="group__debug.html#ga11448560006dd165128e404b54ebb2f7">copyStateToGPU</a>(qureg);</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>  <span class="comment">// (n - 2n i) * (1 + 1i) = 3n - n*i</span></div>
<div class="line"><a name="l01064"></a><span class="lineno"> 1064</span>  <a class="code" href="group__operator.html#gad2e953390342cd361cfb4064d47715e6">applyDiagonalOp</a>(qureg, op);</div>
<div class="line"><a name="l01065"></a><span class="lineno"> 1065</span>  <a class="code" href="group__debug.html#ga924ef2dbda6b733b4041270077c76ece">copyStateFromGPU</a>(qureg);</div>
<div class="line"><a name="l01066"></a><span class="lineno"> 1066</span>  <span class="keywordflow">for</span> (n=0; n<qureg.<a class="code" href="structQureg.html#ab0ea0358482b62f43fdd781469607d97">numAmpsPerChunk</a>; n++) {</div>
<div class="line"><a name="l01067"></a><span class="lineno"> 1067</span>  REQUIRE( qureg.<a class="code" href="structQureg.html#a441e4cacef6bd17adb9813c7442d42fe">stateVec</a>.real[n] == 3*n );</div>
<div class="line"><a name="l01068"></a><span class="lineno"> 1068</span>  REQUIRE( qureg.<a class="code" href="structQureg.html#a441e4cacef6bd17adb9813c7442d42fe">stateVec</a>.imag[n] == -n );</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>  </div>
<div class="line"><a name="l01071"></a><span class="lineno"> 1071</span>  <a class="code" href="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(qureg, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l01072"></a><span class="lineno"> 1072</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="l01073"></a><span class="lineno"> 1073</span>  }</div>
<div class="line"><a name="l01074"></a><span class="lineno"> 1074</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l01127">applyDiagonalOp()</a>, <a class="el" href="QuEST__validation_8c_source.html#l00328">calcLog2()</a>, <a class="el" href="QuEST__cpu_8c_source.html#l00045">copyStateFromGPU()</a>, <a class="el" href="QuEST__cpu_8c_source.html#l00042">copyStateToGPU()</a>, <a class="el" href="QuEST_8c_source.html#l01518">createDiagonalOp()</a>, <a class="el" href="QuEST_8c_source.html#l00036">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l01524">destroyDiagonalOp()</a>, <a class="el" href="QuEST_8c_source.html#l00077">destroyQureg()</a>, <a class="el" href="QuEST_8h_source.html#l00310">DiagonalOp::imag</a>, <a class="el" href="QuEST_8h_source.html#l00332">Qureg::numAmpsPerChunk</a>, <a class="el" href="QuEST_8h_source.html#l00302">DiagonalOp::numElemsPerChunk</a>, <a class="el" href="QuEST_8h_source.html#l00365">QuESTEnv::numRanks</a>, <a class="el" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, <a class="el" href="QuEST_8h_source.html#l00308">DiagonalOp::real</a>, <a class="el" href="QuEST_8h_source.html#l00341">Qureg::stateVec</a>, and <a class="el" href="QuEST_8c_source.html#l01531">syncDiagonalOp()</a>.</p>
</div>
</div>
<a id="ga4296b3ea07d5a25be3f5bd0e87459112"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga4296b3ea07d5a25be3f5bd0e87459112">◆ </a></span>TEST_CASE() <span class="overload">[121/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"tGate" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#gac15907193da5a7c48b9610a26e669064" title="Apply the single-qubit T gate.">tGate</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l02631">2631</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l02631"></a><span class="lineno"> 2631</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>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l02634"></a><span class="lineno"> 2634</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op{{1,0},{0,<a class="code" href="utilities_8cpp.html#a9dc43d4a0827b56cd004270a9c5b2604">expI</a>(<a class="code" href="QuEST__common_8c.html#ae71449b1cc6e6250b91f539153a7a0d3">M_PI</a>/4.)}};</div>
<div class="line"><a name="l02635"></a><span class="lineno"> 2635</span>  </div>
<div class="line"><a name="l02636"></a><span class="lineno"> 2636</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</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="keywordtype">int</span> target = GENERATE( range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) );</div>
<div class="line"><a name="l02639"></a><span class="lineno"> 2639</span>  </div>
<div class="line"><a name="l02640"></a><span class="lineno"> 2640</span>  SECTION( <span class="stringliteral">"state-vector "</span>) {</div>
<div class="line"><a name="l02641"></a><span class="lineno"> 2641</span>  </div>
<div class="line"><a name="l02642"></a><span class="lineno"> 2642</span>  <a class="code" href="group__unitary.html#gac15907193da5a7c48b9610a26e669064">tGate</a>(quregVec, target);</div>
<div class="line"><a name="l02643"></a><span class="lineno"> 2643</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, target, op);</div>
<div class="line"><a name="l02644"></a><span class="lineno"> 2644</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l02645"></a><span class="lineno"> 2645</span>  }</div>
<div class="line"><a name="l02646"></a><span class="lineno"> 2646</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l02647"></a><span class="lineno"> 2647</span>  </div>
<div class="line"><a name="l02648"></a><span class="lineno"> 2648</span>  <a class="code" href="group__unitary.html#gac15907193da5a7c48b9610a26e669064">tGate</a>(quregMatr, target);</div>
<div class="line"><a name="l02649"></a><span class="lineno"> 2649</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, target, op);</div>
<div class="line"><a name="l02650"></a><span class="lineno"> 2650</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</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>  }</div>
<div class="line"><a name="l02653"></a><span class="lineno"> 2653</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l02654"></a><span class="lineno"> 2654</span>  </div>
<div class="line"><a name="l02655"></a><span class="lineno"> 2655</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l02656"></a><span class="lineno"> 2656</span>  </div>
<div class="line"><a name="l02657"></a><span class="lineno"> 2657</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="l02658"></a><span class="lineno"> 2658</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gac15907193da5a7c48b9610a26e669064">tGate</a>(quregVec, target), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l02659"></a><span class="lineno"> 2659</span>  }</div>
<div class="line"><a name="l02660"></a><span class="lineno"> 2660</span>  }</div>
<div class="line"><a name="l02661"></a><span class="lineno"> 2661</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l02662"></a><span class="lineno"> 2662</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00417">expI()</a>, <a class="el" href="QuEST__common_8c_source.html#l00041">M_PI</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, and <a class="el" href="QuEST_8c_source.html#l00476">tGate()</a>.</p>
</div>
</div>
<a id="gabab3cf31bd73b8334ef6d2e7d2b2ea67"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gabab3cf31bd73b8334ef6d2e7d2b2ea67">◆ </a></span>TEST_CASE() <span class="overload">[122/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"toComplex" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[data_structures] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__type.html#gab54c5a1ea720830a7ee394d03fb9f4e9">toComplex</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__data__structures_8cpp_source.html#l00042">42</a> of file <a class="el" href="test__data__structures_8cpp_source.html">test_data_structures.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l00042"></a><span class="lineno"> 42</span>  {</div>
<div class="line"><a name="l00043"></a><span class="lineno"> 43</span>  </div>
<div class="line"><a name="l00044"></a><span class="lineno"> 44</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> a = <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>(.5,-.2);</div>
<div class="line"><a name="l00045"></a><span class="lineno"> 45</span>  <a class="code" href="structComplex.html">Complex</a> b = <a class="code" href="group__type.html#gab54c5a1ea720830a7ee394d03fb9f4e9">toComplex</a>(a);</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>  REQUIRE( real(a) == b.<a class="code" href="structComplex.html#ab5b2e2eca02131fc74b289a83636cbe3">real</a> );</div>
<div class="line"><a name="l00048"></a><span class="lineno"> 48</span>  REQUIRE( imag(a) == b.<a class="code" href="structComplex.html#a84f5439aad0ef495efdd3b4c1c02d27e">imag</a> );</div>
<div class="line"><a name="l00049"></a><span class="lineno"> 49</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8h_source.html#l00106">Complex::imag</a>, <a class="el" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a>, <a class="el" href="QuEST_8h_source.html#l00105">Complex::real</a>, and <a class="el" href="group__type.html#gab54c5a1ea720830a7ee394d03fb9f4e9">toComplex</a>.</p>
</div>
</div>
<a id="ga572d6aa93309f0de2004e2ede2a302e3"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga572d6aa93309f0de2004e2ede2a302e3">◆ </a></span>TEST_CASE() <span class="overload">[123/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"twoQubitUnitary" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#gab525a42d63233f61afeb6be97d89dd36" title="Apply a general two-qubit unitary (including a global phase factor).">twoQubitUnitary</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l02670">2670</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l02670"></a><span class="lineno"> 2670</span>  {</div>
<div class="line"><a name="l02671"></a><span class="lineno"> 2671</span>  </div>
<div class="line"><a name="l02672"></a><span class="lineno"> 2672</span>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l02673"></a><span class="lineno"> 2673</span>  </div>
<div class="line"><a name="l02674"></a><span class="lineno"> 2674</span>  <span class="comment">// in distributed mode, each node must be able to fit all amps modified by unitary </span></div>
<div class="line"><a name="l02675"></a><span class="lineno"> 2675</span>  REQUIRE( quregVec.numAmpsPerChunk >= 4 );</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>  <span class="comment">// every test will use a unique random matrix</span></div>
<div class="line"><a name="l02678"></a><span class="lineno"> 2678</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op = <a class="code" href="group__testutilities.html#ga1a5e9b668716b91dd8527ce00f7500cf">getRandomUnitary</a>(2);</div>
<div class="line"><a name="l02679"></a><span class="lineno"> 2679</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="l02680"></a><span class="lineno"> 2680</span>  </div>
<div class="line"><a name="l02681"></a><span class="lineno"> 2681</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l02682"></a><span class="lineno"> 2682</span>  </div>
<div class="line"><a name="l02683"></a><span class="lineno"> 2683</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="l02684"></a><span class="lineno"> 2684</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="l02685"></a><span class="lineno"> 2685</span>  <span class="keywordtype">int</span> targs[] = {targ1, targ2};</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>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l02688"></a><span class="lineno"> 2688</span>  </div>
<div class="line"><a name="l02689"></a><span class="lineno"> 2689</span>  <a class="code" href="group__unitary.html#gab525a42d63233f61afeb6be97d89dd36">twoQubitUnitary</a>(quregVec, targ1, targ2, matr);</div>
<div class="line"><a name="l02690"></a><span class="lineno"> 2690</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, targs, 2, op);</div>
<div class="line"><a name="l02691"></a><span class="lineno"> 2691</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l02692"></a><span class="lineno"> 2692</span>  }</div>
<div class="line"><a name="l02693"></a><span class="lineno"> 2693</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l02694"></a><span class="lineno"> 2694</span>  </div>
<div class="line"><a name="l02695"></a><span class="lineno"> 2695</span>  <a class="code" href="group__unitary.html#gab525a42d63233f61afeb6be97d89dd36">twoQubitUnitary</a>(quregMatr, targ1, targ2, matr);</div>
<div class="line"><a name="l02696"></a><span class="lineno"> 2696</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, targs, 2, op);</div>
<div class="line"><a name="l02697"></a><span class="lineno"> 2697</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 10*REAL_EPS) );</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>  }</div>
<div class="line"><a name="l02700"></a><span class="lineno"> 2700</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</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>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l02703"></a><span class="lineno"> 2703</span>  </div>
<div class="line"><a name="l02704"></a><span class="lineno"> 2704</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="l02705"></a><span class="lineno"> 2705</span>  <span class="keywordtype">int</span> targ2 = 0;</div>
<div class="line"><a name="l02706"></a><span class="lineno"> 2706</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gab525a42d63233f61afeb6be97d89dd36">twoQubitUnitary</a>(quregVec, targ1, targ2, matr), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l02707"></a><span class="lineno"> 2707</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gab525a42d63233f61afeb6be97d89dd36">twoQubitUnitary</a>(quregVec, targ2, targ1, matr), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l02708"></a><span class="lineno"> 2708</span>  }</div>
<div class="line"><a name="l02709"></a><span class="lineno"> 2709</span>  SECTION( <span class="stringliteral">"repetition of targets"</span> ) {</div>
<div class="line"><a name="l02710"></a><span class="lineno"> 2710</span>  </div>
<div class="line"><a name="l02711"></a><span class="lineno"> 2711</span>  <span class="keywordtype">int</span> qb = 0;</div>
<div class="line"><a name="l02712"></a><span class="lineno"> 2712</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gab525a42d63233f61afeb6be97d89dd36">twoQubitUnitary</a>(quregVec, qb, qb, matr), Contains(<span class="stringliteral">"target"</span>) && Contains(<span class="stringliteral">"unique"</span>) );</div>
<div class="line"><a name="l02713"></a><span class="lineno"> 2713</span>  }</div>
<div class="line"><a name="l02714"></a><span class="lineno"> 2714</span>  SECTION( <span class="stringliteral">"unitarity"</span> ) {</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>  matr.<a class="code" href="structComplexMatrix4.html#aeadc9893e1b16cdd585dac523e73926c">real</a>[0][0] = 0; <span class="comment">// break matr unitarity</span></div>
<div class="line"><a name="l02717"></a><span class="lineno"> 2717</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gab525a42d63233f61afeb6be97d89dd36">twoQubitUnitary</a>(quregVec, 0, 1, matr), Contains(<span class="stringliteral">"unitary"</span>) );</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>  SECTION( <span class="stringliteral">"unitary fits in node"</span> ) {</div>
<div class="line"><a name="l02720"></a><span class="lineno"> 2720</span>  </div>
<div class="line"><a name="l02721"></a><span class="lineno"> 2721</span>  <span class="comment">// pretend we have a very limited distributed memory</span></div>
<div class="line"><a name="l02722"></a><span class="lineno"> 2722</span>  quregVec.numAmpsPerChunk = 1;</div>
<div class="line"><a name="l02723"></a><span class="lineno"> 2723</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gab525a42d63233f61afeb6be97d89dd36">twoQubitUnitary</a>(quregVec, 0, 1, matr), Contains(<span class="stringliteral">"targets too many qubits"</span>));</div>
<div class="line"><a name="l02724"></a><span class="lineno"> 2724</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>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l02727"></a><span class="lineno"> 2727</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00530">getRandomUnitary()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, <a class="el" href="QuEST_8h_source.html#l00177">ComplexMatrix4::real</a>, <a class="el" href="utilities_8cpp_source.html#l01027">toComplexMatrix4()</a>, and <a class="el" href="QuEST_8c_source.html#l00256">twoQubitUnitary()</a>.</p>
</div>
</div>
<a id="ga826c9b5aef57549316ebef503203d85b"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga826c9b5aef57549316ebef503203d85b">◆ </a></span>TEST_CASE() <span class="overload">[124/124]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TEST_CASE </td>
<td>(</td>
<td class="paramtype">"unitary" </td>
<td class="paramname">, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">"" </td>
<td class="paramname">[unitaries] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__unitary.html#ga78b814256f851cac70fdf3cbf9cfc206" title="Apply a general single-qubit unitary (including a global phase factor).">unitary</a></dd></dl>
<dl class="section author"><dt>Author</dt><dd>Tyson Jones </dd></dl>
<p class="definition">Definition at line <a class="el" href="test__unitaries_8cpp_source.html#l02735">2735</a> of file <a class="el" href="test__unitaries_8cpp_source.html">test_unitaries.cpp</a>.</p>
<div class="fragment"><div class="line"><a name="l02735"></a><span class="lineno"> 2735</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="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l02738"></a><span class="lineno"> 2738</span>  </div>
<div class="line"><a name="l02739"></a><span class="lineno"> 2739</span>  <span class="comment">// every test will use a unique random matrix</span></div>
<div class="line"><a name="l02740"></a><span class="lineno"> 2740</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op = <a class="code" href="group__testutilities.html#ga1a5e9b668716b91dd8527ce00f7500cf">getRandomUnitary</a>(1);</div>
<div class="line"><a name="l02741"></a><span class="lineno"> 2741</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="l02742"></a><span class="lineno"> 2742</span>  </div>
<div class="line"><a name="l02743"></a><span class="lineno"> 2743</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</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>  <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="l02746"></a><span class="lineno"> 2746</span>  </div>
<div class="line"><a name="l02747"></a><span class="lineno"> 2747</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</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>  <a class="code" href="group__unitary.html#ga78b814256f851cac70fdf3cbf9cfc206">unitary</a>(quregVec, target, matr);</div>
<div class="line"><a name="l02750"></a><span class="lineno"> 2750</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, target, op);</div>
<div class="line"><a name="l02751"></a><span class="lineno"> 2751</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</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">"density-matrix"</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="group__unitary.html#ga78b814256f851cac70fdf3cbf9cfc206">unitary</a>(quregMatr, target, matr);</div>
<div class="line"><a name="l02756"></a><span class="lineno"> 2756</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, target, op);</div>
<div class="line"><a name="l02757"></a><span class="lineno"> 2757</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 10*REAL_EPS) );</div>
<div class="line"><a name="l02758"></a><span class="lineno"> 2758</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>  SECTION( <span class="stringliteral">"input validation"</span> ) {</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>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l02763"></a><span class="lineno"> 2763</span>  </div>
<div class="line"><a name="l02764"></a><span class="lineno"> 2764</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="l02765"></a><span class="lineno"> 2765</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga78b814256f851cac70fdf3cbf9cfc206">unitary</a>(quregVec, target, matr), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l02766"></a><span class="lineno"> 2766</span>  }</div>
<div class="line"><a name="l02767"></a><span class="lineno"> 2767</span>  SECTION( <span class="stringliteral">"unitarity"</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>  matr.<a class="code" href="structComplexMatrix2.html#a3ea98d545b67a190ee6abe936c72076f">real</a>[0][0] = 0; <span class="comment">// break matr unitarity</span></div>
<div class="line"><a name="l02770"></a><span class="lineno"> 2770</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga78b814256f851cac70fdf3cbf9cfc206">unitary</a>(quregVec, 0, matr), Contains(<span class="stringliteral">"unitary"</span>) );</div>
<div class="line"><a name="l02771"></a><span class="lineno"> 2771</span>  }</div>
<div class="line"><a name="l02772"></a><span class="lineno"> 2772</span>  }</div>
<div class="line"><a name="l02773"></a><span class="lineno"> 2773</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l02774"></a><span class="lineno"> 2774</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00728">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00398">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00530">getRandomUnitary()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>, <a class="el" href="QuEST_8h_source.html#l00139">ComplexMatrix2::real</a>, <a class="el" href="utilities_8cpp_source.html#l01021">toComplexMatrix2()</a>, and <a class="el" href="QuEST_8c_source.html#l00348">unitary()</a>.</p>
</div>
</div>
</div><!-- contents -->
<div class="ttc" id="agroup__unitary_html_ga7eb969c1dd6c949aecf716d2fba71120"><div class="ttname"><a href="group__unitary.html#ga7eb969c1dd6c949aecf716d2fba71120">controlledRotateZ</a></div><div class="ttdeci">void controlledRotateZ(Qureg qureg, int controlQubit, int targetQubit, qreal angle)</div><div class="ttdoc">Applies a controlled rotation by a given angle around the Z-axis of the Bloch-sphere.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00244">QuEST.c:244</a></div></div>
<div class="ttc" id="agroup__decoherence_html_gacc2667ac87482a7afdcb711b74bf732e"><div class="ttname"><a href="group__decoherence.html#gacc2667ac87482a7afdcb711b74bf732e">mixDephasing</a></div><div class="ttdeci">void mixDephasing(Qureg qureg, int targetQubit, qreal prob)</div><div class="ttdoc">Mixes a density matrix qureg to induce single-qubit dephasing noise.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01250">QuEST.c:1250</a></div></div>
<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__calc_html_ga4a14d22379d399760b0cfc5c8053589b"><div class="ttname"><a href="group__calc.html#ga4a14d22379d399760b0cfc5c8053589b">getProbAmp</a></div><div class="ttdeci">qreal getProbAmp(Qureg qureg, long long int index)</div><div class="ttdoc">Get the probability of a state-vector at an index in the full state vector.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00932">QuEST.c:932</a></div></div>
<div class="ttc" id="agroup__init_html_gada7230491a50cd409f8b00f5ee1db953"><div class="ttname"><a href="group__init.html#gada7230491a50cd409f8b00f5ee1db953">initBlankState</a></div><div class="ttdeci">void initBlankState(Qureg qureg)</div><div class="ttdoc">Initialises a qureg to have all-zero-amplitudes.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00119">QuEST.c:119</a></div></div>
<div class="ttc" id="astructVector_html"><div class="ttname"><a href="structVector.html">Vector</a></div><div class="ttdoc">Represents a 3-vector of real numbers.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00198">QuEST.h:198</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__testutilities_html_ga20f041452b43026d876fde17a5999265"><div class="ttname"><a href="group__testutilities.html#ga20f041452b43026d876fde17a5999265">getFullOperatorMatrix</a></div><div class="ttdeci">QMatrix getFullOperatorMatrix(int *ctrls, int numCtrls, int *targs, int numTargs, QMatrix op, int numQubits)</div><div class="ttdoc">Takes a 2^numTargs-by-2^numTargs matrix op and a returns a 2^numQubits-by-2^numQubits matrix where op...</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l00304">utilities.cpp:304</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__unitary_html_gab525a42d63233f61afeb6be97d89dd36"><div class="ttname"><a href="group__unitary.html#gab525a42d63233f61afeb6be97d89dd36">twoQubitUnitary</a></div><div class="ttdeci">void twoQubitUnitary(Qureg qureg, int targetQubit1, int targetQubit2, ComplexMatrix4 u)</div><div class="ttdoc">Apply a general two-qubit unitary (including a global phase factor).</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00256">QuEST.c:256</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga13f904b417f647c70d163770e65906fc"><div class="ttname"><a href="group__unitary.html#ga13f904b417f647c70d163770e65906fc">controlledRotateX</a></div><div class="ttdeci">void controlledRotateX(Qureg qureg, int controlQubit, int targetQubit, qreal angle)</div><div class="ttdoc">Applies a controlled rotation by a given angle around the X-axis of the Bloch-sphere.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00220">QuEST.c:220</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__debug_html_ga924ef2dbda6b733b4041270077c76ece"><div class="ttname"><a href="group__debug.html#ga924ef2dbda6b733b4041270077c76ece">copyStateFromGPU</a></div><div class="ttdeci">void copyStateFromGPU(Qureg qureg)</div><div class="ttdoc">In GPU mode, this copies the state-vector (or density matrix) from GPU memory (qureg....</div><div class="ttdef"><b>Definition:</b> <a href="QuEST__cpu_8c_source.html#l00045">QuEST_cpu.c:45</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="astructComplexMatrix4_html_aeadc9893e1b16cdd585dac523e73926c"><div class="ttname"><a href="structComplexMatrix4.html#aeadc9893e1b16cdd585dac523e73926c">ComplexMatrix4::real</a></div><div class="ttdeci">qreal real[4][4]</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00177">QuEST.h:177</a></div></div>
<div class="ttc" id="agroup__debug_html_ga8d31fe2d1ad4d01e2a1f5f6b8bc15b77"><div class="ttname"><a href="group__debug.html#ga8d31fe2d1ad4d01e2a1f5f6b8bc15b77">syncQuESTEnv</a></div><div class="ttdeci">void syncQuESTEnv(QuESTEnv env)</div><div class="ttdoc">Guarantees that all code up to the given point has been executed on all nodes (if running in distribu...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST__cpu__distributed_8c_source.html#l00164">QuEST_cpu_distributed.c:164</a></div></div>
<div class="ttc" id="agroup__type_html_ga3cf635d2b2e57226c8d5a777f513367e"><div class="ttname"><a href="group__type.html#ga3cf635d2b2e57226c8d5a777f513367e">fromComplex</a></div><div class="ttdeci">#define fromComplex(comp)</div></div>
<div class="ttc" id="agroup__init_html_ga9a348df3e1df623c3d4c4f12c3ee3fe8"><div class="ttname"><a href="group__init.html#ga9a348df3e1df623c3d4c4f12c3ee3fe8">initPureState</a></div><div class="ttdeci">void initPureState(Qureg qureg, Qureg pure)</div><div class="ttdoc">Initialise qureg into to a given pure state of an equivalent Hilbert dimension.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00145">QuEST.c:145</a></div></div>
<div class="ttc" id="atest__unitaries_8cpp_html_aec8f698a7995e17e0ff1055526d2e5d4"><div class="ttname"><a href="test__unitaries_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__unitaries_8cpp_source.html#l00033">test_unitaries.cpp:33</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__unitary_html_ga4c708f066b244801e10f538b48b90145"><div class="ttname"><a href="group__unitary.html#ga4c708f066b244801e10f538b48b90145">rotateAroundAxis</a></div><div class="ttdeci">void rotateAroundAxis(Qureg qureg, int rotQubit, qreal angle, Vector axis)</div><div class="ttdoc">Rotate a single qubit by a given angle around a given Vector on the Bloch-sphere.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00601">QuEST.c:601</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__decoherence_html_gae2ea9255b8b11a4a382231e5604dc4e3"><div class="ttname"><a href="group__decoherence.html#gae2ea9255b8b11a4a382231e5604dc4e3">mixDepolarising</a></div><div class="ttdeci">void mixDepolarising(Qureg qureg, int targetQubit, qreal prob)</div><div class="ttdoc">Mixes a density matrix qureg to induce single-qubit homogeneous depolarising noise.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01272">QuEST.c:1272</a></div></div>
<div class="ttc" id="astructQuESTEnv_html_aa648bb336cf8598467cb62db00b9cee8"><div class="ttname"><a href="structQuESTEnv.html#aa648bb336cf8598467cb62db00b9cee8">QuESTEnv::rank</a></div><div class="ttdeci">int rank</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00364">QuEST.h:364</a></div></div>
<div class="ttc" id="agroup__calc_html_gab082910d33473ec29e1d5852943de468"><div class="ttname"><a href="group__calc.html#gab082910d33473ec29e1d5852943de468">calcTotalProb</a></div><div class="ttdeci">qreal calcTotalProb(Qureg qureg)</div><div class="ttdoc">A debugging function which calculates the probability of the qubits in qureg being in any state,...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01143">QuEST.c:1143</a></div></div>
<div class="ttc" id="agroup__decoherence_html_gaea8509011985522bae857bd3b13c34ed"><div class="ttname"><a href="group__decoherence.html#gaea8509011985522bae857bd3b13c34ed">mixDamping</a></div><div class="ttdeci">void mixDamping(Qureg qureg, int targetQubit, qreal prob)</div><div class="ttdoc">Mixes a density matrix qureg to induce single-qubit amplitude damping (decay to 0 state).</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01283">QuEST.c:1283</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="astructDiagonalOp_html_ada3bffa8e414f883e415dd74e46cd879"><div class="ttname"><a href="structDiagonalOp.html#ada3bffa8e414f883e415dd74e46cd879">DiagonalOp::numChunks</a></div><div class="ttdeci">int numChunks</div><div class="ttdoc">The number of nodes between which the elements of this operator are split.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00304">QuEST.h:304</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__calc_html_gad0cc08d52cad5062553d6f78126780cc"><div class="ttname"><a href="group__calc.html#gad0cc08d52cad5062553d6f78126780cc">calcProbOfAllOutcomes</a></div><div class="ttdeci">void calcProbOfAllOutcomes(qreal *retProbs, Qureg qureg, int *qubits, int numQubits)</div><div class="ttdoc">Populates outcomeProbs with the probabilities of every outcome of the sub-register contained in qubit...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01176">QuEST.c:1176</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__unitary_html_gafd81a9217fb7d21c365443442492b2dc"><div class="ttname"><a href="group__unitary.html#gafd81a9217fb7d21c365443442492b2dc">multiControlledMultiQubitNot</a></div><div class="ttdeci">void multiControlledMultiQubitNot(Qureg qureg, int *ctrls, int numCtrls, int *targs, int numTargs)</div><div class="ttdoc">Apply a NOT (or Pauli X) gate with multiple control and target qubits.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00549">QuEST.c:549</a></div></div>
<div class="ttc" id="agroup__calc_html_gadca286c4ad5cde6124d4e80a7ab95a68"><div class="ttname"><a href="group__calc.html#gadca286c4ad5cde6124d4e80a7ab95a68">getDensityAmp</a></div><div class="ttdeci">Complex getDensityAmp(Qureg qureg, long long int row, long long int col)</div><div class="ttdoc">Get an amplitude from a density matrix at a given row and column.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00949">QuEST.c:949</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__testutilities_html_ga0d3b30625e2350a1e837a0b259dd3b18"><div class="ttname"><a href="group__testutilities.html#ga0d3b30625e2350a1e837a0b259dd3b18">getRandomKrausMap</a></div><div class="ttdeci">std::vector< QMatrix > getRandomKrausMap(int numQb, int numOps)</div><div class="ttdoc">Returns a random Kraus map of #numOps 2^numQb-by-2^numQb operators, from an undisclosed distribution.</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l00578">utilities.cpp:578</a></div></div>
<div class="ttc" id="agroup__type_html_gaa86572b44755646858d6b0292d53cc15"><div class="ttname"><a href="group__type.html#gaa86572b44755646858d6b0292d53cc15">createDiagonalOpFromPauliHamilFile</a></div><div class="ttdeci">DiagonalOp createDiagonalOpFromPauliHamilFile(char *fn, QuESTEnv env)</div><div class="ttdoc">Creates and initialiases a diagonal operator from the Z Pauli Hamiltonian encoded in file with filena...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01558">QuEST.c:1558</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__calc_html_gad575782de461d9ab0975b38cc7850f1a"><div class="ttname"><a href="group__calc.html#gad575782de461d9ab0975b38cc7850f1a">getImagAmp</a></div><div class="ttdeci">qreal getImagAmp(Qureg qureg, long long int index)</div><div class="ttdoc">Get the imaginary component of the complex probability amplitude at an index in the state vector.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00925">QuEST.c:925</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga0c84c429cb1d7e2596706c1804dd9cba"><div class="ttname"><a href="group__unitary.html#ga0c84c429cb1d7e2596706c1804dd9cba">controlledRotateAroundAxis</a></div><div class="ttdeci">void controlledRotateAroundAxis(Qureg qureg, int controlQubit, int targetQubit, qreal angle, Vector axis)</div><div class="ttdoc">Applies a controlled rotation by a given angle around a given vector on the Bloch-sphere.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00614">QuEST.c:614</a></div></div>
<div class="ttc" id="agroup__decoherence_html_gacb7faa9d8afb0f4270c866424fffbccd"><div class="ttname"><a href="group__decoherence.html#gacb7faa9d8afb0f4270c866424fffbccd">mixKrausMap</a></div><div class="ttdeci">void mixKrausMap(Qureg qureg, int target, ComplexMatrix2 *ops, int numOps)</div><div class="ttdoc">Apply a general single-qubit Kraus map to a density matrix, as specified by at most four Kraus operat...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01314">QuEST.c:1314</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="astructVector_html_ab33976d8fda2e44b770f71269d698a25"><div class="ttname"><a href="structVector.html#ab33976d8fda2e44b770f71269d698a25">Vector::z</a></div><div class="ttdeci">qreal z</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00200">QuEST.h:200</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga65c7879947e398690a5428bd43e143e3"><div class="ttname"><a href="group__unitary.html#ga65c7879947e398690a5428bd43e143e3">multiControlledTwoQubitUnitary</a></div><div class="ttdeci">void multiControlledTwoQubitUnitary(Qureg qureg, int *controlQubits, int numControlQubits, int targetQubit1, int targetQubit2, ComplexMatrix4 u)</div><div class="ttdoc">Apply a general multi-controlled two-qubit unitary (including a global phase factor).</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00282">QuEST.c:282</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="agroup__normgate_html_ga34457f7f62ccd75fb7d3fe67cd2f815a"><div class="ttname"><a href="group__normgate.html#ga34457f7f62ccd75fb7d3fe67cd2f815a">collapseToOutcome</a></div><div class="ttdeci">qreal collapseToOutcome(Qureg qureg, int measureQubit, int outcome)</div><div class="ttdoc">Updates qureg to be consistent with measuring measureQubit in the given outcome (0 or 1),...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00966">QuEST.c:966</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="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_ga683779343fb2c6055f6b1d01079c2ede"><div class="ttname"><a href="group__calc.html#ga683779343fb2c6055f6b1d01079c2ede">calcPurity</a></div><div class="ttdeci">qreal calcPurity(Qureg qureg)</div><div class="ttdoc">Calculates the purity of a density matrix, by the trace of the density matrix squared.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01185">QuEST.c:1185</a></div></div>
<div class="ttc" id="agroup__calc_html_ga2a7946e6fa4f44c9ae0c6c9f683229ad"><div class="ttname"><a href="group__calc.html#ga2a7946e6fa4f44c9ae0c6c9f683229ad">calcProbOfOutcome</a></div><div class="ttdeci">qreal calcProbOfOutcome(Qureg qureg, int measureQubit, int outcome)</div><div class="ttdoc">Gives the probability of a specified qubit being measured in the given outcome (0 or 1).</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01166">QuEST.c:1166</a></div></div>
<div class="ttc" id="agroup__normgate_html_ga2a3794103125f1e3cfa103f8b1963656"><div class="ttname"><a href="group__normgate.html#ga2a3794103125f1e3cfa103f8b1963656">measure</a></div><div class="ttdeci">int measure(Qureg qureg, int measureQubit)</div><div class="ttdoc">Measures a single qubit, collapsing it randomly to 0 or 1.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00998">QuEST.c:998</a></div></div>
<div class="ttc" id="agroup__testutilities_html_ga1a5e9b668716b91dd8527ce00f7500cf"><div class="ttname"><a href="group__testutilities.html#ga1a5e9b668716b91dd8527ce00f7500cf">getRandomUnitary</a></div><div class="ttdeci">QMatrix getRandomUnitary(int numQb)</div><div class="ttdoc">Returns a uniformly random (under Haar) 2^numQb-by-2^numQb unitary matrix.</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l00530">utilities.cpp:530</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_ga8efe977bb581c8bc760d2ce2419161d7"><div class="ttname"><a href="group__testutilities.html#ga8efe977bb581c8bc760d2ce2419161d7">writeToFileSynch</a></div><div class="ttdeci">void writeToFileSynch(char *fn, const string &contents)</div><div class="ttdoc">Writes contents to the file with filename fn, which is created and/or overwritten.</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l01362">utilities.cpp:1362</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__unitary_html_ga78b814256f851cac70fdf3cbf9cfc206"><div class="ttname"><a href="group__unitary.html#ga78b814256f851cac70fdf3cbf9cfc206">unitary</a></div><div class="ttdeci">void unitary(Qureg qureg, int targetQubit, ComplexMatrix2 u)</div><div class="ttdoc">Apply a general single-qubit unitary (including a global phase factor).</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00348">QuEST.c:348</a></div></div>
<div class="ttc" id="astructDiagonalOp_html_aa91713a22c95a383bba55e56c4a4e37a"><div class="ttname"><a href="structDiagonalOp.html#aa91713a22c95a383bba55e56c4a4e37a">DiagonalOp::chunkId</a></div><div class="ttdeci">int chunkId</div><div class="ttdoc">The position of the chunk of the operator held by this process in the full operator.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00306">QuEST.h:306</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_ga2de7d3b138728b6beb7753b82df61803"><div class="ttname"><a href="group__testutilities.html#ga2de7d3b138728b6beb7753b82df61803">getKetBra</a></div><div class="ttdeci">QMatrix getKetBra(QVector ket, QVector bra)</div><div class="ttdoc">Returns the matrix |ket><bra|, with ith-jth element ket(i) conj(bra(j)), since |ket><bra| = sum_i a_i...</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l00169">utilities.cpp:169</a></div></div>
<div class="ttc" id="agroup__decoherence_html_gacfc45a8fc86ee18f60866bbd0c874ed0"><div class="ttname"><a href="group__decoherence.html#gacfc45a8fc86ee18f60866bbd0c874ed0">mixTwoQubitDepolarising</a></div><div class="ttdeci">void mixTwoQubitDepolarising(Qureg qureg, int qubit1, int qubit2, qreal prob)</div><div class="ttdoc">Mixes a density matrix qureg to induce two-qubit homogeneous depolarising noise.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01291">QuEST.c:1291</a></div></div>
<div class="ttc" id="agroup__calc_html_ga82f17e96a4cb7612fb9c6ef856df3810"><div class="ttname"><a href="group__calc.html#ga82f17e96a4cb7612fb9c6ef856df3810">calcExpecDiagonalOp</a></div><div class="ttdeci">Complex calcExpecDiagonalOp(Qureg qureg, DiagonalOp op)</div><div class="ttdoc">Computes the expected value of the diagonal operator op for state qureg.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01228">QuEST.c:1228</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga655ffcd4def2e127341c9488f5ca8455"><div class="ttname"><a href="group__unitary.html#ga655ffcd4def2e127341c9488f5ca8455">sGate</a></div><div class="ttdeci">void sGate(Qureg qureg, int targetQubit)</div><div class="ttdoc">Apply the single-qubit S gate.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00465">QuEST.c:465</a></div></div>
<div class="ttc" id="agroup__init_html_ga4534403b721977b669bff7bf4e37f0fb"><div class="ttname"><a href="group__init.html#ga4534403b721977b669bff7bf4e37f0fb">cloneQureg</a></div><div class="ttdeci">void cloneQureg(Qureg targetQureg, Qureg copyQureg)</div><div class="ttdoc">Overwrite the amplitudes of targetQureg with those from copyQureg.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00164">QuEST.c:164</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__unitary_html_ga34312ff52cc28bcab3cbd2ff338fd081"><div class="ttname"><a href="group__unitary.html#ga34312ff52cc28bcab3cbd2ff338fd081">rotateY</a></div><div class="ttdeci">void rotateY(Qureg qureg, int targetQubit, qreal angle)</div><div class="ttdoc">Rotate a single qubit by a given angle around the Y-axis of the Bloch-sphere.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00198">QuEST.c:198</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="astructQuESTEnv_html"><div class="ttname"><a href="structQuESTEnv.html">QuESTEnv</a></div><div class="ttdoc">Information about the environment the program is running in.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00362">QuEST.h:362</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__type_html_gaa77376c5e3518186eb085f37826d6008"><div class="ttname"><a href="group__type.html#gaa77376c5e3518186eb085f37826d6008">createPauliHamilFromFile</a></div><div class="ttdeci">PauliHamil createPauliHamilFromFile(char *fn)</div><div class="ttdoc">Creates a PauliHamil instance, a real-weighted sum of products of Pauli operators,...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01420">QuEST.c:1420</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="agroup__unitary_html_ga0832e39058d913ad47af44e97a854446"><div class="ttname"><a href="group__unitary.html#ga0832e39058d913ad47af44e97a854446">multiControlledPhaseShift</a></div><div class="ttdeci">void multiControlledPhaseShift(Qureg qureg, int *controlQubits, int numControlQubits, qreal angle)</div><div class="ttdoc">Introduce a phase factor on state of the passed qubits.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00510">QuEST.c:510</a></div></div>
<div class="ttc" id="agroup__type_html_gafabb15a6c1cf49f8ecb67e1f35c77c1e"><div class="ttname"><a href="group__type.html#gafabb15a6c1cf49f8ecb67e1f35c77c1e">setDiagonalOpElems</a></div><div class="ttdeci">void setDiagonalOpElems(DiagonalOp op, long long int startInd, qreal *real, qreal *imag, long long int numElems)</div><div class="ttdoc">Modifies a subset (starting at index startInd, and ending at index startInd + numElems) of the elemen...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01543">QuEST.c:1543</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__init_html_gabc0c64f8adf307d2a44184dc0f8ca66e"><div class="ttname"><a href="group__init.html#gabc0c64f8adf307d2a44184dc0f8ca66e">setAmps</a></div><div class="ttdeci">void setAmps(Qureg qureg, long long int startInd, qreal *reals, qreal *imags, long long int numAmps)</div><div class="ttdoc">Overwrites a subset of the amplitudes in state-vector qureg, with those passed in reals and imags.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01021">QuEST.c:1021</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__unitary_html_gad76781842af56821ed4e223bd776f057"><div class="ttname"><a href="group__unitary.html#gad76781842af56821ed4e223bd776f057">multiControlledPhaseFlip</a></div><div class="ttdeci">void multiControlledPhaseFlip(Qureg qureg, int *controlQubits, int numControlQubits)</div><div class="ttdoc">Apply the multiple-qubit controlled phase flip gate, also known as the multiple-qubit controlled paul...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00587">QuEST.c:587</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga20bf9b8a71b8a3ee4651e9497e6d1f4f"><div class="ttname"><a href="group__unitary.html#ga20bf9b8a71b8a3ee4651e9497e6d1f4f">multiQubitUnitary</a></div><div class="ttdeci">void multiQubitUnitary(Qureg qureg, int *targs, int numTargs, ComplexMatrixN u)</div><div class="ttdoc">Apply a general multi-qubit unitary (including a global phase factor) with any number of target qubit...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00296">QuEST.c:296</a></div></div>
<div class="ttc" id="atest__unitaries_8cpp_html_ae34496c47ef565b741782f01e710ea2c"><div class="ttname"><a href="test__unitaries_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 unitaries.</div><div class="ttdef"><b>Definition:</b> <a href="test__unitaries_8cpp_source.html#l00024">test_unitaries.cpp:24</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga1e5dd165b402e97abaa0b807026527f2"><div class="ttname"><a href="group__unitary.html#ga1e5dd165b402e97abaa0b807026527f2">multiControlledMultiRotateZ</a></div><div class="ttdeci">void multiControlledMultiRotateZ(Qureg qureg, int *controlQubits, int numControls, int *targetQubits, int numTargets, qreal angle)</div><div class="ttdoc">Apply a multi-controlled multi-target Z rotation, also known as a controlled phase gadget.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00668">QuEST.c:668</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__calc_html_ga30d6f8b7c766c9c9914b2c61a2fc0def"><div class="ttname"><a href="group__calc.html#ga30d6f8b7c766c9c9914b2c61a2fc0def">getAmp</a></div><div class="ttdeci">Complex getAmp(Qureg qureg, long long int index)</div><div class="ttdoc">Get the complex amplitude at a given index in the state vector.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00939">QuEST.c:939</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga5e5fdaa7d3dd449b3e2c5d4a01bd015a"><div class="ttname"><a href="group__unitary.html#ga5e5fdaa7d3dd449b3e2c5d4a01bd015a">controlledPauliY</a></div><div class="ttdeci">void controlledPauliY(Qureg qureg, int controlQubit, int targetQubit)</div><div class="ttdoc">Apply the controlled pauliY (single control, single target) gate, also known as the c-Y and c-sigma-Y...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00563">QuEST.c:563</a></div></div>
<div class="ttc" id="agroup__testutilities_html_ga00f4feec845c019c3390898b0cc7f1ef"><div class="ttname"><a href="group__testutilities.html#ga00f4feec845c019c3390898b0cc7f1ef">getExponentialOfPauliMatrix</a></div><div class="ttdeci">QMatrix getExponentialOfPauliMatrix(qreal angle, QMatrix a)</div><div class="ttdoc">Returns the matrix exponential of a kronecker product of pauli matrices (or of any involutory matrice...</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l00216">utilities.cpp:216</a></div></div>
<div class="ttc" id="agroup__normgate_html_gae192ac0759e46c7b20a7182020155240"><div class="ttname"><a href="group__normgate.html#gae192ac0759e46c7b20a7182020155240">measureWithStats</a></div><div class="ttdeci">int measureWithStats(Qureg qureg, int measureQubit, qreal *outcomeProb)</div><div class="ttdoc">Measures a single qubit, collapsing it randomly to 0 or 1, and additionally gives the probability of ...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00985">QuEST.c:985</a></div></div>
<div class="ttc" id="astructQureg_html_a0a86e8a50ea8c998b4a0a6640c5a1218"><div class="ttname"><a href="structQureg.html#a0a86e8a50ea8c998b4a0a6640c5a1218">Qureg::numQubitsInStateVec</a></div><div class="ttdeci">int numQubitsInStateVec</div><div class="ttdoc">Number of qubits in the state-vector - this is double the number represented for mixed states.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00329">QuEST.h:329</a></div></div>
<div class="ttc" id="agroup__calc_html_ga5544d2833a69941b8820797b79daf79f"><div class="ttname"><a href="group__calc.html#ga5544d2833a69941b8820797b79daf79f">calcExpecPauliHamil</a></div><div class="ttdeci">qreal calcExpecPauliHamil(Qureg qureg, PauliHamil hamil, Qureg workspace)</div><div class="ttdoc">Computes the expected value of qureg under Hermitian operator hamil.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01219">QuEST.c:1219</a></div></div>
<div class="ttc" id="agroup__testutilities_html_ga7c35b1d233b0fb5b42de3bceee26e7e5"><div class="ttname"><a href="group__testutilities.html#ga7c35b1d233b0fb5b42de3bceee26e7e5">setUniqueFilename</a></div><div class="ttdeci">void setUniqueFilename(char *outFn, char *prefix)</div><div class="ttdoc">Modifies outFn to be a filename of format prefix_NUM.txt where NUM is a new unique integer so far.</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l01358">utilities.cpp:1358</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga3ad6c477edcdbc845fc1143e860fda08"><div class="ttname"><a href="group__unitary.html#ga3ad6c477edcdbc845fc1143e860fda08">multiControlledMultiQubitUnitary</a></div><div class="ttdeci">void multiControlledMultiQubitUnitary(Qureg qureg, int *ctrls, int numCtrls, int *targs, int numTargs, ComplexMatrixN u)</div><div class="ttdoc">Apply a general multi-controlled multi-qubit unitary (including a global phase factor).</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00330">QuEST.c:330</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="agroup__unitary_html_ga8886a3793b21622c48cf3bad6e15082d"><div class="ttname"><a href="group__unitary.html#ga8886a3793b21622c48cf3bad6e15082d">rotateX</a></div><div class="ttdeci">void rotateX(Qureg qureg, int targetQubit, qreal angle)</div><div class="ttdoc">Rotate a single qubit by a given angle around the X-axis of the Bloch-sphere.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00187">QuEST.c:187</a></div></div>
<div class="ttc" id="agroup__init_html_ga5d0f3f71ea38d3c44597f8c2c2f014d4"><div class="ttname"><a href="group__init.html#ga5d0f3f71ea38d3c44597f8c2c2f014d4">setWeightedQureg</a></div><div class="ttdeci">void setWeightedQureg(Complex fac1, Qureg qureg1, Complex fac2, Qureg qureg2, Complex facOut, Qureg out)</div><div class="ttdoc">Modifies qureg out to the result of (facOut out + fac1 qureg1 + fac2 qureg2), imposing no constraints...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01037">QuEST.c:1037</a></div></div>
<div class="ttc" id="agroup__unitary_html_gab2ececaa253252e1b1cdb18a8452704a"><div class="ttname"><a href="group__unitary.html#gab2ececaa253252e1b1cdb18a8452704a">multiControlledMultiRotatePauli</a></div><div class="ttdeci">void multiControlledMultiRotatePauli(Qureg qureg, int *controlQubits, int numControls, int *targetQubits, enum pauliOpType *targetPaulis, int numTargets, qreal angle)</div><div class="ttdoc">Apply a multi-controlled multi-target multi-Pauli rotation, also known as a controlled Pauli gadget.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00705">QuEST.c:705</a></div></div>
<div class="ttc" id="agroup__calc_html_ga87ddbe5c8281543541ccd99e0dafd387"><div class="ttname"><a href="group__calc.html#ga87ddbe5c8281543541ccd99e0dafd387">calcHilbertSchmidtDistance</a></div><div class="ttdeci">qreal calcHilbertSchmidtDistance(Qureg a, Qureg b)</div><div class="ttdoc">Computes the Hilbert Schmidt distance between two density matrices a and b, defined as the Frobenius ...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01237">QuEST.c:1237</a></div></div>
<div class="ttc" id="astructVector_html_abc3cfc6c8e297b1153a373d84b981e6b"><div class="ttname"><a href="structVector.html#abc3cfc6c8e297b1153a373d84b981e6b">Vector::y</a></div><div class="ttdeci">qreal y</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00200">QuEST.h:200</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="astructVector_html_a0d0459a5b731ac5fb3dff2c6134e6e88"><div class="ttname"><a href="structVector.html#a0d0459a5b731ac5fb3dff2c6134e6e88">Vector::x</a></div><div class="ttdeci">qreal x</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00200">QuEST.h:200</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga5d80b490e3910aa737a81bb597cdfcc9"><div class="ttname"><a href="group__unitary.html#ga5d80b490e3910aa737a81bb597cdfcc9">pauliZ</a></div><div class="ttdeci">void pauliZ(Qureg qureg, int targetQubit)</div><div class="ttdoc">Apply the single-qubit Pauli-Z (also known as the Z, sigma-Z or phase-flip) gate.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00454">QuEST.c:454</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="astructQureg_html_ab0ea0358482b62f43fdd781469607d97"><div class="ttname"><a href="structQureg.html#ab0ea0358482b62f43fdd781469607d97">Qureg::numAmpsPerChunk</a></div><div class="ttdeci">long long int numAmpsPerChunk</div><div class="ttdoc">Number of probability amplitudes held in stateVec by this process In the non-MPI version,...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00332">QuEST.h:332</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="agroup__unitary_html_ga820fd139c035136819e371308c206e36"><div class="ttname"><a href="group__unitary.html#ga820fd139c035136819e371308c206e36">swapGate</a></div><div class="ttdeci">void swapGate(Qureg qureg, int qb1, int qb2)</div><div class="ttdoc">Performs a SWAP gate between qubit1 and qubit2.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00627">QuEST.c:627</a></div></div>
<div class="ttc" id="agroup__type_html_gad863c5878a01051a2726ce94bf365428"><div class="ttname"><a href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a></div><div class="ttdeci">#define qcomp</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__init_html_ga4589960486ec43dcd63bd985f1c4f398"><div class="ttname"><a href="group__init.html#ga4589960486ec43dcd63bd985f1c4f398">initStateFromAmps</a></div><div class="ttdeci">void initStateFromAmps(Qureg qureg, qreal *reals, qreal *imags)</div><div class="ttdoc">Initialise qureg by specifying all amplitudes.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00157">QuEST.c:157</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__debug_html_ga11448560006dd165128e404b54ebb2f7"><div class="ttname"><a href="group__debug.html#ga11448560006dd165128e404b54ebb2f7">copyStateToGPU</a></div><div class="ttdeci">void copyStateToGPU(Qureg qureg)</div><div class="ttdoc">In GPU mode, this copies the state-vector (or density matrix) from RAM (qureg.stateVec) to VRAM / GPU...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST__cpu_8c_source.html#l00042">QuEST_cpu.c:42</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="agroup__type_html_gab54c5a1ea720830a7ee394d03fb9f4e9"><div class="ttname"><a href="group__type.html#gab54c5a1ea720830a7ee394d03fb9f4e9">toComplex</a></div><div class="ttdeci">#define toComplex(scalar)</div></div>
<div class="ttc" id="astructQuESTEnv_html_af22aacd7c9905accae28484785c193b4"><div class="ttname"><a href="structQuESTEnv.html#af22aacd7c9905accae28484785c193b4">QuESTEnv::numRanks</a></div><div class="ttdeci">int numRanks</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00365">QuEST.h:365</a></div></div>
<div class="ttc" id="agroup__calc_html_ga1416145280c62c5dd5ec9bed89b4cd05"><div class="ttname"><a href="group__calc.html#ga1416145280c62c5dd5ec9bed89b4cd05">getRealAmp</a></div><div class="ttdeci">qreal getRealAmp(Qureg qureg, long long int index)</div><div class="ttdoc">Get the real component of the complex probability amplitude at an index in the state vector.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00918">QuEST.c:918</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga2fa310101ecffd6aeba96f77b7d85f56"><div class="ttname"><a href="group__unitary.html#ga2fa310101ecffd6aeba96f77b7d85f56">controlledPhaseFlip</a></div><div class="ttdeci">void controlledPhaseFlip(Qureg qureg, int idQubit1, int idQubit2)</div><div class="ttdoc">Apply the (two-qubit) controlled phase flip gate, also known as the controlled pauliZ gate.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00575">QuEST.c:575</a></div></div>
<div class="ttc" id="astructDiagonalOp_html_a5131eeb67aafb4c19ac98270c3266742"><div class="ttname"><a href="structDiagonalOp.html#a5131eeb67aafb4c19ac98270c3266742">DiagonalOp::numQubits</a></div><div class="ttdeci">int numQubits</div><div class="ttdoc">The number of qubits this operator can act on (informing its size)</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00300">QuEST.h:300</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__calc_html_ga73036c778d800703585ab3d8796a915f"><div class="ttname"><a href="group__calc.html#ga73036c778d800703585ab3d8796a915f">getNumQubits</a></div><div class="ttdeci">int getNumQubits(Qureg qureg)</div><div class="ttdoc">Returns the number of qubits represented by qureg.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00908">QuEST.c:908</a></div></div>
<div class="ttc" id="agroup__calc_html_ga374ad70804998394ae41ebfe106258a6"><div class="ttname"><a href="group__calc.html#ga374ad70804998394ae41ebfe106258a6">calcInnerProduct</a></div><div class="ttdeci">Complex calcInnerProduct(Qureg bra, Qureg ket)</div><div class="ttdoc">Computes the inner product of two equal-size state vectors, given by.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01150">QuEST.c:1150</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__unitary_html_gaeb975903209000ebbaf50ef1cc353a79"><div class="ttname"><a href="group__unitary.html#gaeb975903209000ebbaf50ef1cc353a79">controlledMultiQubitUnitary</a></div><div class="ttdeci">void controlledMultiQubitUnitary(Qureg qureg, int ctrl, int *targs, int numTargs, ComplexMatrixN u)</div><div class="ttdoc">Apply a general controlled multi-qubit unitary (including a global phase factor).</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00313">QuEST.c:313</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="agroup__testutilities_html_ga887d1cd8befe710189cab7f535db3910"><div class="ttname"><a href="group__testutilities.html#ga887d1cd8befe710189cab7f535db3910">setRandomDiagPauliHamil</a></div><div class="ttdeci">void setRandomDiagPauliHamil(PauliHamil hamil)</div><div class="ttdoc">Populates hamil with random coefficients and a random amount number of PAULI_I and PAULI_Z operators.</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l01241">utilities.cpp:1241</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga7e58e8131f219f48e5b7410ca8dfe0c0"><div class="ttname"><a href="group__unitary.html#ga7e58e8131f219f48e5b7410ca8dfe0c0">multiQubitNot</a></div><div class="ttdeci">void multiQubitNot(Qureg qureg, int *targs, int numTargs)</div><div class="ttdoc">Apply a NOT (or Pauli X) gate with multiple target qubits, which has the same effect as (but is much ...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00536">QuEST.c:536</a></div></div>
<div class="ttc" id="agroup__decoherence_html_ga2cf7dece0efea4207349f872cdcb7e81"><div class="ttname"><a href="group__decoherence.html#ga2cf7dece0efea4207349f872cdcb7e81">mixTwoQubitKrausMap</a></div><div class="ttdeci">void mixTwoQubitKrausMap(Qureg qureg, int target1, int target2, ComplexMatrix4 *ops, int numOps)</div><div class="ttdoc">Apply a general two-qubit Kraus map to a density matrix, as specified by at most sixteen Kraus operat...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01324">QuEST.c:1324</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__unitary_html_gaefaa7acba90373efe4e0f0b94987c734"><div class="ttname"><a href="group__unitary.html#gaefaa7acba90373efe4e0f0b94987c734">compactUnitary</a></div><div class="ttdeci">void compactUnitary(Qureg qureg, int targetQubit, Complex alpha, Complex beta)</div><div class="ttdoc">Apply a single-qubit unitary parameterised by two given complex scalars.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00404">QuEST.c:404</a></div></div>
<div class="ttc" id="agroup__init_html_ga0379e21efca0767a22607fc0e26a5a22"><div class="ttname"><a href="group__init.html#ga0379e21efca0767a22607fc0e26a5a22">initClassicalState</a></div><div class="ttdeci">void initClassicalState(Qureg qureg, long long int stateInd)</div><div class="ttdoc">Initialise qureg into the classical state (also known as a "computational basis state") with index st...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00134">QuEST.c:134</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga8e0f03e745778a89d6f59c3c25e32df8"><div class="ttname"><a href="group__unitary.html#ga8e0f03e745778a89d6f59c3c25e32df8">pauliY</a></div><div class="ttdeci">void pauliY(Qureg qureg, int targetQubit)</div><div class="ttdoc">Apply the single-qubit Pauli-Y (also known as the Y or sigma-Y) gate.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00443">QuEST.c:443</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="agroup__unitary_html_ga7214a79aa22ae7a50ad6f38615968cb0"><div class="ttname"><a href="group__unitary.html#ga7214a79aa22ae7a50ad6f38615968cb0">controlledPhaseShift</a></div><div class="ttdeci">void controlledPhaseShift(Qureg qureg, int idQubit1, int idQubit2, qreal angle)</div><div class="ttdoc">Introduce a phase factor on state of qubits idQubit1 and idQubit2.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00498">QuEST.c:498</a></div></div>
<div class="ttc" id="agroup__decoherence_html_ga14282bdb1dc65760ca9ecbe6305eb770"><div class="ttname"><a href="group__decoherence.html#ga14282bdb1dc65760ca9ecbe6305eb770">mixTwoQubitDephasing</a></div><div class="ttdeci">void mixTwoQubitDephasing(Qureg qureg, int qubit1, int qubit2, qreal prob)</div><div class="ttdoc">Mixes a density matrix qureg to induce two-qubit dephasing noise.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01260">QuEST.c:1260</a></div></div>
<div class="ttc" id="agroup__unitary_html_gaa3fb996a5cadd098f4acd8aec955cf9c"><div class="ttname"><a href="group__unitary.html#gaa3fb996a5cadd098f4acd8aec955cf9c">controlledUnitary</a></div><div class="ttdeci">void controlledUnitary(Qureg qureg, int controlQubit, int targetQubit, ComplexMatrix2 u)</div><div class="ttdoc">Apply a general controlled unitary (single control, single target), which can include a global phase ...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00360">QuEST.c:360</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_ga12a6c59ebbfba8bdb9453a4138027d46"><div class="ttname"><a href="group__type.html#ga12a6c59ebbfba8bdb9453a4138027d46">initDiagonalOp</a></div><div class="ttdeci">void initDiagonalOp(DiagonalOp op, qreal *real, qreal *imag)</div><div class="ttdoc">Overwrites the entire DiagonalOp op with the given real and imag complex elements.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01537">QuEST.c:1537</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga26baa057f5db8804825c2d611386753b"><div class="ttname"><a href="group__unitary.html#ga26baa057f5db8804825c2d611386753b">phaseShift</a></div><div class="ttdeci">void phaseShift(Qureg qureg, int targetQubit, qreal angle)</div><div class="ttdoc">Shift the phase between and of a single qubit by a given angle.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00487">QuEST.c:487</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="astructQureg_html_a441e4cacef6bd17adb9813c7442d42fe"><div class="ttname"><a href="structQureg.html#a441e4cacef6bd17adb9813c7442d42fe">Qureg::stateVec</a></div><div class="ttdeci">ComplexArray stateVec</div><div class="ttdoc">Computational state amplitudes - a subset thereof in the MPI version.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00341">QuEST.h:341</a></div></div>
<div class="ttc" id="agroup__unitary_html_gaa5a138473a4433c853c6e66e7aabc237"><div class="ttname"><a href="group__unitary.html#gaa5a138473a4433c853c6e66e7aabc237">controlledNot</a></div><div class="ttdeci">void controlledNot(Qureg qureg, int controlQubit, int targetQubit)</div><div class="ttdoc">Apply the controlled not (single control, single target) gate, also known as the c-X,...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00524">QuEST.c:524</a></div></div>
<div class="ttc" id="astructComplexMatrix2_html_a3ea98d545b67a190ee6abe936c72076f"><div class="ttname"><a href="structComplexMatrix2.html#a3ea98d545b67a190ee6abe936c72076f">ComplexMatrix2::real</a></div><div class="ttdeci">qreal real[2][2]</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00139">QuEST.h:139</a></div></div>
<div class="ttc" id="agroup__calc_html_ga8cbe422d4981bf06847d229a4c6aa3df"><div class="ttname"><a href="group__calc.html#ga8cbe422d4981bf06847d229a4c6aa3df">getNumAmps</a></div><div class="ttdeci">long long int getNumAmps(Qureg qureg)</div><div class="ttdoc">Returns the number of complex amplitudes in a state-vector qureg.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00912">QuEST.c:912</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_ga2ecd67e0de9efcbbe37afbad28a8ffad"><div class="ttname"><a href="group__type.html#ga2ecd67e0de9efcbbe37afbad28a8ffad">initDiagonalOpFromPauliHamil</a></div><div class="ttdeci">void initDiagonalOpFromPauliHamil(DiagonalOp op, PauliHamil hamil)</div><div class="ttdoc">Populates the diagonal operator op to be equivalent to the given Pauli Hamiltonian hamil,...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01550">QuEST.c:1550</a></div></div>
<div class="ttc" id="astructQureg_html_acf78445e9435d09f44f0cc832c6aee79"><div class="ttname"><a href="structQureg.html#acf78445e9435d09f44f0cc832c6aee79">Qureg::isDensityMatrix</a></div><div class="ttdeci">int isDensityMatrix</div><div class="ttdoc">Whether this instance is a density-state representation.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00325">QuEST.h:325</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga4193c14cfb918fa3291fb0648058d63e"><div class="ttname"><a href="group__unitary.html#ga4193c14cfb918fa3291fb0648058d63e">pauliX</a></div><div class="ttdeci">void pauliX(Qureg qureg, int targetQubit)</div><div class="ttdoc">Apply the single-qubit Pauli-X (also known as the X, sigma-X, NOT or bit-flip) gate.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00432">QuEST.c:432</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="atest__decoherence_8cpp_html_ae828ab685c6e8b0cec317b7a6c46963a"><div class="ttname"><a href="test__decoherence_8cpp.html#ae828ab685c6e8b0cec317b7a6c46963a">PREPARE_TEST</a></div><div class="ttdeci">#define PREPARE_TEST(qureg, ref)</div><div class="ttdoc">Prepares a density matrix in the debug state, and the reference QMatrix.</div><div class="ttdef"><b>Definition:</b> <a href="test__decoherence_8cpp_source.html#l00009">test_decoherence.cpp:9</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__calc_html_ga50ee589fd5ceab52fdd70d0082352b41"><div class="ttname"><a href="group__calc.html#ga50ee589fd5ceab52fdd70d0082352b41">calcExpecPauliSum</a></div><div class="ttdeci">qreal calcExpecPauliSum(Qureg qureg, enum pauliOpType *allPauliCodes, qreal *termCoeffs, int numSumTerms, Qureg workspace)</div><div class="ttdoc">Computes the expected value of a sum of products of Pauli operators.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01210">QuEST.c:1210</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga3d89916b46bc4aaf23e938022e6c89c1"><div class="ttname"><a href="group__unitary.html#ga3d89916b46bc4aaf23e938022e6c89c1">controlledTwoQubitUnitary</a></div><div class="ttdeci">void controlledTwoQubitUnitary(Qureg qureg, int controlQubit, int targetQubit1, int targetQubit2, ComplexMatrix4 u)</div><div class="ttdoc">Apply a general controlled two-qubit unitary (including a global phase factor).</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00269">QuEST.c:269</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="astructPauliHamil_html_acb49fff0e3160ea1904c9ca34408b4e1"><div class="ttname"><a href="structPauliHamil.html#acb49fff0e3160ea1904c9ca34408b4e1">PauliHamil::numQubits</a></div><div class="ttdeci">int numQubits</div><div class="ttdoc">The number of qubits informing the Hilbert dimension of the Hamiltonian.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00287">QuEST.h:287</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="astructQureg_html_ad08dff5316b8937f4b2a1417591543dc"><div class="ttname"><a href="structQureg.html#ad08dff5316b8937f4b2a1417591543dc">Qureg::numQubitsRepresented</a></div><div class="ttdeci">int numQubitsRepresented</div><div class="ttdoc">The number of qubits represented in either the state-vector or density matrix.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00327">QuEST.h:327</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="astructQureg_html_adef4935cac95763c29164cf99b144ed4"><div class="ttname"><a href="structQureg.html#adef4935cac95763c29164cf99b144ed4">Qureg::numAmpsTotal</a></div><div class="ttdeci">long long int numAmpsTotal</div><div class="ttdoc">Total number of amplitudes, which are possibly distributed among machines.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00334">QuEST.h:334</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="astructComplex_html_ab5b2e2eca02131fc74b289a83636cbe3"><div class="ttname"><a href="structComplex.html#ab5b2e2eca02131fc74b289a83636cbe3">Complex::real</a></div><div class="ttdeci">qreal real</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00105">QuEST.h:105</a></div></div>
<div class="ttc" id="agroup__decoherence_html_ga97d563fa8f4bc51f720bbb653f5480b3"><div class="ttname"><a href="group__decoherence.html#ga97d563fa8f4bc51f720bbb653f5480b3">mixDensityMatrix</a></div><div class="ttdeci">void mixDensityMatrix(Qureg combineQureg, qreal otherProb, Qureg otherQureg)</div><div class="ttdoc">Modifies combineQureg to become (1-prob)combineProb + prob otherQureg.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01012">QuEST.c:1012</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__unitary_html_gac15907193da5a7c48b9610a26e669064"><div class="ttname"><a href="group__unitary.html#gac15907193da5a7c48b9610a26e669064">tGate</a></div><div class="ttdeci">void tGate(Qureg qureg, int targetQubit)</div><div class="ttdoc">Apply the single-qubit T gate.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00476">QuEST.c:476</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga3250d0d95b5d755cad542a6a2372b894"><div class="ttname"><a href="group__unitary.html#ga3250d0d95b5d755cad542a6a2372b894">multiRotateZ</a></div><div class="ttdeci">void multiRotateZ(Qureg qureg, int *qubits, int numQubits, qreal angle)</div><div class="ttdoc">Apply a multi-qubit Z rotation, also known as a phase gadget, on a selected number of qubits.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00652">QuEST.c:652</a></div></div>
<div class="ttc" id="astructComplex_html_a84f5439aad0ef495efdd3b4c1c02d27e"><div class="ttname"><a href="structComplex.html#a84f5439aad0ef495efdd3b4c1c02d27e">Complex::imag</a></div><div class="ttdeci">qreal imag</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00106">QuEST.h:106</a></div></div>
<div class="ttc" id="agroup__testutilities_html_gad2d2691472dbd81bc4b893160a560c50"><div class="ttname"><a href="group__testutilities.html#gad2d2691472dbd81bc4b893160a560c50">deleteFilesWithPrefixSynch</a></div><div class="ttdeci">void deleteFilesWithPrefixSynch(char *prefix)</div><div class="ttdoc">Deletes all files with filename starting with prefix.</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l01375">utilities.cpp:1375</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__testutilities_html_gac60cee26113732c491f21dc43066b605"><div class="ttname"><a href="group__testutilities.html#gac60cee26113732c491f21dc43066b605">getExponentialOfDiagonalMatrix</a></div><div class="ttdeci">QMatrix getExponentialOfDiagonalMatrix(QMatrix a)</div><div class="ttdoc">Returns the matrix exponential of a diagonal, square, complex matrix.</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l00197">utilities.cpp:197</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__decoherence_html_ga9a77f84e1aa7d25d036b14d7d0cd8b61"><div class="ttname"><a href="group__decoherence.html#ga9a77f84e1aa7d25d036b14d7d0cd8b61">mixPauli</a></div><div class="ttdeci">void mixPauli(Qureg qureg, int qubit, qreal probX, qreal probY, qreal probZ)</div><div class="ttdoc">Mixes a density matrix qureg to induce general single-qubit Pauli noise.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01303">QuEST.c:1303</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__unitary_html_ga6532decd6c404189915563492f090e6f"><div class="ttname"><a href="group__unitary.html#ga6532decd6c404189915563492f090e6f">hadamard</a></div><div class="ttdeci">void hadamard(Qureg qureg, int targetQubit)</div><div class="ttdoc">Apply the single-qubit Hadamard gate.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00176">QuEST.c:176</a></div></div>
<div class="ttc" id="astructComplex_html"><div class="ttname"><a href="structComplex.html">Complex</a></div><div class="ttdoc">Represents one complex number.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8h_source.html#l00103">QuEST.h:103</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__unitary_html_gab23a8b022ec83b9d423961ca87cd8cb5"><div class="ttname"><a href="group__unitary.html#gab23a8b022ec83b9d423961ca87cd8cb5">rotateZ</a></div><div class="ttdeci">void rotateZ(Qureg qureg, int targetQubit, qreal angle)</div><div class="ttdoc">Rotate a single qubit by a given angle around the Z-axis of the Bloch-sphere (also known as a phase s...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00209">QuEST.c:209</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__unitary_html_gaa700dc9657ade4cf16f1cad1624c5332"><div class="ttname"><a href="group__unitary.html#gaa700dc9657ade4cf16f1cad1624c5332">multiControlledUnitary</a></div><div class="ttdeci">void multiControlledUnitary(Qureg qureg, int *controlQubits, int numControlQubits, int targetQubit, ComplexMatrix2 u)</div><div class="ttdoc">Apply a general multiple-control single-target unitary, which can include a global phase factor.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00373">QuEST.c:373</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__init_html_ga2f049055d4a51d0ea4d1a43b5234dedb"><div class="ttname"><a href="group__init.html#ga2f049055d4a51d0ea4d1a43b5234dedb">initZeroState</a></div><div class="ttdeci">void initZeroState(Qureg qureg)</div><div class="ttdoc">Initialise qureg into the zero state.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00113">QuEST.c:113</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__calc_html_ga658b3a5cab5e73a17a7fd76a83583a22"><div class="ttname"><a href="group__calc.html#ga658b3a5cab5e73a17a7fd76a83583a22">calcDensityInnerProduct</a></div><div class="ttdeci">qreal calcDensityInnerProduct(Qureg rho1, Qureg rho2)</div><div class="ttdoc">Computes the Hilbert-Schmidt scalar product (which is equivalent to the Frobenius inner product of ma...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01158">QuEST.c:1158</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_ga2e09685323c6b2312a64daf8c74b12b5"><div class="ttname"><a href="group__testutilities.html#ga2e09685323c6b2312a64daf8c74b12b5">bitsets</a></div><div class="ttdeci">Catch::Generators::GeneratorWrapper< int * > bitsets(int numBits)</div><div class="ttdoc">Returns a Catch2 generator of every numBits-length bit-set, in increasing lexographic order,...</div><div class="ttdef"><b>Definition:</b> <a href="utilities_8cpp_source.html#l01557">utilities.cpp:1557</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="agroup__init_html_ga234bd34016f08288532791903b9884b5"><div class="ttname"><a href="group__init.html#ga234bd34016f08288532791903b9884b5">initPlusState</a></div><div class="ttdeci">void initPlusState(Qureg qureg)</div><div class="ttdoc">Initialise qureg into the plus state.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00125">QuEST.c:125</a></div></div>
<div class="ttc" id="agroup__calc_html_ga15cfad3f3d26339128e3be32ae7deacd"><div class="ttname"><a href="group__calc.html#ga15cfad3f3d26339128e3be32ae7deacd">calcExpecPauliProd</a></div><div class="ttdeci">qreal calcExpecPauliProd(Qureg qureg, int *targetQubits, enum pauliOpType *pauliCodes, int numTargets, Qureg workspace)</div><div class="ttdoc">Computes the expected value of a product of Pauli operators.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01201">QuEST.c:1201</a></div></div>
<div class="ttc" id="agroup__unitary_html_gaf7e15bf09c64082e0a8467998eb25623"><div class="ttname"><a href="group__unitary.html#gaf7e15bf09c64082e0a8467998eb25623">controlledCompactUnitary</a></div><div class="ttdeci">void controlledCompactUnitary(Qureg qureg, int controlQubit, int targetQubit, Complex alpha, Complex beta)</div><div class="ttdoc">Apply a controlled unitary (single control, single target) parameterised by two given complex scalars...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00417">QuEST.c:417</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga41b946a82982c3fa3dc2a7395665bc90"><div class="ttname"><a href="group__unitary.html#ga41b946a82982c3fa3dc2a7395665bc90">multiStateControlledUnitary</a></div><div class="ttdeci">void multiStateControlledUnitary(Qureg qureg, int *controlQubits, int *controlState, int numControlQubits, int targetQubit, ComplexMatrix2 u)</div><div class="ttdoc">Apply a general single-qubit unitary with multiple control qubits, conditioned upon a specific bit se...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00388">QuEST.c:388</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga75d5e65f87c68403602a669b9c6d52b0"><div class="ttname"><a href="group__unitary.html#ga75d5e65f87c68403602a669b9c6d52b0">sqrtSwapGate</a></div><div class="ttdeci">void sqrtSwapGate(Qureg qureg, int qb1, int qb2)</div><div class="ttdoc">Performs a sqrt SWAP gate between qubit1 and qubit2.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00639">QuEST.c:639</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__decoherence_html_ga65b4c0944090fae78a37ba3b94811ace"><div class="ttname"><a href="group__decoherence.html#ga65b4c0944090fae78a37ba3b94811ace">mixMultiQubitKrausMap</a></div><div class="ttdeci">void mixMultiQubitKrausMap(Qureg qureg, int *targets, int numTargets, ComplexMatrixN *ops, int numOps)</div><div class="ttdoc">Apply a general N-qubit Kraus map to a density matrix, as specified by at most (2N)^2 Kraus operators...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01334">QuEST.c:1334</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__unitary_html_gafbbded98b7233f5da06d74d1db5cbfdb"><div class="ttname"><a href="group__unitary.html#gafbbded98b7233f5da06d74d1db5cbfdb">controlledRotateY</a></div><div class="ttdeci">void controlledRotateY(Qureg qureg, int controlQubit, int targetQubit, qreal angle)</div><div class="ttdoc">Applies a controlled rotation by a given angle around the Y-axis of the Bloch-sphere.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00232">QuEST.c:232</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>
