Merge branch 'main' into remove_nvqc

Author: sacpis

docs/sphinx/applications/python/images/speedup.png

@@ -12,6 +12,22 @@ and is also available as a Docker image. More information about installing the n
 - `Documentation <https://nvidia.github.io/cuda-quantum/latest>`__
 - `Examples <https://github.com/NVIDIA/cuda-quantum/tree/main/docs/sphinx/examples>`__
 
+**0.13.0**
+
+This release adds support for CUDA 13 and Python 3.13 and removes support for 
+CUDA 11 and Python 3.10. It adds support for using the CUDA-Q QEC libraries 
+for real-time decoding on Quantinuum backends, and adds support for submission 
+to QCI backends. Check out the release notes below to learn about additional 
+new content.
+
+- `Docker image <https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum/tags>`__
+- `Python wheel <https://pypi.org/project/cudaq/0.13.0>`__
+- `C++ installer <https://github.com/NVIDIA/cuda-quantum/releases/0.13.0>`__
+- `Documentation <https://nvidia.github.io/cuda-quantum/0.13.0>`__
+- `Examples <https://github.com/NVIDIA/cuda-quantum/tree/releases/v0.13.0/docs/sphinx/examples>`__
+
+The full change log can be found `here <https://github.com/NVIDIA/cuda-quantum/releases/0.13.0>`__.
+
 **0.12.0**
 
 This release contains a range of new features and performance improvements for 
@@ -23,7 +39,7 @@ Python 3.13.
 
 *Note*: Support for Python 3.10 will be removed in future releases.
 
-- `Docker image <https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum>`__
+- `Docker image <https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum/tags>`__
 - `Python wheel <https://pypi.org/project/cudaq/0.12.0>`__
 - `C++ installer <https://github.com/NVIDIA/cuda-quantum/releases/0.12.0>`__
 - `Documentation <https://nvidia.github.io/cuda-quantum/0.12.0>`__

docs/sphinx/applications/python/skqd.ipynb

@@ -6,7 +6,7 @@
 # the terms of the Apache License 2.0 which accompanies this distribution.     #
 # ============================================================================ #
 
-# fmt: off
+# `fmt: off`
 #[Begin Docs]
 import cudaq
 import numpy as np
@@ -45,4 +45,4 @@ def custom_xy_test():
 
 cudaq.sample(custom_xy_test).dump() # prints { 10:1000 }
 #[End Docs]
-# fmt: on
+# `fmt: on`

docs/sphinx/applications/python/skqd_src/pre_and_postprocessing.py

@@ -50,6 +50,8 @@ Quantum Photonic States
 We define a qumode (qudit) to have the states
 :math:`\ket{0}`, :math:`\ket{1}`, ... :math:`\ket{d}` in Dirac notation where:
 
+:spellcheck-disable:
+
 .. math:: \ket{0} = \begin{bmatrix} 1 & 0 & 0 & \dots & 0 \end{bmatrix} ^ \top
 
 .. math:: \ket{1} = \begin{bmatrix} 0 & 1 & 0 & \dots & 0 \end{bmatrix}^ \top
@@ -60,6 +62,8 @@ We define a qumode (qudit) to have the states
 
 .. math:: \ket{d} = \begin{bmatrix} 0 & 0 & 0 & \dots & 1 \end{bmatrix}^ \top
 
+:spellcheck-enable:
+
 where the linear combinations of states or superpositions are:
 
 .. math::   \ket{\psi} = \alpha_0\ket{0} + \alpha_1\ket{1} + \alpha_2\ket{2} + \dots + \alpha_d\ket{d}
@@ -94,6 +98,8 @@ qumode up to a maximum given by the qudit level :math:`d`:
 
 .. math::  C \ket{0} = \ket{1} 
 
+:spellcheck-disable:
+
 .. math::  \begin{bmatrix}
                 0 & 0 & \dots & 0 & 0 & 0 & 0 \\
                 1 & 0 & \dots & 0 & 0 & 0 & 0 \\
@@ -106,6 +112,8 @@ qumode up to a maximum given by the qudit level :math:`d`:
             \begin{bmatrix} 1 \\ 0 \\ 0 \\ \vdots \\ 0 \\ 0 \\ 0 \end{bmatrix} =
             \begin{bmatrix} 0 \\ 1 \\ 0 \\ \vdots \\ 0 \\ 0 \\ 0 \end{bmatrix}
 
+:spellcheck-enable:
+
 .. literalinclude:: ../../../snippets/python/using/examples/create_photonic_gate.py
     :language: python
     :start-after: [Begin Docs]
@@ -121,6 +129,8 @@ value 0, the operation has no effect:
 
 .. math::  A \ket{1} =  \ket{0}
 
+:spellcheck-disable:
+
 .. math::  \begin{bmatrix}
                 1 & 1 & 0 & 0 & \dots & 0 & 0 \\
                 0 & 0 & 1 & 0 & \dots & 0 & 0 \\
@@ -133,6 +143,8 @@ value 0, the operation has no effect:
             \begin{bmatrix} 0 \\ 1 \\ 0 \\ \vdots \\ 0 \\ 0 \\ 0 \end{bmatrix} =
             \begin{bmatrix} 1 \\ 0 \\ 0 \\ \vdots \\ 0 \\ 0 \\ 0 \end{bmatrix}
 
+:spellcheck-enable:
+
 .. literalinclude:: ../../../snippets/python/using/examples/annihilate_photonic_gate.py
     :language: python
     :start-after: [Begin Docs]

docs/sphinx/releases.rst

@@ -125,7 +125,9 @@ path, i.e., the trace, of the provided `kernel`.
   # Output
   #      ╭───╮╭──────────╮
   # q0 : ┤ h ├┤ ry(0.59) ├
-  #      ╰───╯╰──────────╯)#");
+  #      ╰───╯╰──────────╯
+
+Note: This function is only available when using simulator backends.)#");
 }
 
 } // namespace cudaq

docs/sphinx/snippets/python/using/examples/two_qubit_custom_op.py

@@ -244,6 +244,20 @@ def test():
     assert not '10' in counts
 
 
+def test_draw():
+
+    @cudaq.kernel
+    def kernel():
+        q = cudaq.qvector(2)
+        h(q[0])
+        x.ctrl(q[0], q[1])
+        mz(q)
+
+    # Test here is that this does not raise an exception
+    result = cudaq.draw(kernel)
+    assert result is ''
+
+
 # leave for gdb debugging
 if __name__ == "__main__":
     loc = os.path.abspath(__file__)

docs/sphinx/using/backends/sims/photonics.rst

@@ -8,10 +8,10 @@
 
 #pragma once
 
-#include <concepts>
-
 #include "common/ExecutionContext.h"
 #include "cudaq/platform.h"
+#include <concepts>
+#include <iostream>
 
 namespace cudaq {
 
@@ -32,9 +32,13 @@ cudaq::Trace traceFromKernel(KernelFunctor &&kernel, Args &&...args) {
   // Get the platform.
   auto &platform = cudaq::get_platform();
 
-  // This can only be done in simulation
-  if (!platform.is_simulator())
-    throw std::runtime_error("Cannot use draw on a physical QPU.");
+  // This is not supported on hardware backends, but we don't want callers to
+  // crash on unhandled exceptions.
+  if (!platform.is_simulator()) {
+    std::cerr << "Warning: `draw` can only be used with a simulator platform. "
+              << "Returning an empty trace." << std::endl;
+    return Trace();
+  }
 
   // Create an execution context, indicate this is for tracing the execution
   // path
@@ -107,6 +111,7 @@ std::string extractTraceLatex(KernelFunctor &&kernel) {
 /// */      
 /// \endcode
 ///
+/// @note This function is only available when using simulator backends.
 // clang-format on
 
 #if CUDAQ_USE_STD20