<!-- 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.1.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: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: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: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: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: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: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: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: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: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: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: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: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="ga37d50a46caa1bdf003155dafc4426b73"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga37d50a46caa1bdf003155dafc4426b73">◆ </a></span>TEST_CASE() <span class="overload">[1/88]</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#l00015">15</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="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> 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="l00018"></a><span class="lineno"> 18</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="l00019"></a><span class="lineno"> 19</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="l00020"></a><span class="lineno"> 20</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="l00021"></a><span class="lineno"> 21</span>  </div>
<div class="line"><a name="l00022"></a><span class="lineno"> 22</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(vecIn);</div>
<div class="line"><a name="l00023"></a><span class="lineno"> 23</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(matIn);</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>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00026"></a><span class="lineno"> 26</span>  </div>
<div class="line"><a name="l00027"></a><span class="lineno"> 27</span>  <span class="keywordtype">int</span> numTerms = GENERATE( 1, 2, 10, 15);</div>
<div class="line"><a name="l00028"></a><span class="lineno"> 28</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="l00029"></a><span class="lineno"> 29</span>  </div>
<div class="line"><a name="l00030"></a><span class="lineno"> 30</span>  <span class="comment">// each test will use random coefficients</span></div>
<div class="line"><a name="l00031"></a><span class="lineno"> 31</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeffs[numTerms];</div>
<div class="line"><a name="l00032"></a><span class="lineno"> 32</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numTerms; i++)</div>
<div class="line"><a name="l00033"></a><span class="lineno"> 33</span>  coeffs[i] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5, 5);</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">/* it's too expensive to try ALL Pauli sequences, via </span></div>
<div class="line"><a name="l00036"></a><span class="lineno"> 36</span> <span class="comment"> * pauliOpType* paulis = GENERATE_COPY( pauliseqs(numPaulis) );.</span></div>
<div class="line"><a name="l00037"></a><span class="lineno"> 37</span> <span class="comment"> * Furthermore, take(10, pauliseqs(numTargs)) will try the same pauli codes.</span></div>
<div class="line"><a name="l00038"></a><span class="lineno"> 38</span> <span class="comment"> * Hence, we instead opt to repeatedly randomly generate pauliseqs</span></div>
<div class="line"><a name="l00039"></a><span class="lineno"> 39</span> <span class="comment"> */</span></div>
<div class="line"><a name="l00040"></a><span class="lineno"> 40</span>  GENERATE( range(0,10) ); <span class="comment">// gen 10 random pauli-codes</span></div>
<div class="line"><a name="l00041"></a><span class="lineno"> 41</span>  <a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a> paulis[numPaulis];</div>
<div class="line"><a name="l00042"></a><span class="lineno"> 42</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numPaulis; i++)</div>
<div class="line"><a name="l00043"></a><span class="lineno"> 43</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="l00044"></a><span class="lineno"> 44</span>  </div>
<div class="line"><a name="l00045"></a><span class="lineno"> 45</span>  <span class="comment">// build the resulting Pauli sum; sum_j coeffs[j] * paulis[n*j : (n+1)j]</span></div>
<div class="line"><a name="l00046"></a><span class="lineno"> 46</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> iMatr{{1,0},{0,1}};</div>
<div class="line"><a name="l00047"></a><span class="lineno"> 47</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> xMatr{{0,1},{1,0}};</div>
<div class="line"><a name="l00048"></a><span class="lineno"> 48</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> yMatr{{0,-1i},{1i,0}};</div>
<div class="line"><a name="l00049"></a><span class="lineno"> 49</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> zMatr{{1,0},{0,-1}};</div>
<div class="line"><a name="l00050"></a><span class="lineno"> 50</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> pauliSum = <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="l00051"></a><span class="lineno"> 51</span>  </div>
<div class="line"><a name="l00052"></a><span class="lineno"> 52</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> t=0; t<numTerms; t++) {</div>
<div class="line"><a name="l00053"></a><span class="lineno"> 53</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> pauliProd = <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a>{{1}};</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="keywordflow">for</span> (<span class="keywordtype">int</span> q=0; q<<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>; q++) {</div>
<div class="line"><a name="l00056"></a><span class="lineno"> 56</span>  <span class="keywordtype">int</span> i = q + t*<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>;</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__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> fac;</div>
<div class="line"><a name="l00059"></a><span class="lineno"> 59</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="l00060"></a><span class="lineno"> 60</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="l00061"></a><span class="lineno"> 61</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="l00062"></a><span class="lineno"> 62</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="l00063"></a><span class="lineno"> 63</span>  pauliProd = <a class="code" href="group__testutilities.html#ga50616e813b0d0aa4f8220785d780cdff">getKroneckerProduct</a>(fac, pauliProd);</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>  pauliSum += coeffs[t] * pauliProd;</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>  </div>
<div class="line"><a name="l00068"></a><span class="lineno"> 68</span>  SECTION( <span class="stringliteral">"state-vector"</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="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> vecRef = <a class="code" href="group__testutilities.html#gade0e7c37811a69f1c21c88c11943a19f">toQVector</a>(vecIn);</div>
<div class="line"><a name="l00071"></a><span class="lineno"> 71</span>  <a class="code" href="group__operator.html#ga6fc26cf857db070e12959e59ecfed8a6">applyPauliSum</a>(vecIn, paulis, coeffs, numTerms, vecOut);</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>  <span class="comment">// ensure vecIn barely changes under precision</span></div>
<div class="line"><a name="l00074"></a><span class="lineno"> 74</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vecIn, vecRef) );</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>  <span class="comment">// ensure vecOut changed correctly </span></div>
<div class="line"><a name="l00077"></a><span class="lineno"> 77</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vecOut, pauliSum * vecRef) );</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>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00080"></a><span class="lineno"> 80</span>  </div>
<div class="line"><a name="l00081"></a><span class="lineno"> 81</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="l00082"></a><span class="lineno"> 82</span>  <a class="code" href="group__operator.html#ga6fc26cf857db070e12959e59ecfed8a6">applyPauliSum</a>(matIn, paulis, coeffs, numTerms, matOut);</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">// ensure matIn barely changes under precision</span></div>
<div class="line"><a name="l00085"></a><span class="lineno"> 85</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(matIn, matRef) );</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>  <span class="comment">// ensure matOut changed correctly </span></div>
<div class="line"><a name="l00088"></a><span class="lineno"> 88</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(matOut, pauliSum * matRef, 1E2*REAL_EPS) );</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>  }</div>
<div class="line"><a name="l00091"></a><span class="lineno"> 91</span>  SECTION( <span class="stringliteral">"input validation"</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>  SECTION( <span class="stringliteral">"number of terms"</span> ) {</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>  <span class="keywordtype">int</span> numTerms = GENERATE( -1, 0 );</div>
<div class="line"><a name="l00096"></a><span class="lineno"> 96</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="l00097"></a><span class="lineno"> 97</span>  }</div>
<div class="line"><a name="l00098"></a><span class="lineno"> 98</span>  SECTION( <span class="stringliteral">"pauli codes"</span> ) {</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>  <span class="comment">// valid codes</span></div>
<div class="line"><a name="l00101"></a><span class="lineno"> 101</span>  <span class="keywordtype">int</span> numTerms = 3;</div>
<div class="line"><a name="l00102"></a><span class="lineno"> 102</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="l00103"></a><span class="lineno"> 103</span>  <a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a> paulis[numPaulis];</div>
<div class="line"><a name="l00104"></a><span class="lineno"> 104</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numPaulis; i++)</div>
<div class="line"><a name="l00105"></a><span class="lineno"> 105</span>  paulis[i] = <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a63800f45b01ccc2608f754aee850bf4a">PAULI_I</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>  <span class="comment">// make one invalid </span></div>
<div class="line"><a name="l00108"></a><span class="lineno"> 108</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="l00109"></a><span class="lineno"> 109</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="l00110"></a><span class="lineno"> 110</span>  }</div>
<div class="line"><a name="l00111"></a><span class="lineno"> 111</span>  SECTION( <span class="stringliteral">"qureg dimensions"</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="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="l00114"></a><span class="lineno"> 114</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="l00115"></a><span class="lineno"> 115</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="l00116"></a><span class="lineno"> 116</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="l00117"></a><span class="lineno"> 117</span>  }</div>
<div class="line"><a name="l00118"></a><span class="lineno"> 118</span>  SECTION( <span class="stringliteral">"qureg types"</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__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a> paulis[<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>];</div>
<div class="line"><a name="l00121"></a><span class="lineno"> 121</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="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>(vecIn, <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>(vecOut, <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="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(matIn, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00127"></a><span class="lineno"> 127</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="l00128"></a><span class="lineno"> 128</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l00806">applyPauliSum()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00048">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00169">getKroneckerProduct()</a>, <a class="el" href="utilities_8cpp_source.html#l00481">getRandomInt()</a>, <a class="el" href="utilities_8cpp_source.html#l00410">getRandomReal()</a>, <a class="el" href="utilities_8cpp_source.html#l00143">getZeroMatrix()</a>, <a class="el" href="QuEST_8c_source.html#l01057">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#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, <a class="el" href="utilities_8cpp_source.html#l00835">toQMatrix()</a>, and <a class="el" href="utilities_8cpp_source.html#l00904">toQVector()</a>.</p>
</div>
</div>
<a id="ga4f3c9ca42b9b7cd322f1b89ba2350a81"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga4f3c9ca42b9b7cd322f1b89ba2350a81">◆ </a></span>TEST_CASE() <span class="overload">[2/88]</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#l00015">15</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="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> 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="l00018"></a><span class="lineno"> 18</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="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="comment">// repeat these random tests 10 times </span></div>
<div class="line"><a name="l00023"></a><span class="lineno"> 23</span>  GENERATE( range(0,10) );</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>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l00026"></a><span class="lineno"> 26</span>  </div>
<div class="line"><a name="l00027"></a><span class="lineno"> 27</span>  SECTION( <span class="stringliteral">"pure"</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="comment">// mat1 = |r1><r1|</span></div>
<div class="line"><a name="l00030"></a><span class="lineno"> 30</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="l00031"></a><span class="lineno"> 31</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="l00032"></a><span class="lineno"> 32</span>  </div>
<div class="line"><a name="l00033"></a><span class="lineno"> 33</span>  <span class="comment">// mat2 = |r2><r2|</span></div>
<div class="line"><a name="l00034"></a><span class="lineno"> 34</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="l00035"></a><span class="lineno"> 35</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="l00036"></a><span class="lineno"> 36</span>  </div>
<div class="line"><a name="l00037"></a><span class="lineno"> 37</span>  <span class="comment">// prod( |r1><r1|, |r2><r2| ) = |<r1|r2>|^2 </span></div>
<div class="line"><a name="l00038"></a><span class="lineno"> 38</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> prod = 0;</div>
<div class="line"><a name="l00039"></a><span class="lineno"> 39</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<r1.size(); i++)</div>
<div class="line"><a name="l00040"></a><span class="lineno"> 40</span>  prod += conj(r1[i]) * r2[i];</div>
<div class="line"><a name="l00041"></a><span class="lineno"> 41</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> densProd = pow(abs(prod),2);</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>  REQUIRE( <a class="code" href="group__calc.html#ga658b3a5cab5e73a17a7fd76a83583a22">calcDensityInnerProduct</a>(mat1,mat2) == Approx(densProd) );</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>  SECTION( <span class="stringliteral">"mixed"</span> ) {</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__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="l00048"></a><span class="lineno"> 48</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="l00049"></a><span class="lineno"> 49</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat1, ref1);</div>
<div class="line"><a name="l00050"></a><span class="lineno"> 50</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat2, ref2);</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>  <span class="comment">// prod(mat1, mat2) = sum_{ij} conj(mat1_{ij}) * mat2_{ij}</span></div>
<div class="line"><a name="l00053"></a><span class="lineno"> 53</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> refProd = 0;</div>
<div class="line"><a name="l00054"></a><span class="lineno"> 54</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<ref1.size(); i++)</div>
<div class="line"><a name="l00055"></a><span class="lineno"> 55</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> j=0; j<ref1.size(); j++)</div>
<div class="line"><a name="l00056"></a><span class="lineno"> 56</span>  refProd += conj(ref1[i][j]) * ref2[i][j];</div>
<div class="line"><a name="l00057"></a><span class="lineno"> 57</span>  REQUIRE( imag(refProd) == Approx(0).margin(REAL_EPS) );</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>  REQUIRE( <a class="code" href="group__calc.html#ga658b3a5cab5e73a17a7fd76a83583a22">calcDensityInnerProduct</a>(mat1,mat2) == Approx(real(refProd)) );</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">// should be invariant under ordering</span></div>
<div class="line"><a name="l00062"></a><span class="lineno"> 62</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="l00063"></a><span class="lineno"> 63</span>  }</div>
<div class="line"><a name="l00064"></a><span class="lineno"> 64</span>  SECTION( <span class="stringliteral">"unnormalised"</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>  <span class="comment">// set both to random (non-Hermitian) complex matrices</span></div>
<div class="line"><a name="l00067"></a><span class="lineno"> 67</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="l00068"></a><span class="lineno"> 68</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="l00069"></a><span class="lineno"> 69</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat1, ref1);</div>
<div class="line"><a name="l00070"></a><span class="lineno"> 70</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat2, ref2);</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">// prod(mat1, mat2) = real(sum_{ij} conj(mat1_{ij}) * mat2_{ij})</span></div>
<div class="line"><a name="l00073"></a><span class="lineno"> 73</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> refProd = 0;</div>
<div class="line"><a name="l00074"></a><span class="lineno"> 74</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<ref1.size(); i++)</div>
<div class="line"><a name="l00075"></a><span class="lineno"> 75</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> j=0; j<ref1.size(); j++)</div>
<div class="line"><a name="l00076"></a><span class="lineno"> 76</span>  refProd += conj(ref1[i][j]) * ref2[i][j];</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>  REQUIRE( <a class="code" href="group__calc.html#ga658b3a5cab5e73a17a7fd76a83583a22">calcDensityInnerProduct</a>(mat1,mat2) == Approx(real(refProd)) );</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>  }</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">"input validation"</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>  SECTION( <span class="stringliteral">"dimensions"</span> ) {</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>  <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="l00087"></a><span class="lineno"> 87</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="l00088"></a><span class="lineno"> 88</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="l00089"></a><span class="lineno"> 89</span>  }</div>
<div class="line"><a name="l00090"></a><span class="lineno"> 90</span>  SECTION( <span class="stringliteral">"state-vectors"</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>  </div>
<div class="line"><a name="l00094"></a><span class="lineno"> 94</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="l00095"></a><span class="lineno"> 95</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="l00096"></a><span class="lineno"> 96</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="l00097"></a><span class="lineno"> 97</span>  </div>
<div class="line"><a name="l00098"></a><span class="lineno"> 98</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="l00099"></a><span class="lineno"> 99</span>  }</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#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(mat1, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00102"></a><span class="lineno"> 102</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="l00103"></a><span class="lineno"> 103</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l00837">calcDensityInnerProduct()</a>, <a class="el" href="QuEST_8c_source.html#l00048">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00159">getKetBra()</a>, <a class="el" href="utilities_8cpp_source.html#l00457">getRandomDensityMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00368">getRandomQMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00453">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#l00946">toQureg()</a>.</p>
</div>
</div>
<a id="ga8825124816954c15598897e157f6e048"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga8825124816954c15598897e157f6e048">◆ </a></span>TEST_CASE() <span class="overload">[3/88]</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#l00111">111</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="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>  <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="l00114"></a><span class="lineno"> 114</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="l00115"></a><span class="lineno"> 115</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(vec);</div>
<div class="line"><a name="l00116"></a><span class="lineno"> 116</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(mat);</div>
<div class="line"><a name="l00117"></a><span class="lineno"> 117</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="l00118"></a><span class="lineno"> 118</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="l00119"></a><span class="lineno"> 119</span>  </div>
<div class="line"><a name="l00120"></a><span class="lineno"> 120</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="l00121"></a><span class="lineno"> 121</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="l00122"></a><span class="lineno"> 122</span>  </div>
<div class="line"><a name="l00123"></a><span class="lineno"> 123</span>  SECTION( <span class="stringliteral">"correctness"</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>  <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="l00126"></a><span class="lineno"> 126</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="l00127"></a><span class="lineno"> 127</span>  </div>
<div class="line"><a name="l00128"></a><span class="lineno"> 128</span>  <span class="comment">/* it's too expensive to try ALL Pauli sequences, via </span></div>
<div class="line"><a name="l00129"></a><span class="lineno"> 129</span> <span class="comment"> * pauliOpType* paulis = GENERATE_COPY( pauliseqs(numTargs) );.</span></div>
<div class="line"><a name="l00130"></a><span class="lineno"> 130</span> <span class="comment"> * Furthermore, take(10, pauliseqs(numTargs)) will try the same pauli codes.</span></div>
<div class="line"><a name="l00131"></a><span class="lineno"> 131</span> <span class="comment"> * Hence, we instead opt to repeatedlyrandomly generate pauliseqs</span></div>
<div class="line"><a name="l00132"></a><span class="lineno"> 132</span> <span class="comment"> */</span></div>
<div class="line"><a name="l00133"></a><span class="lineno"> 133</span>  GENERATE( range(0,10) ); <span class="comment">// gen 10 random pauli-codes for every targs</span></div>
<div class="line"><a name="l00134"></a><span class="lineno"> 134</span>  <a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a> paulis[numTargs];</div>
<div class="line"><a name="l00135"></a><span class="lineno"> 135</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numTargs; i++)</div>
<div class="line"><a name="l00136"></a><span class="lineno"> 136</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="l00137"></a><span class="lineno"> 137</span>  </div>
<div class="line"><a name="l00138"></a><span class="lineno"> 138</span>  <span class="comment">// produce a numTargs-big matrix 'pauliProd' by pauli-matrix tensoring</span></div>
<div class="line"><a name="l00139"></a><span class="lineno"> 139</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> iMatr{{1,0},{0,1}};</div>
<div class="line"><a name="l00140"></a><span class="lineno"> 140</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> xMatr{{0,1},{1,0}};</div>
<div class="line"><a name="l00141"></a><span class="lineno"> 141</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> yMatr{{0,-1i},{1i,0}};</div>
<div class="line"><a name="l00142"></a><span class="lineno"> 142</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> zMatr{{1,0},{0,-1}};</div>
<div class="line"><a name="l00143"></a><span class="lineno"> 143</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> pauliProd{{1}};</div>
<div class="line"><a name="l00144"></a><span class="lineno"> 144</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numTargs; i++) {</div>
<div class="line"><a name="l00145"></a><span class="lineno"> 145</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> fac;</div>
<div class="line"><a name="l00146"></a><span class="lineno"> 146</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="l00147"></a><span class="lineno"> 147</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="l00148"></a><span class="lineno"> 148</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="l00149"></a><span class="lineno"> 149</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="l00150"></a><span class="lineno"> 150</span>  pauliProd = <a class="code" href="group__testutilities.html#ga50616e813b0d0aa4f8220785d780cdff">getKroneckerProduct</a>(fac, pauliProd);</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>  </div>
<div class="line"><a name="l00153"></a><span class="lineno"> 153</span>  SECTION( <span class="stringliteral">"state-vector"</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="comment">/* calcExpecPauliProd calculates <qureg|pauliProd|qureg> */</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="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> prodRef = vecRef; </div>
<div class="line"><a name="l00158"></a><span class="lineno"> 158</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(prodRef, targs, numTargs, pauliProd);</div>
<div class="line"><a name="l00159"></a><span class="lineno"> 159</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> prod = 0;</div>
<div class="line"><a name="l00160"></a><span class="lineno"> 160</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<vecRef.size(); i++)</div>
<div class="line"><a name="l00161"></a><span class="lineno"> 161</span>  prod += conj(vecRef[i]) * prodRef[i];</div>
<div class="line"><a name="l00162"></a><span class="lineno"> 162</span>  REQUIRE( imag(prod) == Approx(0).margin(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>  <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="l00165"></a><span class="lineno"> 165</span>  REQUIRE( res == Approx(real(prod)).margin(REAL_EPS) );</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">"density matrix"</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>  <span class="comment">/* calcExpecPauliProd calculates Trace( pauliProd * qureg ) */</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>  <span class="comment">// produce (pauliProd * mat)</span></div>
<div class="line"><a name="l00172"></a><span class="lineno"> 172</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="l00173"></a><span class="lineno"> 173</span>  matRef = fullOp * matRef;</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">// compute real(trace(pauliProd * mat))</span></div>
<div class="line"><a name="l00176"></a><span class="lineno"> 176</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> tr = 0;</div>
<div class="line"><a name="l00177"></a><span class="lineno"> 177</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<matRef.size(); i++)</div>
<div class="line"><a name="l00178"></a><span class="lineno"> 178</span>  tr += real(matRef[i][i]);</div>
<div class="line"><a name="l00179"></a><span class="lineno"> 179</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="l00180"></a><span class="lineno"> 180</span>  </div>
<div class="line"><a name="l00181"></a><span class="lineno"> 181</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="l00182"></a><span class="lineno"> 182</span>  REQUIRE( res == Approx(tr).margin(10*REAL_EPS) );</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>  }</div>
<div class="line"><a name="l00185"></a><span class="lineno"> 185</span>  SECTION( <span class="stringliteral">"validation"</span> ) {</div>
<div class="line"><a name="l00186"></a><span class="lineno"> 186</span>  </div>
<div class="line"><a name="l00187"></a><span class="lineno"> 187</span>  SECTION( <span class="stringliteral">"number of targets"</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>  <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="l00190"></a><span class="lineno"> 190</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="l00191"></a><span class="lineno"> 191</span>  }</div>
<div class="line"><a name="l00192"></a><span class="lineno"> 192</span>  SECTION( <span class="stringliteral">"target indices"</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="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l00195"></a><span class="lineno"> 195</span>  <span class="keywordtype">int</span> targs[3] = {0, 1, 2};</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>  <span class="comment">// make one index wrong</span></div>
<div class="line"><a name="l00198"></a><span class="lineno"> 198</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="l00199"></a><span class="lineno"> 199</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="l00200"></a><span class="lineno"> 200</span>  }</div>
<div class="line"><a name="l00201"></a><span class="lineno"> 201</span>  SECTION( <span class="stringliteral">"repetition in targets"</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="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l00204"></a><span class="lineno"> 204</span>  <span class="keywordtype">int</span> targs[3] = {0, 1, 1};</div>
<div class="line"><a name="l00205"></a><span class="lineno"> 205</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="l00206"></a><span class="lineno"> 206</span>  }</div>
<div class="line"><a name="l00207"></a><span class="lineno"> 207</span>  SECTION( <span class="stringliteral">"pauli codes"</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>  <span class="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l00210"></a><span class="lineno"> 210</span>  <span class="keywordtype">int</span> targs[3] = {0, 1, 2};</div>
<div class="line"><a name="l00211"></a><span class="lineno"> 211</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="l00212"></a><span class="lineno"> 212</span>  </div>
<div class="line"><a name="l00213"></a><span class="lineno"> 213</span>  <span class="comment">// make one pauli wrong</span></div>
<div class="line"><a name="l00214"></a><span class="lineno"> 214</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="l00215"></a><span class="lineno"> 215</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="l00216"></a><span class="lineno"> 216</span>  }</div>
<div class="line"><a name="l00217"></a><span class="lineno"> 217</span>  SECTION( <span class="stringliteral">"workspace type"</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>  <span class="keywordtype">int</span> numTargs = 1;</div>
<div class="line"><a name="l00220"></a><span class="lineno"> 220</span>  <span class="keywordtype">int</span> targs[1] = {0};</div>
<div class="line"><a name="l00221"></a><span class="lineno"> 221</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="l00222"></a><span class="lineno"> 222</span>  </div>
<div class="line"><a name="l00223"></a><span class="lineno"> 223</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="l00224"></a><span class="lineno"> 224</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="l00225"></a><span class="lineno"> 225</span>  }</div>
<div class="line"><a name="l00226"></a><span class="lineno"> 226</span>  SECTION( <span class="stringliteral">"workspace dimensions"</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="keywordtype">int</span> numTargs = 1;</div>
<div class="line"><a name="l00229"></a><span class="lineno"> 229</span>  <span class="keywordtype">int</span> targs[1] = {0};</div>
<div class="line"><a name="l00230"></a><span class="lineno"> 230</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="l00231"></a><span class="lineno"> 231</span>  </div>
<div class="line"><a name="l00232"></a><span class="lineno"> 232</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="l00233"></a><span class="lineno"> 233</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="l00234"></a><span class="lineno"> 234</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="l00235"></a><span class="lineno"> 235</span>  </div>
<div class="line"><a name="l00236"></a><span class="lineno"> 236</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="l00237"></a><span class="lineno"> 237</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="l00238"></a><span class="lineno"> 238</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="l00239"></a><span class="lineno"> 239</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>  <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="l00242"></a><span class="lineno"> 242</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="l00243"></a><span class="lineno"> 243</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="l00244"></a><span class="lineno"> 244</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="l00245"></a><span class="lineno"> 245</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00573">applyReferenceOp()</a>, <a class="el" href="QuEST_8c_source.html#l00871">calcExpecPauliProd()</a>, <a class="el" href="QuEST_8c_source.html#l00048">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00293">getFullOperatorMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00169">getKroneckerProduct()</a>, <a class="el" href="utilities_8cpp_source.html#l00481">getRandomInt()</a>, <a class="el" href="QuEST_8c_source.html#l01057">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#l01074">sublists()</a>, <a class="el" href="utilities_8cpp_source.html#l00835">toQMatrix()</a>, and <a class="el" href="utilities_8cpp_source.html#l00904">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">[4/88]</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#l00253">253</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="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="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="l00256"></a><span class="lineno"> 256</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="l00257"></a><span class="lineno"> 257</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(vec);</div>
<div class="line"><a name="l00258"></a><span class="lineno"> 258</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(mat);</div>
<div class="line"><a name="l00259"></a><span class="lineno"> 259</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="l00260"></a><span class="lineno"> 260</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="l00261"></a><span class="lineno"> 261</span>  </div>
<div class="line"><a name="l00262"></a><span class="lineno"> 262</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="l00263"></a><span class="lineno"> 263</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="l00264"></a><span class="lineno"> 264</span>  </div>
<div class="line"><a name="l00265"></a><span class="lineno"> 265</span>  SECTION( <span class="stringliteral">"correctness"</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>  <span class="keywordtype">int</span> numSumTerms = GENERATE( 1, 2, 10, 15 );</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">/* it's too expensive to try every possible Pauli configuration, so</span></div>
<div class="line"><a name="l00270"></a><span class="lineno"> 270</span> <span class="comment"> * we'll try 10 random codes, and for each, random coefficients</span></div>
<div class="line"><a name="l00271"></a><span class="lineno"> 271</span> <span class="comment"> */</span></div>
<div class="line"><a name="l00272"></a><span class="lineno"> 272</span>  GENERATE( range(0,10) );</div>
<div class="line"><a name="l00273"></a><span class="lineno"> 273</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="l00274"></a><span class="lineno"> 274</span>  <a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a> paulis[totNumCodes];</div>
<div class="line"><a name="l00275"></a><span class="lineno"> 275</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<totNumCodes; i++)</div>
<div class="line"><a name="l00276"></a><span class="lineno"> 276</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="l00277"></a><span class="lineno"> 277</span>  </div>
<div class="line"><a name="l00278"></a><span class="lineno"> 278</span>  <span class="comment">// for every above param configuration, try random coefficients</span></div>
<div class="line"><a name="l00279"></a><span class="lineno"> 279</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeffs[numSumTerms];</div>
<div class="line"><a name="l00280"></a><span class="lineno"> 280</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numSumTerms; i++)</div>
<div class="line"><a name="l00281"></a><span class="lineno"> 281</span>  coeffs[i] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5, 5);</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">// produce a numTargs-big matrix 'pauliSum' by pauli-matrix tensoring and summing</span></div>
<div class="line"><a name="l00284"></a><span class="lineno"> 284</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> iMatr{{1,0},{0,1}};</div>
<div class="line"><a name="l00285"></a><span class="lineno"> 285</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> xMatr{{0,1},{1,0}};</div>
<div class="line"><a name="l00286"></a><span class="lineno"> 286</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> yMatr{{0,-1i},{1i,0}};</div>
<div class="line"><a name="l00287"></a><span class="lineno"> 287</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> zMatr{{1,0},{0,-1}};</div>
<div class="line"><a name="l00288"></a><span class="lineno"> 288</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> pauliSum = <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="l00289"></a><span class="lineno"> 289</span>  </div>
<div class="line"><a name="l00290"></a><span class="lineno"> 290</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> t=0; t<numSumTerms; t++) {</div>
<div class="line"><a name="l00291"></a><span class="lineno"> 291</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> pauliProd = <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a>{{1}};</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="keywordflow">for</span> (<span class="keywordtype">int</span> q=0; q<<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>; q++) {</div>
<div class="line"><a name="l00294"></a><span class="lineno"> 294</span>  <span class="keywordtype">int</span> i = q + t*<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>;</div>
<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>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> fac;</div>
<div class="line"><a name="l00297"></a><span class="lineno"> 297</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="l00298"></a><span class="lineno"> 298</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="l00299"></a><span class="lineno"> 299</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="l00300"></a><span class="lineno"> 300</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="l00301"></a><span class="lineno"> 301</span>  pauliProd = <a class="code" href="group__testutilities.html#ga50616e813b0d0aa4f8220785d780cdff">getKroneckerProduct</a>(fac, pauliProd);</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>  pauliSum += coeffs[t] * pauliProd;</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>  <span class="comment">/* calcExpecPauliSum calculates <qureg|pauliSum|qureg> */</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="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> sumRef = pauliSum * vecRef;</div>
<div class="line"><a name="l00310"></a><span class="lineno"> 310</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> prod = 0;</div>
<div class="line"><a name="l00311"></a><span class="lineno"> 311</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<vecRef.size(); i++)</div>
<div class="line"><a name="l00312"></a><span class="lineno"> 312</span>  prod += conj(vecRef[i]) * sumRef[i];</div>
<div class="line"><a name="l00313"></a><span class="lineno"> 313</span>  REQUIRE( imag(prod) == Approx(0).margin(10*REAL_EPS) );</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>  <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="l00316"></a><span class="lineno"> 316</span>  REQUIRE( res == Approx(real(prod)).margin(10*REAL_EPS) );</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">"density matrix"</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>  <span class="comment">/* calcExpecPauliSum calculates Trace( pauliSum * qureg ) */</span></div>
<div class="line"><a name="l00321"></a><span class="lineno"> 321</span>  matRef = pauliSum * matRef; </div>
<div class="line"><a name="l00322"></a><span class="lineno"> 322</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> tr = 0;</div>
<div class="line"><a name="l00323"></a><span class="lineno"> 323</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<matRef.size(); i++)</div>
<div class="line"><a name="l00324"></a><span class="lineno"> 324</span>  tr += real(matRef[i][i]);</div>
<div class="line"><a name="l00325"></a><span class="lineno"> 325</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="l00326"></a><span class="lineno"> 326</span>  </div>
<div class="line"><a name="l00327"></a><span class="lineno"> 327</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="l00328"></a><span class="lineno"> 328</span>  REQUIRE( res == Approx(tr).margin(1E2*REAL_EPS) );</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>  }</div>
<div class="line"><a name="l00331"></a><span class="lineno"> 331</span>  SECTION( <span class="stringliteral">"validation"</span> ) {</div>
<div class="line"><a name="l00332"></a><span class="lineno"> 332</span>  </div>
<div class="line"><a name="l00333"></a><span class="lineno"> 333</span>  SECTION( <span class="stringliteral">"number of sum terms"</span> ) {</div>
<div class="line"><a name="l00334"></a><span class="lineno"> 334</span>  </div>
<div class="line"><a name="l00335"></a><span class="lineno"> 335</span>  <span class="keywordtype">int</span> numSumTerms = GENERATE( -1, 0 );</div>
<div class="line"><a name="l00336"></a><span class="lineno"> 336</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="l00337"></a><span class="lineno"> 337</span>  }</div>
<div class="line"><a name="l00338"></a><span class="lineno"> 338</span>  SECTION( <span class="stringliteral">"pauli codes"</span> ) {</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 params</span></div>
<div class="line"><a name="l00341"></a><span class="lineno"> 341</span>  <span class="keywordtype">int</span> numSumTerms = 3;</div>
<div class="line"><a name="l00342"></a><span class="lineno"> 342</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeffs[numSumTerms];</div>
<div class="line"><a name="l00343"></a><span class="lineno"> 343</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="l00344"></a><span class="lineno"> 344</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="l00345"></a><span class="lineno"> 345</span>  codes[i] = <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a63800f45b01ccc2608f754aee850bf4a">PAULI_I</a>;</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>  <span class="comment">// make one pauli wrong</span></div>
<div class="line"><a name="l00348"></a><span class="lineno"> 348</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="l00349"></a><span class="lineno"> 349</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="l00350"></a><span class="lineno"> 350</span>  }</div>
<div class="line"><a name="l00351"></a><span class="lineno"> 351</span>  SECTION( <span class="stringliteral">"workspace type"</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>  <span class="comment">// make valid params</span></div>
<div class="line"><a name="l00354"></a><span class="lineno"> 354</span>  <span class="keywordtype">int</span> numSumTerms = 1;</div>
<div class="line"><a name="l00355"></a><span class="lineno"> 355</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeffs[1] = {0};</div>
<div class="line"><a name="l00356"></a><span class="lineno"> 356</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="l00357"></a><span class="lineno"> 357</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="l00358"></a><span class="lineno"> 358</span>  codes[i] = <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a63800f45b01ccc2608f754aee850bf4a">PAULI_I</a>;</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>  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="l00361"></a><span class="lineno"> 361</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="l00362"></a><span class="lineno"> 362</span>  }</div>
<div class="line"><a name="l00363"></a><span class="lineno"> 363</span>  SECTION( <span class="stringliteral">"workspace dimensions"</span> ) {</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>  <span class="comment">// make valid params</span></div>
<div class="line"><a name="l00366"></a><span class="lineno"> 366</span>  <span class="keywordtype">int</span> numSumTerms = 1;</div>
<div class="line"><a name="l00367"></a><span class="lineno"> 367</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> coeffs[1] = {0};</div>
<div class="line"><a name="l00368"></a><span class="lineno"> 368</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="l00369"></a><span class="lineno"> 369</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="l00370"></a><span class="lineno"> 370</span>  codes[i] = <a class="code" href="group__type.html#gga1c703cf89629e4e9c7023cd402d67028a63800f45b01ccc2608f754aee850bf4a">PAULI_I</a>;</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="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="l00373"></a><span class="lineno"> 373</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="l00374"></a><span class="lineno"> 374</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="l00375"></a><span class="lineno"> 375</span>  </div>
<div class="line"><a name="l00376"></a><span class="lineno"> 376</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="l00377"></a><span class="lineno"> 377</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="l00378"></a><span class="lineno"> 378</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="l00379"></a><span class="lineno"> 379</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>  <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="l00382"></a><span class="lineno"> 382</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="l00383"></a><span class="lineno"> 383</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="l00384"></a><span class="lineno"> 384</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="l00385"></a><span class="lineno"> 385</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l00880">calcExpecPauliSum()</a>, <a class="el" href="QuEST_8c_source.html#l00048">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00169">getKroneckerProduct()</a>, <a class="el" href="utilities_8cpp_source.html#l00481">getRandomInt()</a>, <a class="el" href="utilities_8cpp_source.html#l00410">getRandomReal()</a>, <a class="el" href="utilities_8cpp_source.html#l00143">getZeroMatrix()</a>, <a class="el" href="QuEST_8c_source.html#l01057">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#l00835">toQMatrix()</a>, and <a class="el" href="utilities_8cpp_source.html#l00904">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">[5/88]</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 statevector or density matrix) against a reference pure state (ne...">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#l00393">393</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="l00393"></a><span class="lineno"> 393</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>  <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="l00396"></a><span class="lineno"> 396</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="l00397"></a><span class="lineno"> 397</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="l00398"></a><span class="lineno"> 398</span>  </div>
<div class="line"><a name="l00399"></a><span class="lineno"> 399</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00400"></a><span class="lineno"> 400</span>  </div>
<div class="line"><a name="l00401"></a><span class="lineno"> 401</span>  <span class="comment">// repeat the below random tests 10 times </span></div>
<div class="line"><a name="l00402"></a><span class="lineno"> 402</span>  GENERATE( range(0,10) );</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>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00405"></a><span class="lineno"> 405</span>  </div>
<div class="line"><a name="l00406"></a><span class="lineno"> 406</span>  <span class="comment">/* calcFidelity computes |<vec|pure>|^2 */</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">"normalised"</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">// random L2 vectors</span></div>
<div class="line"><a name="l00411"></a><span class="lineno"> 411</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="l00412"></a><span class="lineno"> 412</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="l00413"></a><span class="lineno"> 413</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(vec, vecRef);</div>
<div class="line"><a name="l00414"></a><span class="lineno"> 414</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(pure, pureRef);</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">// |<vec|vec>|^2 = |1|^2 = 1</span></div>
<div class="line"><a name="l00417"></a><span class="lineno"> 417</span>  REQUIRE( <a class="code" href="group__calc.html#gaa266ed6c8ae5d0d0f49e1ac50819cffc">calcFidelity</a>(vec,vec) == Approx(1) );</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="comment">// |<vec|pure>|^2 = |sum_j conj(vec_j) * pure_j|^2</span></div>
<div class="line"><a name="l00420"></a><span class="lineno"> 420</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> dotProd = 0;</div>
<div class="line"><a name="l00421"></a><span class="lineno"> 421</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<vecRef.size(); i++)</div>
<div class="line"><a name="l00422"></a><span class="lineno"> 422</span>  dotProd += conj(vecRef[i]) * pureRef[i];</div>
<div class="line"><a name="l00423"></a><span class="lineno"> 423</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> refFid = pow(abs(dotProd), 2);</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>  REQUIRE( <a class="code" href="group__calc.html#gaa266ed6c8ae5d0d0f49e1ac50819cffc">calcFidelity</a>(vec,pure) == Approx(refFid) );</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>  SECTION( <span class="stringliteral">"unnormalised"</span> ) {</div>
<div class="line"><a name="l00428"></a><span class="lineno"> 428</span>  </div>
<div class="line"><a name="l00429"></a><span class="lineno"> 429</span>  <span class="comment">// random unnormalised vectors</span></div>
<div class="line"><a name="l00430"></a><span class="lineno"> 430</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="l00431"></a><span class="lineno"> 431</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="l00432"></a><span class="lineno"> 432</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(vec, vecRef);</div>
<div class="line"><a name="l00433"></a><span class="lineno"> 433</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(pure, pureRef);</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>  <span class="comment">// Let nv be magnitude of vec, hence |unit-vec> = 1/sqrt(nv)|vec></span></div>
<div class="line"><a name="l00436"></a><span class="lineno"> 436</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> nv = 0;</div>
<div class="line"><a name="l00437"></a><span class="lineno"> 437</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<vecRef.size(); i++)</div>
<div class="line"><a name="l00438"></a><span class="lineno"> 438</span>  nv += pow(abs(vecRef[i]), 2);</div>
<div class="line"><a name="l00439"></a><span class="lineno"> 439</span>  <span class="comment">// then <vec|vec> = sqrt(nv)*sqrt(nv) <unit-vec|unit-vec> = nv,</span></div>
<div class="line"><a name="l00440"></a><span class="lineno"> 440</span>  <span class="comment">// hence |<vec|vec>|^2 = nv*nv</span></div>
<div class="line"><a name="l00441"></a><span class="lineno"> 441</span>  REQUIRE( <a class="code" href="group__calc.html#gaa266ed6c8ae5d0d0f49e1ac50819cffc">calcFidelity</a>(vec,vec) == Approx( nv*nv ) );</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>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> dotProd = 0;</div>
<div class="line"><a name="l00444"></a><span class="lineno"> 444</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<vecRef.size(); i++)</div>
<div class="line"><a name="l00445"></a><span class="lineno"> 445</span>  dotProd += conj(vecRef[i]) * pureRef[i];</div>
<div class="line"><a name="l00446"></a><span class="lineno"> 446</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> refFid = pow(abs(dotProd), 2);</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>  REQUIRE( <a class="code" href="group__calc.html#gaa266ed6c8ae5d0d0f49e1ac50819cffc">calcFidelity</a>(vec,pure) == Approx(refFid) ); </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>  }</div>
<div class="line"><a name="l00451"></a><span class="lineno"> 451</span>  SECTION( <span class="stringliteral">"density-matrix"</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>  <span class="comment">/* calcFidelity computes <pure|mat|pure> */</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>  SECTION( <span class="stringliteral">"pure"</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>  <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="l00458"></a><span class="lineno"> 458</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(pure, pureRef);</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">// test when density matrix is the same pure state </span></div>
<div class="line"><a name="l00461"></a><span class="lineno"> 461</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="l00462"></a><span class="lineno"> 462</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat, matRef);</div>
<div class="line"><a name="l00463"></a><span class="lineno"> 463</span>  REQUIRE( <a class="code" href="group__calc.html#gaa266ed6c8ae5d0d0f49e1ac50819cffc">calcFidelity</a>(mat,pure) == Approx(1) ); </div>
<div class="line"><a name="l00464"></a><span class="lineno"> 464</span>  </div>
<div class="line"><a name="l00465"></a><span class="lineno"> 465</span>  <span class="comment">// test when density matrix is a random pure state</span></div>
<div class="line"><a name="l00466"></a><span class="lineno"> 466</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="l00467"></a><span class="lineno"> 467</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="l00468"></a><span class="lineno"> 468</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat, matRef);</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>  <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="l00471"></a><span class="lineno"> 471</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> dotProd = 0;</div>
<div class="line"><a name="l00472"></a><span class="lineno"> 472</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<r1.size(); i++)</div>
<div class="line"><a name="l00473"></a><span class="lineno"> 473</span>  dotProd += conj(r1[i]) * pureRef[i];</div>
<div class="line"><a name="l00474"></a><span class="lineno"> 474</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> refFid = pow(abs(dotProd), 2);</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>  REQUIRE( <a class="code" href="group__calc.html#gaa266ed6c8ae5d0d0f49e1ac50819cffc">calcFidelity</a>(mat,pure) == Approx(refFid) ); </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">"mixed"</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>  <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="l00481"></a><span class="lineno"> 481</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(pure, pureRef);</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="comment">// test when density matrix is mixed </span></div>
<div class="line"><a name="l00484"></a><span class="lineno"> 484</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="l00485"></a><span class="lineno"> 485</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat, matRef);</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">// <pure|mat|pure> = <pure| (Mat|pure>)</span></div>
<div class="line"><a name="l00488"></a><span class="lineno"> 488</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> rhs = matRef * pureRef;</div>
<div class="line"><a name="l00489"></a><span class="lineno"> 489</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> dotProd = 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<rhs.size(); i++)</div>
<div class="line"><a name="l00491"></a><span class="lineno"> 491</span>  dotProd += conj(pureRef[i]) * rhs[i];</div>
<div class="line"><a name="l00492"></a><span class="lineno"> 492</span>  </div>
<div class="line"><a name="l00493"></a><span class="lineno"> 493</span>  REQUIRE( imag(dotProd) == Approx(0).margin(REAL_EPS) );</div>
<div class="line"><a name="l00494"></a><span class="lineno"> 494</span>  REQUIRE( <a class="code" href="group__calc.html#gaa266ed6c8ae5d0d0f49e1ac50819cffc">calcFidelity</a>(mat,pure) == Approx(real(dotProd)) );</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">"unnormalised"</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="comment">// test when both density matrix and pure state are unnormalised</span></div>
<div class="line"><a name="l00499"></a><span class="lineno"> 499</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="l00500"></a><span class="lineno"> 500</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="l00501"></a><span class="lineno"> 501</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(pure, pureRef);</div>
<div class="line"><a name="l00502"></a><span class="lineno"> 502</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat, matRef);</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>  <span class="comment">// real[ <pure|mat|pure> ] = real[ <pure| (Mat|pure>) ]</span></div>
<div class="line"><a name="l00505"></a><span class="lineno"> 505</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> rhs = matRef * pureRef;</div>
<div class="line"><a name="l00506"></a><span class="lineno"> 506</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> dotProd = 0;</div>
<div class="line"><a name="l00507"></a><span class="lineno"> 507</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<rhs.size(); i++)</div>
<div class="line"><a name="l00508"></a><span class="lineno"> 508</span>  dotProd += conj(pureRef[i]) * rhs[i];</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>  REQUIRE( <a class="code" href="group__calc.html#gaa266ed6c8ae5d0d0f49e1ac50819cffc">calcFidelity</a>(mat,pure) == Approx(real(dotProd)) );</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>  }</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">"dimensions"</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="comment">// two state-vectors</span></div>
<div class="line"><a name="l00519"></a><span class="lineno"> 519</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="l00520"></a><span class="lineno"> 520</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="l00521"></a><span class="lineno"> 521</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="l00522"></a><span class="lineno"> 522</span>  </div>
<div class="line"><a name="l00523"></a><span class="lineno"> 523</span>  <span class="comment">// density-matrix and state-vector</span></div>
<div class="line"><a name="l00524"></a><span class="lineno"> 524</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="l00525"></a><span class="lineno"> 525</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="l00526"></a><span class="lineno"> 526</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="l00527"></a><span class="lineno"> 527</span>  }</div>
<div class="line"><a name="l00528"></a><span class="lineno"> 528</span>  SECTION( <span class="stringliteral">"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>  <span class="comment">// two mixed statess</span></div>
<div class="line"><a name="l00531"></a><span class="lineno"> 531</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="l00532"></a><span class="lineno"> 532</span>  }</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>  <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="l00535"></a><span class="lineno"> 535</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="l00536"></a><span class="lineno"> 536</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="l00537"></a><span class="lineno"> 537</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l00861">calcFidelity()</a>, <a class="el" href="QuEST_8c_source.html#l00048">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00159">getKetBra()</a>, <a class="el" href="utilities_8cpp_source.html#l00457">getRandomDensityMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00368">getRandomQMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00420">getRandomQVector()</a>, <a class="el" href="utilities_8cpp_source.html#l00453">getRandomStateVector()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="QuEST_8h_source.html#l00165">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#l00946">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">[6/88]</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#l00545">545</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="l00545"></a><span class="lineno"> 545</span>  {</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="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="l00548"></a><span class="lineno"> 548</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="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="comment">// perform these random tests 10 times </span></div>
<div class="line"><a name="l00553"></a><span class="lineno"> 553</span>  GENERATE( range(0,10) );</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">"density-matrix"</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">"pure"</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="comment">// create random |r1><r1| and |r2><r2| states</span></div>
<div class="line"><a name="l00560"></a><span class="lineno"> 560</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="l00561"></a><span class="lineno"> 561</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="l00562"></a><span class="lineno"> 562</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat1, m1);</div>
<div class="line"><a name="l00563"></a><span class="lineno"> 563</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="l00564"></a><span class="lineno"> 564</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="l00565"></a><span class="lineno"> 565</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat2, m2);</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>  <span class="comment">// Tr{ (a-b)(a-b)^dagger } = sum_{ij} |a_{ij} - b_{ij}|^2</span></div>
<div class="line"><a name="l00568"></a><span class="lineno"> 568</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> tr = 0;</div>
<div class="line"><a name="l00569"></a><span class="lineno"> 569</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<m1.size(); i++)</div>
<div class="line"><a name="l00570"></a><span class="lineno"> 570</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> j=0; j<m1.size(); j++)</div>
<div class="line"><a name="l00571"></a><span class="lineno"> 571</span>  tr += pow(abs(m1[i][j] - m2[i][j]), 2);</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>  <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="l00574"></a><span class="lineno"> 574</span>  REQUIRE( res == Approx(sqrt(tr)) );</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>  }</div>
<div class="line"><a name="l00577"></a><span class="lineno"> 577</span>  SECTION( <span class="stringliteral">"normalised"</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>  <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="l00580"></a><span class="lineno"> 580</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="l00581"></a><span class="lineno"> 581</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat1, ref1);</div>
<div class="line"><a name="l00582"></a><span class="lineno"> 582</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat2, ref2);</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>  <span class="comment">// Tr{ (a-b)(a-b)^dagger } = sum_{ij} |a_{ij} - b_{ij}|^2</span></div>
<div class="line"><a name="l00585"></a><span class="lineno"> 585</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> tr = 0;</div>
<div class="line"><a name="l00586"></a><span class="lineno"> 586</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<ref1.size(); i++)</div>
<div class="line"><a name="l00587"></a><span class="lineno"> 587</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> j=0; j<ref1.size(); j++)</div>
<div class="line"><a name="l00588"></a><span class="lineno"> 588</span>  tr += pow(abs(ref1[i][j] - ref2[i][j]), 2);</div>
<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>  <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="l00591"></a><span class="lineno"> 591</span>  REQUIRE( res == Approx(sqrt(tr)) );</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">"unnormalised"</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">// mat1 and mat2 are both random matrices</span></div>
<div class="line"><a name="l00596"></a><span class="lineno"> 596</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="l00597"></a><span class="lineno"> 597</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="l00598"></a><span class="lineno"> 598</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat1, ref1);</div>
<div class="line"><a name="l00599"></a><span class="lineno"> 599</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat2, ref2);</div>
<div class="line"><a name="l00600"></a><span class="lineno"> 600</span>  </div>
<div class="line"><a name="l00601"></a><span class="lineno"> 601</span>  <span class="comment">// Tr{ (a-b)(a-b)^dagger } = sum_{ij} |a_{ij} - b_{ij}|^2</span></div>
<div class="line"><a name="l00602"></a><span class="lineno"> 602</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> tr = 0;</div>
<div class="line"><a name="l00603"></a><span class="lineno"> 603</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<ref1.size(); i++)</div>
<div class="line"><a name="l00604"></a><span class="lineno"> 604</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> j=0; j<ref1.size(); j++)</div>
<div class="line"><a name="l00605"></a><span class="lineno"> 605</span>  tr += pow(abs(ref1[i][j] - ref2[i][j]), 2);</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#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> res = <a class="code" href="group__calc.html#ga87ddbe5c8281543541ccd99e0dafd387">calcHilbertSchmidtDistance</a>(mat1, mat2);</div>
<div class="line"><a name="l00608"></a><span class="lineno"> 608</span>  REQUIRE( res == Approx(sqrt(tr)) );</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>  }</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>  SECTION( <span class="stringliteral">"input validation"</span>) {</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>  SECTION( <span class="stringliteral">"dimensions"</span> ) {</div>
<div class="line"><a name="l00615"></a><span class="lineno"> 615</span>  </div>
<div class="line"><a name="l00616"></a><span class="lineno"> 616</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="l00617"></a><span class="lineno"> 617</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="l00618"></a><span class="lineno"> 618</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="l00619"></a><span class="lineno"> 619</span>  }</div>
<div class="line"><a name="l00620"></a><span class="lineno"> 620</span>  SECTION( <span class="stringliteral">"state-vector"</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>  <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="l00623"></a><span class="lineno"> 623</span>  </div>
<div class="line"><a name="l00624"></a><span class="lineno"> 624</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="l00625"></a><span class="lineno"> 625</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="l00626"></a><span class="lineno"> 626</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="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>(vec, <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>  }</div>
<div class="line"><a name="l00631"></a><span class="lineno"> 631</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="l00632"></a><span class="lineno"> 632</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="l00633"></a><span class="lineno"> 633</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l00889">calcHilbertSchmidtDistance()</a>, <a class="el" href="QuEST_8c_source.html#l00048">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00159">getKetBra()</a>, <a class="el" href="utilities_8cpp_source.html#l00457">getRandomDensityMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00368">getRandomQMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00453">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#l00946">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">[7/88]</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#l00641">641</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="l00641"></a><span class="lineno"> 641</span>  {</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>  <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="l00644"></a><span class="lineno"> 644</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="l00645"></a><span class="lineno"> 645</span>  </div>
<div class="line"><a name="l00646"></a><span class="lineno"> 646</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00647"></a><span class="lineno"> 647</span>  </div>
<div class="line"><a name="l00648"></a><span class="lineno"> 648</span>  <span class="comment">// perform these random tests 10 times </span></div>
<div class="line"><a name="l00649"></a><span class="lineno"> 649</span>  GENERATE( range(0,10) );</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>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00652"></a><span class="lineno"> 652</span>  </div>
<div class="line"><a name="l00653"></a><span class="lineno"> 653</span>  SECTION( <span class="stringliteral">"normalised"</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>  <span class="comment">// <r1|r2> = sum_j conj(r1_j) * r2_j</span></div>
<div class="line"><a name="l00656"></a><span class="lineno"> 656</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="l00657"></a><span class="lineno"> 657</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="l00658"></a><span class="lineno"> 658</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> prod = 0;</div>
<div class="line"><a name="l00659"></a><span class="lineno"> 659</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<r1.size(); i++)</div>
<div class="line"><a name="l00660"></a><span class="lineno"> 660</span>  prod += conj(r1[i]) * r2[i];</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>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(vec1, r1);</div>
<div class="line"><a name="l00663"></a><span class="lineno"> 663</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(vec2, r2);</div>
<div class="line"><a name="l00664"></a><span class="lineno"> 664</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="l00665"></a><span class="lineno"> 665</span>  </div>
<div class="line"><a name="l00666"></a><span class="lineno"> 666</span>  REQUIRE( res.<a class="code" href="structComplex.html#ab5b2e2eca02131fc74b289a83636cbe3">real</a> == Approx(real(prod)) );</div>
<div class="line"><a name="l00667"></a><span class="lineno"> 667</span>  REQUIRE( res.<a class="code" href="structComplex.html#a84f5439aad0ef495efdd3b4c1c02d27e">imag</a> == Approx(imag(prod)) );</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">"unnormalised"</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">// <r1|r2> = sum_j conj(r1_j) * r2_j</span></div>
<div class="line"><a name="l00672"></a><span class="lineno"> 672</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="l00673"></a><span class="lineno"> 673</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="l00674"></a><span class="lineno"> 674</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> prod = 0;</div>
<div class="line"><a name="l00675"></a><span class="lineno"> 675</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<r1.size(); i++)</div>
<div class="line"><a name="l00676"></a><span class="lineno"> 676</span>  prod += conj(r1[i]) * r2[i];</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>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(vec1, r1);</div>
<div class="line"><a name="l00679"></a><span class="lineno"> 679</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(vec2, r2);</div>
<div class="line"><a name="l00680"></a><span class="lineno"> 680</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="l00681"></a><span class="lineno"> 681</span>  </div>
<div class="line"><a name="l00682"></a><span class="lineno"> 682</span>  REQUIRE( res.<a class="code" href="structComplex.html#ab5b2e2eca02131fc74b289a83636cbe3">real</a> == Approx(real(prod)) );</div>
<div class="line"><a name="l00683"></a><span class="lineno"> 683</span>  REQUIRE( res.<a class="code" href="structComplex.html#a84f5439aad0ef495efdd3b4c1c02d27e">imag</a> == Approx(imag(prod)) );</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>  }</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>  SECTION( <span class="stringliteral">"input validation"</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>  SECTION( <span class="stringliteral">"dimensions"</span> ) {</div>
<div class="line"><a name="l00690"></a><span class="lineno"> 690</span>  </div>
<div class="line"><a name="l00691"></a><span class="lineno"> 691</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="l00692"></a><span class="lineno"> 692</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="l00693"></a><span class="lineno"> 693</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="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-matrix"</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>  <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="l00698"></a><span class="lineno"> 698</span>  </div>
<div class="line"><a name="l00699"></a><span class="lineno"> 699</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="l00700"></a><span class="lineno"> 700</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="l00701"></a><span class="lineno"> 701</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="l00702"></a><span class="lineno"> 702</span>  </div>
<div class="line"><a name="l00703"></a><span class="lineno"> 703</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="l00704"></a><span class="lineno"> 704</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="group__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(vec1, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00707"></a><span class="lineno"> 707</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="l00708"></a><span class="lineno"> 708</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l00829">calcInnerProduct()</a>, <a class="el" href="QuEST_8c_source.html#l00048">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00420">getRandomQVector()</a>, <a class="el" href="utilities_8cpp_source.html#l00453">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#l00946">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">[8/88]</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#ga2a0fbd65f42d35dcd5ae966c48826920" 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#l00716">716</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="l00716"></a><span class="lineno"> 716</span>  {</div>
<div class="line"><a name="l00717"></a><span class="lineno"> 717</span>  </div>
<div class="line"><a name="l00718"></a><span class="lineno"> 718</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="l00719"></a><span class="lineno"> 719</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="l00720"></a><span class="lineno"> 720</span>  </div>
<div class="line"><a name="l00721"></a><span class="lineno"> 721</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00722"></a><span class="lineno"> 722</span>  </div>
<div class="line"><a name="l00723"></a><span class="lineno"> 723</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="l00724"></a><span class="lineno"> 724</span>  <span class="keywordtype">int</span> outcome = GENERATE( 0, 1 );</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>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<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>  SECTION( <span class="stringliteral">"normalised"</span> ) {</div>
<div class="line"><a name="l00729"></a><span class="lineno"> 729</span>  </div>
<div class="line"><a name="l00730"></a><span class="lineno"> 730</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="l00731"></a><span class="lineno"> 731</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(vec, ref);</div>
<div class="line"><a name="l00732"></a><span class="lineno"> 732</span>  </div>
<div class="line"><a name="l00733"></a><span class="lineno"> 733</span>  <span class="comment">// prob is sum of |amp|^2 of amplitudes where target bit is outcome</span></div>
<div class="line"><a name="l00734"></a><span class="lineno"> 734</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> prob = 0;</div>
<div class="line"><a name="l00735"></a><span class="lineno"> 735</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> ind=0; ind<ref.size(); ind++) {</div>
<div class="line"><a name="l00736"></a><span class="lineno"> 736</span>  <span class="keywordtype">int</span> bit = (ind >> target) & 1; <span class="comment">// target-th bit</span></div>
<div class="line"><a name="l00737"></a><span class="lineno"> 737</span>  <span class="keywordflow">if</span> (bit == outcome)</div>
<div class="line"><a name="l00738"></a><span class="lineno"> 738</span>  prob += pow(abs(ref[ind]), 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>  </div>
<div class="line"><a name="l00741"></a><span class="lineno"> 741</span>  REQUIRE( <a class="code" href="group__calc.html#ga2a0fbd65f42d35dcd5ae966c48826920">calcProbOfOutcome</a>(vec, target, outcome) == Approx(prob) );</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>  SECTION( <span class="stringliteral">"unnormalised"</span> ) {</div>
<div class="line"><a name="l00744"></a><span class="lineno"> 744</span>  </div>
<div class="line"><a name="l00745"></a><span class="lineno"> 745</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="l00746"></a><span class="lineno"> 746</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(vec, ref);</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">// prob is (sum of |amp|^2 of amplitudes where target bit is zero)</span></div>
<div class="line"><a name="l00749"></a><span class="lineno"> 749</span>  <span class="comment">// or 1 - (this) if outcome == 1</span></div>
<div class="line"><a name="l00750"></a><span class="lineno"> 750</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> prob = 0;</div>
<div class="line"><a name="l00751"></a><span class="lineno"> 751</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> ind=0; ind<ref.size(); ind++) {</div>
<div class="line"><a name="l00752"></a><span class="lineno"> 752</span>  <span class="keywordtype">int</span> bit = (ind >> target) & 1; <span class="comment">// target-th bit</span></div>
<div class="line"><a name="l00753"></a><span class="lineno"> 753</span>  <span class="keywordflow">if</span> (bit == 0)</div>
<div class="line"><a name="l00754"></a><span class="lineno"> 754</span>  prob += pow(abs(ref[ind]), 2);</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>  <span class="keywordflow">if</span> (outcome == 1)</div>
<div class="line"><a name="l00757"></a><span class="lineno"> 757</span>  prob = 1 - prob;</div>
<div class="line"><a name="l00758"></a><span class="lineno"> 758</span>  </div>
<div class="line"><a name="l00759"></a><span class="lineno"> 759</span>  REQUIRE( <a class="code" href="group__calc.html#ga2a0fbd65f42d35dcd5ae966c48826920">calcProbOfOutcome</a>(vec, target, outcome) == Approx(prob) );</div>
<div class="line"><a name="l00760"></a><span class="lineno"> 760</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>  SECTION( <span class="stringliteral">"density-matrix"</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>  SECTION( <span class="stringliteral">"pure"</span> ) {</div>
<div class="line"><a name="l00765"></a><span class="lineno"> 765</span>  </div>
<div class="line"><a name="l00766"></a><span class="lineno"> 766</span>  <span class="comment">// set mat to a random |r><r|</span></div>
<div class="line"><a name="l00767"></a><span class="lineno"> 767</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="l00768"></a><span class="lineno"> 768</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="l00769"></a><span class="lineno"> 769</span>  </div>
<div class="line"><a name="l00770"></a><span class="lineno"> 770</span>  <span class="comment">// calc prob of the state-vector</span></div>
<div class="line"><a name="l00771"></a><span class="lineno"> 771</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> prob = 0;</div>
<div class="line"><a name="l00772"></a><span class="lineno"> 772</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> ind=0; ind<ref.size(); ind++) {</div>
<div class="line"><a name="l00773"></a><span class="lineno"> 773</span>  <span class="keywordtype">int</span> bit = (ind >> target) & 1; <span class="comment">// target-th bit</span></div>
<div class="line"><a name="l00774"></a><span class="lineno"> 774</span>  <span class="keywordflow">if</span> (bit == outcome)</div>
<div class="line"><a name="l00775"></a><span class="lineno"> 775</span>  prob += pow(abs(ref[ind]), 2);</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>  REQUIRE( <a class="code" href="group__calc.html#ga2a0fbd65f42d35dcd5ae966c48826920">calcProbOfOutcome</a>(mat, target, outcome) == Approx(prob) );</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">"mixed"</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="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="l00783"></a><span class="lineno"> 783</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat, ref);</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>  <span class="comment">// prob is sum of diagonal amps (should be real) where target bit is outcome</span></div>
<div class="line"><a name="l00786"></a><span class="lineno"> 786</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> tr = 0;</div>
<div class="line"><a name="l00787"></a><span class="lineno"> 787</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> ind=0; ind<ref.size(); ind++) {</div>
<div class="line"><a name="l00788"></a><span class="lineno"> 788</span>  <span class="keywordtype">int</span> bit = (ind >> target) & 1; <span class="comment">// target-th bit</span></div>
<div class="line"><a name="l00789"></a><span class="lineno"> 789</span>  <span class="keywordflow">if</span> (bit == outcome)</div>
<div class="line"><a name="l00790"></a><span class="lineno"> 790</span>  tr += ref[ind][ind];</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>  REQUIRE( imag(tr) == Approx(0).margin(REAL_EPS) );</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>  REQUIRE( <a class="code" href="group__calc.html#ga2a0fbd65f42d35dcd5ae966c48826920">calcProbOfOutcome</a>(mat, target, outcome) == Approx(real(tr)) );</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>  SECTION( <span class="stringliteral">"unnormalised"</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__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="l00799"></a><span class="lineno"> 799</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat, ref);</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>  <span class="comment">// prob is (sum of real of diagonal amps where target bit is outcome)</span></div>
<div class="line"><a name="l00802"></a><span class="lineno"> 802</span>  <span class="comment">// or 1 - (this) if outcome == 1</span></div>
<div class="line"><a name="l00803"></a><span class="lineno"> 803</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> tr = 0;</div>
<div class="line"><a name="l00804"></a><span class="lineno"> 804</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> ind=0; ind<ref.size(); ind++) {</div>
<div class="line"><a name="l00805"></a><span class="lineno"> 805</span>  <span class="keywordtype">int</span> bit = (ind >> target) & 1; <span class="comment">// target-th bit</span></div>
<div class="line"><a name="l00806"></a><span class="lineno"> 806</span>  <span class="keywordflow">if</span> (bit == 0)</div>
<div class="line"><a name="l00807"></a><span class="lineno"> 807</span>  tr += real(ref[ind][ind]);</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="keywordflow">if</span> (outcome == 1)</div>
<div class="line"><a name="l00810"></a><span class="lineno"> 810</span>  tr = 1 - tr;</div>
<div class="line"><a name="l00811"></a><span class="lineno"> 811</span>  </div>
<div class="line"><a name="l00812"></a><span class="lineno"> 812</span>  REQUIRE( <a class="code" href="group__calc.html#ga2a0fbd65f42d35dcd5ae966c48826920">calcProbOfOutcome</a>(mat, target, outcome) == Approx(tr) );</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 class="line"><a name="l00815"></a><span class="lineno"> 815</span>  }</div>
<div class="line"><a name="l00816"></a><span class="lineno"> 816</span>  SECTION( <span class="stringliteral">"validation"</span> ) {</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">"qubit indices"</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>  <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="l00821"></a><span class="lineno"> 821</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga2a0fbd65f42d35dcd5ae966c48826920">calcProbOfOutcome</a>(vec, target, 0), Contains(<span class="stringliteral">"Invalid target qubit"</span>) );</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>  SECTION( <span class="stringliteral">"outcome value"</span> ) {</div>
<div class="line"><a name="l00824"></a><span class="lineno"> 824</span>  </div>
<div class="line"><a name="l00825"></a><span class="lineno"> 825</span>  <span class="keywordtype">int</span> outcome = GENERATE( -1, 2 );</div>
<div class="line"><a name="l00826"></a><span class="lineno"> 826</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__calc.html#ga2a0fbd65f42d35dcd5ae966c48826920">calcProbOfOutcome</a>(vec, 0, outcome), Contains(<span class="stringliteral">"Invalid measurement outcome"</span>) );</div>
<div class="line"><a name="l00827"></a><span class="lineno"> 827</span>  }</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__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(vec, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00830"></a><span class="lineno"> 830</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="l00831"></a><span class="lineno"> 831</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l00845">calcProbOfOutcome()</a>, <a class="el" href="QuEST_8c_source.html#l00048">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00159">getKetBra()</a>, <a class="el" href="utilities_8cpp_source.html#l00457">getRandomDensityMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00368">getRandomQMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00420">getRandomQVector()</a>, <a class="el" href="utilities_8cpp_source.html#l00453">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#l00946">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">[9/88]</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#l00839">839</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="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>  <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="l00842"></a><span class="lineno"> 842</span>  </div>
<div class="line"><a name="l00843"></a><span class="lineno"> 843</span>  SECTION( <span class="stringliteral">"correctness"</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>  <span class="comment">// perform the following random tests 10 times </span></div>
<div class="line"><a name="l00846"></a><span class="lineno"> 846</span>  GENERATE( range(1,10) );</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">"density-matrix"</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>  SECTION( <span class="stringliteral">"pure"</span> ) {</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>  <span class="comment">// pure states have unity purity </span></div>
<div class="line"><a name="l00853"></a><span class="lineno"> 853</span>  <a class="code" href="group__init.html#ga2f049055d4a51d0ea4d1a43b5234dedb">initZeroState</a>(mat);</div>
<div class="line"><a name="l00854"></a><span class="lineno"> 854</span>  REQUIRE( <a class="code" href="group__calc.html#ga683779343fb2c6055f6b1d01079c2ede">calcPurity</a>(mat) == 1 );</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>  <span class="comment">// (try also a pure random L2-vector)</span></div>
<div class="line"><a name="l00857"></a><span class="lineno"> 857</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="l00858"></a><span class="lineno"> 858</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="l00859"></a><span class="lineno"> 859</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat, m1);</div>
<div class="line"><a name="l00860"></a><span class="lineno"> 860</span>  REQUIRE( <a class="code" href="group__calc.html#ga683779343fb2c6055f6b1d01079c2ede">calcPurity</a>(mat) == Approx(1) );</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>  }</div>
<div class="line"><a name="l00863"></a><span class="lineno"> 863</span>  SECTION( <span class="stringliteral">"mixed"</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="comment">// mixed states have 1/2^N < purity < 1</span></div>
<div class="line"><a name="l00866"></a><span class="lineno"> 866</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="l00867"></a><span class="lineno"> 867</span>  <a class="code" href="group__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat, ref);</div>
<div class="line"><a name="l00868"></a><span class="lineno"> 868</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="l00869"></a><span class="lineno"> 869</span>  REQUIRE( purity < 1 );</div>
<div class="line"><a name="l00870"></a><span class="lineno"> 870</span>  REQUIRE( purity >= 1/pow(2.,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</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>  <span class="comment">// compare to Tr(rho^2)</span></div>
<div class="line"><a name="l00873"></a><span class="lineno"> 873</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> prod = ref*ref;</div>
<div class="line"><a name="l00874"></a><span class="lineno"> 874</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> tr = 0;</div>
<div class="line"><a name="l00875"></a><span class="lineno"> 875</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<prod.size(); i++)</div>
<div class="line"><a name="l00876"></a><span class="lineno"> 876</span>  tr += real(prod[i][i]);</div>
<div class="line"><a name="l00877"></a><span class="lineno"> 877</span>  REQUIRE( purity == Approx(tr) );</div>
<div class="line"><a name="l00878"></a><span class="lineno"> 878</span>  }</div>
<div class="line"><a name="l00879"></a><span class="lineno"> 879</span>  SECTION( <span class="stringliteral">"unnormalised"</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">// unphysical states give sum_{ij} |rho_ij|^2</span></div>
<div class="line"><a name="l00882"></a><span class="lineno"> 882</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="l00883"></a><span class="lineno"> 883</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> tot = 0;</div>
<div class="line"><a name="l00884"></a><span class="lineno"> 884</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<ref.size(); i++)</div>
<div class="line"><a name="l00885"></a><span class="lineno"> 885</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> j=0; j<ref.size(); j++)</div>
<div class="line"><a name="l00886"></a><span class="lineno"> 886</span>  tot += pow(abs(ref[i][j]), 2);</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__testutilities.html#gaf5a18d4c00dfe0523972be3bfc666362">toQureg</a>(mat, ref);</div>
<div class="line"><a name="l00889"></a><span class="lineno"> 889</span>  REQUIRE( <a class="code" href="group__calc.html#ga683779343fb2c6055f6b1d01079c2ede">calcPurity</a>(mat) == Approx(tot) );</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 class="line"><a name="l00893"></a><span class="lineno"> 893</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00894"></a><span class="lineno"> 894</span>  </div>
<div class="line"><a name="l00895"></a><span class="lineno"> 895</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00896"></a><span class="lineno"> 896</span>  </div>
<div class="line"><a name="l00897"></a><span class="lineno"> 897</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="l00898"></a><span class="lineno"> 898</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="l00899"></a><span class="lineno"> 899</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="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>  <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="l00903"></a><span class="lineno"> 903</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l00855">calcPurity()</a>, <a class="el" href="QuEST_8c_source.html#l00048">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00159">getKetBra()</a>, <a class="el" href="utilities_8cpp_source.html#l00457">getRandomDensityMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00368">getRandomQMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00453">getRandomStateVector()</a>, <a class="el" href="QuEST_8c_source.html#l00111">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#l00946">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">[10/88]</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#l00911">911</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="l00911"></a><span class="lineno"> 911</span>  {</div>
<div class="line"><a name="l00912"></a><span class="lineno"> 912</span>  </div>
<div class="line"><a name="l00913"></a><span class="lineno"> 913</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="l00914"></a><span class="lineno"> 914</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="l00915"></a><span class="lineno"> 915</span>  </div>
<div class="line"><a name="l00916"></a><span class="lineno"> 916</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</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">"state-vector"</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>  <span class="comment">// normalised: prob(vec) = 1</span></div>
<div class="line"><a name="l00921"></a><span class="lineno"> 921</span>  <a class="code" href="group__init.html#ga234bd34016f08288532791903b9884b5">initPlusState</a>(vec);</div>
<div class="line"><a name="l00922"></a><span class="lineno"> 922</span>  REQUIRE( <a class="code" href="group__calc.html#gab082910d33473ec29e1d5852943de468">calcTotalProb</a>(vec) == Approx(1) );</div>
<div class="line"><a name="l00923"></a><span class="lineno"> 923</span>  </div>
<div class="line"><a name="l00924"></a><span class="lineno"> 924</span>  <span class="comment">// zero norm: prob(vec) = 0</span></div>
<div class="line"><a name="l00925"></a><span class="lineno"> 925</span>  <a class="code" href="group__init.html#gada7230491a50cd409f8b00f5ee1db953">initBlankState</a>(vec);</div>
<div class="line"><a name="l00926"></a><span class="lineno"> 926</span>  REQUIRE( <a class="code" href="group__calc.html#gab082910d33473ec29e1d5852943de468">calcTotalProb</a>(vec) == 0 );</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">// random L2 state: prob(vec) = 1</span></div>
<div class="line"><a name="l00929"></a><span class="lineno"> 929</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="l00930"></a><span class="lineno"> 930</span>  REQUIRE( <a class="code" href="group__calc.html#gab082910d33473ec29e1d5852943de468">calcTotalProb</a>(vec) == Approx(1) );</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>  <span class="comment">// unnormalised: prob(vec) = sum_i |vec_i|^2</span></div>
<div class="line"><a name="l00933"></a><span class="lineno"> 933</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(vec);</div>
<div class="line"><a name="l00934"></a><span class="lineno"> 934</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="l00935"></a><span class="lineno"> 935</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> refProb = 0;</div>
<div class="line"><a name="l00936"></a><span class="lineno"> 936</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<ref.size(); i++)</div>
<div class="line"><a name="l00937"></a><span class="lineno"> 937</span>  refProb += pow(abs(ref[i]), 2);</div>
<div class="line"><a name="l00938"></a><span class="lineno"> 938</span>  REQUIRE( <a class="code" href="group__calc.html#gab082910d33473ec29e1d5852943de468">calcTotalProb</a>(vec) == Approx(refProb) );</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">"density-matrix"</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="comment">// normalised: prob(mat) = 1</span></div>
<div class="line"><a name="l00943"></a><span class="lineno"> 943</span>  <a class="code" href="group__init.html#ga234bd34016f08288532791903b9884b5">initPlusState</a>(mat);</div>
<div class="line"><a name="l00944"></a><span class="lineno"> 944</span>  REQUIRE( <a class="code" href="group__calc.html#gab082910d33473ec29e1d5852943de468">calcTotalProb</a>(mat) == Approx(1) );</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>  <span class="comment">// zero norm: prob(mat) = 0</span></div>
<div class="line"><a name="l00947"></a><span class="lineno"> 947</span>  <a class="code" href="group__init.html#gada7230491a50cd409f8b00f5ee1db953">initBlankState</a>(mat);</div>
<div class="line"><a name="l00948"></a><span class="lineno"> 948</span>  REQUIRE( <a class="code" href="group__calc.html#gab082910d33473ec29e1d5852943de468">calcTotalProb</a>(mat) == 0 );</div>
<div class="line"><a name="l00949"></a><span class="lineno"> 949</span>  </div>
<div class="line"><a name="l00950"></a><span class="lineno"> 950</span>  <span class="comment">// random density matrix: prob(mat) = 1</span></div>
<div class="line"><a name="l00951"></a><span class="lineno"> 951</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="l00952"></a><span class="lineno"> 952</span>  REQUIRE( <a class="code" href="group__calc.html#gab082910d33473ec29e1d5852943de468">calcTotalProb</a>(mat) == Approx(1) );</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">// unnormalised: prob(mat) = sum_i real(mat_{ii})</span></div>
<div class="line"><a name="l00955"></a><span class="lineno"> 955</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(mat);</div>
<div class="line"><a name="l00956"></a><span class="lineno"> 956</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="l00957"></a><span class="lineno"> 957</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> refProb = 0;</div>
<div class="line"><a name="l00958"></a><span class="lineno"> 958</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0; i<ref.size(); i++)</div>
<div class="line"><a name="l00959"></a><span class="lineno"> 959</span>  refProb += real(ref[i][i]);</div>
<div class="line"><a name="l00960"></a><span class="lineno"> 960</span>  REQUIRE( <a class="code" href="group__calc.html#gab082910d33473ec29e1d5852943de468">calcTotalProb</a>(mat) == Approx(refProb) );</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>  }</div>
<div class="line"><a name="l00963"></a><span class="lineno"> 963</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00964"></a><span class="lineno"> 964</span>  </div>
<div class="line"><a name="l00965"></a><span class="lineno"> 965</span>  <span class="comment">// no validation </span></div>
<div class="line"><a name="l00966"></a><span class="lineno"> 966</span>  SUCCEED();</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>  <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="l00969"></a><span class="lineno"> 969</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="l00970"></a><span class="lineno"> 970</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l00822">calcTotalProb()</a>, <a class="el" href="QuEST_8c_source.html#l00048">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00457">getRandomDensityMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00453">getRandomStateVector()</a>, <a class="el" href="QuEST_8c_source.html#l00117">initBlankState()</a>, <a class="el" href="QuEST_8c_source.html#l01057">initDebugState()</a>, <a class="el" href="QuEST_8c_source.html#l00123">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#l00835">toQMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00946">toQureg()</a>, and <a class="el" href="utilities_8cpp_source.html#l00904">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">[11/88]</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="Set targetQureg to be a clone of 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#l00387">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00163">cloneQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00048">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00117">initBlankState()</a>, <a class="el" href="QuEST_8c_source.html#l01057">initDebugState()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="QuEST_8h_source.html#l00165">Qureg::numQubitsRepresented</a>, <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>, <a class="el" href="utilities_8cpp_source.html#l00835">toQMatrix()</a>, and <a class="el" href="utilities_8cpp_source.html#l00904">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">[12/88]</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#gab164930b260718d85ed3f55f50c76a59" 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#gab164930b260718d85ed3f55f50c76a59">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#gab164930b260718d85ed3f55f50c76a59">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#gab164930b260718d85ed3f55f50c76a59">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#gab164930b260718d85ed3f55f50c76a59">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#gab164930b260718d85ed3f55f50c76a59">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#gab164930b260718d85ed3f55f50c76a59">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#l00387">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00724">collapseToOutcome()</a>, <a class="el" href="QuEST_8c_source.html#l00048">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00457">getRandomDensityMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00453">getRandomStateVector()</a>, <a class="el" href="QuEST_8c_source.html#l00132">initClassicalState()</a>, <a class="el" href="QuEST_8c_source.html#l00111">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#l00946">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">[13/88]</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#ga0cbd92af48fe641522e62eea1a76a7c3" 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*M_PI));</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*M_PI));</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#ga0cbd92af48fe641522e62eea1a76a7c3">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#ga0cbd92af48fe641522e62eea1a76a7c3">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#ga0cbd92af48fe641522e62eea1a76a7c3">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#ga0cbd92af48fe641522e62eea1a76a7c3">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#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l00403">compactUnitary()</a>, <a class="el" href="utilities_8cpp_source.html#l00406">expI()</a>, <a class="el" href="utilities_8cpp_source.html#l00410">getRandomReal()</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#l00835">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">[14/88]</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#gaa854e4b76cfd4000a32c06c990960bd9" 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*M_PI));</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*M_PI));</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#gaa854e4b76cfd4000a32c06c990960bd9">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#gaa854e4b76cfd4000a32c06c990960bd9">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#gaa854e4b76cfd4000a32c06c990960bd9">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#gaa854e4b76cfd4000a32c06c990960bd9">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#gaa854e4b76cfd4000a32c06c990960bd9">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#gaa854e4b76cfd4000a32c06c990960bd9">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#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l00416">controlledCompactUnitary()</a>, <a class="el" href="utilities_8cpp_source.html#l00406">expI()</a>, <a class="el" href="utilities_8cpp_source.html#l00410">getRandomReal()</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#l00835">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">[15/88]</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#ga6375f658bd7cb24d25e0603b5b947bbd" 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#ga6375f658bd7cb24d25e0603b5b947bbd">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#ga6375f658bd7cb24d25e0603b5b947bbd">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#ga6375f658bd7cb24d25e0603b5b947bbd">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#ga6375f658bd7cb24d25e0603b5b947bbd">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#ga6375f658bd7cb24d25e0603b5b947bbd">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#ga6375f658bd7cb24d25e0603b5b947bbd">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#ga6375f658bd7cb24d25e0603b5b947bbd">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#ga6375f658bd7cb24d25e0603b5b947bbd">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#ga6375f658bd7cb24d25e0603b5b947bbd">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#ga6375f658bd7cb24d25e0603b5b947bbd">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#ga6375f658bd7cb24d25e0603b5b947bbd">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#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="QuEST__validation_8c_source.html#l00254">calcLog2()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l00312">controlledMultiQubitUnitary()</a>, <a class="el" href="QuEST_8c_source.html#l01000">createComplexMatrixN()</a>, <a class="el" href="QuEST_8c_source.html#l01021">destroyComplexMatrixN()</a>, <a class="el" href="utilities_8cpp_source.html#l00485">getRandomUnitary()</a>, <a class="el" href="QuEST_8h_source.html#l00140">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#l00139">ComplexMatrixN::real</a>, <a class="el" href="utilities_8cpp_source.html#l01074">sublists()</a>, and <a class="el" href="utilities_8cpp_source.html#l00824">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">[16/88]</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#gadf4927a3d5dd8cd6d7400f2e810b4f05" 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#gadf4927a3d5dd8cd6d7400f2e810b4f05">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#gadf4927a3d5dd8cd6d7400f2e810b4f05">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#gadf4927a3d5dd8cd6d7400f2e810b4f05">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#gadf4927a3d5dd8cd6d7400f2e810b4f05">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#gadf4927a3d5dd8cd6d7400f2e810b4f05">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#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l00523">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">[17/88]</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#ga811e9b47126c83ff859059106f66cf96" 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,-1i},{1i,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#ga811e9b47126c83ff859059106f66cf96">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#ga811e9b47126c83ff859059106f66cf96">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#ga811e9b47126c83ff859059106f66cf96">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#ga811e9b47126c83ff859059106f66cf96">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#ga811e9b47126c83ff859059106f66cf96">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#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l00535">controlledPauliY()</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="gaa1bacf29d7a0a247e5a944bf76f086d0"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaa1bacf29d7a0a247e5a944bf76f086d0">◆ </a></span>TEST_CASE() <span class="overload">[18/88]</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#ga4dcb9c6660d7a5f74c9597bc467d39ef" 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#ga4dcb9c6660d7a5f74c9597bc467d39ef">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#ga4dcb9c6660d7a5f74c9597bc467d39ef">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#ga4dcb9c6660d7a5f74c9597bc467d39ef">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#ga4dcb9c6660d7a5f74c9597bc467d39ef">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#ga4dcb9c6660d7a5f74c9597bc467d39ef">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#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l00547">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">[19/88]</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#ga69e074c8174e198ca014d9905b98b43d" 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*M_PI, 2*M_PI);</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#ga69e074c8174e198ca014d9905b98b43d">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#ga69e074c8174e198ca014d9905b98b43d">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#ga69e074c8174e198ca014d9905b98b43d">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#ga69e074c8174e198ca014d9905b98b43d">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#ga69e074c8174e198ca014d9905b98b43d">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#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l00497">controlledPhaseShift()</a>, <a class="el" href="utilities_8cpp_source.html#l00406">expI()</a>, <a class="el" href="utilities_8cpp_source.html#l00410">getRandomReal()</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">[20/88]</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#ga82bf9aaf01430d3ecfde52b7731421d7" 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*M_PI, 4*M_PI);</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 - 1i*vec.<a class="code" href="structVector.html#ab33976d8fda2e44b770f71269d698a25">z</a>*s/m, -(vec.<a class="code" href="structVector.html#abc3cfc6c8e297b1153a373d84b981e6b">y</a> + 1i*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> - 1i*vec.<a class="code" href="structVector.html#a0d0459a5b731ac5fb3dff2c6134e6e88">x</a>)*s/m, c + 1i*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#ga82bf9aaf01430d3ecfde52b7731421d7">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#ga82bf9aaf01430d3ecfde52b7731421d7">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#ga82bf9aaf01430d3ecfde52b7731421d7">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#ga82bf9aaf01430d3ecfde52b7731421d7">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#ga82bf9aaf01430d3ecfde52b7731421d7">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#ga82bf9aaf01430d3ecfde52b7731421d7">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#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l00586">controlledRotateAroundAxis()</a>, <a class="el" href="utilities_8cpp_source.html#l00410">getRandomReal()</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>, <a class="el" href="QuEST_8h_source.html#l00150">Vector::x</a>, <a class="el" href="QuEST_8h_source.html#l00150">Vector::y</a>, and <a class="el" href="QuEST_8h_source.html#l00150">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">[21/88]</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#ga7dc4ed5d9fd2872a04fea6ef13b65c3d" 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*M_PI, 4*M_PI);</div>
<div class="line"><a name="l00546"></a><span class="lineno"> 546</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op{{cos(param/2), -1i*sin(param/2)}, {-1i*sin(param/2), cos(param/2)}};</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>  SECTION( <span class="stringliteral">"correctness"</span> ) {</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="keywordtype">int</span> target = GENERATE( range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) );</div>
<div class="line"><a name="l00551"></a><span class="lineno"> 551</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="l00552"></a><span class="lineno"> 552</span>  </div>
<div class="line"><a name="l00553"></a><span class="lineno"> 553</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</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>  <a class="code" href="group__unitary.html#ga7dc4ed5d9fd2872a04fea6ef13b65c3d">controlledRotateX</a>(quregVec, control, target, param);</div>
<div class="line"><a name="l00556"></a><span class="lineno"> 556</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, control, target, op); </div>
<div class="line"><a name="l00557"></a><span class="lineno"> 557</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</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>  SECTION( <span class="stringliteral">"density-matrix"</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>  <a class="code" href="group__unitary.html#ga7dc4ed5d9fd2872a04fea6ef13b65c3d">controlledRotateX</a>(quregMatr, control, target, param);</div>
<div class="line"><a name="l00562"></a><span class="lineno"> 562</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, control, target, op); </div>
<div class="line"><a name="l00563"></a><span class="lineno"> 563</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</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>  }</div>
<div class="line"><a name="l00566"></a><span class="lineno"> 566</span>  SECTION( <span class="stringliteral">"input validation"</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">"control and target collision"</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> qb = GENERATE( range(0,<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__unitary.html#ga7dc4ed5d9fd2872a04fea6ef13b65c3d">controlledRotateX</a>(quregVec, qb, qb, param), Contains(<span class="stringliteral">"Control"</span>) && Contains(<span class="stringliteral">"target"</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">"qubit indices"</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>  <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="l00576"></a><span class="lineno"> 576</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga7dc4ed5d9fd2872a04fea6ef13b65c3d">controlledRotateX</a>(quregVec, qb, 0, param), Contains(<span class="stringliteral">"Invalid control"</span>) );</div>
<div class="line"><a name="l00577"></a><span class="lineno"> 577</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga7dc4ed5d9fd2872a04fea6ef13b65c3d">controlledRotateX</a>(quregVec, 0, qb, param), Contains(<span class="stringliteral">"Invalid target"</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>  }</div>
<div class="line"><a name="l00580"></a><span class="lineno"> 580</span>  <a class="code" href="test__unitaries_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="utilities_8cpp_source.html#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l00219">controlledRotateX()</a>, <a class="el" href="utilities_8cpp_source.html#l00410">getRandomReal()</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="ga8b6968998c3a5d74b05d440c5e342b66"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga8b6968998c3a5d74b05d440c5e342b66">◆ </a></span>TEST_CASE() <span class="overload">[22/88]</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#gaf99ba5356a6c20d3d047b36874fc0a50" 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#l00589">589</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="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__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l00592"></a><span class="lineno"> 592</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> param = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-4*M_PI, 4*M_PI);</div>
<div class="line"><a name="l00593"></a><span class="lineno"> 593</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="l00594"></a><span class="lineno"> 594</span>  </div>
<div class="line"><a name="l00595"></a><span class="lineno"> 595</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</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="keywordtype">int</span> target = GENERATE( range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) );</div>
<div class="line"><a name="l00598"></a><span class="lineno"> 598</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="l00599"></a><span class="lineno"> 599</span>  </div>
<div class="line"><a name="l00600"></a><span class="lineno"> 600</span>  SECTION( <span class="stringliteral">"state-vector"</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>  <a class="code" href="group__unitary.html#gaf99ba5356a6c20d3d047b36874fc0a50">controlledRotateY</a>(quregVec, control, target, param);</div>
<div class="line"><a name="l00603"></a><span class="lineno"> 603</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, control, target, op); </div>
<div class="line"><a name="l00604"></a><span class="lineno"> 604</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</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>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</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>  <a class="code" href="group__unitary.html#gaf99ba5356a6c20d3d047b36874fc0a50">controlledRotateY</a>(quregMatr, control, target, param);</div>
<div class="line"><a name="l00609"></a><span class="lineno"> 609</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, control, target, op); </div>
<div class="line"><a name="l00610"></a><span class="lineno"> 610</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 2*REAL_EPS) );</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>  }</div>
<div class="line"><a name="l00613"></a><span class="lineno"> 613</span>  SECTION( <span class="stringliteral">"input validation"</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">"control and target collision"</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>  <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="l00618"></a><span class="lineno"> 618</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gaf99ba5356a6c20d3d047b36874fc0a50">controlledRotateY</a>(quregVec, qb, qb, param), Contains(<span class="stringliteral">"Control"</span>) && Contains(<span class="stringliteral">"target"</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>  SECTION( <span class="stringliteral">"qubit indices"</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>  <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="l00623"></a><span class="lineno"> 623</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gaf99ba5356a6c20d3d047b36874fc0a50">controlledRotateY</a>(quregVec, qb, 0, param), Contains(<span class="stringliteral">"Invalid control"</span>) );</div>
<div class="line"><a name="l00624"></a><span class="lineno"> 624</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gaf99ba5356a6c20d3d047b36874fc0a50">controlledRotateY</a>(quregVec, 0, qb, param), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l00625"></a><span class="lineno"> 625</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>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l00628"></a><span class="lineno"> 628</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l00231">controlledRotateY()</a>, <a class="el" href="utilities_8cpp_source.html#l00410">getRandomReal()</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">[23/88]</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#ga9afcf34f7c6ae127452b503c074a9b7b" 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#l00636">636</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="l00636"></a><span class="lineno"> 636</span>  {</div>
<div class="line"><a name="l00637"></a><span class="lineno"> 637</span>  </div>
<div class="line"><a name="l00638"></a><span class="lineno"> 638</span>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l00639"></a><span class="lineno"> 639</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> param = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-4*M_PI, 4*M_PI);</div>
<div class="line"><a name="l00640"></a><span class="lineno"> 640</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="l00641"></a><span class="lineno"> 641</span>  </div>
<div class="line"><a name="l00642"></a><span class="lineno"> 642</span>  SECTION( <span class="stringliteral">"correctness"</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>  <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="l00645"></a><span class="lineno"> 645</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="l00646"></a><span class="lineno"> 646</span>  </div>
<div class="line"><a name="l00647"></a><span class="lineno"> 647</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</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>  <a class="code" href="group__unitary.html#ga9afcf34f7c6ae127452b503c074a9b7b">controlledRotateZ</a>(quregVec, control, target, param);</div>
<div class="line"><a name="l00650"></a><span class="lineno"> 650</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, control, target, op); </div>
<div class="line"><a name="l00651"></a><span class="lineno"> 651</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l00652"></a><span class="lineno"> 652</span>  }</div>
<div class="line"><a name="l00653"></a><span class="lineno"> 653</span>  SECTION( <span class="stringliteral">"density-matrix"</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="group__unitary.html#ga9afcf34f7c6ae127452b503c074a9b7b">controlledRotateZ</a>(quregMatr, control, target, param);</div>
<div class="line"><a name="l00656"></a><span class="lineno"> 656</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, control, target, op); </div>
<div class="line"><a name="l00657"></a><span class="lineno"> 657</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</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 class="line"><a name="l00660"></a><span class="lineno"> 660</span>  SECTION( <span class="stringliteral">"input validation"</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">"control and target collision"</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>  <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="l00665"></a><span class="lineno"> 665</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga9afcf34f7c6ae127452b503c074a9b7b">controlledRotateZ</a>(quregVec, qb, qb, param), Contains(<span class="stringliteral">"Control"</span>) && Contains(<span class="stringliteral">"target"</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>  SECTION( <span class="stringliteral">"qubit indices"</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>  <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="l00670"></a><span class="lineno"> 670</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga9afcf34f7c6ae127452b503c074a9b7b">controlledRotateZ</a>(quregVec, qb, 0, param), Contains(<span class="stringliteral">"Invalid control"</span>) );</div>
<div class="line"><a name="l00671"></a><span class="lineno"> 671</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga9afcf34f7c6ae127452b503c074a9b7b">controlledRotateZ</a>(quregVec, 0, qb, param), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l00672"></a><span class="lineno"> 672</span>  }</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>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l00675"></a><span class="lineno"> 675</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l00243">controlledRotateZ()</a>, <a class="el" href="utilities_8cpp_source.html#l00406">expI()</a>, <a class="el" href="utilities_8cpp_source.html#l00410">getRandomReal()</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">[24/88]</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#ga8a718f1a8cc3a0ea3f5bbdb2c5a99d80" 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#l00683">683</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="l00683"></a><span class="lineno"> 683</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>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</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>  <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="l00688"></a><span class="lineno"> 688</span>  REQUIRE( quregVec.numAmpsPerChunk >= 4 );</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">// every test will use a unique random matrix</span></div>
<div class="line"><a name="l00691"></a><span class="lineno"> 691</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="l00692"></a><span class="lineno"> 692</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="l00693"></a><span class="lineno"> 693</span>  </div>
<div class="line"><a name="l00694"></a><span class="lineno"> 694</span>  SECTION( <span class="stringliteral">"correctness"</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> targ1 = 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>  <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="l00698"></a><span class="lineno"> 698</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="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__unitary.html#ga8a718f1a8cc3a0ea3f5bbdb2c5a99d80">controlledTwoQubitUnitary</a>(quregVec, control, targ1, targ2, matr);</div>
<div class="line"><a name="l00703"></a><span class="lineno"> 703</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, control, targ1, targ2, op); </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) );</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__unitary.html#ga8a718f1a8cc3a0ea3f5bbdb2c5a99d80">controlledTwoQubitUnitary</a>(quregMatr, control, targ1, targ2, matr);</div>
<div class="line"><a name="l00709"></a><span class="lineno"> 709</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, control, targ1, targ2, op); </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, 10*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>  SECTION( <span class="stringliteral">"repetition of targets"</span> ) {</div>
<div class="line"><a name="l00716"></a><span class="lineno"> 716</span>  <span class="keywordtype">int</span> targ = 0;</div>
<div class="line"><a name="l00717"></a><span class="lineno"> 717</span>  <span class="keywordtype">int</span> ctrl = 1;</div>
<div class="line"><a name="l00718"></a><span class="lineno"> 718</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga8a718f1a8cc3a0ea3f5bbdb2c5a99d80">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="l00719"></a><span class="lineno"> 719</span>  }</div>
<div class="line"><a name="l00720"></a><span class="lineno"> 720</span>  SECTION( <span class="stringliteral">"control and target collision"</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>  <span class="keywordtype">int</span> targ1 = 1;</div>
<div class="line"><a name="l00723"></a><span class="lineno"> 723</span>  <span class="keywordtype">int</span> targ2 = 2;</div>
<div class="line"><a name="l00724"></a><span class="lineno"> 724</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="l00725"></a><span class="lineno"> 725</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga8a718f1a8cc3a0ea3f5bbdb2c5a99d80">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="l00726"></a><span class="lineno"> 726</span>  }</div>
<div class="line"><a name="l00727"></a><span class="lineno"> 727</span>  SECTION( <span class="stringliteral">"qubit indices"</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">// valid config</span></div>
<div class="line"><a name="l00730"></a><span class="lineno"> 730</span>  <span class="keywordtype">int</span> ctrl = 0;</div>
<div class="line"><a name="l00731"></a><span class="lineno"> 731</span>  <span class="keywordtype">int</span> targ1 = 1;</div>
<div class="line"><a name="l00732"></a><span class="lineno"> 732</span>  <span class="keywordtype">int</span> targ2 = 2;</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="keywordtype">int</span> qb = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l00735"></a><span class="lineno"> 735</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga8a718f1a8cc3a0ea3f5bbdb2c5a99d80">controlledTwoQubitUnitary</a>(quregVec, qb, targ1, targ2, matr), Contains(<span class="stringliteral">"Invalid control"</span>) );</div>
<div class="line"><a name="l00736"></a><span class="lineno"> 736</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga8a718f1a8cc3a0ea3f5bbdb2c5a99d80">controlledTwoQubitUnitary</a>(quregVec, ctrl, qb, targ2, matr), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l00737"></a><span class="lineno"> 737</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga8a718f1a8cc3a0ea3f5bbdb2c5a99d80">controlledTwoQubitUnitary</a>(quregVec, ctrl, targ1, qb, matr), Contains(<span class="stringliteral">"Invalid target"</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">"unitarity"</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>  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="l00742"></a><span class="lineno"> 742</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga8a718f1a8cc3a0ea3f5bbdb2c5a99d80">controlledTwoQubitUnitary</a>(quregVec, 0, 1, 2, matr), Contains(<span class="stringliteral">"unitary"</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">"unitary fits in node"</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>  <span class="comment">// pretend we have a very limited distributed memory</span></div>
<div class="line"><a name="l00747"></a><span class="lineno"> 747</span>  quregVec.numAmpsPerChunk = 1;</div>
<div class="line"><a name="l00748"></a><span class="lineno"> 748</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga8a718f1a8cc3a0ea3f5bbdb2c5a99d80">controlledTwoQubitUnitary</a>(quregVec, 0, 1, 2, matr), Contains(<span class="stringliteral">"targets too many qubits"</span>));</div>
<div class="line"><a name="l00749"></a><span class="lineno"> 749</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>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l00752"></a><span class="lineno"> 752</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l00268">controlledTwoQubitUnitary()</a>, <a class="el" href="utilities_8cpp_source.html#l00485">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#l00127">ComplexMatrix4::real</a>, and <a class="el" href="utilities_8cpp_source.html#l00818">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">[25/88]</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#gaf2ad34c9659292d32c6c725e4bd668cf" 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#l00760">760</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="l00760"></a><span class="lineno"> 760</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>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l00763"></a><span class="lineno"> 763</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="l00764"></a><span class="lineno"> 764</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="l00765"></a><span class="lineno"> 765</span>  </div>
<div class="line"><a name="l00766"></a><span class="lineno"> 766</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</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="keywordtype">int</span> target = GENERATE( range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) );</div>
<div class="line"><a name="l00769"></a><span class="lineno"> 769</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="l00770"></a><span class="lineno"> 770</span>  </div>
<div class="line"><a name="l00771"></a><span class="lineno"> 771</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</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>  <a class="code" href="group__unitary.html#gaf2ad34c9659292d32c6c725e4bd668cf">controlledUnitary</a>(quregVec, control, target, matr);</div>
<div class="line"><a name="l00774"></a><span class="lineno"> 774</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, control, target, op); </div>
<div class="line"><a name="l00775"></a><span class="lineno"> 775</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</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>  SECTION( <span class="stringliteral">"density-matrix"</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>  <a class="code" href="group__unitary.html#gaf2ad34c9659292d32c6c725e4bd668cf">controlledUnitary</a>(quregMatr, control, target, matr);</div>
<div class="line"><a name="l00780"></a><span class="lineno"> 780</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, control, target, op); </div>
<div class="line"><a name="l00781"></a><span class="lineno"> 781</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 10*REAL_EPS) );</div>
<div class="line"><a name="l00782"></a><span class="lineno"> 782</span>  }</div>
<div class="line"><a name="l00783"></a><span class="lineno"> 783</span>  }</div>
<div class="line"><a name="l00784"></a><span class="lineno"> 784</span>  SECTION( <span class="stringliteral">"input validation"</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">"control and target collision"</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>  <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="l00789"></a><span class="lineno"> 789</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gaf2ad34c9659292d32c6c725e4bd668cf">controlledUnitary</a>(quregVec, qb, qb, matr), Contains(<span class="stringliteral">"Control"</span>) && Contains(<span class="stringliteral">"target"</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>  SECTION( <span class="stringliteral">"qubit indices"</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>  <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="l00794"></a><span class="lineno"> 794</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gaf2ad34c9659292d32c6c725e4bd668cf">controlledUnitary</a>(quregVec, qb, 0, matr), Contains(<span class="stringliteral">"Invalid control"</span>) );</div>
<div class="line"><a name="l00795"></a><span class="lineno"> 795</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gaf2ad34c9659292d32c6c725e4bd668cf">controlledUnitary</a>(quregVec, 0, qb, matr), Contains(<span class="stringliteral">"Invalid target"</span>) );</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>  SECTION( <span class="stringliteral">"unitarity"</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>  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="l00800"></a><span class="lineno"> 800</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gaf2ad34c9659292d32c6c725e4bd668cf">controlledUnitary</a>(quregVec, 0, 1, matr), Contains(<span class="stringliteral">"unitary"</span>) );</div>
<div class="line"><a name="l00801"></a><span class="lineno"> 801</span>  }</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="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l00804"></a><span class="lineno"> 804</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l00359">controlledUnitary()</a>, <a class="el" href="utilities_8cpp_source.html#l00485">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#l00116">ComplexMatrix2::real</a>, and <a class="el" href="utilities_8cpp_source.html#l00812">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">[26/88]</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 statevector 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#l00387">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00062">createCloneQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00048">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="QuEST_8h_source.html#l00163">Qureg::isDensityMatrix</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="QuEST_8h_source.html#l00170">Qureg::numAmpsPerChunk</a>, <a class="el" href="QuEST_8h_source.html#l00172">Qureg::numAmpsTotal</a>, <a class="el" href="QuEST_8h_source.html#l00167">Qureg::numQubitsInStateVec</a>, <a class="el" href="QuEST_8h_source.html#l00165">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">[27/88]</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="Create (dynamically) a square complex matrix which can be passed to the multi-qubit general unitary f...">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#l00387">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l01000">createComplexMatrixN()</a>, <a class="el" href="QuEST_8c_source.html#l01021">destroyComplexMatrixN()</a>, <a class="el" href="utilities_8cpp_source.html#l00143">getZeroMatrix()</a>, and <a class="el" href="utilities_8cpp_source.html#l00835">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">[28/88]</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="Create a Qureg for qubits which are represented by a density matrix, and can be in mixed states.">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) - 1;</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( range(3,10) );</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#l00387">areEqual()</a>, <a class="el" href="QuEST__validation_8c_source.html#l00254">calcLog2()</a>, <a class="el" href="QuEST_8c_source.html#l00048">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00143">getZeroMatrix()</a>, <a class="el" href="QuEST_8h_source.html#l00202">QuESTEnv::numRanks</a>, and <a class="el" href="main_8cpp_source.html#l00020">QUEST_ENV</a>.</p>
</div>
</div>
<a id="ga18b791c2fe5a2c484c51879ef16fba22"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga18b791c2fe5a2c484c51879ef16fba22">◆ </a></span>TEST_CASE() <span class="overload">[29/88]</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#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">/* there is no meaningful way to test this */</span></div>
<div class="line"><a name="l00193"></a><span class="lineno"> 193</span>  SUCCEED( );</div>
<div class="line"><a name="l00194"></a><span class="lineno"> 194</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">[30/88]</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="Create a 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#l00202">202</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="l00202"></a><span class="lineno"> 202</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="comment">// must be at least one amplitude per node</span></div>
<div class="line"><a name="l00205"></a><span class="lineno"> 205</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="l00206"></a><span class="lineno"> 206</span>  <span class="keywordflow">if</span> (minNumQb == 0)</div>
<div class="line"><a name="l00207"></a><span class="lineno"> 207</span>  minNumQb = 1;</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>  SECTION( <span class="stringliteral">"correctness"</span> ) {</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">// try 10 valid number of qubits</span></div>
<div class="line"><a name="l00212"></a><span class="lineno"> 212</span>  <span class="keywordtype">int</span> numQb = GENERATE_COPY( range(minNumQb, minNumQb+10) );</div>
<div class="line"><a name="l00213"></a><span class="lineno"> 213</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="l00214"></a><span class="lineno"> 214</span>  </div>
<div class="line"><a name="l00215"></a><span class="lineno"> 215</span>  <span class="comment">// ensure elems (CPU and/or GPU) are created, and reg begins in |0></span></div>
<div class="line"><a name="l00216"></a><span class="lineno"> 216</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="l00217"></a><span class="lineno"> 217</span>  ref[0] = 1; <span class="comment">// |0></span></div>
<div class="line"><a name="l00218"></a><span class="lineno"> 218</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(reg, ref) );</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>(reg, <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 class="line"><a name="l00222"></a><span class="lineno"> 222</span>  SECTION( <span class="stringliteral">"input validation"</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>  SECTION( <span class="stringliteral">"number of qubits"</span> ) {</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>  <span class="keywordtype">int</span> numQb = GENERATE( -1, 0 );</div>
<div class="line"><a name="l00227"></a><span class="lineno"> 227</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="l00228"></a><span class="lineno"> 228</span>  }</div>
<div class="line"><a name="l00229"></a><span class="lineno"> 229</span>  SECTION( <span class="stringliteral">"number of amplitudes"</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>  <span class="comment">// use local QuESTEnv to safely modify</span></div>
<div class="line"><a name="l00232"></a><span class="lineno"> 232</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="l00233"></a><span class="lineno"> 233</span>  </div>
<div class="line"><a name="l00234"></a><span class="lineno"> 234</span>  <span class="comment">// too many amplitudes to store in type</span></div>
<div class="line"><a name="l00235"></a><span class="lineno"> 235</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="l00236"></a><span class="lineno"> 236</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="l00237"></a><span class="lineno"> 237</span>  </div>
<div class="line"><a name="l00238"></a><span class="lineno"> 238</span>  <span class="comment">// too few amplitudes to distribute</span></div>
<div class="line"><a name="l00239"></a><span class="lineno"> 239</span>  <span class="keywordtype">int</span> minQb = GENERATE( range(2,10) );</div>
<div class="line"><a name="l00240"></a><span class="lineno"> 240</span>  env.<a class="code" href="structQuESTEnv.html#af22aacd7c9905accae28484785c193b4">numRanks</a> = (int) pow(2, minQb);</div>
<div class="line"><a name="l00241"></a><span class="lineno"> 241</span>  <span class="keywordtype">int</span> numQb = GENERATE_COPY( range(1,minQb) );</div>
<div class="line"><a name="l00242"></a><span class="lineno"> 242</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="l00243"></a><span class="lineno"> 243</span>  }</div>
<div class="line"><a name="l00244"></a><span class="lineno"> 244</span>  SECTION( <span class="stringliteral">"available memory"</span> ) {</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">/* there is no reliable way to force the malloc statements to</span></div>
<div class="line"><a name="l00247"></a><span class="lineno"> 247</span> <span class="comment"> * fail, and hence trigger the matrixInit validation */</span></div>
<div class="line"><a name="l00248"></a><span class="lineno"> 248</span>  SUCCEED( );</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>  }</div>
<div class="line"><a name="l00251"></a><span class="lineno"> 251</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="QuEST__validation_8c_source.html#l00254">calcLog2()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="QuEST_8h_source.html#l00202">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">[31/88]</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#l00259">259</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="l00259"></a><span class="lineno"> 259</span>  {</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>  SECTION( <span class="stringliteral">"correctness"</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>  <span class="comment">/* there is no meaningful way to test this */</span></div>
<div class="line"><a name="l00264"></a><span class="lineno"> 264</span>  SUCCEED( );</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>  SECTION( <span class="stringliteral">"input validation"</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">"matrix not created"</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>  <span class="comment">/* this is an artificial test case since nothing in the QuEST API </span></div>
<div class="line"><a name="l00271"></a><span class="lineno"> 271</span> <span class="comment"> * automatically sets un-initialised ComplexMatrixN fields to </span></div>
<div class="line"><a name="l00272"></a><span class="lineno"> 272</span> <span class="comment"> * the NULL pointer.</span></div>
<div class="line"><a name="l00273"></a><span class="lineno"> 273</span> <span class="comment"> */</span></div>
<div class="line"><a name="l00274"></a><span class="lineno"> 274</span>  <a class="code" href="structComplexMatrixN.html">ComplexMatrixN</a> m;</div>
<div class="line"><a name="l00275"></a><span class="lineno"> 275</span>  m.<a class="code" href="structComplexMatrixN.html#a446e8a077597e4f76049d547df0c9738">real</a> = NULL;</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">/* the error message is also somewhat unrelated, but oh well </span></div>
<div class="line"><a name="l00278"></a><span class="lineno"> 278</span> <span class="comment"> */</span></div>
<div class="line"><a name="l00279"></a><span class="lineno"> 279</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="l00280"></a><span class="lineno"> 280</span>  }</div>
<div class="line"><a name="l00281"></a><span class="lineno"> 281</span>  }</div>
<div class="line"><a name="l00282"></a><span class="lineno"> 282</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l01021">destroyComplexMatrixN()</a>, and <a class="el" href="QuEST_8h_source.html#l00139">ComplexMatrixN::real</a>.</p>
</div>
</div>
<a id="gab5ca964a4d64491f3c32e7fda334a5e1"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gab5ca964a4d64491f3c32e7fda334a5e1">◆ </a></span>TEST_CASE() <span class="overload">[32/88]</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#l00290">290</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="l00290"></a><span class="lineno"> 290</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="comment">/* there is no meaningful way to test this */</span></div>
<div class="line"><a name="l00293"></a><span class="lineno"> 293</span>  SUCCEED( );</div>
<div class="line"><a name="l00294"></a><span class="lineno"> 294</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">[33/88]</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 object representing a set of qubits.">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#l00302">302</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="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>  <span class="comment">/* there is no meaningful way to test this.</span></div>
<div class="line"><a name="l00305"></a><span class="lineno"> 305</span> <span class="comment"> * We e.g. cannot check that the pointers are NULL because </span></div>
<div class="line"><a name="l00306"></a><span class="lineno"> 306</span> <span class="comment"> * they are not updated; this function passes the struct by value,</span></div>
<div class="line"><a name="l00307"></a><span class="lineno"> 307</span> <span class="comment"> * not by reference. We also cannot reliably monitor the </span></div>
<div class="line"><a name="l00308"></a><span class="lineno"> 308</span> <span class="comment"> * memory used in the heap at runtime.</span></div>
<div class="line"><a name="l00309"></a><span class="lineno"> 309</span> <span class="comment"> */</span></div>
<div class="line"><a name="l00310"></a><span class="lineno"> 310</span>  SUCCEED( );</div>
<div class="line"><a name="l00311"></a><span class="lineno"> 311</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">[34/88]</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">[35/88]</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#l00978">978</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="l00978"></a><span class="lineno"> 978</span>  {</div>
<div class="line"><a name="l00979"></a><span class="lineno"> 979</span>  </div>
<div class="line"><a name="l00980"></a><span class="lineno"> 980</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="l00981"></a><span class="lineno"> 981</span>  </div>
<div class="line"><a name="l00982"></a><span class="lineno"> 982</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l00983"></a><span class="lineno"> 983</span>  </div>
<div class="line"><a name="l00984"></a><span class="lineno"> 984</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00985"></a><span class="lineno"> 985</span>  </div>
<div class="line"><a name="l00986"></a><span class="lineno"> 986</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(vec);</div>
<div class="line"><a name="l00987"></a><span class="lineno"> 987</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="l00988"></a><span class="lineno"> 988</span>  </div>
<div class="line"><a name="l00989"></a><span class="lineno"> 989</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="l00990"></a><span class="lineno"> 990</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="l00991"></a><span class="lineno"> 991</span>  REQUIRE( <a class="code" href="group__type.html#ga3cf635d2b2e57226c8d5a777f513367e">fromComplex</a>(amp) == ref[ind] );</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>  }</div>
<div class="line"><a name="l00994"></a><span class="lineno"> 994</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</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>  SECTION( <span class="stringliteral">"state index"</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>  <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="l00999"></a><span class="lineno"> 999</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="l01000"></a><span class="lineno"> 1000</span>  }</div>
<div class="line"><a name="l01001"></a><span class="lineno"> 1001</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01002"></a><span class="lineno"> 1002</span>  </div>
<div class="line"><a name="l01003"></a><span class="lineno"> 1003</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="l01004"></a><span class="lineno"> 1004</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="l01005"></a><span class="lineno"> 1005</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="l01006"></a><span class="lineno"> 1006</span>  }</div>
<div class="line"><a name="l01007"></a><span class="lineno"> 1007</span>  }</div>
<div class="line"><a name="l01008"></a><span class="lineno"> 1008</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="l01009"></a><span class="lineno"> 1009</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l00048">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="group__type.html#ga3cf635d2b2e57226c8d5a777f513367e">fromComplex</a>, <a class="el" href="QuEST_8c_source.html#l00697">getAmp()</a>, <a class="el" href="QuEST_8c_source.html#l01057">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#l00904">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">[36/88]</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#l01017">1017</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="l01017"></a><span class="lineno"> 1017</span>  {</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>  <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="l01020"></a><span class="lineno"> 1020</span>  </div>
<div class="line"><a name="l01021"></a><span class="lineno"> 1021</span>  SECTION( <span class="stringliteral">"correctness"</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>  SECTION( <span class="stringliteral">"density-matrix"</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__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(mat);</div>
<div class="line"><a name="l01026"></a><span class="lineno"> 1026</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="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> row = GENERATE( range(0,1<<<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) );</div>
<div class="line"><a name="l01029"></a><span class="lineno"> 1029</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="l01030"></a><span class="lineno"> 1030</span>  </div>
<div class="line"><a name="l01031"></a><span class="lineno"> 1031</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="l01032"></a><span class="lineno"> 1032</span>  REQUIRE( <a class="code" href="group__type.html#ga3cf635d2b2e57226c8d5a777f513367e">fromComplex</a>(amp) == ref[row][col] );</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>  SECTION( <span class="stringliteral">"input validation"</span> ) {</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">"state index"</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>  <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="l01040"></a><span class="lineno"> 1040</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="l01041"></a><span class="lineno"> 1041</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="l01042"></a><span class="lineno"> 1042</span>  </div>
<div class="line"><a name="l01043"></a><span class="lineno"> 1043</span>  }</div>
<div class="line"><a name="l01044"></a><span class="lineno"> 1044</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</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>  <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="l01047"></a><span class="lineno"> 1047</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="l01048"></a><span class="lineno"> 1048</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="l01049"></a><span class="lineno"> 1049</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>  <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="l01052"></a><span class="lineno"> 1052</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l00048">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="group__type.html#ga3cf635d2b2e57226c8d5a777f513367e">fromComplex</a>, <a class="el" href="QuEST_8c_source.html#l00707">getDensityAmp()</a>, <a class="el" href="QuEST_8c_source.html#l01057">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#l00835">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">[37/88]</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#l01060">1060</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="l01060"></a><span class="lineno"> 1060</span>  {</div>
<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>  <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="l01063"></a><span class="lineno"> 1063</span>  </div>
<div class="line"><a name="l01064"></a><span class="lineno"> 1064</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l01065"></a><span class="lineno"> 1065</span>  </div>
<div class="line"><a name="l01066"></a><span class="lineno"> 1066</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l01067"></a><span class="lineno"> 1067</span>  </div>
<div class="line"><a name="l01068"></a><span class="lineno"> 1068</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(vec);</div>
<div class="line"><a name="l01069"></a><span class="lineno"> 1069</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="l01070"></a><span class="lineno"> 1070</span>  </div>
<div class="line"><a name="l01071"></a><span class="lineno"> 1071</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="l01072"></a><span class="lineno"> 1072</span>  REQUIRE( <a class="code" href="group__calc.html#gad575782de461d9ab0975b38cc7850f1a">getImagAmp</a>(vec,ind) == imag(ref[ind]) );</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 class="line"><a name="l01075"></a><span class="lineno"> 1075</span>  SECTION( <span class="stringliteral">"input validation"</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>  SECTION( <span class="stringliteral">"state index"</span> ) {</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="keywordtype">int</span> ind = GENERATE( -1, 1<<<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l01080"></a><span class="lineno"> 1080</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="l01081"></a><span class="lineno"> 1081</span>  }</div>
<div class="line"><a name="l01082"></a><span class="lineno"> 1082</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01083"></a><span class="lineno"> 1083</span>  </div>
<div class="line"><a name="l01084"></a><span class="lineno"> 1084</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="l01085"></a><span class="lineno"> 1085</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="l01086"></a><span class="lineno"> 1086</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="l01087"></a><span class="lineno"> 1087</span>  }</div>
<div class="line"><a name="l01088"></a><span class="lineno"> 1088</span>  }</div>
<div class="line"><a name="l01089"></a><span class="lineno"> 1089</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="l01090"></a><span class="lineno"> 1090</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l00048">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00683">getImagAmp()</a>, <a class="el" href="QuEST_8c_source.html#l01057">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#l00904">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">[38/88]</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="Get the number of probability amplitudes in a qureg object, given by 2^numQubits.">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#l01098">1098</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="l01098"></a><span class="lineno"> 1098</span>  {</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">"correctness"</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">// test >= NUM_QUBITS so as not to limit distribution size</span></div>
<div class="line"><a name="l01103"></a><span class="lineno"> 1103</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="l01104"></a><span class="lineno"> 1104</span>  </div>
<div class="line"><a name="l01105"></a><span class="lineno"> 1105</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l01106"></a><span class="lineno"> 1106</span>  </div>
<div class="line"><a name="l01107"></a><span class="lineno"> 1107</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="l01108"></a><span class="lineno"> 1108</span>  REQUIRE( <a class="code" href="group__calc.html#ga8cbe422d4981bf06847d229a4c6aa3df">getNumAmps</a>(vec) == (1<<numQb) );</div>
<div class="line"><a name="l01109"></a><span class="lineno"> 1109</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="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>  SECTION( <span class="stringliteral">"input validation"</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>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01115"></a><span class="lineno"> 1115</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="l01116"></a><span class="lineno"> 1116</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="l01117"></a><span class="lineno"> 1117</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="l01118"></a><span class="lineno"> 1118</span>  }</div>
<div class="line"><a name="l01119"></a><span class="lineno"> 1119</span>  }</div>
<div class="line"><a name="l01120"></a><span class="lineno"> 1120</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l00048">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00670">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">[39/88]</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="Get the number of qubits in a qureg object.">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#l01128">1128</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="l01128"></a><span class="lineno"> 1128</span>  {</div>
<div class="line"><a name="l01129"></a><span class="lineno"> 1129</span>  </div>
<div class="line"><a name="l01130"></a><span class="lineno"> 1130</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</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>  <span class="comment">// test >= NUM_QUBITS so as not to limit distribution size</span></div>
<div class="line"><a name="l01133"></a><span class="lineno"> 1133</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="l01134"></a><span class="lineno"> 1134</span>  </div>
<div class="line"><a name="l01135"></a><span class="lineno"> 1135</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</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>  <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="l01138"></a><span class="lineno"> 1138</span>  REQUIRE( <a class="code" href="group__calc.html#ga73036c778d800703585ab3d8796a915f">getNumQubits</a>(vec) == numQb );</div>
<div class="line"><a name="l01139"></a><span class="lineno"> 1139</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="l01140"></a><span class="lineno"> 1140</span>  }</div>
<div class="line"><a name="l01141"></a><span class="lineno"> 1141</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01142"></a><span class="lineno"> 1142</span>  </div>
<div class="line"><a name="l01143"></a><span class="lineno"> 1143</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="l01144"></a><span class="lineno"> 1144</span>  REQUIRE( <a class="code" href="group__calc.html#ga73036c778d800703585ab3d8796a915f">getNumQubits</a>(mat) == numQb );</div>
<div class="line"><a name="l01145"></a><span class="lineno"> 1145</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="l01146"></a><span class="lineno"> 1146</span>  }</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">"input validation"</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>  <span class="comment">// no validation</span></div>
<div class="line"><a name="l01151"></a><span class="lineno"> 1151</span>  SUCCEED();</div>
<div class="line"><a name="l01152"></a><span class="lineno"> 1152</span>  }</div>
<div class="line"><a name="l01153"></a><span class="lineno"> 1153</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l00048">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00666">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">[40/88]</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#l01161">1161</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="l01161"></a><span class="lineno"> 1161</span>  {</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>  <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="l01164"></a><span class="lineno"> 1164</span>  </div>
<div class="line"><a name="l01165"></a><span class="lineno"> 1165</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l01166"></a><span class="lineno"> 1166</span>  </div>
<div class="line"><a name="l01167"></a><span class="lineno"> 1167</span>  SECTION( <span class="stringliteral">"state-vector"</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>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(vec);</div>
<div class="line"><a name="l01170"></a><span class="lineno"> 1170</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="l01171"></a><span class="lineno"> 1171</span>  </div>
<div class="line"><a name="l01172"></a><span class="lineno"> 1172</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="l01173"></a><span class="lineno"> 1173</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> refCalc = pow(abs(ref[ind]), 2);</div>
<div class="line"><a name="l01174"></a><span class="lineno"> 1174</span>  REQUIRE( <a class="code" href="group__calc.html#ga4a14d22379d399760b0cfc5c8053589b">getProbAmp</a>(vec,ind) == Approx(refCalc) );</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">"input validation"</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>  SECTION( <span class="stringliteral">"state index"</span> ) {</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>  <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="l01182"></a><span class="lineno"> 1182</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="l01183"></a><span class="lineno"> 1183</span>  }</div>
<div class="line"><a name="l01184"></a><span class="lineno"> 1184</span>  SECTION( <span class="stringliteral">"density-matrix"</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>  <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="l01187"></a><span class="lineno"> 1187</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="l01188"></a><span class="lineno"> 1188</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="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>  <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="l01192"></a><span class="lineno"> 1192</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l00048">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00690">getProbAmp()</a>, <a class="el" href="QuEST_8c_source.html#l01057">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#l00904">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">[41/88]</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#l01200">1200</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="l01200"></a><span class="lineno"> 1200</span>  {</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>  <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="l01203"></a><span class="lineno"> 1203</span>  </div>
<div class="line"><a name="l01204"></a><span class="lineno"> 1204</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</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>  SECTION( <span class="stringliteral">"state-vector"</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>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(vec);</div>
<div class="line"><a name="l01209"></a><span class="lineno"> 1209</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="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> ind = GENERATE( range(0,1<<<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) );</div>
<div class="line"><a name="l01212"></a><span class="lineno"> 1212</span>  REQUIRE( <a class="code" href="group__calc.html#ga1416145280c62c5dd5ec9bed89b4cd05">getRealAmp</a>(vec,ind) == real(ref[ind]) );</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>  }</div>
<div class="line"><a name="l01215"></a><span class="lineno"> 1215</span>  SECTION( <span class="stringliteral">"input validation"</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>  SECTION( <span class="stringliteral">"state index"</span> ) {</div>
<div class="line"><a name="l01218"></a><span class="lineno"> 1218</span>  </div>
<div class="line"><a name="l01219"></a><span class="lineno"> 1219</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="l01220"></a><span class="lineno"> 1220</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="l01221"></a><span class="lineno"> 1221</span>  }</div>
<div class="line"><a name="l01222"></a><span class="lineno"> 1222</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01223"></a><span class="lineno"> 1223</span>  </div>
<div class="line"><a name="l01224"></a><span class="lineno"> 1224</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="l01225"></a><span class="lineno"> 1225</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="l01226"></a><span class="lineno"> 1226</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="l01227"></a><span class="lineno"> 1227</span>  }</div>
<div class="line"><a name="l01228"></a><span class="lineno"> 1228</span>  }</div>
<div class="line"><a name="l01229"></a><span class="lineno"> 1229</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="l01230"></a><span class="lineno"> 1230</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="QuEST_8c_source.html#l00048">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00676">getRealAmp()</a>, <a class="el" href="QuEST_8c_source.html#l01057">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#l00904">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">[42/88]</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">[43/88]</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#ga2f3bec8d06e7bf7314c581a5b837641f" 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#l00812">812</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="l00812"></a><span class="lineno"> 812</span>  {</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>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l00815"></a><span class="lineno"> 815</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> a = 1/sqrt(2);</div>
<div class="line"><a name="l00816"></a><span class="lineno"> 816</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op{{a,a},{a,-a}};</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">"correctness"</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>  <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="l00821"></a><span class="lineno"> 821</span>  </div>
<div class="line"><a name="l00822"></a><span class="lineno"> 822</span>  SECTION( <span class="stringliteral">"state-vector "</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>  <a class="code" href="group__unitary.html#ga2f3bec8d06e7bf7314c581a5b837641f">hadamard</a>(quregVec, target);</div>
<div class="line"><a name="l00825"></a><span class="lineno"> 825</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, target, op);</div>
<div class="line"><a name="l00826"></a><span class="lineno"> 826</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l00827"></a><span class="lineno"> 827</span>  }</div>
<div class="line"><a name="l00828"></a><span class="lineno"> 828</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</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>  <a class="code" href="group__unitary.html#ga2f3bec8d06e7bf7314c581a5b837641f">hadamard</a>(quregMatr, target);</div>
<div class="line"><a name="l00831"></a><span class="lineno"> 831</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, target, op);</div>
<div class="line"><a name="l00832"></a><span class="lineno"> 832</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 10*REAL_EPS) );</div>
<div class="line"><a name="l00833"></a><span class="lineno"> 833</span>  }</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>  SECTION( <span class="stringliteral">"input validation"</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">"qubit indices"</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>  <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="l00840"></a><span class="lineno"> 840</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga2f3bec8d06e7bf7314c581a5b837641f">hadamard</a>(quregVec, target), Contains(<span class="stringliteral">"Invalid target"</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>  }</div>
<div class="line"><a name="l00843"></a><span class="lineno"> 843</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l00844"></a><span class="lineno"> 844</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l00175">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">[44/88]</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#l00387">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00048">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00143">getZeroMatrix()</a>, <a class="el" href="QuEST_8c_source.html#l00117">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">[45/88]</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 a set of qubits to the classical state (also known as a "computational basis state") with...">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#l00387">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00048">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00143">getZeroMatrix()</a>, <a class="el" href="QuEST_8c_source.html#l00132">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">[46/88]</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#l00319">319</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="l00319"></a><span class="lineno"> 319</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>  <span class="comment">/* use of this function is illegal in C++ */</span></div>
<div class="line"><a name="l00322"></a><span class="lineno"> 322</span>  SUCCEED( );</div>
<div class="line"><a name="l00323"></a><span class="lineno"> 323</span> }</div>
</div><!-- fragment -->
</div>
</div>
<a id="gaf2260af68bc6f547784bc900602ef5fe"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaf2260af68bc6f547784bc900602ef5fe">◆ </a></span>TEST_CASE() <span class="overload">[47/88]</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 a set of qubits to the plus state (and similarly for density matrices).">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#l00387">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00048">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00143">getZeroMatrix()</a>, <a class="el" href="QuEST_8c_source.html#l00123">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">[48/88]</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 a set of qubits, which can be a state vector or density matrix, to a given pure state.">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#l00387">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00048">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00143">getZeroMatrix()</a>, <a class="el" href="QuEST_8c_source.html#l00117">initBlankState()</a>, <a class="el" href="QuEST_8c_source.html#l01057">initDebugState()</a>, <a class="el" href="QuEST_8c_source.html#l00143">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#l00904">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">[49/88]</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 the complete statevector.">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>  </div>
<div class="line"><a name="l00290"></a><span class="lineno"> 290</span>  SECTION( <span class="stringliteral">"correctness"</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>  SECTION( <span class="stringliteral">"state-vector"</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>  <span class="comment">// create arbitrary (but distinctly non-zero) amplitudes</span></div>
<div class="line"><a name="l00295"></a><span class="lineno"> 295</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="l00296"></a><span class="lineno"> 296</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="l00297"></a><span class="lineno"> 297</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> vecRef = <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="l00298"></a><span class="lineno"> 298</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<vec.<a class="code" href="structQureg.html#adef4935cac95763c29164cf99b144ed4">numAmpsTotal</a>; i++) {</div>
<div class="line"><a name="l00299"></a><span class="lineno"> 299</span>  ampsRe[i] = 2*i;</div>
<div class="line"><a name="l00300"></a><span class="lineno"> 300</span>  ampsIm[i] = 2*i + 1;</div>
<div class="line"><a name="l00301"></a><span class="lineno"> 301</span>  vecRef[i] = (ampsRe[i]) + 1i*(ampsIm[i]);</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>  </div>
<div class="line"><a name="l00304"></a><span class="lineno"> 304</span>  <a class="code" href="group__init.html#gada7230491a50cd409f8b00f5ee1db953">initBlankState</a>(vec);</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>  }</div>
<div class="line"><a name="l00309"></a><span class="lineno"> 309</span>  SECTION( <span class="stringliteral">"input validation"</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>  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="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="l00314"></a><span class="lineno"> 314</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__init.html#ga4589960486ec43dcd63bd985f1c4f398">initStateFromAmps</a>(mat, NULL, NULL), Contains(<span class="stringliteral">"valid only for state-vectors"</span>) );</div>
<div class="line"><a name="l00315"></a><span class="lineno"> 315</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="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>  <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="l00319"></a><span class="lineno"> 319</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00048">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00117">initBlankState()</a>, <a class="el" href="QuEST_8c_source.html#l00155">initStateFromAmps()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="QuEST_8h_source.html#l00172">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">[50/88]</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 a set of qubits to the classical 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#l00327">327</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="l00327"></a><span class="lineno"> 327</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>  <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="l00330"></a><span class="lineno"> 330</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="l00331"></a><span class="lineno"> 331</span>  </div>
<div class="line"><a name="l00332"></a><span class="lineno"> 332</span>  SECTION( <span class="stringliteral">"correctness"</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>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</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>  <a class="code" href="group__init.html#gada7230491a50cd409f8b00f5ee1db953">initBlankState</a>(vec);</div>
<div class="line"><a name="l00337"></a><span class="lineno"> 337</span>  <a class="code" href="group__init.html#ga2f049055d4a51d0ea4d1a43b5234dedb">initZeroState</a>(vec);</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>  <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="l00340"></a><span class="lineno"> 340</span>  refVec[0] = 1;</div>
<div class="line"><a name="l00341"></a><span class="lineno"> 341</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vec, refVec) );</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>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</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>  <a class="code" href="group__init.html#gada7230491a50cd409f8b00f5ee1db953">initBlankState</a>(mat);</div>
<div class="line"><a name="l00346"></a><span class="lineno"> 346</span>  <a class="code" href="group__init.html#ga2f049055d4a51d0ea4d1a43b5234dedb">initZeroState</a>(mat);</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#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="l00349"></a><span class="lineno"> 349</span>  refMat[0][0] = 1;</div>
<div class="line"><a name="l00350"></a><span class="lineno"> 350</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(mat, refMat) );</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>  }</div>
<div class="line"><a name="l00353"></a><span class="lineno"> 353</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</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>  <span class="comment">// no input validation </span></div>
<div class="line"><a name="l00356"></a><span class="lineno"> 356</span>  SUCCEED( );</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__type.html#ga8e1e6ad3254892edc2ee08712ea9d692">destroyQureg</a>(vec, <a class="code" href="main_8cpp.html#a718130cc1fc36cde991aff3d4c85c47d">QUEST_ENV</a>);</div>
<div class="line"><a name="l00359"></a><span class="lineno"> 359</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="l00360"></a><span class="lineno"> 360</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00048">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00143">getZeroMatrix()</a>, <a class="el" href="QuEST_8c_source.html#l00117">initBlankState()</a>, <a class="el" href="QuEST_8c_source.html#l00111">initZeroState()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="QuEST_8h_source.html#l00172">Qureg::numAmpsTotal</a>, <a class="el" href="QuEST_8h_source.html#l00165">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">[51/88]</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#l00387">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00048">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00457">getRandomDensityMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00453">getRandomStateVector()</a>, <a class="el" href="QuEST_8c_source.html#l00756">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#l00946">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">[52/88]</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#l00387">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00048">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00457">getRandomDensityMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00453">getRandomStateVector()</a>, <a class="el" href="QuEST_8c_source.html#l00743">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#l00946">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">[53/88]</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#ga3e39405eb2ce05ce4bb88c0f00dace45" 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#ga3e39405eb2ce05ce4bb88c0f00dace45">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#ga3e39405eb2ce05ce4bb88c0f00dace45">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#ga3e39405eb2ce05ce4bb88c0f00dace45">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#ga3e39405eb2ce05ce4bb88c0f00dace45">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#ga3e39405eb2ce05ce4bb88c0f00dace45">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#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00410">getRandomReal()</a>, <a class="el" href="QuEST_8c_source.html#l00935">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">[54/88]</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#l00387">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00048">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="QuEST_8c_source.html#l01057">initDebugState()</a>, <a class="el" href="QuEST_8c_source.html#l00770">mixDensityMatrix()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="QuEST_8h_source.html#l00165">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#l00835">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">[55/88]</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#ga91edd6320f517810a58afd4b845edf12" 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#ga91edd6320f517810a58afd4b845edf12">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#ga91edd6320f517810a58afd4b845edf12">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#ga91edd6320f517810a58afd4b845edf12">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#ga91edd6320f517810a58afd4b845edf12">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#ga91edd6320f517810a58afd4b845edf12">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#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00410">getRandomReal()</a>, <a class="el" href="QuEST_8c_source.html#l00902">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">[56/88]</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#ga556fe013915bca4626367d98db948f5e" 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#ga556fe013915bca4626367d98db948f5e">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,-1i},{1i,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#ga556fe013915bca4626367d98db948f5e">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#ga556fe013915bca4626367d98db948f5e">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#ga556fe013915bca4626367d98db948f5e">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#ga556fe013915bca4626367d98db948f5e">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#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00410">getRandomReal()</a>, <a class="el" href="QuEST_8c_source.html#l00924">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#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">[57/88]</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#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00533">getRandomKrausMap()</a>, <a class="el" href="utilities_8cpp_source.html#l00143">getZeroMatrix()</a>, <a class="el" href="QuEST_8c_source.html#l00966">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#l00116">ComplexMatrix2::real</a>, and <a class="el" href="utilities_8cpp_source.html#l00812">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">[58/88]</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#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="QuEST__validation_8c_source.html#l00254">calcLog2()</a>, <a class="el" href="QuEST_8c_source.html#l01000">createComplexMatrixN()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l01021">destroyComplexMatrixN()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00533">getRandomKrausMap()</a>, <a class="el" href="utilities_8cpp_source.html#l00143">getZeroMatrix()</a>, <a class="el" href="QuEST_8c_source.html#l00986">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#l00139">ComplexMatrixN::real</a>, <a class="el" href="utilities_8cpp_source.html#l01074">sublists()</a>, and <a class="el" href="utilities_8cpp_source.html#l00824">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">[59/88]</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,-1i},{1i,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#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00410">getRandomReal()</a>, <a class="el" href="QuEST_8c_source.html#l00955">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#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">[60/88]</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#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00410">getRandomReal()</a>, <a class="el" href="QuEST_8c_source.html#l00912">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">[61/88]</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,-1i},{1i,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#ga50616e813b0d0aa4f8220785d780cdff">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#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00169">getKroneckerProduct()</a>, <a class="el" href="utilities_8cpp_source.html#l00410">getRandomReal()</a>, <a class="el" href="QuEST_8c_source.html#l00943">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#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">[62/88]</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#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00533">getRandomKrausMap()</a>, <a class="el" href="utilities_8cpp_source.html#l00143">getZeroMatrix()</a>, <a class="el" href="QuEST_8c_source.html#l00976">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#l00127">ComplexMatrix4::real</a>, and <a class="el" href="utilities_8cpp_source.html#l00818">toComplexMatrix4()</a>.</p>
</div>
</div>
<a id="ga4a7295ff2f6ab9b0569da7a4f34056fc"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga4a7295ff2f6ab9b0569da7a4f34056fc">◆ </a></span>TEST_CASE() <span class="overload">[63/88]</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#gadad71b27575fd7d9baf110ff780ee0a1" 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#l00852">852</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="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>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</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>  <span class="comment">// figure out max-num targs (inclusive) allowed by hardware backend</span></div>
<div class="line"><a name="l00857"></a><span class="lineno"> 857</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="l00858"></a><span class="lineno"> 858</span>  <span class="keywordflow">if</span> (maxNumTargs >= <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>)</div>
<div class="line"><a name="l00859"></a><span class="lineno"> 859</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="l00860"></a><span class="lineno"> 860</span>  </div>
<div class="line"><a name="l00861"></a><span class="lineno"> 861</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</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>  <span class="comment">// try all possible numbers of targets and controls</span></div>
<div class="line"><a name="l00864"></a><span class="lineno"> 864</span>  <span class="keywordtype">int</span> numTargs = GENERATE_COPY( range(1,maxNumTargs+1) );</div>
<div class="line"><a name="l00865"></a><span class="lineno"> 865</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="l00866"></a><span class="lineno"> 866</span>  <span class="keywordtype">int</span> numCtrls = GENERATE_COPY( range(1,maxNumCtrls+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>  <span class="comment">// generate all possible valid qubit arrangements</span></div>
<div class="line"><a name="l00869"></a><span class="lineno"> 869</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="l00870"></a><span class="lineno"> 870</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="l00871"></a><span class="lineno"> 871</span>  </div>
<div class="line"><a name="l00872"></a><span class="lineno"> 872</span>  <span class="comment">// for each qubit arrangement, use a new random unitary</span></div>
<div class="line"><a name="l00873"></a><span class="lineno"> 873</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="l00874"></a><span class="lineno"> 874</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="l00875"></a><span class="lineno"> 875</span>  <a class="code" href="group__testutilities.html#ga7f83695bea7d0332a577bca017dbb03c">toComplexMatrixN</a>(op, matr);</div>
<div class="line"><a name="l00876"></a><span class="lineno"> 876</span>  </div>
<div class="line"><a name="l00877"></a><span class="lineno"> 877</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00878"></a><span class="lineno"> 878</span>  </div>
<div class="line"><a name="l00879"></a><span class="lineno"> 879</span>  <a class="code" href="group__unitary.html#gadad71b27575fd7d9baf110ff780ee0a1">multiControlledMultiQubitUnitary</a>(quregVec, ctrls, numCtrls, targs, numTargs, matr);</div>
<div class="line"><a name="l00880"></a><span class="lineno"> 880</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, ctrls, numCtrls, targs, numTargs, op);</div>
<div class="line"><a name="l00881"></a><span class="lineno"> 881</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</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>  SECTION( <span class="stringliteral">"density-matrix"</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="group__unitary.html#gadad71b27575fd7d9baf110ff780ee0a1">multiControlledMultiQubitUnitary</a>(quregMatr, ctrls, numCtrls, targs, numTargs, matr);</div>
<div class="line"><a name="l00886"></a><span class="lineno"> 886</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, ctrls, numCtrls, targs, numTargs, op);</div>
<div class="line"><a name="l00887"></a><span class="lineno"> 887</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 10*REAL_EPS) );</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>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</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">"input validation"</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>  SECTION( <span class="stringliteral">"number of targets"</span> ) {</div>
<div class="line"><a name="l00894"></a><span class="lineno"> 894</span>  </div>
<div class="line"><a name="l00895"></a><span class="lineno"> 895</span>  <span class="comment">// there cannot be more targets than qubits in register</span></div>
<div class="line"><a name="l00896"></a><span class="lineno"> 896</span>  <span class="comment">// (numTargs=NUM_QUBITS is caught elsewhere, because that implies ctrls are invalid)</span></div>
<div class="line"><a name="l00897"></a><span class="lineno"> 897</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="l00898"></a><span class="lineno"> 898</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="l00899"></a><span class="lineno"> 899</span>  <span class="keywordtype">int</span> ctrls[] = {0};</div>
<div class="line"><a name="l00900"></a><span class="lineno"> 900</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="l00901"></a><span class="lineno"> 901</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="l00902"></a><span class="lineno"> 902</span>  </div>
<div class="line"><a name="l00903"></a><span class="lineno"> 903</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gadad71b27575fd7d9baf110ff780ee0a1">multiControlledMultiQubitUnitary</a>(quregVec, ctrls, 1, targs, numTargs, matr), Contains(<span class="stringliteral">"Invalid number of target"</span>));</div>
<div class="line"><a name="l00904"></a><span class="lineno"> 904</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</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>  SECTION( <span class="stringliteral">"repetition in targets"</span> ) {</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">int</span> ctrls[] = {0};</div>
<div class="line"><a name="l00909"></a><span class="lineno"> 909</span>  <span class="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l00910"></a><span class="lineno"> 910</span>  <span class="keywordtype">int</span> targs[] = {1,2,2};</div>
<div class="line"><a name="l00911"></a><span class="lineno"> 911</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="l00912"></a><span class="lineno"> 912</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="l00913"></a><span class="lineno"> 913</span>  </div>
<div class="line"><a name="l00914"></a><span class="lineno"> 914</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gadad71b27575fd7d9baf110ff780ee0a1">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="l00915"></a><span class="lineno"> 915</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l00916"></a><span class="lineno"> 916</span>  }</div>
<div class="line"><a name="l00917"></a><span class="lineno"> 917</span>  SECTION( <span class="stringliteral">"number of controls"</span> ) {</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>  <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="l00920"></a><span class="lineno"> 920</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="l00921"></a><span class="lineno"> 921</span>  <span class="keywordtype">int</span> targs[1] = {0};</div>
<div class="line"><a name="l00922"></a><span class="lineno"> 922</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="l00923"></a><span class="lineno"> 923</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="l00924"></a><span class="lineno"> 924</span>  </div>
<div class="line"><a name="l00925"></a><span class="lineno"> 925</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gadad71b27575fd7d9baf110ff780ee0a1">multiControlledMultiQubitUnitary</a>(quregVec, ctrls, numCtrls, targs, 1, matr), Contains(<span class="stringliteral">"Invalid number of control"</span>));</div>
<div class="line"><a name="l00926"></a><span class="lineno"> 926</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</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>  SECTION( <span class="stringliteral">"repetition in controls"</span> ) {</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>  <span class="keywordtype">int</span> ctrls[] = {0,1,1};</div>
<div class="line"><a name="l00931"></a><span class="lineno"> 931</span>  <span class="keywordtype">int</span> targs[] = {3};</div>
<div class="line"><a name="l00932"></a><span class="lineno"> 932</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="l00933"></a><span class="lineno"> 933</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="l00934"></a><span class="lineno"> 934</span>  </div>
<div class="line"><a name="l00935"></a><span class="lineno"> 935</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gadad71b27575fd7d9baf110ff780ee0a1">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="l00936"></a><span class="lineno"> 936</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</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">"control and target collision"</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> ctrls[] = {0,1,2};</div>
<div class="line"><a name="l00941"></a><span class="lineno"> 941</span>  <span class="keywordtype">int</span> targs[] = {3,1,4};</div>
<div class="line"><a name="l00942"></a><span class="lineno"> 942</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="l00943"></a><span class="lineno"> 943</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="l00944"></a><span class="lineno"> 944</span>  </div>
<div class="line"><a name="l00945"></a><span class="lineno"> 945</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gadad71b27575fd7d9baf110ff780ee0a1">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="l00946"></a><span class="lineno"> 946</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</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>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l00949"></a><span class="lineno"> 949</span>  </div>
<div class="line"><a name="l00950"></a><span class="lineno"> 950</span>  <span class="comment">// valid inds</span></div>
<div class="line"><a name="l00951"></a><span class="lineno"> 951</span>  <span class="keywordtype">int</span> numQb = 2;</div>
<div class="line"><a name="l00952"></a><span class="lineno"> 952</span>  <span class="keywordtype">int</span> qb1[2] = {0,1};</div>
<div class="line"><a name="l00953"></a><span class="lineno"> 953</span>  <span class="keywordtype">int</span> qb2[2] = {2,3};</div>
<div class="line"><a name="l00954"></a><span class="lineno"> 954</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="l00955"></a><span class="lineno"> 955</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="l00956"></a><span class="lineno"> 956</span>  </div>
<div class="line"><a name="l00957"></a><span class="lineno"> 957</span>  <span class="comment">// make qb1 invalid</span></div>
<div class="line"><a name="l00958"></a><span class="lineno"> 958</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="l00959"></a><span class="lineno"> 959</span>  qb1[GENERATE_COPY(range(0,numQb))] = inv;</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>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gadad71b27575fd7d9baf110ff780ee0a1">multiControlledMultiQubitUnitary</a>(quregVec, qb1, numQb, qb2, numQb, matr), Contains(<span class="stringliteral">"Invalid control"</span>) );</div>
<div class="line"><a name="l00962"></a><span class="lineno"> 962</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gadad71b27575fd7d9baf110ff780ee0a1">multiControlledMultiQubitUnitary</a>(quregVec, qb2, numQb, qb1, numQb, matr), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l00963"></a><span class="lineno"> 963</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l00964"></a><span class="lineno"> 964</span>  }</div>
<div class="line"><a name="l00965"></a><span class="lineno"> 965</span>  SECTION( <span class="stringliteral">"unitarity"</span> ) {</div>
<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>  <span class="keywordtype">int</span> ctrls[1] = {0};</div>
<div class="line"><a name="l00968"></a><span class="lineno"> 968</span>  <span class="keywordtype">int</span> numTargs = GENERATE_COPY( range(1,maxNumTargs+1) );</div>
<div class="line"><a name="l00969"></a><span class="lineno"> 969</span>  <span class="keywordtype">int</span> targs[numTargs];</div>
<div class="line"><a name="l00970"></a><span class="lineno"> 970</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numTargs; i++)</div>
<div class="line"><a name="l00971"></a><span class="lineno"> 971</span>  targs[i] = i+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>  <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="l00974"></a><span class="lineno"> 974</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gadad71b27575fd7d9baf110ff780ee0a1">multiControlledMultiQubitUnitary</a>(quregVec, ctrls, 1, targs, numTargs, matr), Contains(<span class="stringliteral">"unitary"</span>) );</div>
<div class="line"><a name="l00975"></a><span class="lineno"> 975</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</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">"unitary creation"</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> ctrls[1] = {0};</div>
<div class="line"><a name="l00980"></a><span class="lineno"> 980</span>  <span class="keywordtype">int</span> targs[3] = {1,2,3};</div>
<div class="line"><a name="l00981"></a><span class="lineno"> 981</span>  </div>
<div class="line"><a name="l00982"></a><span class="lineno"> 982</span>  <span class="comment">/* compilers don't auto-initialise to NULL; the below circumstance </span></div>
<div class="line"><a name="l00983"></a><span class="lineno"> 983</span> <span class="comment"> * only really occurs when 'malloc' returns NULL in createComplexMatrixN, </span></div>
<div class="line"><a name="l00984"></a><span class="lineno"> 984</span> <span class="comment"> * which actually triggers its own validation. Hence this test is useless </span></div>
<div class="line"><a name="l00985"></a><span class="lineno"> 985</span> <span class="comment"> * currently.</span></div>
<div class="line"><a name="l00986"></a><span class="lineno"> 986</span> <span class="comment"> */</span></div>
<div class="line"><a name="l00987"></a><span class="lineno"> 987</span>  <a class="code" href="structComplexMatrixN.html">ComplexMatrixN</a> matr;</div>
<div class="line"><a name="l00988"></a><span class="lineno"> 988</span>  matr.<a class="code" href="structComplexMatrixN.html#a446e8a077597e4f76049d547df0c9738">real</a> = NULL;</div>
<div class="line"><a name="l00989"></a><span class="lineno"> 989</span>  matr.<a class="code" href="structComplexMatrixN.html#afde13e469a3b4f179f45e53d1ec0a7cf">imag</a> = NULL; </div>
<div class="line"><a name="l00990"></a><span class="lineno"> 990</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gadad71b27575fd7d9baf110ff780ee0a1">multiControlledMultiQubitUnitary</a>(quregVec, ctrls, 1, targs, 3, matr), Contains(<span class="stringliteral">"created"</span>) );</div>
<div class="line"><a name="l00991"></a><span class="lineno"> 991</span>  }</div>
<div class="line"><a name="l00992"></a><span class="lineno"> 992</span>  SECTION( <span class="stringliteral">"unitary dimensions"</span> ) {</div>
<div class="line"><a name="l00993"></a><span class="lineno"> 993</span>  </div>
<div class="line"><a name="l00994"></a><span class="lineno"> 994</span>  <span class="keywordtype">int</span> ctrls[1] = {0};</div>
<div class="line"><a name="l00995"></a><span class="lineno"> 995</span>  <span class="keywordtype">int</span> targs[2] = {1,2};</div>
<div class="line"><a name="l00996"></a><span class="lineno"> 996</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="l00997"></a><span class="lineno"> 997</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="l00998"></a><span class="lineno"> 998</span>  </div>
<div class="line"><a name="l00999"></a><span class="lineno"> 999</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gadad71b27575fd7d9baf110ff780ee0a1">multiControlledMultiQubitUnitary</a>(quregVec, ctrls, 1, targs, 2, matr), Contains(<span class="stringliteral">"matrix size"</span>));</div>
<div class="line"><a name="l01000"></a><span class="lineno"> 1000</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</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>  SECTION( <span class="stringliteral">"unitary fits in node"</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>  <span class="comment">// pretend we have a very limited distributed memory (judged by matr size)</span></div>
<div class="line"><a name="l01005"></a><span class="lineno"> 1005</span>  quregVec.numAmpsPerChunk = 1;</div>
<div class="line"><a name="l01006"></a><span class="lineno"> 1006</span>  <span class="keywordtype">int</span> ctrls[1] = {0};</div>
<div class="line"><a name="l01007"></a><span class="lineno"> 1007</span>  <span class="keywordtype">int</span> targs[2] = {1,2};</div>
<div class="line"><a name="l01008"></a><span class="lineno"> 1008</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="l01009"></a><span class="lineno"> 1009</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="l01010"></a><span class="lineno"> 1010</span>  </div>
<div class="line"><a name="l01011"></a><span class="lineno"> 1011</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gadad71b27575fd7d9baf110ff780ee0a1">multiControlledMultiQubitUnitary</a>(quregVec, ctrls, 1, targs, 2, matr), Contains(<span class="stringliteral">"targets too many qubits"</span>));</div>
<div class="line"><a name="l01012"></a><span class="lineno"> 1012</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l01013"></a><span class="lineno"> 1013</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>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l01016"></a><span class="lineno"> 1016</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="QuEST__validation_8c_source.html#l00254">calcLog2()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l01000">createComplexMatrixN()</a>, <a class="el" href="QuEST_8c_source.html#l01021">destroyComplexMatrixN()</a>, <a class="el" href="utilities_8cpp_source.html#l00485">getRandomUnitary()</a>, <a class="el" href="QuEST_8h_source.html#l00140">ComplexMatrixN::imag</a>, <a class="el" href="QuEST_8c_source.html#l00329">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#l00139">ComplexMatrixN::real</a>, <a class="el" href="utilities_8cpp_source.html#l01074">sublists()</a>, and <a class="el" href="utilities_8cpp_source.html#l00824">toComplexMatrixN()</a>.</p>
</div>
</div>
<a id="gac41ea931fcc90e931b0ca2bf98cd9dd0"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gac41ea931fcc90e931b0ca2bf98cd9dd0">◆ </a></span>TEST_CASE() <span class="overload">[64/88]</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#l01024">1024</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="l01024"></a><span class="lineno"> 1024</span>  {</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>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</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="comment">// acts on the final control qubit</span></div>
<div class="line"><a name="l01029"></a><span class="lineno"> 1029</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op{{1,0},{0,-1}};</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>  SECTION( <span class="stringliteral">"correctness"</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>  <span class="comment">// generate ALL valid qubit arrangements</span></div>
<div class="line"><a name="l01034"></a><span class="lineno"> 1034</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="l01035"></a><span class="lineno"> 1035</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="l01036"></a><span class="lineno"> 1036</span>  </div>
<div class="line"><a name="l01037"></a><span class="lineno"> 1037</span>  SECTION( <span class="stringliteral">"state-vector"</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__unitary.html#gad76781842af56821ed4e223bd776f057">multiControlledPhaseFlip</a>(quregVec, ctrls, numCtrls);</div>
<div class="line"><a name="l01040"></a><span class="lineno"> 1040</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="l01041"></a><span class="lineno"> 1041</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</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>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</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>  <a class="code" href="group__unitary.html#gad76781842af56821ed4e223bd776f057">multiControlledPhaseFlip</a>(quregMatr, ctrls, numCtrls);</div>
<div class="line"><a name="l01046"></a><span class="lineno"> 1046</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="l01047"></a><span class="lineno"> 1047</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</div>
<div class="line"><a name="l01048"></a><span class="lineno"> 1048</span>  }</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>  SECTION( <span class="stringliteral">"input validation"</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>  SECTION( <span class="stringliteral">"number of controls"</span> ) {</div>
<div class="line"><a name="l01053"></a><span class="lineno"> 1053</span>  </div>
<div class="line"><a name="l01054"></a><span class="lineno"> 1054</span>  <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="l01055"></a><span class="lineno"> 1055</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="l01056"></a><span class="lineno"> 1056</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="l01057"></a><span class="lineno"> 1057</span>  }</div>
<div class="line"><a name="l01058"></a><span class="lineno"> 1058</span>  SECTION( <span class="stringliteral">"repetition of controls"</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="keywordtype">int</span> numCtrls = 3;</div>
<div class="line"><a name="l01061"></a><span class="lineno"> 1061</span>  <span class="keywordtype">int</span> ctrls[] = {0,1,1};</div>
<div class="line"><a name="l01062"></a><span class="lineno"> 1062</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="l01063"></a><span class="lineno"> 1063</span>  }</div>
<div class="line"><a name="l01064"></a><span class="lineno"> 1064</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l01065"></a><span class="lineno"> 1065</span>  </div>
<div class="line"><a name="l01066"></a><span class="lineno"> 1066</span>  <span class="keywordtype">int</span> numCtrls = 3;</div>
<div class="line"><a name="l01067"></a><span class="lineno"> 1067</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="l01068"></a><span class="lineno"> 1068</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="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="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l01072"></a><span class="lineno"> 1072</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l00559">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#l01074">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">[65/88]</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#l01080">1080</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="l01080"></a><span class="lineno"> 1080</span>  {</div>
<div class="line"><a name="l01081"></a><span class="lineno"> 1081</span>  </div>
<div class="line"><a name="l01082"></a><span class="lineno"> 1082</span>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l01083"></a><span class="lineno"> 1083</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> param = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-2*M_PI, 2*M_PI);</div>
<div class="line"><a name="l01084"></a><span class="lineno"> 1084</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="l01085"></a><span class="lineno"> 1085</span>  </div>
<div class="line"><a name="l01086"></a><span class="lineno"> 1086</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</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>  <span class="comment">// generate ALL valid qubit arrangements</span></div>
<div class="line"><a name="l01089"></a><span class="lineno"> 1089</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="l01090"></a><span class="lineno"> 1090</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="l01091"></a><span class="lineno"> 1091</span>  </div>
<div class="line"><a name="l01092"></a><span class="lineno"> 1092</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</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>  <a class="code" href="group__unitary.html#ga0832e39058d913ad47af44e97a854446">multiControlledPhaseShift</a>(quregVec, ctrls, numCtrls, param);</div>
<div class="line"><a name="l01095"></a><span class="lineno"> 1095</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="l01096"></a><span class="lineno"> 1096</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l01097"></a><span class="lineno"> 1097</span>  }</div>
<div class="line"><a name="l01098"></a><span class="lineno"> 1098</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</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>  <a class="code" href="group__unitary.html#ga0832e39058d913ad47af44e97a854446">multiControlledPhaseShift</a>(quregMatr, ctrls, numCtrls, param);</div>
<div class="line"><a name="l01101"></a><span class="lineno"> 1101</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="l01102"></a><span class="lineno"> 1102</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</div>
<div class="line"><a name="l01103"></a><span class="lineno"> 1103</span>  }</div>
<div class="line"><a name="l01104"></a><span class="lineno"> 1104</span>  }</div>
<div class="line"><a name="l01105"></a><span class="lineno"> 1105</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l01106"></a><span class="lineno"> 1106</span>  </div>
<div class="line"><a name="l01107"></a><span class="lineno"> 1107</span>  SECTION( <span class="stringliteral">"number of controls"</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>  <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="l01110"></a><span class="lineno"> 1110</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="l01111"></a><span class="lineno"> 1111</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="l01112"></a><span class="lineno"> 1112</span>  }</div>
<div class="line"><a name="l01113"></a><span class="lineno"> 1113</span>  SECTION( <span class="stringliteral">"repetition of controls"</span> ) {</div>
<div class="line"><a name="l01114"></a><span class="lineno"> 1114</span>  </div>
<div class="line"><a name="l01115"></a><span class="lineno"> 1115</span>  <span class="keywordtype">int</span> numCtrls = 3;</div>
<div class="line"><a name="l01116"></a><span class="lineno"> 1116</span>  <span class="keywordtype">int</span> ctrls[] = {0,1,1};</div>
<div class="line"><a name="l01117"></a><span class="lineno"> 1117</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="l01118"></a><span class="lineno"> 1118</span>  }</div>
<div class="line"><a name="l01119"></a><span class="lineno"> 1119</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</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="keywordtype">int</span> numCtrls = 3;</div>
<div class="line"><a name="l01122"></a><span class="lineno"> 1122</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="l01123"></a><span class="lineno"> 1123</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="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>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l01127"></a><span class="lineno"> 1127</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00406">expI()</a>, <a class="el" href="utilities_8cpp_source.html#l00410">getRandomReal()</a>, <a class="el" href="QuEST_8c_source.html#l00509">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#l01074">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">[66/88]</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#ga4183dc6cb8fd996fb790a711bf3e4871" 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#l01135">1135</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="l01135"></a><span class="lineno"> 1135</span>  {</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>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</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">// in distributed mode, each node must be able to fit all amps modified by unitary </span></div>
<div class="line"><a name="l01140"></a><span class="lineno"> 1140</span>  REQUIRE( quregVec.numAmpsPerChunk >= 4 );</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>  <span class="comment">// every test will use a unique random matrix</span></div>
<div class="line"><a name="l01143"></a><span class="lineno"> 1143</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="l01144"></a><span class="lineno"> 1144</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="l01145"></a><span class="lineno"> 1145</span>  </div>
<div class="line"><a name="l01146"></a><span class="lineno"> 1146</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</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>  <span class="comment">// generate ALL valid qubit arrangements</span></div>
<div class="line"><a name="l01149"></a><span class="lineno"> 1149</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="l01150"></a><span class="lineno"> 1150</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="l01151"></a><span class="lineno"> 1151</span>  <span class="keywordtype">int</span> targs[] = {targ1, targ2};</div>
<div class="line"><a name="l01152"></a><span class="lineno"> 1152</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="l01153"></a><span class="lineno"> 1153</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="l01154"></a><span class="lineno"> 1154</span>  </div>
<div class="line"><a name="l01155"></a><span class="lineno"> 1155</span>  SECTION( <span class="stringliteral">"state-vector"</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>  <a class="code" href="group__unitary.html#ga4183dc6cb8fd996fb790a711bf3e4871">multiControlledTwoQubitUnitary</a>(quregVec, ctrls, numCtrls, targ1, targ2, matr);</div>
<div class="line"><a name="l01158"></a><span class="lineno"> 1158</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, ctrls, numCtrls, targ1, targ2, op);</div>
<div class="line"><a name="l01159"></a><span class="lineno"> 1159</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l01160"></a><span class="lineno"> 1160</span>  }</div>
<div class="line"><a name="l01161"></a><span class="lineno"> 1161</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</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>  <a class="code" href="group__unitary.html#ga4183dc6cb8fd996fb790a711bf3e4871">multiControlledTwoQubitUnitary</a>(quregMatr, ctrls, numCtrls, targ1, targ2, matr);</div>
<div class="line"><a name="l01164"></a><span class="lineno"> 1164</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, ctrls, numCtrls, targ1, targ2, op);</div>
<div class="line"><a name="l01165"></a><span class="lineno"> 1165</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 10*REAL_EPS) );</div>
<div class="line"><a name="l01166"></a><span class="lineno"> 1166</span>  }</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>  SECTION( <span class="stringliteral">"input validation"</span> ) {</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">"number of controls"</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>  <span class="comment">// numCtrls=(NUM_QUBITS-1) is ok since requires ctrl qubit inds are invalid</span></div>
<div class="line"><a name="l01173"></a><span class="lineno"> 1173</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="l01174"></a><span class="lineno"> 1174</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="l01175"></a><span class="lineno"> 1175</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga4183dc6cb8fd996fb790a711bf3e4871">multiControlledTwoQubitUnitary</a>(quregVec, ctrls, numCtrls, 0, 1, matr), Contains(<span class="stringliteral">"Invalid number of control"</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">"repetition of controls"</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="keywordtype">int</span> numCtrls = 3;</div>
<div class="line"><a name="l01180"></a><span class="lineno"> 1180</span>  <span class="keywordtype">int</span> ctrls[] = {0,1,1};</div>
<div class="line"><a name="l01181"></a><span class="lineno"> 1181</span>  <span class="keywordtype">int</span> targ1 = 2;</div>
<div class="line"><a name="l01182"></a><span class="lineno"> 1182</span>  <span class="keywordtype">int</span> targ2 = 3;</div>
<div class="line"><a name="l01183"></a><span class="lineno"> 1183</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga4183dc6cb8fd996fb790a711bf3e4871">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="l01184"></a><span class="lineno"> 1184</span>  }</div>
<div class="line"><a name="l01185"></a><span class="lineno"> 1185</span>  SECTION( <span class="stringliteral">"repetition of targets"</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>  <span class="keywordtype">int</span> numCtrls = 3;</div>
<div class="line"><a name="l01188"></a><span class="lineno"> 1188</span>  <span class="keywordtype">int</span> ctrls[] = {0,1,2};</div>
<div class="line"><a name="l01189"></a><span class="lineno"> 1189</span>  <span class="keywordtype">int</span> targ1 = 3;</div>
<div class="line"><a name="l01190"></a><span class="lineno"> 1190</span>  <span class="keywordtype">int</span> targ2 = targ1;</div>
<div class="line"><a name="l01191"></a><span class="lineno"> 1191</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga4183dc6cb8fd996fb790a711bf3e4871">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="l01192"></a><span class="lineno"> 1192</span>  }</div>
<div class="line"><a name="l01193"></a><span class="lineno"> 1193</span>  SECTION( <span class="stringliteral">"control and target collision"</span> ) {</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>  <span class="keywordtype">int</span> numCtrls = 3;</div>
<div class="line"><a name="l01196"></a><span class="lineno"> 1196</span>  <span class="keywordtype">int</span> ctrls[] = {0,1,2};</div>
<div class="line"><a name="l01197"></a><span class="lineno"> 1197</span>  <span class="keywordtype">int</span> targ1 = 3;</div>
<div class="line"><a name="l01198"></a><span class="lineno"> 1198</span>  <span class="keywordtype">int</span> targ2 = ctrls[GENERATE_COPY( range(0,numCtrls) )];</div>
<div class="line"><a name="l01199"></a><span class="lineno"> 1199</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga4183dc6cb8fd996fb790a711bf3e4871">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="l01200"></a><span class="lineno"> 1200</span>  }</div>
<div class="line"><a name="l01201"></a><span class="lineno"> 1201</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l01202"></a><span class="lineno"> 1202</span>  </div>
<div class="line"><a name="l01203"></a><span class="lineno"> 1203</span>  <span class="comment">// valid indices</span></div>
<div class="line"><a name="l01204"></a><span class="lineno"> 1204</span>  <span class="keywordtype">int</span> targ1 = 0;</div>
<div class="line"><a name="l01205"></a><span class="lineno"> 1205</span>  <span class="keywordtype">int</span> targ2 = 1;</div>
<div class="line"><a name="l01206"></a><span class="lineno"> 1206</span>  <span class="keywordtype">int</span> numCtrls = 3;</div>
<div class="line"><a name="l01207"></a><span class="lineno"> 1207</span>  <span class="keywordtype">int</span> ctrls[] = { 2, 3, 4 };</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="keywordtype">int</span> inv = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l01210"></a><span class="lineno"> 1210</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga4183dc6cb8fd996fb790a711bf3e4871">multiControlledTwoQubitUnitary</a>(quregVec, ctrls, numCtrls, inv, targ2, matr), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l01211"></a><span class="lineno"> 1211</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga4183dc6cb8fd996fb790a711bf3e4871">multiControlledTwoQubitUnitary</a>(quregVec, ctrls, numCtrls, targ1, inv, matr), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l01212"></a><span class="lineno"> 1212</span>  </div>
<div class="line"><a name="l01213"></a><span class="lineno"> 1213</span>  ctrls[numCtrls-1] = inv; <span class="comment">// make ctrls invalid </span></div>
<div class="line"><a name="l01214"></a><span class="lineno"> 1214</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga4183dc6cb8fd996fb790a711bf3e4871">multiControlledTwoQubitUnitary</a>(quregVec, ctrls, numCtrls, targ1, targ2, matr), Contains(<span class="stringliteral">"Invalid control"</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>  SECTION( <span class="stringliteral">"unitarity "</span> ) {</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="keywordtype">int</span> ctrls[1] = {0};</div>
<div class="line"><a name="l01219"></a><span class="lineno"> 1219</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="l01220"></a><span class="lineno"> 1220</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga4183dc6cb8fd996fb790a711bf3e4871">multiControlledTwoQubitUnitary</a>(quregVec, ctrls, 1, 1, 2, matr), Contains(<span class="stringliteral">"unitary"</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>  SECTION( <span class="stringliteral">"unitary fits in node"</span> ) {</div>
<div class="line"><a name="l01223"></a><span class="lineno"> 1223</span>  </div>
<div class="line"><a name="l01224"></a><span class="lineno"> 1224</span>  <span class="comment">// pretend we have a very limited distributed memory</span></div>
<div class="line"><a name="l01225"></a><span class="lineno"> 1225</span>  quregVec.numAmpsPerChunk = 1;</div>
<div class="line"><a name="l01226"></a><span class="lineno"> 1226</span>  <span class="keywordtype">int</span> ctrls[1] = {0};</div>
<div class="line"><a name="l01227"></a><span class="lineno"> 1227</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga4183dc6cb8fd996fb790a711bf3e4871">multiControlledTwoQubitUnitary</a>(quregVec, ctrls, 1, 1, 2, matr), Contains(<span class="stringliteral">"targets too many qubits"</span>));</div>
<div class="line"><a name="l01228"></a><span class="lineno"> 1228</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>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l01231"></a><span class="lineno"> 1231</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00485">getRandomUnitary()</a>, <a class="el" href="QuEST_8c_source.html#l00281">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#l00127">ComplexMatrix4::real</a>, <a class="el" href="utilities_8cpp_source.html#l01074">sublists()</a>, and <a class="el" href="utilities_8cpp_source.html#l00818">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">[67/88]</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#ga18c44cb3b947147951590dea2f6b25f7" 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#l01239">1239</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="l01239"></a><span class="lineno"> 1239</span>  {</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>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</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>  <span class="comment">// every test will use a unique random matrix</span></div>
<div class="line"><a name="l01244"></a><span class="lineno"> 1244</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="l01245"></a><span class="lineno"> 1245</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="l01246"></a><span class="lineno"> 1246</span>  </div>
<div class="line"><a name="l01247"></a><span class="lineno"> 1247</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l01248"></a><span class="lineno"> 1248</span>  </div>
<div class="line"><a name="l01249"></a><span class="lineno"> 1249</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="l01250"></a><span class="lineno"> 1250</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="l01251"></a><span class="lineno"> 1251</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="l01252"></a><span class="lineno"> 1252</span>  </div>
<div class="line"><a name="l01253"></a><span class="lineno"> 1253</span>  SECTION( <span class="stringliteral">"state-vector"</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>  <a class="code" href="group__unitary.html#ga18c44cb3b947147951590dea2f6b25f7">multiControlledUnitary</a>(quregVec, ctrls, numCtrls, target, matr);</div>
<div class="line"><a name="l01256"></a><span class="lineno"> 1256</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, ctrls, numCtrls, target, op);</div>
<div class="line"><a name="l01257"></a><span class="lineno"> 1257</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</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>  SECTION( <span class="stringliteral">"density-matrix"</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>  <a class="code" href="group__unitary.html#ga18c44cb3b947147951590dea2f6b25f7">multiControlledUnitary</a>(quregMatr, ctrls, numCtrls, target, matr);</div>
<div class="line"><a name="l01262"></a><span class="lineno"> 1262</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, ctrls, numCtrls, target, op);</div>
<div class="line"><a name="l01263"></a><span class="lineno"> 1263</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 10*REAL_EPS) );</div>
<div class="line"><a name="l01264"></a><span class="lineno"> 1264</span>  }</div>
<div class="line"><a name="l01265"></a><span class="lineno"> 1265</span>  }</div>
<div class="line"><a name="l01266"></a><span class="lineno"> 1266</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l01267"></a><span class="lineno"> 1267</span>  </div>
<div class="line"><a name="l01268"></a><span class="lineno"> 1268</span>  SECTION( <span class="stringliteral">"number of controls"</span> ) {</div>
<div class="line"><a name="l01269"></a><span class="lineno"> 1269</span>  </div>
<div class="line"><a name="l01270"></a><span class="lineno"> 1270</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="l01271"></a><span class="lineno"> 1271</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="l01272"></a><span class="lineno"> 1272</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga18c44cb3b947147951590dea2f6b25f7">multiControlledUnitary</a>(quregVec, ctrls, numCtrls, 0, matr), Contains(<span class="stringliteral">"Invalid number of control"</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>  SECTION( <span class="stringliteral">"repetition of controls"</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>  <span class="keywordtype">int</span> ctrls[] = {0,1,1};</div>
<div class="line"><a name="l01277"></a><span class="lineno"> 1277</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga18c44cb3b947147951590dea2f6b25f7">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="l01278"></a><span class="lineno"> 1278</span>  }</div>
<div class="line"><a name="l01279"></a><span class="lineno"> 1279</span>  SECTION( <span class="stringliteral">"control and target collision"</span> ) {</div>
<div class="line"><a name="l01280"></a><span class="lineno"> 1280</span>  </div>
<div class="line"><a name="l01281"></a><span class="lineno"> 1281</span>  <span class="keywordtype">int</span> ctrls[] = {0,1,2};</div>
<div class="line"><a name="l01282"></a><span class="lineno"> 1282</span>  <span class="keywordtype">int</span> targ = ctrls[GENERATE( range(0,3) )];</div>
<div class="line"><a name="l01283"></a><span class="lineno"> 1283</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga18c44cb3b947147951590dea2f6b25f7">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="l01284"></a><span class="lineno"> 1284</span>  }</div>
<div class="line"><a name="l01285"></a><span class="lineno"> 1285</span>  SECTION( <span class="stringliteral">"qubit indices"</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>  <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="l01288"></a><span class="lineno"> 1288</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga18c44cb3b947147951590dea2f6b25f7">multiControlledUnitary</a>(quregVec, ctrls, 3, 0, matr), Contains(<span class="stringliteral">"Invalid control"</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>  ctrls[2] = 3; <span class="comment">// make ctrls valid </span></div>
<div class="line"><a name="l01291"></a><span class="lineno"> 1291</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="l01292"></a><span class="lineno"> 1292</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga18c44cb3b947147951590dea2f6b25f7">multiControlledUnitary</a>(quregVec, ctrls, 3, targ, matr), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l01293"></a><span class="lineno"> 1293</span>  }</div>
<div class="line"><a name="l01294"></a><span class="lineno"> 1294</span>  SECTION( <span class="stringliteral">"unitarity"</span> ) {</div>
<div class="line"><a name="l01295"></a><span class="lineno"> 1295</span>  </div>
<div class="line"><a name="l01296"></a><span class="lineno"> 1296</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="l01297"></a><span class="lineno"> 1297</span>  <span class="keywordtype">int</span> ctrls[] = {0};</div>
<div class="line"><a name="l01298"></a><span class="lineno"> 1298</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga18c44cb3b947147951590dea2f6b25f7">multiControlledUnitary</a>(quregVec, ctrls, 1, 1, matr), Contains(<span class="stringliteral">"unitary"</span>) );</div>
<div class="line"><a name="l01299"></a><span class="lineno"> 1299</span>  }</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>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l01302"></a><span class="lineno"> 1302</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00485">getRandomUnitary()</a>, <a class="el" href="QuEST_8c_source.html#l00372">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#l00116">ComplexMatrix2::real</a>, <a class="el" href="utilities_8cpp_source.html#l01074">sublists()</a>, and <a class="el" href="utilities_8cpp_source.html#l00812">toComplexMatrix2()</a>.</p>
</div>
</div>
<a id="gaf396e2e9e1e995adfb30947201c23590"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaf396e2e9e1e995adfb30947201c23590">◆ </a></span>TEST_CASE() <span class="overload">[68/88]</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#gab5828a9f0518951451d9fec9370199ae" 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#l01310">1310</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="l01310"></a><span class="lineno"> 1310</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="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</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="comment">// figure out max-num (inclusive) targs allowed by hardware backend</span></div>
<div class="line"><a name="l01315"></a><span class="lineno"> 1315</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="l01316"></a><span class="lineno"> 1316</span>  </div>
<div class="line"><a name="l01317"></a><span class="lineno"> 1317</span>  SECTION( <span class="stringliteral">"correctness"</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>  <span class="comment">// generate all possible qubit arrangements</span></div>
<div class="line"><a name="l01320"></a><span class="lineno"> 1320</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="l01321"></a><span class="lineno"> 1321</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="l01322"></a><span class="lineno"> 1322</span>  </div>
<div class="line"><a name="l01323"></a><span class="lineno"> 1323</span>  <span class="comment">// for each qubit arrangement, use a new random unitary</span></div>
<div class="line"><a name="l01324"></a><span class="lineno"> 1324</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="l01325"></a><span class="lineno"> 1325</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="l01326"></a><span class="lineno"> 1326</span>  <a class="code" href="group__testutilities.html#ga7f83695bea7d0332a577bca017dbb03c">toComplexMatrixN</a>(op, matr);</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>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l01329"></a><span class="lineno"> 1329</span>  </div>
<div class="line"><a name="l01330"></a><span class="lineno"> 1330</span>  <a class="code" href="group__unitary.html#gab5828a9f0518951451d9fec9370199ae">multiQubitUnitary</a>(quregVec, targs, numTargs, matr);</div>
<div class="line"><a name="l01331"></a><span class="lineno"> 1331</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, targs, numTargs, op);</div>
<div class="line"><a name="l01332"></a><span class="lineno"> 1332</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l01333"></a><span class="lineno"> 1333</span>  }</div>
<div class="line"><a name="l01334"></a><span class="lineno"> 1334</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01335"></a><span class="lineno"> 1335</span>  </div>
<div class="line"><a name="l01336"></a><span class="lineno"> 1336</span>  <a class="code" href="group__unitary.html#gab5828a9f0518951451d9fec9370199ae">multiQubitUnitary</a>(quregMatr, targs, numTargs, matr);</div>
<div class="line"><a name="l01337"></a><span class="lineno"> 1337</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, targs, numTargs, op);</div>
<div class="line"><a name="l01338"></a><span class="lineno"> 1338</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 10*REAL_EPS) );</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="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</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">"input validation"</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>  SECTION( <span class="stringliteral">"number of targets"</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>  <span class="comment">// there cannot be more targets than qubits in register</span></div>
<div class="line"><a name="l01347"></a><span class="lineno"> 1347</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="l01348"></a><span class="lineno"> 1348</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="l01349"></a><span class="lineno"> 1349</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="l01350"></a><span class="lineno"> 1350</span>  </div>
<div class="line"><a name="l01351"></a><span class="lineno"> 1351</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gab5828a9f0518951451d9fec9370199ae">multiQubitUnitary</a>(quregVec, targs, numTargs, matr), Contains(<span class="stringliteral">"Invalid number of target"</span>));</div>
<div class="line"><a name="l01352"></a><span class="lineno"> 1352</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l01353"></a><span class="lineno"> 1353</span>  }</div>
<div class="line"><a name="l01354"></a><span class="lineno"> 1354</span>  SECTION( <span class="stringliteral">"repetition in targets"</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>  <span class="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l01357"></a><span class="lineno"> 1357</span>  <span class="keywordtype">int</span> targs[] = {1,2,2};</div>
<div class="line"><a name="l01358"></a><span class="lineno"> 1358</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="l01359"></a><span class="lineno"> 1359</span>  </div>
<div class="line"><a name="l01360"></a><span class="lineno"> 1360</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gab5828a9f0518951451d9fec9370199ae">multiQubitUnitary</a>(quregVec, targs, numTargs, matr), Contains(<span class="stringliteral">"target"</span>) && Contains(<span class="stringliteral">"unique"</span>));</div>
<div class="line"><a name="l01361"></a><span class="lineno"> 1361</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l01362"></a><span class="lineno"> 1362</span>  }</div>
<div class="line"><a name="l01363"></a><span class="lineno"> 1363</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</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> numTargs = 3;</div>
<div class="line"><a name="l01366"></a><span class="lineno"> 1366</span>  <span class="keywordtype">int</span> targs[] = {1,2,3};</div>
<div class="line"><a name="l01367"></a><span class="lineno"> 1367</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="l01368"></a><span class="lineno"> 1368</span>  </div>
<div class="line"><a name="l01369"></a><span class="lineno"> 1369</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="l01370"></a><span class="lineno"> 1370</span>  targs[GENERATE_COPY( range(0,numTargs) )] = inv; <span class="comment">// make invalid target</span></div>
<div class="line"><a name="l01371"></a><span class="lineno"> 1371</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gab5828a9f0518951451d9fec9370199ae">multiQubitUnitary</a>(quregVec, targs, numTargs, matr), Contains(<span class="stringliteral">"Invalid target"</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>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l01374"></a><span class="lineno"> 1374</span>  }</div>
<div class="line"><a name="l01375"></a><span class="lineno"> 1375</span>  SECTION( <span class="stringliteral">"unitarity"</span> ) {</div>
<div class="line"><a name="l01376"></a><span class="lineno"> 1376</span>  </div>
<div class="line"><a name="l01377"></a><span class="lineno"> 1377</span>  <span class="keywordtype">int</span> numTargs = GENERATE_COPY( range(1,maxNumTargs) );</div>
<div class="line"><a name="l01378"></a><span class="lineno"> 1378</span>  <span class="keywordtype">int</span> targs[numTargs];</div>
<div class="line"><a name="l01379"></a><span class="lineno"> 1379</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numTargs; i++)</div>
<div class="line"><a name="l01380"></a><span class="lineno"> 1380</span>  targs[i] = i+1;</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>  <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="l01383"></a><span class="lineno"> 1383</span>  </div>
<div class="line"><a name="l01384"></a><span class="lineno"> 1384</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gab5828a9f0518951451d9fec9370199ae">multiQubitUnitary</a>(quregVec, targs, numTargs, matr), Contains(<span class="stringliteral">"unitary"</span>) );</div>
<div class="line"><a name="l01385"></a><span class="lineno"> 1385</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l01386"></a><span class="lineno"> 1386</span>  }</div>
<div class="line"><a name="l01387"></a><span class="lineno"> 1387</span>  SECTION( <span class="stringliteral">"unitary creation"</span> ) {</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>  <span class="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l01390"></a><span class="lineno"> 1390</span>  <span class="keywordtype">int</span> targs[] = {1,2,3};</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>  <span class="comment">/* compilers don't auto-initialise to NULL; the below circumstance </span></div>
<div class="line"><a name="l01393"></a><span class="lineno"> 1393</span> <span class="comment"> * only really occurs when 'malloc' returns NULL in createComplexMatrixN, </span></div>
<div class="line"><a name="l01394"></a><span class="lineno"> 1394</span> <span class="comment"> * which actually triggers its own validation. Hence this test is useless </span></div>
<div class="line"><a name="l01395"></a><span class="lineno"> 1395</span> <span class="comment"> * currently.</span></div>
<div class="line"><a name="l01396"></a><span class="lineno"> 1396</span> <span class="comment"> */</span></div>
<div class="line"><a name="l01397"></a><span class="lineno"> 1397</span>  <a class="code" href="structComplexMatrixN.html">ComplexMatrixN</a> matr;</div>
<div class="line"><a name="l01398"></a><span class="lineno"> 1398</span>  matr.<a class="code" href="structComplexMatrixN.html#a446e8a077597e4f76049d547df0c9738">real</a> = NULL;</div>
<div class="line"><a name="l01399"></a><span class="lineno"> 1399</span>  matr.<a class="code" href="structComplexMatrixN.html#afde13e469a3b4f179f45e53d1ec0a7cf">imag</a> = NULL; </div>
<div class="line"><a name="l01400"></a><span class="lineno"> 1400</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gab5828a9f0518951451d9fec9370199ae">multiQubitUnitary</a>(quregVec, targs, numTargs, matr), Contains(<span class="stringliteral">"created"</span>) );</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">"unitary dimensions"</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>  <span class="keywordtype">int</span> targs[2] = {1,2};</div>
<div class="line"><a name="l01405"></a><span class="lineno"> 1405</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="l01406"></a><span class="lineno"> 1406</span>  </div>
<div class="line"><a name="l01407"></a><span class="lineno"> 1407</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gab5828a9f0518951451d9fec9370199ae">multiQubitUnitary</a>(quregVec, targs, 2, matr), Contains(<span class="stringliteral">"matrix size"</span>));</div>
<div class="line"><a name="l01408"></a><span class="lineno"> 1408</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</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>  SECTION( <span class="stringliteral">"unitary fits in node"</span> ) {</div>
<div class="line"><a name="l01411"></a><span class="lineno"> 1411</span>  </div>
<div class="line"><a name="l01412"></a><span class="lineno"> 1412</span>  <span class="comment">// pretend we have a very limited distributed memory (judged by matr size)</span></div>
<div class="line"><a name="l01413"></a><span class="lineno"> 1413</span>  quregVec.numAmpsPerChunk = 1;</div>
<div class="line"><a name="l01414"></a><span class="lineno"> 1414</span>  <span class="keywordtype">int</span> qb[] = {1,2};</div>
<div class="line"><a name="l01415"></a><span class="lineno"> 1415</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="l01416"></a><span class="lineno"> 1416</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gab5828a9f0518951451d9fec9370199ae">multiQubitUnitary</a>(quregVec, qb, 2, matr), Contains(<span class="stringliteral">"targets too many qubits"</span>));</div>
<div class="line"><a name="l01417"></a><span class="lineno"> 1417</span>  <a class="code" href="group__type.html#ga9df2f3d86be4a6e9aad481665e5e6753">destroyComplexMatrixN</a>(matr);</div>
<div class="line"><a name="l01418"></a><span class="lineno"> 1418</span>  }</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>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l01421"></a><span class="lineno"> 1421</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="QuEST__validation_8c_source.html#l00254">calcLog2()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="QuEST_8c_source.html#l01000">createComplexMatrixN()</a>, <a class="el" href="QuEST_8c_source.html#l01021">destroyComplexMatrixN()</a>, <a class="el" href="utilities_8cpp_source.html#l00485">getRandomUnitary()</a>, <a class="el" href="QuEST_8h_source.html#l00140">ComplexMatrixN::imag</a>, <a class="el" href="QuEST_8c_source.html#l00295">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#l00139">ComplexMatrixN::real</a>, <a class="el" href="utilities_8cpp_source.html#l01074">sublists()</a>, and <a class="el" href="utilities_8cpp_source.html#l00824">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">[69/88]</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 on a selected number of qubits.">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#l01429">1429</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="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>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l01432"></a><span class="lineno"> 1432</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> param = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-4*M_PI, 4*M_PI);</div>
<div class="line"><a name="l01433"></a><span class="lineno"> 1433</span>  </div>
<div class="line"><a name="l01434"></a><span class="lineno"> 1434</span>  SECTION( <span class="stringliteral">"correctness"</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>  <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="l01437"></a><span class="lineno"> 1437</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="l01438"></a><span class="lineno"> 1438</span>  </div>
<div class="line"><a name="l01439"></a><span class="lineno"> 1439</span>  <span class="comment">/* it's too expensive to try ALL Pauli sequences, via </span></div>
<div class="line"><a name="l01440"></a><span class="lineno"> 1440</span> <span class="comment"> * pauliOpType* paulis = GENERATE_COPY( pauliseqs(numTargs) );.</span></div>
<div class="line"><a name="l01441"></a><span class="lineno"> 1441</span> <span class="comment"> * Furthermore, take(10, pauliseqs(numTargs)) will try the same pauli codes.</span></div>
<div class="line"><a name="l01442"></a><span class="lineno"> 1442</span> <span class="comment"> * Hence, we instead opt to repeatedlyrandomly generate pauliseqs</span></div>
<div class="line"><a name="l01443"></a><span class="lineno"> 1443</span> <span class="comment"> */</span></div>
<div class="line"><a name="l01444"></a><span class="lineno"> 1444</span>  GENERATE( range(0,10) ); <span class="comment">// gen 10 random pauli-codes for every targs</span></div>
<div class="line"><a name="l01445"></a><span class="lineno"> 1445</span>  <a class="code" href="group__type.html#ga1c703cf89629e4e9c7023cd402d67028">pauliOpType</a> paulis[numTargs];</div>
<div class="line"><a name="l01446"></a><span class="lineno"> 1446</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numTargs; i++)</div>
<div class="line"><a name="l01447"></a><span class="lineno"> 1447</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="l01448"></a><span class="lineno"> 1448</span>  </div>
<div class="line"><a name="l01449"></a><span class="lineno"> 1449</span>  <span class="comment">// exclude identities from reference matrix exp (they apply unwanted global phase)</span></div>
<div class="line"><a name="l01450"></a><span class="lineno"> 1450</span>  <span class="keywordtype">int</span> refTargs[numTargs];</div>
<div class="line"><a name="l01451"></a><span class="lineno"> 1451</span>  <span class="keywordtype">int</span> numRefTargs = 0;</div>
<div class="line"><a name="l01452"></a><span class="lineno"> 1452</span>  </div>
<div class="line"><a name="l01453"></a><span class="lineno"> 1453</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> xMatr{{0,1},{1,0}};</div>
<div class="line"><a name="l01454"></a><span class="lineno"> 1454</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> yMatr{{0,-1i},{1i,0}};</div>
<div class="line"><a name="l01455"></a><span class="lineno"> 1455</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> zMatr{{1,0},{0,-1}};</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>  <span class="comment">// build correct reference matrix by pauli-matrix exponentiation...</span></div>
<div class="line"><a name="l01458"></a><span class="lineno"> 1458</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> pauliProd{{1}};</div>
<div class="line"><a name="l01459"></a><span class="lineno"> 1459</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numTargs; i++) {</div>
<div class="line"><a name="l01460"></a><span class="lineno"> 1460</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> fac;</div>
<div class="line"><a name="l01461"></a><span class="lineno"> 1461</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="l01462"></a><span class="lineno"> 1462</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="l01463"></a><span class="lineno"> 1463</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="l01464"></a><span class="lineno"> 1464</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="l01465"></a><span class="lineno"> 1465</span>  pauliProd = <a class="code" href="group__testutilities.html#ga50616e813b0d0aa4f8220785d780cdff">getKroneckerProduct</a>(fac, pauliProd);</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>  <span class="comment">// include this target in ref list</span></div>
<div class="line"><a name="l01468"></a><span class="lineno"> 1468</span>  refTargs[numRefTargs++] = targs[i];</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>  <span class="comment">// produces exp(-i param/2 pauliProd), unless pauliProd = I</span></div>
<div class="line"><a name="l01472"></a><span class="lineno"> 1472</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op;</div>
<div class="line"><a name="l01473"></a><span class="lineno"> 1473</span>  <span class="keywordflow">if</span> (numRefTargs > 0)</div>
<div class="line"><a name="l01474"></a><span class="lineno"> 1474</span>  op = <a class="code" href="group__testutilities.html#ga00f4feec845c019c3390898b0cc7f1ef">getExponentialOfPauliMatrix</a>(param, pauliProd);</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">"state-vector"</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#ga34aa4865c92f9aa5d898c91286c9eca5">multiRotatePauli</a>(quregVec, targs, paulis, numTargs, param);</div>
<div class="line"><a name="l01479"></a><span class="lineno"> 1479</span>  <span class="keywordflow">if</span> (numRefTargs > 0)</div>
<div class="line"><a name="l01480"></a><span class="lineno"> 1480</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, refTargs, numRefTargs, op);</div>
<div class="line"><a name="l01481"></a><span class="lineno"> 1481</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</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">"density-matrix"</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__unitary.html#ga34aa4865c92f9aa5d898c91286c9eca5">multiRotatePauli</a>(quregMatr, targs, paulis, numTargs, param);</div>
<div class="line"><a name="l01486"></a><span class="lineno"> 1486</span>  <span class="keywordflow">if</span> (numRefTargs > 0)</div>
<div class="line"><a name="l01487"></a><span class="lineno"> 1487</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, refTargs, numRefTargs, op);</div>
<div class="line"><a name="l01488"></a><span class="lineno"> 1488</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 10*REAL_EPS) );</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>  }</div>
<div class="line"><a name="l01491"></a><span class="lineno"> 1491</span>  SECTION( <span class="stringliteral">"input validation"</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>  SECTION( <span class="stringliteral">"number of targets"</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>  <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="l01496"></a><span class="lineno"> 1496</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="l01497"></a><span class="lineno"> 1497</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="l01498"></a><span class="lineno"> 1498</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="l01499"></a><span class="lineno"> 1499</span>  </div>
<div class="line"><a name="l01500"></a><span class="lineno"> 1500</span>  }</div>
<div class="line"><a name="l01501"></a><span class="lineno"> 1501</span>  SECTION( <span class="stringliteral">"repetition of targets"</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>  <span class="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l01504"></a><span class="lineno"> 1504</span>  <span class="keywordtype">int</span> targs[3] = {0, 1, 1};</div>
<div class="line"><a name="l01505"></a><span class="lineno"> 1505</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="l01506"></a><span class="lineno"> 1506</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="l01507"></a><span class="lineno"> 1507</span>  }</div>
<div class="line"><a name="l01508"></a><span class="lineno"> 1508</span>  SECTION( <span class="stringliteral">"qubit 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="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l01511"></a><span class="lineno"> 1511</span>  <span class="keywordtype">int</span> targs[3] = {0, 1, 2};</div>
<div class="line"><a name="l01512"></a><span class="lineno"> 1512</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="l01513"></a><span class="lineno"> 1513</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="l01514"></a><span class="lineno"> 1514</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="l01515"></a><span class="lineno"> 1515</span>  }</div>
<div class="line"><a name="l01516"></a><span class="lineno"> 1516</span>  SECTION( <span class="stringliteral">"pauli codes"</span> ) {</div>
<div class="line"><a name="l01517"></a><span class="lineno"> 1517</span>  <span class="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l01518"></a><span class="lineno"> 1518</span>  <span class="keywordtype">int</span> targs[3] = {0, 1, 2};</div>
<div class="line"><a name="l01519"></a><span class="lineno"> 1519</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="l01520"></a><span class="lineno"> 1520</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="l01521"></a><span class="lineno"> 1521</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="l01522"></a><span class="lineno"> 1522</span>  }</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>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l01525"></a><span class="lineno"> 1525</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00205">getExponentialOfPauliMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00169">getKroneckerProduct()</a>, <a class="el" href="utilities_8cpp_source.html#l00481">getRandomInt()</a>, <a class="el" href="utilities_8cpp_source.html#l00410">getRandomReal()</a>, <a class="el" href="QuEST_8c_source.html#l00640">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#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, and <a class="el" href="utilities_8cpp_source.html#l01074">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">[70/88]</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 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#l01533">1533</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="l01533"></a><span class="lineno"> 1533</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="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l01536"></a><span class="lineno"> 1536</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> param = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-4*M_PI, 4*M_PI);</div>
<div class="line"><a name="l01537"></a><span class="lineno"> 1537</span>  </div>
<div class="line"><a name="l01538"></a><span class="lineno"> 1538</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l01539"></a><span class="lineno"> 1539</span>  </div>
<div class="line"><a name="l01540"></a><span class="lineno"> 1540</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="l01541"></a><span class="lineno"> 1541</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="l01542"></a><span class="lineno"> 1542</span>  </div>
<div class="line"><a name="l01543"></a><span class="lineno"> 1543</span>  <span class="comment">// build correct reference matrix by diagonal-matrix exponentiation...</span></div>
<div class="line"><a name="l01544"></a><span class="lineno"> 1544</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> zMatr{{1,0},{0,-1}};</div>
<div class="line"><a name="l01545"></a><span class="lineno"> 1545</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> zProd = zMatr;</div>
<div class="line"><a name="l01546"></a><span class="lineno"> 1546</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> t=0; t<numTargs-1; t++)</div>
<div class="line"><a name="l01547"></a><span class="lineno"> 1547</span>  zProd = <a class="code" href="group__testutilities.html#ga50616e813b0d0aa4f8220785d780cdff">getKroneckerProduct</a>(zMatr, zProd); <span class="comment">// Z . Z ... Z</span></div>
<div class="line"><a name="l01548"></a><span class="lineno"> 1548</span>  </div>
<div class="line"><a name="l01549"></a><span class="lineno"> 1549</span>  <span class="comment">// (-i param/2) Z . I . Z ...</span></div>
<div class="line"><a name="l01550"></a><span class="lineno"> 1550</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> expArg = (-1i * param / 2.) *</div>
<div class="line"><a name="l01551"></a><span class="lineno"> 1551</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="l01552"></a><span class="lineno"> 1552</span>  </div>
<div class="line"><a name="l01553"></a><span class="lineno"> 1553</span>  <span class="comment">// exp( -i param/2 Z . I . Z ...)</span></div>
<div class="line"><a name="l01554"></a><span class="lineno"> 1554</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="l01555"></a><span class="lineno"> 1555</span>  </div>
<div class="line"><a name="l01556"></a><span class="lineno"> 1556</span>  <span class="comment">// all qubits to specify full operator matrix on reference structures</span></div>
<div class="line"><a name="l01557"></a><span class="lineno"> 1557</span>  <span class="keywordtype">int</span> allQubits[<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>];</div>
<div class="line"><a name="l01558"></a><span class="lineno"> 1558</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="l01559"></a><span class="lineno"> 1559</span>  allQubits[i] = i;</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>  SECTION( <span class="stringliteral">"state-vector"</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>  <a class="code" href="group__unitary.html#ga3250d0d95b5d755cad542a6a2372b894">multiRotateZ</a>(quregVec, targs, numTargs, param);</div>
<div class="line"><a name="l01564"></a><span class="lineno"> 1564</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="l01565"></a><span class="lineno"> 1565</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l01566"></a><span class="lineno"> 1566</span>  </div>
<div class="line"><a name="l01567"></a><span class="lineno"> 1567</span>  }</div>
<div class="line"><a name="l01568"></a><span class="lineno"> 1568</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01569"></a><span class="lineno"> 1569</span>  </div>
<div class="line"><a name="l01570"></a><span class="lineno"> 1570</span>  <a class="code" href="group__unitary.html#ga3250d0d95b5d755cad542a6a2372b894">multiRotateZ</a>(quregMatr, targs, numTargs, param);</div>
<div class="line"><a name="l01571"></a><span class="lineno"> 1571</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="l01572"></a><span class="lineno"> 1572</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 2*REAL_EPS) );</div>
<div class="line"><a name="l01573"></a><span class="lineno"> 1573</span>  }</div>
<div class="line"><a name="l01574"></a><span class="lineno"> 1574</span>  }</div>
<div class="line"><a name="l01575"></a><span class="lineno"> 1575</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l01576"></a><span class="lineno"> 1576</span>  </div>
<div class="line"><a name="l01577"></a><span class="lineno"> 1577</span>  SECTION( <span class="stringliteral">"number of targets"</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>  <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="l01580"></a><span class="lineno"> 1580</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="l01581"></a><span class="lineno"> 1581</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="l01582"></a><span class="lineno"> 1582</span>  </div>
<div class="line"><a name="l01583"></a><span class="lineno"> 1583</span>  }</div>
<div class="line"><a name="l01584"></a><span class="lineno"> 1584</span>  SECTION( <span class="stringliteral">"repetition of targets"</span> ) {</div>
<div class="line"><a name="l01585"></a><span class="lineno"> 1585</span>  </div>
<div class="line"><a name="l01586"></a><span class="lineno"> 1586</span>  <span class="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l01587"></a><span class="lineno"> 1587</span>  <span class="keywordtype">int</span> targs[3] = {0, 1, 1};</div>
<div class="line"><a name="l01588"></a><span class="lineno"> 1588</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="l01589"></a><span class="lineno"> 1589</span>  }</div>
<div class="line"><a name="l01590"></a><span class="lineno"> 1590</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l01591"></a><span class="lineno"> 1591</span>  </div>
<div class="line"><a name="l01592"></a><span class="lineno"> 1592</span>  <span class="keywordtype">int</span> numTargs = 3;</div>
<div class="line"><a name="l01593"></a><span class="lineno"> 1593</span>  <span class="keywordtype">int</span> targs[3] = {0, 1, 2};</div>
<div class="line"><a name="l01594"></a><span class="lineno"> 1594</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="l01595"></a><span class="lineno"> 1595</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="l01596"></a><span class="lineno"> 1596</span>  }</div>
<div class="line"><a name="l01597"></a><span class="lineno"> 1597</span>  }</div>
<div class="line"><a name="l01598"></a><span class="lineno"> 1598</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l01599"></a><span class="lineno"> 1599</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00187">getExponentialOfDiagonalMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00293">getFullOperatorMatrix()</a>, <a class="el" href="utilities_8cpp_source.html#l00169">getKroneckerProduct()</a>, <a class="el" href="utilities_8cpp_source.html#l00410">getRandomReal()</a>, <a class="el" href="QuEST_8c_source.html#l00624">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#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a>, and <a class="el" href="utilities_8cpp_source.html#l01074">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">[71/88]</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#ga09a08f98955e75d942fdc88d4dca3e33" title="Apply a general multiple-control, conditioned on a specific bit sequence, single-target unitary,...">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#l01607">1607</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="l01607"></a><span class="lineno"> 1607</span>  {</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>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l01610"></a><span class="lineno"> 1610</span>  </div>
<div class="line"><a name="l01611"></a><span class="lineno"> 1611</span>  <span class="comment">// every test will use a unique random matrix</span></div>
<div class="line"><a name="l01612"></a><span class="lineno"> 1612</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="l01613"></a><span class="lineno"> 1613</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="l01614"></a><span class="lineno"> 1614</span>  </div>
<div class="line"><a name="l01615"></a><span class="lineno"> 1615</span>  <span class="comment">// the zero-conditioned control qubits can be effected by notting before/after ctrls</span></div>
<div class="line"><a name="l01616"></a><span class="lineno"> 1616</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> notOp{{0,1},{1,0}};</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>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l01619"></a><span class="lineno"> 1619</span>  </div>
<div class="line"><a name="l01620"></a><span class="lineno"> 1620</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="l01621"></a><span class="lineno"> 1621</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="l01622"></a><span class="lineno"> 1622</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="l01623"></a><span class="lineno"> 1623</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="l01624"></a><span class="lineno"> 1624</span>  </div>
<div class="line"><a name="l01625"></a><span class="lineno"> 1625</span>  SECTION( <span class="stringliteral">"state-vector"</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>  <a class="code" href="group__unitary.html#ga09a08f98955e75d942fdc88d4dca3e33">multiStateControlledUnitary</a>(quregVec, ctrls, ctrlState, numCtrls, target, matr);</div>
<div class="line"><a name="l01628"></a><span class="lineno"> 1628</span>  </div>
<div class="line"><a name="l01629"></a><span class="lineno"> 1629</span>  <span class="comment">// simulate controlled-state by notting before & after controls</span></div>
<div class="line"><a name="l01630"></a><span class="lineno"> 1630</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numCtrls; i++)</div>
<div class="line"><a name="l01631"></a><span class="lineno"> 1631</span>  <span class="keywordflow">if</span> (ctrlState[i] == 0)</div>
<div class="line"><a name="l01632"></a><span class="lineno"> 1632</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, ctrls[i], notOp);</div>
<div class="line"><a name="l01633"></a><span class="lineno"> 1633</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, ctrls, numCtrls, target, op);</div>
<div class="line"><a name="l01634"></a><span class="lineno"> 1634</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numCtrls; i++)</div>
<div class="line"><a name="l01635"></a><span class="lineno"> 1635</span>  <span class="keywordflow">if</span> (ctrlState[i] == 0)</div>
<div class="line"><a name="l01636"></a><span class="lineno"> 1636</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, ctrls[i], notOp);</div>
<div class="line"><a name="l01637"></a><span class="lineno"> 1637</span>  </div>
<div class="line"><a name="l01638"></a><span class="lineno"> 1638</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l01639"></a><span class="lineno"> 1639</span>  }</div>
<div class="line"><a name="l01640"></a><span class="lineno"> 1640</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l01641"></a><span class="lineno"> 1641</span>  </div>
<div class="line"><a name="l01642"></a><span class="lineno"> 1642</span>  <a class="code" href="group__unitary.html#ga09a08f98955e75d942fdc88d4dca3e33">multiStateControlledUnitary</a>(quregMatr, ctrls, ctrlState, numCtrls, target, matr);</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>  <span class="comment">// simulate controlled-state by notting before & after controls</span></div>
<div class="line"><a name="l01645"></a><span class="lineno"> 1645</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numCtrls; i++)</div>
<div class="line"><a name="l01646"></a><span class="lineno"> 1646</span>  <span class="keywordflow">if</span> (ctrlState[i] == 0)</div>
<div class="line"><a name="l01647"></a><span class="lineno"> 1647</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, ctrls[i], notOp);</div>
<div class="line"><a name="l01648"></a><span class="lineno"> 1648</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, ctrls, numCtrls, target, op);</div>
<div class="line"><a name="l01649"></a><span class="lineno"> 1649</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numCtrls; i++)</div>
<div class="line"><a name="l01650"></a><span class="lineno"> 1650</span>  <span class="keywordflow">if</span> (ctrlState[i] == 0)</div>
<div class="line"><a name="l01651"></a><span class="lineno"> 1651</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, ctrls[i], notOp);</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>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 10*REAL_EPS) );</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>  }</div>
<div class="line"><a name="l01656"></a><span class="lineno"> 1656</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</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>  SECTION( <span class="stringliteral">"number of controls"</span> ) {</div>
<div class="line"><a name="l01659"></a><span class="lineno"> 1659</span>  </div>
<div class="line"><a name="l01660"></a><span class="lineno"> 1660</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="l01661"></a><span class="lineno"> 1661</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="l01662"></a><span class="lineno"> 1662</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="l01663"></a><span class="lineno"> 1663</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga09a08f98955e75d942fdc88d4dca3e33">multiStateControlledUnitary</a>(quregVec, ctrls, ctrlState, numCtrls, 0, matr), Contains(<span class="stringliteral">"Invalid number of control"</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>  SECTION( <span class="stringliteral">"repetition of controls"</span> ) {</div>
<div class="line"><a name="l01666"></a><span class="lineno"> 1666</span>  </div>
<div class="line"><a name="l01667"></a><span class="lineno"> 1667</span>  <span class="keywordtype">int</span> ctrls[] = {0,1,1};</div>
<div class="line"><a name="l01668"></a><span class="lineno"> 1668</span>  <span class="keywordtype">int</span> ctrlState[] = {0, 1, 0};</div>
<div class="line"><a name="l01669"></a><span class="lineno"> 1669</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga09a08f98955e75d942fdc88d4dca3e33">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="l01670"></a><span class="lineno"> 1670</span>  }</div>
<div class="line"><a name="l01671"></a><span class="lineno"> 1671</span>  SECTION( <span class="stringliteral">"control and target collision"</span> ) {</div>
<div class="line"><a name="l01672"></a><span class="lineno"> 1672</span>  </div>
<div class="line"><a name="l01673"></a><span class="lineno"> 1673</span>  <span class="keywordtype">int</span> ctrls[] = {0,1,2};</div>
<div class="line"><a name="l01674"></a><span class="lineno"> 1674</span>  <span class="keywordtype">int</span> ctrlState[] = {0, 1, 0};</div>
<div class="line"><a name="l01675"></a><span class="lineno"> 1675</span>  <span class="keywordtype">int</span> targ = ctrls[GENERATE( range(0,3) )];</div>
<div class="line"><a name="l01676"></a><span class="lineno"> 1676</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga09a08f98955e75d942fdc88d4dca3e33">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="l01677"></a><span class="lineno"> 1677</span>  }</div>
<div class="line"><a name="l01678"></a><span class="lineno"> 1678</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l01679"></a><span class="lineno"> 1679</span>  </div>
<div class="line"><a name="l01680"></a><span class="lineno"> 1680</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="l01681"></a><span class="lineno"> 1681</span>  <span class="keywordtype">int</span> ctrlState[] = {0, 1, 0};</div>
<div class="line"><a name="l01682"></a><span class="lineno"> 1682</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga09a08f98955e75d942fdc88d4dca3e33">multiStateControlledUnitary</a>(quregVec, ctrls, ctrlState, 3, 0, matr), Contains(<span class="stringliteral">"Invalid control"</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>  ctrls[2] = 3; <span class="comment">// make ctrls valid </span></div>
<div class="line"><a name="l01685"></a><span class="lineno"> 1685</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="l01686"></a><span class="lineno"> 1686</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga09a08f98955e75d942fdc88d4dca3e33">multiStateControlledUnitary</a>(quregVec, ctrls, ctrlState, 3, targ, matr), Contains(<span class="stringliteral">"Invalid target"</span>) );</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>  SECTION( <span class="stringliteral">"unitarity"</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>  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="l01691"></a><span class="lineno"> 1691</span>  <span class="keywordtype">int</span> ctrls[] = {0};</div>
<div class="line"><a name="l01692"></a><span class="lineno"> 1692</span>  <span class="keywordtype">int</span> ctrlState[1] = {0};</div>
<div class="line"><a name="l01693"></a><span class="lineno"> 1693</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga09a08f98955e75d942fdc88d4dca3e33">multiStateControlledUnitary</a>(quregVec, ctrls, ctrlState, 1, 1, matr), Contains(<span class="stringliteral">"unitary"</span>) );</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>  SECTION( <span class="stringliteral">"control state bits"</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">// valid qubits</span></div>
<div class="line"><a name="l01698"></a><span class="lineno"> 1698</span>  <span class="keywordtype">int</span> ctrls[] = {0, 1, 2};</div>
<div class="line"><a name="l01699"></a><span class="lineno"> 1699</span>  <span class="keywordtype">int</span> ctrlState[] = {0, 0, 0};</div>
<div class="line"><a name="l01700"></a><span class="lineno"> 1700</span>  <span class="keywordtype">int</span> targ = 3;</div>
<div class="line"><a name="l01701"></a><span class="lineno"> 1701</span>  </div>
<div class="line"><a name="l01702"></a><span class="lineno"> 1702</span>  <span class="comment">// make invalid </span></div>
<div class="line"><a name="l01703"></a><span class="lineno"> 1703</span>  ctrlState[2] = GENERATE(-1, 2);</div>
<div class="line"><a name="l01704"></a><span class="lineno"> 1704</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga09a08f98955e75d942fdc88d4dca3e33">multiStateControlledUnitary</a>(quregVec, ctrls, ctrlState, 3, targ, matr), Contains(<span class="stringliteral">"state"</span>) );</div>
<div class="line"><a name="l01705"></a><span class="lineno"> 1705</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="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l01708"></a><span class="lineno"> 1708</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="utilities_8cpp_source.html#l01143">bitsets()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00485">getRandomUnitary()</a>, <a class="el" href="QuEST_8c_source.html#l00387">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#l00116">ComplexMatrix2::real</a>, <a class="el" href="utilities_8cpp_source.html#l01074">sublists()</a>, and <a class="el" href="utilities_8cpp_source.html#l00812">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">[72/88]</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#ga84cd118c44b9d3866f56b865dbb9bd7d" 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#l01716">1716</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="l01716"></a><span class="lineno"> 1716</span>  {</div>
<div class="line"><a name="l01717"></a><span class="lineno"> 1717</span>  </div>
<div class="line"><a name="l01718"></a><span class="lineno"> 1718</span>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l01719"></a><span class="lineno"> 1719</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op{{0,1},{1,0}};</div>
<div class="line"><a name="l01720"></a><span class="lineno"> 1720</span>  </div>
<div class="line"><a name="l01721"></a><span class="lineno"> 1721</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l01722"></a><span class="lineno"> 1722</span>  </div>
<div class="line"><a name="l01723"></a><span class="lineno"> 1723</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="l01724"></a><span class="lineno"> 1724</span>  </div>
<div class="line"><a name="l01725"></a><span class="lineno"> 1725</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l01726"></a><span class="lineno"> 1726</span>  </div>
<div class="line"><a name="l01727"></a><span class="lineno"> 1727</span>  <a class="code" href="group__unitary.html#ga84cd118c44b9d3866f56b865dbb9bd7d">pauliX</a>(quregVec, target);</div>
<div class="line"><a name="l01728"></a><span class="lineno"> 1728</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, target, op);</div>
<div class="line"><a name="l01729"></a><span class="lineno"> 1729</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</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">"density-matrix correctness"</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__unitary.html#ga84cd118c44b9d3866f56b865dbb9bd7d">pauliX</a>(quregMatr, target);</div>
<div class="line"><a name="l01734"></a><span class="lineno"> 1734</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, target, op);</div>
<div class="line"><a name="l01735"></a><span class="lineno"> 1735</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</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>  }</div>
<div class="line"><a name="l01738"></a><span class="lineno"> 1738</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l01739"></a><span class="lineno"> 1739</span>  </div>
<div class="line"><a name="l01740"></a><span class="lineno"> 1740</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l01741"></a><span class="lineno"> 1741</span>  </div>
<div class="line"><a name="l01742"></a><span class="lineno"> 1742</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="l01743"></a><span class="lineno"> 1743</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga84cd118c44b9d3866f56b865dbb9bd7d">pauliX</a>(quregVec, target), 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#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">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#l00431">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">[73/88]</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#gaa064fcf40fd02b21f98a9a83dc6cea13" 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#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>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op{{0,-1i},{1i,0}};</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">"correctness"</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>  <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="l01763"></a><span class="lineno"> 1763</span>  </div>
<div class="line"><a name="l01764"></a><span class="lineno"> 1764</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</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>  <a class="code" href="group__unitary.html#gaa064fcf40fd02b21f98a9a83dc6cea13">pauliY</a>(quregVec, target);</div>
<div class="line"><a name="l01767"></a><span class="lineno"> 1767</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, target, op);</div>
<div class="line"><a name="l01768"></a><span class="lineno"> 1768</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l01769"></a><span class="lineno"> 1769</span>  }</div>
<div class="line"><a name="l01770"></a><span class="lineno"> 1770</span>  SECTION( <span class="stringliteral">"density-matrix correctness"</span> ) {</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>  <a class="code" href="group__unitary.html#gaa064fcf40fd02b21f98a9a83dc6cea13">pauliY</a>(quregMatr, target);</div>
<div class="line"><a name="l01773"></a><span class="lineno"> 1773</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, target, op);</div>
<div class="line"><a name="l01774"></a><span class="lineno"> 1774</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</div>
<div class="line"><a name="l01775"></a><span class="lineno"> 1775</span>  }</div>
<div class="line"><a name="l01776"></a><span class="lineno"> 1776</span>  }</div>
<div class="line"><a name="l01777"></a><span class="lineno"> 1777</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</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">"qubit indices"</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>  <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="l01782"></a><span class="lineno"> 1782</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gaa064fcf40fd02b21f98a9a83dc6cea13">pauliY</a>(quregVec, target), Contains(<span class="stringliteral">"Invalid target"</span>) );</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="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l01786"></a><span class="lineno"> 1786</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">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#l00442">pauliY()</a>, and <a class="el" href="test__unitaries_8cpp_source.html#l00024">PREPARE_TEST</a>.</p>
</div>
</div>
<a id="ga25a1ad7cfce5d2dcf4365bc107aeeb6c"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga25a1ad7cfce5d2dcf4365bc107aeeb6c">◆ </a></span>TEST_CASE() <span class="overload">[74/88]</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#gadf988ee16f38ddaf404552c41ea2b745" 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#l01794">1794</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="l01794"></a><span class="lineno"> 1794</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="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l01797"></a><span class="lineno"> 1797</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op{{1,0},{0,-1}};</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">"correctness"</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> target = GENERATE( range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) );</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>  SECTION( <span class="stringliteral">"state-vector"</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>  <a class="code" href="group__unitary.html#gadf988ee16f38ddaf404552c41ea2b745">pauliZ</a>(quregVec, target);</div>
<div class="line"><a name="l01806"></a><span class="lineno"> 1806</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, target, op);</div>
<div class="line"><a name="l01807"></a><span class="lineno"> 1807</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</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>  SECTION( <span class="stringliteral">"density-matrix correctness"</span> ) {</div>
<div class="line"><a name="l01810"></a><span class="lineno"> 1810</span>  </div>
<div class="line"><a name="l01811"></a><span class="lineno"> 1811</span>  <a class="code" href="group__unitary.html#gadf988ee16f38ddaf404552c41ea2b745">pauliZ</a>(quregMatr, target);</div>
<div class="line"><a name="l01812"></a><span class="lineno"> 1812</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, target, op);</div>
<div class="line"><a name="l01813"></a><span class="lineno"> 1813</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</div>
<div class="line"><a name="l01814"></a><span class="lineno"> 1814</span>  }</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>  SECTION( <span class="stringliteral">"input validation"</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>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</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>  <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="l01821"></a><span class="lineno"> 1821</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gadf988ee16f38ddaf404552c41ea2b745">pauliZ</a>(quregVec, target), Contains(<span class="stringliteral">"Invalid target"</span>) );</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>  }</div>
<div class="line"><a name="l01824"></a><span class="lineno"> 1824</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l01825"></a><span class="lineno"> 1825</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">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#l00453">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">[75/88]</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#ga05c7b8c9491410215e277ea83c0dfef8" 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#l01833">1833</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="l01833"></a><span class="lineno"> 1833</span>  {</div>
<div class="line"><a name="l01834"></a><span class="lineno"> 1834</span>  </div>
<div class="line"><a name="l01835"></a><span class="lineno"> 1835</span>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l01836"></a><span class="lineno"> 1836</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> param = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-2*M_PI, 2*M_PI);</div>
<div class="line"><a name="l01837"></a><span class="lineno"> 1837</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="l01838"></a><span class="lineno"> 1838</span>  </div>
<div class="line"><a name="l01839"></a><span class="lineno"> 1839</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l01840"></a><span class="lineno"> 1840</span>  </div>
<div class="line"><a name="l01841"></a><span class="lineno"> 1841</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="l01842"></a><span class="lineno"> 1842</span>  </div>
<div class="line"><a name="l01843"></a><span class="lineno"> 1843</span>  SECTION( <span class="stringliteral">"state-vector "</span>) {</div>
<div class="line"><a name="l01844"></a><span class="lineno"> 1844</span>  </div>
<div class="line"><a name="l01845"></a><span class="lineno"> 1845</span>  <a class="code" href="group__unitary.html#ga05c7b8c9491410215e277ea83c0dfef8">phaseShift</a>(quregVec, target, param);</div>
<div class="line"><a name="l01846"></a><span class="lineno"> 1846</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, target, op);</div>
<div class="line"><a name="l01847"></a><span class="lineno"> 1847</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</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">"density-matrix"</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>  <a class="code" href="group__unitary.html#ga05c7b8c9491410215e277ea83c0dfef8">phaseShift</a>(quregMatr, target, param);</div>
<div class="line"><a name="l01852"></a><span class="lineno"> 1852</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, target, op);</div>
<div class="line"><a name="l01853"></a><span class="lineno"> 1853</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</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>  }</div>
<div class="line"><a name="l01856"></a><span class="lineno"> 1856</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l01857"></a><span class="lineno"> 1857</span>  </div>
<div class="line"><a name="l01858"></a><span class="lineno"> 1858</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l01859"></a><span class="lineno"> 1859</span>  </div>
<div class="line"><a name="l01860"></a><span class="lineno"> 1860</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="l01861"></a><span class="lineno"> 1861</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga05c7b8c9491410215e277ea83c0dfef8">phaseShift</a>(quregVec, target, param), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l01862"></a><span class="lineno"> 1862</span>  }</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>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l01865"></a><span class="lineno"> 1865</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00406">expI()</a>, <a class="el" href="utilities_8cpp_source.html#l00410">getRandomReal()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="QuEST_8c_source.html#l00486">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">[76/88]</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#gac5c485fe330636966effc0642ba2bd99" 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#l01873">1873</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="l01873"></a><span class="lineno"> 1873</span>  {</div>
<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>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l01876"></a><span class="lineno"> 1876</span>  </div>
<div class="line"><a name="l01877"></a><span class="lineno"> 1877</span>  <span class="comment">// each test will use a random parameter and axis vector </span></div>
<div class="line"><a name="l01878"></a><span class="lineno"> 1878</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> param = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-4*M_PI, 4*M_PI);</div>
<div class="line"><a name="l01879"></a><span class="lineno"> 1879</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="l01880"></a><span class="lineno"> 1880</span>  </div>
<div class="line"><a name="l01881"></a><span class="lineno"> 1881</span>  <span class="comment">// Rn(a) = cos(a/2)I - i sin(a/2) n . paulivector</span></div>
<div class="line"><a name="l01882"></a><span class="lineno"> 1882</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="l01883"></a><span class="lineno"> 1883</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> c = cos(param/2);</div>
<div class="line"><a name="l01884"></a><span class="lineno"> 1884</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> s = sin(param/2);</div>
<div class="line"><a name="l01885"></a><span class="lineno"> 1885</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="l01886"></a><span class="lineno"> 1886</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op{{c - 1i*vec.<a class="code" href="structVector.html#ab33976d8fda2e44b770f71269d698a25">z</a>*s/m, -(vec.<a class="code" href="structVector.html#abc3cfc6c8e297b1153a373d84b981e6b">y</a> + 1i*vec.<a class="code" href="structVector.html#a0d0459a5b731ac5fb3dff2c6134e6e88">x</a>)*s/m}, </div>
<div class="line"><a name="l01887"></a><span class="lineno"> 1887</span>  {(vec.<a class="code" href="structVector.html#abc3cfc6c8e297b1153a373d84b981e6b">y</a> - 1i*vec.<a class="code" href="structVector.html#a0d0459a5b731ac5fb3dff2c6134e6e88">x</a>)*s/m, c + 1i*vec.<a class="code" href="structVector.html#ab33976d8fda2e44b770f71269d698a25">z</a>*s/m}};</div>
<div class="line"><a name="l01888"></a><span class="lineno"> 1888</span>  </div>
<div class="line"><a name="l01889"></a><span class="lineno"> 1889</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l01890"></a><span class="lineno"> 1890</span>  </div>
<div class="line"><a name="l01891"></a><span class="lineno"> 1891</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="l01892"></a><span class="lineno"> 1892</span>  </div>
<div class="line"><a name="l01893"></a><span class="lineno"> 1893</span>  SECTION( <span class="stringliteral">"state-vector "</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>  <a class="code" href="group__unitary.html#gac5c485fe330636966effc0642ba2bd99">rotateAroundAxis</a>(quregVec, target, param, vec);</div>
<div class="line"><a name="l01896"></a><span class="lineno"> 1896</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, target, op);</div>
<div class="line"><a name="l01897"></a><span class="lineno"> 1897</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l01898"></a><span class="lineno"> 1898</span>  }</div>
<div class="line"><a name="l01899"></a><span class="lineno"> 1899</span>  SECTION( <span class="stringliteral">"density-matrix"</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>  <a class="code" href="group__unitary.html#gac5c485fe330636966effc0642ba2bd99">rotateAroundAxis</a>(quregMatr, target, param, vec);</div>
<div class="line"><a name="l01902"></a><span class="lineno"> 1902</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, target, op);</div>
<div class="line"><a name="l01903"></a><span class="lineno"> 1903</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 10*REAL_EPS) );</div>
<div class="line"><a name="l01904"></a><span class="lineno"> 1904</span>  }</div>
<div class="line"><a name="l01905"></a><span class="lineno"> 1905</span>  }</div>
<div class="line"><a name="l01906"></a><span class="lineno"> 1906</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l01907"></a><span class="lineno"> 1907</span>  </div>
<div class="line"><a name="l01908"></a><span class="lineno"> 1908</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</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="keywordtype">int</span> target = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l01911"></a><span class="lineno"> 1911</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gac5c485fe330636966effc0642ba2bd99">rotateAroundAxis</a>(quregVec, target, param, vec), Contains(<span class="stringliteral">"Invalid target"</span>) );</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>  SECTION( <span class="stringliteral">"zero rotation axis"</span> ) {</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>  <span class="keywordtype">int</span> target = 0;</div>
<div class="line"><a name="l01916"></a><span class="lineno"> 1916</span>  vec = {.<a class="code" href="structVector.html#a0d0459a5b731ac5fb3dff2c6134e6e88">x</a>=0, .y=0, .z=0};</div>
<div class="line"><a name="l01917"></a><span class="lineno"> 1917</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#gac5c485fe330636966effc0642ba2bd99">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="l01918"></a><span class="lineno"> 1918</span>  }</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>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l01921"></a><span class="lineno"> 1921</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00410">getRandomReal()</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>, <a class="el" href="QuEST_8c_source.html#l00573">rotateAroundAxis()</a>, <a class="el" href="QuEST_8h_source.html#l00150">Vector::x</a>, <a class="el" href="QuEST_8h_source.html#l00150">Vector::y</a>, and <a class="el" href="QuEST_8h_source.html#l00150">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">[77/88]</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#ga5fb1514d67ab43917dc64a357e711425" 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#l01929">1929</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="l01929"></a><span class="lineno"> 1929</span>  {</div>
<div class="line"><a name="l01930"></a><span class="lineno"> 1930</span>  </div>
<div class="line"><a name="l01931"></a><span class="lineno"> 1931</span>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l01932"></a><span class="lineno"> 1932</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> param = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-4*M_PI, 4*M_PI);</div>
<div class="line"><a name="l01933"></a><span class="lineno"> 1933</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op{{cos(param/2), -1i*sin(param/2)}, {-1i*sin(param/2), cos(param/2)}};</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>  SECTION( <span class="stringliteral">"correctness"</span> ) {</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>  <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="l01938"></a><span class="lineno"> 1938</span>  </div>
<div class="line"><a name="l01939"></a><span class="lineno"> 1939</span>  SECTION( <span class="stringliteral">"state-vector "</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>  <a class="code" href="group__unitary.html#ga5fb1514d67ab43917dc64a357e711425">rotateX</a>(quregVec, target, param);</div>
<div class="line"><a name="l01942"></a><span class="lineno"> 1942</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, target, op);</div>
<div class="line"><a name="l01943"></a><span class="lineno"> 1943</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</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">"density-matrix"</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>  <a class="code" href="group__unitary.html#ga5fb1514d67ab43917dc64a357e711425">rotateX</a>(quregMatr, target, param);</div>
<div class="line"><a name="l01948"></a><span class="lineno"> 1948</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, target, op);</div>
<div class="line"><a name="l01949"></a><span class="lineno"> 1949</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</div>
<div class="line"><a name="l01950"></a><span class="lineno"> 1950</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">"input validation"</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>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l01955"></a><span class="lineno"> 1955</span>  </div>
<div class="line"><a name="l01956"></a><span class="lineno"> 1956</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="l01957"></a><span class="lineno"> 1957</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga5fb1514d67ab43917dc64a357e711425">rotateX</a>(quregVec, target, param), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l01958"></a><span class="lineno"> 1958</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>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l01961"></a><span class="lineno"> 1961</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00410">getRandomReal()</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#l00186">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">[78/88]</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#ga680f90d42e56950f40d11d695596a363" 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#l01969">1969</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="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>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l01972"></a><span class="lineno"> 1972</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> param = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-4*M_PI, 4*M_PI);</div>
<div class="line"><a name="l01973"></a><span class="lineno"> 1973</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="l01974"></a><span class="lineno"> 1974</span>  </div>
<div class="line"><a name="l01975"></a><span class="lineno"> 1975</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l01976"></a><span class="lineno"> 1976</span>  </div>
<div class="line"><a name="l01977"></a><span class="lineno"> 1977</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="l01978"></a><span class="lineno"> 1978</span>  </div>
<div class="line"><a name="l01979"></a><span class="lineno"> 1979</span>  SECTION( <span class="stringliteral">"state-vector "</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>  <a class="code" href="group__unitary.html#ga680f90d42e56950f40d11d695596a363">rotateY</a>(quregVec, target, param);</div>
<div class="line"><a name="l01982"></a><span class="lineno"> 1982</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, target, op);</div>
<div class="line"><a name="l01983"></a><span class="lineno"> 1983</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l01984"></a><span class="lineno"> 1984</span>  }</div>
<div class="line"><a name="l01985"></a><span class="lineno"> 1985</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</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>  <a class="code" href="group__unitary.html#ga680f90d42e56950f40d11d695596a363">rotateY</a>(quregMatr, target, param);</div>
<div class="line"><a name="l01988"></a><span class="lineno"> 1988</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, target, op);</div>
<div class="line"><a name="l01989"></a><span class="lineno"> 1989</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 2*REAL_EPS) );</div>
<div class="line"><a name="l01990"></a><span class="lineno"> 1990</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">"input validation"</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>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l01995"></a><span class="lineno"> 1995</span>  </div>
<div class="line"><a name="l01996"></a><span class="lineno"> 1996</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="l01997"></a><span class="lineno"> 1997</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga680f90d42e56950f40d11d695596a363">rotateY</a>(quregVec, target, param), Contains(<span class="stringliteral">"Invalid target"</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>  }</div>
<div class="line"><a name="l02000"></a><span class="lineno"> 2000</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l02001"></a><span class="lineno"> 2001</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00410">getRandomReal()</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#l00197">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">[79/88]</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#ga30675e80b054d5adf556ae00f98377d9" 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#l02009">2009</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="l02009"></a><span class="lineno"> 2009</span>  {</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>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l02012"></a><span class="lineno"> 2012</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> param = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-4*M_PI, 4*M_PI);</div>
<div class="line"><a name="l02013"></a><span class="lineno"> 2013</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="l02014"></a><span class="lineno"> 2014</span>  </div>
<div class="line"><a name="l02015"></a><span class="lineno"> 2015</span>  SECTION( <span class="stringliteral">"correctness"</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>  <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="l02018"></a><span class="lineno"> 2018</span>  </div>
<div class="line"><a name="l02019"></a><span class="lineno"> 2019</span>  SECTION( <span class="stringliteral">"state-vector "</span>) {</div>
<div class="line"><a name="l02020"></a><span class="lineno"> 2020</span>  </div>
<div class="line"><a name="l02021"></a><span class="lineno"> 2021</span>  <a class="code" href="group__unitary.html#ga30675e80b054d5adf556ae00f98377d9">rotateZ</a>(quregVec, target, param);</div>
<div class="line"><a name="l02022"></a><span class="lineno"> 2022</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, target, op);</div>
<div class="line"><a name="l02023"></a><span class="lineno"> 2023</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l02024"></a><span class="lineno"> 2024</span>  }</div>
<div class="line"><a name="l02025"></a><span class="lineno"> 2025</span>  SECTION( <span class="stringliteral">"density-matrix"</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>  <a class="code" href="group__unitary.html#ga30675e80b054d5adf556ae00f98377d9">rotateZ</a>(quregMatr, target, param);</div>
<div class="line"><a name="l02028"></a><span class="lineno"> 2028</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, target, op);</div>
<div class="line"><a name="l02029"></a><span class="lineno"> 2029</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</div>
<div class="line"><a name="l02030"></a><span class="lineno"> 2030</span>  }</div>
<div class="line"><a name="l02031"></a><span class="lineno"> 2031</span>  }</div>
<div class="line"><a name="l02032"></a><span class="lineno"> 2032</span>  SECTION( <span class="stringliteral">"input validation"</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">"qubit indices"</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="keywordtype">int</span> target = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l02037"></a><span class="lineno"> 2037</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga30675e80b054d5adf556ae00f98377d9">rotateZ</a>(quregVec, target, param), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l02038"></a><span class="lineno"> 2038</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>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l02041"></a><span class="lineno"> 2041</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00406">expI()</a>, <a class="el" href="utilities_8cpp_source.html#l00410">getRandomReal()</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#l00208">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">[80/88]</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 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#l00368">368</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="l00368"></a><span class="lineno"> 368</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>  <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="l00371"></a><span class="lineno"> 371</span>  </div>
<div class="line"><a name="l00372"></a><span class="lineno"> 372</span>  <span class="keywordtype">int</span> maxInd = vec.<a class="code" href="structQureg.html#adef4935cac95763c29164cf99b144ed4">numAmpsTotal</a>;</div>
<div class="line"><a name="l00373"></a><span class="lineno"> 373</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> reals[maxInd];</div>
<div class="line"><a name="l00374"></a><span class="lineno"> 374</span>  <a class="code" href="group__type.html#ga7740e349b4f8bae6451547680f0ce2d6">qreal</a> imags[maxInd];</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">"correctness"</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">"state-vector"</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="comment">// all valid number of amplitudes and offsets</span></div>
<div class="line"><a name="l00381"></a><span class="lineno"> 381</span>  <span class="keywordtype">int</span> startInd = GENERATE_COPY( range(0,maxInd) );</div>
<div class="line"><a name="l00382"></a><span class="lineno"> 382</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="l00383"></a><span class="lineno"> 383</span>  </div>
<div class="line"><a name="l00384"></a><span class="lineno"> 384</span>  <span class="comment">// generate random amplitudes</span></div>
<div class="line"><a name="l00385"></a><span class="lineno"> 385</span>  <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<numAmps; i++) {</div>
<div class="line"><a name="l00386"></a><span class="lineno"> 386</span>  reals[i] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5);</div>
<div class="line"><a name="l00387"></a><span class="lineno"> 387</span>  imags[i] = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5);</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>  </div>
<div class="line"><a name="l00390"></a><span class="lineno"> 390</span>  <span class="comment">// check both specified and un-specified amplitudes are correctly handled</span></div>
<div class="line"><a name="l00391"></a><span class="lineno"> 391</span>  <a class="code" href="group__debug.html#gaa696c94112e5fbbc996af10dfc4e2c1c">initDebugState</a>(vec);</div>
<div class="line"><a name="l00392"></a><span class="lineno"> 392</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="l00393"></a><span class="lineno"> 393</span>  </div>
<div class="line"><a name="l00394"></a><span class="lineno"> 394</span>  <a class="code" href="group__init.html#gabc0c64f8adf307d2a44184dc0f8ca66e">setAmps</a>(vec, startInd, reals, imags, numAmps);</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<numAmps; i++)</div>
<div class="line"><a name="l00396"></a><span class="lineno"> 396</span>  vecRef[startInd+i] = reals[i] + 1i*(imags[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>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vec, vecRef) );</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>  }</div>
<div class="line"><a name="l00401"></a><span class="lineno"> 401</span>  SECTION( <span class="stringliteral">"input validation"</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>  SECTION( <span class="stringliteral">"start index"</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>  <span class="keywordtype">int</span> startInd = GENERATE_COPY( -1, maxInd );</div>
<div class="line"><a name="l00406"></a><span class="lineno"> 406</span>  <span class="keywordtype">int</span> numAmps = 0;</div>
<div class="line"><a name="l00407"></a><span class="lineno"> 407</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="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">"number of amplitudes"</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">// independent</span></div>
<div class="line"><a name="l00413"></a><span class="lineno"> 413</span>  <span class="keywordtype">int</span> startInd = 0;</div>
<div class="line"><a name="l00414"></a><span class="lineno"> 414</span>  <span class="keywordtype">int</span> numAmps = GENERATE_COPY( -1, maxInd+1 );</div>
<div class="line"><a name="l00415"></a><span class="lineno"> 415</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="l00416"></a><span class="lineno"> 416</span>  </div>
<div class="line"><a name="l00417"></a><span class="lineno"> 417</span>  <span class="comment">// invalid considering start-index</span></div>
<div class="line"><a name="l00418"></a><span class="lineno"> 418</span>  startInd = maxInd - 1;</div>
<div class="line"><a name="l00419"></a><span class="lineno"> 419</span>  numAmps = 2;</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">"More amplitudes given than exist"</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">"density-matrix"</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="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="l00425"></a><span class="lineno"> 425</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="l00426"></a><span class="lineno"> 426</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="l00427"></a><span class="lineno"> 427</span>  }</div>
<div class="line"><a name="l00428"></a><span class="lineno"> 428</span>  }</div>
<div class="line"><a name="l00429"></a><span class="lineno"> 429</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="l00430"></a><span class="lineno"> 430</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="QuEST_8c_source.html#l00048">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00410">getRandomReal()</a>, <a class="el" href="QuEST_8c_source.html#l01057">initDebugState()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="QuEST_8h_source.html#l00172">Qureg::numAmpsTotal</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#l00779">setAmps()</a>, and <a class="el" href="utilities_8cpp_source.html#l00904">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">[81/88]</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#l00438">438</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="l00438"></a><span class="lineno"> 438</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>  SECTION( <span class="stringliteral">"correctness"</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>  <span class="comment">// repeat each test below 10 times </span></div>
<div class="line"><a name="l00443"></a><span class="lineno"> 443</span>  GENERATE( range(0,10) );</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">/* note tolerance in areEqual increases with tests, since </span></div>
<div class="line"><a name="l00446"></a><span class="lineno"> 446</span> <span class="comment"> * small differences propogate in vecC which is not re-initialised </span></div>
<div class="line"><a name="l00447"></a><span class="lineno"> 447</span> <span class="comment"> */</span></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>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l00450"></a><span class="lineno"> 450</span>  </div>
<div class="line"><a name="l00451"></a><span class="lineno"> 451</span>  <span class="comment">// make three random vectors</span></div>
<div class="line"><a name="l00452"></a><span class="lineno"> 452</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="l00453"></a><span class="lineno"> 453</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="l00454"></a><span class="lineno"> 454</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="l00455"></a><span class="lineno"> 455</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="l00456"></a><span class="lineno"> 456</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="l00457"></a><span class="lineno"> 457</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="l00458"></a><span class="lineno"> 458</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="l00459"></a><span class="lineno"> 459</span>  }</div>
<div class="line"><a name="l00460"></a><span class="lineno"> 460</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="l00461"></a><span class="lineno"> 461</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="l00462"></a><span class="lineno"> 462</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="l00463"></a><span class="lineno"> 463</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="l00464"></a><span class="lineno"> 464</span>  <a class="code" href="group__testutilities.html#gac9263a65c96a458b810b20baa81c5b94">QVector</a> refOut;</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="comment">// get three random factors</span></div>
<div class="line"><a name="l00467"></a><span class="lineno"> 467</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> numA = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5) + 1i*<a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5);</div>
<div class="line"><a name="l00468"></a><span class="lineno"> 468</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> numB = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5) + 1i*<a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5);</div>
<div class="line"><a name="l00469"></a><span class="lineno"> 469</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> numC = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5) + 1i*<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>  <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="l00471"></a><span class="lineno"> 471</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="l00472"></a><span class="lineno"> 472</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="l00473"></a><span class="lineno"> 473</span>  </div>
<div class="line"><a name="l00474"></a><span class="lineno"> 474</span>  <span class="comment">// check out-qureg is correct, when all quregs are unique... </span></div>
<div class="line"><a name="l00475"></a><span class="lineno"> 475</span>  <a class="code" href="group__init.html#ga5d0f3f71ea38d3c44597f8c2c2f014d4">setWeightedQureg</a>(facA, vecA, facB, vecB, facC, vecC);</div>
<div class="line"><a name="l00476"></a><span class="lineno"> 476</span>  refOut = numA*refA + numB*refB + numC*refC;</div>
<div class="line"><a name="l00477"></a><span class="lineno"> 477</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vecC, 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">// ... and that other qureg's aren't modified</span></div>
<div class="line"><a name="l00480"></a><span class="lineno"> 480</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vecA, refA) );</div>
<div class="line"><a name="l00481"></a><span class="lineno"> 481</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vecB, refB) );</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="comment">// check quregOut correct, when it's also qureg2</span></div>
<div class="line"><a name="l00484"></a><span class="lineno"> 484</span>  refC = <a class="code" href="group__testutilities.html#gade0e7c37811a69f1c21c88c11943a19f">toQVector</a>(vecC);</div>
<div class="line"><a name="l00485"></a><span class="lineno"> 485</span>  <a class="code" href="group__init.html#ga5d0f3f71ea38d3c44597f8c2c2f014d4">setWeightedQureg</a>(facB, vecB, facC, vecC, facA, vecC);</div>
<div class="line"><a name="l00486"></a><span class="lineno"> 486</span>  refOut = numB*refB + numC*refC + numA*refC;</div>
<div class="line"><a name="l00487"></a><span class="lineno"> 487</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vecC, refOut, 10*REAL_EPS) );</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="comment">// ... and that the remaining qureg is not modified</span></div>
<div class="line"><a name="l00490"></a><span class="lineno"> 490</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vecB, refB) );</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">// check quregOut correct, when it's also qureg1</span></div>
<div class="line"><a name="l00493"></a><span class="lineno"> 493</span>  refC = <a class="code" href="group__testutilities.html#gade0e7c37811a69f1c21c88c11943a19f">toQVector</a>(vecC);</div>
<div class="line"><a name="l00494"></a><span class="lineno"> 494</span>  <a class="code" href="group__init.html#ga5d0f3f71ea38d3c44597f8c2c2f014d4">setWeightedQureg</a>(facC, vecC, facB, vecB, facA, vecC);</div>
<div class="line"><a name="l00495"></a><span class="lineno"> 495</span>  refOut = numC*refC + numB*refB + numA*refC;</div>
<div class="line"><a name="l00496"></a><span class="lineno"> 496</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vecC, refOut, 10*REAL_EPS) );</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="comment">// ... and that the remaining qureg is not modified</span></div>
<div class="line"><a name="l00499"></a><span class="lineno"> 499</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vecB, refB) );</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">// check quregOut is correct when it's both input quregs</span></div>
<div class="line"><a name="l00502"></a><span class="lineno"> 502</span>  refC = <a class="code" href="group__testutilities.html#gade0e7c37811a69f1c21c88c11943a19f">toQVector</a>(vecC);</div>
<div class="line"><a name="l00503"></a><span class="lineno"> 503</span>  <a class="code" href="group__init.html#ga5d0f3f71ea38d3c44597f8c2c2f014d4">setWeightedQureg</a>(facA, vecC, facB, vecC, facC, vecC);</div>
<div class="line"><a name="l00504"></a><span class="lineno"> 504</span>  refOut = numA*refC + numB*refC + numC*refC;</div>
<div class="line"><a name="l00505"></a><span class="lineno"> 505</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(vecC, refOut, 1E2*REAL_EPS) );</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">// cleanup</span></div>
<div class="line"><a name="l00508"></a><span class="lineno"> 508</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="l00509"></a><span class="lineno"> 509</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="l00510"></a><span class="lineno"> 510</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="l00511"></a><span class="lineno"> 511</span>  }</div>
<div class="line"><a name="l00512"></a><span class="lineno"> 512</span>  SECTION( <span class="stringliteral">"density-matrix"</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>  <span class="comment">// make three random matrices</span></div>
<div class="line"><a name="l00515"></a><span class="lineno"> 515</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="l00516"></a><span class="lineno"> 516</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="l00517"></a><span class="lineno"> 517</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="l00518"></a><span class="lineno"> 518</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="l00519"></a><span class="lineno"> 519</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="l00520"></a><span class="lineno"> 520</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="l00521"></a><span class="lineno"> 521</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="l00522"></a><span class="lineno"> 522</span>  }</div>
<div class="line"><a name="l00523"></a><span class="lineno"> 523</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="l00524"></a><span class="lineno"> 524</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="l00525"></a><span class="lineno"> 525</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="l00526"></a><span class="lineno"> 526</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="l00527"></a><span class="lineno"> 527</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> refOut;</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>  <span class="comment">// get three random factors</span></div>
<div class="line"><a name="l00530"></a><span class="lineno"> 530</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> numA = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5) + 1i*<a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5);</div>
<div class="line"><a name="l00531"></a><span class="lineno"> 531</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> numB = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5) + 1i*<a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5);</div>
<div class="line"><a name="l00532"></a><span class="lineno"> 532</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> numC = <a class="code" href="group__testutilities.html#gacd5aadbe10ecdedaa625f85171c0a3cd">getRandomReal</a>(-5,5) + 1i*<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>  <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="l00534"></a><span class="lineno"> 534</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="l00535"></a><span class="lineno"> 535</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="l00536"></a><span class="lineno"> 536</span>  </div>
<div class="line"><a name="l00537"></a><span class="lineno"> 537</span>  <span class="comment">// check out-qureg is correct, when all quregs are unique... </span></div>
<div class="line"><a name="l00538"></a><span class="lineno"> 538</span>  <a class="code" href="group__init.html#ga5d0f3f71ea38d3c44597f8c2c2f014d4">setWeightedQureg</a>(facA, matA, facB, matB, facC, matC);</div>
<div class="line"><a name="l00539"></a><span class="lineno"> 539</span>  refOut = numA*refA + numB*refB + numC*refC;</div>
<div class="line"><a name="l00540"></a><span class="lineno"> 540</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(matC, 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">// ... and that other qureg's aren't modified</span></div>
<div class="line"><a name="l00543"></a><span class="lineno"> 543</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(matA, refA) );</div>
<div class="line"><a name="l00544"></a><span class="lineno"> 544</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(matB, refB) );</div>
<div class="line"><a name="l00545"></a><span class="lineno"> 545</span>  </div>
<div class="line"><a name="l00546"></a><span class="lineno"> 546</span>  <span class="comment">// check quregOut correct, when it's also qureg2</span></div>
<div class="line"><a name="l00547"></a><span class="lineno"> 547</span>  refC = <a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(matC);</div>
<div class="line"><a name="l00548"></a><span class="lineno"> 548</span>  <a class="code" href="group__init.html#ga5d0f3f71ea38d3c44597f8c2c2f014d4">setWeightedQureg</a>(facB, matB, facC, matC, facA, matC);</div>
<div class="line"><a name="l00549"></a><span class="lineno"> 549</span>  refOut = numB*refB + numC*refC + numA*refC;</div>
<div class="line"><a name="l00550"></a><span class="lineno"> 550</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(matC, refOut, 10*REAL_EPS) );</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="comment">// ... and that the remaining qureg is not modified</span></div>
<div class="line"><a name="l00553"></a><span class="lineno"> 553</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(matB, refB) );</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">// check quregOut correct, when it's also qureg1</span></div>
<div class="line"><a name="l00556"></a><span class="lineno"> 556</span>  refC = <a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(matC);</div>
<div class="line"><a name="l00557"></a><span class="lineno"> 557</span>  <a class="code" href="group__init.html#ga5d0f3f71ea38d3c44597f8c2c2f014d4">setWeightedQureg</a>(facC, matC, facB, matB, facA, matC);</div>
<div class="line"><a name="l00558"></a><span class="lineno"> 558</span>  refOut = numC*refC + numB*refB + numA*refC;</div>
<div class="line"><a name="l00559"></a><span class="lineno"> 559</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(matC, refOut, 1E2*REAL_EPS) );</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>  <span class="comment">// ... and that the remaining qureg is not modified</span></div>
<div class="line"><a name="l00562"></a><span class="lineno"> 562</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(matB, refB) );</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>  <span class="comment">// check quregOut is correct when it's both input quregs</span></div>
<div class="line"><a name="l00565"></a><span class="lineno"> 565</span>  refC = <a class="code" href="group__testutilities.html#ga253946523907014c4f198d2bb38d4913">toQMatrix</a>(matC);</div>
<div class="line"><a name="l00566"></a><span class="lineno"> 566</span>  <a class="code" href="group__init.html#ga5d0f3f71ea38d3c44597f8c2c2f014d4">setWeightedQureg</a>(facA, matC, facB, matC, facC, matC);</div>
<div class="line"><a name="l00567"></a><span class="lineno"> 567</span>  refOut = numA*refC + numB*refC + numC*refC;</div>
<div class="line"><a name="l00568"></a><span class="lineno"> 568</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(matC, refOut, 1E3*REAL_EPS) );</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="comment">// cleanup</span></div>
<div class="line"><a name="l00571"></a><span class="lineno"> 571</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="l00572"></a><span class="lineno"> 572</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="l00573"></a><span class="lineno"> 573</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="l00574"></a><span class="lineno"> 574</span>  }</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>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l00577"></a><span class="lineno"> 577</span>  </div>
<div class="line"><a name="l00578"></a><span class="lineno"> 578</span>  SECTION( <span class="stringliteral">"qureg types"</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="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="l00581"></a><span class="lineno"> 581</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="l00582"></a><span class="lineno"> 582</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="l00583"></a><span class="lineno"> 583</span>  </div>
<div class="line"><a name="l00584"></a><span class="lineno"> 584</span>  <span class="comment">// two state-vecs, one density-matrix</span></div>
<div class="line"><a name="l00585"></a><span class="lineno"> 585</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="l00586"></a><span class="lineno"> 586</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="l00587"></a><span class="lineno"> 587</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="l00588"></a><span class="lineno"> 588</span>  </div>
<div class="line"><a name="l00589"></a><span class="lineno"> 589</span>  <span class="comment">// one state-vec, two density-matrices</span></div>
<div class="line"><a name="l00590"></a><span class="lineno"> 590</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="l00591"></a><span class="lineno"> 591</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="l00592"></a><span class="lineno"> 592</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="l00593"></a><span class="lineno"> 593</span>  </div>
<div class="line"><a name="l00594"></a><span class="lineno"> 594</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="l00595"></a><span class="lineno"> 595</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="l00596"></a><span class="lineno"> 596</span>  } </div>
<div class="line"><a name="l00597"></a><span class="lineno"> 597</span>  SECTION( <span class="stringliteral">"qureg dimensions"</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>  <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="l00600"></a><span class="lineno"> 600</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="l00601"></a><span class="lineno"> 601</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="l00602"></a><span class="lineno"> 602</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="l00603"></a><span class="lineno"> 603</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="l00604"></a><span class="lineno"> 604</span>  </div>
<div class="line"><a name="l00605"></a><span class="lineno"> 605</span>  <span class="comment">// state-vecs</span></div>
<div class="line"><a name="l00606"></a><span class="lineno"> 606</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="l00607"></a><span class="lineno"> 607</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="l00608"></a><span class="lineno"> 608</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="l00609"></a><span class="lineno"> 609</span>  </div>
<div class="line"><a name="l00610"></a><span class="lineno"> 610</span>  <span class="comment">// density-matrices</span></div>
<div class="line"><a name="l00611"></a><span class="lineno"> 611</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="l00612"></a><span class="lineno"> 612</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="l00613"></a><span class="lineno"> 613</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="l00614"></a><span class="lineno"> 614</span>  </div>
<div class="line"><a name="l00615"></a><span class="lineno"> 615</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="l00616"></a><span class="lineno"> 616</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="l00617"></a><span class="lineno"> 617</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="l00618"></a><span class="lineno"> 618</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="l00619"></a><span class="lineno"> 619</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> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="QuEST__cpu_8c_source.html#l00036">copyStateToGPU()</a>, <a class="el" href="QuEST_8c_source.html#l00048">createDensityQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00034">createQureg()</a>, <a class="el" href="QuEST_8c_source.html#l00075">destroyQureg()</a>, <a class="el" href="utilities_8cpp_source.html#l00410">getRandomReal()</a>, <a class="el" href="utilities_8hpp_source.html#l00036">NUM_QUBITS</a>, <a class="el" href="QuEST_8h_source.html#l00170">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#l00795">setWeightedQureg()</a>, <a class="el" href="QuEST_8h_source.html#l00179">Qureg::stateVec</a>, <a class="el" href="group__type.html#gab54c5a1ea720830a7ee394d03fb9f4e9">toComplex</a>, <a class="el" href="utilities_8cpp_source.html#l00835">toQMatrix()</a>, and <a class="el" href="utilities_8cpp_source.html#l00904">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">[82/88]</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#ga67a83cdbd8d6ae77f91aa011cf09907a" 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#l02049">2049</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="l02049"></a><span class="lineno"> 2049</span>  {</div>
<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>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l02052"></a><span class="lineno"> 2052</span>  <a class="code" href="group__testutilities.html#gabbc686f5f40eff22e08a2b2012ac4e41">QMatrix</a> op{{1,0},{0,1i}};</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">"correctness"</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="keywordtype">int</span> target = GENERATE( range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) );</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>  SECTION( <span class="stringliteral">"state-vector "</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>  <a class="code" href="group__unitary.html#ga67a83cdbd8d6ae77f91aa011cf09907a">sGate</a>(quregVec, target);</div>
<div class="line"><a name="l02061"></a><span class="lineno"> 2061</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, target, op);</div>
<div class="line"><a name="l02062"></a><span class="lineno"> 2062</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l02063"></a><span class="lineno"> 2063</span>  }</div>
<div class="line"><a name="l02064"></a><span class="lineno"> 2064</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</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>  <a class="code" href="group__unitary.html#ga67a83cdbd8d6ae77f91aa011cf09907a">sGate</a>(quregMatr, target);</div>
<div class="line"><a name="l02067"></a><span class="lineno"> 2067</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, target, op);</div>
<div class="line"><a name="l02068"></a><span class="lineno"> 2068</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</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>  }</div>
<div class="line"><a name="l02071"></a><span class="lineno"> 2071</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</div>
<div class="line"><a name="l02072"></a><span class="lineno"> 2072</span>  </div>
<div class="line"><a name="l02073"></a><span class="lineno"> 2073</span>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l02074"></a><span class="lineno"> 2074</span>  </div>
<div class="line"><a name="l02075"></a><span class="lineno"> 2075</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="l02076"></a><span class="lineno"> 2076</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga67a83cdbd8d6ae77f91aa011cf09907a">sGate</a>(quregVec, target), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l02077"></a><span class="lineno"> 2077</span>  }</div>
<div class="line"><a name="l02078"></a><span class="lineno"> 2078</span>  }</div>
<div class="line"><a name="l02079"></a><span class="lineno"> 2079</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l02080"></a><span class="lineno"> 2080</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">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#l00464">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">[83/88]</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#l02088">2088</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="l02088"></a><span class="lineno"> 2088</span>  {</div>
<div class="line"><a name="l02089"></a><span class="lineno"> 2089</span>  </div>
<div class="line"><a name="l02090"></a><span class="lineno"> 2090</span>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l02091"></a><span class="lineno"> 2091</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> a = (1. + 1i)/2.;</div>
<div class="line"><a name="l02092"></a><span class="lineno"> 2092</span>  <a class="code" href="group__type.html#gad863c5878a01051a2726ce94bf365428">qcomp</a> b = (1. - 1i)/2.;</div>
<div class="line"><a name="l02093"></a><span class="lineno"> 2093</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="l02094"></a><span class="lineno"> 2094</span>  </div>
<div class="line"><a name="l02095"></a><span class="lineno"> 2095</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l02096"></a><span class="lineno"> 2096</span>  </div>
<div class="line"><a name="l02097"></a><span class="lineno"> 2097</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="l02098"></a><span class="lineno"> 2098</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="l02099"></a><span class="lineno"> 2099</span>  <span class="keywordtype">int</span> targs[] = {targ1, targ2};</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">"state-vector"</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>  <a class="code" href="group__unitary.html#ga75d5e65f87c68403602a669b9c6d52b0">sqrtSwapGate</a>(quregVec, targ1, targ2);</div>
<div class="line"><a name="l02104"></a><span class="lineno"> 2104</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, targs, 2, op);</div>
<div class="line"><a name="l02105"></a><span class="lineno"> 2105</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l02106"></a><span class="lineno"> 2106</span>  }</div>
<div class="line"><a name="l02107"></a><span class="lineno"> 2107</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</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>  <a class="code" href="group__unitary.html#ga75d5e65f87c68403602a669b9c6d52b0">sqrtSwapGate</a>(quregMatr, targ1, targ2);</div>
<div class="line"><a name="l02110"></a><span class="lineno"> 2110</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, targs, 2, op);</div>
<div class="line"><a name="l02111"></a><span class="lineno"> 2111</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</div>
<div class="line"><a name="l02112"></a><span class="lineno"> 2112</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">"input validation"</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>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l02117"></a><span class="lineno"> 2117</span>  </div>
<div class="line"><a name="l02118"></a><span class="lineno"> 2118</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="l02119"></a><span class="lineno"> 2119</span>  <span class="keywordtype">int</span> targ2 = 0;</div>
<div class="line"><a name="l02120"></a><span class="lineno"> 2120</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="l02121"></a><span class="lineno"> 2121</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="l02122"></a><span class="lineno"> 2122</span>  }</div>
<div class="line"><a name="l02123"></a><span class="lineno"> 2123</span>  SECTION( <span class="stringliteral">"repetition of targets"</span> ) {</div>
<div class="line"><a name="l02124"></a><span class="lineno"> 2124</span>  </div>
<div class="line"><a name="l02125"></a><span class="lineno"> 2125</span>  <span class="keywordtype">int</span> qb = 0;</div>
<div class="line"><a name="l02126"></a><span class="lineno"> 2126</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="l02127"></a><span class="lineno"> 2127</span>  }</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>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l02130"></a><span class="lineno"> 2130</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">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#l00611">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">[84/88]</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#l02138">2138</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="l02138"></a><span class="lineno"> 2138</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>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l02141"></a><span class="lineno"> 2141</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="l02142"></a><span class="lineno"> 2142</span>  </div>
<div class="line"><a name="l02143"></a><span class="lineno"> 2143</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</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="keywordtype">int</span> targ1 = GENERATE( range(0,<a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a>) );</div>
<div class="line"><a name="l02146"></a><span class="lineno"> 2146</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="l02147"></a><span class="lineno"> 2147</span>  <span class="keywordtype">int</span> targs[] = {targ1, targ2};</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>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l02150"></a><span class="lineno"> 2150</span>  </div>
<div class="line"><a name="l02151"></a><span class="lineno"> 2151</span>  <a class="code" href="group__unitary.html#ga820fd139c035136819e371308c206e36">swapGate</a>(quregVec, targ1, targ2);</div>
<div class="line"><a name="l02152"></a><span class="lineno"> 2152</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, targs, 2, op);</div>
<div class="line"><a name="l02153"></a><span class="lineno"> 2153</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l02154"></a><span class="lineno"> 2154</span>  }</div>
<div class="line"><a name="l02155"></a><span class="lineno"> 2155</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</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>  <a class="code" href="group__unitary.html#ga820fd139c035136819e371308c206e36">swapGate</a>(quregMatr, targ1, targ2);</div>
<div class="line"><a name="l02158"></a><span class="lineno"> 2158</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, targs, 2, op);</div>
<div class="line"><a name="l02159"></a><span class="lineno"> 2159</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</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>  }</div>
<div class="line"><a name="l02162"></a><span class="lineno"> 2162</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</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">"qubit indices"</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> targ1 = GENERATE( -1, <a class="code" href="utilities_8hpp.html#a2f52338126bb8cdf7fcf68eaf01c546a">NUM_QUBITS</a> );</div>
<div class="line"><a name="l02167"></a><span class="lineno"> 2167</span>  <span class="keywordtype">int</span> targ2 = 0;</div>
<div class="line"><a name="l02168"></a><span class="lineno"> 2168</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="l02169"></a><span class="lineno"> 2169</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="l02170"></a><span class="lineno"> 2170</span>  }</div>
<div class="line"><a name="l02171"></a><span class="lineno"> 2171</span>  SECTION( <span class="stringliteral">"repetition of targets"</span> ) {</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>  <span class="keywordtype">int</span> qb = 0;</div>
<div class="line"><a name="l02174"></a><span class="lineno"> 2174</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="l02175"></a><span class="lineno"> 2175</span>  }</div>
<div class="line"><a name="l02176"></a><span class="lineno"> 2176</span>  }</div>
<div class="line"><a name="l02177"></a><span class="lineno"> 2177</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l02178"></a><span class="lineno"> 2178</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">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#l00599">swapGate()</a>.</p>
</div>
</div>
<a id="ga4296b3ea07d5a25be3f5bd0e87459112"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga4296b3ea07d5a25be3f5bd0e87459112">◆ </a></span>TEST_CASE() <span class="overload">[85/88]</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#ga3c500a891a522fd3045c379489f0252a" 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#l02186">2186</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="l02186"></a><span class="lineno"> 2186</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>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l02189"></a><span class="lineno"> 2189</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>(M_PI/4.)}};</div>
<div class="line"><a name="l02190"></a><span class="lineno"> 2190</span>  </div>
<div class="line"><a name="l02191"></a><span class="lineno"> 2191</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l02192"></a><span class="lineno"> 2192</span>  </div>
<div class="line"><a name="l02193"></a><span class="lineno"> 2193</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="l02194"></a><span class="lineno"> 2194</span>  </div>
<div class="line"><a name="l02195"></a><span class="lineno"> 2195</span>  SECTION( <span class="stringliteral">"state-vector "</span>) {</div>
<div class="line"><a name="l02196"></a><span class="lineno"> 2196</span>  </div>
<div class="line"><a name="l02197"></a><span class="lineno"> 2197</span>  <a class="code" href="group__unitary.html#ga3c500a891a522fd3045c379489f0252a">tGate</a>(quregVec, target);</div>
<div class="line"><a name="l02198"></a><span class="lineno"> 2198</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, target, op);</div>
<div class="line"><a name="l02199"></a><span class="lineno"> 2199</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l02200"></a><span class="lineno"> 2200</span>  }</div>
<div class="line"><a name="l02201"></a><span class="lineno"> 2201</span>  SECTION( <span class="stringliteral">"density-matrix"</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>  <a class="code" href="group__unitary.html#ga3c500a891a522fd3045c379489f0252a">tGate</a>(quregMatr, target);</div>
<div class="line"><a name="l02204"></a><span class="lineno"> 2204</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, target, op);</div>
<div class="line"><a name="l02205"></a><span class="lineno"> 2205</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr) );</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>  }</div>
<div class="line"><a name="l02208"></a><span class="lineno"> 2208</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</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>  SECTION( <span class="stringliteral">"qubit indices"</span> ) {</div>
<div class="line"><a name="l02211"></a><span class="lineno"> 2211</span>  </div>
<div class="line"><a name="l02212"></a><span class="lineno"> 2212</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="l02213"></a><span class="lineno"> 2213</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga3c500a891a522fd3045c379489f0252a">tGate</a>(quregVec, target), Contains(<span class="stringliteral">"Invalid target"</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>  }</div>
<div class="line"><a name="l02216"></a><span class="lineno"> 2216</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l02217"></a><span class="lineno"> 2217</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00406">expI()</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#l00475">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">[86/88]</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 = .5 - .2i;</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">[87/88]</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#ga81cf22c68db66bf9b4593a5d1b3f528c" 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#l02225">2225</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="l02225"></a><span class="lineno"> 2225</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="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</div>
<div class="line"><a name="l02228"></a><span class="lineno"> 2228</span>  </div>
<div class="line"><a name="l02229"></a><span class="lineno"> 2229</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="l02230"></a><span class="lineno"> 2230</span>  REQUIRE( quregVec.numAmpsPerChunk >= 4 );</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>  <span class="comment">// every test will use a unique random matrix</span></div>
<div class="line"><a name="l02233"></a><span class="lineno"> 2233</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="l02234"></a><span class="lineno"> 2234</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="l02235"></a><span class="lineno"> 2235</span>  </div>
<div class="line"><a name="l02236"></a><span class="lineno"> 2236</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<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>  <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="l02239"></a><span class="lineno"> 2239</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="l02240"></a><span class="lineno"> 2240</span>  <span class="keywordtype">int</span> targs[] = {targ1, targ2};</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">"state-vector"</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>  <a class="code" href="group__unitary.html#ga81cf22c68db66bf9b4593a5d1b3f528c">twoQubitUnitary</a>(quregVec, targ1, targ2, matr);</div>
<div class="line"><a name="l02245"></a><span class="lineno"> 2245</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, targs, 2, op);</div>
<div class="line"><a name="l02246"></a><span class="lineno"> 2246</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</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>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l02249"></a><span class="lineno"> 2249</span>  </div>
<div class="line"><a name="l02250"></a><span class="lineno"> 2250</span>  <a class="code" href="group__unitary.html#ga81cf22c68db66bf9b4593a5d1b3f528c">twoQubitUnitary</a>(quregMatr, targ1, targ2, matr);</div>
<div class="line"><a name="l02251"></a><span class="lineno"> 2251</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, targs, 2, op);</div>
<div class="line"><a name="l02252"></a><span class="lineno"> 2252</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 10*REAL_EPS) );</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>  }</div>
<div class="line"><a name="l02255"></a><span class="lineno"> 2255</span>  SECTION( <span class="stringliteral">"input validation"</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>  SECTION( <span class="stringliteral">"qubit indices"</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>  <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="l02260"></a><span class="lineno"> 2260</span>  <span class="keywordtype">int</span> targ2 = 0;</div>
<div class="line"><a name="l02261"></a><span class="lineno"> 2261</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga81cf22c68db66bf9b4593a5d1b3f528c">twoQubitUnitary</a>(quregVec, targ1, targ2, matr), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l02262"></a><span class="lineno"> 2262</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga81cf22c68db66bf9b4593a5d1b3f528c">twoQubitUnitary</a>(quregVec, targ2, targ1, matr), Contains(<span class="stringliteral">"Invalid target"</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>  SECTION( <span class="stringliteral">"repetition of targets"</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>  <span class="keywordtype">int</span> qb = 0;</div>
<div class="line"><a name="l02267"></a><span class="lineno"> 2267</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga81cf22c68db66bf9b4593a5d1b3f528c">twoQubitUnitary</a>(quregVec, qb, qb, matr), Contains(<span class="stringliteral">"target"</span>) && Contains(<span class="stringliteral">"unique"</span>) );</div>
<div class="line"><a name="l02268"></a><span class="lineno"> 2268</span>  }</div>
<div class="line"><a name="l02269"></a><span class="lineno"> 2269</span>  SECTION( <span class="stringliteral">"unitarity"</span> ) {</div>
<div class="line"><a name="l02270"></a><span class="lineno"> 2270</span>  </div>
<div class="line"><a name="l02271"></a><span class="lineno"> 2271</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="l02272"></a><span class="lineno"> 2272</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga81cf22c68db66bf9b4593a5d1b3f528c">twoQubitUnitary</a>(quregVec, 0, 1, matr), Contains(<span class="stringliteral">"unitary"</span>) );</div>
<div class="line"><a name="l02273"></a><span class="lineno"> 2273</span>  }</div>
<div class="line"><a name="l02274"></a><span class="lineno"> 2274</span>  SECTION( <span class="stringliteral">"unitary fits in node"</span> ) {</div>
<div class="line"><a name="l02275"></a><span class="lineno"> 2275</span>  </div>
<div class="line"><a name="l02276"></a><span class="lineno"> 2276</span>  <span class="comment">// pretend we have a very limited distributed memory</span></div>
<div class="line"><a name="l02277"></a><span class="lineno"> 2277</span>  quregVec.numAmpsPerChunk = 1;</div>
<div class="line"><a name="l02278"></a><span class="lineno"> 2278</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga81cf22c68db66bf9b4593a5d1b3f528c">twoQubitUnitary</a>(quregVec, 0, 1, matr), Contains(<span class="stringliteral">"targets too many qubits"</span>));</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>  }</div>
<div class="line"><a name="l02281"></a><span class="lineno"> 2281</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l02282"></a><span class="lineno"> 2282</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00485">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#l00127">ComplexMatrix4::real</a>, <a class="el" href="utilities_8cpp_source.html#l00818">toComplexMatrix4()</a>, and <a class="el" href="QuEST_8c_source.html#l00255">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">[88/88]</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#ga5a117f81298e8ed894d964198e737757" 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#l02290">2290</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="l02290"></a><span class="lineno"> 2290</span>  {</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>  <a class="code" href="test__unitaries_8cpp.html#ae34496c47ef565b741782f01e710ea2c">PREPARE_TEST</a>( quregVec, quregMatr, refVec, refMatr );</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>  <span class="comment">// every test will use a unique random matrix</span></div>
<div class="line"><a name="l02295"></a><span class="lineno"> 2295</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="l02296"></a><span class="lineno"> 2296</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="l02297"></a><span class="lineno"> 2297</span>  </div>
<div class="line"><a name="l02298"></a><span class="lineno"> 2298</span>  SECTION( <span class="stringliteral">"correctness"</span> ) {</div>
<div class="line"><a name="l02299"></a><span class="lineno"> 2299</span>  </div>
<div class="line"><a name="l02300"></a><span class="lineno"> 2300</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="l02301"></a><span class="lineno"> 2301</span>  </div>
<div class="line"><a name="l02302"></a><span class="lineno"> 2302</span>  SECTION( <span class="stringliteral">"state-vector"</span> ) {</div>
<div class="line"><a name="l02303"></a><span class="lineno"> 2303</span>  </div>
<div class="line"><a name="l02304"></a><span class="lineno"> 2304</span>  <a class="code" href="group__unitary.html#ga5a117f81298e8ed894d964198e737757">unitary</a>(quregVec, target, matr);</div>
<div class="line"><a name="l02305"></a><span class="lineno"> 2305</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refVec, target, op);</div>
<div class="line"><a name="l02306"></a><span class="lineno"> 2306</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregVec, refVec) );</div>
<div class="line"><a name="l02307"></a><span class="lineno"> 2307</span>  }</div>
<div class="line"><a name="l02308"></a><span class="lineno"> 2308</span>  SECTION( <span class="stringliteral">"density-matrix"</span> ) {</div>
<div class="line"><a name="l02309"></a><span class="lineno"> 2309</span>  </div>
<div class="line"><a name="l02310"></a><span class="lineno"> 2310</span>  <a class="code" href="group__unitary.html#ga5a117f81298e8ed894d964198e737757">unitary</a>(quregMatr, target, matr);</div>
<div class="line"><a name="l02311"></a><span class="lineno"> 2311</span>  <a class="code" href="group__testutilities.html#ga731c2de4d491629d806a03e0aea2f3a3">applyReferenceOp</a>(refMatr, target, op);</div>
<div class="line"><a name="l02312"></a><span class="lineno"> 2312</span>  REQUIRE( <a class="code" href="group__testutilities.html#ga45cc399adad2e2a67b0124851189fae5">areEqual</a>(quregMatr, refMatr, 10*REAL_EPS) );</div>
<div class="line"><a name="l02313"></a><span class="lineno"> 2313</span>  }</div>
<div class="line"><a name="l02314"></a><span class="lineno"> 2314</span>  }</div>
<div class="line"><a name="l02315"></a><span class="lineno"> 2315</span>  SECTION( <span class="stringliteral">"input validation"</span> ) {</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">"qubit indices"</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>  <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="l02320"></a><span class="lineno"> 2320</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga5a117f81298e8ed894d964198e737757">unitary</a>(quregVec, target, matr), Contains(<span class="stringliteral">"Invalid target"</span>) );</div>
<div class="line"><a name="l02321"></a><span class="lineno"> 2321</span>  }</div>
<div class="line"><a name="l02322"></a><span class="lineno"> 2322</span>  SECTION( <span class="stringliteral">"unitarity"</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>  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="l02325"></a><span class="lineno"> 2325</span>  REQUIRE_THROWS_WITH( <a class="code" href="group__unitary.html#ga5a117f81298e8ed894d964198e737757">unitary</a>(quregVec, 0, matr), Contains(<span class="stringliteral">"unitary"</span>) );</div>
<div class="line"><a name="l02326"></a><span class="lineno"> 2326</span>  }</div>
<div class="line"><a name="l02327"></a><span class="lineno"> 2327</span>  }</div>
<div class="line"><a name="l02328"></a><span class="lineno"> 2328</span>  <a class="code" href="test__unitaries_8cpp.html#aec8f698a7995e17e0ff1055526d2e5d4">CLEANUP_TEST</a>( quregVec, quregMatr );</div>
<div class="line"><a name="l02329"></a><span class="lineno"> 2329</span> }</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="utilities_8cpp_source.html#l00573">applyReferenceOp()</a>, <a class="el" href="utilities_8cpp_source.html#l00387">areEqual()</a>, <a class="el" href="test__unitaries_8cpp_source.html#l00033">CLEANUP_TEST</a>, <a class="el" href="utilities_8cpp_source.html#l00485">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#l00116">ComplexMatrix2::real</a>, <a class="el" href="utilities_8cpp_source.html#l00812">toComplexMatrix2()</a>, and <a class="el" href="QuEST_8c_source.html#l00347">unitary()</a>.</p>
</div>
</div>
</div><!-- contents -->
<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#l00690">QuEST.c:690</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#l00117">QuEST.c:117</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#l00148">QuEST.h:148</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__unitary_html_ga811e9b47126c83ff859059106f66cf96"><div class="ttname"><a href="group__unitary.html#ga811e9b47126c83ff859059106f66cf96">controlledPauliY</a></div><div class="ttdeci">void controlledPauliY(Qureg qureg, const int controlQubit, const 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#l00535">QuEST.c:535</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#l00293">utilities.cpp:293</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#l00127">QuEST.h:127</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 a set of qubits, which can be a state vector or density matrix, to a given pure state.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00143">QuEST.c:143</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__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_ga3c500a891a522fd3045c379489f0252a"><div class="ttname"><a href="group__unitary.html#ga3c500a891a522fd3045c379489f0252a">tGate</a></div><div class="ttdeci">void tGate(Qureg qureg, const 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#l00475">QuEST.c:475</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#l00822">QuEST.c:822</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#l01021">QuEST.c:1021</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga30675e80b054d5adf556ae00f98377d9"><div class="ttname"><a href="group__unitary.html#ga30675e80b054d5adf556ae00f98377d9">rotateZ</a></div><div class="ttdeci">void rotateZ(Qureg qureg, const 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#l00208">QuEST.c:208</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__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#l00707">QuEST.c:707</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#l00481">utilities.cpp:481</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#l00533">utilities.cpp:533</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">Create (dynamically) a square complex matrix which can be passed to the multi-qubit general unitary f...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01000">QuEST.c:1000</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#l00683">QuEST.c:683</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#l00966">QuEST.c:966</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#l00150">QuEST.h:150</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__decoherence_html_ga91edd6320f517810a58afd4b845edf12"><div class="ttname"><a href="group__decoherence.html#ga91edd6320f517810a58afd4b845edf12">mixDephasing</a></div><div class="ttdeci">void mixDephasing(Qureg qureg, const 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#l00902">QuEST.c:902</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#l00855">QuEST.c:855</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#l00756">QuEST.c:756</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#l00485">utilities.cpp:485</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 statevector or density matrix) against a reference pure state (ne...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00861">QuEST.c:861</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#l00410">utilities.cpp:410</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#l00159">utilities.cpp:159</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#l00943">QuEST.c:943</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga5fb1514d67ab43917dc64a357e711425"><div class="ttname"><a href="group__unitary.html#ga5fb1514d67ab43917dc64a357e711425">rotateX</a></div><div class="ttdeci">void rotateX(Qureg qureg, const 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#l00186">QuEST.c:186</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">Set targetQureg to be a clone of copyQureg.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00163">QuEST.c:163</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga4183dc6cb8fd996fb790a711bf3e4871"><div class="ttname"><a href="group__unitary.html#ga4183dc6cb8fd996fb790a711bf3e4871">multiControlledTwoQubitUnitary</a></div><div class="ttdeci">void multiControlledTwoQubitUnitary(Qureg qureg, int *controlQubits, const int numControlQubits, const int targetQubit1, const 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#l00281">QuEST.c:281</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#l00125">QuEST.h:125</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#l00199">QuEST.h:199</a></div></div>
<div class="ttc" id="agroup__unitary_html_gadf988ee16f38ddaf404552c41ea2b745"><div class="ttname"><a href="group__unitary.html#gadf988ee16f38ddaf404552c41ea2b745">pauliZ</a></div><div class="ttdeci">void pauliZ(Qureg qureg, const 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#l00453">QuEST.c:453</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#l00509">QuEST.c:509</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#l00136">QuEST.h:136</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga4dcb9c6660d7a5f74c9597bc467d39ef"><div class="ttname"><a href="group__unitary.html#ga4dcb9c6660d7a5f74c9597bc467d39ef">controlledPhaseFlip</a></div><div class="ttdeci">void controlledPhaseFlip(Qureg qureg, const int idQubit1, const 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#l00547">QuEST.c:547</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 on a selected number of qubits.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00640">QuEST.c:640</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#l00835">utilities.cpp:835</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#l00946">utilities.cpp:946</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 qureg, with those passed in reals and imags.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00779">QuEST.c:779</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#l00254">QuEST_validation.c:254</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga18c44cb3b947147951590dea2f6b25f7"><div class="ttname"><a href="group__unitary.html#ga18c44cb3b947147951590dea2f6b25f7">multiControlledUnitary</a></div><div class="ttdeci">void multiControlledUnitary(Qureg qureg, int *controlQubits, const int numControlQubits, const 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#l00372">QuEST.c:372</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#l00559">QuEST.c:559</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__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#l00697">QuEST.c:697</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#l00205">utilities.cpp:205</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#l00743">QuEST.c:743</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#l00167">QuEST.h:167</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga6375f658bd7cb24d25e0603b5b947bbd"><div class="ttname"><a href="group__unitary.html#ga6375f658bd7cb24d25e0603b5b947bbd">controlledMultiQubitUnitary</a></div><div class="ttdeci">void controlledMultiQubitUnitary(Qureg qureg, int ctrl, int *targs, const 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#l00312">QuEST.c:312</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga09a08f98955e75d942fdc88d4dca3e33"><div class="ttname"><a href="group__unitary.html#ga09a08f98955e75d942fdc88d4dca3e33">multiStateControlledUnitary</a></div><div class="ttdeci">void multiStateControlledUnitary(Qureg qureg, int *controlQubits, int *controlState, const int numControlQubits, const int targetQubit, ComplexMatrix2 u)</div><div class="ttdoc">Apply a general multiple-control, conditioned on a specific bit sequence, single-target unitary,...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00387">QuEST.c:387</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#l00824">utilities.cpp:824</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#l00795">QuEST.c:795</a></div></div>
<div class="ttc" id="agroup__unitary_html_gadad71b27575fd7d9baf110ff780ee0a1"><div class="ttname"><a href="group__unitary.html#gadad71b27575fd7d9baf110ff780ee0a1">multiControlledMultiQubitUnitary</a></div><div class="ttdeci">void multiControlledMultiQubitUnitary(Qureg qureg, int *ctrls, const int numCtrls, int *targs, const 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#l00329">QuEST.c:329</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga05c7b8c9491410215e277ea83c0dfef8"><div class="ttname"><a href="group__unitary.html#ga05c7b8c9491410215e277ea83c0dfef8">phaseShift</a></div><div class="ttdeci">void phaseShift(Qureg qureg, const 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#l00486">QuEST.c:486</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#l00889">QuEST.c:889</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#l00150">QuEST.h:150</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#l00406">utilities.cpp:406</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="agroup__unitary_html_gab5828a9f0518951451d9fec9370199ae"><div class="ttname"><a href="group__unitary.html#gab5828a9f0518951451d9fec9370199ae">multiQubitUnitary</a></div><div class="ttdeci">void multiQubitUnitary(Qureg qureg, int *targs, const 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#l00295">QuEST.c:295</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#l00150">QuEST.h:150</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga0cbd92af48fe641522e62eea1a76a7c3"><div class="ttname"><a href="group__unitary.html#ga0cbd92af48fe641522e62eea1a76a7c3">compactUnitary</a></div><div class="ttdeci">void compactUnitary(Qureg qureg, const 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#l00403">QuEST.c:403</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#l00904">utilities.cpp:904</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#l00170">QuEST.h:170</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga2f3bec8d06e7bf7314c581a5b837641f"><div class="ttname"><a href="group__unitary.html#ga2f3bec8d06e7bf7314c581a5b837641f">hadamard</a></div><div class="ttdeci">void hadamard(Qureg qureg, const 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#l00175">QuEST.c:175</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga680f90d42e56950f40d11d695596a363"><div class="ttname"><a href="group__unitary.html#ga680f90d42e56950f40d11d695596a363">rotateY</a></div><div class="ttdeci">void rotateY(Qureg qureg, const 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#l00197">QuEST.c:197</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#l00599">QuEST.c:599</a></div></div>
<div class="ttc" id="agroup__unitary_html_gaf2ad34c9659292d32c6c725e4bd668cf"><div class="ttname"><a href="group__unitary.html#gaf2ad34c9659292d32c6c725e4bd668cf">controlledUnitary</a></div><div class="ttdeci">void controlledUnitary(Qureg qureg, const int controlQubit, const 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#l00359">QuEST.c:359</a></div></div>
<div class="ttc" id="agroup__unitary_html_gaf99ba5356a6c20d3d047b36874fc0a50"><div class="ttname"><a href="group__unitary.html#gaf99ba5356a6c20d3d047b36874fc0a50">controlledRotateY</a></div><div class="ttdeci">void controlledRotateY(Qureg qureg, const int controlQubit, const 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#l00231">QuEST.c:231</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="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 the complete statevector.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00155">QuEST.c:155</a></div></div>
<div class="ttc" id="agroup__unitary_html_gadf4927a3d5dd8cd6d7400f2e810b4f05"><div class="ttname"><a href="group__unitary.html#gadf4927a3d5dd8cd6d7400f2e810b4f05">controlledNot</a></div><div class="ttdeci">void controlledNot(Qureg qureg, const int controlQubit, const 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#l00523">QuEST.c:523</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#l00818">utilities.cpp:818</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#l00036">QuEST_cpu.c:36</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#l00202">QuEST.h:202</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga82bf9aaf01430d3ecfde52b7731421d7"><div class="ttname"><a href="group__unitary.html#ga82bf9aaf01430d3ecfde52b7731421d7">controlledRotateAroundAxis</a></div><div class="ttdeci">void controlledRotateAroundAxis(Qureg qureg, const int controlQubit, const 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#l00586">QuEST.c:586</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#l00676">QuEST.c:676</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga8a718f1a8cc3a0ea3f5bbdb2c5a99d80"><div class="ttname"><a href="group__unitary.html#ga8a718f1a8cc3a0ea3f5bbdb2c5a99d80">controlledTwoQubitUnitary</a></div><div class="ttdeci">void controlledTwoQubitUnitary(Qureg qureg, const int controlQubit, const int targetQubit1, const 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#l00268">QuEST.c:268</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="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">Get the number of qubits in a qureg object.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00666">QuEST.c:666</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#l00829">QuEST.c:829</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga69e074c8174e198ca014d9905b98b43d"><div class="ttname"><a href="group__unitary.html#ga69e074c8174e198ca014d9905b98b43d">controlledPhaseShift</a></div><div class="ttdeci">void controlledPhaseShift(Qureg qureg, const int idQubit1, const 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#l00497">QuEST.c:497</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 object representing a set of qubits.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00075">QuEST.c:75</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#l00453">utilities.cpp:453</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#l00976">QuEST.c:976</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#l00139">QuEST.h:139</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 n-th complex amplitude (2n...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l01057">QuEST.c:1057</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#l00806">QuEST.c:806</a></div></div>
<div class="ttc" id="agroup__decoherence_html_ga3e39405eb2ce05ce4bb88c0f00dace45"><div class="ttname"><a href="group__decoherence.html#ga3e39405eb2ce05ce4bb88c0f00dace45">mixDamping</a></div><div class="ttdeci">void mixDamping(Qureg qureg, const 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#l00935">QuEST.c:935</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#l00368">utilities.cpp:368</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 a set of qubits to the classical state (also known as a "computational basis state") with...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00132">QuEST.c:132</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga5a117f81298e8ed894d964198e737757"><div class="ttname"><a href="group__unitary.html#ga5a117f81298e8ed894d964198e737757">unitary</a></div><div class="ttdeci">void unitary(Qureg qureg, const 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#l00347">QuEST.c:347</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#l00160">QuEST.h:160</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga9afcf34f7c6ae127452b503c074a9b7b"><div class="ttname"><a href="group__unitary.html#ga9afcf34f7c6ae127452b503c074a9b7b">controlledRotateZ</a></div><div class="ttdeci">void controlledRotateZ(Qureg qureg, const int controlQubit, const 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#l00243">QuEST.c:243</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#l00912">QuEST.c:912</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#l00140">QuEST.h:140</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#l00179">QuEST.h:179</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#l00116">QuEST.h:116</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">Get the number of probability amplitudes in a qureg object, given by 2^numQubits.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00670">QuEST.c:670</a></div></div>
<div class="ttc" id="agroup__unitary_html_gaa854e4b76cfd4000a32c06c990960bd9"><div class="ttname"><a href="group__unitary.html#gaa854e4b76cfd4000a32c06c990960bd9">controlledCompactUnitary</a></div><div class="ttdeci">void controlledCompactUnitary(Qureg qureg, const int controlQubit, const 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#l00416">QuEST.c:416</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#l00163">QuEST.h:163</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 statevector or ...</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00062">QuEST.c:62</a></div></div>
<div class="ttc" id="agroup__normgate_html_gab164930b260718d85ed3f55f50c76a59"><div class="ttname"><a href="group__normgate.html#gab164930b260718d85ed3f55f50c76a59">collapseToOutcome</a></div><div class="ttdeci">qreal collapseToOutcome(Qureg qureg, const 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#l00724">QuEST.c:724</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga7dc4ed5d9fd2872a04fea6ef13b65c3d"><div class="ttname"><a href="group__unitary.html#ga7dc4ed5d9fd2872a04fea6ef13b65c3d">controlledRotateX</a></div><div class="ttdeci">void controlledRotateX(Qureg qureg, const int controlQubit, const 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#l00219">QuEST.c:219</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#l00880">QuEST.c:880</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#l00812">utilities.cpp:812</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#l01074">utilities.cpp:1074</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#l00165">QuEST.h:165</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#l00172">QuEST.h:172</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#l00770">QuEST.c:770</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">Create a 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#l00034">QuEST.c:34</a></div></div>
<div class="ttc" id="agroup__calc_html_ga2a0fbd65f42d35dcd5ae966c48826920"><div class="ttname"><a href="group__calc.html#ga2a0fbd65f42d35dcd5ae966c48826920">calcProbOfOutcome</a></div><div class="ttdeci">qreal calcProbOfOutcome(Qureg qureg, const 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#l00845">QuEST.c:845</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 on a selected number of qubits.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00624">QuEST.c:624</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__unitary_html_gaa064fcf40fd02b21f98a9a83dc6cea13"><div class="ttname"><a href="group__unitary.html#gaa064fcf40fd02b21f98a9a83dc6cea13">pauliY</a></div><div class="ttdeci">void pauliY(Qureg qureg, const 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#l00442">QuEST.c:442</a></div></div>
<div class="ttc" id="agroup__testutilities_html_ga50616e813b0d0aa4f8220785d780cdff"><div class="ttname"><a href="group__testutilities.html#ga50616e813b0d0aa4f8220785d780cdff">getKroneckerProduct</a></div><div class="ttdeci">QMatrix getKroneckerProduct(QMatrix a, QMatrix b)</div><div class="ttdoc">Returns the kronecker product of a and b, where a and b are square but possibly differently-sized com...</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__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#l00457">utilities.cpp:457</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#l00187">utilities.cpp:187</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#l00955">QuEST.c:955</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#l00143">utilities.cpp:143</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__unitary_html_ga81cf22c68db66bf9b4593a5d1b3f528c"><div class="ttname"><a href="group__unitary.html#ga81cf22c68db66bf9b4593a5d1b3f528c">twoQubitUnitary</a></div><div class="ttdeci">void twoQubitUnitary(Qureg qureg, const int targetQubit1, const 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#l00255">QuEST.c:255</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#l00420">utilities.cpp:420</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga67a83cdbd8d6ae77f91aa011cf09907a"><div class="ttname"><a href="group__unitary.html#ga67a83cdbd8d6ae77f91aa011cf09907a">sGate</a></div><div class="ttdeci">void sGate(Qureg qureg, const 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#l00464">QuEST.c:464</a></div></div>
<div class="ttc" id="agroup__unitary_html_gac5c485fe330636966effc0642ba2bd99"><div class="ttname"><a href="group__unitary.html#gac5c485fe330636966effc0642ba2bd99">rotateAroundAxis</a></div><div class="ttdeci">void rotateAroundAxis(Qureg qureg, const 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#l00573">QuEST.c:573</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 a set of qubits to the classical zero state .</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00111">QuEST.c:111</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#l00837">QuEST.c:837</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#l00387">utilities.cpp:387</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">Create a Qureg for qubits which are represented by a density matrix, and can be in mixed states.</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00048">QuEST.c:48</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#l00573">utilities.cpp:573</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#l01143">utilities.cpp:1143</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 a set of qubits to the plus state (and similarly for density matrices).</div><div class="ttdef"><b>Definition:</b> <a href="QuEST_8c_source.html#l00123">QuEST.c:123</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#l00871">QuEST.c:871</a></div></div>
<div class="ttc" id="agroup__unitary_html_ga84cd118c44b9d3866f56b865dbb9bd7d"><div class="ttname"><a href="group__unitary.html#ga84cd118c44b9d3866f56b865dbb9bd7d">pauliX</a></div><div class="ttdeci">void pauliX(Qureg qureg, const 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#l00431">QuEST.c:431</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#l00611">QuEST.c:611</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#l00986">QuEST.c:986</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#l00114">QuEST.h:114</a></div></div>
<div class="ttc" id="agroup__decoherence_html_ga556fe013915bca4626367d98db948f5e"><div class="ttname"><a href="group__decoherence.html#ga556fe013915bca4626367d98db948f5e">mixDepolarising</a></div><div class="ttdeci">void mixDepolarising(Qureg qureg, const 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#l00924">QuEST.c:924</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>
