Docs preview for PR #3800.

Author: cuda-quantum-bot

pr-3800/_sources/api/languages/python_api.rst.txt

@@ -45,7 +45,6 @@ Program Construction
     .. automethod:: mx
     .. automethod:: my
     .. automethod:: mz
-    .. automethod:: c_if
     .. automethod:: for_loop
     .. automethod:: adjoint
     .. automethod:: control

pr-3800/_sources/specification/cudaq/dynamic_kernels.rst.txt

@@ -30,9 +30,6 @@ The :code:`kernel_builder` takes the following structure
 
           void h(Value& qubit);
           //... all other quantum operations ... 
-
-          // if (mz(q)) thenFunctor()
-          void c_if(Value& result, std::function<void()>&& thenFunctor);
           
           // Invoke a predefined kernel
           template<typename OtherKernelBuilder, typename... Values>

pr-3800/_sources/using/examples/measuring_kernels.rst.txt

@@ -58,28 +58,28 @@ The results show qubit 0 is one, indicating the reset worked, and qubit 1 has a
 
     .. literalinclude:: ../../examples/python/measuring_kernels.py
         :language: python
-        :start-after: [Begin Sample3]
-        :end-before: [End Sample3]
+        :start-after: [Begin Run0]
+        :end-before: [End Run0]
 
 .. tab:: C++
 
     .. literalinclude:: ../../examples/cpp/measuring_kernels.cpp
         :language: cpp
-        :start-after: [Begin Sample3]
-        :end-before: [End Sample3]
+        :start-after: [Begin Run1]
+        :end-before: [End Run1]
 
 Output
 
 .. tab:: Python
 
     .. literalinclude:: ../../examples/python/measuring_kernels.py
         :language: python
-        :start-after: [Begin Sample4]
-        :end-before: [End Sample4]
+        :start-after: [Begin Run1]
+        :end-before: [End Run1]
 
 .. tab:: C++
 
     .. literalinclude:: ../../examples/cpp/measuring_kernels.cpp
         :language: cpp
-        :start-after: [Begin Sample4]
-        :end-before: [End Sample4]
+        :start-after: [Begin Run1]
+        :end-before: [End Run1]

pr-3800/api/languages/python_api.html

@@ -2380,7 +2380,7 @@ <h3>Spin Operators<a class="headerlink" href="#spin-operators" title="Permalink
 <em class="property"><span class="pre">static</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">random</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.operators.spin.SpinOperator.random" title="Permalink to this definition">¶</a></dt>
 <dd><dl class="py function">
 <dt class="sig sig-object py">
-<span class="sig-name descname"><span class="pre">random</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">qubit_count</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.14)"><span class="pre">int</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">term_count</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.14)"><span class="pre">int</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">seed</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.14)"><span class="pre">int</span></a></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">913987273</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference internal" href="#cudaq.operators.spin.SpinOperator" title="cudaq.operators.spin.SpinOperator"><span class="pre">SpinOperator</span></a></span></span></dt>
+<span class="sig-name descname"><span class="pre">random</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">qubit_count</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.14)"><span class="pre">int</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">term_count</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.14)"><span class="pre">int</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">seed</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.14)"><span class="pre">int</span></a></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">3867101369</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference internal" href="#cudaq.operators.spin.SpinOperator" title="cudaq.operators.spin.SpinOperator"><span class="pre">SpinOperator</span></a></span></span></dt>
 <dd></dd></dl>
 
 <p>Return a random spin operator with the given number of terms (<code class="code docutils literal notranslate"><span class="pre">term_count</span></code>) where each term acts on all targets in the open range [0, qubit_count). An optional seed value may also be provided.</p>
@@ -2711,6 +2711,12 @@ <h3>Spin Operators<a class="headerlink" href="#spin-operators" title="Permalink
 <p>Returns the serialized data representation of the operator.</p>
 </dd></dl>
 
+<dl class="py property">
+<dt class="sig sig-object py" id="cudaq.operators.spin.SpinOperatorTerm.term_count">
+<em class="property"><span class="pre">property</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">term_count</span></span><a class="headerlink" href="#cudaq.operators.spin.SpinOperatorTerm.term_count" title="Permalink to this definition">¶</a></dt>
+<dd><p>Returns the number of terms in the operator. Always returns 1.</p>
+</dd></dl>
+
 <dl class="py property">
 <dt class="sig sig-object py" id="cudaq.operators.spin.SpinOperatorTerm.term_id">
 <em class="property"><span class="pre">property</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">term_id</span></span><a class="headerlink" href="#cudaq.operators.spin.SpinOperatorTerm.term_id" title="Permalink to this definition">¶</a></dt>
@@ -5349,9 +5355,8 @@ <h2>Data Types<a class="headerlink" href="#data-types" title="Permalink to this
 terminal measurements.</p>
 <div class="admonition note">
 <p class="admonition-title">Note</p>
-<p>At this time, mid-circuit measurements are not directly supported.
-Mid-circuit measurements may only be used if they are passed through
-to <code class="code docutils literal notranslate"><span class="pre">c_if</span></code>.</p>
+<p>Conditional logic on mid-circuit measurements is no longer supported with</p>
+<p><code class="code docutils literal notranslate"><span class="pre">sample</span></code>. Use <code class="code docutils literal notranslate"><span class="pre">run</span></code> instead.</p>
 </div>
 <dl class="py attribute">
 <dt class="sig sig-object py" id="cudaq.SampleResult.register_names">

pr-3800/api/languages/python_api.md

@@ -3580,7 +3580,7 @@ aria-hidden="true"}](../default_ops.html "Quantum Operations"){.btn
 
     :   
 
-        [[random]{.pre}]{.sig-name .descname}[(]{.sig-paren}*[[qubit_count]{.pre}]{.n}[[:]{.pre}]{.p}[ ]{.w}[[[int]{.pre}](https://docs.python.org/3/library/functions.html#int "(in Python v3.14)"){.reference .external}]{.n}*, *[[term_count]{.pre}]{.n}[[:]{.pre}]{.p}[ ]{.w}[[[int]{.pre}](https://docs.python.org/3/library/functions.html#int "(in Python v3.14)"){.reference .external}]{.n}*, *[[seed]{.pre}]{.n}[[:]{.pre}]{.p}[ ]{.w}[[[int]{.pre}](https://docs.python.org/3/library/functions.html#int "(in Python v3.14)"){.reference .external}]{.n}[ ]{.w}[[=]{.pre}]{.o}[ ]{.w}[[913987273]{.pre}]{.default_value}*[)]{.sig-paren} [[→]{.sig-return-icon} [[[SpinOperator]{.pre}](#cudaq.operators.spin.SpinOperator "cudaq.operators.spin.SpinOperator"){.reference .internal}]{.sig-return-typehint}]{.sig-return}
+        [[random]{.pre}]{.sig-name .descname}[(]{.sig-paren}*[[qubit_count]{.pre}]{.n}[[:]{.pre}]{.p}[ ]{.w}[[[int]{.pre}](https://docs.python.org/3/library/functions.html#int "(in Python v3.14)"){.reference .external}]{.n}*, *[[term_count]{.pre}]{.n}[[:]{.pre}]{.p}[ ]{.w}[[[int]{.pre}](https://docs.python.org/3/library/functions.html#int "(in Python v3.14)"){.reference .external}]{.n}*, *[[seed]{.pre}]{.n}[[:]{.pre}]{.p}[ ]{.w}[[[int]{.pre}](https://docs.python.org/3/library/functions.html#int "(in Python v3.14)"){.reference .external}]{.n}[ ]{.w}[[=]{.pre}]{.o}[ ]{.w}[[3867101369]{.pre}]{.default_value}*[)]{.sig-paren} [[→]{.sig-return-icon} [[[SpinOperator]{.pre}](#cudaq.operators.spin.SpinOperator "cudaq.operators.spin.SpinOperator"){.reference .internal}]{.sig-return-typehint}]{.sig-return}
 
         :   
 
@@ -3949,6 +3949,10 @@ aria-hidden="true"}](../default_ops.html "Quantum Operations"){.btn
 
         Returns the serialized data representation of the operator.
 
+    *[property]{.pre}[ ]{.w}*[[term_count]{.pre}]{.sig-name .descname}[¶](#cudaq.operators.spin.SpinOperatorTerm.term_count "Permalink to this definition"){.headerlink}
+
+    :   Returns the number of terms in the operator. Always returns 1.
+
     *[property]{.pre}[ ]{.w}*[[term_id]{.pre}]{.sig-name .descname}[¶](#cudaq.operators.spin.SpinOperatorTerm.term_id "Permalink to this definition"){.headerlink}
 
     :   The term id uniquely identifies the operators and targets
@@ -7056,9 +7060,11 @@ aria-hidden="true"}](../default_ops.html "Quantum Operations"){.btn
     ::: {.admonition .note}
     Note
 
-    At this time, mid-circuit measurements are not directly supported.
-    Mid-circuit measurements may only be used if they are passed through
-    to [`c_if`{.code .docutils .literal .notranslate}]{.pre}.
+    Conditional logic on mid-circuit measurements is no longer supported
+    with
+
+    [`sample`{.code .docutils .literal .notranslate}]{.pre}. Use
+    [`run`{.code .docutils .literal .notranslate}]{.pre} instead.
     :::
 
     [[register_names]{.pre}]{.sig-name .descname}[¶](#cudaq.SampleResult.register_names "Permalink to this definition"){.headerlink}

pr-3800/applications/python/adapt_qaoa.html

@@ -1038,7 +1038,7 @@ <h1>ADAPT-QAOA algorithm<a class="headerlink" href="#ADAPT-QAOA-algorithm" title
 parameter</p>
 <p>3- Optimize all parameters currently in the Ansatz <span class="math notranslate nohighlight">\(\beta_m, \gamma_m = 1, 2, ...k\)</span> such that <span class="math notranslate nohighlight">\(\braket{\psi (k)|H_C|\psi(k)}\)</span> is minimized, and return to the second step.</p>
 <p>Below is a schematic representation of the ADAPT-QAOA algorithm explained above.</p>
-<div><p><img alt="7c3b1ee445a94c4a824980f19ebb8f40" class="no-scaled-link" src="../../_images/adapt-qaoa.png" style="width: 1000px;" /></p>
+<div><p><img alt="427e4b30bcf24ad79983c230ac95ddf2" class="no-scaled-link" src="../../_images/adapt-qaoa.png" style="width: 1000px;" /></p>
 </div><div class="nbinput nblast docutils container">
 <div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[15]:
 </pre></div>

pr-3800/applications/python/adapt_qaoa.md

@@ -1827,7 +1827,7 @@ explained above.
 
 <div>
 
-![7c3b1ee445a94c4a824980f19ebb8f40](../../_images/adapt-qaoa.png){.no-scaled-link
+![427e4b30bcf24ad79983c230ac95ddf2](../../_images/adapt-qaoa.png){.no-scaled-link
 style="width: 1000px;"}
 
 </div>

pr-3800/applications/python/adapt_vqe.html

@@ -1035,7 +1035,7 @@ <h1>ADAPT-VQE algorithm<a class="headerlink" href="#ADAPT-VQE-algorithm" title="
 <p>7- Perform a VQE experiment to re-optimize all parameters in the ansatz.</p>
 <p>8- go to step 4</p>
 <p>Below is a Schematic depiction of the ADAPT-VQE algorithm</p>
-<div><p><img alt="a59c26f145b04e3c8c52cab7e624dcee" class="no-scaled-link" src="../../_images/adapt-vqe.png" style="width: 800px;" /></p>
+<div><p><img alt="1bc261faf85f46d89c52bb80700f7408" class="no-scaled-link" src="../../_images/adapt-vqe.png" style="width: 800px;" /></p>
 </div><div class="nbinput docutils container">
 <div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[1]:
 </pre></div>

pr-3800/applications/python/adapt_vqe.md

@@ -1795,7 +1795,7 @@ Below is a Schematic depiction of the ADAPT-VQE algorithm
 
 <div>
 
-![a59c26f145b04e3c8c52cab7e624dcee](../../_images/adapt-vqe.png){.no-scaled-link
+![1bc261faf85f46d89c52bb80700f7408](../../_images/adapt-vqe.png){.no-scaled-link
 style="width: 800px;"}
 
 </div>

pr-3800/applications/python/deutsch_algorithm.html

@@ -1095,7 +1095,7 @@ <h2>XOR <span class="math notranslate nohighlight">\(\oplus\)</span><a class="he
 </section>
 <section id="Quantum-oracles">
 <h2>Quantum oracles<a class="headerlink" href="#Quantum-oracles" title="Permalink to this heading">¶</a></h2>
-<p><img alt="cee15daa7f4e448aa4078a76833db7a9" class="no-scaled-link" src="../../_images/oracle.png" style="width: 300px; height: 150px;" /></p>
+<p><img alt="2a94167d40db49cba21771edaf9dfcff" class="no-scaled-link" src="../../_images/oracle.png" style="width: 300px; height: 150px;" /></p>
 <p>Suppose we have <span class="math notranslate nohighlight">\(f(x): \{0,1\} \longrightarrow \{0,1\}\)</span>. We can compute this function on a quantum computer using oracles which we treat as black box functions that yield the output with an appropriate sequence of logical gates.</p>
 <p>Above you see an oracle represented as <span class="math notranslate nohighlight">\(U_f\)</span> which allows us to transform the state <span class="math notranslate nohighlight">\(\ket{x}\ket{y}\)</span> into:</p>
 <div class="math notranslate nohighlight">
@@ -1143,7 +1143,7 @@ <h2>Quantum parallelism<a class="headerlink" href="#Quantum-parallelism" title="
 <h2>Deutsch’s Algorithm:<a class="headerlink" href="#Deutsch's-Algorithm:" title="Permalink to this heading">¶</a></h2>
 <p>Our aim is to find out if <span class="math notranslate nohighlight">\(f: \{0,1\} \longrightarrow \{0,1\}\)</span> is a constant or a balanced function? If constant, <span class="math notranslate nohighlight">\(f(0) = f(1)\)</span>, and if balanced, <span class="math notranslate nohighlight">\(f(0) \neq f(1)\)</span>.</p>
 <p>We step through the circuit diagram below and follow the math after the application of each gate.</p>
-<p><img alt="7b9c285f50a549ccb2a44cbe936b516c" class="no-scaled-link" src="../../_images/deutsch.png" style="width: 500px; height: 210px;" /></p>
+<p><img alt="456ad7dcf36c4b359879972324994f65" class="no-scaled-link" src="../../_images/deutsch.png" style="width: 500px; height: 210px;" /></p>
 <div class="math notranslate nohighlight">
 \[\ket{\psi_0}  =  \ket{01}
 \tag{1}\]</div>